Campos do XML da NFGas: caminho, tamanho e valores

(raiz do arquivo)

12 campos

Campo	O que é	Ocorrência	Regras
consSitNFGas	Schema de validação XML dp Pedido de Consulta da Situação Atual da NFGas.	Obrigatório, uma vez	—
consStatServNFGas	Schema XML de validação do Pedido de Consulta do Status do Serviço NFGas	Obrigatório, uma vez	—
evCancNFGas	Schema XML de validação do evento do cancelamento 110111	Obrigatório, uma vez	—
evCancVincPgto	Schema XML de validação do evento cancelamento da vinculação do pgto 110301	Obrigatório, uma vez	—
eventoNFGas	Schema XML de validação do Pedido de Registro de Evento da NFGas	Obrigatório, uma vez	—
evVincPgto	Schema XML de validação do evento de vinculação da transação de pagamento com o DFe - 110300	Obrigatório, uma vez	—
NFGas	Nota Fiscal Eletrônica da Agua	Obrigatório, uma vez	—
nfgasProc	NFGas processada	Obrigatório, uma vez	—
retConsSitNFGas	Schema XML de validação do retorno da consulta da situação atual da NFGas.	Obrigatório, uma vez	—
retConsStatServNFGas	Schema XML de validação do Resultado da Consulta do Status do Serviço de NFGas	Obrigatório, uma vez	—
retEventoNFGas	Schema XML de validação do retorno Pedido de Evento da NFGas	Obrigatório, uma vez	—
retNFGas	Schema XML de validação do retorno da NFGas	Obrigatório, uma vez	—

consSitNFGas

1 campo

Campo	O que é	Ocorrência	Regras
xServ	Serviço Solicitado	Obrigatório, uma vez	—

evCancNFGas

1 campo

Campo	O que é	Ocorrência	Regras
descEvento	Descrição do Evento - “Cancelamento”	Obrigatório, uma vez	—

evCancVincPgto

1 campo

Campo	O que é	Ocorrência	Regras
nProtVincPgto	Número do Protocolo de autorização do evento a ser cancelado	Obrigatório, uma vez	—

eventoNFGas

1 campo

Campo	O que é	Ocorrência	Regras
infEvento	—	Obrigatório, uma vez	—

NFGas

2 campos

Campo	O que é	Ocorrência	Regras
infNFGas	Informações da NFGas	Obrigatório, uma vez	—
infNFGasSupl	Informações suplementares da NFGas	Obrigatório, uma vez	—

nfgasProc

5 campos

Campo	O que é	Ocorrência	Regras
dhConexao	Data e Hora da Conexão de Origem	Opcional, no máximo uma vez	—
ipTransmissor	IP do transmissor do documento fiscal para o ambiente autorizador	Opcional, no máximo uma vez	—
nPortaCon	Porta de origem utilizada na conexão (De 0 a 65535)	Opcional, no máximo uma vez	—
protNFGas	Tipo Protocolo de status resultado do processamento da NFGas	Obrigatório, uma vez	—
versao	Versão do leiaute	Obrigatório, uma vez	—

retConsSitNFGas

1 campo

Campo	O que é	Ocorrência	Regras
procEventoNFGas	Pedido de Registro de Evento de NFGas processado	Opcional, quantas vezes precisar	—

retConsStatServNFGas

3 campos

Campo	O que é	Ocorrência	Regras
dhRetorno	AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados.	Opcional, no máximo uma vez	—
tMed	Tempo médio de resposta do serviço (em segundos) dos últimos 5 minutos	Opcional, no máximo uma vez	—
xObs	Campo observação utilizado para incluir informações ao contribuinte	Opcional, no máximo uma vez	—

eventoNFGas/infEvento

5 campos

Campo	O que é	Ocorrência	Regras
cOrgao	Código do órgão de recepção do Evento.	Obrigatório, uma vez	—
detEvento	Detalhamento do evento específico	Obrigatório, uma vez	—
dhEvento	Data e Hora do Evento, formato UTC (AAAA-MM-DDThh:mm:ssTZD)	Obrigatório, uma vez	—
nSeqEvento	Seqüencial do evento para o mesmo tipo de evento. Para maioria dos eventos será 1, nos casos em que possa existir mais de um evento o autor do evento…	Obrigatório, uma vez	—
tpEvento	Tipo do Evento	Obrigatório, uma vez	—

NFGas/infNFGas

16 campos

Campo	O que é	Ocorrência	Regras
autXML	Autorizados para download do XML do DF-e	0 a 10 vez(es)	—
dest	Identificação do destinatário	Obrigatório, uma vez	—
det	Detalhamento de Produtos e Serviços	1 a 990 vez(es)	—
emit	Identificação do Emitente do documento fiscal	Obrigatório, uma vez	—
gAgencia	Grupo de informações da Agência reguladora Obrigatorio para tpFat 1 e 2 (normal e agregada) Vedado para tpFat 3 (agregadora)	Opcional, no máximo uma vez	—
gFat	Grupo de informações de controle da Fatura Obrigatorio para tpFat 1 e 3 (normal e agregador) Vedado para tpFat 2 (agregado)	Opcional, no máximo uma vez	—
gMed	Grupo de informações dos Equipamentos de Medição	0 a 99 vez(es)	520 521
gRespTec	Informações do Responsável Técnico pela emissão do DF-e	Opcional, no máximo uma vez	—
gSub	Grupo de informações da substituição	Opcional, no máximo uma vez	—
gVolContrat	Grupo de informações das volumes contratados	0 a 20 vez(es)	—
Id	Identificador da tag a ser assinada	Obrigatório, uma vez	—
ide	Identificação da NFGas	Obrigatório, uma vez	1026 1027 1028 1029
infAdic	Informações Adicionais	Opcional, no máximo uma vez	—
instalacao	Dados da Instalação OPCIONAL para TpFat=3	Opcional, no máximo uma vez	—
pgtoVinc	Grupo de informações da vínculação com a transação de pagamento	Opcional, no máximo uma vez	—
total	Dados dos totais da NFGas	Obrigatório, uma vez	1054

NFGas/infNFGasSupl

1 campo

Campo	O que é	Ocorrência	Regras
qrCodNFGas	Texto com o QR-Code para consulta da NFGas	Obrigatório, uma vez	—

nfgasProc/protNFGas

2 campos

Campo	O que é	Ocorrência	Regras
infFisco	Mensagem do Fisco	Opcional, no máximo uma vez	—
infProt	Dados do protocolo de status	Obrigatório, uma vez	—

retEventoNFGas/infEvento

2 campos

Campo	O que é	Ocorrência	Regras
dhRegEvento	Data e Hora de do recebimento do evento ou do registro do evento formato AAAA-MM-DDThh:mm:ssTZD	Opcional, no máximo uma vez	—
xEvento	Descrição do Evento	Opcional, no máximo uma vez	—

eventoNFGas/infEvento/detEvento

1 campo

Campo	O que é	Ocorrência	Regras
versaoEvento	—	Obrigatório, uma vez	—

NFGas/infNFGas/autXML

2 campos

Campo	O que é	Ocorrência	Regras
CNPJ	CNPJ do autorizado	Obrigatório, uma vez	—
CPF	CPF do autorizado	Obrigatório, uma vez	—

NFGas/infNFGas/dest

8 campos

Campo	O que é	Ocorrência	Regras
cNIS	Número da Identificação Social - NIS	Obrigatório, uma vez	—
enderDest	Endereço do destinatário	Obrigatório, uma vez	—
idOutros	Identificação do destinatário outros	Obrigatório, uma vez	—
IE	Inscrição Estadual do destinatário	Opcional, no máximo uma vez	—
IM	Inscrição Municipal	Opcional, no máximo uma vez	—
NB	Número do Benefício	Obrigatório, uma vez	—
xNome	Razão social ou Nome do destinatário	Obrigatório, uma vez	—
xNomeAdicional	Nome de destinatário adicional	Opcional, no máximo uma vez	—

NFGas/infNFGas/det

5 campos

Campo	O que é	Ocorrência	Regras
chNFGasAnt	Chave de Acesso da NFGas anterior Usar para NFGas quando indicar um item de devolução de nota anterior DEVE SER USADA NA NOTA AGREGADORA PARA INDICAR…	Opcional, no máximo uma vez	242 245 246 250
gAgregadora	Informar para faturamento agregador (3)	Obrigatório, uma vez	—
gNormal	Informar se faturamento normal (1) ou agregado (2)	Obrigatório, uma vez	—
nItem	Número do item da NFGas	Obrigatório, uma vez	—
nItemAnt	Número do item da NFGas anterior	Opcional, no máximo uma vez	—

NFGas/infNFGas/emit

3 campos

Campo	O que é	Ocorrência	Regras
enderEmit	Endereço do emitente	Obrigatório, uma vez	—
ISUFEmit	Inscrição do emitente da Suframa	Opcional, no máximo uma vez	—
xFant	Nome fantasia do emitente	Opcional, no máximo uma vez	—

NFGas/infNFGas/gAgencia

5 campos

Campo	O que é	Ocorrência	Regras
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	—

NFGas/infNFGas/gFat

12 campos

Campo	O que é	Ocorrência	Regras
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	—
infAdFat	Informações adicionais de faturamento	Opcional, no máximo uma vez	—
nFat	Número da Fatura	Opcional, no máximo uma vez	—

NFGas/infNFGas/gMed

8 campos

