Documentos fiscais são identificados por série + número. A sequência precisa ser contínua dentro da mesma série e ambiente (produção vs homologação), sob pena de rejeição da SEFAZ por "número fora de sequência".
Comportamento por requisição
A escolha entre controle automático e controle manual acontece por chamada, não por configuração de empresa:
- Quando você envia
Serie,NumeroeLotena requisição, a API usa exatamente os valores enviados (controle manual). - Quando você omite os três campos, a API gerencia a numeração automaticamente — consulta o próximo número disponível para a empresa, modelo, série e ambiente, incrementa e grava o protocolo (controle automático).
Não há nada a configurar previamente. O integrador decide a cada nota.
Controle automático (padrão)
Quando Serie, Numero e Lote são omitidos, a Brasil NFe:
- Consulta o contador interno por empresa + modelo + série + ambiente.
- Incrementa automaticamente e grava o protocolo no banco.
- Garante a contiguidade da série — a validação de sequência continua sendo da SEFAZ, mas a API protege contra duplicidade local.
Controle manual
Para controlar a numeração do seu lado (ex.: migração de ERP legado, múltiplas séries gerenciadas externamente), basta enviar Serie, Numero e Lote em cada requisição.
Cuidados em controle manual:
- Nunca reaproveite números já autorizados - isso gera chave de acesso duplicada.
- Nunca pule números sem justificativa - a SEFAZ exige inutilização explícita via
/InutilizarNumeracao. - Mantenha séries distintas entre produção e homologação - mesmos números em ambientes diferentes é permitido, mas na mesma série causa duplicidade.
Inutilização de numeração
Quando um número da série nunca será usado (erro de integração, número pulado por acidente), use /InutilizarNumeracao para informar a SEFAZ que aquele intervalo foi descartado. Sem inutilização, o próximo envio na sequência é rejeitado.