Saltar para o conteúdo principal
GoCardless

GoCardless bank integration: cobranças e liquidações no Odoo

Com o conector GoCardless para Odoo, as cobranças e as liquidações veem-se dentro do Odoo, junto da fatura e do cliente, e não num painel à parte. As capturas são de demonstração e há duas mensagens do código do Odoo 20 que convém conhecer.

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

A pergunta de fundo por detrás de «gocardless bank integration»

Por detrás de uma pesquisa como «gocardless bank integration» há três perguntas práticas: o que foi cobrado, a que fatura e a que cliente corresponde, e se o dinheiro já chegou ao banco. Se hoje cobra com a GoCardless e faz a contabilidade noutro programa, essas três respostas estão repartidas por dois ecrãs e o cruzamento fica por sua conta.

Um conector resolve isso levando os dados da GoCardless para o Odoo, onde se gerem clientes e faturas. Este é o conector da FlexigoTech e precisa da subscrição do FlexigoTech Cloud para funcionar. Tem a sua ficha na Odoo Apps e a sua página, com a compra, em flexigotech.com. As capturas são do Odoo 20, com dados de demonstração (um ginásio inventado e a API da GoCardless simulada, em modo de teste), e os dados do código também são do Odoo 20.

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

Comparação: dois sítios face a um

O que quer saberGoCardless e contabilidade em separadoCom o conector no Odoo
Que cobranças existem e de quem são?Dois sítios a consultar: o painel da GoCardless e a sua contabilidadeA lista Payment Transactions mostra cobranças com o provedor GoCardless e o método SEPA Direct Debit, com a sua referência de fatura, o cliente e o montante
Como vai uma cobrança concreta?Localiza-a num sítio e cruza-a com o outroA ficha da cobrança traz um grupo GOCARDLESS com GoCardless Payment Status, Charge Date, GoCardless Cause, Success+ Will Retry e GoCardless Retries
De que se compõe uma liquidação?Reconstrói-a fora da sua contabilidadeO ecrã GoCardless Payouts mostra Arrival Date, Net Paid Out, Fees Deducted, Items Total e Variance, além do detalhe por cobrança com a sua comissão
O dinheiro já chegou ao banco?Verifica na GoCardlessA liquidação mostra o seu estado (na captura de demonstração, paid); o módulo tem uma mensagem para as liquidações cujo estado não é o de paga (mais abaixo)
Como levo a liquidação para a contabilidade?Um lançamento à parte na sua contabilidadeA liquidação da captura traz um botão Post to accounting

As cobranças dentro do Odoo

A primeira coisa que muda é onde se consulta. Na lista de cobranças da captura, cada quota de sócio aparece com a sua referência de fatura, o cliente e o montante, e todas estão no estado Confirmed, com a GoCardless como provedor e SEPA Direct Debit como método.

Lista Payment Transactions do Odoo 20 com quotas de sócios cobradas por SEPA Direct Debit e provedor GoCardless, todas no estado Confirmed, com referência de fatura, cliente e montante
As cobranças da GoCardless no Odoo, com dados de demonstração de um ginásio inventado e a API da GoCardless simulada

Se abrir uma cobrança, a ficha mostra o estado Confirmed, o provedor, o método e o mandato como token de pagamento. Em baixo, o grupo GOCARDLESS reúne os dados próprios da GoCardless: GoCardless Payment Status (na captura, paid_out), Charge Date, GoCardless Cause, Success+ Will Retry e GoCardless Retries.

Ficha de uma cobrança do Odoo 20 com estado Confirmed, provedor GoCardless, método SEPA Direct Debit, o mandato como token de pagamento e o grupo GOCARDLESS com GoCardless Payment Status, Charge Date, GoCardless Cause, Success+ Will Retry e GoCardless Retries
Ficha de uma cobrança da GoCardless com dados de demonstração e a API simulada

A liquidação dentro do Odoo

A segunda pergunta é o que aconteceu ao dinheiro. O ecrã GoCardless Payouts reúne numa liquidação a sua data de chegada (Arrival Date), o estado, o líquido pago (Net Paid Out), as comissões descontadas (Fees Deducted), o total das cobranças (Items Total) e uma linha Variance, que na captura de demonstração está a zero. Por baixo vem o detalhe por cobrança com a sua comissão, e a liquidação da captura traz o botão Post to accounting.

Liquidação no ecrã GoCardless Payouts com Arrival Date, estado paid, Net Paid Out, Fees Deducted, Items Total, Variance a zero, detalhe por cobrança com a sua comissão e o botão Post to accounting
Uma liquidação de demonstração (ginásio inventado, modo de teste)

O que diz o código do Odoo 20

No código publicado para o Odoo 20 há dados que interessam a quem faz reconciliação.

O primeiro é uma tarefa agendada chamada GoCardless: import payouts, que se executa todos os dias e fica ativa ao instalar o módulo.

O segundo é uma mensagem para uma liquidação cujo estado não é o de paga:

Esta liquidação está no estado …, não paga: o dinheiro ainda não chegou ao banco. Importe novamente as liquidações quando a GoCardless a indicar como paga. (This payout is …, not paid: the money has not reached the bank. Import the payouts again once GoCardless reports it paid.)

No lugar das reticências, o módulo escreve o estado que a liquidação tiver nesse momento. A própria mensagem diz o que fazer: esperar que a GoCardless a dê como paga e voltar a importar as liquidações.

O terceiro afeta quem trabalha com várias empresas na mesma base de dados. O módulo tem esta mensagem para uma liquidação que pertence a uma empresa que não está entre as do utilizador (exceto se se trabalhar com permissões de superutilizador):

Esta liquidação pertence a uma empresa em que não trabalha. (This payout belongs to a company you do not work for.)

O que pedir para ver antes de decidir

Se ainda não usa o Odoo e está a avaliar este caminho, estes são os ecrãs que vale a pena rever com os seus dados:

  • A lista Payment Transactions: verifique que cada cobrança da GoCardless leva a sua fatura e o seu cliente.
  • A ficha de uma cobrança, com o grupo GOCARDLESS.
  • Uma liquidação em GoCardless Payouts: o detalhe por cobrança, as comissões, a linha Variance e o botão Post to accounting.

Como continuar: implementação e conector

O conector não substitui o Odoo: instala-se dentro dele. Se ainda não o usa, o caminho são três peças: ter o Odoo em funcionamento, acrescentar-lhe o conector e contratar a subscrição do FlexigoTech Cloud de que este precisa para funcionar. A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, pelo que as peças podem vir do mesmo sítio. Conte-nos como cobra hoje com a GoCardless e analisamos o seu caso.

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): models/gocardless_payout.py
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
  • flexigotech.com/en/services.html