Campo	O que é	Ocorrência	Regras
dMedAnt	Data da leitura anterior	Obrigatório, uma vez	—
dMedAtu	Data da leitura atual	Obrigatório, uma vez	—
idEqp	Identificação do equipamento de Medição	Obrigatório, uma vez	—
nMed	Número de referência para informar nos produtos a relação com a medição	Obrigatório, uma vez	—
tpEqp	1 - Medidor 2 - Conversor	Obrigatório, uma vez	—
tpMedidor	1 - Turbina 2 - Rotativo 3 - Diafragma 4 - Ultrasonico Informado apenas para tpEqp = 1	Opcional, no máximo uma vez	—
vMedAnt	Valor da medição (leitura) anterior	Obrigatório, uma vez	—
vMedAtu	Valor da medição (leitura) atual	Obrigatório, uma vez	—

NFGas/infNFGas/gRespTec

5 campos

Campo	O que é	Ocorrência	Regras
email	Email da pessoa jurídica a ser contatada	Obrigatório, uma vez	—
fone	Telefone da pessoa jurídica a ser contatada	Obrigatório, uma vez	—
hashCSRT	Hash do token do código de segurança do responsável técnico	Obrigatório, uma vez	—
idCSRT	Identificador do código de segurança do responsável técnico	Obrigatório, uma vez	—
xContato	Nome da pessoa a ser contatada	Obrigatório, uma vez	—

NFGas/infNFGas/gSub

3 campos

Campo	O que é	Ocorrência	Regras
chNFGas	Chave de acesso da NFGas referenciada	Obrigatório, uma vez	—
gNF	Informação da NF em papel referenciada	Obrigatório, uma vez	—
motSub	Motivo da substituição	Obrigatório, uma vez	—

NFGas/infNFGas/gVolContrat

3 campos

Campo	O que é	Ocorrência	Regras
nContrat	Número de referência para informar nos produtos a relação com a quantidade contratada	Obrigatório, uma vez	—
qUnidContrat	Quantidade Contratada em m3	Obrigatório, uma vez	—
tpVolContrat	Tipo de volume contratado	Obrigatório, uma vez	—

NFGas/infNFGas/ide

18 campos

Campo	O que é	Ocorrência	Regras
cDV	Digito verificador da chave de acesso	Obrigatório, uma vez	—
cMunFG	Código do município de ocorrência do fato gerador do IBS/CBS	Obrigatório, uma vez	—
cNF	Código numérico que compõe a Chave de Acesso.	Obrigatório, uma vez	—
cUF	Código da UF do emitente da NFGas	Obrigatório, uma vez	226
dhCont	Data e Hora da entrada em contingência	Obrigatório, uma vez	417
dhEmi	Data e hora de emissão do documento fiscal	Obrigatório, uma vez	—
finNFGas	Finalidade de emissão da NFGas	Obrigatório, uma vez	411 412 414 206
gCompraGov	Grupo de Compras Governamentais	Opcional, no máximo uma vez	—
mod	Modelo da NFGas	Obrigatório, uma vez	—
nNF	Número do documento fiscal	Obrigatório, uma vez	—
nSiteAutoriz	Identificação do número do Site do Autorizador de recepção da NFGas	Obrigatório, uma vez	—
serie	Série do documento fiscal	Obrigatório, uma vez	—
tpAmb	Tipo do Ambiente	Obrigatório, uma vez	252
tpEmis	Forma de emissão do Documento Fiscal	Obrigatório, uma vez	416 419 228
tpFat	Tipo de Faturamento da NFGas	Obrigatório, uma vez	527 516 531 270
tpPagAnt	Tipo Pagamento ou Pagamento Antecipado	Opcional, no máximo uma vez	—
verProc	Versão do processo de emissão	Obrigatório, uma vez	—
xJust	Justificativa da entrada em contingência	Obrigatório, uma vez	—

NFGas/infNFGas/infAdic

2 campos

Campo	O que é	Ocorrência	Regras
infAdFisco	Informações adicionais de interesse do Fisco	Opcional, no máximo uma vez	—
infCpl	Informações complementares de interesse do Contribuinte	0 a 5 vez(es)	—

NFGas/infNFGas/instalacao

9 campos

Campo	O que é	Ocorrência	Regras
codRoteiroLeitura	Roteiro da Leitura para uso operacional	Opcional, no máximo uma vez	—
idCodCliente	Código de Identificação do Cliente para empresa emitente	Opcional, no máximo uma vez	—
idInstalacao	Código único de Identificação da Instalação	Obrigatório, uma vez	—
latGPS	Latitude do ponto geográfico da localização da captura	Obrigatório, uma vez	—
longGPS	Longitude do ponto geográfico da localização da captura	Obrigatório, uma vez	—
nContrato	Número do Contrato	Opcional, no máximo uma vez	—
tpClasse	Classe de Consumo da Instalação	Obrigatório, uma vez	—
tpInstalacao	Tipo de Instalação	Obrigatório, uma vez	—
xClasse	Detalhamento da Classe quando informado Outros	Opcional, no máximo uma vez	522 523

