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

vISS de ISSQNtot: total do imposto e rejeição 607

<vISS>total › ISSQNtot › vISS

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/vISS registra o total de ISS dos itens da NF-e. No item, o valor correspondente chama-se vISSQN; no total, vISS. Essa mudança de nome não altera sua natureza de imposto, distinto da base e da retenção.

Localização e nomes diferentes no item

No XML processado, localize /nfeProc/NFe/infNFe/total/ISSQNtot/vISS. No documento com raiz NFe, comece em NFe/infNFe. Use o namespace da NF-e ao selecionar o caminho.

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.

W20-10 usa U04, det/imposto/ISSQN/vISSQN. ISSQNtot/vBC soma bases U02, enquanto ISSQNtot/vISSRet soma retenções U11. Não use uma busca por vISS em todos os níveis esperando encontrar a origem: a tag de item é vISSQN. Fonte: MOC 7 Anexo I — leiaute e regras de validação, p.123.

Como conferir serviços com cálculos diferentes

Some os impostos U04 já calculados por item. Hipótese sintética: um serviço tem ISS de R$ 4,00 e outro de R$ 2,00, totalizando R$ 6,00. Não é necessário nem seguro aplicar uma única alíquota à soma das bases para reproduzir esse total: os itens podem ter parâmetros diferentes.

O exemplo não define alíquota, município de incidência ou exigibilidade. Esses parâmetros devem vir da operação documentada; quando faltarem, confirme-os com os dados do serviço, data, municípios e memória de cálculo antes de apurar o item. Fonte: MOC 7 Anexo I — leiaute e regras de validação, grupos U/W20.

Por que a retenção não deve ser subtraída automaticamente

O leiaute tem uma coluna para ISS do item e outra para ISS retido. Se a soma U04 é R$ 6,00 e a soma U11 é R$ 2,00, W20 continua representando R$ 6,00 e W22f representa R$ 2,00, nas hipóteses declaradas. Escrever R$ 4,00 em vISS por subtração mudaria a correspondência de W20-10. Isso não define quem deve recolher o tributo nem qual é o valor líquido de cobrança. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W20-10 e W22f-10.

Formato e XML do total de ISS

Para o imposto total, TDec_1302Opc admite valores positivos, como 6.00, usando ponto e duas casas quando houver decimais. Não serializa 0.00, valor negativo ou texto com moeda. Preserve um zero real na memória sem substituí-lo por quantia artificial. Fonte: Tipos básicos NF-e/NFC-e.

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

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

vISS vem depois de vBC e antes de vPIS quando os campos existirem. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Como investigar a rejeição 607

A regra W20-10 compara o total com U04/vISSQN dos itens sujeitos ao ISSQN; a divergência corresponde à rejeição 607, 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. A aplicação é facultativa no MOC para 55/65. Se a divergência é na retenção, confira W22f-10/368. 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 ISS retido em vISSRet aprofunda a retenção, que permanece separada do imposto total.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ISSQNtot/vISS
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