vAliq no ISSQN: alíquota percentual do serviço na NF-e
<vAliq>det › imposto › ISSQN › vAliqRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vAliq, em /nfeProc/NFe/infNFe/det/imposto/ISSQN/vAliq, informa a alíquota percentual do ISSQN do item. Apesar da letra “v” no nome, esse campo não é um valor em reais; o resultado monetário do imposto é vISSQN.
De onde vem a alíquota e o que o XML não decide
O parâmetro depende do serviço, município, regime e demais condições aplicáveis à prestação. O MOC e o XSD descrevem a representação, sem escolher uma alíquota para qualquer empresa. Confirme o parâmetro e seu fundamento com o responsável contábil, junto da base e da exigibilidade, antes da geração. Fonte: MOC 7.0 — Anexo I 7.00, novembro/2020, U03, p. 56.
Não deduza a alíquota dividindo um imposto retido pelo valor bruto quando a base ou as retenções não estão identificadas. vISSRet, vBC e vISSQN possuem funções diferentes.
Como representar percentual e conferir uma conta
O campo é obrigatório dentro de ISSQN, depois de vBC. O tipo TDec_0302a04 permite zero ou até três algarismos inteiros; havendo fração, de duas a quatro casas. O ponto é separador decimal. O tipo não é uma tabela de alíquotas legais nem um teto fiscal. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, ISSQN/vAliq, linhas 4454–4458; Tipos básicos NF-e PL_010f_v1.04, TDec_0302a04.
Fragmento parcial, com 2% assumidos apenas para demonstração matemática:
<vAliq xmlns="http://www.portalfiscal.inf.br/nfe">2.0000</vAliq>
Com base hipotética já confirmada de R$ 1.250,00, o cálculo percentual simples resulta em 1.250 × 2 ÷ 100 = R$ 25,00. O XML representa 2%, e não a fração 0,02. Serializar0.0200 representaria 0,02%, que sobre a mesma base resulta em R$ 0,25. Nenhum desses parâmetros é recomendação para a operação do leitor.
Como localizar diferença no imposto
Compare alíquota na origem, unidade usada no cálculo, conteúdo do XML, base e resultado. Sistemas que armazenam taxa como fração precisam transformar corretamente para percentual ao serializar. Se a alíquota e a base estão corretas, confira precisão e regra de arredondamento da apuração, sem arredondar parâmetros previamente para forçar coincidência.
A retenção não muda automaticamente o percentual e a ausência de rejeição de schema não comprova que a alíquota material esteja correta. Uma alteração do fundamento tributário precisa de confirmação própria; uma correção de conversão de unidade pode ser verificada pela memória de cálculo e pelo XML do mesmo item.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/ISSQN/vAliq- 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_0302a04 · 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,4}|[1-9]{1}[0-9]{0,2}(\.[0-9]{2,4})?- whiteSpace
preserve