Erro mandate_is_inactive da GoCardless ao criar uma cobrança a partir do Odoo

O que diz a GoCardless

A GoCardless separa as duas partes do texto com um travessão. Os erros invalid_state significam, segundo a GoCardless, que a ação não é válida no estado atual do recurso. Aqui o recurso é o mandato: cancelado, falhado ou expirado, já não aceita cobranças.

Como se chega a este erro

O normal é que o Odoo fique a saber que um mandato morreu por um evento da GoCardless antes de tentar cobrar com ele. Este erro aparece quando não foi assim: o aviso não chegou ou chegou tarde, ou o mandato foi cancelado mesmo antes da cobrança. A cobrança pode vir de uma subscrição que se renova ou de um pagamento registado com o método de pagamento guardado do cliente. Os avisos da GoCardless chegam por webhook: com a ligação em dois cliques, através do FlexigoTech Cloud; no modo avançado, ao endpoint que criou no Dashboard da GoCardless. Se esse caminho falhar, o Odoo não fica a saber a tempo.

O que faz o conector

Sem um tratamento especial, veria o erro tal como está, com o texto da API, e o mandato continuaria a ser oferecido para a fatura seguinte. O conector faz outra coisa:

1. Reconhece o reason mandate_is_inactive na resposta.
2. Pergunta à GoCardless por esse mandato para confirmar o seu estado.
3. Se estiver cancelado, falhado, expirado, consumido ou bloqueado, arquiva-o no Odoo. Se for a primeira notícia desse mandato morto, regista-o na ficha do cliente, com o estado do mandato entre parênteses («O mandato de débito direto GoCardless de … já não pode ser usado (cancelled). Não é possível cobrar mais nada com ele. Peça ao cliente que crie um novo mandato.»), e cria a atividade «Mandato da GoCardless perdido».
4. Passa a transação para «Erro» com a sua própria mensagem, em vez do erro em bruto: «O mandato GoCardless do cliente está no estado …, pelo que não pode ser cobrado. Peça ao cliente um novo mandato.».

Se o mandato estiver afinal ativo, o conector não lhe toca e a transação mostra o erro da GoCardless: «A GoCardless rejeitou o pedido.» seguido da mensagem da API e do seu request_id. O mesmo tratamento tem o botão de tentar novamente uma cobrança quando a GoCardless responde mandate_is_inactive.

Estes textos saem no idioma de quem lança a cobrança; se for uma ação agendada, como a renovação de uma subscrição, são escritos sem ninguém à frente: numa base de dados criada em português saem assim, e numa criada em inglês e passada depois para português, em inglês: «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.».

Porque não convém voltar a tentar

A GoCardless indica-o na descrição dos erros invalid_state: há que informar o utilizador e não o deixar voltar a tentar. Um mandato cancelado não volta a estar ativo por se insistir; precisa de uma nova assinatura do cliente ou, em alguns casos e só com permissões especiais da GoCardless, de uma reativação.

O que fazer

• Veja a mensagem da transação e a nota do conector na ficha do cliente. A transação abre-se a partir da fatura, com o botão «Transação de Pagamento» no topo; o menu de transações só aparece em modo de programador, e no Odoo 20 não existe. As duas mensagens dizem em que estado está o mandato.
• Peça ao cliente um novo mandato e cobre com ele a fatura pendente.
• Se acontecer com frequência, verifique que os webhooks da GoCardless chegam ao seu Odoo: são eles que avisam antes de a cobrança chegar. Mesmo assim, o conector pede de hora a hora os eventos que se tenham perdido.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector transforma um erro de API numa tarefa clara: o mandato morto sai da lista de métodos de pagamento, o cliente fica avisado na sua ficha e a fatura continua pendente até haver um mandato que funcione.

Continue a ler