Pular para o conteúdo
TRILHA TESOURARIA · ABERTA

As notas de serviço da sua empresa, baixadas todo dia para uma pasta sua.

Emitir e receber NFS-e gera um fluxo de notas que alguém precisa baixar, nomear e guardar. O Capturador busca todo dia, no Ambiente de Dados Nacional, as notas que a empresa emitiu e recebeu, e deixa na sua pasta o XML de cada uma por mês, uma base e um CSV pronto para a planilha.

Como instalar Dar uma estrela no GitHub Grátis e aberta · Apache-2.0
python capturador.py baixar --pasta C:\Notas
empresa **********0181: notas novas 32, repetidas 0 (emitidas 12, recebidas 20, intermediario 0, outro 0); eventos 0; outros 0; pendentes novas 0, resolvidas 0, total 0; paginas 1; parada fim
notas.csv: 32 linha(s)

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

76

testes automatizados no motor

4

dependências para instalar

3

comandos: configurar, baixar e agendar

A nota de serviço chega de vários lados: a que você emitiu, a que o fornecedor emitiu para você, a que o contador pede no fechamento. Baixar uma por uma no portal é trabalho de fim de mês, e é o tipo de trabalho que atrasa quando o mês aperta.

Sem as notas organizadas, a tesouraria não confere o que vai pagar, o contas a pagar não acha o XML e o fechamento espera alguém caçar o que faltou.

Como funciona

  1. 1 Conecta. Usa o certificado A1 e-CNPJ da empresa para falar com o Ambiente de Dados Nacional. A senha do certificado fica no cofre do sistema, nunca em arquivo.
  2. 2 Baixa. Traz as notas emitidas e as recebidas, página por página. A 1ª rodada busca o histórico; as seguintes, só o que é novo. Dia perdido não perde nota: a rodada seguinte continua de onde parou.
  3. 3 Organiza. Grava o XML de cada nota na pasta do mês de emissão, mantém uma base SQLite e gera o notas.csv. O item que não deu para ler vai para pendentes e é reprocessado na rodada seguinte.

As duas formas de resolver isso

Quem baixa

Baixar à mão, nota a nota
uma pessoa, quando lembra
Capturador de Notas (nós)
o agendador do computador, todo dia

Emitidas e recebidas

Baixar à mão, nota a nota
uma de cada vez
Capturador de Notas (nós)
as duas, na mesma rodada

O que você guarda

Baixar à mão, nota a nota
XML solto, cada um com o seu nome
Capturador de Notas (nós)
XML por mês, base SQLite e CSV para a planilha

Custo

Baixar à mão, nota a nota
o tempo de quem baixa
Capturador de Notas (nós)
grátis e aberto

O dado é seu

As notas ficam com você.

O programa só fala com o Ambiente de Dados Nacional, usando o certificado da sua empresa. Nada vai para a Finance AI Lab nem para IA, e a senha fica no cofre do sistema. A tela e o log mostram só contagens e o CNPJ mascarado, nunca o texto de uma nota.

O que vem

A prova que eu tenho hoje

A prova hoje é de laboratório: 76 testes automatizados contra notas sintéticas e um ADN simulado, sem nota real nem rede nos testes. Ainda não tenho relato de uso por outra empresa.

Onde isso ainda não chega.

  • Só NFS-e do padrão nacional e só certificado A1 e-CNPJ. NF-e de produto, CT-e, e-CPF, procurador e certificado A3 (token) ficam para depois.
  • Município que não manda a nota para o ADN não aparece aqui.
  • O ADN limita o ritmo das consultas: uma empresa com muito histórico pode precisar de mais de uma rodada na primeira vez.
  • Evento num formato que o programa ainda não conhece fica em pendentes, sem perda, até uma versão que o leia.
  • Baixa e organiza; a conferência fiscal e contábil continua sendo sua ou do contador responsável.

É para você?

É para você se

  • Quem cuida da tesouraria ou do contas a pagar e precisa das notas recebidas em ordem.
  • Quem faz a contabilidade de PMEs e quer o XML de cada cliente sem baixar um a um.
  • Quem emite NFS-e e quer a cópia de todas elas numa pasta que é sua.

Não é para você se

  • Quem precisa de NF-e de produto, que é outro sistema.
  • Quem só tem certificado A3 (token) ou e-CPF, por enquanto.
  • Quem tem notas de um município que ainda não envia ao ADN.

Antes de instalar: o que você precisa

  • Windows, macOS ou Linux, com Python 3.12 ou mais novo.
  • O certificado digital A1 e-CNPJ da empresa (o arquivo .pfx) e a senha dele.
  • Uma pasta para as notas, fora de qualquer repositório git: o programa recusa pasta dentro de um.
  • O computador ligado na hora da tarefa diária. Dia perdido não perde nota.

Como instalar

É um programa que roda no seu computador, sem IA no meio. Cinco passos.

  1. Requisitos. Windows, macOS ou Linux, Python 3.12 e o certificado A1 e-CNPJ da empresa.
  2. Baixe o programa. Pegue o zip da última versão e extraia numa pasta.
  3. Instale as dependências. No terminal, dentro da pasta, crie um ambiente Python e instale: py -3.12 -m venv .venv e depois .venv\Scripts\pip install "pydantic>=2.6" "defusedxml>=0.7.1" "cryptography>=42" "keyring>=25". No macOS e no Linux, python3.12 -m venv .venv e .venv/bin/pip.
  4. Configure e baixe. Rode .venv\Scripts\python capturador.py configurar --pasta C:\Notas; o programa pede o CNPJ, o caminho do certificado e a senha, que vai para o cofre do sistema. Depois, .venv\Scripts\python capturador.py baixar --pasta C:\Notas traz o histórico. No macOS e no Linux, use .venv/bin/python no lugar de .venv\Scripts\python e uma pasta como ~/Notas.
  5. Agende. Rode .venv\Scripts\python capturador.py agendar --pasta C:\Notas --hora 09:00. No Windows ele cria a tarefa diária, que só roda com o computador ligado; no macOS e no Linux, .venv/bin/python capturador.py agendar --pasta ~/Notas --hora 09:00 mostra a linha para o crontab.

O programa só fala com o Ambiente de Dados Nacional, usando o seu certificado. Nada vai para a Finance AI Lab nem para IA, e a senha fica no cofre do sistema.

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

As notas saem do meu computador?

Não. O programa só fala com o Ambiente de Dados Nacional, usando o certificado da sua empresa. Nada vai para a Finance AI Lab nem para IA, e a senha fica no cofre do sistema.

Pega nota emitida e recebida?

As duas, desde que estejam no padrão nacional e no ADN. Nota de município que não envia ao ADN não aparece.

Serve para NF-e de produto?

Não. É só NFS-e, a nota de serviço do padrão nacional. NF-e de produto, CT-e e certificado A3 ficam para depois.

O que acontece se um dia o computador estiver desligado?

A tarefa daquele dia não roda, mas nada se perde: a rodada seguinte continua do último ponto e traz o que faltou.