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

vOutro de ISSQNtot: outras retenções, não despesas acessórias

<vOutro>total › ISSQNtot › vOutro

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/vOutro totaliza outras retenções dos itens de ISSQN. É valor declaratório. Neste caminho, vOutro não significa despesas acessórias nem qualquer outro valor que aumente o preço do serviço.

Qual ancestral muda o significado de vOutro

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

A origem é U08, det/imposto/ISSQN/vOutro. Já ICMSTot/vOutro soma despesas acessórias de det/prod/vOutro, I17a. Os dois campos podem existir no arquivo com o mesmo nome local e valores diferentes. Um relatório deve exibir a coluna ou o ancestral para que o leitor saiba qual está conferindo. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.56, 59, 121 e 123.

Como conferir outras retenções sem agregar conceitos

W22c-10 compara W22c com a soma U08. Hipótese sintética: outras retenções documentalmente confirmadas de R$ 9,00 e R$ 6,00 geram R$ 15,00. Se houver ISS retido de R$ 2,00, ele permanece em U11/W22f, sem elevar vOutro a R$ 17,00. O exemplo não decide quais retenções são devidas ou como se classificam.

Para definir o conteúdo material de outras retenções, reúna a identificação de cada retenção, seus documentos, serviço e data. O XSD não enumera a natureza dessas retenções nem substitui sua confirmação; não use o campo como depósito de diferenças de cálculo. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W22c-10.

Formato e exemplo contextual

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 de ISSQNtot, parcial em relação à nota, com prestação sintética em 30/09/2026:

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

A sequência coloca vOutro depois de vDeducao e antes de vDescIncond. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Rejeição 365: conferência do caminho U08

A regra W22c-10 compara o total com U08/ISSQN/vOutro dos itens; a divergência corresponde à rejeição 365, 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 é obrigatória no MOC para 55/65. A rejeição 604 pertence às despesas acessórias I17a/W15, não a este total. 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.

A despesa acessória ICMSTot/vOutro é o homônimo com significado e soma diferentes.

Referência técnica para integração

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