vServ de ISSQNtot: total dos serviços e rejeição 605
<vServ>total › ISSQNtot › vServRevisã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