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.
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 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 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 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
- O programa em Python, com quatro dependências para instalar.
- Os comandos configurar, baixar e agendar.
- A pasta organizada: XML por mês, base SQLite e notas.csv, que abre direto na planilha.
- Os testes, que usam só dado sintético.
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.
- Requisitos. Windows, macOS ou Linux, Python 3.12 e o certificado A1 e-CNPJ da empresa.
- Baixe o programa. Pegue o zip da última versão e extraia numa pasta.
- Instale as dependências. No terminal, dentro da pasta, crie um ambiente Python e instale:
py -3.12 -m venv .venve 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 .venve.venv/bin/pip. - 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:\Notastraz o histórico. No macOS e no Linux, use.venv/bin/pythonno lugar de.venv\Scripts\pythone uma pasta como~/Notas. - 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:00mostra 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.