vISSRet em ISSQNtot: total de ISS retido e rejeição 368

ISSQNtot/vISSRet é o total da retenção de ISS informada nos itens da NF-e. Ele soma det/imposto/ISSQN/vISSRet e não substitui o total do imposto vISS.

Origem da retenção e limites de interpretação

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

U11 é descrito como valor declaratório de retenção de ISS. A declaração no XML não comprova pagamento, recolhimento ou compensação. A decisão de haver retenção precisa estar sustentada pela operação, pelo serviço, pelas partes, pelo município e pela data; este campo não escolhe o responsável pelo recolhimento. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.56–59.

Como somar e comparar com o imposto

W22f-10 compara W22f com U11. Exemplo sintético: retenções já confirmadas de R$ 1,20 e R$ 0,80 resultam em R$ 2,00. Se o imposto U04 desses itens soma R$ 6,00, vISS total continua seguindo U04 e não é substituído por R$ 2,00 ou por R$ 4,00.

Outras retenções de serviços usam ISSQN/vOutro; retenções de tributos federais usam total/retTrib. Não transfira os valores desses campos para vISSRet pelo simples fato de serem retenções. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W20-10/W22c-10/W22f-10.

Representação da retenção total

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 do grupo estudado, parcial em relação à nota, com prestação hipotética em 30/09/2026:

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

vISSRet fica depois de vDescCond e antes de cRegTrib, quando esses campos existem. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Como investigar a rejeição 368

A regra W22f-10 compara o total com U11/vISSRet dos itens; a divergência corresponde à rejeição 368, 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 obrigatória no MOC, modelos 55/65. Procure retenção registrada só no total, item omitido, duplicação ou troca com o valor do imposto. Uma soma correta não comprova o dever material de reter nem o recolhimento. 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 imposto total em vISS permite conferir a diferença entre ISS apurado e retido.