Saltar para o conteúdo principal
GoCardless

Odoo SEPA com GoCardless: cobre as suas faturas por débito direto dentro do Odoo

Se já fatura no Odoo e quer cobrar por débito direto SEPA, o conector da GoCardless faz tudo dentro do Odoo: o cliente assina o mandato uma só vez, o Odoo cobra cada fatura com base nele quando regista o pagamento com o método de pagamento do cliente, as cobranças falhadas podem ser repetidas pelo Success+ (plano Advanced, se a causa o permitir) ou à mão, e cada liquidação chega às suas contas com as respetivas comissões. Aqui fica como decorre uma cobrança, a configuração, os limites e o custo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 10 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 17.0, 18.0, 19.0 e 20.0 · nas fontes indicadas no fim
Leitura
8 min

O que a GoCardless resolve dentro do Odoo

A GoCardless aceita pagamentos pontuais ou pagamentos recorrentes automáticos. Com o conector, esse trabalho passa para o Odoo:

  • O mandato: o cliente assina-o uma só vez na página da GoCardless, no seu próprio idioma, e fica guardado no Odoo como método de pagamento.
  • A cobrança: cada fatura é cobrada com base no mandato quando regista o pagamento com o método de pagamento do cliente, por SEPA Core e em euros.
  • Pagamentos falhados: podem ser repetidos pelo Success+ (plano Advanced, se a causa o permitir) ou à mão; perante uma falha tardia ou uma devolução (chargeback), o pagamento é revertido e a fatura volta a ficar por cobrar.
  • Liquidações: cada uma é importada com a sua discriminação e as suas comissões, num lançamento equilibrado que regulariza as cobranças.

Funciona no Odoo Community ou Enterprise, no Odoo.sh ou no seu próprio servidor, mas não no Odoo Online.

Uma cobrança SEPA no Odoo do princípio ao fim

Do mandato à cobrança da fatura

Com o mandato ativo, usa o botão da fatura que regista o pagamento: com um método de pagamento eletrónico, o assistente mostra o campo Token de pagamento salvo e, quando confirma com esse token, o Odoo cria a transação de pagamento e processa-a com o token. O conector também cobra as subscrições que se renovam com o mandato guardado e, em cada cobrança, pede que o Success+ possa repeti-la se a causa o permitir.

Lista do Odoo de Códigos de Pagamento com mandatos SEPA da GoCardless de vários sócios
Mandatos guardados como métodos de pagamento, com dados de demonstração de um ginásio fictício e a interface em inglês.

O estado do pagamento na GoCardless

Abre a transação a partir do botão de transação de pagamento, no topo da fatura, que aparece quando a fatura tem transações. No seu formulário, o conector acrescenta o grupo GoCardless antes da mensagem da transação, com Estado do pagamento na GoCardless e Novas tentativas da GoCardless sempre à vista. A própria transação pode estar, por exemplo, pendente, em erro ou confirmada.

Formulário de uma cobrança da GoCardless no Odoo 20 no estado Confirmado com o grupo GOCARDLESS
Uma cobrança em modo de teste, com a API da GoCardless simulada, dados de demonstração e a interface em inglês.

Cobranças falhadas: Success+ ou nova tentativa à mão

Se a GoCardless indicar que o Success+ vai tentar novamente, o conector acrescenta O Success+ vai tentar novamente de forma automática; não é preciso fazer nada. e deixa a transação pendente, não em erro. Segundo a GoCardless, o Success+ só repete os casos de saldo insuficiente: no SEPA, os códigos AM04 e MS03 (este último apenas na Alemanha, Áustria, Bélgica, Luxemburgo e Eslováquia).

Nos restantes casos, o botão Tentar cobrar novamente pode aparecer no formulário e pede-lhe que confirme A GoCardless vai tentar cobrar novamente este pagamento, o que pode ter uma comissão. Continuar?. Não aparece se o Success+ já vai tentar de novo, pois só acrescentaria uma comissão, nem depois de contadas 3 novas tentativas. A GoCardless define a nova data de débito e a transação fica pendente até ela a confirmar. Se a GoCardless responder retry_failed, veja o que fazer.

Devoluções e onde reembolsar

Uma falha tardia, uma devolução (chargeback) ou um cancelamento passa a transação a Erro e, se esta já tinha pago faturas, cancela o respetivo pagamento: a fatura volta a ficar por cobrar. Se for você a devolver o dinheiro, vá ao pagamento da cobrança e use o botão Notas de Crédito, que devolve o dinheiro e não emite nenhuma nota de crédito; está visível enquanto houver um valor por reembolsar. Depois, tanto o pagamento como a transação mostram um botão Notas de Crédito.

Configurar o débito direto SEPA da GoCardless no Odoo, passo a passo

  1. Tenha a sua própria conta GoCardless, ou crie uma ao ligar: não está incluída, abre-a junto da GoCardless sob os seus termos e comissões.
  2. Ligue a base de dados ao FlexigoTech Cloud, em Definições > FlexigoTech Cloud; antes de se enviar seja o que for, um administrador aceita a lista de dados do FlexigoTech Cloud.
  3. No provedor de serviços de pagamento GoCardless, mantenha a opção por omissão, Ligar a minha conta GoCardless: a sua ajuda diz que ligar através da FlexigoTech configura a conta e os seus webhooks em dois cliques. Se faltar o passo anterior, verá Ligue primeiro esta base de dados ao FlexigoTech Cloud, em Definições > FlexigoTech Cloud.
  4. Prima Testar a ligação.
  5. A tarefa GoCardless: importar liquidações corre todos os dias, mas vem desligada na instalação.
  6. Se já tem mandatos na GoCardless, importe-os: o conector associa-os aos seus contactos por e-mail, metadados ou nome e código postal, e você revê-os.
  7. Faça a primeira cobrança: registe o pagamento de uma fatura com o token de pagamento guardado e abra a transação a partir da fatura.
Provedor de serviços de pagamento GoCardless no Odoo com a opção Ligar a minha conta GoCardless, o estado Ligado e o botão Testar a ligação
Separador de Configuração em modo de teste, com dados de demonstração e a interface em inglês; em baixo, o diário e as contas das liquidações.

O que vigiar na primeira semana de cobranças SEPA

Em cada cobrança, olhe para o grupo GoCardless da transação: Estado do pagamento na GoCardless e Novas tentativas da GoCardless. O conector traz ainda as etiquetas Data de débito, Causa segundo a GoCardless e O Success+ vai tentar novamente. Uma cobrança falhada aparece no Odoo com uma mensagem a dizer que a GoCardless não a conseguiu cobrar, com a causa entre parênteses. Uma transação pendente com a nota do Success+ não precisa de nada; uma em Erro é a que deve rever e, se aparecer, a que tem o botão Tentar cobrar novamente.

Quando um mandato já não pode ser usado, o conector arquiva-o, regista-o no contacto e cria uma atividade Mandato da GoCardless perdido para pedir um novo.

A tarefa GoCardless: recuperar eventos em falta corre todas as horas e está ativa na instalação: pede à GoCardless os eventos que não chegaram e aplica até 100 por execução. O conector guarda cada evento que aplica e, se um voltar a chegar, não o aplica duas vezes.

Cada liquidação passa para a contabilidade com Lançar na contabilidade: a cobrança, a comissão da GoCardless e o valor líquido para o banco, num único lançamento equilibrado. Se ainda não estiver paga na GoCardless, o conector pára com 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.

Se a discriminação não somar o valor liquidado, pára com A discriminação desta liquidação não soma o valor liquidado (diferença: …). Lançá-la colocaria um valor errado na contabilidade.

Limites do SEPA a conhecer antes de começar

  • Cobra em euros por débito direto SEPA Core: sem outra moeda, sem outro esquema e sem Pay by Bank.
  • Não lança as liquidações sozinho: prime Lançar na contabilidade em cada uma.

O conector não reembolsa uma cobrança se tiverem passado menos de 2 dias desde a última mudança de estado da respetiva transação (ou desde que foi criada, se não houver nenhuma) e pára com A GoCardless não pode reembolsar uma cobrança até esta estar liquidada. Esta foi debitada há … dia(s); os reembolsos são possíveis após … dias.

Além disso, a GoCardless só aceita um reembolso fora do seu período de reembolso mais seguro, 7 dias de calendário a contar da data de débito; antes disso, a sua API devolve um erro. Esse período pode ser desativado pedindo-o à GoCardless.

