Pular para conteúdo

Pagamentos e Integrações Financeiras

Objetivo

Documentar os módulos de integração com adquirentes de pagamento (Cielo, Rede, PagBank), a cobrança escritural (boleto/CNAB), o pagamento escritural e a destinação bancária.

Faturamento → Faturamento → Contas a Receber → Cobrança Remessa Faturamento → Faturamento → Contas a Receber → Cobrança Retorno Faturamento → Faturamento → Contas a Pagar → Pagamento Escritural Faturamento → Faturamento → Contas a Pagar → Retorno Escritural Faturamento → Faturamento → Contas a Receber → Destinação Bancária

Módulos de Pagamento (Payment Providers)

Cielo (l10n_br_ciel_it_payment_cielo)

Dado Valor
Módulo l10n_br_ciel_it_payment_cielo
Versão 25.3.14
Depende payment
Frontend payment_portal.js
Funcionalidade Integração com Cielo E-commerce (cartão crédito/débito)

Rede (l10n_br_ciel_it_payment_rede)

Dado Valor
Módulo l10n_br_ciel_it_payment_rede
Versão 25.3.14
Depende payment
Frontend payment_portal.js
Funcionalidade Integração com Rede E-Rede (cartão crédito/débito)

PagBank (l10n_br_ciel_it_payment_pag_bank)

Dado Valor
Módulo l10n_br_ciel_it_payment_pag_bank
Versão 25.0.3
Depende payment
Funcionalidade Integração com PagBank (PIX, boleto, cartão)

Configuração Comum

Todos os módulos de pagamento seguem o padrão Odoo payment.provider: 1. Instalação do módulo lida com post_init_hook (cria o provider) 2. Configuração em Contabilidade → Configuração → Payment Providers 3. Credenciais de produção e sandbox separadas 4. Frontend com JavaScript OWL para o checkout

Cobrança Escritural (Boleto/CNAB)

Status do Título (l10n_br_situacao_cobranca)

Status Descrição
SALVO Título salvo no sistema
EMITIDO Boleto emitido/gerado
REGISTRADO Registrado no banco
LIQUIDADO Liquidado/pago
BAIXADO Baixado (cancelado)

Tipos de Espécie (COBRANCA_ESPECIE)

Código Descrição
01 DM — Duplicata Mercantil
04 DS — Duplicata de Serviço
25 DMI — Duplicata Mercantil por Indicação
AUTO Automático (definido pelo sistema)

Emissão de Bloqueto

Código Quem emite
1 Banco emite
2 Cliente emite
3 Banco pré-emite, cliente complementa
7 Banco emitente — aberta

Fluxo de Cobrança

flowchart LR
    A["Fatura Postada"] --> B["Gerar Remessa"]
    B --> C["Enviar ao Banco<br/>(arquivo CNAB)"]
    C --> D["Banco Registra"]
    D --> E["Cliente Paga"]
    E --> F["Retorno CNAB"]
    F --> G["Reconciliação<br/>Automática"]

Pagamento Escritural (Fornecedores)

Tipos de Pagamento CNAB

Código Descrição
1 Transferência — Conta Corrente
5 Transferência — Poupança
41 TED Outra Titularidade
43 TED Mesma Titularidade
45 PIX
47 PIX QR Code
30 Títulos do próprio banco
31 Títulos de outros bancos
16 DARF Normal
17 GPS
18 DARF Simples

Tipos de Conta

Código Tipo
0 Sem Conta
1 Conta Corrente
2 Poupança
99 Outros

Tipo de Chave PIX

Código Tipo
01 Telefone
02 E-mail
03 CPF/CNPJ
04 Chave Aleatória

Destinação Bancária

Funcionalidade

Regra funcional: Interface OWL customizada para gestão de destinação bancária de pagamentos. Permite selecionar múltiplas faturas e gerar remessas de pagamento em lote.

Controladores OWL

Controlador Arquivo Funcionalidade
destinacao_bancaria_list_controller.js static/src/js/ Lista de destinações bancárias
cobranca_escritural_remessa_list_controller.js static/src/js/ Remessa de cobranças
cobranca_escritural_retorno_list_controller.js static/src/js/ Retorno de cobranças
pagamento_escritural_remessa_list_controller.js static/src/js/ Remessa de pagamentos
pagamento_escritural_retorno_list_controller.js static/src/js/ Retorno de pagamentos

Cenários de Uso / Troubleshooting

1. Boleto não gerado

  • Verificar: Diário bancário está configurado para CNAB
  • Verificar: Operação de saída não está em TIPO_PEDIDO_SAIDA_NO_PAYMENT
  • Verificar: A parcela de pagamento gerou account.move.line no diário correto

2. Retorno CNAB não reconcilia

  • Verificar: Nosso número corresponde ao registrado no banco
  • Verificar: Arquivo de retorno está no formato correto do banco

3. Payment provider com erro no checkout

  • Verificar: Credenciais configuradas (sandbox vs. produção)
  • Verificar: Provider está em estado enabled

Referências Cruzadas