Das Deel-Token, das Odoo braucht
Deel unterscheidet drei Token: das Organisationstoken, das für die ganze Organisation steht; das persönliche Token, das für einen Benutzer steht; und das Worker-Token, das für einen EOR-Mitarbeiter steht. Der Connector arbeitet mit dem Organisationstoken, das unter Authentifizierungsmethode voreingestellt ist: Organisationstoken. Laut dem Hilfe-Center von Deel läuft ein persönliches Token ab, wenn die Person, die es erstellt hat, das Unternehmen verlässt; ein Organisationstoken hängt an niemandem und läuft nicht ab, kann aber keine Verträge unterschreiben. Um es zu erstellen, müssen Sie in Deel Org Admin oder IT Developer Admin sein.
Schritt für Schritt im Developer Center von Deel
- Öffnen Sie das Developer Center. Die Authentifizierungsanleitung von Deel kommt über More und dann Developer dorthin; die Webhook-Anleitung über das Profilsymbol, Settings und Developer Center; das Hilfe-Center über Apps & Integrations.
- Öffnen Sie den Reiter Access Tokens und klicken Sie auf Generate new token.
- Wählen Sie den Typ Organization token.
- Setzen Sie die Berechtigungen aus der Tabelle unten und legen Sie fest, auf welche sensiblen Daten das Token zugreifen darf.
- Klicken Sie auf Generate und kopieren Sie das Token sofort: Deel weist darauf hin, dass es danach nicht mehr angezeigt wird.
Deel vergibt für seine Sandbox und für die Produktion getrennte Schlüssel und bittet darum, sie nicht zu mischen. In Odoo bietet das Feld Umgebung der Verbindung Produktion und Sandbox (Tests); Letzteres ist eine Demo-Organisation von Deel (demo.deel.com) ohne echtes Geld. Das Token muss zu der Umgebung gehören, die Sie wählen.
Welche Berechtigungen Sie setzen
Deel nennt seine Berechtigungen ressource:read und ressource:write, und seine Referenz gibt für jeden Aufruf die nötige an. Das sind, unter anderem, die Aufrufe des Connectors und die Berechtigung für jeden, laut der Referenz von Deel vom 18-11-2026:
| Wofür | Aufruf | Berechtigung |
|---|---|---|
Verbindung testen | GET /organizations | organizations:read |
| Rechtseinheiten | GET /legal-entities | organizations:read, accounting:read |
| Verträge und Personen | GET /contracts, GET /people | contracts:read, people:read |
| Rechnungen, Deel-Gebühren und ihre PDFs | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Zahlungen und ihre Aufschlüsselung | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Lohnabrechnungszyklen und Kostenstellen | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Brutto-Netto-Bericht jedes Zyklus | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| Webhook anlegen und entfernen | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Kostenstellen an Deel senden | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-entity:write |
Die letzten beiden Zeilen schreiben in Deel. Der Webhook wird nur angelegt, wenn ein Administrator auf Webhook registrieren klickt, und Kostenstellen gehen nur an Deel, wenn Sie Odoo die Führung geben; voreingestellt ist, dass sie von Deel nach Odoo kommen. Die Hilfe des Token-Feldes verlangt Leseberechtigungen. Nur mit diesen lehnt Deel laut seiner Referenz das Anlegen des Webhooks ab und, wenn Odoo die Kostenstellen führen soll, auch deren Versand. Die Anleitung von Deel zur Authentifizierung nennt für ein Token, dem eine Berechtigung fehlt, zwei mögliche Antworten: 403 oder 401. Bei einem 403 liest die Synchronisierung alle 30 Minuten alles andere weiter. Bei einem 401 behandelt der Connector das Token als abgelehnt, und wenn Odoo die Kostenstellen führt, bricht jeder Lauf dort ab, bevor er Verträge, Rechnungen, Zahlungen und Lohnabrechnungen erreicht; dann braucht das Token zusätzlich legal-entity:write. Ändert Deel die Berechtigung eines Aufrufs, gilt seine Referenz.
Wo es in Odoo hinkommt
In der Deel-Verbindung macht ein Administrator Folgendes:
- Er setzt
Ich akzeptiere, dass FlexigoTech Cloud die Deel-Anmeldedaten speichert, denn bis dahin lässt sich das Token-Feld nicht ausfüllen und nichts wird gesendet; - er lässt
OrganisationstokenunterAuthentifizierungsmethodestehen und wählt dieUmgebung; - er fügt das Token in
Deel-Organisationstokenein und speichert.
Beim Speichern schickt der Connector das Token an FlexigoTech Cloud, das in der Testphase oder abonniert sein muss, und trägt das Datum unter Anmeldedaten gespeichert am ein. Das Feld ist danach wieder leer, und zwar mit Absicht: Es ist nur beschreibbar, und Odoo behält das Token nicht. Nur ein Administrator kann es speichern. Danach fragt Verbindung testen bei Deel die Organisation und ihre Rechtseinheiten ab und antwortet mit dem Namen und deren Anzahl.

