ISSQNtot na NF-e: campos, somas e diferenças para NFS-e

ISSQNtot reúne os totais relativos ao ISSQN na NF-e. Ele fica em infNFe/total, ao lado de ICMSTot. Não é uma NFS-e nem substitui o leiaute municipal ou nacional de serviços; sua origem está nos itens da própria nota.

Nesta página:

• Quando o grupo pertence ao contexto da nota
• Quais campos formam ISSQNtot
• Como conferir os somatórios e identificar a rejeição
• Exemplo de um grupo completo dentro da nota
• Ausência, zero e formato dos valores
• Como evitar as confusões mais comuns
• Como corrigir uma divergência comprovada

Quando o grupo pertence ao contexto da nota

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

O MOC descreve o grupo ISSQN dos itens para a NF-e conjugada. No item, ISSQN é mutuamente exclusivo com ICMS e II, enquanto uma nota pode conter itens de contextos diferentes. A regra U01-10/530 trata da inscrição municipal quando há tributação de ISSQN; U01-20/592 verifica a ausência de item sujeito ao ICMS, com exceção de autorização a critério da UF para NF-e somente com itens de ISSQN. Essas condições devem ser confirmadas antes de assumir que a presença de ISSQNtot autoriza uma emissão. O MOC relaciona regras a 55/65; isso não torna qualquer serviço permitido em qualquer modelo. Fonte: MOC 7 Anexo I — leiaute e regras de validação, grupos M/U, p.119.

Quais campos formam ISSQNtot

A ordem abaixo é a sequência do XSD. O grupo é opcional; se existir, dCompet é obrigatório, e os demais filhos são opcionais.

O código usa 1=Microempresa Municipal; 2=Estimativa; 3=Sociedade de Profissionais; 4=Cooperativa; 5=Microempresário Individual (MEI); 6=Microempresário e Empresa de Pequeno Porte. Essa enumeração não escolhe o enquadramento do prestador. Fontes: MOC 7 Anexo I — leiaute e regras de validação, p.59; Schemas XML NF-e/NFC-e PL 010f.

Como conferir os somatórios e identificar a rejeição

As comparações são documentadas para 55/65. Faça uma tabela por item com o grupo ISSQN e os valores de cada coluna; some cada conceito separadamente. Não recalcule o imposto total aplicando uma alíquota única à base agregada, pois os itens podem ter parâmetros diferentes. Fonte: MOC 7 Anexo I — leiaute e regras de validação, p.123.

Exemplo de um grupo completo dentro da nota

Hipótese sintética: dois serviços têm valores de R$ 100,00 e R$ 50,00, bases já confirmadas de R$ 80,00 e R$ 50,00, e ISS apurado de R$ 4,00 e R$ 2,00. As somas são R$ 150,00, R$ 130,00 e R$ 6,00. A data documentada da prestação é 30/09/2026. O exemplo não define incidência ou alíquota.

Fragmento completo de ISSQNtot, parcial em relação à nota:

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

A ausência dos demais filhos significa que eles não foram representados neste cenário. Não significa que todo serviço dispense PIS/COFINS, retenções ou códigos. A nota completa precisa dos demais grupos e da validação aplicável. Fonte estrutural: Schemas XML NF-e/NFC-e PL 010f.

Ausência, zero e formato dos valores

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.

Isso vale para os valores monetários de ISSQNtot, mas não autoriza apagar zeros explícitos da memória de cálculo. dCompet é data obrigatória dentro do grupo; cRegTrib é um código opcional, sem código zero ou rótulo livre.

Como evitar as confusões mais comuns

vISS totaliza o imposto; vISSRet totaliza o imposto retido. Não subtraia automaticamente a retenção de vISS nem transfira uma para a outra. ISSQNtot/vOutro é outras retenções; ICMSTot/vOutro é despesas acessórias. ISSQNtot/vPIS e vCOFINS usam o recorte de serviços, enquanto os campos de ICMSTot usam o recorte de ICMS.

A base de ISS não é determinada universalmente por vServ-vDeducao-vDescIncond: o XML registra conceitos, mas a definição material da base depende da operação. Confirme documentos, município, data, serviço, deduções, descontos, exigibilidade e retenções antes de calcular. A integração então confere cada total por seu caminho. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.56–59 e 123.

Como corrigir uma divergência comprovada

Primeiro diferencie erro de schema, rejeição de soma e dúvida de enquadramento. Para schema, examine sequência, dCompet, tipo positivo dos valores e código permitido. Para soma, compare o total apenas com os itens participantes da regra indicada. Para enquadramento, identifique o parâmetro faltante e a documentação que o define; não altere códigos ou valores verdadeiros para forçar aceitação. Refaça a prévia e a validação após corrigir a origem. XML estruturalmente válido e HTTP bem-sucedido não comprovam autorização; preserve o documento assinado e o retorno oficial.

A data de prestação dCompet aprofunda o filho obrigatório do grupo e sua diferença para a emissão.