Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · IPI, II e ISSQN

vISSQN na NF-e: valor do ISS por item e conferência

<vISSQN>det › imposto › ISSQN › vISSQN

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

vISSQN, U04, é o valor do ISSQN do item da NF-e. Ele vem depois da base vBC e da alíquota vAliq no grupo ISSQN. É diferente do imposto retido, informado em vISSRet, e do valor total de ISS da nota.

O caminho desta página é /nfeProc/NFe/infNFe/det/imposto/ISSQN/vISSQN.

Quando o item tem ISSQN

O grupo ISSQN representa o item de serviço na NF-e conjugada. A U01-20/592 verifica nota com ISSQN sem item ICMS, com aplicação facultativa e exceção a critério da UF para nota só de ISSQN. A U01-10/530 verifica IM do emitente ausente. Essas regras da NF-e não são o contrato de NFS-e nacional. MOC, pp. 56–57 e 119.

No grupo presente, vBC, vAliq e vISSQN são estruturalmente obrigatórios, uma ocorrência de cada. Isso não torna o tributo devido em qualquer situação: a exigibilidade é uma informação separada, indISS, e precisa corresponder ao tratamento documentado. MOC, pp. 56–57.

Como conferir a relação entre base, alíquota e valor

Com base e alíquota previamente definidas para um cenário proporcional, a conferência aritmética é base × alíquota ÷ 100. Exemplo sintético: base de R$ 800,00 e alíquota assumida de 2,5% resultam em R$ 20,00. Esses números apenas demonstram a leitura dos campos; não recomendam alíquota, incidência ou base para o seu serviço. Deduções e descontos devem ter sido tratados na memória da base antes dessa conta, quando aplicáveis. O MOC identifica U02/U03/U04, mas não estabelece nessa seção uma tolerância universal para validar U04. MOC, pp. 56–57.

Fragmento de leitura e precisão

Recorte isolado do valor do imposto, com base hipotética de 800 e alíquota hipotética de 2,5%; não é um grupo ISSQN completo:

<vISSQN xmlns="http://www.portalfiscal.inf.br/nfe">20.00</vISSQN>

vISSQN usa TDec_1302: aceita zero e valores não negativos com até 13 dígitos inteiros; quando há fração, duas casas. vAliq é percentual, enquanto vISSQN é moeda. Use ponto no XML e preserve precisão do cálculo antes de representar os centavos. XML válido não comprova a correção fiscal da base. XSD PL010f.

Imposto calculado, retido e total da nota

vISSRet identifica retenção de ISS; não é instrução para zerar vISSQN nem para subtrair o retido do imposto calculado dentro de U04. O total do imposto vai em total/ISSQNtot/vISS, W20, com nome diferente. W20-10, facultativa no MOC, compara esse total com os itens e associa a divergência à rejeição 607. W19-10 compara o total da base (606), e W18-10, o total dos serviços (605). MOC, pp. 59 e 123.

Como investigar uma diferença

Reúna os valores por item: preço, base, deduções/descontos, alíquota, exigibilidade, imposto e retenção. Confira se o sistema somou vISSQN dos itens de ISS no total correto, sem misturar ICMS ou somente a parcela retida. Diferença de soma é diagnóstico técnico; definição de base, alíquota, retenção e exigibilidade exige os documentos da prestação e validação do responsável contábil.

Campos relacionados

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/imposto/ISSQN/vISSQN
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
TDec_1302 · 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\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve