Para conciliar Mercado Pago, Asaas e PagBank com o ERP, organize três registros diferentes: a venda, o recebimento no provedor e a transferência para a conta bancária. Depois associe cada movimento ao pedido original, preserve taxas e ajustes em campos próprios e encaminhe divergências para revisão. Um aviso de pagamento aprovado ajuda a atualizar o atendimento, mas não prova sozinho que o dinheiro ficou disponível nem que chegou ao banco.
A IA pode explicar diferenças e sugerir onde investigar. A confirmação financeira deve continuar baseada em identificadores, documentos e regras verificáveis. Este é um desenho de implantação para negócios que recebem por mais de uma plataforma, com foco na comparação dos repasses e na atualização segura do ERP.
Resumo rápido
- Separe venda, saldo no provedor e transferência bancária.
- Crie um modelo comum sem apagar os campos originais de cada plataforma.
- Combine eventos operacionais com relatórios de movimentações.
- Trate taxas, estornos, antecipações e parcelas explicitamente.
- Use IA para investigar exceções, mantendo a baixa sob regras determinísticas.
O que exatamente precisa ser conciliado
O ERP registra a obrigação comercial: um cliente deve determinado valor por uma compra. O provedor registra o processamento e os movimentos financeiros associados. O banco registra entradas e saídas de caixa. Esses conjuntos conversam, mas suas linhas não têm necessariamente a mesma quantidade nem a mesma data. Uma compra pode virar várias parcelas; uma transferência pode reunir muitas vendas.
Por isso, estabeleça três perguntas independentes. A cobrança corresponde ao pedido certo? Os movimentos do provedor explicam o valor líquido devido? O saque ou repasse corresponde ao crédito bancário? A resposta positiva a uma delas não encerra as outras. Essa separação também evita classificar como atraso uma parcela cujo vencimento financeiro ainda não chegou.
Defina no início quem decide a política de baixa: o responsável financeiro, com apoio contábil quando necessário. O integrador traduz essa política em regras. Não escolha o momento da baixa apenas porque um webhook chega antes. Para a conferência da última etapa, o guia de conciliação bancária com extratos OFX cobre o encontro entre movimentos e extrato.
Como os três provedores entram na arquitetura
Não tente impor um único endpoint aos três serviços. Use adaptadores: pequenos componentes que consultam cada fonte e traduzem seus registros para o modelo interno. A tabela indica o papel das fontes consultadas; não representa equivalência entre produtos, contratos ou permissões.
| Provedor | Fonte oficial relevante | Uso na conciliação | Cuidado operacional |
|---|---|---|---|
| Mercado Pago | Relatório de Liberações | Entender disponibilidade e movimentos do saldo | Não confundir valor vendido com dinheiro disponível |
| Asaas | API e eventos de cobrança | Relacionar mudanças de estado às entidades locais | Separar recebimento do evento e efeito no ERP |
| PagBank | Extrato EDI transacional e financeiro | Comparar transações, recebíveis e liquidações | Planejar a leitura segundo o período coberto pelo extrato |
O Mercado Pago descreve o relatório de Liberações como uma visão das movimentações e da disponibilidade do dinheiro. Contestações e bloqueios ajudam a explicar por que o total vendido difere do saldo disponível. Na implementação proposta, conserve essas situações como eventos financeiros próprios, em vez de reduzir tudo a uma coluna genérica de diferença.
A documentação de eventos do Asaas orienta validar, persistir e confirmar o recebimento antes do processamento de negócio, além de tratar duplicidades e reprocessamento. Isso fundamenta a camada de entrada. Para fechar o período, acrescente consultas e documentos financeiros adequados ao produto contratado; o evento isolado não substitui a verificação dos totais.
O EDI do PagBank distingue informações transacionais e financeiras, trabalha com movimentos do dia anterior e requer solicitação de acesso. A documentação também informa exclusões, como vendas com vouchers. Portanto, registre a cobertura real da fonte antes de prometer que o painel representa toda a operação. Uma lacuna de cobertura deve aparecer como limitação conhecida, não como venda desaparecida.
Um modelo de dados que preserve as diferenças
Comece por um identificador interno de pedido e por uma tabela de correspondências. Nela, associe empresa, conta do provedor, identificador da cobrança e identificador do pedido no ERP. O nome do cliente pode ajudar uma pessoa a investigar, mas não é uma chave confiável. Nomes repetidos, abreviações e compras de terceiros tornam esse atalho arriscado.
Para cada movimento, grave origem, identificador externo, tipo, moeda, valor, data do evento, data de disponibilidade quando existir e referência ao documento original. Inclua parcela e grupo de liquidação quando a fonte oferecer esses campos. Não preencha datas desconhecidas com a data da importação: isso transforma ausência de informação em informação falsa.
Armazene dinheiro em centavos ou em um tipo decimal adequado. Defina o sinal de cada lançamento: entradas positivas, saídas negativas, por exemplo. Preserve também o valor recebido originalmente. A normalização deve ser reversível para que uma divergência possa ser investigada sem baixar novamente um relatório que talvez já tenha mudado.
Crie relações de um para muitos. Um pedido pode ter tentativas de pagamento diferentes; uma cobrança pode ter reembolso parcial; uma transferência pode consolidar movimentos. O sistema precisa representar essas relações antes de oferecer correspondência automática. Uma planilha de controle pode servir ao piloto, desde que não esconda essas associações em comentários soltos.
Fluxo de implantação: importar, comparar e registrar
1. Construir uma área de entrada
Guarde cada arquivo ou evento com um identificador de importação, período e conta de origem. O registro bruto fica separado das tabelas utilizadas para conciliar. Assim, corrigir uma regra de leitura não exige alterar a evidência. Para arquivos repetidos, compare uma impressão digital do conteúdo e a identificação do documento, evitando importar duas vezes o mesmo lote.
Nas notificações, aplique o mecanismo de validação específico do produto. O guia de Webhooks do Mercado Pago documenta a assinatura no cabeçalho x-signature. Não copie essa configuração para outro fornecedor. A implementação de cada adaptador deve seguir a documentação correspondente e manter segredos fora de prompts e relatórios.
2. Calcular a posição esperada
Para cada cobrança, reúna principal, taxas identificadas, devoluções, ajustes e valores liberados. Evite a fórmula universal “venda menos taxa igual depósito”: ela não representa bloqueios, antecipação ou agrupamentos. A posição esperada depende do ciclo completo registrado para aquela operação. Quando faltar um componente, classifique como informação pendente, sem estimar silenciosamente a diferença.
3. Associar por regras graduais
Priorize referência externa exata, conta correta e moeda compatível. Depois verifique valor e período. Correspondências aproximadas por descrição ou proximidade de data devem gerar candidatos para revisão. Defina tolerância apenas quando houver justificativa documentada, como uma regra de arredondamento conhecida. Não use uma tolerância ampla para esconder taxa não identificada.
4. Atualizar o ERP uma única vez
Antes de gravar uma baixa, produza uma proposta com título, valor, movimentos associados e regra aplicada. Use uma chave de idempotência, isto é, uma referência que impeça repetir o mesmo efeito. Se o ERP não oferecer esse recurso, mantenha um registro local dos efeitos e consulte o destino após respostas incertas. Um timeout não significa necessariamente que a operação falhou.
Conserve estados separados para “comparado”, “aprovado” e “gravado no ERP”. Uma conciliação correta pode aguardar integração, e uma integração bem-sucedida pode ter usado dados incorretos. O painel precisa permitir distinguir esses problemas. Para a camada de orquestração, compare as opções em Zapier, Make e n8n com IA.
Exemplo: loja de peças em Campinas com três canais
Imagine uma loja de peças em Campinas que recebe pedidos do site por Mercado Pago, cobra clientes recorrentes pelo Asaas e usa PagBank em outra frente comercial. O cenário é ilustrativo. O financeiro começa com um período fechado e seleciona operações que incluem pagamento simples, parcelamento, devolução parcial e transferência agrupada.
Uma compra aparece como paga no site, mas seu dinheiro ainda não está disponível. O painel mostra “cobrança confirmada, liquidação pendente” e mantém a referência do pedido. Outra operação tem devolução parcial: a devolução é associada à cobrança original sem apagar o recebimento anterior. No banco, uma entrada reúne vários movimentos; o vínculo é feito com o grupo, preservando a composição.
A IA recebe apenas a ficha da divergência e os movimentos necessários. O pedido pode ser: “Explique a diferença entre a posição esperada e a observada. Cite os identificadores que sustentam cada hipótese. Se faltar evidência, indique qual documento consultar. Não sugira baixa sem correspondência comprovada”. A resposta vai para a fila do analista, nunca diretamente para a API financeira.
O piloto será considerado pronto quando o responsável conseguir reproduzir cada conclusão com as fontes e repetir a importação sem gerar novas baixas. Meça operações sem correspondência, idade das pendências e retrabalho por regra. Esses indicadores orientam melhorias sem inventar uma promessa de economia ou uma taxa de acerto antecipada.
Erros comuns
Tratar recebimento como receita nova em cada sistema. A mesma venda pode aparecer no ERP, no provedor e no banco. Se cada aparição gerar um lançamento comercial independente, o painel duplica a operação. Mantenha as entidades e seus vínculos explícitos.
Deixar a IA calcular o saldo final. Aritmética e aplicação de taxas devem ser funções verificáveis. O modelo pode ajudar a interpretar uma descrição, mas não deve substituir cálculos ou inventar a natureza de uma cobrança desconhecida.
Ignorar a data de corte. Registre fuso, período solicitado e momento da extração. Uma comparação entre janelas diferentes produz divergências artificiais, sobretudo em operações próximas da meia-noite. Reabra períodos conforme política definida, preservando versões anteriores.
Testar apenas o caminho feliz. Reenvie um evento, processe um arquivo duplicado, simule falha do ERP após a gravação e importe uma devolução posterior. Verifique também conta errada e referência ausente. O teste relevante comprova que nenhuma dessas situações cria baixa indevida.
Perguntas frequentes
É necessário usar IA em toda conciliação?
Não. Correspondências exatas e contas fechadas dispensam modelo de linguagem. Use IA quando a explicação textual ou a organização de evidências ajudar o analista. Isso reduz custo e facilita entender por que determinada decisão foi tomada.
Um webhook pode substituir o relatório financeiro?
Não convém assumir isso. O evento serve a mudanças operacionais; o fechamento depende da cobertura e do significado das fontes financeiras. Combine as duas camadas e documente quais movimentos cada uma representa.
Posso conciliar somente pelo valor?
Um mesmo valor pode aparecer em várias vendas. Use identificadores e contexto da conta; trate valor como verificação complementar. Quando não houver referência suficiente, apresente candidatos e exija revisão em vez de escolher automaticamente.
Como começar sem integração de escrita no ERP?
Produza um relatório de propostas com links para as evidências. O responsável valida e registra pelo procedimento existente. Só habilite escrita depois de demonstrar rastreabilidade, recuperação de falhas e proteção contra repetição no processo completo.
