Què és un pagament a Deel
Aquesta guia mira el pagament a contractistes des de l'empresa que paga. A la pestanya Pay de Finance, Deel selecciona per defecte totes les factures pendents per pagar-les d'una vegada, i l'empresa pot treure les que encara no vulgui pagar, tret de les que, segons Deel, poden ser obligatòries en alguns casos, com les vençudes. Si paga per transferència, hi ha d'incloure la referència de Deel del pagament. Mentre els diners no arriben, el pagament figura en procés, i quan Deel confirma que els ha rebut passa a Paid. Per això un pagament a Deel salda d'una vegada les factures de diversos contractistes.
L'API de Deel separa les dues coses. GET /payments llista els pagaments a Deel amb el seu estat, que és paid o processing, els seus totals, la moneda i el mitjà de pagament, però ja no porta les factures que cobreix. Per a això hi ha GET /payments/{payment_id}/breakdown, que segons Deel dona cada factura i la comissió de Deel com a línies separades. Cada línia porta, entre altres camps, l'identificador de la factura (invoice_id), el contracte i el seu tipus, el nom de la persona, l'import amb la seva moneda, l'import en la moneda del pagament i el compte comptable que s'hagi configurat a Deel (general_ledger_account).
Com ho reparteix el connector
| El que porta Deel | Què fa el connector a Odoo |
|---|---|
Pagaments de GET /payments | Els llegeix des de la passada anterior menys 7 dies; la primera vegada, des d'Importar factures emeses des de |
Estat processing | El pagament espera a En espera a Deel i el connector no en demana el desglossament |
Estat paid | El pagament passa a Registrar i el connector en llegeix el desglossament, si Deel el dona per pagat en els 7 dies següents a la seva creació |
invoice_id de cada línia | La factura de proveïdor d'aquesta factura de Deel, que en rep el pagament |
paid_at | Data del pagament a Odoo |
deel_reference | Comunicació del pagament; si no hi és, l'etiqueta del pagament |
general_ledger_account | Es desa a Compta general Deel, però no decideix on va el pagament |
Cada factura es paga amb l'assistent de registre de pagaments d'Odoo, al Diari de pagaments de la seva entitat legal, així que un pagament a Deel que cobreix diverses factures dona a Odoo un pagament per factura. L'import de cada pagament és el que queda per pagar de la seva factura de proveïdor, no el de la línia del desglossament: si algú va retocar la factura a Odoo, es paga el que diu la factura. Si una factura ja figura com a pagada a Odoo, el connector no crea cap altre pagament, i una línia ja pagada no es torna a pagar a les passades següents. Quan cap factura no ha d'esperar, el pagament de Deel queda a Registrat.
Les condicions, totes
Perquè una factura rebi el seu pagament s'han de complir alhora totes aquestes condicions:
- La connexió té marcada la casella
Pagaments a Deel, que ve marcada. - Deel dona el pagament per pagat (
paid) en els 7 dies següents a la seva creació. - La factura de Deel ja té la seva factura de proveïdor a Odoo.
- Aquesta factura de proveïdor està comptabilitzada. Amb
Factures de proveïdoraBorrador, per revisar, que és el que ve posat, algú l'ha de comptabilitzar; ambRegistrat quan tot coincideixi, es comptabilitza sola quan tot coincideix. - La seva entitat legal té
Diari de pagaments, un diari de banc o de caixa. Aquest camp ve buit a cada entitat nova, i sense ell les factures es queden sense pagar a Odoo.
Si a una factura li falta alguna de les tres últimes condicions, el pagament queda a Algunes factures no estan llestes, amb un avís que ho explica, i les factures que sí que compleixen es paguen igualment. La sincronització ho torna a mirar cada 30 minuts, i quan la factura es comptabilitza i l'entitat té diari, se'n registra el pagament. Si la connexió rep webhooks, els esdeveniments payment.statement.initiated i payment.statement.mark-paid de Deel avancen la part de pagaments, i les dades es tornen a llegir per l'API.

Si el pagament arriba abans que la seva factura
El desglossament pot anomenar una factura de Deel que Odoo encara no té: una emesa abans de la data des de la qual importes, o la d'un treballador COR, que el connector no demana quan llista factures. En aquest cas la llegeix de Deel pel seu identificador, amb GET /invoices/{id}, i en crea al moment la factura de proveïdor, amb les mateixes regles que les altres. Si aquesta factura queda en esborrany, que és el que ve posat, el pagament espera a Algunes factures no estan llestes fins que algú la comptabilitza, i es registra a la passada següent.
Contractistes amb proveïdor propi
A Deel els diners van a Deel, però a Odoo cada factura està a nom d'un proveïdor, i l'entitat legal de Deel decideix l'empresa, el diari de compres i aquest proveïdor. Un contractista és el seu propi proveïdor: el connector el busca pel seu correu només entre els contactes d'Odoo que ja són proveïdors i no tenen usuari; si no el troba, en crea un de nou. Mentre Deel no tingui aquesta persona, per exemple perquè no ha acceptat la invitació, les seves factures van al proveïdor de Deel. Les d'EOR i COR van sempre a Deel, al Proveïdor Deel de l'entitat legal o, si és buit, al de la connexió. Com que el pagament es registra a la factura, salda el deute amb el mateix proveïdor que té la factura.

El que no fa
El connector no fa servir el compte comptable que porta el desglossament: el desa a Compta general Deel, i el pagament va al diari de pagaments de l'entitat. Tampoc llegeix els abonaments, que l'API de Deel dona en una altra crida (GET /billing/invoices), ni torna a llegir un pagament que continuï en procés més de 7 dies després de crear-se, perquè Deel, segons la referència de la seva API, filtra la llista de pagaments per la data en què es van crear. Si Deel el dona per pagat més tard, el pagament es queda a En espera a Deel sense cap avís i les seves factures continuen sense pagar a Odoo. Els webhooks llancen aquesta mateixa lectura, així que tampoc no el recuperen, i avui no hi ha cap botó que ho faci. A més, cap pagament no 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, no tenia pagaments, així que aquesta part es va provar amb respostes fetes sobre la referència de l'API de Deel, i tampoc s'ha vist com arriba en un desglossament real la línia de la comissió de Deel. 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.
El connector funciona a Odoo 17, 18, 19 i 20 al teu servidor o a Odoo.sh, no a Odoo Online. Com entra cada factura és a Deel invoice a Odoo, la nòmina de Global Payroll a Deel gross to net i la comparació amb Bill Sync, la sincronització de factures de Deel, a les seves integracions comptables. 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/4407737772689-Making-Invoice-Payments-With-Deel
- 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-
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_payment.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_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/deel_invoice.py
- 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