NFGas/infNFGas/pgtoVinc

1 campo

Campo	O que é	Ocorrência	Regras
pgto	Dados de cada pagamento previsto	1 a 99 vez(es)	—

NFGas/infNFGas/total

10 campos

Campo	O que é	Ocorrência	Regras
IBSCBSTot	Totais de IBS e CBS	Obrigatório, uma vez	—
ICMSTot	Totais referentes ao ICMS	Obrigatório, uma vez	—
vCOFINS	Valor do COFINS	Obrigatório, uma vez	—
vNF	Valor Total da NFGas	Obrigatório, uma vez	463
vPIS	Valor do PIS	Obrigatório, uma vez	—
vProd	Valor Total dos produtos e serviços	Obrigatório, uma vez	435
vProdLiq	Valor Total líquido dos produtos e serviços sem tributos	Opcional, no máximo uma vez	—
vRetTribTot	Total da retenção de tributos federais	Obrigatório, uma vez	—
vTotDFe	Valor total do documento fiscal (vNF )	Obrigatório, uma vez	—
vTxReg	Valor Taxa Regulatoria	Obrigatório, uma vez	—

nfgasProc/protNFGas/infFisco

2 campos

Campo	O que é	Ocorrência	Regras
cMsg	Código do status da mensagem do fisco	Obrigatório, uma vez	—
xMsg	Mensagem do Fisco	Obrigatório, uma vez	—

nfgasProc/protNFGas/infProt

6 campos

Campo	O que é	Ocorrência	Regras
cStat	Código do status da NFGas	Obrigatório, uma vez	—
dhRecbto	Data e hora de processamento, no formato AAAA-MM-DDTHH:MM:SS TZD.	Obrigatório, uma vez	—
digVal	Digest Value da NFGas processado. Utilizado para conferir a integridade da NFGas original.	Opcional, no máximo uma vez	—
nProt	Número do Protocolo de Status da NFGas.	Opcional, no máximo uma vez	—
verAplic	Versão do Aplicativo que processou a NFGas	Obrigatório, uma vez	—
xMotivo	Descrição literal do status da NFGas	Obrigatório, uma vez	—

NFGas/infNFGas/dest/enderDest

8 campos

Campo	O que é	Ocorrência	Regras
CEP	CEP	Obrigatório, uma vez	—
cMun	Código do município (utilizar a tabela do IBGE)	Obrigatório, uma vez	1015
nro	Número	Obrigatório, uma vez	—
UF	Sigla da UF	Obrigatório, uma vez	247
xBairro	Bairro	Obrigatório, uma vez	—
xCpl	Complemento	Opcional, no máximo uma vez	—
xLgr	Logradouro	Obrigatório, uma vez	—
xMun	Nome do município	Obrigatório, uma vez	—

NFGas/infNFGas/det/gAgregadora

1 campo

Campo	O que é	Ocorrência	Regras
cClass	Código de classificação	Obrigatório, uma vez	276

NFGas/infNFGas/det/gNormal

5 campos

Campo	O que é	Ocorrência	Regras
gProcRef	Grupo Processo referenciado	Opcional, no máximo uma vez	—
gTarif	Grupo de Tarifas por Período	0 a 20 vez(es)	—
imposto	Tributos incidentes no Produto ou Serviço	Obrigatório, uma vez	—
infAdProd	Informações adicionais do produto (norma referenciada, informações complementares, etc)	Opcional, no máximo uma vez	—
prod	Dados do Produto ou Serviço	Obrigatório, uma vez	—

NFGas/infNFGas/gAgencia/gHistCons

3 campos

Campo	O que é	Ocorrência	Regras
gCons	Consumo	1 a 13 vez(es)	—
medMensal	Média Mensal de consumo	Obrigatório, uma vez	—
xHistorico	Nome do histórico para exibição/apresentação	Obrigatório, uma vez	—

NFGas/infNFGas/gFat/gPIX

1 campo

Campo	O que é	Ocorrência	Regras
urlQRCodePIX	URL do QRCode do PIX que será apresentado na fatura	Obrigatório, uma vez	—

NFGas/infNFGas/gSub/gNF

3 campos

Campo	O que é	Ocorrência	Regras
CompetApur	Ano e mês de apuração (AAAAMM)	Obrigatório, uma vez	—
CompetEmis	Ano e mês da emissão da NF papel (AAAAMM)	Obrigatório, uma vez	—
hash115	Hash do registro no arquivo do convênio 115	Opcional, no máximo uma vez	—

NFGas/infNFGas/ide/gCompraGov

4 campos

