L'informe gross to net de Deel
Segons el seu centre d'ajuda, Deel Global Payroll genera un informe brut a net a cada cicle, amb el mateix format a tots els països, i cada informe és d'un sol cicle. S'obre a Analytics, entre els informes de nòmina, i s'exporta en CSV, XLSX o PDF. Deel també adverteix que el G2N recull resultats de nòmina i no regles comptables, així que no porta apunts al deure i a l'haver, ni lògica per assignar comptes, ni validació. Sense una integració, algú de comptabilitat prepara a mà l'assentament de cada cicle a partir d'aquesta descàrrega.
L'API de Deel dona el mateix informe per cicle amb GET /reports/payroll/cycles/{cycle_id}/gross-to-net. Per a cada contracte retorna la seva moneda (currency), el tipus de canvi entre la moneda de la nòmina i la del pagament (conversion_rate) i la llista de conceptes, cadascun amb el seu nom (label), el seu import (value), la seva categoria i un d'aquests grups (category_group):
| Grup de Deel | Què recull |
|---|---|
ADDITIONS | El que s'afegeix al sou brut, com el sou base |
DEDUCTIONS | El que es descompta a la persona, com la seva retenció i la seva cotització |
BENEFITS | Beneficis |
CONTRIBUTIONS | Cotitzacions de l'empresa |
INFOS | Informació |
TOTALS | Totals, com el net a pagar |
El connector llegeix totes les pàgines de l'informe i desa cada concepte com una línia del cicle a Odoo. Deel dona 20 contractes per pàgina si no se li demana una altra mida; el connector en demana 50, i això no s'ha provat amb un informe real.
Quan està llest un cicle
El connector demana els cicles de cada entitat legal amb GET /legal-entities/{legal_entity_id}/payroll-events, però només els de les entitats que tenen Diari de nòmina. Cada entitat nova pren com a diari de nòmina el primer diari general de la seva empresa; si l'hi treus, aquesta entitat deixa de donar assentaments de nòmina. Cada lectura comença a la data d'Importar cicles de nòmina des de, que per defecte són 90 dies abans del dia en què crees la connexió: el connector no desa fins on ha llegit, així que cada passada torna a demanar els cicles des d'aquesta data.
Deel marca cada cicle amb has_g2n_report, i la seva documentació diu que només és cert quan el cicle està publicat i el seu informe no té errors que el bloquegin. A Odoo és la casella Llisto per brut a net, i és el que passa el cicle d'En espera a Deel a Publicar. D'allà surt amb el seu assentament (Registre creat), s'atura a Mapejar conceptes si a algun concepte li falten comptes, o queda en Error amb un avís. La sincronització corre cada 30 minuts; si la connexió rep webhooks, l'esdeveniment gp.payslips.available de Deel avança la part de nòmina, i les dades es tornen a llegir sempre per l'API.
Cada concepte, als seus comptes
El mapa és a la pestanya Comptes de nòmina de la connexió, i cada fila diu què fer amb un concepte: Registrar, que és el que ve posat, o Ignorar. Una fila que es registra porta un Compta de dèbit i un Compta de crèdit, i l'import del concepte va sencer als dos, així que cada assentament quadra per construcció. Una fila sense concepte val per a tot el seu grup, i una sense entitat legal, per a totes les entitats de la connexió. Si diverses files encaixen amb una línia de l'informe, guanya la més concreta: la d'aquesta entitat i aquest concepte, després la d'aquesta entitat i el seu grup, després la de qualsevol entitat amb aquest concepte i, per acabar, la de qualsevol entitat amb aquest grup.
Quan arriba un concepte sense fila llesta, el cicle es queda a Mapejar conceptes: el connector crea la fila que falta i obre una incidència que demana un compte del deure i un altre de l'haver, o ignorar-lo. El mateix passa amb un grup que el connector no coneix, que desa com a INFOS i que també necessita la seva fila, de manera que cap import no queda fora sense que algú l'hagi vist. La casella Centres de costos de cada fila ve marcada, i amb ella la línia del deure porta els centres de cost del contracte de Deel d'aquesta persona.

