Gerador de Número NF-e (sequencial)

Número da NF-e (nNF): sequência, série e fluxo de emissão

O número da NF-e (campo nNF) e o identificador sequencial humano-legível atribuído pelo emitente a cada nota fiscal eletrônica. Ele e distinto da chave de acesso de 44 dígitos — o número e curto (até 9 dígitos, faixa 1 a 999.999.999) e so e único dentro da combinação CNPJ emitente + modelo + série. Dois emitentes diferentes podem ter, simultaneamente, uma nota "1234"; a chave de acesso e o que torna o registro globalmente único.

Cada CNPJ define sua própria política de numeração. A maioria das empresas começa em 1 e incrementa indefinidamente; quando uma série se aproxima de 999.999.999, o emitente migra para uma nova série. Alguns sistemas contabeis reiniciam a numeração anualmente ou por filial — pratica permitida desde que a tupla (CNPJ, mod, serie, nNF) nunca se repita.

Série e modelos de documento

A série (serie) e a particao de 3 dígitos (0 a 999) do espaço de numeração. Convenções:

• Série 0 — tradicional, usada por empresas com um único ponto de emissão.
• Séries 1 a 99 — operações normais, geralmente por filial ou por unidade de negócio.
• Séries 900 a 999 — reservadas para contingencia offline da NFC-e (tpEmis = 9). Os números são pre-alocados e usados quando o link com a SEFAZ esta indisponivel.

Os modelos direcionam fluxos fiscais distintos:

• 55 — NF-e (nota geral, B2B).
• 65 — NFC-e (consumidor final).
• 57 — CT-e (transporte).
• 58 — MDF-e (manifesto eletronico).
• 67 — CT-e OS (transporte de outros serviços).
• 21/22 — notas de telecomunicacao e energia elétrica.

Fluxo de emissão e situações

A emissão de uma NF-e envolve: (1) o emitente monta o XML com o próximo nNF na série escolhida, (2) assina com certificado ICP-Brasil A1 ou A3, (3) envia ao web service da SEFAZ-UF correspondente, (4) recebe protocolo de autorizacao ou motivo de rejeicao. Notas autorizadas podem então ser impressas como DANFE com o código de barras da chave de acesso.

Situações possíveis para uma tupla (modelo, série, número):

• Autorizada (cStat 100) — XML aprovado; documento habil a circulação.
• Cancelada (cStat 101) — cancelamento registrado em até 24h, antes da circulação da mercadoria.
• Inutilizada (cStat 102) — faixa de numeração formalmente descartada para manter a sequência auditavel.
• Denegada (cStat 110) — recusada por irregularidade fiscal do emitente ou do destinatário.
• EPEC / contingencia — emitida offline sob regras do Evento Previo de Emissão em Contingencia.

Correção, cancelamento e inutilizacao

Após a autorizacao, pequenos erros (descrição do produto, CFOP, informações adicionais) podem ser corrigidos por CC-e (Carta de Correção Eletrônica). A CC-e não pode alterar valores, tributos, CNPJ do destinatário, CNPJ do emitente, data de emissão ou quantidades. Para erros substanciais, o emitente deve cancelar a NF-e em até 24 horas (algumas operações admitem até 7 dias para inutilizacao do número). Após a janela legal, o único caminho jurídico e uma operação de devolucao pelo destinatário.

Validação e consulta

Uma NF-e emitida não pode ser consultada apenas pelo número no portal público — a chave de acesso e obrigatória no serviço NfeConsultaProtocolo da SEFAZ. O número e útil para conciliacao interna, cruzamento com ERP, contas a receber e como identificador impresso na DANFE. Bibliotecas que automatizam a emissão incluem nfephp-org (PHP), NotaFiscalNet (Java) e diversos pacotes Node que envelopam os web services SOAP da SEFAZ.

Perguntas frequentes

Posso reaproveitar um número rejeitado pela SEFAZ? Sim. Apenas números autorizados ficam bloqueados. Um XML rejeitado não consome o número, portanto o mesmo nNF pode ser reenviado após correção.

Posso consultar uma NF-e apenas pelo número? Não — o portal público indexa pela chave de acesso (44 dígitos). ERPs internos indexam pela tupla (CNPJ, modelo, série, número), que identifica o documento de forma única dentro do emitente.

O que acontece ao chegar em 999.999.999? O emitente deve migrar para a próxima série disponível. Pular número não e permitido: qualquer faixa não usada precisa ser formalmente inutilizada via o serviço Inutilizacao de Numeração.

O número gerado aqui vale como NF-e real? Não. O número sozinho não constitui nota — um documento real e enforceable exige o XML completo, a assinatura digital e o protocolo de autorizacao da SEFAZ. Este gerador produz sequências para testes, desenvolvimento e cenários de integracao.

Por que algumas empresas usam várias séries? Para particionar a numeração por filial, por ponto de venda, por ambiente de emissão (homologação versus produção) ou por modo de contingencia. Cada série tem seu próprio contador independente.