O adquirente pagou o líquido certo? O motor calcula e casa contra o que caiu.
Quem recebe por cartão confere o total do depósito, não o cálculo por trás dele: bruto menos taxa menos antecipação, por venda, por parcela, em data diferente da venda. O motor calcula o líquido esperado de cada venda, casa contra a liquidação do adquirente pela referência e aponta taxa cobrada a mais, parcela que não caiu e venda que sumiu.
3 registros | 3 OK/antecipado | 0 alertas | conciliacao 100.0%
OK: 3
R$ taxa cobrada a mais: 0.00 | R$ nao liquidado: 0.00
saida: conciliado.csv saída real do motor, num arquivo de teste do repositório.
7
testes automatizados no motor
10
vereditos possíveis, de OK a CHARGEBACK
0
dependências para instalar: só a biblioteca padrão do Python
Quem recebe por cartão confere o total do depósito, não o cálculo por trás: bruto menos taxa menos antecipação, por venda, por parcela, em data diferente da venda.
Sem esse cálculo, taxa cobrada a mais, parcela que não caiu ou venda que nunca foi liquidada passam batido no meio do lote.
Como funciona
- 1 Calcula. Calcula o líquido esperado de cada venda: o bruto menos a taxa (MDR) do contrato, menos a antecipação quando houver.
- 2 Casa. Casa a liquidação do adquirente contra a venda do ERP pela referência (NSU, autorização ou pedido), mesmo quando uma venda vira várias parcelas.
- 3 Aponta. Aponta o veredicto de cada linha, taxa cobrada a mais, parcela faltante, venda não liquidada, chargeback e outros, e o resumo do lote inteiro.
As duas formas de resolver isso
Taxa cobrada a mais que o contrato
- Olhar o total do depósito
- some dentro do total, ninguém percebe
- Conciliação de Recebíveis (nós)
- vira TAXA DIVERGE, com o valor da diferença
Parcela que não caiu
- Olhar o total do depósito
- só aparece quando o caixa não fecha no fim do mês
- Conciliação de Recebíveis (nós)
- vira PARCELA FALTANTE, apontada na hora
Venda nunca liquidada
- Olhar o total do depósito
- fica escondida no meio do lote
- Conciliação de Recebíveis (nós)
- vira VENDA NAO LIQUIDADA, listada
Custo
- Olhar o total do depósito
- o tempo de quem confere o extrato de cartão
- Conciliação de Recebíveis (nós)
- grátis e aberto
O dado é seu
A liquidação fica com você.
No terminal, no Claude Code ou no Cowork, o motor lê os CSVs no seu computador e o Claude só vê o resumo agregado que ele imprime (quantos registros, quantos OK, o total de taxa cobrada a mais e o percentual de conciliação), nunca a venda linha a linha. Anexar a planilha numa conversa comum do Claude, na web ou no app, é outra coisa: aí o arquivo sobe para a nuvem da Anthropic.
O que vem
- O motor em Python, sem nenhuma dependência para instalar.
- Os três CSVs de exemplo (liquidações, vendas e a tabela de MDR), com o resultado que eles têm de dar.
- Os testes, com o gabarito sintético que eles usam.
A prova que eu tenho hoje
A prova hoje é de bancada, e mais frágil que a dos outros motores da fila: o gabarito é inteiramente sintético, gerado pelos próprios testes, e nenhum export real de adquirente (Cielo, Rede, Stone ou qualquer outra) passou por ele ainda. Trate o resultado como hipótese, não como conciliação auditada, até isso acontecer.
Onde isso ainda não chega.
- O gabarito é sintético: o motor acerta os casos gerados pelos próprios testes, não os de um export real de adquirente.
- Registradora multi-credor (como CERC, TAG ou B3) e parcelado do emissor com juros ficam fora do escopo.
- Sem o CSV de MDR, o motor mostra a taxa efetiva mas não julga se ela está errada: sem o contrato, não há o que comparar.
- O motor não paga nem registra nada: concilia e aponta, quem decide é a pessoa.
É para você?
É para você se
- Quem recebe por cartão e hoje só confere o total do depósito, não o cálculo por trás dele.
- Quem já suspeitou de taxa cobrada a mais e não teve como provar.
Não é para você se
- Quem precisa conciliar registradora multi-credor ou parcelado do emissor com juros.
- Quem quer o número já validado contra um export real de adquirente: este ainda não tem esse histórico.
Antes de instalar: o que você precisa
- Python no computador; o motor não usa nenhuma biblioteca externa.
- Para usar como skill: Claude Code, ou o Cowork do Claude Desktop (plano pago). Direto no terminal funciona sem Claude nenhum.
- As planilhas de liquidação e de vendas em CSV (a de MDR é opcional, mas sem ela o motor não julga a taxa).
Grátis e aberta quando sair da fila.
Conciliação de Recebíveis está na fila de abertura e vai sair grátis, com o código aberto. Avisamos você quando sair.
- O motor em Python, sem nenhuma dependência para instalar.
- Os três CSVs de exemplo (liquidações, vendas e a tabela de MDR), com o resultado que eles têm de dar.
- Os testes, com o gabarito sintético que eles usam.
Recebe no seu e-mail
Sem spam. Descadastro em 1 clique.
Perguntas frequentes
A planilha sai da minha máquina?
No terminal, no Claude Code ou no Cowork, não: o motor lê os CSVs aí e o Claude só vê o resumo agregado que ele imprime. Anexar a planilha numa conversa comum do Claude, na web ou no app, é diferente: o arquivo sobe para a nuvem da Anthropic.
Já foi testado com dado real de adquirente?
Ainda não. O gabarito é sintético, e o resultado deve ser tratado como hipótese até um export real de adquirente passar por ele.
Ele decide se a taxa está errada?
Só quando você manda o CSV de MDR (o contrato de taxa por produto e bandeira). Sem ele, o motor mostra a taxa efetiva mas não julga.
Ele paga ou registra alguma coisa?
Não. Ele concilia e aponta; pagar, registrar ou contestar é decisão da pessoa.