gFat
Grupo de informações de controle da Fatura Obrigatorio para tpFat 1 e 3 Vedado para tpFat 2
Onde fica no arquivo
No documento
-
NFAg/infNFAg/gFat
Opcional, no máximo uma vez
-
nfagProc/NFAg/infNFAg/gFat
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 — 3
gFat 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á |
|---|---|---|
| NF3e | Grupo de informações de controle da Fatura | NF3e/infNF3e/gFat |
| NFCom | Grupo de informações de controle da Fatura | NFCom/infNFCom/gFat |
| NFGas | Grupo de informações de controle da Fatura Obrigatorio para tpFat 1 e 3 (normal e agregador) Vedado para tpFat 2 (agregado) | NFGas/infNFGas/gFat |
O que vai dentro deste grupo — 11
gFat é 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 |
|---|---|---|
| codAgencia | Número da agência bancária para débito em conta | Obrigatório, uma vez |
| codBanco | Número do banco para débito em conta | Obrigatório, uma vez |
| codBarras | Linha digitável do código de barras | Obrigatório, uma vez |
| codDebAuto | Código de autorização débito em conta | Obrigatório, uma vez |
| CompetFat | Ano e mês referência do faturamento (AAAAMM) | Obrigatório, uma vez |
| dApresFat | Data de apresentação da fatura | Opcional, no máximo uma vez |
| dProxLeitura | Data prevista próxima leitura | Obrigatório, uma vez |
| dVencFat | Data de vencimento da fatura | Obrigatório, uma vez |
| enderCorresp | Endereço de entrega da fatura. | Opcional, no máximo uma vez |
| gPIX | Grupo de informações do PIX | Opcional, no máximo uma vez |
| nFat | Número da Fatura | 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 gFat da NFAg?
Grupo de informações de controle da Fatura Obrigatorio para tpFat 1 e 3 Vedado para tpFat 2 No XML ele fica em NFAg/infNFAg/gFat. É um grupo: não carrega valor próprio, agrupa outros campos. Opcional, no máximo uma vez.
O que vai dentro do grupo gFat da NFAg?
11 campos: codAgencia, codBanco, codBarras, codDebAuto, CompetFat, dApresFat, dProxLeitura, dVencFat, enderCorresp, gPIX, nFat. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.
gFat aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/gFat, nfagProc/NFAg/infNFAg/gFat. 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.
gFat na NFAg é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 3 outros documentos (NF3e, NFCom, 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.