Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Totais

vServ de ISSQNtot: total dos serviços e rejeição 605

<vServ>total › ISSQNtot › vServ

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

ISSQNtot/vServ é o valor total dos serviços sob não incidência ou não tributados pelo ICMS, conforme a descrição do MOC. A comparação W18-10 soma prod/vProd dos itens sujeitos ao ISSQN. O campo não é a base de cálculo do ISS nem o valor do imposto.

Qual valor de item origina vServ

XPath completo: /nfeProc/NFe/infNFe/total/ISSQNtot/vServ. Se o arquivo contém apenas a raiz NFe, retire /nfeProc do início. Em consultas XPath, associe um prefixo, por exemplo n, ao namespace http://www.portalfiscal.inf.br/nfe e use esse prefixo em cada elemento. Buscar apenas pelo nome da última tag pode misturar item e total ou grupos tributários diferentes.

Este é um campo da NF-e/NFC-e, no namespace da NF-e; não é uma tag de DPS ou NFS-e municipal/nacional. A existência do grupo no schema não comprova habilitação para emitir documento conjugado nem define o tratamento do serviço. Fonte: Schemas XML NF-e/NFC-e PL 010f e MOC 7 Anexo I — leiaute e regras de validação.

A origem I11 fica em det/prod/vProd, e não dentro de det/imposto/ISSQN. A existência do grupo ISSQN identifica o recorte de serviços para a comparação W18-10. ISSQNtot/vBC usa U02, enquanto ISSQNtot/vISS usa U04; três totais com funções distintas. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.59 e 123.

Como conferir vServ e diferenças para vProd total

Hipótese sintética: dois itens sujeitos ao ISSQN têm prod/vProd de R$ 100,00 e R$ 50,00, produzindo vServ=150.00. Se suas bases U02 já confirmadas somam R$ 130,00, isso não reduz vServ para R$ 130,00. Um item com ICMS de R$ 80,00 pertence ao recorte específico de ICMSTot/vProd, não ao somatório de serviços W18.

W07-10 possui condição expressa indTot=1; W18-10 descreve o somatório dos valores dos itens sujeitos ao ISSQN. Não transplante automaticamente o filtro de uma regra para outra. A classificação dos itens deve ser verdadeira e documentada, sem mudar tributo ou indicador para fazer o total fechar. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.121 e 123.

XML e relação com o valor total da nota

No PL 010f v1.04, o tipo TDec_1302Opc usa ponto como separador, sem R$, vírgula, espaço, sinal ou separador de milhar. Para valores com parte decimal, use duas casas, como 12.50. O padrão não aceita 0 ou 0.00: a ausência de uma tag opcional e o valor zero são estados diferentes. Preserve o zero conhecido na origem; a serialização deve seguir o tipo, sem inventar um valor positivo ou substituir informação desconhecida por zero. Fonte: Tipos básicos NF-e/NFC-e.

Fragmento completo de ISSQNtot, parcial em relação à nota, com prestação assumida em 30/09/2026:

<ISSQNtot xmlns="http://www.portalfiscal.inf.br/nfe">
  <vServ>150.00</vServ>
  <dCompet>2026-09-30</dCompet>
</ISSQNtot>

vServ é o primeiro filho de ISSQNtot. W16-10 inclui vServ em sua composição documentada, com condições e exceções próprias; não duplique o mesmo valor de serviço em vProd de outro recorte apenas para igualar o total comercial. Fontes: Schemas XML NF-e/NFC-e PL 010f; MOC 7 Anexo I — leiaute e regras de validação, p.122.

Como investigar a rejeição 605

A regra W18-10 compara o total com I11/prod/vProd dos itens sujeitos ao ISSQN; a divergência corresponde à rejeição 605, nas condições documentadas. Leia o código e a mensagem do retorno real antes de atribuir a causa. Liste os itens participantes, preserve os valores efetivamente serializados e some-os com aritmética decimal. Compare esse resultado com a tag de total, procurando item omitido, soma duplicada, ancestral errado ou alteração posterior ao cálculo.

Corrija a origem comprovada do erro no cálculo ou no mapeamento; depois gere uma nova prévia e valide novamente o campo, os itens e o XSD aplicável. Não edite XML já assinado ou autorizado para acertar a soma. Aplicação facultativa no MOC para 55/65. Procure uso da base no lugar do valor do serviço, inclusão de mercadorias ou item de serviço não contado. A aceitação pelo XSD demonstra estrutura, não autorização nem tratamento fiscal correto. Fonte: MOC 7 Anexo I — leiaute e regras de validação.

O vProd de ICMSTot aprofunda o recorte de produtos e a condição expressa indTot=1.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ISSQNtot/vServ
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
TDec_1302Opc · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
0\.[0-9]{1}[1-9]{1}|0\.[1-9]{1}[0-9]{1}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve