Hoe Deel meldt
Als er iets in het account gebeurt, stuurt Deel een POST naar het adres van de webhook met een JSON die het type event in data.meta.event_type bevat, de organisatie, de gewijzigde resource en het tijdstip. Elke levering heeft drie headers: x-deel-signature, met de handtekening; x-deel-hmac-label, dat zegt welke ondertekeningssleutel is gebruikt; en x-deel-webhook-version. Webhooks maak je via de API, met POST /webhooks, of op het tabblad Webhooks van het Developer Center, en daarvoor moet je in Deel Org Admin of IT Developer Admin zijn. Een webhook die in de sandbox is gemaakt, krijgt alleen events uit de sandbox.
Hoe de handtekening wordt gecontroleerd
Deel berekent een HMAC-SHA256 van het woord POST gevolgd door de body zoals die binnenkomt, met de ondertekeningssleutel van de webhook, en vraagt dat te controleren voordat je iets verwerkt. Die sleutel (signing_key) geeft Deel terug bij het aanmaken van de webhook, en Deel maakt hem zelf aan als je er geen meegeeft. De codevoorbeelden van Deel geven de handtekening in hexadecimaal.
De controller van de connector doet dezelfde berekening met de sleutel die bij de koppeling is opgeslagen, vergelijkt die met x-deel-signature op een manier die altijd even lang duurt en antwoordt zo:
| Wat er bij Odoo binnenkomt | Antwoord |
|---|---|
| Geldige handtekening | 200, met het event genoteerd in de wachtrij |
| Geen of een foute handtekening | 401 |
| Een onbekend token in het adres of een in Odoo uitgeschakelde webhook | 404 |
| Een body van meer dan 1 MB | 413 |
Anders dan het API-token, dat FlexigoTech Cloud bewaart, blijft de ondertekeningssleutel in Odoo, bij de koppeling, in een veld dat alleen beheerders zien. De tests van de module controleren de handtekening met de berekening uit het Python-voorbeeld van Deel, en het aanmaken en verwijderen van de webhook is getest tegen de demo-organisatie van Deel.
Welke events er zijn
De eventpagina van Deel spreekt van meer dan 100 («100+ Events») en verwijst voor de volledige lijst naar GET /webhooks/events/types, waarvoor het recht webhooks:read nodig is. In de index van de API-referentie van Deel, gekopieerd op 18-11-2026, staan 56 events met een eigen pagina. In die lijst staat geen event voor een uitgegeven factuur en geen voor een bruto-netto-rapport: voor facturen zijn er alleen de aanpassingen (Invoice Adjustment Created, Pending For Approval en Reviewed); voor de loonverwerking die voor beschikbare loonstroken van Global Payroll en EOR en die voor een verwijderd loondocument; en voor betalingen het gestarte en het als betaald gemarkeerde overzicht.
De connector abonneert zich op 12 van die events, en elk event vertelt hem alleen welk deel van de synchronisatie hij moet draaien:
| Events van Deel | Wat de connector opnieuw leest |
|---|---|
payment.statement.initiated, payment.statement.mark-paid | De betalingen |
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.available | De facturen |
gp.payslips.available | De loonverwerking van Global Payroll |
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deleted | De personen en de contracten |
Een event dat de connector niet kent, wordt genoteerd en als afgehandeld gemarkeerd zonder dat er iets draait.
Nieuwe pogingen en uitschakelen, volgens Deel
Antwoordt het adres niet met een 2xx, of duurt het langer dan 30 seconden, dan telt Deel dat als mislukking en probeert het opnieuw na wachttijden van 1, 2, 4, 8, 16 en 32 minuten, daarna van 1, 2 en 4 uur, en een tiende poging na 16 uur. Na 10 mislukkingen op rij schakelt Deel het abonnement uit, dat je dan met de hand weer moet aanzetten, via de API of in het Developer Center. Deel vraagt binnen 30 seconden een 200 te geven, liefst binnen 5, en waarschuwt dat hetzelfde event meer dan eens kan aankomen.
De connector antwoordt zodra hij het event heeft genoteerd; de synchronisatie volgt daarna, in de wachtrij. In Odoo gaat Webhook Actief alleen uit via Webhook verwijderen of via Verbinding verbreken, en de connector vraagt Deel niet in welke staat de webhook is. Schakelt Deel hem uit na 10 mislukkingen, bijvoorbeeld omdat Odoo plat lag, dan blijft Odoo hem als actief zien: je zet hem weer aan in het Developer Center van Deel, of je verwijdert hem en registreert hem opnieuw vanuit Odoo. Intussen blijft de synchronisatie om de 30 minuten dezelfde gegevens brengen. Om te zien wat er met elke levering gebeurde, heeft elke webhook in het Developer Center een tabblad Logs met de code die je Odoo teruggaf; een 401 daar wijst op de handtekening.
Wat de connector doet als het belt
Deel roept je Odoo rechtstreeks aan, op een https-adres met een willekeurig token per koppeling, zodat FlexigoTech Cloud niet tussen de levering zit. Via FlexigoTech Cloud lopen het aanmaken en verwijderen van de webhook en de leesacties die daarna komen. Bij een geldige handtekening noteert Odoo het type event in de wachtrij, zonder de inhoud als gegeven te nemen, en wekt de taak Deel: webhook wachtrij, die daarnaast elk uur vanzelf draait. Die taak kijkt welke delen bij elke koppeling hebben gebeld en draait elk deel één keer, ook als er meerdere meldingen binnenkwamen, waarbij ze de gegevens via de API opnieuw bij Deel leest.

Hoe je hem vanuit Odoo registreert
Op het tabblad Webhooks van de koppeling klikt een beheerder op Webhook registreren. De knop verschijnt alleen als de koppeling niet meer op Niet verbonden staat (het token is al opgeslagen) en de webhook niet actief is, en daarnaast is nodig:
- dat Odoo op https draait, want anders stopt de connector en herinnert hij eraan dat «De geplande synchronisatie blijft werken zonder webhooks.»;
- dat het token
webhooks:writeheeft, het recht dat Deel vraagt om een webhook aan te maken en te verwijderen; met een token dat alleen mag lezen, antwoordt Deel volgens zijn handleiding over authenticatie met 403 of 401. Bij een 403 toont de connector de reden die Deel geeft; bij een 401 meldt hij dat Deel het token weigerde en vraagt hij om een nieuw token, ook als het token alleen dat recht mist.
De connector stuurt Deel een naam die met Odoo begint, het adres, de 12 events uit de tabel en versie v2 van de API, en bewaart de ID en de ondertekeningssleutel die Deel teruggeeft. Lukt het, dan meldt hij: «Deel roept Odoo op wanneer een betaling, een loonstrook of een contract verandert.» Webhook verwijderen wist hem bij Deel, en Verbinding verbreken ook, zolang de dienst van FlexigoTech Cloud actief is.

Waarom hij ook om de 30 minuten nakijkt
Deel raadt aan niet alleen op webhooks te vertrouwen en geregeld bij te werken. De connector doet dat met de taak Deel: synchroniseer contracten, facturen, betalingen, loonadministratie en kostendragers, die om de 30 minuten draait, met of zonder webhooks. En er zijn redenen aan de kant van Deel om die taak te houden: de lijst heeft geen event voor een uitgegeven factuur, dus nieuwe facturen komen met die ronde binnen; een webhook die Deel uitschakelt, laat Odoo niets weten; en een Odoo zonder https kan ze niet ontvangen. Met webhooks komen een betaling, een loonstrook of een contract binnen zodra Deel meldt; zonder, bij de volgende run.
Wat er getest is
Tegen de demo-organisatie van Deel (demo.deel.com) zijn via FlexigoTech Cloud de verbinding, de rechtspersonen, een contract met zijn persoon en zijn leverancier, de webhooks en een tweede run zonder duplicaten getest. Facturen, betalingen en loonperiodes zijn getest met nagebootste antwoorden op basis van de API-referentie van Deel, omdat die organisatie ze nog niet had. De connector werkt op Odoo 17, 18, 19 en 20, op je eigen server of op Odoo.sh, en niet op Odoo Online. Het token en zijn rechten staan in de gids over het Deel API token, en wat als leveranciersfactuur binnenkomt, in de gids over facturen van Deel. 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
- developer.deel.com/api/webhooks/introduction
- developer.deel.com/api/webhooks/quickstart
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/webhooks/no-code
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- developer.deel.com/api/webhooks/events
- developer.deel.com/api/stable/llms.txt
- developer.deel.com/api/endpoints/webhooks/get-webhook-events
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): controllers/main.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): static/description/index.html
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): tests/test_webhook.py
- developer.deel.com/api/authentication
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
