NCM Buscador
CAMPO DO XML · NFS-E VIA Obrigatório 2 posições 6 regras

chSubstda

Chave de acesso da NFSeV. A regra de formação é: Cód.da localidade/trecho (7) + Amb.Ger. (1) + Inscrição Federal (14) + nNFS-e Via (13) + serie (3) + AnoMes Emis. da NFS-e Via (4) + Cód.Num. (7) + DV (1)

✓ Oficial · 13 de outubro de 2026 NFS-e Via: leiaute do XML e regras de negócio — NT 010/SE-CGNFSe — Adequações NFS-e Via (leiaute 1.01), 11/09/2026, aprovada pelo Ato Técnico Conjunto nº 7, de 28/09/2026 · Anexo IV v1.00.05 (leiautes e regras de negócio) e esquemas XSD 1.01 · sobre a NT 006/SE-CGNFSe, de 28/01/2026 · Comitê Gestor da NFS-e Nacional (CGNFSe) / Secretaria Executiva

Onde fica no arquivo

No documento

  • NFSeVia/infNFSeVia/subst/chSubstda

    Obrigatório, uma vez

  • nfseViaProc/NFSeVia/infNFSeVia/subst/chSubstda

    Obrigatório, uma vez

O caminho até aqui, nível a nível

  1. NFSeVia — Schema XML da Nota Fiscal de Serviços Eletrônica Via - NFS-e Via
  2. └ infNFSeVia
  3. └ subst
  4. └ chSubstda — você está aqui

Dentro do grupo subst

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
até 50
Tipo no esquema
TSChaveNFSeVia
Formato base
string

Formato exigido: [0-9]{8}[0-9A-Z]{12}[0-9]{15}[0-9A-Z]{3}[0-9]{12} Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

As regras que verificam este campo — 6

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

1106 chSubstda documento

A chave de acesso da NFS-e Substituída deve ser válida e ser formada pelo CNPJ e o Código do Trecho informados na NFS-e de Substituição.

Mensagem: Falha na composição da chave de acesso substituida.

1107 chSubstda documento

O CNPJ da concessionária informado na chave de acesso da NFS-e Substituída deve possuir um CNPJ válido.

Mensagem: Dígito verificador do CNPJ da chave de acesso substituída inválido.

1139 chSubstda documento

NFS-e Via de Substituição não pode ser recepcionada pelo Ambiente Nacional se referencia uma NFS-e inexistente. (Chave da NFS-e Via a ser substituída não encontrada).

Mensagem: Chave de acesso inexistente para substituição.

1137 chSubstda documento

NFS-e Via de Substituição não pode ser recepcionada pelo Ambiente Nacional para NFS-e Via que possui Evento de Cancelamento (Chave da NFS-e a ser substituída possui evento de cancelamento).

Mensagem: Evento de cancelamento para substituição já existente para a chave de acesso.

1170 chSubstda documento

A chave de acesso da nota substituída deve ser igual a chave de acesso informada no cancelamento por substituição (campo chNFSeVia) vinculado a essa NFS-e Via.

Mensagem: Chave de acesso informada no evento de cancelamento diferente da nota informada como substituída.

1143 chSubstda documento

A NF-S e substituta deve ter as mesmas informações nos seguintes campos em relação a substituída.

Mensagem: Campo da nota substituta é diferente da nota original. Campo código (Série/Ambiente/Praça/Techo/CNPJ/Data de Competência/Codigo de Acesso ao Pedágio) da nota substituta é diferente da nota original

Campos do mesmo grupo — 2

São os campos que ficam ao lado deste no arquivo, dentro de NFSeVia/infNFSeVia/subst. Quem preenche um costuma precisar dos outros na mesma passada.

Perguntas frequentes

O que é o campo chSubstda da NFS-e Via?

Chave de acesso da NFSeV. A regra de formação é: Cód.da localidade/trecho (7) + Amb.Ger. (1) + Inscrição Federal (14) + nNFS-e Via (13) + serie (3) + AnoMes Emis. da NFS-e Via (4) + Cód.Num. (7) + DV (1) No XML ele fica em NFSeVia/infNFSeVia/subst/chSubstda. Obrigatório, uma vez, com tamanho até 50.

chSubstda aparece em quantos lugares da NFS-e Via?

Em 2 posições do esquema oficial: NFSeVia/infNFSeVia/subst/chSubstda, nfseViaProc/NFSeVia/infNFSeVia/subst/chSubstda. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Que rejeição chSubstda pode causar na NFS-e Via?

6 regras do manual citam este campo, disparando os códigos 1106, 1107, 1139, 1137, 1170, 1143. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

De onde vem esta descrição da NFS-e Via?

Do esquema XML oficial (schemas_v1-01_atualizado (leiaute 1.01 da NFS-e Via, NT 010/SE-CGNFSe)). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo