CAMPO DO XML · NF3E Obrigatório 2 posições

tpBand

Tipo da bandeira tarifária

✓ Conferido · 12 de outubro de 2026

Onde fica no arquivo

No documento

NF3e/infNF3e/NFdet/det/detItem/gAdBand/tpBand

Obrigatório, uma vez
nf3eProc/NF3e/infNF3e/NFdet/det/detItem/gAdBand/tpBand

Obrigatório, uma vez

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
└ detItem — Grupo de informações referentes a item da NF3e
└ gAdBand — Grupo de Adicional de Bandeira
└ tpBand — você está aqui

Dentro do grupo gAdBand , grupo de Adicional de Bandeira

O que o arquivo aceita neste campo

Ocorrência: 1-1
Tamanho: 1
Tipo no esquema: TBand
Formato base: string

Valores aceitos — 5

Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.

Campos do mesmo grupo — 5

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

dFimAdBand Data de fim da aplicação do adicional dIniAdBand Data de início da aplicação do adicional motDifBand Motivo da diferença do adicional aplicado vAdBand Valor do Adicional tarifário vAdBandAplic Valor do adicional tarifário aplicado

Perguntas frequentes

O que é o campo tpBand da NF3e?

Tipo da bandeira tarifária No XML ele fica em NF3e/infNF3e/NFdet/det/detItem/gAdBand/tpBand. Obrigatório, uma vez, com tamanho 1.

tpBand aparece em quantos lugares da NF3e?

Em 2 posições do esquema oficial: NF3e/infNF3e/NFdet/det/detItem/gAdBand/tpBand, nf3eProc/NF3e/infNF3e/NFdet/det/detItem/gAdBand/tpBand. 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.

Quais valores tpBand aceita na NF3e?

O esquema oficial restringe a 5 valores: 1, 2, 3, 4, 5. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.

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.