Chave de acesso da NFS-e
A chave de acesso da NFS-e Nacional tem 50 posições. O identificador da nota dentro do arquivo tem 53 — e a diferença não é erro de contagem: são dois campos distintos, com nomes próprios no schema oficial.
Chave de acesso
50
Só dígitos e letras, sem prefixo. É o número que identifica a nota nas consultas.
Identificador no XML
53
O literal NFS seguido da chave. É o que vai no atributo do arquivo.
A regra de formação, no schema: Informar o identificador precedido do literal "NFS". A regra de formação do identificador de 53 posições da NFS-e é: "NFS" + Cód.Mun.(7) + Amb.Ger.(1) + Tipo de Inscrição Federal(1) + Inscrição Federal(14) + No.NFS-e(13) + AnoMes Emis.(4) + Cód.Num.(9) + DV(1)
Cole a chave e veja o que cada posição significa
A composição está no Guia do Emissor Público Nacional. Cole a chave de 50 posições abaixo — ou o identificador de 53, que é o literal "NFS" na frente da mesma chave — e cada campo é separado com o que ele quer dizer. Roda no seu navegador; nada é enviado.
Aceita com ou sem espaços e pontuação.
Cada identificador do sistema, e quantas posições tem
| O que identifica | Posições | Prefixo | Aceita letra |
|---|---|---|---|
| Chave de acesso da NFS-eTSChaveNFSe | 50 | — | sim, na inscrição federal |
| Identificador da NFS-e no XMLTSIdNFSe | 53 | NFS | — |
| Identificador da DPSTSIdDPS | 45 | DPS | sim, na inscrição federal |
| Identificador do eventoTSIdEvento | 62 | EVT | sim, na inscrição federal |
| Identificador do pedido de registro de eventoTSIdPedRegEvt | 59 | PRE | sim, na inscrição federal |
| Referência ao evento de origemTSIdNumEvento | 56 | — | sim, na inscrição federal |
| Chave da NF-e, dentro do schema da NFS-eTSChaveNFe | 44 | — | sim, na inscrição federal |
Contagem derivada do formato declarado no schema oficial. Quando o formato tem dois caminhos alternativos, vale um deles por vez — somar os dois infla o total.
O CNPJ alfanumérico e as duas posições que continuam numéricas
O CNPJ passou a aceitar letras, mas não em todas as posições: são 12 posições alfanuméricas seguidas de 2 dígitos verificadores que continuam numéricos. Dá para conferir isso nos CNPJs alfa já cadastrados para teste — todos têm letra nas 12 primeiras posições, e nenhum tem letra nas duas últimas.
Formato do CNPJ no documento de mercadoria
[0-9A-Z]{12}[0-9]{2}
12 posições alfanuméricas + 2 numéricas
Os dois documentos não travam a mesma coisa
Na chave de 44 dígitos, o documento de mercadoria abre 12 posições para letra — exatamente as 12 do CNPJ, deixando os verificadores numéricos. Já o schema da NFS-e abre 14. Na prática, o arquivo da NFS-e aceita uma inscrição com letra no dígito verificador, que não existe na realidade e que o outro documento recusa.
Quem escreve validação a partir de um só dos dois schemas herda a diferença. Vale conferir a inscrição pela regra do CNPJ, e não apenas pelo formato que o arquivo aceita.
Por que a resposta que se acha na internet costuma ser de outro documento
Quem procura pela chave da nota de serviço quase sempre encontra a explicação da chave de 44 dígitos, que é a do documento de mercadoria. A estrutura é parecida o bastante para parecer certa e diferente o bastante para não servir: muda o total, muda quem publica o leiaute e muda a documentação técnica que manda no assunto. O mesmo acontece com o prazo de cancelamento, que costuma vir com o número da nota de consumidor — o prazo da NFS-e é outro.
Perguntas frequentes
Quantos dígitos tem a chave de acesso da NFS-e?
A chave de acesso tem 50 posições. O que confunde é que o identificador da nota dentro do XML tem 53: ele é o literal "NFS" seguido dos mesmos 50 dígitos. O schema oficial dá nomes diferentes aos dois, e a documentação dele diz literalmente "identificador de 53 posições".
A chave da NFS-e é igual à da NF-e?
Não. A da NF-e tem 44 dígitos e a da NFS-e tem 50. São documentos de projetos diferentes, com portais e documentação separados — e boa parte da confusão vem de material que explica a estrutura de 44 dígitos respondendo a uma pergunta sobre serviço.
O que o CNPJ alfanumérico mudou na chave?
As posições da inscrição federal passaram a aceitar letra. O CNPJ alfanumérico tem 12 posições alfanuméricas e mantém os 2 dígitos verificadores numéricos — dá para conferir nos CNPJs alfa já cadastrados: todos têm letra nas 12 primeiras posições e nenhum tem letra nas duas últimas.
Como o identificador da DPS é formado?
Informar o identificador precedido do literal "DPS". A regra de formação do identificador de 45 posições da DPS é: "DPS" + Cód.Mun (7) + Tipo de Inscrição Federal (1) + Inscrição Federal (14 - CPF completar com 000 à esquerda) + Série DPS (5)+ Núm. DPS (15)
Por que o identificador da DPS começa com 1 ou 2 depois do código do município?
Porque esse dígito declara o tipo de inscrição federal do emitente: 1 para CPF e 2 para CNPJ. E só o ramo do CNPJ aceita letra — no ramo do CPF as 14 posições continuam numéricas. Até a versão anterior do schema essa regra existia só no texto da documentação; agora ela está escrita no próprio formato exigido.