Pular para o conteúdo
TRILHA TESOURARIA · ABERTA

Da nota do fornecedor à carga de contas a pagar, em minutos.

Digitar nota de entrada é o tipo de trabalho que ninguém sente falta. Você joga as NF-e e NFS-e (uma a uma ou o lote do mês, o XML ou o PDF) e a skill devolve a conferência pronta e o arquivo de carga pro seu ERP, sinalizando o que pede atenção.

Como instalar Dar uma estrela no GitHub Grátis e aberta · Apache-2.0
python scripts/ler_notas.py processar --entrada exemplo --perfil generico --out resultado-exemplo
{
  "total": 4,
  "auto_aprovadas": 4,
  "conferir": 0,
  "falhou": 0,
  "recebidas": 4,
  "fora_do_limite": 0,
  "repetidas": 0,
  "por_familia": {
    "nfe": 1,
    "nfse_abrasf": 1,
    "nfse_nacional": 1,
    "nfse_sp": 1
  }
}

carga: resultado-exemplo\carga.csv
carga (planilha): resultado-exemplo\carga.xlsx

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

405

testes automatizados verdes

18

notas reais validadas

6

padrões de NF roteados

3

destinos de carga (Omie/ContaAzul/genérico)

Nota de entrada é digitação pura: abrir o XML ou o PDF, copiar fornecedor, número, datas, valores e impostos para o ERP, uma a uma. Num mês de volume, some meia manhã só nisso, e cada campo é uma chance de errar um valor ou perder uma nota cancelada no meio do lote.

Um sistema de captura de nota em SaaS resolve, cobrando de R$ 80 a R$ 480 por mês, com o seu XML subindo para a nuvem deles.

Como funciona

  1. 1 Aponta. Você aponta as notas: XML na pasta, PDF no chat, ou um ZIP com o lote do mês.
  2. 2 Lê e extrai. O motor lê e extrai o que importa (fornecedor, número, datas, valores, impostos) e sinaliza o que pede atenção, como nota cancelada ou devolução.
  3. 3 Entrega. Sai a planilha de conferência e o arquivo de carga pro seu ERP (Omie, ContaAzul ou formato genérico).

As três formas de resolver isso

Custo

Digitação manual
sua meia manhã, todo mês
SaaS de captura
R$ 80 a R$ 480/mês
Leitor aberto (nós)
grátis e aberta

Onde o XML roda

Digitação manual
no seu PC, mas na unha
SaaS de captura
sobe pra nuvem deles
Leitor aberto (nós)
na sua máquina, no terminal e no Claude Code; no Cowork e no chat, na nuvem da Anthropic

Formatos

Digitação manual
você abre um a um
SaaS de captura
varia
Leitor aberto (nós)
NF-e e NFS-e, XML/PDF/foto/ZIP

Quem confere

Digitação manual
você, campo a campo
SaaS de captura
caixa-preta
Leitor aberto (nós)
você, com o risco já sinalizado

O dado é seu

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

No terminal, o motor lê o XML no seu computador e nada sai dele. No Claude Code, em sessão local, o motor também lê o XML no disco, e a skill foi feita para o Claude ver só o resumo que ele imprime (contagens e totais), nunca a linha da nota; 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 XML sobe para lá. O caminho por PDF ou foto já é diferente por natureza: o Claude lê o documento direto, em qualquer uma dessas plataformas, e a página avisa isso com todas as letras. Você escolhe o caminho, nota a nota.

O que vem

A prova que eu tenho hoje

Produto novo, ainda sem fila de depoimentos. O que tenho é o teste com dado real: 405 testes automatizados verdes e validação contra 18 notas reais de modelos e municípios diferentes (NFS-e Nacional, ABRASF, São Paulo, GINFES, webiss, além de NF-e de venda e industrialização). O motor roteia a família certa sozinho, sem você dizer de onde veio a nota.

Onde isso ainda não chega.

  • Não lê boleto, recibo, guia nem fatura: rejeita com aviso em vez de fingir que leu.
  • Não decide o que pagar. A skill captura e sinaliza; a decisão continua com você.

É para você?

É para você se

  • Você digita nota de entrada no ERP todo mês e quer o lote conferido sem catar campo a campo.
  • Usa o Claude Code ou o Cowork, ou roda direto no terminal, e consegue instalar Python seguindo o tutorial de instalação.
  • Quer o motor lendo o XML no seu disco, pelo terminal ou pelo Claude Code, e não um SaaS de captura.

Não é para você se

  • Precisa que ele leia boleto, recibo ou fatura. É um leitor de NOTA FISCAL (NF-e e NFS-e); o resto ele rejeita com aviso.
  • Quer que a skill decida o que pagar. A filosofia é capturar, não decidir: o valor líquido e a decisão continuam com você.

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.
  • Os XML das notas (NF-e e NFS-e) de fornecedor.

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. Você instala a skill uma vez seguindo o tutorial de instalação e depois conversa com o Claude em português.

Minhas notas vão para a nuvem?

No terminal, não. No Claude Code, em sessão local, o motor lê o XML no disco e a skill foi feita para o Claude ler só o resumo que o motor imprime (contagens e totais), 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 XML sobe. Já o caminho por PDF ou foto foge disso em qualquer plataforma: o Claude lê o documento direto. Você escolhe o caminho por nota.

Ele lê boleto, recibo ou fatura?

Não, e isso é proposital. É um leitor de NOTA FISCAL (NF-e e NFS-e). Boleto, recibo, guia e fatura ele rejeita com aviso, em vez de fingir que leu.

Ele decide o que pagar?

Não. A filosofia é capturar, não decidir: a skill extrai e sinaliza; o valor líquido e a decisão de pagamento continuam com você.

E se não funcionar para mim?

É grátis: você testa nas suas notas reais, sem custo nenhum. Se não servir, me conte, que eu ajusto.