CAMPO DO XML · NF-E Opcional 2 posições

vServ

Valor Total dos Serviços sob não-incidência ou não tributados pelo ICMS

✓ Conferido · 02 de outubro de 2026

Onde fica no arquivo

No documento

NFe/infNFe/total/ISSQNtot/vServ

Opcional, no máximo uma vez
NFe/infNFe/transp/retTransp/vServ

Obrigatório, uma vez

Valor do Serviço

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

NFe — Nota Fiscal Eletrônica
└ infNFe — Informações da Nota Fiscal eletrônica
└ total — Dados dos totais da NF-e
└ ISSQNtot — Totais referentes ao ISSQN
└ vServ — você está aqui

Dentro do grupo ISSQNtot , totais referentes ao ISSQN

O que o arquivo aceita neste campo

Ocorrência: 0-1
Tamanho: —
Tipo no esquema: TDec_1302Opc
Formato base: string

Formato exigido: 0\.[0-9]{1}[1-9]{1}|0\.[1-9]{1}[0-9]{1}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})? 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.

O mesmo nome em outros documentos fiscais — 1

vServ aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento	O que o leiaute dele diz	Caminho lá
NFS-e Via	—	NFSeVia/infNFSeVia/valores/vServ

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 11

São os campos que ficam ao lado deste no arquivo, dentro de NFe/infNFe/total/ISSQNtot. Quem preenche um costuma precisar dos outros na mesma passada.

cRegTrib Código do regime especial de tributação dCompet Data da prestação do serviço (AAAA-MM-DD) vBC BC do ICMS vCOFINS Valor do COFINS vDeducao Valor dedução para redução da base de cálculo vDescCond Valor desconto condicionado vDescIncond Valor desconto incondicionado vISS Valor Total do ISS vISSRet Valor Total Retenção ISS vOutro Outras despesas acessórias vPIS Valor do PIS

Perguntas frequentes

O que é o campo vServ do NF-e?

Valor Total dos Serviços sob não-incidência ou não tributados pelo ICMS No XML ele fica em NFe/infNFe/total/ISSQNtot/vServ. Opcional, no máximo uma vez.

vServ aparece em quantos lugares do NF-e?

Em 2 posições do esquema oficial: NFe/infNFe/total/ISSQNtot/vServ, NFe/infNFe/transp/retTransp/vServ. 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.

vServ no NF-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 1 outro documento (NFS-e Via), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

vServ sai impresso no DANFE da NF-e?

Sim, pelo leiaute da NT 2026.010, em produção a partir de 01/12/2026: no quadro facultativo Cálculo do ISSQN. A nota técnica não cria campo no XML: ela diz onde imprimir campos que já existem.

De onde vem esta descrição do NF-e?

Do esquema XML oficial (PL_010f_v1.04). 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.