NCM Buscador
Buscar
CAMPO DO XML · NFS-e Obrigatório

chNFSe

Identificador da NFS-e à qual o evento será vinculado.

✓ Oficial · 27 de julho de 2026

Onde fica no arquivo

evento/pedRegEvento/infPedReg/chNFSe

Dentro do grupo infPedReg — Parte Geral do Pedido de Registro de Evento Grupo de informações do pedido de registro do evento

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
50
Tipo declarado
TSChaveNFSe
Formato exigido
[0-9]{6}([0-9A-Z]{14})[0-9]{30}

No schema: Identificador da NFS-e à qual o evento será vinculado O XSD declara chNFSe em 2 pontos do leiaute; esta é a declaração deste caminho.

Em qual documento este campo é declarado

  • Anexo II — eventos

Regras de validação que citam chNFSe — 8

E1831 Anexo II — eventos regra deste ponto do leiaute

A NFS-e indicada não existe no ADN NFS-e.

E0822 Anexo II — eventos regra deste ponto do leiaute

Não pode ocorrer cancelamento de NFS-e fora do prazo limite para o cancelamento da NFS-e, conforme parametrização do município emissor da NFS-e.

E0823 Anexo II — eventos regra deste ponto do leiaute

Não pode ocorrer cancelamento de NFS-e acima de valor permitido pelo município emissor da NFS-e, conforme parametrização do município emissor da NFS-e.

E0824 Anexo II — eventos regra deste ponto do leiaute

Não pode ocorrer o cancelamento de NFS-e que não esteja identificado o tomador de serviço, conforme parametrização do município emissor da NFS-e.

E0827 Anexo II — eventos regra deste ponto do leiaute

Não é permitido realizar um Evento de Cancelamento para NFS-e que possua Evento de Tributos Recolhidos vinculado, conforme parametrização do município de incidência do ISSQN da NFS-e.

E0831 Anexo II — eventos regra deste ponto do leiaute

O pedido de registro deste evento de NFS-e deve ser enviado para o ambiente que gerou a NFS-e referenciada no pedido.

E1833 Anexo II — eventos regra deste ponto do leiaute

Somente é permitido um único evento do tipo Manifestação de NFS-e (Confirmação e Rejeição), se o autor do evento, informado nos campos CNPJAutor ou CPFAutor, corresponder aos possíveis não emitentes da NFS-e indicada pela chave de acesso.

E1835 Anexo II — eventos regra deste ponto do leiaute

Somente é permitido um único evento do tipo Manifestação de NFS-e (Anulação da Rejeição) para cada Evento de Manifestação de NFS-e - Rejeição, emitido por cada um dos possíveis não emitentes da NFS-e indicada pela chave de acesso.

A mesma tag em outros pontos do XML — 1

chNFSe não é um campo só: o leiaute declara este nome em 2 caminhos diferentes, cada um com o seu grupo e o seu significado. É por isso que a regra listada pelo nome pode não ser a desta ocorrência.

NFSe/infNFSe/DPS/infDPS/valores/vDedRed/documentos/docDedRed/chNFSe

Chave de acesso da NFS-e (padrão nacional).

Campos do mesmo grupo — 22

CNPJAutor Número de inscrição federal (CNPJ) do autor do evento. CNPJ do autor do evento (parte… CPFAutor Número de inscrição federal (CPF) do autor do evento. CPF do autor do evento (parte… dhEvento Data e hora do evento no formato AAAA-MM-DDThh:mm:ssTZD (UTC - Universal Coordinated… e101101 Parte Específica do Pedido de Registro de Evento Evento Cancelamento de NFS-e e101103 Parte Específica do Pedido de Registro de Evento Solicitação de Análise Fiscal para… e105102 Parte Específica do Pedido de Registro de Evento Cancelamento de NFS-e por Substituição e105104 Parte Específica do Pedido de Registro de Evento Cancelamento de NFS-e Deferido por… e105105 Parte Específica do Pedido de Registro de Evento Cancelamento de NFS-e Indeferido por… e202201 Parte Específica do Evento Manifestação de NFS-e - Confirmação do Prestador e202205 Parte Específica do Evento Manifestação de NFS-e - Rejeição do Prestador e203202 Parte Específica do Evento Manifestação de NFS-e - Confirmação do Tomador e203206 Parte Específica do Evento Manifestação de NFS-e - Rejeição do Tomador e204203 Parte Específica do Evento Manifestação de NFS-e - Confirmação do Intermediário e204207 Parte Específica do Evento Manifestação de NFS-e - Rejeição do Intermediário e205204 Parte Específica do Evento Manifestação de NFS-e - Confirmação Tácita e205208 Parte Específica do Evento Manifestação de NFS-e - Anulação da Rejeição e305101 Parte Específica do Evento Cancelamento de NFS-e por Ofício e305102 Parte Específica do Evento Bloqueio de NFS-e por Ofício e305103 Parte Específica do Evento Desbloqueio de NFS-e por Ofício id O identificador do pedido de registro de evento é composto pela concatenação de campos… tpAmb Tipo de ambiente: 1 - Produção; 2 - Homologação; verAplic Versão do aplicativo que gerou o pedido de registro de evento.

Perguntas frequentes

O que é o campo chNFSe da NFS-e?

Identificador da NFS-e à qual o evento será vinculado. No XML ele fica em evento/pedRegEvento/infPedReg/chNFSe. É obrigatório (ocorrência 1-1) e o tamanho é 50.

Onde chNFSe entra no XML?

No caminho evento/pedRegEvento/infPedReg/chNFSe, dentro do grupo infPedReg (Parte Geral do Pedido de Registro de Evento Grupo de informações do pedido de registro do evento). O mesmo grupo tem outros 22 campos.

Quais erros chNFSe pode causar?

As regras de validação que citam este campo disparam 8 códigos: E0822, E0823, E0824, E0827, E0831, E1831, E1833, E1835. Cada um tem a regra oficial na ficha do código.