Saltar para o conteúdo principal
GoCardless

Comissões GoCardless no Odoo: cobrado, devolvido e comissões em separado

Com o conector da GoCardless, o Odoo não regista a liquidação como um único valor: ao lançá-la, separa o cobrado, o devolvido e as comissões, e cada parte vai para a sua conta. A conta da GoCardless abres tu com a GoCardless, com as suas condições e as suas comissões; o conector trata de onde cai cada valor na contabilidade.

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

O que és tu que defines e o que traz o conector

A conta da GoCardless não vem incluída: és tu que a abres com a GoCardless, sob as suas condições e as suas comissões. O conector trabalha com o que a GoCardless te liquida. Traz as liquidações para o Odoo com a tarefa agendada GoCardless: importar liquidações (GoCardless: import payouts), que corre uma vez por dia e está ativa ao instalar, ou quando carregas no botão Importar liquidações agora (Import payouts now).

As liquidações abrem-se a partir do menu Faturação › Contabilidade › Liquidações da GoCardless (Invoicing › Accounting › GoCardless Payouts). Cada uma traz o campo Valor líquido pago (Net Paid Out), só de leitura, cuja ajuda diz O que chegou realmente à conta bancária. Esse valor líquido é um único valor, mas lá dentro há cobranças, devoluções e comissões. No separador Discriminação (Breakdown), tabela Linha (Item), cada linha tem um Valor (Amount), e a sua ajuda diz Positivo para um crédito, negativo para um débito.

Ficha do provedor GoCardless no Odoo com dados de demonstração e interface em inglês, separador Configuration: bloco de reconciliação de liquidações com o diário e as contas, e os botões Import payouts now e Import existing mandates
Configuração do provedor GoCardless em modo de teste, com dados de demonstração e interface em inglês: por baixo, o bloco de reconciliação de liquidações com o diário e as contas, e o botão para importar liquidações.

As comissões têm a sua própria conta. O campo Conta de comissões (Fees Account) está na ficha do provedor de pagamento, no grupo Reconciliação de liquidações (Payout reconciliation), e só aparece quando o provedor é a GoCardless. A sua ajuda diz Conta de gastos para as comissões que a GoCardless desconta de cada liquidação.

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: as partes de uma liquidação

Ao lançar, o módulo não trata o valor líquido como se fossem todos cobranças. Parte da discriminação e escreve um único lançamento com uma linha por cada parte. Isto é o que faz no Odoo 20:

ParteComo a reconhece o móduloLinha do lançamentoConta e lado
Valor líquido pagoO que chegou à conta bancáriaLiquidação da GoCardless …Conta bancária, a débito
CobradoLinhas da discriminação com valor positivo que não são comissõesCobranças da GoCardless liquidadasConta de compensação de cobranças, a crédito
DevolvidoLinhas com valor negativo que não são comissõesReembolsos e estornosConta de compensação de cobranças, a débito
ComissõesLinhas de comissão somadas; o resultado é um gastoComissões da GoCardlessConta de comissões, a débito
Comissões reembolsadasAs mesmas linhas, se a soma der a favorComissões da GoCardless reembolsadasConta de comissões, a crédito

A linha de devoluções só é escrita se houver algo devolvido, e a de comissões só se a soma das comissões não for zero. A linha de cobranças é escrita em qualquer caso.

Como ler a tabela

  • Cobrado e devolvido vão para a mesma conta, cada um no seu lado. Os reembolsos e as devoluções dão dinheiro aos clientes, pelo que reduzem o que as cobranças criaram.
  • As comissões não se misturam com as cobranças: vão para a conta de gastos que escolhes em Conta de comissões.
  • O valor líquido é o único valor que entra na conta bancária, e é o que deve bater certo com o resto.

Há uma razão para não partir do valor líquido. Creditar «líquido mais comissões» como se fossem todos cobranças parece bater certo, mas assim que a liquidação inclui um reembolso ou uma devolução, a conta de compensação fica com um resíduo permanente e o reembolso não chega à contabilidade. O módulo constrói o lançamento a partir da discriminação para o evitar.

Comissões que a GoCardless devolve

Quando um pagamento falha ou é devolvido, a GoCardless reembolsa as suas comissões como linhas de comissão com valor positivo. O módulo classifica por tipo de linha e não pelo sinal, pelo que essas linhas não são contadas como cobranças. Se a soma das comissões der a favor, o lançamento usa a linha Comissões da GoCardless reembolsadas.

Também importa quando voltas a tentar uma cobrança. O botão Tentar cobrar novamente (Retry collection) pede confirmação com este texto: A GoCardless vai tentar cobrar novamente este pagamento, o que pode ter uma comissão. Continuar? (GoCardless will try to collect this payment again, which can cost a fee. Continue?).

Ficha de uma cobrança da GoCardless no Odoo 20 com dados de demonstração, interface em inglês e API simulada: estado Confirmed, método SEPA Direct Debit e grupo GOCARDLESS com GoCardless Payment Status (paid_out)
Uma cobrança da GoCardless com dados de demonstração e a API simulada (modo de teste): estado Confirmed e, no grupo GOCARDLESS, o estado da cobrança na GoCardless.

Quando lançar e o que faz o botão

Lançar é uma decisão manual e está desativada por defeito: passar algo para o razão geral é assunto do contabilista, não de um conector. O botão Lançar na contabilidade (Post to accounting) da liquidação fica oculto quando se verifica qualquer uma destas condições, no Odoo 17, 18, 19 e 20:

  • A liquidação já tem Lançamento de Diário (Journal Entry).
  • O campo Equilibrado (Is Balanced) não está marcado.
  • O Estado (Status) não indica que a liquidação esteja paga.

Ao carregar nele no Odoo 20, o módulo cria o lançamento com as linhas da tabela, valida-o, deixa-o ligado à liquidação e depois tenta reconciliar os pagamentos que o Odoo registou para as cobranças dessa liquidação. Essa reconciliação faz-se quando esses pagamentos estão na mesma conta que a liquidação usa como conta de compensação (o habitual com a configuração por defeito) e a conta permite reconciliar. Se os pagamentos estiverem noutra conta, o módulo não adivinha: deixa-os para reconciliar à mão.

Liquidações noutra moeda

Se a liquidação chegar numa moeda diferente da da empresa, o módulo converte cada linha para a da empresa. Como cada linha é arredondada em separado, a linha de cobranças absorve a diferença de arredondamento e o lançamento fica equilibrado; os valores originais na moeda da liquidação mantêm-se exatos.

O que o Odoo centraliza para quem ainda não o usa

No Odoo ficam juntos a liquidação importada, a sua discriminação, o lançamento que gera ao ser lançada e os pagamentos das cobranças que se reconciliam com ele. As comissões deixam de ser uma subtração escondida no valor líquido: são uma linha com a sua conta de gastos. E o devolvido não se confunde com o cobrado.

Como a FlexigoTech te ajuda

Se ainda não usas o Odoo, implementamos o Odoo nas versões 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. O conector da GoCardless tem a sua ficha no Odoo Apps e a sua página em flexigotech.com, onde o podes comprar.

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_provider.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
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): views/payment_transaction_views.xml
  • flexigotech.com/en/services.html