Zum Hauptinhalt springen
Deel

Deel API Token für Odoo: erstellen, berechtigen und einfügen

Deel kennt drei Arten von Token für seine API, und der Odoo-Connector nutzt eine davon: das Organisationstoken, das ein Deel-Administrator im Developer Center von Deel erstellt. Hier finden Sie die Schritte, die Berechtigung, die die Referenz von Deel für jeden Aufruf des Connectors verlangt, die Stelle in Odoo, an der das Token eingefügt wird, und was beim Speichern damit passiert.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 18. November 2026

Das Wichtigste

Modul
Deel
Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
6 Min.

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

  1. Ö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.
  2. Öffnen Sie den Reiter Access Tokens und klicken Sie auf Generate new token.
  3. Wählen Sie den Typ Organization token.
  4. Setzen Sie die Berechtigungen aus der Tabelle unten und legen Sie fest, auf welche sensiblen Daten das Token zugreifen darf.
  5. 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ürAufrufBerechtigung
Verbindung testenGET /organizationsorganizations:read
RechtseinheitenGET /legal-entitiesorganizations:read, accounting:read
Verträge und PersonenGET /contracts, GET /peoplecontracts:read, people:read
Rechnungen, Deel-Gebühren und ihre PDFsGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Zahlungen und ihre AufschlüsselungGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Lohnabrechnungszyklen und KostenstellenGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Brutto-Netto-Bericht jedes ZyklusGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Webhook anlegen und entfernenPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Kostenstellen an Deel sendenPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-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 Organisationstoken unter Authentifizierungsmethode stehen und wählt die Umgebung;
  • er fügt das Token in Deel-Organisationstoken ein 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.

Deel-Verbindung in Odoo mit der Methode Organisationstoken, der akzeptierten Zustimmung für FlexigoTech Cloud, dem leeren Token-Feld und dem Datum, an dem die Anmeldedaten gespeichert wurden
Die Verbindung mit bereits gespeichertem Token: Das Feld ist leer, und das Datum zeigt, wann es gesendet wurde (erfundene Organisation, Demodaten).

Ä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.

Einstellungen von FlexigoTech Cloud in Odoo mit verbundener Datenbank und der Karte des Deel-Connectors in der Testphase, mit ihrem Preis und dem Text, dass er die Verbindung mit der Plattform über FlexigoTech Cloud aufrechterhält
Der Deel-Connector in den Einstellungen von FlexigoTech Cloud, in der Testphase (Demodaten).

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 DeelUrsache laut DeelWas der Connector tut
401Token ungültig oder abgelaufen, kein Authorization-Header oder fehlende BerechtigungenSetzt die Verbindung auf Deel lehnte den Token ab und bittet um ein neues
403Dem Token fehlt die Berechtigung für diesen AufrufHält das Token nicht für ungültig: Er zeigt den Grund, den Deel nennt
429Mehr als 5 Anfragen pro Sekunde in der OrganisationWartet 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

Deel Webhooks mit Odoo: Signatur, Ereignisse, Wiederholungen und was der Connector tutWie Deel jeden Webhook signiert, welche Ereignisse seine Liste hat, wann es wiederholt oder deaktiviert und was der Deel-Connector für Odoo damit macht.Deel invoice in Odoo: von der Deel-Rechnung zur LieferantenrechnungWas eine Deel invoice für Auftragnehmer, EOR oder Deel-Gebühren enthält und wie sie in Odoo als Lieferantenrechnung mit MwSt., PDF und Kostenstellen ankommt.Deel integrations für die Buchhaltung: was GL Sync und Bill Sync tun und wie Sie das in Odoo bekommenDeel verbindet seine Buchhaltungsdaten mit NetSuite, Xero, QuickBooks, Sage, SAP und Dynamics. Odoo fehlt in der Liste: was ein Connector abdeckt und was nicht.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen