Campos do XML da NFS-e Via: caminho, tamanho e valores

(raiz do arquivo)

4 campos

Campo	O que é	Ocorrência	Regras
evento	Schema XML dos Eventos vinculados a Nota Fiscal de Serviços Eletrônica Via - NFS-e Via	Obrigatório, uma vez	—
eventoViaProc	Schema XML da Nota Fiscal de Serviços Eletrônica Via - NFS-e Via	Obrigatório, uma vez	—
NFSeVia	Schema XML da Nota Fiscal de Serviços Eletrônica Via - NFS-e Via	Obrigatório, uma vez	—
nfseViaProc	Schema XML da Nota Fiscal de Servicos Eletronica Via - NFS-e Via	Obrigatório, uma vez	—

evento

1 campo

Campo	O que é	Ocorrência	Regras
infEventoVia	—	Obrigatório, uma vez	—

eventoViaProc

1 campo

Campo	O que é	Ocorrência	Regras
protEventoVia	—	Obrigatório, uma vez	—

NFSeVia

2 campos

Campo	O que é	Ocorrência	Regras
infNFSeVia	—	Obrigatório, uma vez	—
versao	—	Obrigatório, uma vez	—

nfseViaProc

1 campo

Campo	O que é	Ocorrência	Regras
protNFSeVia	—	Obrigatório, uma vez	—

evento/infEventoVia

6 campos

Campo	O que é	Ocorrência	Regras
dhEvento	Data e Hora, formato UTC (AAAA-MM-DDThh:mm:ssTZD, onde TZD = +hh:mm ou -hh:mm)	Obrigatório, uma vez	1193
e101101	Evento de cancelamento	Obrigatório, uma vez	—
e105102	Evento de cancelamento por substituição	Obrigatório, uma vez	—
e203202	Evento de Manifestação de Informação do Adquirente - Com Aceite	Obrigatório, uma vez	—
e203204	Evento de Manifestação de Informação do Adquirente - Com Rejeição	Obrigatório, uma vez	—
nSeqEvento	Número com 3 dígitos	Obrigatório, uma vez	1168 1191

NFSeVia/infNFSeVia

10 campos

Campo	O que é	Ocorrência	Regras
cStat	100 - NFS-e Via; 101 - NFS-e Via de Substituição; 102 - NFS-e Via de Decisão Judicial;	Obrigatório, uma vez	1147 1148
dhCompet	—	Obrigatório, uma vez	—
dhEmi	—	Obrigatório, uma vez	1105 1103 1132
fornec	—	Obrigatório, uma vez	—
id	—	Obrigatório, uma vez	1100 1117 1142 1138
serv	—	Obrigatório, uma vez	—
subst	—	Opcional, no máximo uma vez	—
tpAmb	Tipos de ambiente do Sistema Nacional NFS-e Via: 1 - Produção; 2 - Homologação;	Obrigatório, uma vez	1133
valores	—	Obrigatório, uma vez	—
verAplic	Tipo Versão da aplicação emissora NFS-e Via	Obrigatório, uma vez	—

nfseViaProc/protNFSeVia

1 campo

Campo	O que é	Ocorrência	Regras
infProt	—	Obrigatório, uma vez	—

evento/infEventoVia/e101101

1 campo

Campo	O que é	Ocorrência	Regras
xDesc	Descrição do evento: "Cancelamento de NFS-e Via".	Obrigatório, uma vez	—

evento/infEventoVia/e105102

1 campo

Campo	O que é	Ocorrência	Regras
chSubstituta	Chave de Acesso da NFS-e Via substituta.	Obrigatório, uma vez	1142

evento/infEventoVia/e203202

3 campos

Campo	O que é	Ocorrência	Regras
CNPJCPF	CNPJ ou CPF do Adquirente da NFS-e Via	Obrigatório, uma vez	1187 1188 1189 1190
tpNi	Tipo de Identificação do Adquirente: 1 - CPF; 2 - CNPJ	Obrigatório, uma vez	—
xRazaoSocial	Nome ou Razão Social do Adquirente (2 a 60 caracteres)	Obrigatório, uma vez	—

evento/infEventoVia/e203204

2 campos

Campo	O que é	Ocorrência	Regras
cCodMotivoRejeicao	Código do motivo de rejeição da NFS-e Via pelo adquirente do Serviço de Exploração de via	Obrigatório, uma vez	—
xMotivoRejeita	Motivo da Rejeição da NFS-e Via pelo adquirente do Serviço de Exploração de via (15 a 55 caracteres)	Opcional, no máximo uma vez	1186

eventoViaProc/protEventoVia/infProt

1 campo

Campo	O que é	Ocorrência	Regras
tpEventoVia	Tipos de eventos: 101101 - Cancelamento de NFS-e Via 105102 - Cancelamento para Substituição de NFS-e Via 203202 - Manifestação de Informação do…	Obrigatório, uma vez	—

NFSeVia/infNFSeVia/fornec

3 campos

Campo	O que é	Ocorrência	Regras
cMun	—	Obrigatório, uma vez	1110
CNPJ	—	Obrigatório, uma vez	1108 1171
xNome	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/serv

12 campos

Campo	O que é	Ocorrência	Regras
cLocEmi	—	Obrigatório, uma vez	1134
cLocOper	—	Obrigatório, uma vez	1109 1120 1121
cNBS	Código NBS correspondente ao serviço prestado: 106042100 (fixo)	Obrigatório, uma vez	—
cPracaEmi	—	Obrigatório, uma vez	1161 1119
cTribNac	Código de tributação nacional do ISSQN: 220101 (fixo)	Obrigatório, uma vez	—
explVia	—	Obrigatório, uma vez	—
kmPracaEmi	—	Obrigatório, uma vez	1164
nNFSeVia	Número sequencial, por praça e por equipamento, de pedágio, da NFS-e VIA gerado pelo emitente e tipo de emitente da NFS-e VIA.	Obrigatório, uma vez	—
serie	Tipo Série para cada praça ou equipamento NFS-e Via	Obrigatório, uma vez	—
xLocEmi	—	Obrigatório, uma vez	—
xLocOper	—	Obrigatório, uma vez	—
xPracaEmi	—	Obrigatório, uma vez	—

NFSeVia/infNFSeVia/subst

3 campos

Campo	O que é	Ocorrência	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) +…	Obrigatório, uma vez	1106 1107 1139 1137
cMotivo	Código de justificativa para substituição de NFS-e Via: 03 - Inclusão Retroativa de Imunidade/Isenção para NFS-e Via; 04 - Exclusão Retroativa de…	Obrigatório, uma vez	—
xMotivo	Descrição do motivo da substituição da NFS-e Via. Deve ser informada quando o motivo for 99 - Outros.	Opcional, no máximo uma vez	1172

NFSeVia/infNFSeVia/valores

4 campos

Campo	O que é	Ocorrência	Regras
modPagamento	Modalidade de pagamento: 1 - Débito 2 - Crédito 3 - Dinheiro 4 - Eletrônico 5 - Pagamento posterior 6 - Sem cobrança	Obrigatório, uma vez	—
trib	—	Obrigatório, uma vez	—
vDescCondIncond	—	Opcional, no máximo uma vez	—
vServ	—	Obrigatório, uma vez	1163

nfseViaProc/protNFSeVia/infProt

3 campos

Campo	O que é	Ocorrência	Regras
chNFSeVia	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) +…	Obrigatório, uma vez	1135 1136 1137 1146
dhRecbto	Data e Hora, formato UTC (AAAA-MM-DDThh:mm:ssTZD, onde TZD = +hh:mm ou -hh:mm)	Obrigatório, uma vez	—
nProt	—	Obrigatório, uma vez	—

NFSeVia/infNFSeVia/serv/explVia

7 campos

