Wat een betaling in Deel is
Deze gids bekijkt de betaling aan contractors vanuit het bedrijf dat betaalt. Op het tabblad Pay onder Finance selecteert Deel standaard alle openstaande facturen om ze in één keer te betalen, en het bedrijf kan de facturen weghalen die het nog niet wil betalen, behalve facturen die volgens Deel in sommige gevallen verplicht kunnen zijn, zoals vervallen facturen. Betaalt het per overboeking, dan moet het de Deel-referentie van de betaling vermelden. Zolang het geld niet binnen is, staat de betaling op in behandeling, en zodra Deel de ontvangst bevestigt, gaat ze naar Paid. Zo vereffent één betaling aan Deel in één keer de facturen van meerdere contractors.
De API van Deel houdt die twee apart. GET /payments geeft de betalingen aan Deel met hun status, paid of processing, hun totalen, de valuta en de betaalmethode, maar niet meer de facturen die ze dekken. Daarvoor is er GET /payments/{payment_id}/breakdown, dat volgens Deel elke factuur en de kosten van Deel als aparte regels geeft. Elke regel bevat onder meer de id van de factuur (invoice_id), het contract en het type, de naam van de persoon, het bedrag met de valuta, het bedrag in de betaalvaluta en de grootboekrekening die in Deel is ingesteld (general_ledger_account).
Hoe de connector haar verdeelt
| Wat Deel stuurt | Wat de connector in Odoo doet |
|---|---|
Betalingen uit GET /payments | Leest ze vanaf de vorige run min 7 dagen; de eerste keer vanaf Facturen geïmporteerd vanaf |
Status processing | De betaling wacht op Wacht op Deel en de connector vraagt haar uitsplitsing niet op |
Status paid | De betaling gaat naar Te registreren en de connector leest haar uitsplitsing, als Deel haar binnen 7 dagen na het aanmaken als betaald geeft |
invoice_id van elke regel | De leveranciersfactuur van die Deel-factuur, die haar betaling krijgt |
paid_at | Betaaldatum in Odoo |
deel_reference | Omschrijving van de betaling; ontbreekt die, dan het label van de betaling |
general_ledger_account | Bewaard in Deel-grootboekrekening, maar bepaalt niet waar de betaling heen gaat |
Elke factuur wordt betaald met de betalingswizard van Odoo, in het Betalingenboek van haar rechtspersoon, zodat een betaling aan Deel die meerdere facturen dekt in Odoo één betaling per factuur oplevert. Elke betaling is voor wat er op haar leveranciersfactuur nog openstaat, niet voor het bedrag van de regel in de uitsplitsing: heeft iemand de factuur in Odoo aangepast, dan wordt betaald wat op de factuur staat. Staat een factuur in Odoo al als betaald, dan maakt de connector geen tweede betaling, en een regel die al betaald is, wordt in latere runs niet nog eens betaald. Hoeft geen enkele factuur te wachten, dan eindigt de Deel-betaling op Geregistreerd.
De voorwaarden, allemaal
Om een factuur haar betaling te laten krijgen, moeten al deze voorwaarden tegelijk gelden:
- In de koppeling staat het vakje
Betalingen naar Deelaan, zoals standaard. - Deel geeft de betaling binnen 7 dagen na het aanmaken als betaald (
paid). - De Deel-factuur heeft al haar leveranciersfactuur in Odoo.
- Die leveranciersfactuur is geboekt. Met
LeveranciersfacturenopConcept, te controleren, de standaardwaarde, moet iemand haar boeken; metVerwerkt wanneer alles overeenkomtboekt ze zichzelf als alles overeenkomt. - Haar rechtspersoon heeft een
Betalingenboek, een bank- of kasdagboek. Dat veld is bij elke nieuwe rechtspersoon leeg, en zonder dat blijven de facturen in Odoo onbetaald.
Mist een factuur een van de laatste drie voorwaarden, dan blijft de betaling op Niet alle facturen klaar staan, met een melding die het uitlegt, en de facturen die wel voldoen worden toch betaald. De synchronisatie kijkt er elke 30 minuten opnieuw naar, en zodra de factuur geboekt is en de rechtspersoon een dagboek heeft, wordt haar betaling geregistreerd. Ontvangt de koppeling webhooks, dan starten de events payment.statement.initiated en payment.statement.mark-paid van Deel het betalingsdeel eerder, en de gegevens worden opnieuw via de API gelezen.

