PixERPOpen Financefintechconciliação

Pix integrado ao ERP: cobrança, conciliação automática e Open Finance na prática

Como integrar Pix Cobrança ao seu ERP com conciliação automática via APIs do Bacen e Open Finance. Implementação técnica e armadilhas comuns.

Por Bradata·12 de junho de 2026·6 min de leitura

O problema real: Pix entrou, mas o ERP não acompanhou

Em maio de 2026, o Bacen registrou mais de 5,2 bilhões de transações Pix em um único mês. Empresas B2B e B2C recebem por Pix diariamente. Mas na maioria dos ERPs, o financeiro ainda entra no internet banking, confere créditos Pix, volta ao ERP e dá baixa manual título por título.

Pix tem API, webhook e estrutura de dados padronizada pelo Bacen. O problema é que a maioria dos ERPs trata Pix como depósito genérico, sem vínculo com o título de origem. A conciliação fica manual e propensa a erro.

Este post detalha como integrar Pix Cobrança ao ERP com conciliação automática via APIs do Bacen e Open Finance.

Pix Cobrança: a peça que falta na maioria dos ERPs

Diferente do Pix comum (transferência livre entre chaves), o Pix Cobrança gera uma cobrança com valor definido, identificador único (txid) e QR Code. Dois tipos:

Cobrança imediata (cob): sem vencimento. O pagador escaneia e paga. Útil para PDV e e-commerce.
Cobrança com vencimento (cobv): tem data de vencimento, multa, juros e desconto configuráveis. Funciona como boleto registrado, mas com liquidação instantânea.

A cobv é a mais relevante para ERPs. Ela permite substituir boletos por Pix em contas a receber, mantendo as mesmas regras de negócio: vencimento, juros moratórios, multa por atraso, desconto por antecipação.

Criando uma cobrança via API Pix do Bacen

A API Pix (especificação v2.6.1, Bacen) é implementada pelo PSP (banco ou instituição de pagamento). Autenticação: OAuth 2.0 com mTLS (certificado A1).

# Criação de cobrança com vencimento (cobv)
PUT /cobv/{txid}
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "calendario": {
    "dataDeVencimento": "2026-07-10",
    "validadeAposVencimento": 30
  },
  "devedor": {
    "cnpj": "12345678000195",
    "nome": "Empresa Exemplo Ltda"
  },
  "valor": {
    "original": "4500.00",
    "multa": { "modalidade": 2, "valorPerc": "2.00" },
    "juros": { "modalidade": 2, "valorPerc": "1.00" },
    "desconto": {
      "modalidade": 1,
      "descontoDataFixa": [
        { "data": "2026-07-05", "valorPerc": "5.00" }
      ]
    }
  },
  "chave": "financeiro@empresa.com.br",
  "solicitacaoPagador": "Fatura #4521 - Serviços Jun/2026"
}

O txid é o campo de ligação entre Pix e título no ERP. Essa é a decisão mais importante da integração. Use um identificador que localize o título de forma unívoca. Na prática, muitas equipes usam o ID do contas a receber ou uma composição de filial + número do título.

Recebendo o pagamento via webhook

Quando o pagador quita a cobrança, o PSP envia uma notificação para o webhook cadastrado:

POST /webhook-pix
Content-Type: application/json

{
  "pix": [
    {
      "endToEndId": "E12345678202606121830s0123456789",
      "txid": "CR00045210001",
      "valor": "4500.00",
      "horario": "2026-06-12T18:30:22.000Z",
      "infoPagador": "Pagamento fatura Jun/2026"
    }
  ]
}

O txid vem de volta. O ERP localiza o título, compara valor recebido com valor devido, dá baixa automática e registra a diferença contábil se houver.

Conciliação automática: o fluxo completo

Webhook é o caminho principal, mas não pode ser o único. Webhooks falham: o PSP pode ter instabilidade, seu servidor pode estar fora. A arquitetura precisa de dois caminhos:

                ┌─────────────────┐
                │  PSP (Banco)    │
                └──────┬──────────┘
                       │
          ┌────────────┼────────────┐
          │ webhook    │            │ polling
          ▼            │            ▼
  ┌───────────┐        │    ┌──────────────┐
  │ Listener  │        │    │ Job agendado │
  │ (real-time)│       │    │ (a cada 5min)│
  └─────┬─────┘        │    └──────┬───────┘
        │              │           │
        ▼              │           ▼
  ┌─────────────────────────────────────┐
  │     Motor de conciliação (ERP)      │
  │  1. Busca título pelo txid          │
  │  2. Valida valor (juros/desconto)   │
  │  3. Baixa automática                │
  │  4. Lançamento contábil             │
  │  5. Notificação ao comercial        │
  └─────────────────────────────────────┘

O job de polling consulta GET /cobv ou GET /pix periodicamente para capturar pagamentos que o webhook perdeu. Idempotência é obrigatória. O campo endToEndId (E2E) é único por transação Pix no SPI. Use ele como chave de deduplicação.

Regras de matching para valores divergentes

Na prática, o valor recebido nem sempre bate exatamente com o valor original:

Cenário	Valor original	Valor recebido	Tratamento
Pagamento exato	R$ 4.500,00	R$ 4.500,00	Baixa total
Pagamento com juros	R$ 4.500,00	R$ 4.590,00	Baixa total + lançamento de juros recebidos
Pagamento com desconto	R$ 4.500,00	R$ 4.275,00	Validar se desconto é legítimo pela data, baixa total + lançamento de desconto concedido
Pagamento parcial	R$ 4.500,00	R$ 2.000,00	Baixa parcial, título permanece em aberto com saldo
Pagamento duplicado	R$ 4.500,00	R$ 4.500,00 (segundo)	Rejeitar via API ou registrar crédito para devolução

A cobv do Bacen calcula juros e desconto automaticamente pelo PSP, então o valor no webhook geralmente já reflete essas regras. Mas nem todo PSP implementa de forma consistente. Teste com o seu banco.

Open Finance: o próximo nível

Open Finance no Brasil (regulado pelo Bacen, Fase 4 em operação) permite que o ERP acesse dados bancários do cliente com consentimento. Dois casos de uso diretos:

Iniciação de pagamento (ITP): o ERP inicia um Pix direto da conta do pagador, sem que ele abra o app do banco. Menos atrito que QR Code.

Consulta de extratos: com consentimento, o ERP consulta extratos via API Open Finance para conciliação bidirecional. Resolve o problema de pagamentos fora do Pix Cobrança (TEDs, transferências manuais) que ficam como "não identificados".

A autenticação segue o padrão FAPI (Financial-grade API): PKCE, request objects assinados com JWS, certificados ICP-Brasil. Abstraia isso em um serviço intermediário que encapsula a autenticação e expõe endpoints simplificados para o ERP.

Armadilhas comuns na integração

Estas são as que vemos com mais frequência:

1. Certificado mTLS expirando sem alerta. O certificado A1 vale 1 ano. Quando expira, a API para silenciosamente. Monitore e alerte 30 dias antes.

2. Webhook sem fallback. Alguns PSPs tentam entregar o webhook 3 vezes. Outros, apenas 1. Sem polling de backup, pagamentos ficam sem baixa.

3. txid sem padronização. Cada módulo do ERP gera txid diferente. Contas a receber usa um padrão, vendas usa outro. Defina uma convenção única no início do projeto.

4. Ignorar o ciclo de vida da cobrança. Cobranças têm status: ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR, REMOVIDA_PELO_PSP. Cobranças expiradas precisam atualizar o título no ERP.

5. Não tratar devolução. A API Pix permite devolução parcial ou total até 90 dias. Se o ERP não implementa, o financeiro faz no internet banking e a conciliação quebra.

6. Sandbox irreal. A maioria dos PSPs oferece sandbox com comportamento diferente da produção. Teste em produção com valores baixos (R$ 0,01) antes de liberar.

Resultado prático

Em um cliente nosso de distribuição com 1.200 títulos/mês, a migração de boleto para Pix Cobrança com conciliação automática gerou:

Conciliação caiu de 12h/semana para menos de 1h (só revisão de exceções)
Prazo médio de recebimento caiu 4 dias (Pix liquida na hora, boleto levava D+1 a D+3)
Inadimplência caiu 18% (cobv gera notificação nativa no app do banco)
Custo por recebimento caiu de R$ 3,50 (boleto) para R$ 0,80 (Pix)

Conclusão

Pix Cobrança com conciliação automática não é diferencial. É o mínimo esperado de um ERP em 2026. Para B2B, cobv substituiu o boleto na prática.

A integração técnica é tratável. As APIs do Bacen são bem documentadas. O trabalho real está nos detalhes: ciclo de vida da cobrança, matching de valores divergentes, fallback de webhook, renovação de certificado, tratamento de devoluções.

Se você precisa integrar Pix ao seu ERP, fale com a Bradata. Implementamos integrações Pix com conciliação automática em ERPs de diferentes portes e segmentos.

Fontes: Especificação API Pix v2.6.1 (Bacen), Manual de Iniciação de Pagamentos Open Finance Brasil, Estatísticas do Pix (Bacen, maio/2026), regulamentação FAPI/Open Finance, projetos internos Bradata.

Compartilhar:LinkedIn X (Twitter)WhatsApp