Naar hoofdinhoud
Deel

Deel webhooks met Odoo: handtekening, events, nieuwe pogingen en wat de connector doet

Deel kan via een webhook melden dat een betaling, een loonstrook of een contract verandert, en ondertekent elke melding met HMAC-SHA256. De Deel-connector van FlexigoTech gebruikt die meldingen als deurbel: hij controleert de handtekening, noteert wat er rinkelde en leest het gegeven opnieuw via de API. Daarnaast loopt hij om de 30 minuten alles na: de eventlijst van Deel van 18-11-2026 heeft bijvoorbeeld geen event voor een uitgegeven factuur.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 18 november 2026

In het kort

Module
Deel
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
7 min

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 binnenkomtAntwoord
Geldige handtekening200, met het event genoteerd in de wachtrij
Geen of een foute handtekening401
Een onbekend token in het adres of een in Odoo uitgeschakelde webhook404
Een body van meer dan 1 MB413

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 DeelWat de connector opnieuw leest
payment.statement.initiated, payment.statement.mark-paidDe betalingen
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.availableDe facturen
gp.payslips.availableDe loonverwerking van Global Payroll
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deletedDe 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.

Formulier van de Deel-koppeling in Odoo met de knoppen Verbinding testen, Nu synchroniseren en Verbinding verbreken, de omgeving Productie en de tekst over FlexigoTech Cloud, die webhooks noemt bij de aanroepen naar Deel
De Deel-koppeling in Odoo, met de tekst over FlexigoTech Cloud die webhooks noemt bij de aanroepen naar Deel (verzonnen organisatie, demogegevens).

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:write heeft, 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.

Instellingen van FlexigoTech Cloud in Odoo met de kaart van de Deel-connector in de proefperiode, met de prijs en de tekst dat hij de verbinding met het platform via FlexigoTech Cloud werkend houdt
De Deel-connector in de instellingen van FlexigoTech Cloud, in de proefperiode (demogegevens).

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

Deel API token voor Odoo: aanmaken, rechten geven en plakkenHoe je het organisatietoken van Deel maakt, welke rechten Deel per aanroep van de connector noemt, waar het in Odoo komt en waar het na het opslaan heen gaat.Facturen van Deel in Odoo: van de Deel-factuur naar de leveranciersfactuurWat een factuur van Deel voor contractors, EOR of Deel-kosten bevat en hoe die in Odoo binnenkomt als leveranciersfactuur, met btw, pdf en kostenplaatsen.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen