De Deel-factuur zoals het betalende bedrijf die ziet
Wie «deel invoice» zoekt, vindt meestal hoe een contractor zijn factuur in Deel maakt. Deze gids gaat over de andere kant: het bedrijf dat die facturen ontvangt en in de boekhouding moet krijgen. In Deel beheert het bedrijf betalingen en facturen op het tabblad Billing, onder Finance, en downloadt ze daar één voor één of in een zip van maximaal 50 documenten. Zonder connector typt iemand elke pdf opnieuw over in Odoo.
De API van Deel geeft meer dan de pdf laat zien. De factuurlijst geeft standaard alleen betaalde en terugbetaalde facturen, dus de connector vraagt die op met status=all en krijgt ook de openstaande. Facturen voor de eigen kosten van Deel komen via een aparte oproep, GET /invoices/deel, en de connector importeert die ook.
De connector is via FlexigoTech Cloud van begin tot eind getest tegen een demo-organisatie van Deel (demo.deel.com): de verbinding, de rechtspersonen, een contract met zijn persoon en zijn leverancier, de webhooks en een tweede run zonder duplicaten. Die organisatie had nog geen facturen, betalingen of loonperiodes, dus dat deel is getest met nagebootste antwoorden op basis van de API-referentie van Deel. Of de factuurlijst van Deel ook de facturen van werknemers via EOR bevat, moet nog met een echte organisatie worden nagegaan.
| Wat Deel stuurt | Waar het in Odoo terechtkomt |
|---|---|
De posten van de factuur (line_items) | Eén regel van de leveranciersfactuur per post, met de omschrijving |
amount en deel_fee | Heeft de factuur geen posten, dan één regel met het bedrag en één met de Deel-kosten |
vat_percentage | De Odoo-belasting die je aan dat tarief hebt gekoppeld onder BTW-tarieven |
| Factuurdatum en vervaldatum | Factuurdatum en, zonder betalingsvoorwaarden, de vervaldatum |
| Factuurnummer in Deel | Referentie van de factuur en van de betaling |
| Bijlage bij de leveranciersfactuur, tot 20 MB |
Hoe er een leveranciersfactuur van wordt
Elke Deel-factuur wordt in Odoo opgeslagen met haar Deel-ID, en de connector laat nooit twee leveranciersfacturen voor dezelfde factuur toe, ook niet als twee runs overlappen of twee koppelingen dezelfde Deel-organisatie lezen. De rechtspersoon in Deel bepaalt het Odoo-bedrijf, het inkoopdagboek en de leverancier, en een contractor met een eigen leverancier in Odoo gaat naar die leverancier. Een negatief totaal levert een creditnota van de leverancier op.

De regels komen uit de posten die de factuur in Deel heeft en krijgen de analytische verdeling van het contract, zodat de kostenplaatsen al ingevuld binnenkomen. Alleen de regel met de eigen kosten van Deel, op een factuur zonder posten, krijgt die niet. De import stopt met een melding, zonder de factuur te maken, onder meer als een btw-tarief van Deel geen gekoppelde Odoo-belasting heeft in de koppeling, als de valuta in Odoo niet actief is of als de rechtspersoon van Deel geen inkoopdagboek heeft.
Voordat de factuur klaar is, vergelijkt de connector het totaal in Odoo met dat in Deel. Verschillen ze meer dan 0,01, dan zet hij de factuur op Te bekijken met een bericht dat beide totalen noemt en vraagt de belastingen te controleren voor het boeken. Het veld Leveranciersfacturen van de koppeling bepaalt de rest: met Concept, te controleren, de standaardwaarde, blijven ze allemaal in concept; met Verwerkt wanneer alles overeenkomt worden ze vanzelf geboekt als het totaal klopt.
De statussen van een Deel-factuur in Odoo
| Status | Wat het betekent |
|---|---|
Te importeren | Gelezen uit Deel, nog zonder leveranciersfactuur |
Factuur aangemaakt | De leveranciersfactuur bestaat in Odoo |
Te bekijken | Het totaal klopt niet of Deel heeft de factuur later gewijzigd, en een mens beslist |
Facturen met een totaal van nul leveren geen leveranciersfactuur op, en facturen voor contractors of werknemers via EOR die Deel als geannuleerd, mislukt of onbetaalbaar markeert ook niet. Ontbreekt er iets om de factuur te maken, zoals een belasting of een valuta, dan gaat ze in fout met een melding over wat er ontbreekt.

Factuur aangemaakt en gekoppeld aan haar leveranciersfactuur in concept.Als Deel de factuur later wijzigt of annuleert
Wijzigt Deel het totaal van een factuur, of annuleert het een factuur voor een contractor of een werknemer via EOR, terwijl de leveranciersfactuur al in Odoo staat, dan laat de connector die leveranciersfactuur met rust, omdat die al geboekt of betaald kan zijn: hij zet de Deel-factuur op Te bekijken en opent een melding met de wijziging, zodat iemand de factuur annuleert of een creditnota maakt. Om dat op te merken draait de synchronisatie elke 30 minuten en leest hij opnieuw wat in de 7 dagen voor de vorige run is uitgegeven. Oudere facturen die al een leveranciersfactuur hebben en nog niet betaald zijn, worden één voor één nagekeken, tot 100 per run.
Voordat je hem aanzet
- Odoo 17, 18, 19 of 20 op je eigen server of op Odoo.sh. De module werkt niet op Odoo Online.
- Een organisatietoken van Deel met leesrechten, dat een Deel-beheerder in het Developer Center maakt. Je plakt het in de koppeling en FlexigoTech Cloud bewaart het versleuteld, nooit je Odoo. De optie
Autoriseren met Deelwerkt zodra Deel de app van FlexigoTech goedkeurt; tot dan vraagt de connector om het token te gebruiken. - Een Odoo-belasting voor elk btw-tarief op je facturen, onder
BTW-tarieven. - Het
Betalingenboekvan elke rechtspersoon van Deel, dat leeg begint. Zonder dat boek registreert de connector de betalingen aan Deel niet in Odoo; met dat boek registreert hij ze op leveranciersfacturen die al geboekt zijn. - De datum vanaf wanneer je importeert. Verander je die niet, dan komen de facturen binnen die zijn uitgegeven in de 60 dagen voor het aanmaken van de koppeling.
Betaalt één Deel-organisatie vanuit meerdere entiteiten, dan gaat elke rechtspersoon naar een eigen Odoo-bedrijf, met eigen dagboeken en een eigen leverancier. Gebruik je ook Global Payroll, dan komt de loonverwerking binnen als één boeking per periode, en dat vergelijken we met wat Deel biedt in zijn boekhoudintegraties. De connector staat volledig uitgelegd op zijn pagina en is gepubliceerd op Odoo Apps.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- help.letsdeel.com/hc/en-gb/articles/20301708484753-How-to-Download-Invoices-and-Manage-Pay
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