Als de betaling eerder komt dan haar factuur
De uitsplitsing kan een Deel-factuur noemen die Odoo nog niet heeft: een factuur die is uitgegeven vóór de datum vanaf wanneer je importeert, of die van een COR-werknemer, die de connector niet opvraagt als hij facturen ophaalt. Dan leest hij die factuur bij Deel via haar id, met GET /invoices/{id}, en maakt hij meteen haar leveranciersfactuur, met dezelfde regels als bij de andere. Blijft die factuur in concept, wat de standaard is, dan wacht de betaling op Niet alle facturen klaar tot iemand haar boekt, en wordt ze in de volgende run geregistreerd.
Contractors met een eigen leverancier
In Deel gaat het geld naar Deel, maar in Odoo staat elke factuur op naam van een leverancier, en de rechtspersoon in Deel bepaalt het bedrijf, het inkoopdagboek en die leverancier. Een contractor is zijn eigen leverancier: de connector zoekt hem op zijn e-mailadres, maar alleen tussen de contacten in Odoo die al leverancier zijn en geen gebruiker hebben; vindt hij er geen, dan maakt hij een nieuwe aan. Zolang Deel die persoon nog niet heeft, bijvoorbeeld omdat ze de uitnodiging niet heeft aanvaard, gaan haar facturen naar de leverancier van Deel. Facturen van EOR en COR gaan altijd naar Deel, naar de Deel leverancier van de rechtspersoon of, als dat veld leeg is, naar die van de koppeling. Omdat de betaling op de factuur wordt geregistreerd, vereffent ze de schuld bij dezelfde leverancier als de factuur.

Wat hij niet doet
De connector gebruikt de grootboekrekening uit de uitsplitsing niet: hij bewaart haar in Deel-grootboekrekening, en de betaling gaat naar het betalingenboek van de rechtspersoon. Creditnota's leest hij evenmin; die geeft de API van Deel via een andere oproep (GET /billing/invoices). Een betaling die meer dan 7 dagen na het aanmaken nog in behandeling is, leest hij ook niet meer, omdat Deel volgens de referentie van zijn API de lijst met betalingen op aanmaakdatum filtert. Geeft Deel de betaling pas later als betaald, dan blijft ze zonder enige melding in de status Wacht op Deel staan en blijven haar facturen in Odoo onbetaald. Webhooks starten precies dat ophalen en halen haar dus evenmin terug, en op dit moment is er geen knop die dat doet. Bovendien is geen enkele betaling getest tegen de echte API van Deel. De demo-organisatie van Deel waartegen de connector via FlexigoTech Cloud is getest, had geen betalingen, dus dit deel is getest met nagebootste antwoorden op basis van de API-referentie van Deel, en niemand heeft nog gezien hoe de regel met de kosten van Deel in een echte uitsplitsing binnenkomt. Tegen die organisatie zijn wel getest: de verbinding, de rechtspersonen, een contract met zijn persoon en zijn leverancier, de webhooks en een tweede run zonder duplicaten.
De connector werkt op Odoo 17, 18, 19 en 20 op je eigen server of op Odoo.sh, niet op Odoo Online. Hoe elke factuur binnenkomt, staat in Facturen van Deel in Odoo, de loonverwerking van Global Payroll in Deel gross to net en de vergelijking met Bill Sync, de factuursynchronisatie van Deel, 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/4407737772689-Making-Invoice-Payments-With-Deel
- developer.deel.com/api/reference/endpoints/accounting/retrieve-payment-receipts-v-2027-01-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-
- 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_account.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.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_invoice.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- help.letsdeel.com/hc/en-gb/articles/46057955155217-Accounting-Integrations-Overview
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
