Pular para o conteúdo
TRILHA TESOURARIA · NA FILA

Antes de pagar o boleto, confira se ele é mesmo o que o fornecedor mandou.

A linha digitável de um boleto carrega banco, valor, vencimento e dígitos verificadores. A Inteligência de Boleto decodifica isso e confere contra o que você esperava pagar, pegando valor alterado, vencimento alterado e código corrompido antes de o pagamento sair. Com uma referência da sua nota fiscal, ela também cruza o beneficiário do boleto contra o fornecedor esperado.

Quero ser avisado Grátis e aberta quando sair · na fila de abertura
python scripts/conferir_boleto.py boletos.csv 
3 boletos | 1 OK | 2 alertas
  DIGITO INVALIDO: 1
  OK: 1
  VALOR DIVERGE: 1
saida: boletos-conferido.csv

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

72

testes automatizados no motor

47

dígitos na linha digitável que ele decodifica

8

veredictos possíveis, do OK ao dígito inválido

A linha digitável do boleto é só uma fileira de números. Ninguém confere dígito por dígito se o valor, o vencimento e o código batem com o que o fornecedor combinou antes de aprovar o pagamento.

E a fraude clássica mora nessa brecha: o boleto trocado depois que o e-mail do fornecedor é invadido. A linha digitável não mostra a conta de destino, por isso a ferramenta tem dois níveis: confere valor, vencimento e dígito de todo boleto, e cruza o beneficiário com o fornecedor da nota quando você lê o PDF com a referência.

Como funciona

  1. 1 Decodifica. Decodifica a linha digitável do boleto: banco, valor, vencimento e dígitos verificadores.
  2. 2 Confere. Confere o valor e o vencimento decodificados contra o que você esperava pagar, e valida o dígito verificador.
  3. 3 Cruza. Com uma referência da sua nota fiscal, cruza o CNPJ do beneficiário do boleto contra o fornecedor esperado.

As duas formas de resolver isso

Conferir a linha digitável

Aprovar de olho no boleto
olhar o valor impresso, sem decodificar
Inteligência de Boleto (nós)
decodifica os dígitos e valida contra o esperado

Boleto trocado (e-mail invadido)

Aprovar de olho no boleto
passa se o valor impresso bater
Inteligência de Boleto (nós)
no modo com a nota fiscal, cruza o beneficiário contra o fornecedor

Dígito verificador corrompido

Aprovar de olho no boleto
ninguém confere na mão
Inteligência de Boleto (nós)
valida na hora, antes do pagamento

Custo

Aprovar de olho no boleto
o tempo de quem aprova
Inteligência de Boleto (nós)
grátis e aberto

O dado é seu

O boleto fica com você.

No terminal, no Claude Code ou no Cowork, o motor lê o CSV no seu computador e o Claude só vê o resumo que ele imprime (total, contagem por veredicto), nunca o valor, o CNPJ ou a linha digitável de um boleto específico. Anexar o boleto numa conversa comum do Claude, na web ou no app, é outra coisa: aí o dado sobe para a nuvem da Anthropic. A referência de cruzamento com o fornecedor também é um CSV seu, local: o motor não consulta a Receita nem qualquer serviço externo.

O que vem

A prova que eu tenho hoje

A prova hoje é de laboratório: 72 testes automatizados contra vetores sintéticos, incluindo boleto com valor alterado, vencimento alterado e dígito verificador corrompido. O decode da linha digitável é determinístico: o dígito verificador ou fecha, ou não fecha. Já a leitura do PDF do boleto (o outro verbo do produto) foi medida separadamente pelo autor num corpus real, com cerca de 89% de cobertura de extração.

Onde isso ainda não chega.

  • Não confirma o beneficiário sozinho. A linha digitável carrega banco, valor, vencimento e dígitos verificadores, não a conta de destino: ela pega valor, vencimento e código alterados, mas não um boleto novo e válido emitido para a conta de um fraudador. O beneficiário só é conferido cruzando o CNPJ contra o fornecedor da sua nota fiscal, e mesmo assim é uma comparação local, não uma consulta à Receita.
  • Boleto de arrecadação ou tributo fica fora desta versão: o motor detecta e marca como tipo não suportado.
  • A leitura de PDF escaneado depende de OCR local (Tesseract e Poppler instalados à parte); sem eles, esse caminho é pulado sem quebrar.
  • O produto não paga nem registra nada: ele confere e alerta. A decisão de pagar continua sua.

É para você?

É para você se

  • Quem aprova o lote de contas a pagar e hoje confere o boleto só de olho no valor impresso.
  • Quem quer cruzar o beneficiário do boleto contra o fornecedor da nota fiscal antes de pagar.

Não é para você se

  • Quem paga boleto de arrecadação ou tributo (48 dígitos): fica fora desta versão.
  • Quem precisa validar a titularidade da conta de destino na Receita, não só cruzar contra a própria NF.

Antes de instalar: o que você precisa

  • Python 3.12 ou mais no computador.
  • Para usar como skill: Claude Code, ou o Cowork do Claude Desktop (plano pago). Direto no terminal funciona sem Claude nenhum.
  • Um CSV com a linha digitável e o valor esperado de cada boleto (e, para o cruzamento, um CSV com o mapa nota fiscal para fornecedor).
Na fila Grátis e aberta

Grátis e aberta quando sair da fila.

Inteligência de Boleto está na fila de abertura e vai sair grátis, com o código aberto. Avisamos você quando sair.

  • O motor em Python, com o decode da linha digitável como fonte única dos dois verbos (conferir e ler PDF).
  • O SKILL.md, para o Claude orquestrar o motor sem nunca ler o valor ou o CNPJ de um boleto na conversa.
  • Os boletos fictícios de exemplo, com o veredicto esperado de cada um.
  • Os testes, com os vetores sintéticos que eles usam.

Recebe no seu e-mail

Sem spam. Descadastro em 1 clique.

Perguntas frequentes

O boleto sai da minha máquina?

No terminal, no Claude Code ou no Cowork, não: o motor lê o CSV aí e o Claude só vê o resumo que ele imprime. Anexar o boleto numa conversa comum do Claude, na web ou no app, é diferente: o dado sobe para a nuvem da Anthropic.

Ele confirma que o dinheiro vai para o fornecedor certo?

Só de forma indireta: cruza o CNPJ do beneficiário do boleto contra o fornecedor da sua nota fiscal. Não consulta a Receita nem confirma a titularidade da conta.

Ele lê o PDF do boleto ou só a linha digitável?

Os dois: um CSV com as linhas digitáveis dá o veredicto na hora; o PDF do boleto dá todos os campos, e é nele que o cruzamento com a nota fiscal acontece.

Ele decide se eu pago ou não?

Não. Ele confere e alerta; a decisão de pagar continua sua.