Campo	O que é	Ocorrência	Regras
pRedutor	Percentual de redução de aliquota em compra governamental	Obrigatório, uma vez	367 381 384
refDFeAnt	Chave de acesso do documento fiscal anterior. Deverá ser informado para tpOperGov 2 e 3 e vedado para os tipos 1 e 4. No caso do tpOperGov 2 aceitará…	0 a 99 vez(es)	—
tpEnteGov	Para administração pública direta e suas autarquias e fundações: 1=União 2=Estados 3=Distrito Federal 4=Municípios 5=Consórcio Público 6=Comitê…	Obrigatório, uma vez	347
tpOperGov	Tipo da operação com ente governamental: 1 – Fornecimento com pagamento posterior; 2 - Recebimento do pagamento com fornecimento já realizado; 3 –…	Obrigatório, uma vez	—

NFGas/infNFGas/pgtoVinc/pgto

5 campos

Campo	O que é	Ocorrência	Regras
CNPJBasePSP	CNPJ base da instituição financeira ou de pagamento	Obrigatório, uma vez	—
CNPJReceb	CNPJ do recebedor do pagamento	Obrigatório, uma vez	—
idTransacao	ID específico da transação financeira conforme o meio de pagamento	Obrigatório, uma vez	—
nPag	Número sequencial do pagamento	Obrigatório, uma vez	—
tpMeioPgto	Código do meio de pagamento (ver IT DFe 2026.001)	Obrigatório, uma vez	—

NFGas/infNFGas/total/IBSCBSTot

4 campos

Campo	O que é	Ocorrência	Regras
gCBS	Totalização da CBS	Obrigatório, uma vez	—
gEstornoCred	Totalização do estorno de crédito	Opcional, no máximo uma vez	—
gIBS	Totalização do IBS	Obrigatório, uma vez	—
vBCIBSCBS	Total Base de Calculo	Obrigatório, uma vez	—

NFGas/infNFGas/total/ICMSTot

7 campos

Campo	O que é	Ocorrência	Regras
vBC	BC do ICMS	Obrigatório, uma vez	—
vBCST	BC do ICMS ST	Obrigatório, uma vez	—
vFCP	Valor Total do FCP (Fundo de Combate à Pobreza).	Obrigatório, uma vez	—
vFCPST	Valor Total do FCP (Fundo de Combate à Pobreza) retido por substituição tributária.	Obrigatório, uma vez	—
vICMS	Valor Total do ICMS	Obrigatório, uma vez	—
vICMSDeson	Valor Total do ICMS desonerado	Obrigatório, uma vez	—
vST	Valor Total do ICMS ST	Obrigatório, uma vez	—

NFGas/infNFGas/total/vRetTribTot

4 campos

Campo	O que é	Ocorrência	Regras
vIRRF	Valor do IRRF retido	Obrigatório, uma vez	—
vRetCofins	Valor do COFNS retido	Obrigatório, uma vez	—
vRetCSLL	Valor da CSLL retida	Obrigatório, uma vez	—
vRetPIS	Valor do PIS retido	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/gProcRef

5 campos

Campo	O que é	Ocorrência	Regras
gIBSCBS	Grupo de informações do IBS e CBS a serem considerados sem a aplicação do processo judicial	Opcional, no máximo uma vez	—
gProc	Grupo identificador do Processo	1 a 10 vez(es)	—
indDevolucao	Indicador de devolução do valor do item	Opcional, no máximo uma vez	238
qFaturada	Quantidade Faturada	Obrigatório, uma vez	435
vItem	Valor unitário do item	Obrigatório, uma vez	435

NFGas/infNFGas/det/gNormal/gTarif

6 campos

Campo	O que é	Ocorrência	Regras
anoAto	Ano do Ato (AAAA)	Obrigatório, uma vez	—
dFimTarif	Data de fim da aplicação da tarifa	Opcional, no máximo uma vez	—
dIniTarif	Data de início da aplicação da tarifa	Obrigatório, uma vez	—
nAto	Número do Ato	Obrigatório, uma vez	—
tpFaixaCons	Faixa Prevista de Consumo	Obrigatório, uma vez	—
vTarifAplic	Valor da tarifa aplicada	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto

16 campos

