Com avisa Deel
Quan passa alguna cosa al compte, Deel fa un POST a l'adreça del webhook amb un JSON que porta el tipus d'esdeveniment a data.meta.event_type, l'organització, el recurs que ha canviat i l'hora. Cada lliurament porta tres capçaleres: x-deel-signature, amb la signatura; x-deel-hmac-label, que diu quina clau de signatura s'ha fet servir; i x-deel-webhook-version. Els webhooks es creen per l'API, amb POST /webhooks, o a la pestanya Webhooks del Developer Center, i per fer-ho cal ser Org Admin o IT Developer Admin a Deel. Un webhook creat al sandbox només rep esdeveniments del sandbox.
Com es comprova la signatura
Deel calcula un HMAC-SHA256 de la paraula POST seguida del cos tal com arriba, amb la clau de signatura del webhook, i demana comprovar-lo abans de processar res. Aquesta clau (signing_key) la torna Deel quan es crea el webhook, i la genera ell mateix si no se li'n dona cap. Els seus exemples de codi treuen la signatura en hexadecimal.
El controlador del connector fa el mateix càlcul amb la clau desada a la connexió, el compara amb x-deel-signature en temps constant i respon així:
| El que arriba a Odoo | Resposta |
|---|---|
| Signatura bona | 200, amb l'esdeveniment apuntat a la cua |
| Sense signatura o amb una signatura dolenta | 401 |
| Un token d'adreça desconegut o un webhook desactivat a Odoo | 404 |
| Un cos de més d'1 MB | 413 |
A diferència del token de l'API, que guarda FlexigoTech Cloud, la clau de signatura es queda a Odoo, a la connexió, en un camp reservat als administradors. Les proves del mòdul comproven la signatura amb el càlcul de l'exemple en Python de Deel, i contra l'organització de demostració de Deel es van provar l'alta i la baixa del webhook.
Quins esdeveniments hi ha
La pàgina d'esdeveniments de Deel parla de més de 100 («100+ Events») i, per a la llista completa, remet a GET /webhooks/events/types, que demana el permís webhooks:read. A l'índex de la seva referència de l'API, copiat el 18-11-2026, hi ha 56 esdeveniments amb pàgina pròpia. En aquesta llista no hi ha cap esdeveniment de factura emesa ni d'informe brut-net: de factures només hi ha els ajustos (Invoice Adjustment Created, Pending For Approval i Reviewed); de nòmines, els de nòmines disponibles de Global Payroll i d'EOR i el d'un document de nòmina esborrat; i de pagaments, l'extracte iniciat i el marcat com a pagat.
El connector se subscriu a 12 d'aquests esdeveniments, i cadascun només li diu quina part de la sincronització ha de córrer:
| Esdeveniments de Deel | El que torna a llegir el connector |
|---|---|
payment.statement.initiated, payment.statement.mark-paid | Els pagaments |
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.available | Les factures |
gp.payslips.available | La nòmina de Global Payroll |
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deleted | Les persones i els contractes |
Un esdeveniment que el connector no coneix s'apunta i es dona per fet sense córrer res.
Reintents i desactivació, segons Deel
Si l'adreça no respon amb un 2xx, o triga més de 30 segons, Deel ho compta com a error i reintenta amb esperes d'1, 2, 4, 8, 16 i 32 minuts, després d'1, 2 i 4 hores, i un desè intent al cap de 16 hores. Amb 10 errors seguits desactiva la subscripció, i cal tornar-la a activar a mà, per l'API o al Developer Center. Deel demana respondre 200 en menys de 30 segons, millor en menys de 5, i avisa que un mateix esdeveniment pot arribar més d'una vegada.
El connector respon tan bon punt apunta l'esdeveniment; la sincronització ve després, a la cua. A Odoo, Webhook Actiu només es desmarca amb Eliminar webhook o amb Desconnectar, i el connector no pregunta a Deel en quin estat és el webhook. Si Deel el desactiva després de 10 errors, per exemple perquè Odoo estava caigut, Odoo el continuarà veient actiu: es reactiva al Developer Center de Deel, o s'elimina i es torna a registrar des d'Odoo. Mentrestant, la sincronització de cada 30 minuts continua portant el mateix. Per saber què ha passat amb cada lliurament, cada webhook té al Developer Center una pestanya Logs amb el codi que ha retornat el teu Odoo; un 401 allà apunta a la signatura.
Què fa el connector quan sona
Deel crida directament el teu Odoo, a una adreça https que porta un token aleatori de cada connexió, de manera que FlexigoTech Cloud no és enmig del lliurament. Per FlexigoTech Cloud passen l'alta i la baixa del webhook i les lectures que vénen després. Amb la signatura bona, Odoo apunta a la cua el tipus d'esdeveniment, sense prendre el contingut com a dada, i desperta la tasca Deel: cua de webhooks, que a més corre sola cada hora. Aquesta tasca mira quines parts han sonat a cada connexió i en corre cadascuna una sola vegada, encara que hagin arribat diversos avisos, i torna a llegir de Deel per l'API.

