Saltar para o conteúdo principal
GoCardless

GoCardless e a automatização de cobranças: o que o Odoo centraliza com o conector

Com o conector de GoCardless, o Odoo lança cada cobrança contra o mandato do cliente, e o Odoo 20 importa as liquidações sozinho: uma tarefa agendada traz-las todos os dias, com as suas comissões e o seu detalhe, e outra tarefa corre a cada hora.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 17 de novembro de 2026

O essencial

Módulo
GoCardless
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Se usas o GoCardless e ainda não tens Odoo, o que precisas de saber é onde fica cada liquidação que o GoCardless te paga. Com o conector (ficha no Odoo Apps), o Odoo 20 guarda uma ficha por liquidação: montante, comissões deduzidas, data de chegada, referência, estado e tipo, além do seu detalhe.

Ficha de uma liquidação do GoCardless no Odoo, com a data de chegada, o estado paid, o montante líquido, as comissões deduzidas, o total de linhas, a diferença a zero, o detalhe por cobrança e o botão Post to accounting
Ficha de uma liquidação em modo de teste, com dados de demonstração de um ginásio inventado e a interface em inglês: data de chegada, montante líquido, comissões, diferença a zero, o detalhe por cobrança com a sua comissão e o botão Post to accounting.

O que traz cada liquidação

Quando o módulo importa uma liquidação nova, cria a sua ficha com o montante, as comissões deduzidas, a data de chegada, a referência, o estado e o tipo que o GoCardless indica, na moeda da liquidação. Depois traz o seu detalhe. Cada ficha fica associada à conta do GoCardless de onde vem.

A importação devolve apenas as liquidações que criou de facto. Se a importação for executada outra vez, o que já existia não conta como novo: a contagem não declara duas vezes o mesmo dinheiro.

How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Duas tarefas agendadas, ativas ao instalar

Ao instalar o módulo vêm ativas duas tarefas agendadas:

  • GoCardless: importar liquidações (GoCardless: import payouts) corre uma vez por dia.
  • GoCardless: recuperar eventos em falta (GoCardless: recover missed events) corre a cada hora.

A primeira é a que traz as liquidações. Percorre as contas do GoCardless que pode usar e, ao terminar, conta quantas liquidações importou e regista as falhas com o seu tipo e um código fixo.

Como se automatiza a cobrança

A cobrança também é lançada pelo Odoo, contra o mandato que o cliente assinou. Quando o cliente paga com o GoCardless e autoriza o mandato, o módulo guarda-o como método de pagamento e cobra contra ele. Depois, sempre que o Odoo cobra esse método guardado, por exemplo ao registar o pagamento de uma fatura ou ao renovar uma subscrição do Odoo, o módulo envia a cobrança ao GoCardless com uma chave fixa. Se o GoCardless não responder a esse pedido, a tarefa agendada que corre de hora a hora volta a enviá-lo com a mesma chave, por isso a cobrança sai uma só vez. O que vem depois, as liquidações, é trazido pela tarefa agendada diária.

Os caminhos do conector, comparados

SituaçãoO que faz o conectorDetalhe
Todos os diasA tarefa GoCardless: importar liquidações percorre as contas utilizáveis e traz as suas liquidaçõesVem ativa ao instalar
A cada horaCorre a tarefa GoCardless: recuperar eventos em faltaVem ativa ao instalar
Conta sem ligar, com um ambiente diferente do do seu token ou detetada como cópiaA tarefa não a chamaSó repetiria a mesma exceção em cada execução
Liquidação novaCria a ficha com montante, comissões deduzidas, data de chegada, referência, estado e tipo, e traz o seu detalheConta como importada
Liquidação já importadaAtualiza o estado e a data de chegadaNão conta como nova; se não tiver detalhe, volta a trazê-lo
Liquidação numa moeda arquivadaReativa a moedaO Odoo não valida um lançamento numa moeda arquivada
Liquidação numa moeda que o Odoo não conheceOmite-aFica registado no registo técnico
Muitas liquidaçõesSegue o cursor do GoCardless, página a páginaA importação inicial não perde as mais antigas
Uma conta falhaRegista a falha e continua com as restantesRegista o tipo de falha e um código fixo
O GoCardless limita o ritmo de pedidosEspera e tenta de novo, um número limitado de vezesSe as tentativas se esgotarem, conta como falha dessa conta

Os casos em mais detalhe

Uma liquidação pendente pode mudar depois

Uma liquidação importada quando ainda estava pendente pode ser devolvida ou paga mais tarde. Por isso, quando a liquidação já existe, o módulo não cria outra: atualiza o seu estado e a sua data de chegada. Ficar com o primeiro estado permitiria registar no banco como cobrado um pagamento devolvido.

Se uma importação anterior criou o cabeçalho e falhou ao trazer o detalhe, a seguinte volta a pedi-lo. Sem esse passo, a liquidação ficaria descontrolada e impossível de contabilizar.

Uma falha numa conta não pára as outras

A tarefa só chama as contas do GoCardless que estão ligadas, no ambiente do seu token e que não são uma cópia. Se uma conta der erro, regista-o e continua com a seguinte. A falha é registada com o seu tipo e um código fixo, nunca com um identificador do GoCardless nem com o seu texto.

Importação inicial completa

O GoCardless entrega as liquidações por páginas. O módulo segue o cursor até acabarem, porque ficar na primeira página faria perder em silêncio todas as liquidações mais antigas na importação inicial.

Moedas arquivadas

O Odoo traz todas as moedas, mas deixa arquivadas as que não se usam. Se o GoCardless pagar numa delas, o módulo reativa-a, porque o dinheiro chegou nessa moeda e tem de poder usar-se na contabilidade. Se a moeda não existir no Odoo, a liquidação é omitida.

Limite de pedidos

Se o GoCardless limitar o ritmo de pedidos, o módulo espera e tenta de novo, mas apenas um número limitado de vezes. Se continuar sem conseguir, a tarefa regista a falha dessa conta, com o seu tipo e um código fixo, e continua com as restantes.

Como te ajuda a FlexigoTech

Se ainda não usas Odoo, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida: podemos montar o Odoo e deixar o conector de GoCardless a funcionar. Tens o módulo na ficha do Odoo Apps e na página do conector. O conector funciona com a subscrição do FlexigoTech Cloud.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
  • flexigotech.com/en/services.html
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py