Errore mandate_is_inactive di GoCardless alla creazione di un incasso da Odoo

Che cosa dice GoCardless

GoCardless separa le due parti del testo con un trattino. Gli errori invalid_state significano, secondo GoCardless, che l'azione non è valida nello stato attuale della risorsa. Qui la risorsa è il mandato: annullato, fallito o scaduto, non accetta più incassi.

Come si arriva a questo errore

Di norma Odoo viene a sapere che un mandato è morto da un evento di GoCardless prima di provare a incassare. Questo errore compare quando non è andata così: l'avviso non è arrivato o è arrivato in ritardo, oppure il mandato è stato annullato poco prima dell'incasso. L'incasso può derivare da un abbonamento che si rinnova o da un pagamento registrato con il metodo di pagamento salvato del cliente. Gli avvisi di GoCardless arrivano tramite webhook: con la connessione in due clic, attraverso FlexigoTech Cloud; in modalità avanzata, all'endpoint che hai creato tu nella Dashboard di GoCardless. Se questo percorso fallisce, Odoo non se ne accorge in tempo.

Che cosa fa il connettore

Senza un trattamento specifico, vedresti l'errore così com'è, con il testo dell'API, e il mandato continuerebbe a essere proposto per la fattura successiva. Il connettore fa altro:

1. Riconosce il reason mandate_is_inactive nella risposta.
2. Interroga GoCardless su quel mandato per confermarne lo stato.
3. Se è annullato, fallito, scaduto, consumato o bloccato, lo archivia in Odoo. Se è la prima segnalazione di quel mandato morto, la scrive nella scheda del cliente, con lo stato del mandato tra parentesi («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.»), e crea l'attività «GoCardless mandate lost».
4. Porta la transazione allo stato «Errore» con un messaggio proprio, al posto dell'errore grezzo: «The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate.».

Se il mandato risultasse attivo, il connettore non lo tocca e la transazione mostra l'errore di GoCardless: «GoCardless rejected the request.» seguito dal messaggio dell'API e dal suo request_id. Lo stesso trattamento vale per il pulsante per riprovare un incasso quando GoCardless risponde mandate_is_inactive.

Il connettore non è tradotto in italiano: questi testi compaiono sempre in inglese, anche in un Odoo in italiano, sia che li avvii un utente sia un'azione pianificata, come il rinnovo di un abbonamento: «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.» e «GoCardless rejected the request.».

Perché non conviene riprovare

GoCardless lo indica nella descrizione degli errori invalid_state: bisogna informare l'utente e non lasciare che riprovi. Un mandato annullato non torna attivo insistendo; serve una nuova firma del cliente o, in alcuni casi e solo con permessi speciali di GoCardless, una riattivazione.

Che cosa fare

• Controlla il messaggio della transazione e la nota del connettore nella scheda del cliente. La transazione si apre dalla fattura, con il pulsante «Transazione di pagamento» in alto; il menu delle transazioni compare solo in modalità sviluppatore, e in Odoo 20 non esiste. I due testi dicono in che stato si trova il mandato.
• Chiedi al cliente un nuovo mandato e incassa con quello la fattura in sospeso.
• Se succede spesso, verifica che i webhook di GoCardless arrivino al tuo Odoo: sono quelli che avvisano prima che arrivi l'incasso. In ogni caso, il connettore richiede ogni ora gli eventi eventualmente persi.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore trasforma un errore dell'API in un'operazione chiara: il mandato morto esce dall'elenco dei metodi di pagamento, il cliente viene avvisato nella sua scheda e la fattura resta in sospeso finché non c'è un mandato funzionante.

Continua a leggere