NCM Buscador

retTrib

Retenção de Tributos Federais

✓ Conferido · 02 de outubro de 2026Esquema XML da NF-e (leiaute) — enums oficiais de campo — Pacote de Liberação PL_010f_v1.04, publicado em 31/08/2026 (NT 2025.002 v1.50 e NT 2026.007 v1.00) · Receita Federal / ENCAT

Onde fica no arquivo

No documento

  • NFe/infNFe/total/retTrib

    Opcional, no máximo uma vez

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

  1. NFe — Nota Fiscal Eletrônica
  2. └ infNFe — Informações da Nota Fiscal eletrônica
  3. └ total — Dados dos totais da NF-e
  4. └ retTrib — você está aqui

Dentro do grupo total , dados dos totais da NF-e

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á
NF3e Grupo de informações de retenção de tributos federais do item anterior NF3e/infNF3e/NFdet/det/detItemAnt/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 — 7

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 Opcional, no máximo uma vez
vBCRetPrev Base de Cálculo da Retenção da Previdêncica Social Opcional, no máximo uma vez
vIRRF Valor Retido de IRRF Opcional, no máximo uma vez
vRetCOFINS Valor Retido de COFINS Opcional, no máximo uma vez
vRetCSLL Valor Retido de CSLL Opcional, no máximo uma vez
vRetPIS Valor Retido de PIS Opcional, no máximo uma vez
vRetPrev Valor da Retenção da Previdêncica Social Opcional, no máximo uma vez

Campos do mesmo grupo — 5

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

Perguntas frequentes

O que é o campo retTrib do NF-e?

Retenção de Tributos Federais No XML ele fica em NFe/infNFe/total/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 do NF-e?

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

retTrib no NF-e é o mesmo campo dos outros documentos fiscais?

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

Do esquema XML oficial (PL_010f_v1.04). 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