Het Deel-token dat Odoo nodig heeft
Deel onderscheidt drie tokens: het organisatietoken, dat voor de hele organisatie staat; het persoonlijke token, dat voor één gebruiker staat; en het workertoken, dat voor één werknemer via EOR staat. De connector werkt met het organisatietoken, dat standaard is aangevinkt bij Authenticatiemethode: Organisatietoken. Volgens het helpcentrum van Deel verloopt een persoonlijk token als degene die het maakte het bedrijf verlaat, terwijl een organisatietoken aan niemand vastzit en niet verloopt, al kan het geen contracten ondertekenen. Om het te maken moet je in Deel Org Admin of IT Developer Admin zijn.
Stap voor stap in het Developer Center van Deel
- Open het Developer Center. De authenticatiegids van Deel komt er via More en dan Developer; de webhookgids via het profielicoon, Settings en Developer Center; en het helpcentrum via Apps & Integrations.
- Open het tabblad Access Tokens en klik op Generate new token.
- Kies het type Organization token.
- Vink de rechten uit de tabel hieronder aan en bepaal bij welke gevoelige gegevens het token mag komen.
- Klik op Generate en kopieer het token meteen: Deel waarschuwt dat je het daarna niet meer te zien krijgt.
Deel geeft aparte sleutels voor zijn sandbox en voor productie, en vraagt ze niet te mengen. In Odoo biedt het veld Omgeving van de koppeling Productie en Testomgeving (tests), een demo-organisatie van Deel (demo.deel.com) zonder echt geld. Het token moet bij de omgeving horen die je kiest.
Welke rechten je aanvinkt
Deel noemt zijn rechten resource:read en resource:write, en zijn referentie geeft per aanroep welk recht nodig is. Dit zijn, onder meer, de aanroepen van de connector en het recht van elk, volgens de referentie van Deel op 18-11-2026:
| Waarvoor | Aanroep | Recht |
|---|---|---|
Verbinding testen | GET /organizations | organizations:read |
| Rechtspersonen | GET /legal-entities | organizations:read, accounting:read |
| Contracten en personen | GET /contracts, GET /people | contracts:read, people:read |
| Facturen, Deel-kosten en hun pdf's | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Betalingen en hun uitsplitsing | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Loonperiodes en kostenplaatsen | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Bruto-netto-rapport van elke periode | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| De webhook aanmaken en verwijderen | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Kostenplaatsen naar Deel sturen | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-entity:write |
De laatste twee rijen schrijven in Deel. De webhook wordt alleen aangemaakt als een beheerder op Webhook registreren klikt, en kostenplaatsen gaan alleen naar Deel als je Odoo de leiding geeft; standaard gaan ze van Deel naar Odoo. De hulptekst van het tokenveld vraagt om leesrechten. Met alleen die rechten weigert Deel volgens zijn referentie het aanmaken van de webhook en, als Odoo de kostenplaatsen leidt, ook het versturen ervan. De handleiding van Deel over authenticatie geeft twee mogelijke antwoorden voor een token dat een recht mist: 403 of 401. Bij een 403 blijft de synchronisatie om de 30 minuten al het andere lezen. Bij een 401 behandelt de connector het als een geweigerd token en, als Odoo de kostenplaatsen leidt, stopt elke run daar, vóór contracten, facturen, betalingen en loonperiodes; in dat geval heeft het token ook legal-entity:write nodig. Verandert Deel het recht van een aanroep, dan geldt zijn referentie.
Waar je het in Odoo plakt
In de Deel-koppeling doet een beheerder dit:
- hij vinkt
Ik ga akkoord dat FlexigoTech Cloud de Deel-gebruikersgegevens bewaartaan, want tot dan kun je het tokenveld niet invullen en wordt er niets verstuurd; - hij laat
Organisatietokenstaan bijAuthenticatiemethodeen kiest deOmgeving; - hij plakt het token in
Deel organisatietokenen slaat op.
Bij het opslaan stuurt de connector het token naar FlexigoTech Cloud, dat in de proefperiode of geabonneerd moet zijn, en zet de datum bij Gebruikersgegevens opgeslagen op. Het veld is daarna weer leeg, en dat is zo bedoeld: het is alleen-schrijven en Odoo houdt het token niet. Alleen een beheerder kan het opslaan. Daarna vraagt Verbinding testen Deel om de organisatie en haar rechtspersonen en antwoordt met de naam en het aantal.

Verander je de Omgeving of de Authenticatiemethode van een opgeslagen koppeling, dan telt de opgeslagen credential niet meer: de koppeling gaat terug naar Niet verbonden, je plakt het token opnieuw en de oude vermelding wordt uit FlexigoTech Cloud gewist.
Waar het token heen gaat
Volgens de module zelf bewaart FlexigoTech Cloud het token versleuteld, één vermelding per koppeling, en zet het bij elke aanroep naar Deel als header Authorization: Bearer, zoals Deel het wil. De aanroepen naar Deel vertrekken niet rechtstreeks uit je Odoo; het enige dat de andere kant op gaat, zijn de meldingen van de webhooks, die Deel naar je Odoo stuurt en die in de webhooks van Deel met Odoo worden uitgelegd. Verbinding verbreken wist het token uit FlexigoTech Cloud en, zolang de dienst actief is, de webhook bij Deel, en laat alles wat al gesynchroniseerd is met rust.

Deel raadt aan om inloggegevens in een veilige kluis te bewaren en nooit in code, tokens elk kwartaal te vervangen of als iemand het team verlaat, en ongebruikte tokens te wissen. Met de connector betekent vervangen: het nieuwe token in Deel maken, in hetzelfde veld plakken, opslaan en het oude in Deel wissen.
Autoriseren met Deel, vandaag
De andere optie van Authenticatiemethode, Autoriseren met Deel, koppelt zonder token te kopiëren: een Deel-beheerder keurt de app van FlexigoTech goed. Zolang FlexigoTech Cloud die app niet heeft voor de gekozen omgeving, antwoordt de connector: «Autoriseren met Deel is nog niet beschikbaar voor deze Deel-omgeving. Gebruik intussen een organisatietoken: er is niets naar Deel verzonden.»
Limieten en fouten
Deel staat 5 verzoeken per seconde per organisatie toe, alle tokens samen, in een glijdend venster van 1 seconde, en de sandbox heeft dezelfde limieten. Daarboven antwoordt Deel met 429, volgens zijn documentatie zonder headers die vooraf waarschuwen. Leest een ander programma dezelfde organisatie, dan deelt het die 5 met de connector. De synchronisatie laat minstens 0,25 seconden tussen twee aanroepen; bij een 429 wacht ze (een seconde, tenzij het antwoord om een andere wachttijd vraagt, en nooit meer dan 5), probeert het tot 3 keer opnieuw en schuift de aanroep, als het blijft mislukken, door naar de volgende run.
| Antwoord van Deel | Oorzaak volgens Deel | Wat de connector doet |
|---|---|---|
| 401 | Token ongeldig of verlopen, geen Authorization-header of ontbrekende rechten | Zet de koppeling op Deel weigerde het token en vraagt om een nieuw token |
| 403 | Het token mist het recht voor die aanroep | Ziet het token niet als fout: hij toont de reden die Deel geeft |
| 429 | Meer dan 5 verzoeken per seconde in de organisatie | Wacht en probeert opnieuw |
Een notitie in de code van de connector noemt nog een 403, de «Error 1010»: dat is de Cloudflare van Deel die de User-Agent van Python-urllib blokkeert, en daarom stuurt de connector altijd zijn eigen. Om te zien waarom Deel een aanroep weigerde, bewaren de Request logs in het Developer Center 15 dagen aan verzoeken met de tokens van de organisatie, ook de geweigerde, met de reden.
Wat er getest is
De connector werkt op Odoo 17, 18, 19 en 20, op je eigen server of op Odoo.sh, en niet op Odoo Online. Hij 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. Facturen, betalingen en loonperiodes zijn getest met nagebootste antwoorden op basis van de API-referentie van Deel, omdat die organisatie ze nog niet had. Wat daarna als leveranciersfactuur binnenkomt, staat in de gids over facturen van Deel, en de vergelijking met de integraties van Deel in Deel integrations. 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/authentication
- help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API
- developer.deel.com/api/webhooks/no-code
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/sandbox
- 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_cost_center.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): models/deel_contract.py
- 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_payroll.py
- developer.deel.com/api/rate-limits
- developer.deel.com/api/endpoints/organizations/get-organizations
- developer.deel.com/api/endpoints/legal-entities/get-legal-entities
- developer.deel.com/api/endpoints/contracts/get-contracts
- developer.deel.com/api/hris-endpoints/people/get-people
- developer.deel.com/api/reference/endpoints/accounting/retrieve-deel-invoices-v-2026-01-01
- developer.deel.com/api/reference/endpoints/accounting/get-billing-invoice-download-link-v-
- 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-
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- developer.deel.com/api/endpoints/cost-centers/get-legal-entity-cost-centers
- developer.deel.com/api/reference/endpoints/cost-centers/sync-cost-centers-for-legal-entity
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- 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
- 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
