Gerador de Número NF-e (sequencial)

Numero da NF-e (nNF): sequencia, serie e fluxo de emissao

O numero da NF-e (campo nNF) e o identificador sequencial humano-legivel atribuido pelo emitente a cada nota fiscal eletronica. Ele e distinto da chave de acesso de 44 digitos — o numero e curto (ate 9 digitos, faixa 1 a 999.999.999) e so e unico dentro da combinacao CNPJ emitente + modelo + serie. Dois emitentes diferentes podem ter, simultaneamente, uma nota "1234"; a chave de acesso e o que torna o registro globalmente unico.

Cada CNPJ define sua propria politica de numeracao. A maioria das empresas comeca em 1 e incrementa indefinidamente; quando uma serie se aproxima de 999.999.999, o emitente migra para uma nova serie. Alguns sistemas contabeis reiniciam a numeracao anualmente ou por filial — pratica permitida desde que a tupla (CNPJ, mod, serie, nNF) nunca se repita.

Serie e modelos de documento

A serie (serie) e a particao de 3 digitos (0 a 999) do espaco de numeracao. Convencoes:

• Serie 0 — tradicional, usada por empresas com um unico ponto de emissao.
• Series 1 a 99 — operacoes normais, geralmente por filial ou por unidade de negocio.
• Series 900 a 999 — reservadas para contingencia offline da NFC-e (tpEmis = 9). Os numeros sao 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 servicos).
• 21/22 — notas de telecomunicacao e energia eletrica.

Fluxo de emissao e situacoes

A emissao de uma NF-e envolve: (1) o emitente monta o XML com o proximo nNF na serie 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 entao ser impressas como DANFE com o codigo de barras da chave de acesso.

Situacoes possiveis para uma tupla (modelo, serie, numero):

• Autorizada (cStat 100) — XML aprovado; documento habil a circulacao.
• Cancelada (cStat 101) — cancelamento registrado em ate 24h, antes da circulacao da mercadoria.
• Inutilizada (cStat 102) — faixa de numeracao formalmente descartada para manter a sequencia auditavel.
• Denegada (cStat 110) — recusada por irregularidade fiscal do emitente ou do destinatario.
• EPEC / contingencia — emitida offline sob regras do Evento Previo de Emissao em Contingencia.

Correcao, cancelamento e inutilizacao

Apos a autorizacao, pequenos erros (descricao do produto, CFOP, informacoes adicionais) podem ser corrigidos por CC-e (Carta de Correcao Eletronica). A CC-e nao pode alterar valores, tributos, CNPJ do destinatario, CNPJ do emitente, data de emissao ou quantidades. Para erros substanciais, o emitente deve cancelar a NF-e em ate 24 horas (algumas operacoes admitem ate 7 dias para inutilizacao do numero). Apos a janela legal, o unico caminho juridico e uma operacao de devolucao pelo destinatario.

Validacao e consulta

Uma NF-e emitida nao pode ser consultada apenas pelo numero no portal publico — a chave de acesso e obrigatoria no servico NfeConsultaProtocolo da SEFAZ. O numero e util para conciliacao interna, cruzamento com ERP, contas a receber e como identificador impresso na DANFE. Bibliotecas que automatizam a emissao incluem nfephp-org (PHP), NotaFiscalNet (Java) e diversos pacotes Node que envelopam os web services SOAP da SEFAZ.

Perguntas frequentes

Posso reaproveitar um numero rejeitado pela SEFAZ? Sim. Apenas numeros autorizados ficam bloqueados. Um XML rejeitado nao consome o numero, portanto o mesmo nNF pode ser reenviado apos correcao.

Posso consultar uma NF-e apenas pelo numero? Nao — o portal publico indexa pela chave de acesso (44 digitos). ERPs internos indexam pela tupla (CNPJ, modelo, serie, numero), que identifica o documento de forma unica dentro do emitente.

O que acontece ao chegar em 999.999.999? O emitente deve migrar para a proxima serie disponivel. Pular numero nao e permitido: qualquer faixa nao usada precisa ser formalmente inutilizada via o servico Inutilizacao de Numeracao.

O numero gerado aqui vale como NF-e real? Nao. O numero sozinho nao constitui nota — um documento real e enforceable exige o XML completo, a assinatura digital e o protocolo de autorizacao da SEFAZ. Este gerador produz sequencias para testes, desenvolvimento e cenarios de integracao.

Por que algumas empresas usam varias series? Para particionar a numeracao por filial, por ponto de venda, por ambiente de emissao (homologacao versus producao) ou por modo de contingencia. Cada serie tem seu proprio contador independente.