Zum Hauptinhalt springen
Deel

Deel Webhooks mit Odoo: Signatur, Ereignisse, Wiederholungen und was der Connector tut

Deel kann per Webhook melden, wenn sich eine Zahlung, eine Lohnabrechnung oder ein Vertrag ändert, und signiert jede Meldung mit HMAC-SHA256. Der Deel-Connector von FlexigoTech nutzt diese Meldungen als Klingel: Er prüft die Signatur, notiert, was geklingelt hat, und liest die Daten über die API neu. Außerdem gleicht er alle 30 Minuten alles ab: Die Ereignisliste von Deel vom 18-11-2026 hat zum Beispiel kein Ereignis für eine ausgestellte Rechnung.

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.

Wie Deel meldet

Passiert etwas im Konto, schickt Deel einen POST an die Adresse des Webhooks, mit einem JSON, das den Ereignistyp in data.meta.event_type, die Organisation, die geänderte Ressource und die Uhrzeit enthält. Jede Zustellung hat drei Header: x-deel-signature mit der Signatur, x-deel-hmac-label, der angibt, welcher Signaturschlüssel verwendet wurde, und x-deel-webhook-version. Webhooks werden über die API mit POST /webhooks angelegt oder im Reiter Webhooks des Developer Center, und dafür muss man in Deel Org Admin oder IT Developer Admin sein. Ein in der Sandbox angelegter Webhook erhält nur Sandbox-Ereignisse.

Wie die Signatur geprüft wird

Deel berechnet einen HMAC-SHA256 aus dem Wort POST, gefolgt vom unveränderten Body, mit dem Signaturschlüssel des Webhooks, und bittet darum, ihn vor jeder Verarbeitung zu prüfen. Diesen Schlüssel (signing_key) gibt Deel beim Anlegen des Webhooks zurück und erzeugt ihn selbst, wenn keiner mitgegeben wird. Seine Codebeispiele geben die Signatur hexadezimal aus.

Der Controller des Connectors rechnet genauso, mit dem in der Verbindung gespeicherten Schlüssel, vergleicht das Ergebnis in konstanter Zeit mit x-deel-signature und antwortet so:

Was bei Odoo ankommtAntwort
Gültige Signatur200, mit dem Ereignis in der Warteschlange
Keine oder eine falsche Signatur401
Ein unbekanntes Token in der Adresse oder ein in Odoo abgeschalteter Webhook404
Ein Body über 1 MB413

Anders als das API-Token, das FlexigoTech Cloud aufbewahrt, bleibt der Signaturschlüssel in Odoo, in der Verbindung, in einem Feld nur für Administratoren. Die Tests des Moduls prüfen die Signatur mit der Berechnung aus dem Python-Beispiel von Deel, und gegen die Demo-Organisation von Deel wurden das Anlegen und das Löschen des Webhooks getestet.

Welche Ereignisse es gibt

Die Ereignisseite von Deel spricht von mehr als 100 („100+ Events“) und verweist für die vollständige Liste auf GET /webhooks/events/types, das die Berechtigung webhooks:read braucht. Im Index der API-Referenz von Deel, kopiert am 18-11-2026, stehen 56 Ereignisse mit eigener Seite. In dieser Liste gibt es kein Ereignis für eine ausgestellte Rechnung und keines für einen Brutto-Netto-Bericht: Bei Rechnungen gibt es nur die Anpassungen (Invoice Adjustment Created, Pending For Approval und Reviewed), bei der Lohnabrechnung die Ereignisse für verfügbare Abrechnungen von Global Payroll und EOR und das für ein gelöschtes Abrechnungsdokument, bei Zahlungen den gestarteten und den als bezahlt markierten Kontoauszug.

Der Connector abonniert 12 dieser Ereignisse, und jedes sagt ihm nur, welchen Teil der Synchronisierung er laufen lassen soll:

Ereignisse von DeelWas der Connector neu liest
payment.statement.initiated, payment.statement.mark-paidDie Zahlungen
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.availableDie Rechnungen
gp.payslips.availableDie Lohnabrechnung von Global Payroll
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deletedPersonen und Verträge

Ein Ereignis, das der Connector nicht kennt, wird notiert und als erledigt markiert, ohne dass etwas läuft.

Wiederholungen und Deaktivierung laut Deel

Antwortet die Adresse nicht mit einem 2xx oder braucht sie länger als 30 Sekunden, zählt Deel das als Fehler und versucht es erneut, nach Wartezeiten von 1, 2, 4, 8, 16 und 32 Minuten, dann von 1, 2 und 4 Stunden, und ein zehntes Mal nach 16 Stunden. Nach 10 Fehlern in Folge deaktiviert Deel das Abonnement, das dann von Hand wieder aktiviert werden muss, über die API oder im Developer Center. Deel verlangt eine 200 innerhalb von 30 Sekunden, besser unter 5, und weist darauf hin, dass dasselbe Ereignis mehr als einmal ankommen kann.

Der Connector antwortet, sobald er das Ereignis notiert hat; die Synchronisierung folgt danach in der Warteschlange. In Odoo wird Webhook aktiv nur durch Webhook entfernen oder durch Trennen zurückgesetzt, und der Connector fragt Deel nicht nach dem Zustand des Webhooks. Deaktiviert Deel ihn nach 10 Fehlern, etwa weil Odoo ausgefallen war, sieht Odoo ihn weiter als aktiv: Man aktiviert ihn im Developer Center von Deel wieder oder entfernt ihn und registriert ihn in Odoo neu. In der Zwischenzeit liefert die Synchronisierung alle 30 Minuten dieselben Daten. Um zu sehen, was mit jeder Zustellung passiert ist, hat jeder Webhook im Developer Center einen Reiter Logs mit dem Code, den Ihr Odoo zurückgegeben hat; eine 401 dort deutet auf die Signatur.

