Navegar na documentação
Enviar notas
Coletor de pasta
Para instalações locais (plano Empresa): o ERP grava os XMLs numa pasta e o coletor faz o resto.
Como funciona
- O ERP (ou uma rotina) copia os XMLs para
entrada/, inclusive em subpastas. - A cada 30 segundos, o coletor pega os arquivos que não mudam há alguns segundos (para não ler arquivo pela metade).
- Simula em lotes e grava o relatório em
saida/<data-hora>/. - Só depois move os XMLs para
processados/ourejeitados/, preservando as subpastas. Se a simulação falhar, nada é movido e o próximo ciclo tenta de novo.
Estrutura
dados/
dados/
├── cenario.json # o cenário usado pelo coletor
├── entrada/ # o ERP grava aqui
│ └── filial-sp/…
├── saida/
│ └── 2026-11-18T13-00-00/
│ ├── resumo.csv # carga por ano
│ ├── itens.csv # nota a nota, item a item
│ ├── rejeitados.csv
│ ├── eventos.csv # cancelamentos e cartas de correção
│ └── simulacao.json
├── processados/
└── rejeitados/Os CSVs usam ; e vírgula decimal: abrem direto no Excel em português.
Configuração
| Variável | Padrão | O que faz |
|---|---|---|
INTERVALO_SEGUNDOS | 30 | Tempo entre ciclos. |
ESTABILIDADE_SEGUNDOS | 5 | Quanto tempo o arquivo precisa ficar sem mudar. |
MODO | continuo | uma-vez processa e encerra (bom para agendador). |
SIMULADOR_API_KEY | — | Chave, quando o simulador exige autenticação. |
Os XMLs ficam só na sua infraestrutura. Nada sai da sua rede.
PróximoCenários e alíquotas