Campo	O que é	Ocorrência	Regras
categVeic	Categorias de veículos para cobrança: 00 - Categoria de Veículos (tipo não informado na nota de origem); 01 - Automóvel, caminhonete e furgão - (2…	Obrigatório, uma vez	—
codAcessoPed	Código de acesso gerado automaticamente pelo sistema emissor da concessionária. Identifica unicamente a NFS-e Via pelo adquirente (tomador) de…	Obrigatório, uma vez	—
codContrato	—	Obrigatório, uma vez	1111 1118
modPassagem	Modalidade Passagem 1 - Fluxo Livre; 2 - Manual; 3 - Automático; 4 - Semi-Automático; 5 - Outros	Obrigatório, uma vez	—
placa	—	Obrigatório, uma vez	—
sentido	Orientação de passagem do veículo: ângulo em graus a partir do norte geográfico em sentido horário, número inteiro de 0 a 359, onde 0º seria o norte,…	Obrigatório, uma vez	—
xInfComp	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/valores/trib

3 campos

Campo	O que é	Ocorrência	Regras
ibscbs	—	Opcional, no máximo uma vez	—
issqn	—	Obrigatório, uma vez	—
tribFed	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/valores/vDescCondIncond

2 campos

Campo	O que é	Ocorrência	Regras
vDescCond	—	Opcional, no máximo uma vez	—
vDescIncond	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/valores/trib/ibscbs

8 campos

Campo	O que é	Ocorrência	Regras
cClassTrib	Código de classificação Tributária do IBS: 000002	Obrigatório, uma vez	—
cIndOp	Código da classificação do indicador da operação: 080101	Obrigatório, uma vez	—
CST	Código de Situação Tributária do IBS: 000	Obrigatório, uma vez	—
gCBS	—	Obrigatório, uma vez	—
gIBS	—	Obrigatório, uma vez	—
vBC	—	Obrigatório, uma vez	1122 1123
vLiq	—	Obrigatório, uma vez	1125
vTotNF	—	Obrigatório, uma vez	1126

NFSeVia/infNFSeVia/valores/trib/issqn

2 campos

Campo	O que é	Ocorrência	Regras
pAliq	—	Obrigatório, uma vez	1116
vISSQN	—	Obrigatório, uma vez	1112

NFSeVia/infNFSeVia/valores/trib/tribFed

1 campo

Campo	O que é	Ocorrência	Regras
piscofins	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/valores/trib/ibscbs/gCBS

1 campo

Campo	O que é	Ocorrência	Regras
vCBS	—	Obrigatório, uma vez	1130

NFSeVia/infNFSeVia/valores/trib/ibscbs/gIBS

3 campos

Campo	O que é	Ocorrência	Regras
mun	—	Obrigatório, uma vez	—
uf	—	Obrigatório, uma vez	—
vIBSTot	—	Obrigatório, uma vez	—

NFSeVia/infNFSeVia/valores/trib/tribFed/piscofins

5 campos

Campo	O que é	Ocorrência	Regras
pAliqCofins	—	Opcional, no máximo uma vez	—
pAliqPis	—	Opcional, no máximo uma vez	—
vBCPisCofins	—	Opcional, no máximo uma vez	—
vCofins	—	Opcional, no máximo uma vez	—
vPis	—	Opcional, no máximo uma vez	—

NFSeVia/infNFSeVia/valores/trib/ibscbs/gIBS/mun

2 campos

Campo	O que é	Ocorrência	Regras
pAliqEfetMun	—	Obrigatório, uma vez	—
vIBSMun	—	Obrigatório, uma vez	1129

NFSeVia/infNFSeVia/valores/trib/ibscbs/gIBS/uf

2 campos

Campo	O que é	Ocorrência	Regras
pAliqEfetUF	—	Obrigatório, uma vez	—
vIBSUF	—	Obrigatório, uma vez	1128

Perguntas frequentes

Quantos campos tem o XML da NFS-e Via?

O esquema oficial (schemas_v1-01_atualizado (leiaute 1.01 da NFS-e Via, NT 010/SE-CGNFSe)), lido pelo Buscador NCM, declara 95 nomes de tag distintos, em 226 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 156 posições estão no documento em si; as demais são de evento, consulta e retorno do web service.

Onde fica cada tag no XML da NFS-e Via?

No caminho completo a partir do elemento raiz, reconstruído caminhando pela árvore do esquema oficial — não por tabela de manual. O Buscador NCM agrupa os campos pelo grupo em que eles ficam, na ordem em que o arquivo é montado, e a ficha de cada tag mostra todas as posições dela.

O campo da NFS-e Via é o mesmo campo da NF-e?

Não necessariamente, e essa confusão custa caro. O mesmo nome de tag existe em vários documentos fiscais com regras e sentidos diferentes: uTrib na NF-e não é o uTrib do CT-e. Cada ficha lista o mesmo nome nos outros documentos, com a redação e o caminho de cada um — justamente para que a regra de um não seja aplicada ao outro.

Todo campo que aparece no pacote de esquemas da NFS-e Via é um campo da NFS-e Via?

Não. O pacote traz um arquivo de tipos COMPARTILHADO entre os documentos fiscais, e nele viajam grupos que pertencem a outros documentos. O critério do Buscador NCM é alcance: só entra a tag que o caminho alcança a partir do elemento raiz do documento. Tag declarada no pacote e não alcançada não é campo do leiaute dele.