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

chSubstituta

Chave de Acesso da NFS-e Via substituta.

✓ 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

Nos eventos

  • evento/infEventoVia/e105102/chSubstituta

    Obrigatório, uma vez

  • eventoViaProc/evento/infEventoVia/e105102/chSubstituta

    Obrigatório, uma vez

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

  1. evento — Schema XML dos Eventos vinculados a Nota Fiscal de Serviços Eletrônica Via - NFS-e Via
  2. └ infEventoVia
  3. └ e105102 — Evento de cancelamento por substituição
  4. └ chSubstituta — você está aqui

Dentro do grupo e105102 , evento de cancelamento por substituição

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 — 1

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.

1142 chSubstituta evento

A chave de acesso da NFS-e Via Substituta informada no Cancelamento por Substituição deve ser igual a chave da NFS-e Via de substituição vinculada.

Mensagem: Chave de acesso da NFS-e Via Substituta informada no cancelamento por substituição é diferente da chave de acesso da NFS-e Via substituta vinculada.

Campos do mesmo grupo — 3

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

Perguntas frequentes

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

Chave de Acesso da NFS-e Via substituta. No XML ele fica em evento/infEventoVia/e105102/chSubstituta. Obrigatório, uma vez, com tamanho até 50.

chSubstituta aparece em quantos lugares da NFS-e Via?

Em 2 posições do esquema oficial: evento/infEventoVia/e105102/chSubstituta, eventoViaProc/evento/infEventoVia/e105102/chSubstituta. 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 chSubstituta pode causar na NFS-e Via?

1 regra do manual cita este campo, disparando o código 1142. ⚠ 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