Qué es un pago en Deel
Esta guía mira el pago a contratistas desde la empresa que paga. En la pestaña Pay de Finance, Deel selecciona por defecto todas las facturas pendientes para pagarlas de una vez, y la empresa puede quitar las que no quiera pagar todavía, salvo las que, según Deel, pueden ser obligatorias en algunos casos, como las vencidas. Si paga por transferencia, tiene que incluir la referencia de Deel del pago. Mientras el dinero no llega, el pago figura en proceso, y cuando Deel confirma que lo ha recibido pasa a Paid. Por eso un pago a Deel salda de una vez las facturas de varios contratistas.
La API de Deel separa las dos cosas. GET /payments lista los pagos a Deel con su estado, que es paid o processing, sus totales, la moneda y el medio de pago, pero ya no trae las facturas que cubre. Para eso está GET /payments/{payment_id}/breakdown, que según Deel da cada factura y la comisión de Deel como líneas separadas. Cada línea lleva, entre otros campos, el identificador de la factura (invoice_id), el contrato y su tipo, el nombre de la persona, el importe con su moneda, el importe en la moneda del pago y la cuenta contable que se haya configurado en Deel (general_ledger_account).
Cómo lo reparte el conector
| Lo que trae Deel | Qué hace el conector en Odoo |
|---|---|
Pagos de GET /payments | Los lee desde la pasada anterior menos 7 días; la primera vez, desde Importar facturas emitidas desde |
Estado processing | El pago espera en En Espera de Deel y el conector no pide su desglose |
Estado paid | El pago pasa a Registrar y el conector lee su desglose, si Deel lo da por pagado en los 7 días siguientes a su creación |
invoice_id de cada línea | La factura de proveedor de esa factura de Deel, que recibe su pago |
paid_at | Fecha del pago en Odoo |
deel_reference | Comunicación del pago; si no viene, la etiqueta del pago |
general_ledger_account | Se guarda en Cuenta contable Deel, pero no decide dónde va el pago |
Cada factura se paga con el asistente de registro de pagos de Odoo, en el Diario de pagos de su entidad legal, así que un pago a Deel que cubre varias facturas da en Odoo un pago por factura. El importe de cada pago es lo que queda por pagar de su factura de proveedor, no el de la línea del desglose: si alguien retocó la factura en Odoo, se paga lo que dice la factura. Si una factura ya figura como pagada en Odoo, el conector no crea otro pago, y una línea ya pagada no se vuelve a pagar en las pasadas siguientes. Cuando ninguna factura tiene que esperar, el pago de Deel queda en Registrado.
Todas las condiciones
Para que una factura reciba su pago tienen que cumplirse a la vez todas estas condiciones:
- La conexión tiene marcada la casilla
Pagos a Deel, que viene marcada. - Deel da el pago por pagado (
paid) en los 7 días siguientes a su creación. - La factura de Deel ya tiene su factura de proveedor en Odoo.
- Esa factura de proveedor está contabilizada. Con
Facturas de ProveedorenBorrador, por revisar, que es lo que viene puesto, alguien tiene que contabilizarla; conRegistrado cuando todo coincide, se contabiliza sola cuando todo coincide. - Su entidad legal tiene
Diario de pagos, un diario de banco o de caja. Ese campo viene vacío en cada entidad nueva, y sin él las facturas se quedan sin pagar en Odoo.
Si a una factura le falta alguna de las tres últimas condiciones, el pago queda en Algunas facturas no están listas, con un aviso que lo explica, y las facturas que sí cumplen se pagan igual. La sincronización lo vuelve a mirar cada 30 minutos, y en cuanto la factura se contabiliza y la entidad tiene diario, se registra su pago. Si la conexión recibe webhooks, los eventos payment.statement.initiated y payment.statement.mark-paid de Deel lanzan antes la parte de pagos, y los datos se vuelven a leer por la API.

Si el pago llega antes que su factura
El desglose puede nombrar una factura de Deel que Odoo todavía no tiene: una emitida antes de la fecha desde la que importas, o la de un trabajador COR, que el conector no pide al listar facturas. En ese caso la lee de Deel por su identificador, con GET /invoices/{id}, y crea en ese momento su factura de proveedor, con las mismas reglas que las demás. Si esa factura queda en borrador, que es lo que viene puesto, el pago espera en Algunas facturas no están listas hasta que alguien la contabiliza, y se registra en la pasada siguiente.
Contratistas con proveedor propio
En Deel el dinero va a Deel, pero en Odoo cada factura está a nombre de un proveedor, y la entidad legal de Deel decide la empresa, el diario de compras y ese proveedor. Un contratista es su propio proveedor: el conector lo busca por su correo solo entre los contactos de Odoo que ya son proveedores y no tienen usuario; si no lo encuentra, crea uno nuevo. Mientras Deel no tenga a esa persona, por ejemplo porque no ha aceptado la invitación, sus facturas van al proveedor de Deel. Las de EOR y COR van siempre a Deel, al Proveedor de Deel de la entidad legal o, si está vacío, al de la conexión. Como el pago se registra en la factura, salda la deuda con el mismo proveedor que tiene la factura.

Lo que no hace
El conector no usa la cuenta contable que trae el desglose: la guarda en Cuenta contable Deel, y el pago va al diario de pagos de la entidad. Tampoco lee los abonos, que la API de Deel da en otra llamada (GET /billing/invoices), ni vuelve a leer un pago que siga en proceso más de 7 días después de crearse, porque Deel, según la referencia de su API, filtra la lista de pagos por la fecha en que se crearon. Si Deel lo da por pagado más tarde, el pago se queda en En Espera de Deel sin ningún aviso y sus facturas siguen sin pagar en Odoo. Los webhooks lanzan esa misma lectura, así que tampoco lo recuperan, y hoy no hay ningún botón que lo haga. Además, ningún pago se ha probado contra la API real de Deel. La organización de demostración de Deel contra la que se probó el conector, a través de FlexigoTech Cloud, no tenía pagos, así que esta parte se probó con respuestas hechas sobre la referencia de la API de Deel, y tampoco se ha visto cómo llega en un desglose real la línea de la comisión de Deel. Contra esa organización sí se probaron la conexión, las entidades legales, un contrato con su persona y su proveedor, los webhooks y una segunda pasada sin duplicados.
El conector funciona en Odoo 17, 18, 19 y 20 en tu servidor o en Odoo.sh, no en Odoo Online. Cómo entra cada factura está en Deel invoice en Odoo, la nómina de Global Payroll en Deel gross to net y la comparación con Bill Sync, la sincronización de facturas de Deel, en sus integraciones contables. El conector está explicado entero en su página y publicado en Odoo Apps.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- 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-
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Código del módulo: 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
