Campos do XML da NFAg: caminho, tamanho e valores

(raiz do arquivo)

12 campos

Campo	O que é	Ocorrência	Regras
consSitNFAg	Schema de validação XML dp Pedido de Consulta da Situação Atual da NFAg.	Obrigatório, uma vez	—
consStatServNFAg	Schema XML de validação do Pedido de Consulta do Status do Serviço NFAg	Obrigatório, uma vez	—
evCancNFAg	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	—
eventoNFAg	Schema XML de validação do Pedido de Registro de Evento da NFAg	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	—
NFAg	Nota Fiscal Eletrônica da Agua	Obrigatório, uma vez	—
nfagProc	NFAg processada	Obrigatório, uma vez	—
retConsSitNFAg	Schema XML de validação do retorno da consulta da situação atual da NFAg.	Obrigatório, uma vez	—
retConsStatServNFAg	Schema XML de validação do Resultado da Consulta do Status do Serviço de NFAg	Obrigatório, uma vez	—
retEventoNFAg	Schema XML de validação do retorno Pedido de Evento da NFAg	Obrigatório, uma vez	—
retNFAg	Schema XML de validação do retorno da NFAg	Obrigatório, uma vez	—

consSitNFAg

1 campo

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

evCancNFAg

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	—

eventoNFAg

1 campo

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

NFAg

2 campos

Campo	O que é	Ocorrência	Regras
infNFAg	Informações da NFAg	Obrigatório, uma vez	—
infNFAgSupl	Informações suplementares da NFAg	Obrigatório, uma vez	—

nfagProc

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	—
protNFAg	Tipo Protocolo de status resultado do processamento da NFAg	Obrigatório, uma vez	—
versao	Versão do leiaute	Obrigatório, uma vez	—

retConsSitNFAg

1 campo

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

retConsStatServNFAg

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	—

eventoNFAg/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	—

NFAg/infNFAg

18 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 VEDADO para tpFat=5	Opcional, no máximo uma vez	—
gFat	Grupo de informações de controle da Fatura Obrigatorio para tpFat 1 e 3 Vedado para tpFat 2	Opcional, no máximo uma vez	—
gFatConjunto	Grupo de Informações do Faturamento conjunto	Opcional, no máximo uma vez	—
gMed	Grupo de informações dos Medidores	0 a 99 vez(es)	—
gQualiAgua	Informações sobre a qualidade de água	Opcional, no máximo uma vez	—
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	—
Id	Identificador da tag a ser assinada	Obrigatório, uma vez	—
ide	Identificação da NFAg	Obrigatório, uma vez	1026 1027 1028 1029
infAdic	Informações Adicionais	Opcional, no máximo uma vez	—
infPAA	Grupo de Informação do Provedor de Assinatura e Autorização	Opcional, no máximo uma vez	—
ligacao	Dados da Ligação Opcional para Faturamento = 5 (Agregador)	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 NFAg	Obrigatório, uma vez	1054

NFAg/infNFAgSupl

1 campo

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

nfagProc/protNFAg

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	—

retEventoNFAg/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	—

eventoNFAg/infEvento/detEvento

1 campo

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

NFAg/infNFAg/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	—

NFAg/infNFAg/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 / acessante	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	—

NFAg/infNFAg/det

9 campos

Campo	O que é	Ocorrência	Regras
chNFAgAnt	Chave de Acesso da NFag anterior	Opcional, no máximo uma vez	242 245 246 250
gAgregadora	Informar para faturamento agregador (5)	Obrigatório, uma vez	—
gProcRef	Grupo Processo referenciado	Opcional, no máximo uma vez	—
gTarif	Grupo de Tarifas por Período	0 a 6 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	—
nItem	Número do item da NFAg	Obrigatório, uma vez	—
nItemAnt	Número do item da NFAg anterior	Opcional, no máximo uma vez	—
prod	Dados do Produto ou Serviço	Obrigatório, uma vez	—

NFAg/infNFAg/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	—

NFAg/infNFAg/gAgencia

8 campos

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

NFAg/infNFAg/gFat

11 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	—
nFat	Número da Fatura	Opcional, no máximo uma vez	—

