NCM Buscador
CAMPO DO XML · NF3E Grupo 2 posições

vRetTribTot

Total da retenção de tributos federais

✓ Conferido · 12 de outubro de 2026 NF3e (modelo 66): leiaute do XML e regras de validação — MOC NF3e — Anexo I: Leiaute e Regras de Validação, versão 1.00a · Portal Nacional dos DF-e / SVRS

Onde fica no arquivo

No documento

  • NF3e/infNF3e/total/vRetTribTot

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/total/vRetTribTot

    Obrigatório, uma vez

O caminho até aqui, nível a nível

  1. NF3e — Nota Fiscal Eletrônica de Energia Elétrica
  2. └ infNF3e — Informações da NF3e
  3. └ total — Dados dos totais da NF3e
  4. └ vRetTribTot — você está aqui

Dentro do grupo total , dados dos totais da NF3e

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
grupo
Formato base
grupo

O mesmo nome em outros documentos fiscais — 3

vRetTribTot aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
NFAg Total da retenção de tributos federais NFAg/infNFAg/total/vRetTribTot
NFCom Total da retenção de tributos federais NFCom/infNFCom/total/vRetTribTot
NFGas Total da retenção de tributos federais NFGas/infNFGas/total/vRetTribTot

Os campos dos doze documentos fiscais, com filtro →

O que vai dentro deste grupo — 4

vRetTribTot é um grupo: ele não carrega valor próprio, agrupa os campos abaixo. A obrigatoriedade de cada um vale dentro do grupo — campo obrigatório num grupo opcional só é exigido quando o grupo é informado.

Campo O que é Ocorrência
vIRRF Valor do IRRF retido Obrigatório, uma vez
vRetCofins Valor do COFNS retido Obrigatório, uma vez
vRetCSLL Valor da CSLL retida Obrigatório, uma vez
vRetPIS Valor do PIS retido Obrigatório, uma vez

Campos do mesmo grupo — 10

São os campos que ficam ao lado deste no arquivo, dentro de NF3e/infNF3e/total. Quem preenche um costuma precisar dos outros na mesma passada.

Perguntas frequentes

O que é o campo vRetTribTot da NF3e?

Total da retenção de tributos federais No XML ele fica em NF3e/infNF3e/total/vRetTribTot. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.

O que vai dentro do grupo vRetTribTot da NF3e?

4 campos: vIRRF, vRetCofins, vRetCSLL, vRetPIS. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.

vRetTribTot aparece em quantos lugares da NF3e?

Em 2 posições do esquema oficial: NF3e/infNF3e/total/vRetTribTot, nf3eProc/NF3e/infNF3e/total/vRetTribTot. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

vRetTribTot na NF3e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 3 outros documentos (NFAg, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição da NF3e?

Do esquema XML oficial (PL_NF3E_1.00a_NT2026.004_RTC_1.00). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo