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.

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.


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ção | Botão Lançar na contabilidade | Resultado |
|---|---|---|
| A liquidação está paga, está equilibrada e não tem lançamento | Vê-se | Cria 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ário | Oculta-se | A vista esconde-o assim que o campo tem valor. |
O Estado (Status) da liquidação não é pago | Oculta-se | A vista esconde-o até a liquidação estar paga. |
A liquidação não está equilibrada (campo Equilibrado, Is Balanced) | Oculta-se | A vista esconde-o enquanto não estiver equilibrada. |
| Carrega no botão alguém que não é contabilista | Vê-se se se cumprirem as condições anteriores | Aparece 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çamento | Quando aparece | Lado e conta |
|---|---|---|
Liquidação da GoCardless … (GoCardless payout …) | Em todo o lançamento de liquidação | Débito, conta bancária, pelo montante liquidado |
Comissões da GoCardless (GoCardless fees) | Se as comissões líquidas forem positivas | Débito, conta de comissões |
Comissões da GoCardless reembolsadas (GoCardless fees refunded) | Se as comissões líquidas forem negativas | Crédito, conta de comissões |
Reembolsos e estornos (Refunds and chargebacks) | Se a liquidação trouxer reembolsos ou estornos | Débito, conta de compensação |
Cobranças da GoCardless liquidadas (GoCardless collections settled) | Em todo o lançamento de liquidação | Cré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