NFAg/infNFAg/gFatConjunto

1 campo

Campo	O que é	Ocorrência	Regras
chNFAgFat	Chave de acesso da NFAg faturada em conjunto Obrigatorio para tpFat 3 Vedado para tpFat 1 e 2	Obrigatório, uma vez	517 518 519 520

NFAg/infNFAg/gMed

4 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	—
idMedidor	Identificação do medidor	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	—

NFAg/infNFAg/gQualiAgua

5 campos

Campo	O que é	Ocorrência	Regras
CompetAnalise	Ano e mês referência da analise (AAAAMM)	Obrigatório, uma vez	—
Conclusao	Conclusão da Análise	Opcional, no máximo uma vez	—
cProcesso	Legislação aplicada	Opcional, no máximo uma vez	—
gAnalise	Grupo de informações da Análise	1 a 10 vez(es)	—
SistemaAbast	Nome do Sistema de abastecimento	Opcional, no máximo uma vez	—

NFAg/infNFAg/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	—

NFAg/infNFAg/gSub

2 campos

Campo	O que é	Ocorrência	Regras
chNFAg	Chave de acesso da NFAg referenciada	Obrigatório, uma vez	—
motSub	Motivo da substituição	Obrigatório, uma vez	—

NFAg/infNFAg/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	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 NFAg	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	—
finNFAg	Finalidade de emissão da NFAg	Obrigatório, uma vez	411 412 414 206
gCompraGov	Grupo de Compras Governamentais	Opcional, no máximo uma vez	—
mod	Modelo da NFAg	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 NFAg	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 NFAg 1 - Faturamento Normal; 2 - Faturamento por terceiro; 3 - Faturamento conjunto 4 - Faturamento Agregado 5 - Faturamento…	Obrigatório, uma vez	527 515 532 516
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	—

NFAg/infNFAg/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)	—

NFAg/infNFAg/infPAA

1 campo

Campo	O que é	Ocorrência	Regras
CNPJPAA	CNPJ do Provedor de Assinatura e Autorização CNPJ da empresa que emitirá a nota do tipo faturamento 1 em nome de outra empresa	Obrigatório, uma vez	—

NFAg/infNFAg/ligacao

6 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	—
idLigacao	Código único de Identificação da Ligaçã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	—
tpLigacao	Tipo de Ligação	Obrigatório, uma vez	—

NFAg/infNFAg/pgtoVinc

1 campo

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

NFAg/infNFAg/total

10 campos

Campo	O que é	Ocorrência	Regras
IBSCBSTot	Totais de IBS e CBS	Obrigatório, uma vez	—
vCOFINS	Valor do COFINS	Obrigatório, uma vez	—
vNF	Valor Total da NF-e	Obrigatório, uma vez	—
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	—
vTFS	Valor TFS	Obrigatório, uma vez	—
vTFU	Valor TFU	Obrigatório, uma vez	—
vTotDFe	Valor total do documento fiscal (vNF)	Obrigatório, uma vez	—

nfagProc/protNFAg/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	—

nfagProc/protNFAg/infProt

6 campos

Campo	O que é	Ocorrência	Regras
cStat	Código do status da NFAg	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 NFAg processado. Utilizado para conferir a integridade da NFAg original.	Opcional, no máximo uma vez	—
nProt	Número do Protocolo de Status da NFAg.	Opcional, no máximo uma vez	—
verAplic	Versão do Aplicativo que processou a NFAg	Obrigatório, uma vez	—
xMotivo	Descrição literal do status da NFAg	Obrigatório, uma vez	—

NFAg/infNFAg/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	—

NFAg/infNFAg/det/gAgregadora

1 campo

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

NFAg/infNFAg/det/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

NFAg/infNFAg/det/gTarif

5 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	Opcional, no máximo uma vez	—

NFAg/infNFAg/det/imposto

6 campos

Campo	O que é	Ocorrência	Regras
COFINS	Dados do COFINS	Opcional, no máximo uma vez	—
IBSCBS	Grupo de informações do IBS e CBS	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	—
TFS	Taxa de Fiscalização de Serviço	Opcional, no máximo uma vez	—
TFU	Taxa de Fiscalização de Uso	Opcional, no máximo uma vez	—

NFAg/infNFAg/det/prod

11 campos

Campo	O que é	Ocorrência	Regras
cProd	Código do produto ou serviço.	Obrigatório, uma vez	—
fatorPoluicao	Fator de poluição	Opcional, no máximo uma vez	435
gMedicao	Grupo para referenciar qual medição e medida estão relacionadas ao item	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	—
qEconomias	Quantidade de economias	Opcional, no máximo uma vez	—
tpCategoria	Categoria da ligação	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	—
xCategoria	Detalhamento da Categoria	Opcional, no máximo uma vez	—
xProd	Descrição do produto ou serviço	Obrigatório, uma vez	—

NFAg/infNFAg/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	—

NFAg/infNFAg/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	—

NFAg/infNFAg/gQualiAgua/gAnalise

7 campos

Campo	O que é	Ocorrência	Regras
nAmostraAnalisada	Número de amostra analisada	Opcional, no máximo uma vez	—
nAmostraDPadrao	Número de amostra dentro do padrão	Opcional, no máximo uma vez	—
nAmostraFPadrao	Número de amostra fora do padrão	Opcional, no máximo uma vez	—
nAmostraMinima	Número de amostra minima	Opcional, no máximo uma vez	—
nMediaMensal	Media mensal dos valores da analise	Opcional, no máximo uma vez	—
xItemAnalisado	Nome do item analisado	Obrigatório, uma vez	—
xValorReferencia	Valor de referência	Opcional, no máximo uma vez	—

NFAg/infNFAg/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	—

NFAg/infNFAg/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	—

NFAg/infNFAg/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	—

NFAg/infNFAg/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	—

NFAg/infNFAg/det/gProcRef/gIBSCBS

4 campos

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

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/imposto/PIS

1 campo

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

NFAg/infNFAg/det/imposto/TFS

2 campos

Campo	O que é	Ocorrência	Regras
pTFS	Alíquota do TFS	Obrigatório, uma vez	—
vBCTFS	Valor BC TFS	Obrigatório, uma vez	—

NFAg/infNFAg/det/imposto/TFU

2 campos

Campo	O que é	Ocorrência	Regras
pTFU	Alíquota do TFU	Obrigatório, uma vez	—
vBCTFU	Valor BC TFU	Obrigatório, uma vez	—

NFAg/infNFAg/det/prod/gMedicao

2 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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/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	—
volFat	Volume Faturado	Obrigatório, uma vez	—

NFAg/infNFAg/total/IBSCBSTot/gCBS

2 campos

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

NFAg/infNFAg/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	—

NFAg/infNFAg/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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/prod/gMedicao/gMedida

7 campos

Campo	O que é	Ocorrência	Regras
nUnidConsumo	Número da unidade de consumo	Opcional, no máximo uma vez	—
tpGrMed	Tipo de grandeza medida	Obrigatório, uma vez	—
vConst	Indicar o fator de multiplicação do medidor	Opcional, no máximo uma vez	—
vMed	Valor da medição	Obrigatório, uma vez	—
vMedAnt	Valor da medição (leitura) anterior	Obrigatório, uma vez	—
vMedAtu	Valor da medição (leitura) atual	Obrigatório, uma vez	—
vUnidConsumo	Volume por unidade de consumo em m3	Opcional, no máximo uma vez	—

NFAg/infNFAg/det/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	347 326

NFAg/infNFAg/det/imposto/IBSCBS/gIBSCBS/gIBSMun

1 campo

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

NFAg/infNFAg/det/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	347

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/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	—

NFAg/infNFAg/det/imposto/IBSCBS/gIBSCBS/gCBS/gDif

1 campo

Campo	O que é	Ocorrência	Regras
pDif	Percentual do diferimento	Obrigatório, uma vez	—

NFAg/infNFAg/det/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 NFAg?

O esquema oficial (PL_NFAg_NT2026.004_RTC_1.00_correcao), lido pelo Buscador NCM, declara 288 nomes de tag distintos, em 835 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 700 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 NFAg?

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 NFAg é 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 NFAg é um campo da NFAg?

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.