Campo	O que é	Ocorrência	Regras
COFINS	Dados do COFINS	Opcional, no máximo uma vez	—
gICMSPrevistoPagtoAntecip	Grupo utilizado exclusivamente na determinação da BC de IBS e CBS em cenários específicos de pagamento antecipado	Obrigatório, uma vez	—
IBSCBS	Grupo de informações do IBS e CBS	Obrigatório, uma vez	—
ICMS00	Prestação sujeito à tributação normal do ICMS	Obrigatório, uma vez	—
ICMS10	Tributada e com cobrança do ICMS por substituição tributária	Obrigatório, uma vez	—
ICMS20	Prestação sujeito à tributação com redução de BC do ICMS	Obrigatório, uma vez	—
ICMS40	Tributação Isenta, Não tributada	Obrigatório, uma vez	—
ICMS51	Tributação com Diferimento	Obrigatório, uma vez	—
ICMS60	Tributação pelo ICMS 60 - ICMS cobrado anteriormente por substituição tributária	Obrigatório, uma vez	—
ICMS70	Tributação pelo ICMS 70 - Com redução de base de cálculo e cobrança do ICMS por substituição tributária	Obrigatório, uma vez	—
ICMS90	ICMS Outros	Obrigatório, uma vez	—
indSemCST	Sem Situação Tributária para o ICMS	Obrigatório, uma vez	540 541
orig	Origem da mercadoria	Obrigatório, uma vez	—
PIS	Dados do PIS	Opcional, no máximo uma vez	—
retTrib	Grupo de informações de retenção de tributos federais	Opcional, no máximo uma vez	—
TxReg	Taxa Regulatória	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/prod

12 campos

Campo	O que é	Ocorrência	Regras
CFOP	CFOP	Opcional, no máximo uma vez	—
cProd	Código do produto ou serviço.	Obrigatório, uma vez	—
fatorP	Fator de correção de pressão	Opcional, no máximo uma vez	—
fatorPCS	Fator de poder calorifico Deve maior que zero	Opcional, no máximo uma vez	435
fatorPTZ	Fator de correção	Opcional, no máximo uma vez	435
fatorT	Fator de correção de temperatura	Opcional, no máximo uma vez	—
gMedicao	Grupo para referenciar qual medição e medida estão relacionadas ao item Informar para origem qtd = 1 ou 5	Opcional, no máximo uma vez	—
gPagAntecipado	Grupo de antecipação de pagamento Permite informar apenas quando tpPagAnt=3	Opcional, no máximo uma vez	—
indOrigemQtd	Indicador da origem da quantidade faturada	Obrigatório, uma vez	—
uMed	Unidade Básica de Medida	Obrigatório, uma vez	—
vItemLiq	Valor unitário do item sem tributos	Obrigatório, uma vez	—
xProd	Descrição do produto ou serviço	Obrigatório, uma vez	—

NFGas/infNFGas/gAgencia/gHistCons/gCons

4 campos

Campo	O que é	Ocorrência	Regras
consumo	Consumo no mês	Opcional, no máximo uma vez	—
medDiaria	Média Diária de consumo	Opcional, no máximo uma vez	—
qtdDias	Quantidade de dias de medição	Obrigatório, uma vez	—
vFat	Valor Faturado	Obrigatório, uma vez	—

NFGas/infNFGas/total/IBSCBSTot/gCBS

3 campos

Campo	O que é	Ocorrência	Regras
vCBS	Valor total da CBS	Obrigatório, uma vez	—
vDevTrib	Total de devoluções de tributos	Obrigatório, uma vez	—
vDif	Total do Diferimento	Obrigatório, uma vez	—

NFGas/infNFGas/total/IBSCBSTot/gEstornoCred

2 campos

Campo	O que é	Ocorrência	Regras
vCBSEstCred	Valor total da CBS estornada	Obrigatório, uma vez	—
vIBSEstCred	Valor total do IBS estornado	Obrigatório, uma vez	—

NFGas/infNFGas/total/IBSCBSTot/gIBS

3 campos

Campo	O que é	Ocorrência	Regras
gIBSMun	Totalização do IBS de competência Municipal	Obrigatório, uma vez	—
gIBSUF	Totalização do IBS de competência da UF	Obrigatório, uma vez	—
vIBS	Valor total do IBS	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/gProcRef/gIBSCBS

2 campos

Campo	O que é	Ocorrência	Regras
vIBSMun	Valor do IBS Municipal	Obrigatório, uma vez	—
vIBSUF	Valor do IBS de competência das UF	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/gProcRef/gProc

2 campos

Campo	O que é	Ocorrência	Regras
nProcesso	Número do Processo	Obrigatório, uma vez	—
tpProc	Tipo de Processo	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/COFINS

2 campos

Campo	O que é	Ocorrência	Regras
CST	classificação Tributária do COFINS	Obrigatório, uma vez	311 366 369 383
pCOFINS	Alíquota do COFINS (em percentual)	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/gICMSPrevistoPagtoAntecip

1 campo

Campo	O que é	Ocorrência	Regras
vICMSPrevisto	Valor do ICMS a incidir no momento do fornecimento futuro. Observação: Em cenários onde não há valor de ICMS devido, informar 0.	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS

2 campos

Campo	O que é	Ocorrência	Regras
cClassTrib	Código de Classificação Tributária do IBS e da CBS	Obrigatório, uma vez	312 388
indDoacao	Tipo Indicador de Doação	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS00

2 campos

