CAMPO DO XML · NF3E Grupo 4 posições

retTrib

Grupo de informações de retenção de tributos federais do item anterior

✓ Conferido · 12 de outubro de 2026

Onde fica no arquivo

No documento

NF3e/infNF3e/NFdet/det/detItemAnt/retTrib

Opcional, no máximo uma vez
NF3e/infNF3e/NFdet/det/detItem/imposto/retTrib

Opcional, no máximo uma vez

Grupo de informações de retenção de tributos federais
nf3eProc/NF3e/infNF3e/NFdet/det/detItemAnt/retTrib

Opcional, no máximo uma vez
nf3eProc/NF3e/infNF3e/NFdet/det/detItem/imposto/retTrib

Opcional, no máximo uma vez

Grupo de informações de retenção de tributos federais

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

NF3e — Nota Fiscal Eletrônica de Energia Elétrica
└ infNF3e — Informações da NF3e
└ NFdet — Detalhamento de Produtos e Serviços
└ det — Detalhamento de Produtos e Serviços
└ detItemAnt — Grupo de informações referentes a item da NF3e anterior
└ retTrib — você está aqui

Dentro do grupo detItemAnt , grupo de informações referentes a item da NF3e anterior

O que o arquivo aceita neste campo

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

O mesmo nome em outros documentos fiscais — 4

retTrib 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á
NF-e	Retenção de Tributos Federais	NFe/infNFe/total/retTrib
NFAg	Grupo de informações de retenção de tributos federais	NFAg/infNFAg/det/imposto/retTrib
NFCom	Grupo de informações de retenção de tributos federais	NFCom/infNFCom/det/imposto/retTrib
NFGas	Grupo de informações de retenção de tributos federais	NFGas/infNFGas/det/gNormal/imposto/retTrib

Os campos dos doze documentos fiscais, com filtro →

O que vai dentro deste grupo — 5

retTrib é 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
vBCIRRF	Base de cálculo do IRRF	Obrigatório, uma vez
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 — 17

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

cClass Código de classificação indDevolucao Indicador de devolução do valor do item nItemAnt Número do item da NF3e anterior que este item está substituindo. Deve sempre existir um… pICMS Alíquota do ICMS qFaturada Quantidade Faturada vBC BC do ICMS vBCST BC do ICMS ST vCOFINS Valor do COFINS vCOFINSEfet Total do Valor Efetivo do COFINS vFCP Valor Total do FCP (Fundo de Combate à Pobreza). vFCPST Valor Total do FCP (Fundo de Combate à Pobreza) retido por substituição tributária. vICMS Valor Total do ICMS vICMSST Valor do ICMS ST retido vItem Valor unitário do item vPIS Valor do PIS vPISEfet Total do Valor Efetivo do PIS vProd Valor Total dos produtos e serviços

Perguntas frequentes

O que é o campo retTrib da NF3e?

Grupo de informações de retenção de tributos federais do item anterior No XML ele fica em NF3e/infNF3e/NFdet/det/detItemAnt/retTrib. É um grupo: não carrega valor próprio, agrupa outros campos. Opcional, no máximo uma vez.

O que vai dentro do grupo retTrib da NF3e?

5 campos: vBCIRRF, 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.

retTrib aparece em quantos lugares da NF3e?

Em 4 posições do esquema oficial: NF3e/infNF3e/NFdet/det/detItemAnt/retTrib, NF3e/infNF3e/NFdet/det/detItem/imposto/retTrib, nf3eProc/NF3e/infNF3e/NFdet/det/detItemAnt/retTrib, nf3eProc/NF3e/infNF3e/NFdet/det/detItem/imposto/retTrib. 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.

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

O nome se repete no leiaute de 4 outros documentos (NF-e, 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.