Séries e numeração
Séries 55/65 independentes por ambiente.
A NFER gerencia automaticamente a sequência numérica e as séries fiscais de cada empresa emissora através de transações atômicas com bloqueio no banco de dados. Isso impede que emissões simultâneas ou concorrentes gerem notas com o mesmo número ou provoquem lacunas na SEFAZ.
Os contadores são totalmente isolados entre modelos (55 para NF-e, 65 para NFC-e, 57 para CT-e e 58 para MDF-e) e ambientes (Homologação e Produção). Alterar ou reiniciar uma sequência em homologação nunca afeta a numeração oficial de produção.
1. Endpoints de Numeração e Séries
Consulte o último número emitido e configure a sequência inicial para migração:
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Consultar Séries & Último Número | GET /v1/companies/:id/nfe-sequences | Ver Numerações Ativas → |
| Configurar Sequência Inicial | POST /v1/companies/:id/nfe-sequence | Ver Configuração → |
2. Migração e Definição do Último Número
Caso sua empresa já emita notas em outro software e esteja migrando para a NFER, você pode definir exatamente o último número utilizado (lastNumero). A próxima nota autorizada pela NFER receberá automaticamente o valor lastNumero + 1.
Campos da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
modelo | string | Sim | "55" (NF-e), "65" (NFC-e), "57" (CT-e) ou "58" (MDF-e Manifesto). |
serie | number | Sim | Número da série fiscal (ex.: 1). |
lastNumero | number | Sim | Último número emitido na SEFAZ. O NFER emitirá a próxima nota como lastNumero + 1. |
environment | string | Sim | "homologacao" ou "producao". |
informacoesFisco | string | Não | Texto padrão opcional gravado no campo infAdFisco de todas as notas da série. |
3. Inutilização de Números Pulados ou Quebrados
Caso ocorra quebra na sequência numérica (ex.: pulo de número por falha de transmissão do software ou cancelamento pré-emissão), a legislação tributária exige que a numeração não utilizada seja formalmente inutilizada perante a SEFAZ até o 10º dia do mês subsequente para evitar autuações fiscais.
A NFER processa a inutilização de forma síncrona diretamente nos webservices oficiais da SEFAZ para todos os documentos fiscais que possuem suporte legal:
| Documento Fiscal | Método e Rota da API | Painel Web (No-code) |
|---|---|---|
| NF-e (Modelo 55) | POST /v1/nfe/inutilizar | /dashboard/nfe/inutilizar → |
| NFC-e (Modelo 65) | POST /v1/nfe/inutilizar (modelo: "65") | /dashboard/nfe/inutilizar?modelo=65 → |
| CT-e (Modelo 57) | POST /v1/cte/inutilizar | /dashboard/nfe/inutilizar?modelo=57 → |