La Deel invoice que veu l'empresa que paga
Qui escriu «deel invoice» en un cercador sol trobar com fa un contractista la seva factura a Deel. Aquesta guia va de l'altre costat: l'empresa que rep aquestes factures i les ha de portar a la comptabilitat. A Deel, l'empresa gestiona pagaments i factures a la pestanya Billing, dins de Finance, i des d'allà les descarrega d'una en una o en un zip de fins a 50 documents. Sense connector, algú torna a teclejar cada PDF a Odoo.
L'API de Deel dona més del que es veu al PDF. La seva llista de factures retorna per defecte només les pagades i les reemborsades, així que el connector la demana amb status=all i rep també les pendents. Les factures de les comissions de Deel arriben per una altra crida, GET /invoices/deel, i el connector també les importa.
El connector es va provar de punta a punta, a través de FlexigoTech Cloud, contra una organització de demostració de Deel (demo.deel.com): la connexió, les entitats legals, un contracte amb la seva persona i el seu proveïdor, els webhooks i una segona passada sense duplicats. Aquella organització encara no tenia factures, pagaments ni cicles de nòmina, així que aquesta part s'ha provat amb respostes fetes sobre la referència de l'API de Deel. Que la llista de factures de Deel porti també les d'EOR està per comprovar amb una organització real.
| El que porta Deel | On acaba a Odoo |
|---|---|
Les partides de la factura (line_items) | Una línia de la factura de proveïdor per partida, amb la seva descripció |
amount i deel_fee | Si la factura no porta partides, una línia amb l'import i una altra amb la comissió de Deel |
vat_percentage | L'impost d'Odoo que hagis assignat a aquest tipus a Tipus d'IVA |
| Data d'emissió i de venciment | Data de la factura i, si no hi ha termini de pagament, venciment |
| Número de la factura a Deel | Referència de la factura i del pagament |
| Adjunt de la factura de proveïdor, fins a 20 MB |
Com es converteix en factura de proveïdor
Cada factura de Deel es desa a Odoo amb el seu identificador de Deel, i el connector no deixa que n'hi hagi dues factures de proveïdor, encara que coincideixin dues passades o dues connexions llegeixin la mateixa organització de Deel. L'entitat legal de Deel decideix l'empresa d'Odoo, el diari de compres i el proveïdor, i un contractista que tingui proveïdor propi a Odoo va a aquest proveïdor. Si el total és negatiu, en surt una factura rectificativa de proveïdor.

Les línies surten de les partides que la factura té a Deel i porten la distribució analítica del contracte, de manera que els centres de cost arriben ja posats. Només en va sense la línia de comissió d'una factura que no porta partides. La importació s'atura amb un avís, sense crear la factura, quan un tipus d'IVA de Deel no té impost d'Odoo assignat a la connexió, quan la moneda no està activa a Odoo o quan l'entitat legal de Deel no té diari de compres, entre altres casos.
Abans de donar-la per bona, el connector compara el total de la factura d'Odoo amb el de Deel. Si difereixen en més de 0,01, la deixa a Revisar amb un missatge que dona els dos totals i demana revisar els impostos abans de comptabilitzar. El camp Factures de proveïdor de la connexió decideix la resta: amb Borrador, per revisar, que és el que ve posat, totes es queden en esborrany; amb Registrat quan tot coincideixi, es comptabilitzen soles quan el total quadra.
Els estats d'una factura de Deel a Odoo
| Estat | Què vol dir |
|---|---|
Per importar | Llegida de Deel, encara sense factura de proveïdor |
Factura creada | Ja té la seva factura de proveïdor a Odoo |
Revisar | El total no quadra o Deel la va canviar després, i decideix una persona |
Les factures de total zero no creen factura de proveïdor, i tampoc les de contractistes o d'empleats EOR que Deel dona per anul·lades, fallides o impagables. Si falta alguna cosa per crear-la, com un impost o una moneda, la factura queda en error amb un avís que diu què falta.

Factura creada i enllaçada a la seva factura de proveïdor en esborrany.Si Deel canvia o anul·la la factura després
Si Deel canvia el total d'una factura, o n'anul·la una d'un contractista o d'un empleat EOR, quan ja té factura de proveïdor a Odoo, el connector no toca aquesta factura de proveïdor, perquè pot estar comptabilitzada o pagada: passa la de Deel a Revisar i obre un avís amb el que ha canviat, perquè algú anul·li la factura o en faci una rectificativa. Per assabentar-se'n, la sincronització corre cada 30 minuts i torna a llegir el que s'ha emès en els 7 dies anteriors a l'última passada. Les factures més antigues que ja tenen factura de proveïdor i encara no estan pagades es repassen una a una, fins a 100 per passada.
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. S'enganxa a la connexió i el desa xifrat FlexigoTech Cloud, mai el teu Odoo. L'opció
Autoritzar amb Deelfuncionarà quan Deel aprovi l'app de FlexigoTech; fins aleshores el connector demana fer servir el token. - Un impost d'Odoo per a cada tipus d'IVA que portin les teves factures, a
Tipus d'IVA. - El
Diari de pagamentsde cada entitat legal de Deel, que ve buit. Sense ell, el connector no registra a Odoo els pagaments a Deel; amb ell, els registra a les factures de proveïdor ja comptabilitzades. - La data des de la qual importar. Si no la canvies, entren les factures emeses en els 60 dies anteriors a crear la connexió.
Quan una organització de Deel paga des de diverses entitats, cada entitat legal va a la seva empresa d'Odoo, amb els seus diaris i el seu proveïdor. Si a més fas servir Global Payroll, la nòmina entra com un assentament per cicle, i ho comparem amb el que fa 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/20301708484753-How-to-Download-Invoices-and-Manage-Pay
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.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_account.py
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- 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_legal_entity.py
