Error mandate_is_inactive de GoCardless en crear un cobrament des d'Odoo

Què diu GoCardless

GoCardless separa les dues parts del text amb un guió. Els errors invalid_state signifiquen, segons GoCardless, que l'acció no val en l'estat actual del recurs. Aquí el recurs és el mandat: cancel·lat, fallit o caducat, ja no admet cobraments.

Com s'arriba a aquest error

Normalment Odoo s'assabenta que un mandat ha mort per un esdeveniment de GoCardless abans d'intentar cobrar-hi. Aquest error apareix quan no ha estat així: l'avís no va arribar o va arribar tard, o el mandat es va cancel·lar just abans del cobrament. El cobrament pot venir d'una subscripció que es renova o d'un pagament registrat amb el mètode de pagament desat del client. Els avisos de GoCardless arriben per webhook: amb la connexió en dos clics, a través de FlexigoTech Cloud; en el mode avançat, a l'endpoint que vas crear tu al Dashboard de GoCardless. Si aquest camí falla, Odoo no se n'assabenta a temps.

Què fa el connector

Sense un tractament especial, veuries l'error tal qual, amb el text de l'API, i el mandat seguiria oferint-se per a la següent factura. El connector fa una altra cosa:

1. Reconeix el reason mandate_is_inactive a la resposta.
2. Pregunta a GoCardless per aquell mandat per confirmar-ne l'estat.
3. Si està cancel·lat, fallit, caducat, consumit o bloquejat, l'arxiva a Odoo. Si és la primera notícia d'aquell mandat mort, ho escriu a la fitxa del client, amb l'estat del mandat entre parèntesis («The GoCardless direct debit mandate of … is no longer usable (cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate.»), i crea l'activitat «GoCardless mandate lost».
4. Passa la transacció a «Error» amb el seu propi missatge, en lloc de l'error en cru: «The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate.».

Si el mandat resultés estar actiu, el connector no el toca i la transacció mostra l'error de GoCardless: «GoCardless rejected the request.» seguit del missatge de l'API i del seu request_id. El mateix tractament té el botó de reintentar un cobrament quan GoCardless contesta mandate_is_inactive.

El connector no està traduït al català: aquests textos surten sempre en anglès, també en un Odoo en català, tant si els llança un usuari com una tasca programada, com la renovació d'una subscripció: «The GoCardless direct debit mandate of … is no longer usable (cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate.», «GoCardless mandate lost», «The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate.» i «GoCardless rejected the request.».

Per què no convé reintentar

GoCardless ho posa a la descripció dels errors invalid_state: cal informar l'usuari i no deixar que reintenti. Un mandat cancel·lat no torna a estar actiu perquè s'insisteixi; necessita una signatura nova del client o, en alguns casos i només amb permisos especials de GoCardless, una reactivació.

Què fer

• Mira el missatge de la transacció i la nota del connector a la fitxa del client. La transacció s'obre des de la factura, amb el botó «Transacció de pagament» de dalt; el menú de transaccions només surt en mode desenvolupador, i a Odoo 20 no existeix. Els dos textos diuen en quin estat és el mandat.
• Demana al client un mandat nou i cobra-hi la factura pendent.
• Si passa sovint, revisa que els webhooks de GoCardless arribin al teu Odoo: són els que avisen abans que arribi el cobrament. Tot i així, el connector demana cada hora els esdeveniments que s'hagin perdut.

Amb el nostre connector

A Odoo 17, 18, 19 i 20 el connector converteix un error d'API en una tasca clara: el mandat mort surt de la llista de mètodes de pagament, el client queda avisat a la seva fitxa i la factura continua pendent fins que hi hagi un mandat que funcioni.

Continua llegint