Ändern Sie die Umgebung oder die Authentifizierungsmethode einer gespeicherten Verbindung, gelten die gespeicherten Anmeldedaten nicht mehr: Die Verbindung springt auf Nicht verbunden zurück, Sie fügen das Token erneut ein, und der alte Eintrag wird aus FlexigoTech Cloud gelöscht.
Wohin das Token geht
Laut dem Modul selbst speichert FlexigoTech Cloud das Token verschlüsselt, einen Eintrag pro Verbindung, und setzt es bei jedem Aufruf an Deel als Header Authorization: Bearer, so wie Deel es vorsieht. Die Aufrufe an Deel gehen nicht direkt von Ihrem Odoo aus; in die Gegenrichtung laufen nur die Webhook-Meldungen, die Deel an Ihr Odoo schickt und die in Deel-Webhooks mit Odoo erklärt sind. Trennen löscht das Token aus FlexigoTech Cloud und, solange der Dienst aktiv ist, den Webhook in Deel und lässt alles bereits Synchronisierte unangetastet.

Deel empfiehlt, Zugangsdaten in einem sicheren Tresor und nie im Code aufzubewahren, Token jedes Quartal oder beim Weggang eines Teammitglieds zu wechseln und ungenutzte zu löschen. Mit dem Connector heißt Wechseln: das neue Token in Deel erstellen, in dasselbe Feld einfügen, speichern und das alte in Deel löschen.
Mit Deel autorisieren, heute
Die andere Option unter Authentifizierungsmethode, Mit Deel autorisieren, verbindet ohne kopiertes Token: Ein Deel-Administrator genehmigt die App von FlexigoTech. Solange FlexigoTech Cloud diese App für die gewählte Umgebung nicht hat, antwortet der Connector: „Mit Deel autorisieren ist für diese Deel-Umgebung noch nicht verfügbar. Verwenden Sie in der Zwischenzeit ein Organisationstoken: Es wurde nichts an Deel gesendet.“
Grenzen und Fehler
Deel erlaubt 5 Anfragen pro Sekunde und Organisation, über alle ihre Token zusammen, in einem gleitenden Fenster von 1 Sekunde, und seine Sandbox hat dieselben Grenzen. Darüber antwortet es mit 429 und schickt laut seiner Dokumentation vorher keine warnenden Header. Liest ein anderes Programm dieselbe Organisation, teilt es sich diese 5 mit dem Connector. Die Synchronisierung lässt mindestens 0,25 Sekunden zwischen zwei Aufrufen; bei einem 429 wartet sie (eine Sekunde, sofern die Antwort keine andere Wartezeit verlangt, und nie mehr als 5), wiederholt bis zu 3 Mal und verschiebt den Aufruf, wenn es weiter scheitert, auf den nächsten Lauf.
| Antwort von Deel | Ursache laut Deel | Was der Connector tut |
|---|---|---|
| 401 | Token ungültig oder abgelaufen, kein Authorization-Header oder fehlende Berechtigungen | Setzt die Verbindung auf Deel lehnte den Token ab und bittet um ein neues |
| 403 | Dem Token fehlt die Berechtigung für diesen Aufruf | Hält das Token nicht für ungültig: Er zeigt den Grund, den Deel nennt |
| 429 | Mehr als 5 Anfragen pro Sekunde in der Organisation | Wartet und wiederholt |
Eine Notiz im Code des Connectors nennt noch einen 403, den „Error 1010“: Das ist das Cloudflare von Deel, das den User-Agent von Python-urllib sperrt, und deshalb schickt der Connector immer seinen eigenen. Um zu sehen, warum Deel einen Aufruf abgelehnt hat, bewahren die Request logs im Developer Center 15 Tage lang die Anfragen mit den Token der Organisation auf, auch die abgelehnten, samt Grund.
Was getestet wurde
Der Connector läuft auf Odoo 17, 18, 19 und 20, auf Ihrem Server oder auf Odoo.sh, nicht auf Odoo Online. Er wurde über FlexigoTech Cloud durchgängig gegen eine Demo-Organisation von Deel (demo.deel.com) getestet: die Verbindung, die Rechtseinheiten, ein Vertrag mit seiner Person und seinem Lieferanten, die Webhooks und ein zweiter Durchlauf ohne Duplikate. Rechnungen, Zahlungen und Lohnabrechnungszyklen wurden mit Antworten getestet, die auf der API-Referenz von Deel beruhen, weil diese Organisation noch keine hatte. Was danach als Lieferantenrechnung ankommt, steht in der Anleitung zur Deel invoice, und der Vergleich mit den Integrationen von Deel in Deel integrations. Der Connector ist auf seiner Seite vollständig erklärt und auf Odoo Apps veröffentlicht.
Weiterlesen
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen
Quellen
- 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
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_cost_center.py
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Quellcode des Moduls: 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
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Quellcode des Moduls: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
