Naar hoofdinhoud
Deel

Deel API token voor Odoo: aanmaken, rechten geven en plakken

Deel kent drie soorten tokens voor zijn API en de Odoo-connector gebruikt er één: het organisatietoken, dat een Deel-beheerder in het Developer Center van Deel aanmaakt. Hier staan de stappen, het recht dat de referentie van Deel per aanroep van de connector vraagt, waar je het token in Odoo plakt en wat er bij het opslaan mee gebeurt.

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

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

  1. 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.
  2. Open het tabblad Access Tokens en klik op Generate new token.
  3. Kies het type Organization token.
  4. Vink de rechten uit de tabel hieronder aan en bepaal bij welke gevoelige gegevens het token mag komen.
  5. 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:

WaarvoorAanroepRecht
Verbinding testenGET /organizationsorganizations:read
RechtspersonenGET /legal-entitiesorganizations:read, accounting:read
Contracten en personenGET /contracts, GET /peoplecontracts:read, people:read
Facturen, Deel-kosten en hun pdf'sGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Betalingen en hun uitsplitsingGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Loonperiodes en kostenplaatsenGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Bruto-netto-rapport van elke periodeGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
De webhook aanmaken en verwijderenPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Kostenplaatsen naar Deel sturenPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-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 bewaart aan, want tot dan kun je het tokenveld niet invullen en wordt er niets verstuurd;
  • hij laat Organisatietoken staan bij Authenticatiemethode en kiest de Omgeving;
  • hij plakt het token in Deel organisatietoken en 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.

Deel-koppeling in Odoo met de methode organisatietoken gekozen, de toestemming voor FlexigoTech Cloud aangevinkt, het tokenveld leeg en onderaan een datum naast het afgesneden label Gebruikersgegevens
De koppeling in de status Aangesloten: het tokenveld is leeg en onderaan staat een datum bij Gebruikersgegevens (verzonnen organisatie, demogegevens).

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.

Instellingen van FlexigoTech Cloud in Odoo met de database verbonden en 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).

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 DeelOorzaak volgens DeelWat de connector doet
401Token ongeldig of verlopen, geen Authorization-header of ontbrekende rechtenZet de koppeling op Deel weigerde het token en vraagt om een nieuw token
403Het token mist het recht voor die aanroepZiet het token niet als fout: hij toont de reden die Deel geeft
429Meer dan 5 verzoeken per seconde in de organisatieWacht 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

Deel webhooks met Odoo: handtekening, events, nieuwe pogingen en wat de connector doetHoe Deel elke webhook ondertekent, welke events zijn lijst heeft, wanneer Deel opnieuw probeert of uitschakelt en wat de Deel-connector voor Odoo ermee doet.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.Deel integrations voor de boekhouding: wat GL Sync en Bill Sync doen en hoe je dat in Odoo krijgtDeel koppelt zijn boekhoudgegevens aan NetSuite, Xero, QuickBooks, Sage, SAP en Dynamics. Odoo staat niet in de lijst: wat een connector dekt en wat niet.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen