gAgencia
Grupo de informações da Agência reguladora VEDADO para tpFat=5
Onde fica no arquivo
No documento
-
NFAg/infNFAg/gAgencia
Opcional, no máximo uma vez
-
nfagProc/NFAg/infNFAg/gAgencia
Opcional, no máximo uma vez
O caminho até aqui, nível a nível
Dentro do grupo infNFAg , informações da NFAg
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 — 1
gAgencia 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á |
|---|---|---|
| NFGas | Grupo de informações da Agência reguladora Obrigatorio para tpFat 1 e 2 (normal e agregada) Vedado para tpFat 3 (agregadora) | NFGas/infNFGas/gAgencia |
O que vai dentro deste grupo — 8
gAgencia é 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 |
|---|---|---|
| dEmissSelo | Data de emissão do Selo de segurança do prestador | Opcional, no máximo uma vez |
| econ | Demonstrativo de economia de agua | Opcional, no máximo uma vez |
| econAcumulada | Demonstrativo de economia de agua acumulada no período | Opcional, no máximo uma vez |
| enderAgenciaAtend | Endereço da Agencia responsável pelo atendimento | Obrigatório, uma vez |
| gHistCons | Histórico de Consumo | 1 a 5 vez(es) |
| nAgenciaAtend | Agencia responsável pelo atendimento | Obrigatório, uma vez |
| sPrestador | Selo de segurança do prestador | Opcional, no máximo uma vez |
| sRegulador | Selo de segurança do Regulador | Opcional, no máximo uma vez |
Campos do mesmo grupo — 18
São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo gAgencia da NFAg?
Grupo de informações da Agência reguladora VEDADO para tpFat=5 No XML ele fica em NFAg/infNFAg/gAgencia. É um grupo: não carrega valor próprio, agrupa outros campos. Opcional, no máximo uma vez.
O que vai dentro do grupo gAgencia da NFAg?
8 campos: dEmissSelo, econ, econAcumulada, enderAgenciaAtend, gHistCons, nAgenciaAtend, sPrestador, sRegulador. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.
gAgencia aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/gAgencia, nfagProc/NFAg/infNFAg/gAgencia. 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.
gAgencia na NFAg é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 1 outro documento (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 NFAg?
Do esquema XML oficial (PL_NFAg_NT2026.004_RTC_1.00_correcao). 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.