gAgencia
Grupo de informações da Agência reguladora Obrigatorio para tpFat 1 e 2 (normal e agregada) Vedado para tpFat 3 (agregadora)
Onde fica no arquivo
No documento
-
NFGas/infNFGas/gAgencia
Opcional, no máximo uma vez
-
nfgasProc/NFGas/infNFGas/gAgencia
Opcional, no máximo uma vez
O caminho até aqui, nível a nível
Dentro do grupo infNFGas , informações da NFGas
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á |
|---|---|---|
| NFAg | Grupo de informações da Agência reguladora VEDADO para tpFat=5 | NFAg/infNFAg/gAgencia |
O que vai dentro deste grupo — 5
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 |
|---|---|---|
| enderAgenciaAtend | Endereço da Agencia responsável pelo atendimento | Opcional, no máximo uma vez |
| gHistCons | Histórico de Consumo | 1 a 5 vez(es) |
| infAdReg | Informações adicionais de interesse das agencias reguladoras | Opcional, no máximo uma vez |
| nomeAgenciaAtend | Nome da Agencia responsável pelo atendimento | Opcional, no máximo uma vez |
| sitioAgenciaAtend | Sítio eletrônico da Agencia | Opcional, no máximo uma vez |
Campos do mesmo grupo — 16
São os campos que ficam ao lado deste no arquivo, dentro de NFGas/infNFGas. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo gAgencia da NFGas?
Grupo de informações da Agência reguladora Obrigatorio para tpFat 1 e 2 (normal e agregada) Vedado para tpFat 3 (agregadora) No XML ele fica em NFGas/infNFGas/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 NFGas?
5 campos: enderAgenciaAtend, gHistCons, infAdReg, nomeAgenciaAtend, sitioAgenciaAtend. 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 NFGas?
Em 2 posições do esquema oficial: NFGas/infNFGas/gAgencia, nfgasProc/NFGas/infNFGas/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 NFGas é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 1 outro documento (NFAg), 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 NFGas?
Do esquema XML oficial (PL_NFGas_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.