Conciliação de recebimentos

Cruze pelo id que existe nos dois lados: id da transação no processador, id do boleto na plataforma de cobrança, número do pedido no gateway. Quando o ERP não guarda esse id, faça em duas etapas: primeiro data de liquidação e valor bruto, pareando 1 para 1 (cada linha do extrato casa com uma única parcela); depois, para o que sobrou, nome normalizado e valor com até 3 dias de diferença. Nome diferente com valor e data iguais não é baixado sozinho: vai para revisão manual.

Cada par recebe um status: igual (diferença dentro da tolerância, por exemplo até R$ 1,00), divergente (os dois valores e a diferença lado a lado), só no extrato e só no core ou ERP. Divergência não é erro do pipeline: é discordância real entre sistemas, e a tabela existe para mostrá-la. Se a conferência for exata, sem tolerância, arredondamento também aparece como divergência, e isso precisa estar escrito.

O que move o saldo é a data em que o dinheiro foi liquidado ou repassado, não a data do pagamento ou do pedido. Converta a data para America/Sao_Paulo antes de cruzar: o ERP costuma baixar o cartão no dia anterior ao que a planilha em UTC mostra. Mantenha a data exibida para o usuário e use a data convertida só no cruzamento.

Duplicado é o mesmo cliente, com o mesmo id de transação e o mesmo valor, com dois ou mais pagamentos concluídos. Em cobrança recorrente de tarifa ou assinatura, conta como duplicada a segunda cobrança em até 2 dias da primeira. Estornos ficam fora, e lançamentos de teste ou validação de valor simbólico (até R$ 1) também.

O core grava sucesso ou falha numa coluna própria, mas a resposta bruta do processador traz o status real. Leia o status da resposta, normalize (falha dura e falha leve viram erro; sucesso vira concluído) e liste diariamente os pagamentos em que os dois discordam. É ali que aparece o contrato baixado sem dinheiro ou cobrado de novo.

Gere a lista de dias esperados numa janela móvel (por exemplo, os últimos 35 dias, ignorando os 2 mais recentes, que ainda podem chegar) e marque cada dia como presente ou faltando, com a contagem de linhas e de arquivos. Grave o resultado em modo de acumulação e alerte quando faltar dia. Dia sem arquivo deixa receita e custo do processador abaixo da fatura.

No core de crédito, cada pagamento se divide em principal, juros, multa e tarifas. A soma dos componentes tem que ser igual ao valor pago; quando o arquivo traz um resíduo, aloque-o num componente declarado (por exemplo, principal) e marque a linha. Concilie o total com o processador e os componentes com a carteira.

Durante migração de processador ou de plataforma de cobrança, o mesmo pagamento aparece nas duas fontes. Empilhar as duas conta a cobrança duas vezes. Deduplique pelo id da transação preferindo o registro pago, e corte por data: a fonte antiga até o dia anterior à virada, a nova a partir dela, excluindo o dia processado nas duas.

O título traz a conta esperada e a baixa traz a conta em que o dinheiro entrou; filtre pela conta da baixa. Some só a categoria de receita: tarifas do meio de pagamento, estornos e taxa de transferência são lançamentos próprios. Estorno e contestação usam o valor líquido lido direto da linha do extrato, nunca recalculado a partir do bruto.

Antes de criar ou baixar qualquer lançamento pelo conector, liste o dia no ERP e compare descrição e valor contando ocorrências. Crie só o que falta; o que existe em aberto, apenas baixe. A criação costuma ser assíncrona e o conector não tem exclusão: um lançamento duplicado só sai à mão. Depois, confira o dia: pago a receber igual à soma do extrato, aberto igual a zero.