Abaixo do valor mínimo, o conector nem sequer chama a GoCardless e avisa GoCardless does not collect amounts below 1.0. This one is ….

Quanto custa cobrar por SEPA com a GoCardless no Odoo e como começar

A GoCardless cobra por transação; a sua tarifa para a zona euro, sem IVA: plano Standard, 1 % + 0,20 € por transação, com um máximo de 2 €; plano Advanced, 1,25 % + 0,20 € por transação, com um máximo de 2,50 €. O Success+ vem com o plano Advanced, não com o Standard.

O módulo custa 9 € sem IVA, com uma licença por versão do Odoo, para as versões 17, 18, 19 e 20, e funciona com a subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas GoCardless (Pro: 98 €/mês ou 980 €/ano, até 10). A subscrição pode ser experimentada gratuitamente, sem cartão. Contrata-se por base de dados de produção, com 14 dias de teste e sem cartão. A sua conta GoCardless, o Odoo e o alojamento são por sua conta.

O conector está na sua página em flexigotech.com. Se quiser ajuda para o pôr a funcionar, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se o negócio que vai cobrar ainda não está no Odoo, leia primeiro o guia da GoCardless escrito para ele.

Odoo SEPA com GoCardless: perguntas frequentes

Em que versões do Odoo funciona?

No Odoo 17, 18, 19 e 20, com a versão 1.1.6 do módulo nas quatro.

O que acontece se o cliente devolver uma cobrança que tinha pago uma fatura?

A transação passa a Erro, o conector cancela o respetivo pagamento e a fatura volta a ficar por cobrar.

Quantas vezes posso repetir uma cobrança?

A GoCardless documenta que os pagamentos podem ser repetidos até 3 vezes e, depois de contadas 3 novas tentativas, o conector deixa de mostrar Tentar cobrar novamente.

Posso ligar várias contas GoCardless?

Sim: o plano Conector cobre até 3 contas e o Pro até 10.

Continue a ler

GoCardless no Odoo: o que muda quando já cobra com a GoCardlessJá cobra com a GoCardless mas ainda não usa Odoo? Veja o que passa para o Odoo com o conector: mandatos, cobranças de faturas, falhas e pagamentos.Erro retry_failed da GoCardless ao tentar cobrar novamente a partir do OdooA GoCardless responde retry_failed se o pagamento não falhou ou já não admite novas tentativas. Eis quando surge o botão «Tentar cobrar novamente» no Odoo.GoCardless access_token_revoked: o Odoo já não consegue falar com a sua contaA GoCardless rejeita com access_token_revoked, access_token_not_active ou unauthorized os pedidos de um token inválido. O que faz o Odoo e como voltar a ligar.Webhook do GoCardless: 498 Token Invalid, 204 e a assinatura Webhook-SignatureO GoCardless pede 498 se a Webhook-Signature não coincidir e 204 se não reconhecer o evento. O que responde o Odoo 17, 18, 19 e 20 e porque no 20 é um 401.
Verificado no código do conector (versão 17.0, 18.0, 19.0 e 20.0) e nas fontes indicadas

