GoCardless mandate_replaced: el mandat té un substitut

Què diu GoCardless

La documentació d'esdeveniments ho explica així: «The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).». I el que porta l'esdeveniment: «The event will include links[new_mandate] with the ID of the new mandate.».

mandate_replaced és un error invalid_state: l'acció no val en l'estat actual del recurs. Per a aquests errors GoCardless demana avisar l'usuari i no reintentar («invalid_state → inform the end user, do not allow retry.»).

Quan apareix

El canvi no el provoca el client ni el seu banc: l'esdeveniment replaced té origen gocardless, i la causa documentada és que el creditor, el compte amb què cobres a GoCardless, ha passat a un altre identificador d'esquema. GoCardless cancel·la el mandat vell i en crea un de nou en el seu lloc.

mandate_replaced només apareix si Odoo intenta cobrar amb el mandat vell: el cobrament d'una subscripció que es renova, o un pagament registrat amb el mètode de pagament desat del client, abans que Odoo hagi aplicat l'esdeveniment.

Què fa Odoo amb el connector

Amb l'esdeveniment replaced:

1. Pren el mandat nou de links.new_mandate.
2. Passa a aquest mandat el mètode de pagament desat del client i el dona per bo, en lloc de donar-lo per perdut. Si el mètode estava arxivat, el reactiva; Odoo 17 no deixa desarxivar un mètode de pagament, i aleshores el connector en crea un de nou per al mandat nou.
3. L'escriu a la fitxa del client: «The GoCardless mandate is usable again (replaced).».

Aquesta nota l'escriu el connector en aplicar l'esdeveniment, sense ningú al davant. 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: «The GoCardless mandate is usable again (replaced).».

Amb mandate_replaced en un cobrament, el connector no fa res d'especial: en crear un cobrament només tracta a part mandate_is_inactive. La transacció passa a «Error» amb «GoCardless rejected the request.» i, a sota, el missatge de GoCardless amb mandate_replaced i el request_id entre claudàtors. El mandat nou el pren de l'esdeveniment, no de l'error. Aquest missatge també surt en anglès, tant si el llança un usuari com una tasca programada: «GoCardless rejected the request.».

Què fer

1. Si un cobrament es queda en error amb mandate_replaced, obre la transacció 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.
2. Mira a la fitxa del client si ja hi és la nota que el mandat es pot tornar a usar (replaced). Si hi és, el mètode de pagament ja apunta al mandat nou.
3. Si no hi és, l'esdeveniment encara no ha arribat. La tasca que cada hora recupera els esdeveniments perduts el porta; si triga més, revisa que els webhooks de GoCardless arribin a Odoo.
4. Amb el mètode de pagament al dia, torna a cobrar la factura.

Amb el nostre connector

A Odoo 17, 18, 19 i 20 el connector segueix el mandat nou en quan GoCardless avisa de la substitució: el client conserva el seu mètode de pagament i la següent factura es cobra amb el mandat que GoCardless ha deixat al seu lloc.

Continua llegint