Si usas GoCardless y aún no tienes Odoo, lo que necesitas saber es dónde queda cada liquidación que te paga GoCardless. Con el conector (ficha en Odoo Apps), Odoo 20 guarda una ficha por liquidación: importe, comisiones deducidas, fecha de llegada, referencia, estado y tipo, además de su desglose.

Post to accounting.Qué trae cada liquidación
Cuando el módulo importa una liquidación nueva, crea su ficha con el importe, las comisiones deducidas, la fecha de llegada, la referencia, el estado y el tipo que da GoCardless, en la moneda de la liquidación. Después trae su desglose. Cada ficha queda asociada a la cuenta de GoCardless de la que viene.
La importación devuelve solo las liquidaciones que ha creado de verdad. Si la importación se ejecuta otra vez, no cuenta como nuevo lo que ya estaba: el recuento no declara dos veces el mismo dinero.

Dos tareas programadas, activas al instalar
Al instalar el módulo vienen activas dos tareas programadas:
GoCardless: importar liquidaciones(GoCardless: import payouts) corre una vez al día.GoCardless: recuperar eventos perdidos(GoCardless: recover missed events) corre cada hora.
La primera es la que trae las liquidaciones. Recorre las cuentas de GoCardless que puede usar y, al terminar, cuenta cuántas liquidaciones ha importado y anota los fallos con su tipo y un código fijo.
Cómo se automatiza el cobro
El cobro también lo lanza Odoo, contra el mandato que firmó el cliente. Cuando el cliente paga con GoCardless y autoriza el mandato, el módulo lo guarda como método de pago y cobra contra él. Después, cada vez que Odoo cobra ese método guardado, por ejemplo al registrar el pago de una factura o al renovar una suscripción de Odoo, el módulo manda el cobro a GoCardless con una clave fija. Si GoCardless no contesta a esa petición, la tarea que corre cada hora la vuelve a enviar con la misma clave, así que el cobro sale una sola vez. Lo que viene después, las liquidaciones, lo trae la tarea diaria.
Los caminos del conector, comparados
| Situación | Qué hace el conector | Detalle |
|---|---|---|
| Cada día | La tarea GoCardless: importar liquidaciones recorre las cuentas utilizables y trae sus liquidaciones | Viene activa al instalar |
| Cada hora | Corre la tarea GoCardless: recuperar eventos perdidos | Viene activa al instalar |
| Cuenta sin conectar, con un entorno distinto al de su token o detectada como copia | La tarea no la llama | Solo repetiría la misma excepción en cada ejecución |
| Liquidación nueva | Crea la ficha con importe, comisiones deducidas, fecha de llegada, referencia, estado y tipo, y trae su desglose | Cuenta como importada |
| Liquidación ya importada | Actualiza el estado y la fecha de llegada | No cuenta como nueva; si no tiene desglose, vuelve a traerlo |
| Liquidación en una moneda archivada | Reactiva la moneda | Odoo no valida un asiento en una moneda archivada |
| Liquidación en una moneda que Odoo no conoce | La omite | Queda anotado en el registro técnico |
| Muchas liquidaciones | Sigue el cursor de GoCardless, página a página | La importación inicial no pierde las más antiguas |
| Una cuenta falla | Anota el fallo y sigue con las demás | Anota el tipo de fallo y un código fijo |
| GoCardless limita el ritmo de peticiones | Espera y reintenta, un número limitado de veces | Si se agotan los reintentos, cuenta como fallo de esa cuenta |
Los casos con más detalle
Una liquidación pendiente puede cambiar después
Una liquidación importada cuando aún estaba pendiente puede rebotar o pagarse más tarde. Por eso, cuando la liquidación ya existe, el módulo no crea otra: actualiza su estado y su fecha de llegada. Quedarse con el primer estado permitiría registrar en el banco como cobrado un pago rebotado.
Si una importación anterior creó la cabecera y falló al traer el desglose, la siguiente vuelve a pedirlo. Sin ese paso, la liquidación quedaría descuadrada e imposible de contabilizar.
Un fallo en una cuenta no para a las demás
La tarea solo llama a las cuentas de GoCardless que están conectadas, en el entorno de su token y que no son una copia. Si una cuenta da error, lo anota y sigue con la siguiente. El fallo se anota con su tipo y un código fijo, nunca con un identificador de GoCardless ni con su texto.
Importación inicial completa
GoCardless entrega las liquidaciones por páginas. El módulo sigue el cursor hasta que se acaban, porque quedarse en la primera página haría perder en silencio todas las liquidaciones más antiguas en la importación inicial.
Monedas archivadas
Odoo trae todas las monedas, pero deja archivadas las que no se usan. Si GoCardless paga en una de ellas, el módulo la reactiva, porque el dinero ha llegado en esa moneda y tiene que poder usarse en la contabilidad. Si la moneda no existe en Odoo, la liquidación se omite.
Límite de peticiones
Si GoCardless limita el ritmo de peticiones, el módulo espera y vuelve a intentarlo, pero solo un número limitado de veces. Si sigue sin poder, la tarea anota el fallo de esa cuenta, con su tipo y un código fijo, y sigue con las demás.
Cómo te ayuda FlexigoTech
Si aún no usas Odoo, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida: podemos montar Odoo y dejar el conector de GoCardless funcionando. Tienes el módulo en la ficha de Odoo Apps y en la página del conector. El conector funciona con la suscripción a FlexigoTech Cloud.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
- Código del módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
- flexigotech.com/en/services.html
- Código del módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py
