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

vTarifHom

Valor da tarifa homologada pela ANEEL

✓ 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/NFdet/det/detItem/gTarif/vTarifHom

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/NFdet/det/detItem/gTarif/vTarifHom

    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. └ NFdet — Detalhamento de Produtos e Serviços
  4. └ det — Detalhamento de Produtos e Serviços
  5. └ detItem — Grupo de informações referentes a item da NF3e
  6. └ gTarif — Grupo de Tarifas por Período
  7. └ vTarifHom — você está aqui

Dentro do grupo gTarif , grupo de Tarifas por Período

O que o arquivo aceita neste campo

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

Formato exigido: 0|0\.[0-9]{8}|[1-9]{1}[0-9]{0,8}(\.[0-9]{8})? Número decimal: até 9 dígitos na parte inteira e 8 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

Campos do mesmo grupo — 10

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

anoAto Ano do Ato da ANEEL (AAAA) cPosTarif Tipo de posto tarifário dFimTarif Data de fim da aplicação da tarifa dIniTarif Data de início da aplicação da tarifa motDifTarif Motivo da diferença de tarifa aplicada com a homologada nAto Número do Ato da ANEEL tpAto Tipo de Ato da ANEEL tpTarif Tarifa de aplicação uMed Unidade Básica de Medida vTarifAplic Valor da tarifa aplicada

Perguntas frequentes

O que é o campo vTarifHom da NF3e?

Valor da tarifa homologada pela ANEEL No XML ele fica em NF3e/infNF3e/NFdet/det/detItem/gTarif/vTarifHom. Obrigatório, uma vez.

vTarifHom aparece em quantos lugares da NF3e?

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

Que formato o campo vTarifHom exige na NF3e?

Número decimal: até 9 dígitos na parte inteira e 8 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. A regra é a expressão do próprio esquema (0|0\.[0-9]{8}|[1-9]{1}[0-9]{0,8}(\.[0-9]{8})?), e ela é verificada antes de qualquer regra de negócio: valor fora do formato faz o arquivo ser recusado na validação, com rejeição genérica de schema — que é a mais difícil de diagnosticar justamente por não citar o campo.

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