Fontes

  • flexigotech.com/pt/conector-gocardless-odoo.html
  • apps.odoo.com/apps/modules/20.0/flexigo_payment_gocardless
  • apps.odoo.com/apps/modules/17.0/flexigo_payment_gocardless
  • apps.odoo.com/apps/modules/18.0/flexigo_payment_gocardless
  • apps.odoo.com/apps/modules/19.0/flexigo_payment_gocardless
  • Código do módulo: flexigo_payment_gocardless 20.0 (94b33cf9): static/description/index.html
  • Código do módulo: flexigo_payment_gocardless: __manifest__.py, linha 31 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • gocardless.com/es-es/
  • Código do módulo: flexigo_payment_gocardless 20.0 (94b33cf9): data/ir_cron_data.xml
  • Código do módulo: flexigo_payment_gocardless 20.0 (94b33cf9): models/gocardless_payout.py
  • Código do módulo: flexigo_payment_gocardless 20.0 (94b33cf9): models/payment_transaction.py
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 152 em 17.0 (e0af273), linha 152 em 18.0 (9085180), linha 152 em 19.0 (4b06513) e linha 158 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 1185 em 17.0 (e0af273), linha 1185 em 18.0 (9085180), linha 1185 em 19.0 (4b06513) e linha 1197 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 1091 em 17.0 (e0af273), linha 1091 em 18.0 (9085180), linha 1091 em 19.0 (4b06513) e linha 1113 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 617 em 17.0 (e0af273), linha 617 em 18.0 (9085180), linha 617 em 19.0 (4b06513) e linha 623 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 408 em 17.0 (e0af273), linha 408 em 18.0 (9085180), linha 408 em 19.0 (4b06513) e linha 414 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 106 em 17.0 (e0af273), linha 106 em 18.0 (9085180), linha 106 em 19.0 (4b06513) e linha 105 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 377 em 17.0 (e0af273), linha 377 em 18.0 (9085180), linha 377 em 19.0 (4b06513) e linha 383 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 1142 em 17.0 (e0af273), linha 1142 em 18.0 (9085180), linha 1142 em 19.0 (4b06513) e linha 1154 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: i18n/pt.po, linha 429 em 17.0 (e0af273), linha 429 em 18.0 (9085180), linha 429 em 19.0 (4b06513) e linha 435 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: views/payment_transaction_views.xml, linha 18 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: views/payment_transaction_views.xml, linha 13 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: views/payment_transaction_views.xml, linha 20 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: views/payment_transaction_views.xml, linha 28 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 437 em 17.0 (e0af273), linha 437 em 18.0 (9085180), linha 436 em 19.0 (4b06513) e linha 451 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 430 em 17.0 (e0af273), linha 430 em 18.0 (9085180), linha 429 em 19.0 (4b06513) e linha 444 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 484 em 17.0 (e0af273), linha 484 em 18.0 (9085180), linha 483 em 19.0 (4b06513) e linha 502 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 461 em 17.0 (e0af273), linha 461 em 18.0 (9085180), linha 460 em 19.0 (4b06513) e linha 479 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 260 em 17.0 (e0af273), linha 260 em 18.0 (9085180), linha 260 em 19.0 (4b06513) e linha 271 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 729 em 17.0 (e0af273), linha 729 em 18.0 (9085180), linha 728 em 19.0 (4b06513) e linha 752 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 754 em 17.0 (e0af273), linha 754 em 18.0 (9085180), linha 753 em 19.0 (4b06513) e linha 777 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 725 em 17.0 (e0af273), linha 725 em 18.0 (9085180), linha 724 em 19.0 (4b06513) e linha 748 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/payment_token.py, linha 131 em 17.0 (e0af273), linha 131 em 18.0 (9085180), linha 131 em 19.0 (4b06513) e linha 130 em 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: const.py, linha 117 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • Código do módulo: flexigo_payment_gocardless: models/gocardless_webhook_event.py, linha 7 em 17.0 (e0af273), 18.0 (9085180), 19.0 (4b06513) e 20.0 (94b33cf)
  • docs.gocardless.com/docs/api-reference/payment
  • docs.gocardless.com/docs/optimise/reduced-failed-payments-with-success-plus
  • docs.gocardless.com/docs/api-reference/refund
  • github.com/odoo/odoo/blob/20.0/addons/account_payment/views/account_move_views.xml
  • github.com/odoo/odoo/blob/20.0/addons/account_payment/views/account_payment_views.xml
  • github.com/odoo/odoo/blob/20.0/addons/payment/i18n/pt.po
  • gocardless.com/es-es/tarifas/
  • gocardless.com/pricing-eu
  • Código do módulo: flexigo_payment_gocardless 20.0 (94b33cf9): models/payment_provider.py, linhas 70, 74, 856 e 875
  • flexigotech.com/pt/precios.html
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 333 em 17.0 (e0af273), linha 333 em 18.0 (9085180), linha 333 em 19.0 (4b06513) e linha 344 em 20.0 (94b33cf)
  • github.com/odoo/odoo/blob/20.0/addons/account_payment/models/account_payment.py
  • Código do módulo: flexigo_payment_gocardless: models/payment_transaction.py, linha 247 em 17.0 (e0af273), linha 247 em 18.0 (9085180), linha 247 em 19.0 (4b06513) e linha 258 em 20.0 (94b33cf)
  • gocardless.com/de-de/preise/
  • gocardless.com/fr-fr/tarifs/
  • gocardless.com/nl/handleidingen/sepa/bescherming/