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.

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.

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ção | O que faz o conector | Detalhe |
|---|---|---|
| Todos os dias | A tarefa GoCardless: importar liquidações percorre as contas utilizáveis e traz as suas liquidações | Vem ativa ao instalar |
| A cada hora | Corre a tarefa GoCardless: recuperar eventos em falta | Vem ativa ao instalar |
| Conta sem ligar, com um ambiente diferente do do seu token ou detetada como cópia | A tarefa não a chama | Só repetiria a mesma exceção em cada execução |
| Liquidação nova | Cria a ficha com montante, comissões deduzidas, data de chegada, referência, estado e tipo, e traz o seu detalhe | Conta como importada |
| Liquidação já importada | Atualiza o estado e a data de chegada | Não conta como nova; se não tiver detalhe, volta a trazê-lo |
| Liquidação numa moeda arquivada | Reativa a moeda | O Odoo não valida um lançamento numa moeda arquivada |
| Liquidação numa moeda que o Odoo não conhece | Omite-a | Fica registado no registo técnico |
| Muitas liquidações | Segue o cursor do GoCardless, página a página | A importação inicial não perde as mais antigas |
| Uma conta falha | Regista a falha e continua com as restantes | Regista o tipo de falha e um código fixo |
| O GoCardless limita o ritmo de pedidos | Espera e tenta de novo, um número limitado de vezes | Se 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