Campo	O que é	Ocorrência	Regras
pFCP	Percentual de ICMS relativo ao Fundo de Combate à Pobreza (FCP).	Obrigatório, uma vez	—
pICMS	Alíquota do ICMS	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS10

6 campos

Campo	O que é	Ocorrência	Regras
modBC	Modalidade de determinação da BC do ICMS: 0 - Margem Valor Agregado (%); 1 - Preço médio ponderado ao consumidor (PMPF) 2 - Valor da Operação	Obrigatório, uma vez	—
modBCST	Modalidade de determinação da BC do ICMS ST: 0 - Margem Valor Agregado (%); 1 - Preço médio ponderado ao consumidor (PMPF) 2 - Valor da Operação	Obrigatório, uma vez	—
pFCPST	Percentual de ICMS relativo ao Fundo de Combate à Pobreza (FCP).	Obrigatório, uma vez	—
pICMSST	Alíquota do ICMS ST	Obrigatório, uma vez	—
pMVAST	Percentual da Margem de Valor Adicionado ICMS ST	Opcional, no máximo uma vez	—
vICMSST	Valor do ICMS ST retido	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS20

2 campos

Campo	O que é	Ocorrência	Regras
cBenef	Código de Benefício Fiscal na UF aplicado ao item	Obrigatório, uma vez	—
pRedBC	Percentual de redução da BC	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS51

3 campos

Campo	O que é	Ocorrência	Regras
pDif	Alíquota de diferimento	Obrigatório, uma vez	—
vICMSDif	Valor do ICMS diferido	Obrigatório, uma vez	—
vICMSOp	Valor do ICMS da operação	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS60

11 campos

Campo	O que é	Ocorrência	Regras
pFCPSTRet	Percentual de FCP retido anteriormente por substituição tributária.	Obrigatório, uma vez	—
pICMSEfet	Alíquota do ICMS efetiva.	Obrigatório, uma vez	—
pICMSSTRet	Aliquota suportada pelo consumidor final.	Obrigatório, uma vez	—
pRedBCEfet	Percentual de redução da base de cálculo efetiva.	Obrigatório, uma vez	—
vBCEfet	Valor da base de cálculo efetiva.	Obrigatório, uma vez	—
vBCFCPSTRet	Valor da Base de cálculo do FCP retido anteriormente por ST.	Obrigatório, uma vez	—
vBCSTRet	Valor da BC do ICMS ST retido anteriormente	Obrigatório, uma vez	—
vFCPSTRet	Valor do FCP retido por substituição tributária.	Obrigatório, uma vez	—
vICMSEfet	Valor do ICMS efetivo.	Obrigatório, uma vez	—
vICMSSTRet	Valor do ICMS ST retido anteriormente	Obrigatório, uma vez	—
vICMSSubstituto	Valor do ICMS Próprio do Substituto cobrado em operação anterior	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/imposto/ICMS70

7 campos

Campo	O que é	Ocorrência	Regras
indDeduzDeson	Indica se o valor do ICMS desonerado (vICMSDeson) deduz do valor do item (vProd): 0=Valor do ICMS desonerado (vICMSDeson) não deduz do valor do item…	Opcional, no máximo uma vez	—
motDesICMS	Motivo da desoneração do ICMS:3-Uso na agropecuária;9-Outros;12-Fomento agropecuário	Obrigatório, uma vez	—
motDesICMSST	Motivo da desoneração do ICMS-ST: 3-Uso na agropecuária; 9-Outros; 12-Fomento agropecuário.	Obrigatório, uma vez	—
pRedBCST	Percentual de redução da BC ICMS ST	Opcional, no máximo uma vez	—
vBCFCP	Valor da Base de cálculo do FCP.	Obrigatório, uma vez	—
vBCFCPST	Valor da Base de cálculo do FCP retido por substituição tributária.	Obrigatório, uma vez	—
vICMSSTDeson	Valor do ICMS-ST desonerado.	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/PIS

1 campo

Campo	O que é	Ocorrência	Regras
pPIS	Alíquota do PIS (em percentual)	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/TxReg

2 campos

Campo	O que é	Ocorrência	Regras
pTaxa	Alíquota	Obrigatório, uma vez	—
vTaxa	Valor	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/prod/gMedicao

3 campos

Campo	O que é	Ocorrência	Regras
gMedida	Grupo de medida	Obrigatório, uma vez	—
tpMotNaoLeitura	Tipo Motivo da não leitura	Obrigatório, uma vez	—
xMotNaoLeitura	Detalhamento do motivo da não leitura	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/prod/gPagAntecipado

2 campos

Campo	O que é	Ocorrência	Regras
chDFePagAnt	Chave de acesso da nota de antecipação de pagamento (com tpPagAnt=1 ou 2)	Obrigatório, uma vez	—
nItemPagAnt	Número do item do DFe de antecipação para referência direta a um item	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS

2 campos

Campo	O que é	Ocorrência	Regras
gTribCompraGov	Grupo de informações da composição do valor do IBS e da CBS em compras governamental	Opcional, no máximo uma vez	—
gTribRegular	Grupo de informações da Tributação Regular. Informar como seria a tributação caso não cumprida a condição resolutória/suspensiva. Exemplo 1: Art.…	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/prod/gMedicao/gMedida

1 campo

Campo	O que é	Ocorrência	Regras
vMed	Valor da medição	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gCBS

5 campos

Campo	O que é	Ocorrência	Regras
gALCZFMCBS	Grupo de operações em áreas incentivadas (ALC/ZFM) - CBS (alíquota zero)	Opcional, no máximo uma vez	—
gDevTrib	Grupo de Informações da devolução de tributos	Opcional, no máximo uma vez	—
gDif	Grupo de campos do Diferimento	Opcional, no máximo uma vez	—
gRed	Grupo de campos da redução de aliquota	Opcional, no máximo uma vez	—
pCBS	Aliquota da CBS (em percentual)	Obrigatório, uma vez	326 339 383

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gIBSMun

1 campo

Campo	O que é	Ocorrência	Regras
pIBSMun	Aliquota do IBS Municipal (em percentual)	Obrigatório, uma vez	338 369 347

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gIBSUF

1 campo

Campo	O que é	Ocorrência	Regras
pIBSUF	Aliquota do IBS de competência das UF (em percentual)	Obrigatório, uma vez	337 366 347

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gTribCompraGov

6 campos

Campo	O que é	Ocorrência	Regras
pAliqCBS	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
pAliqIBSMun	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
pAliqIBSUF	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
vTribCBS	Valor que seria devido a CBS, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—
vTribIBSMun	Valor que seria devido ao município, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—
vTribIBSUF	Valor que seria devido a UF, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gTribRegular

8 campos

Campo	O que é	Ocorrência	Regras
cClassTribReg	Informar qual seria o cClassTrib caso não cumprida a condição resolutória/suspensiva	Obrigatório, uma vez	332
CSTReg	Código da Situação Tributária do IBS e CBS	Obrigatório, uma vez	—
pAliqEfetRegCBS	Alíquota da CBS	Obrigatório, uma vez	—
pAliqEfetRegIBSMun	Alíquota do IBS do Município	Obrigatório, uma vez	—
pAliqEfetRegIBSUF	Alíquota do IBS da UF	Obrigatório, uma vez	—
vTribRegCBS	Valor da CBS	Obrigatório, uma vez	—
vTribRegIBSMun	Valor do IBS do Município	Obrigatório, uma vez	—
vTribRegIBSUF	Valor do IBS da UF	Obrigatório, uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gCBS/gDevTrib

1 campo

Campo	O que é	Ocorrência	Regras
pDevTrib	Percentual de devolução do tributo, conforme LC 214/25 art. 118.	Opcional, no máximo uma vez	—

NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gCBS/gRed

2 campos

Campo	O que é	Ocorrência	Regras
pAliqEfet	Aliquota Efetiva que será aplicada a Base de Calculo (em percentual)	Obrigatório, uma vez	390 392 394
pRedAliq	Percentual de redução de aliquota do cClassTrib	Obrigatório, uma vez	—

Perguntas frequentes

Quantos campos tem o XML da NFGas?

O esquema oficial (PL_NFGas_NT2026.004_RTC_1.00), lido pelo Buscador NCM, declara 327 nomes de tag distintos, em 1027 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 896 posições estão no documento em si; as demais são de evento, consulta e retorno do web service.

Onde fica cada tag no XML da NFGas?

No caminho completo a partir do elemento raiz, reconstruído caminhando pela árvore do esquema oficial — não por tabela de manual. O Buscador NCM agrupa os campos pelo grupo em que eles ficam, na ordem em que o arquivo é montado, e a ficha de cada tag mostra todas as posições dela.

O campo da NFGas é o mesmo campo da NF-e?

Não necessariamente, e essa confusão custa caro. O mesmo nome de tag existe em vários documentos fiscais com regras e sentidos diferentes: uTrib na NF-e não é o uTrib do CT-e. Cada ficha lista o mesmo nome nos outros documentos, com a redação e o caminho de cada um — justamente para que a regra de um não seja aplicada ao outro.

Todo campo que aparece no pacote de esquemas da NFGas é um campo da NFGas?

Não. O pacote traz um arquivo de tipos COMPARTILHADO entre os documentos fiscais, e nele viajam grupos que pertencem a outros documentos. O critério do Buscador NCM é alcance: só entra a tag que o caminho alcança a partir do elemento raiz do documento. Tag declarada no pacote e não alcançada não é campo do leiaute dele.