Was der Connector tut, wenn es klingelt

Deel ruft Ihr Odoo direkt auf, unter einer https-Adresse mit einem zufälligen Token je Verbindung, FlexigoTech Cloud steht also nicht in der Zustellung. Über FlexigoTech Cloud laufen das Anlegen und das Entfernen des Webhooks und die Abrufe danach. Bei gültiger Signatur notiert Odoo den Ereignistyp in der Warteschlange, ohne den Inhalt als Daten zu nehmen, und weckt die Aufgabe Deel: Webhook-Warteschlange, die außerdem jede Stunde von selbst läuft. Diese Aufgabe sieht nach, welche Teile in jeder Verbindung geklingelt haben, und lässt jeden davon einmal laufen, auch wenn mehrere Meldungen eingegangen sind, wobei sie die Daten über die API neu bei Deel abruft.

Formular der Deel-Verbindung in Odoo mit den Schaltflächen Verbindung testen, Jetzt synchronisieren und Trennen, der Umgebung Produktion und dem Text zu FlexigoTech Cloud, der Webhooks unter den Aufrufen an Deel nennt
Die Deel-Verbindung in Odoo, mit dem Text zu FlexigoTech Cloud, der Webhooks unter den Aufrufen an Deel nennt (erfundene Organisation, Demodaten).

So wird er in Odoo angelegt

Im Reiter Webhooks der Verbindung klickt ein Administrator auf Webhook registrieren. Die Schaltfläche erscheint nur, wenn die Verbindung nicht mehr auf Nicht verbunden steht (das Token ist schon gespeichert) und der Webhook nicht aktiv ist, und außerdem braucht es:

  • Odoo unter https, denn sonst hält der Connector an und erinnert daran: „Die geplante Synchronisierung funktioniert ohne Webhooks weiter.“;
  • ein Token mit webhooks:write, der Berechtigung, die Deel zum Anlegen und zum Löschen eines Webhooks verlangt; mit einem reinen Lese-Token antwortet Deel laut seiner Anleitung zur Authentifizierung mit 403 oder 401. Bei einem 403 zeigt der Connector den Grund, den Deel nennt; bei einem 401 meldet er, dass Deel das Token abgelehnt hat, und bittet um ein neues, auch wenn dem Token nur diese Berechtigung fehlt.

Der Connector schickt Deel einen Namen, der mit Odoo beginnt, die Adresse, die 12 Ereignisse aus der Tabelle und die Version v2 der API, und speichert die ID und den Signaturschlüssel, die Deel zurückgibt. Klappt es, meldet er: „Deel ruft Odoo auf, wenn sich eine Zahlung, ein Gehaltsabrechnungsbeleg oder ein Vertrag ändert.“ Webhook entfernen löscht ihn in Deel, und Trennen ebenso, solange der Dienst von FlexigoTech Cloud aktiv ist.

Einstellungen von FlexigoTech Cloud in Odoo mit 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).

Warum er zusätzlich alle 30 Minuten abgleicht

Deel empfiehlt, sich nicht allein auf Webhooks zu verlassen und regelmäßig abzugleichen. Der Connector tut das mit der Aufgabe Deel: Verträge, Rechnungen, Zahlungen, Lohnabrechnungen und Kostenstellen synchronisieren, die alle 30 Minuten läuft, ob es Webhooks gibt oder nicht. Und es gibt Gründe auf der Seite von Deel, sie nicht abzuschalten: Seine Liste hat kein Ereignis für eine ausgestellte Rechnung, neue Rechnungen kommen also mit diesem Abgleich; ein Webhook, den Deel deaktiviert, meldet sich nicht bei Odoo; und ein Odoo ohne https kann keine empfangen. Mit Webhooks kommen eine Zahlung, eine Lohnabrechnung oder ein Vertrag an, sobald Deel meldet; ohne sie beim nächsten Lauf.

Was getestet wurde

Gegen die Demo-Organisation von Deel (demo.deel.com) wurden über FlexigoTech Cloud die Verbindung, die Rechtseinheiten, ein Vertrag mit seiner Person und seinem Lieferanten, die Webhooks und ein zweiter Durchlauf ohne Duplikate getestet. Rechnungen, Zahlungen und Lohnabrechnungszyklen wurden mit Antworten getestet, die auf der API-Referenz von Deel beruhen, weil diese Organisation noch keine hatte. Der Connector läuft auf Odoo 17, 18, 19 und 20, auf Ihrem Server oder auf Odoo.sh, nicht auf Odoo Online. Das Token und seine Berechtigungen stehen in der Anleitung zum Deel API Token, und was als Lieferantenrechnung ankommt, in Deel invoice. Der Connector ist auf seiner Seite vollständig erklärt und auf Odoo Apps veröffentlicht.

Weiterlesen

Deel API Token für Odoo: erstellen, berechtigen und einfügenWie Sie das Deel-Organisationstoken erstellen, welche Berechtigung Deel für jeden Aufruf des Connectors nennt, wo es in Odoo hinkommt und wohin es geht.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.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen