Si fas servir GoCardless i encara no tens Odoo, el que has de saber és on queda cada liquidació que et paga GoCardless. Amb el connector (fitxa a Odoo Apps), Odoo 20 desa una fitxa per liquidació: import, comissions deduïdes, data d'arribada, referència, estat i tipus, a més del seu desglossament.

Post to accounting.Què porta cada liquidació
Quan el mòdul importa una liquidació nova, crea la seva fitxa amb l'import, les comissions deduïdes, la data d'arribada, la referència, l'estat i el tipus que dona GoCardless, en la divisa de la liquidació. Després porta el seu desglossament. Cada fitxa queda associada al compte de GoCardless del qual ve.
La importació retorna només les liquidacions que ha creat de debò. Si la importació s'executa una altra vegada, no compta com a nou el que ja hi era: el recompte no declara dues vegades els mateixos diners.

Dues tasques programades, actives en instal·lar
En instal·lar el mòdul vénen actives dues tasques programades:
GoCardless: import payoutscorre un cop al dia.GoCardless: recover missed eventscorre cada hora.
La primera és la que porta les liquidacions. Recorre els comptes de GoCardless que pot fer servir i, en acabar, compta quantes liquidacions ha importat i anota les fallades amb el seu tipus i un codi fix.
Com s'automatitza el cobrament
El cobrament també el llança Odoo, contra el mandat que va signar el client. Quan el client paga amb GoCardless i autoritza el mandat, el mòdul el desa com a mètode de pagament i cobra contra ell. Després, cada vegada que Odoo cobra aquest mètode desat, per exemple en registrar el pagament d'una factura o en renovar una subscripció d'Odoo, el mòdul envia el cobrament a GoCardless amb una clau fixa. Si GoCardless no respon a aquesta petició, la tasca programada que corre cada hora la torna a enviar amb la mateixa clau, de manera que el cobrament surt una sola vegada. El que ve després, les liquidacions, ho porta la tasca diària.
Els camins del connector, comparats
| Situació | Què fa el connector | Detall |
|---|---|---|
| Cada dia | La tasca GoCardless: import payouts recorre els comptes utilitzables i porta les seves liquidacions | Ve activa en instal·lar |
| Cada hora | Corre la tasca GoCardless: recover missed events | Ve activa en instal·lar |
| Compte sense connectar, amb un entorn diferent al del seu token o detectat com a còpia | La tasca no el crida | Només repetiria la mateixa excepció a cada execució |
| Liquidació nova | Crea la fitxa amb import, comissions deduïdes, data d'arribada, referència, estat i tipus, i porta el seu desglossament | Compta com a importada |
| Liquidació ja importada | Actualitza l'estat i la data d'arribada | No compta com a nova; si no té desglossament, torna a portar-lo |
| Liquidació en una divisa arxivada | Reactiva la divisa | Odoo no valida un assentament en una divisa arxivada |
| Liquidació en una divisa que Odoo no coneix | L'omet | Queda anotat al registre tècnic |
| Moltes liquidacions | Segueix el cursor de GoCardless, pàgina a pàgina | La importació inicial no perd les més antigues |
| Un compte falla | Anota la fallada i continua amb els altres | Anota el tipus de fallada i un codi fix |
| GoCardless limita el ritme de peticions | Espera i reintenta, un nombre limitat de vegades | Si s'esgoten els reintents, compta com a fallada d'aquest compte |
Els casos amb més detall
Una liquidació pendent pot canviar després
Una liquidació importada quan encara estava pendent pot rebotar o pagar-se més tard. Per això, quan la liquidació ja existeix, el mòdul no en crea una altra: actualitza el seu estat i la seva data d'arribada. Quedar-se amb el primer estat permetria registrar al banc com a cobrat un pagament rebotat.
Si una importació anterior ha creat la capçalera i ha fallat en portar el desglossament, la següent el torna a demanar. Sense aquest pas, la liquidació quedaria descidrada i impossible de comptabilitzar.
Una fallada en un compte no atura els altres
La tasca només crida els comptes de GoCardless que estan connectats, a l'entorn del seu token i que no són una còpia. Si un compte dona error, ho anota i continua amb el següent. La fallada s'anota amb el seu tipus i un codi fix, mai amb un identificador de GoCardless ni amb el seu text.
Importació inicial completa
GoCardless lliura les liquidacions per pàgines. El mòdul segueix el cursor fins que s'acaben, perquè quedar-se a la primera pàgina faria perdre en silenci totes les liquidacions més antigues en la importació inicial.
Divises arxivades
Odoo porta totes les divises, però deixa arxivades les que no es fan servir. Si GoCardless paga en una d'elles, el mòdul la reactiva, perquè els diners han arribat en aquesta divisa i s'ha de poder fer servir a la comptabilitat. Si la divisa no existeix a Odoo, la liquidació s'omet.
Límit de peticions
Si GoCardless limita el ritme de peticions, el mòdul espera i torna a intentar-ho, però només un nombre limitat de vegades. Si continua sense poder, la tasca anota la fallada d'aquest compte, amb el seu tipus i un codi fix, i continua amb els altres.
Com t'ajuda FlexigoTech
Si encara no fas servir Odoo, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida: podem muntar Odoo i deixar el connector de GoCardless funcionant. Tens el mòdul a la fitxa d'Odoo Apps i a la pàgina del connector. El connector funciona amb la subscripció a FlexigoTech Cloud.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
- Codi del mòdul: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
- flexigotech.com/en/services.html
- Codi del mòdul: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py