Com es dona d'alta des d'Odoo
A la pestanya Webhooks de la connexió, un administrador prem Registrar webhook. El botó només apareix si la connexió ja no està en No connectat (el token ja està desat) i el webhook no està actiu, i a més cal:
- que Odoo sigui en https, perquè si no el connector s'atura i recorda que «La sincronització programada segueix funcionant sense webhooks.»;
- que el token tingui
webhooks:write, el permís que demana Deel per crear i per esborrar un webhook; amb un token només de lectura, Deel respon 403 o 401, segons la seva guia d'autenticació. Amb un 403, el connector mostra el motiu que dona Deel; amb un 401, diu que Deel ha rebutjat el token i demana desar-ne un de nou, encara que al token només li falti aquest permís.
El connector envia a Deel un nom que comença per Odoo, l'adreça, els 12 esdeveniments de la taula i la versió v2 de l'API, i desa l'identificador i la clau de signatura que torna Deel. Si va bé, avisa: «Deel trucarà a Odoo quan canviï un pagament, una nòmina o un contracte.» Eliminar webhook l'esborra a Deel, i Desconnectar també, si el servei de FlexigoTech Cloud està actiu.

Per què a més repassa cada 30 minuts
Deel recomana no refiar-se només dels webhooks i repassar de tant en tant. El connector ho fa amb la tasca Deel: sincronitzar contractes, factures, pagaments, nòmines i centres de costos, que corre cada 30 minuts hi hagi webhooks o no. I hi ha motius per part de Deel per no treure-la: a la seva llista no hi ha cap esdeveniment de factura emesa, així que les factures noves arriben amb aquest repàs; un webhook que Deel desactiva no avisa Odoo; i un Odoo sense https no els pot rebre. Amb webhooks, un pagament, una nòmina o un contracte arriben tan bon punt Deel avisa; sense, a la passada següent.
El que s'ha provat
Contra l'organització de demostració de Deel (demo.deel.com), a través de FlexigoTech Cloud, es van provar la connexió, les entitats legals, un contracte amb la seva persona i el seu proveïdor, els webhooks i una segona passada sense duplicats. Factures, pagaments i cicles de nòmina es van provar amb respostes fetes sobre la referència de l'API de Deel, perquè aquella organització encara no en tenia. El connector funciona a Odoo 17, 18, 19 i 20, al teu servidor o a Odoo.sh, i no a Odoo Online. El token i els seus permisos són a la guia del Deel API token, i el que entra com a factura de proveïdor, a Deel invoice. El connector està explicat sencer a la seva pàgina i publicat a Odoo Apps.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- developer.deel.com/api/webhooks/introduction
- developer.deel.com/api/webhooks/quickstart
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/webhooks/no-code
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- developer.deel.com/api/webhooks/events
- developer.deel.com/api/stable/llms.txt
- developer.deel.com/api/endpoints/webhooks/get-webhook-events
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): controllers/main.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): static/description/index.html
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): tests/test_webhook.py
- developer.deel.com/api/authentication
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
