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

  1. O ERP (ou uma rotina) copia os XMLs para entrada/, inclusive em subpastas.
  2. A cada 30 segundos, o coletor pega os arquivos que não mudam há alguns segundos (para não ler arquivo pela metade).
  3. Simula em lotes e grava o relatório em saida/<data-hora>/.
  4. Só depois move os XMLs para processados/ ou rejeitados/, 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.

O coletor não guarda histórico. Um cancelamento só tira a nota dos totais se o evento chegar no mesmo ciclo que ela; se chegar depois, aparece em eventos.csv daquele ciclo. Na plataforma (upload, API e webhook) o cancelamento vale a qualquer tempo.

Configuração

VariávelPadrãoO que faz
INTERVALO_SEGUNDOS30Tempo entre ciclos.
ESTABILIDADE_SEGUNDOS5Quanto tempo o arquivo precisa ficar sem mudar.
MODOcontinuouma-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