Moneda, data i detall per persona
Cada concepte entra en la moneda que l'informe dona al seu contracte, o en la de l'empresa si l'informe no la porta. Si aquesta moneda no està activa a Odoo, el cicle s'atura amb un avís que demana activar-la i tornar-ho a provar. L'import en la moneda de la teva empresa surt dels tipus de canvi d'Odoo a la data de l'assentament: el conversion_rate de Deel es desa a la línia del cicle, però l'assentament no el fa servir.
L'assentament va al diari de nòmina de l'entitat legal, amb la data de final del cicle i una referència que porta el nom del cicle. A dins, els imports del mateix concepte que comparteixen comptes, centres de cost i moneda se sumen, així que surt un parell de línies per concepte i no per persona. El detall de cada persona es queda a les línies del cicle, que només veuen els administradors de comptabilitat d'Odoo. Però si l'entitat té una sola persona, o cada persona té el seu propi centre de cost, l'assentament mostra el que cobra aquesta persona a qui pugui veure els assentaments. Cada cicle dona un sol assentament encara que coincideixin dues passades, i el camp Registres de nòmina decideix si es queda en Borrador, per revisar, que és el que ve posat, o surt Registrat.
Un cicle d'exemple, quadrat a mà

El cicle de la captura és un cicle REGULAR d'una empresa inventada, Lumbre Analytics, S.L., del 30 de setembre al 30 d'octubre de 2026, amb un contracte de Global Payroll en euros. El seu mapa fa servir comptes del PGC: 640 per a sous, 642 per a la Seguretat Social a càrrec de l'empresa, 4751 per a retencions, 476 per a la Seguretat Social i 465 per al net pendent de pagament. Amb aquestes dades de demostració, el codi del connector donaria aquest assentament, calculat a mà:
| Concepte | Grup de Deel | Deure (compte) | Haver (compte) |
|---|---|---|---|
Salario base | ADDITIONS | 3900 (640) | 3900 (465) |
IRPF | DEDUCTIONS | 702 (465) | 702 (4751) |
Seguridad Social trabajador | DEDUCTIONS | 253,5 (465) | 253,5 (476) |
Seguridad Social empresa | CONTRIBUTIONS | 1236,3 (642) | 1236,3 (476) |
Neto a pagar | TOTALS | Amb Ignorar, no hi entra | |
| Suma | 6091,8 | 6091,8 |
Cada concepte s'apunta dues vegades, una al deure i una altra a l'haver, i per això les dues columnes sumen el mateix. El compte 465 rep 3900 a l'haver i 702 i 253,5 al deure, i es queda amb 2944,5 a l'haver, que és el Neto a pagar de l'informe. Per això, en aquest exemple, la fila de TOTALS és a Ignorar: el net ja surt de les altres línies. El 476 acumula 1489,8 de Seguretat Social, el 4751 els 702 de retencions, i el cost del cicle per a l'empresa queda al 640 i al 642, amb 5136,3 entre tots dos.
El que no cobreix
La nòmina de PEO no té un tractament propi: el connector tracta els contractes PEO com a EOR, mentre que GL Sync, la integració comptable de Deel, sí que porta PEO al llibre major. A més, res d'això s'ha provat contra l'API real de Deel. L'organització de demostració de Deel contra la qual es va provar el connector, a través de FlexigoTech Cloud, encara no tenia cicles de nòmina, així que els cicles es van provar amb respostes fetes sobre la referència de la seva API. Contra aquesta organització sí que 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.
Abans d'activar-lo
- Odoo 17, 18, 19 o 20 al teu servidor o a Odoo.sh. El mòdul no funciona a Odoo Online.
- Un token d'organització de Deel amb permisos de lectura, que crea un administrador de Deel al Developer Center. Segons la documentació de Deel, l'informe brut a net demana
payslips:readi la llista de cicles,legal-entity:read. Segons el mateix mòdul, el token el desa xifrat FlexigoTech Cloud, mai el teu Odoo. - El
Diari de nòminade cada entitat legal que faci servir Global Payroll. - Les files de
Comptes de nòmina. La primera vegada, cada concepte nou atura el seu cicle fins que li dones comptes o l'ignores. - La data d'
Importar cicles de nòmina des de, si vols portar cicles de més de 90 dies enrere.
Les factures que emet Deel segueixen un altre camí i entren com a factures de proveïdor, com explica Deel invoice a Odoo, i els seus pagaments es registren com explica la guia dels pagaments a Deel. El que fa GL Sync amb altres programes comptables ho comparem a les integracions comptables de Deel. 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
- help.letsdeel.com/hc/en-gb/articles/12602682257809-Customizing-And-Downloading-Gross-To-Ne
- help.letsdeel.com/hc/en-gb/articles/45125127111825-Accounting-Integrations-Pricing-and-Set
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_maps.py
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.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): models/account_move.py
- Càlcul de FlexigoTech amb les xifres citades
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- help.letsdeel.com/hc/en-gb/articles/46057955155217-Accounting-Integrations-Overview
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
