NCM Buscador
CAMPO DO XML · NF3E Obrigatório 4 posições 1 regra

vSaldAtual

Saldo Atual de Créditos em kWh

✓ 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/gSCEE/gSaldoCred/vSaldAtual

    Obrigatório, uma vez

  • NF3e/infNF3e/gSCEE/gTipoSaldo/gSaldoCred/vSaldAtual

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/gSCEE/gSaldoCred/vSaldAtual

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/gSCEE/gTipoSaldo/gSaldoCred/vSaldAtual

    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. └ gSCEE — Grupo dos dados do Sistema de Compensação de Energia Elétrica
  4. └ gSaldoCred — Saldos de Créditos por posto tarifário
  5. └ vSaldAtual — você está aqui

Dentro do grupo gSaldoCred , saldos de Créditos por posto tarifário

O que o arquivo aceita neste campo

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

Formato exigido: [0-9]{1,11}(\.[0-9]{2,4})? 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.

As regras que verificam este campo — 1

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

410 vSaldAtual Validações diversas da NF3e

Se informado grupo do Sistema de Compensação de Energia Elétrica (SCEE) e existir Saldo Atual > 0 (tag: vSaldAtual) em um posto tarifário - Rejeitar se não forem informados crédito a Expirar (tag: vCredExpirar) e Competência da expiração (tag: CompetExpirar)

Mensagem: Expiração dos créditos do SCEE devem ser informados para saldo positivo

Campos do mesmo grupo — 5

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

Perguntas frequentes

O que é o campo vSaldAtual da NF3e?

Saldo Atual de Créditos em kWh No XML ele fica em NF3e/infNF3e/gSCEE/gSaldoCred/vSaldAtual. Obrigatório, uma vez.

vSaldAtual aparece em quantos lugares da NF3e?

Em 4 posições do esquema oficial: NF3e/infNF3e/gSCEE/gSaldoCred/vSaldAtual, NF3e/infNF3e/gSCEE/gTipoSaldo/gSaldoCred/vSaldAtual, nf3eProc/NF3e/infNF3e/gSCEE/gSaldoCred/vSaldAtual, nf3eProc/NF3e/infNF3e/gSCEE/gTipoSaldo/gSaldoCred/vSaldAtual. 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 rejeição vSaldAtual pode causar na NF3e?

1 regra do manual cita este campo, disparando o código 410. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

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