Pular para o conteúdo
TRILHA TESOURARIA · ABERTA

Concilia o mês em minutos, com o motor aberto, no terminal ou no Claude Code.

A conciliação bancária que trava seu fechamento vira uma conversa. Você aponta o extrato (OFX de preferência) e o razão do seu ERP, a skill cruza tudo, inclusive o lote de vários títulos para um crédito só, e te entrega o que bateu, o que sobrou e o que ficou ambíguo.

Como instalar Dar uma estrela no GitHub Grátis e aberta · Apache-2.0
python scripts/conciliar.py conciliar --extrato exemplo/extrato.ofx --razao exemplo/razao.csv --saldo-razao 17690,00 --out resultado
== FASE 1: VALIDACAO ==
{
  "colunas_detectadas": {
    "data": "Data",
    "valor": "Valor",
    "doc": "Documento",
    "ident": "Identificador",
    "contraparte": "Contraparte",
    "cpfcnpj": "CNPJ_CPF",
    "desc": "Historico"
  },
  "extrato": {
    "banco": "999",
    "conta": "••••-0",
    "tipo": "CHECKING",
    "moeda": "BRL",
    "transacoes": 12,
    "creditos": 6,
    "debitos": 6,
    "periodo": [
      "2026-01-02",
      "2026-01-31"
    ],
    "tem_saldo_final": true
  },
  "razao": {
    "linhas": 11,
    "periodo": [
      "2026-01-02",
      "2026-01-22"
    ]
  },
  "reprovas": [],
  "avisos": []
}

== FASE 2: CRUZAMENTO ==
  CONCILIADO                   7
  CONCILIADO_COM_DIFERENCA     1
  PENDENTE_EXTRATO             4
  PENDENTE_RAZAO               3

  pendencias por categoria (a cauda):
    CHEQUE_NAO_COMPENSADO      1  -> aguardar compensação no banco
    DEPOSITO_TRANSITO          1  -> aguardar crédito no banco
    EM_TRANSITO                1  -> aguardar / conferir
    LIQUIDO_ADQUIRENTE         1  -> conciliar pelo líquido + linha de taxa
    RENDIMENTO                 1  -> lançar no razão (receita financeira)
    TARIFA_IOF                 2  -> lançar no razão (despesa bancária)

== FASE 3: RELATORIO ==
  amarracao: FECHA (integridade OK)
  resumo (p/ IA): resultado\resumo.json
  relatorio (LOCAL, dado bruto): resultado\conciliacao.xlsx

saída real do motor, num arquivo de teste do repositório.

48

extratos reais lidos

7

bancos diferentes

0

erros de leitura

87%

dos títulos casados sozinhos, sem lote pesado

Todo fechamento, alguém abre o extrato e o razão lado a lado e cata linha por linha o que bate. Isso consome horas, e ainda sobra o risco de deixar passar um lançamento errado direto para a auditoria.

Terceirizar numa BPO custa de R$ 800 a R$ 3.000 por mês. Um SaaS de conciliação, de R$ 80 a R$ 480 por mês, com seu extrato subindo para a nuvem deles.

Como funciona

  1. 1 Lê. Lê o extrato (OFX de preferência; CSV, Excel ou PDF também) e o razão do seu ERP.
  2. 2 Cruza. Cruza lançamento a lançamento, inclusive o lote N:1 (vários títulos do razão para um crédito só do extrato), e desempata mesmo valor no mesmo dia por CNPJ e contraparte.
  3. 3 Entrega. Entrega o que bateu, o que sobrou e o que ficou ambíguo, com cada pendência já rotulada (tarifa, IOF, Pix órfão, líquido de adquirente), para você decidir o resto.

As três formas de resolver isso

Custo

BPO terceirizada
R$ 800 a R$ 3.000/mês
SaaS de conciliação
R$ 80 a R$ 480/mês
Motor aberto (nós)
grátis e aberta

Onde o seu extrato roda

BPO terceirizada
sai da empresa
SaaS de conciliação
sobe pra nuvem deles
Motor aberto (nós)
na sua máquina, no terminal e no Claude Code; no Cowork e no chat, na nuvem da Anthropic

Lote N:1 (vários títulos, 1 crédito)

BPO terceirizada
manual
SaaS de conciliação
raro
Motor aberto (nós)
casa no automático

Quem decide o duvidoso

BPO terceirizada
a BPO
SaaS de conciliação
regra fixa
Motor aberto (nós)
você, com tudo rotulado

O dado é seu

O que sai da sua máquina, em cada caminho.

No terminal, o motor lê o extrato e o razão no seu computador e nada sai dele. No Claude Code, em sessão local, o motor também lê o extrato e o razão no disco, e a skill foi feita para o Claude ver só o resumo agregado que ele imprime, nunca a linha da transação; o seu pedido, esse resumo e qualquer arquivo que o Claude abrir vão para a Anthropic. No Cowork e numa conversa comum do Claude, na web ou no app, o trabalho roda na nuvem da Anthropic e o extrato e o razão sobem para lá.

O que vem

A prova que eu tenho hoje

Ainda não tenho relato de uso de outra empresa. O que tenho é o teste com dado real: rodei o motor contra 48 extratos OFX de 7 bancos (Itaú, Bradesco, Banco do Brasil, Santander, Caixa, Safra e ABC). Leu os 48 sem um único erro de leitura. Nos meses sem lote pesado, 87% dos títulos do razão casaram sozinhos; nos de lote pesado, 25%, porque falta o número da remessa no razão.

Onde isso ainda não chega.

  • Nos meses de lote pesado a taxa cai: é número de remessa faltando no razão, não o motor errando.
  • Onde falta o dado, ele diz exatamente o que falta e agrega o controle, em vez de forçar um par errado.

É para você?

É para você se

  • Você fecha conciliação bancária todo mês e perde horas no de-para manual entre extrato e razão.
  • Tem Python no computador e usa o Claude Code, ou topa rodar o motor direto no terminal.
  • Quer o motor lendo o extrato no seu disco, pelo terminal ou pelo Claude Code, e não um SaaS de conciliação.

Não é para você se

  • Precisa de conciliação de CNAB automática: fica de fora de propósito, porque o retorno CNAB já é auto-conciliado pelo seu ERP.
  • Quer um SaaS com login, dashboard e app. Isto é uma skill que roda no seu Claude, não um site que você acessa.

Antes de instalar: o que você precisa

  • Python 3.10 ou mais no computador.
  • Para extrato ou razão em Excel e extrato em PDF: as bibliotecas do `requirements.txt` (`pip install -r requirements.txt`). OFX e CSV não pedem nada além do Python.
  • Para usar como skill: Claude Code, ou o Cowork do Claude Desktop (plano pago). Direto no terminal funciona sem Claude nenhum.
  • O extrato (OFX de preferência) e o razão do seu ERP.

Como instalar

Quatro caminhos. O que sobe para a Anthropic muda em cada um, então escolha pelo seu arquivo.

  1. Terminal, sem IA. Baixe o repositório e rode o motor com Python. O motor lê o arquivo no seu computador e nada sai dele.
  2. Claude Code. Instale o plugin pelo marketplace do repositório. Em sessão local, o motor também lê o arquivo no disco, e a skill foi feita para o Claude ver só o resumo que ele imprime; o seu pedido, esse resumo e qualquer arquivo que o Claude abrir vão para a Anthropic.
  3. Cowork. Adicione o marketplace do repositório. O trabalho roda na nuvem da Anthropic e o arquivo usado sobe para lá.
  4. Conversa do claude.ai. Suba o zip da skill. O trabalho roda na nuvem da Anthropic e o arquivo anexado sobe para lá.

Passo a passo de cada um, com os comandos: como instalar uma skill no Claude. O código, o README e as issues estão no GitHub (Apache-2.0).

Me avise da próxima ferramenta

Quando a próxima ferramenta abrir, mandamos um e-mail. Sem data marcada.

Sem spam. Descadastro em 1 clique.

Perguntas frequentes

Preciso saber programar?

Não. No Claude Code, a instalação são dois comandos; depois você pede em português. O tutorial de instalação mostra cada passo.

Meus dados vão para a nuvem?

No terminal, não. No Claude Code, em sessão local, o motor lê o extrato e o razão no disco e a skill foi feita para o Claude ler só o resumo agregado que o motor imprime (contagens, totais, saldos), mas o seu pedido, esse resumo e qualquer arquivo que o Claude abrir vão para a Anthropic. No Cowork e numa conversa comum do Claude, sim: o trabalho roda na nuvem da Anthropic e o extrato e o razão sobem.

Quanto custa?

Nada. É grátis e aberta, sob Apache-2.0: o código está no GitHub.

E se não funcionar para mim?

Abra uma issue no repositório dizendo o banco, o formato do arquivo e o que quebrou. Não anexe extrato nem razão reais; use um arquivo fictício.