Saltar para o conteúdo principal
GoCardless

Fatura GoCardless no Odoo: da cobrança à liquidação lançada

Com a GoCardless, o Odoo guarda as tuas faturas e a GoCardless cobra-as. As cobranças são transações de pagamento do Odoo e cada liquidação do banco converte-se num único lançamento, com as comissões separadas, quando um contabilista carrega em Lançar na contabilidade (Post to accounting).

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
4 min

Faturas no Odoo, cobranças na GoCardless

Se usas a GoCardless, ou vais usá-la, a divisão que o conector propõe é simples: o Odoo guarda as tuas faturas e a GoCardless cobra-as. O conector amplia as transações de pagamento do Odoo, de modo que as cobranças da GoCardless aparecem na mesma lista que qualquer outra transação de pagamento.

Lista de transações de pagamento no Odoo com dados de demonstração: quotas de sócios cobradas com o método SEPA Direct Debit e o fornecedor GoCardless, com a sua referência de fatura, o cliente e o montante
As cobranças da GoCardless na lista de transações de pagamento (ginásio inventado, API simulada, interface em inglês, dados de demonstração).

Fica o outro lado: o dinheiro chega ao banco em liquidações. O conector separa em cada liquidação as cobranças, as comissões e, quando existem, os reembolsos e os estornos. Para a levar à contabilidade acrescenta um botão, Lançar na contabilidade, na ficha da liquidação.

Ficha de uma liquidação da GoCardless no Odoo com dados de demonstração: data de chegada, estado pago, montante líquido liquidado, comissões deduzidas, total de linhas, diferença a zero, discriminação por cobrança com a sua comissão e o botão Post to accounting
Uma liquidação com dados de demonstração (ginásio inventado, modo de teste, interface em inglês), com a diferença a zero e o botão para a lançar.
How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Quando aparece o botão e o que acontece ao carregar nele

O módulo deixa este passo manual de propósito: lançar no livro razão é decisão do contabilista do comércio, não algo que um conector deva fazer nas suas costas. O que se segue é o comportamento do código do Odoo 20; a condição que oculta o botão é a mesma no Odoo 17, 18, 19 e 20.

SituaçãoBotão Lançar na contabilidadeResultado
A liquidação está paga, está equilibrada e não tem lançamentoVê-seCria um lançamento com a discriminação, lança-o e deixa-o no campo Lançamento de Diário. Depois tenta reconciliar as cobranças.
Já existe um lançamento em Lançamento de DiárioOculta-seA vista esconde-o assim que o campo tem valor.
O Estado (Status) da liquidação não é pagoOculta-seA vista esconde-o até a liquidação estar paga.
A liquidação não está equilibrada (campo Equilibrado, Is Balanced)Oculta-seA vista esconde-o enquanto não estiver equilibrada.
Carrega no botão alguém que não é contabilistaVê-se se se cumprirem as condições anterioresAparece Apenas os contabilistas podem lançar as liquidações da GoCardless. e não se cria nenhum lançamento.

A leitura é direta: o botão só é oferecido quando há algo correto para lançar, e quem carrega nele tem de ser contabilista. Quando o botão não aparece, a causa está num desses três campos.

Que lançamento cria

O lançamento constrói-se a partir da discriminação da liquidação, não do montante líquido. O código explica-o: creditar «líquido mais comissões» como se tudo fossem cobranças parece equilibrar, mas falha assim que a liquidação inclui um reembolso ou um estorno, porque a conta de compensação fica com um resíduo permanente e o reembolso não chega à contabilidade.

Linha do lançamentoQuando apareceLado e conta
Liquidação da GoCardless … (GoCardless payout …)Em todo o lançamento de liquidaçãoDébito, conta bancária, pelo montante liquidado
Comissões da GoCardless (GoCardless fees)Se as comissões líquidas forem positivasDébito, conta de comissões
Comissões da GoCardless reembolsadas (GoCardless fees refunded)Se as comissões líquidas forem negativasCrédito, conta de comissões
Reembolsos e estornos (Refunds and chargebacks)Se a liquidação trouxer reembolsos ou estornosDébito, conta de compensação
Cobranças da GoCardless liquidadas (GoCardless collections settled)Em todo o lançamento de liquidaçãoCrédito, conta de compensação, pelas cobranças

Dois detalhes do código que evitam descaldos:

  • O módulo classifica as linhas por tipo, não por sinal. A GoCardless devolve as suas comissões como linhas de comissão positivas quando um pagamento falha ou é devolvido; contá-las como cobranças inflacionaria a despesa em comissões e deixaria um crédito na conta de compensação impossível de reconciliar.
  • Se a liquidação chegar numa moeda diferente da da empresa, cada linha é convertida para a moeda da empresa com o câmbio da data de chegada (ou o de hoje se não houver data de chegada). Como cada linha é arredondada separadamente, a linha de cobranças absorve a diferença de cêntimos para que o Odoo aceite o lançamento; os montantes originais em divisa ficam exatos.

O lançamento leva como referência Liquidação da GoCardless … com o identificador da GoCardless.

Depois de lançar: reconciliação das cobranças

Depois de lançar, o módulo tenta reconciliar os pagamentos que o Odoo tinha lançado para as cobranças dessa liquidação. Cada pagamento debita a sua conta de cobranças pendentes e a liquidação credita a conta de compensação por esse mesmo dinheiro. Quando são a mesma conta, que é o que vem por defeito, cruzá-los é o que faz passar o pagamento de em pagamento a pago.

Se algo não encaixar, o módulo não adivinha:

  • Se um pagamento estiver numa conta diferente da de compensação, regista-o no registo do servidor e deixa-o para reconciliar à mão.
  • Se a conta de compensação não permitir reconciliação, também o regista e não reconcilia nada.
  • Só se reconcilia o crédito das cobranças. O débito de reembolsos e estornos não entra, porque cruzar-se-ia com o próprio crédito da liquidação e deixaria pagamentos em aberto.

Como a FlexigoTech te ajuda

Se ainda não usas o Odoo, o difícil não é o botão: é ter as faturas, as cobranças e a contabilidade no mesmo sítio. A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida; podes começar por a implementação e acrescentar o conector depois. Tens a ficha no Odoo Apps e a página do módulo para ver o conector da GoCardless.

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): static/description/index.html
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_transaction.py
  • 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): views/gocardless_payout_views.xml
  • flexigotech.com/en/services.html