Campos do XML da NF3e: caminho, tamanho e valores

(raiz do arquivo)

14 campos

Campo	O que é	Ocorrência	Regras
consReciNF3e	Schema XML de validação do Pedido de Consulta de NF-3e	Obrigatório, uma vez	—
consSitNF3e	Schema de validação XML dp Pedido de Consulta da Situação Atual da NF-3e.	Obrigatório, uma vez	—
consStatServNF3e	Schema XML de validação do Pedido de Consulta do Status do Serviço NF-3e	Obrigatório, uma vez	—
evCancNF3e	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	—
eventoNF3e	Schema XML de validação do Pedido de Registro de Evento da NF-3e	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	—
NF3e	Nota Fiscal Eletrônica de Energia Elétrica	Obrigatório, uma vez	—
nf3eProc	NF-3e processada	Obrigatório, uma vez	—
retConsReciNF3e	Schema XML de validação do retorno do Pedido de Consulta da NF-3e	Obrigatório, uma vez	—
retConsSitNF3e	Schema XML de validação do retorno da consulta da situação atual da NF-3e.	Obrigatório, uma vez	—
retConsStatServNF3e	Schema XML de validação do Resultado da Consulta do Status do Serviço de NF-3e	Obrigatório, uma vez	—
retEventoNF3e	Schema XML de validação do retorno Pedido de Evento da NF-3e	Obrigatório, uma vez	—
retNF3e	Schema XML de validação do retorno do BP-e	Obrigatório, uma vez	—

consReciNF3e

1 campo

Campo	O que é	Ocorrência	Regras
nRec	Número do Recibo do arquivo a ser consultado	Obrigatório, uma vez	—

consSitNF3e

1 campo

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

evCancNF3e

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	—

eventoNF3e

1 campo

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

NF3e

2 campos

Campo	O que é	Ocorrência	Regras
infNF3e	Informações da NF3e	Obrigatório, uma vez	—
infNF3eSupl	Informações suplementares da NF3e	Obrigatório, uma vez	—

nf3eProc

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	—
protNF3e	Tipo Protocolo de status resultado do processamento da NF3e (Modelo 66)	Obrigatório, uma vez	—
versao	Versão do leiaute	Obrigatório, uma vez	—

retConsSitNF3e

1 campo

Campo	O que é	Ocorrência	Regras
procEventoNF3e	Pedido de Registro de Evento de NF-3e processado	Opcional, quantas vezes precisar	—

retConsStatServNF3e

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	—

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

NF3e/infNF3e

18 campos

Campo	O que é	Ocorrência	Regras
acessante	Dados do acessante	Obrigatório, uma vez	—
autXML	Autorizados para download do XML do DF-e	0 a 10 vez(es)	—
dest	Identificação do destinatário / acessante	Obrigatório, uma vez	—
emit	Identificação do Emitente do documento fiscal	Obrigatório, uma vez	—
gANEEL	Grupo de informações da Agência Nacional de Energia Eletrica	Obrigatório, uma vez	—
gFat	Grupo de informações de controle da Fatura	Obrigatório, uma vez	—
gGrContrat	Grupo de informações das quantidades contratadas	0 a 20 vez(es)	—
gJudic	Grupo de informações para referenciar a NF3e original que foi separada judicialmente	Opcional, no máximo uma vez	—
gMed	Grupo de informações dos Medidores	0 a 20 vez(es)	—
gRespTec	Informações do Responsável Técnico pela emissão do DF-e	Opcional, no máximo uma vez	—
gSCEE	Grupo dos dados do Sistema de Compensação de Energia Elétrica	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 NF3e	Obrigatório, uma vez	1026 1027 1028 1029
infAdic	Informações Adicionais	Opcional, no máximo uma vez	—
NFdet	Detalhamento de Produtos e Serviços	1 a 13 vez(es)	—
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 NF3e	Obrigatório, uma vez	1054

NF3e/infNF3eSupl

1 campo

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

nf3eProc/protNF3e

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	—

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

eventoNF3e/infEvento/detEvento

1 campo

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

NF3e/infNF3e/acessante

12 campos

Campo	O que é	Ocorrência	Regras
codRoteiroLeitura	Roteiro da Leitura para uso operacional	Opcional, no máximo uma vez	—
idAcesso	Código único de Identificação da Unidade Consumidora ou Ponto de Acesso adotado pela distribuidora.	Obrigatório, uma vez	—
idCodCliente	Código de Identificação do Cliente para empresa emitente	Opcional, no máximo 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	—
tpAcesso	Tipo de Acessante	Obrigatório, uma vez	474 409
tpClasse	Classe de Consumo da Unidade Consumidora	Opcional, no máximo uma vez	687 689 474
tpFase	Tipo de ligação	Obrigatório, uma vez	—
tpGrpTensao	Grupo e Subgrupo de Tensão	Obrigatório, uma vez	—
tpModTar	Modalidade Tarifária	Obrigatório, uma vez	—
tpSubClasse	Subclasse de Consumo da Unidade Consumidora	Opcional, no máximo uma vez	425 686 687 474
xNomeUC	Nome da Unidade Consumidora	Opcional, no máximo uma vez	—

NF3e/infNF3e/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	—

NF3e/infNF3e/dest

9 campos

Campo	O que é	Ocorrência	Regras
cNIS	Número da Identificação Social - NIS	Obrigatório, uma vez	686 689
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 / acessante	Opcional, no máximo uma vez	—
IM	Inscrição Municipal	Opcional, no máximo uma vez	—
indIEDest	Indicador da IE do Destinatário/Acessante	Obrigatório, uma vez	—
NB	Número do Benefício	Obrigatório, uma vez	687 688
xNome	Razão social ou Nome do destinatário / acessante	Obrigatório, uma vez	—
xNomeAdicional	Nome de destinatário adicional	Opcional, no máximo uma vez	—

NF3e/infNF3e/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	—

NF3e/infNF3e/gANEEL

1 campo

Campo	O que é	Ocorrência	Regras
gHistFat	Histórico de Faturamento	1 a 5 vez(es)	—

NF3e/infNF3e/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	—

NF3e/infNF3e/gGrContrat

4 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	441 442
qUnidContrat	Quantidade Contratada em kW ou kWh	Obrigatório, uma vez	—
tpGrContrat	Tipo de grandeza contratada	Obrigatório, uma vez	409
tpPosTar	Tipo de Posto Tarifário Contratado	Obrigatório, uma vez	—

NF3e/infNF3e/gJudic

1 campo

Campo	O que é	Ocorrência	Regras
chNF3e	Chave de acesso da NF3e referenciada	Obrigatório, uma vez	—

NF3e/infNF3e/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	—

NF3e/infNF3e/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	476
idCSRT	Identificador do código de segurança do responsável técnico	Obrigatório, uma vez	476
xContato	Nome da pessoa a ser contatada	Obrigatório, uma vez	—

NF3e/infNF3e/gSCEE

4 campos

Campo	O que é	Ocorrência	Regras
gConsumidor	Participação no SCEE como Consumidor	Obrigatório, 1 vez(es) ou mais	—
gSaldoCred	Saldos de Créditos por posto tarifário	1 a 3 vez(es)	—
gTipoSaldo	Agrupador de Saldos para registros de múltiplos saldos por posto tarifário	1 a 10 vez(es)	—
tpPartComp	Tipo de participação no sistema de compensação de energia elétrica	Obrigatório, uma vez	—

NF3e/infNF3e/gSub

2 campos

Campo	O que é	Ocorrência	Regras
gNF	Informação da NF modelo 06 referenciada	Obrigatório, uma vez	—
motSub	Motivo da substituição	Obrigatório, uma vez	413

NF3e/infNF3e/ide

17 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 NF3e	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	—
finNF3e	Finalidade de emissão da NF3e	Obrigatório, uma vez	411 477 412 413
gCompraGov	Grupo de Compras Governamentais	Opcional, no máximo uma vez	—
mod	Modelo da NF3e	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 NF3e	Obrigatório, uma vez	—
serie	Série do documento fiscal	Obrigatório, uma vez	—
tpAmb	Tipo do Ambiente	Obrigatório, uma vez	252 643
tpEmis	Forma de emissão do Documento Fiscal	Obrigatório, uma vez	416 418 419 228
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	—

NF3e/infNF3e/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)	—

NF3e/infNF3e/NFdet

3 campos

Campo	O que é	Ocorrência	Regras
chNF3eAnt	Chave de Acesso da NF3e anterior	Opcional, no máximo uma vez	241 242 245 246
det	Detalhamento de Produtos e Serviços	1 a 990 vez(es)	—
mod6HashAnt	HashCode da Modelo 6 Anterior	Opcional, no máximo uma vez	—

NF3e/infNF3e/pgtoVinc

1 campo

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

NF3e/infNF3e/total

11 campos

Campo	O que é	Ocorrência	Regras
IBSCBSTot	Totais de IBS e CBS	Opcional, no máximo uma vez	—
ICMSTot	Totais referentes ao ICMS	Obrigatório, uma vez	—
vCOFINS	Valor do COFINS	Obrigatório, uma vez	270
vCOFINSEfet	Total do Valor Efetivo do COFINS	Obrigatório, uma vez	488
vNF	Valor Total da NF-e	Obrigatório, uma vez	463
vPIS	Valor do PIS	Obrigatório, uma vez	269
vPISEfet	Total do Valor Efetivo do PIS	Obrigatório, uma vez	487
vProd	Valor Total dos produtos e serviços	Obrigatório, uma vez	264 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)	Opcional, no máximo uma vez	—

nf3eProc/protNF3e/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	—

nf3eProc/protNF3e/infProt

6 campos

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

NF3e/infNF3e/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	—

NF3e/infNF3e/gANEEL/gHistFat

2 campos

Campo	O que é	Ocorrência	Regras
gGrandFat	Grandezas faturadas	13 a 13 vez(es)	—
xGrandFat	Nome da grandeza faturada para exibição	Obrigatório, uma vez	—

NF3e/infNF3e/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	—

NF3e/infNF3e/gSCEE/gConsumidor

6 campos

Campo	O que é	Ocorrência	Regras
enerAloc	Energia alocada	Obrigatório, uma vez	—
enerInjet	Energia injetada	Obrigatório, uma vez	—
idAcessGer	Código Único de identificação da unidade geradora	Obrigatório, uma vez	—
tpFonteEnergia	Tipo da fonte de energia	Obrigatório, uma vez	—
tpPosTarInjet	Tipo de Posto Tarifário Energia injetada	Obrigatório, uma vez	—
vPotInst	Potência instalada da micro ou minigeraçao em kW	Obrigatório, uma vez	—

NF3e/infNF3e/gSCEE/gSaldoCred

5 campos

Campo	O que é	Ocorrência	Regras
CompetExpirar	Ciclo de faturamento em que ocorrerá a expiração (AAAAMM)	Obrigatório, uma vez	410
vCredExpirado	Créditos Expirados	Obrigatório, uma vez	—
vCredExpirar	Créditos a Expirar	Obrigatório, uma vez	410
vSaldAnt	Saldo Anterior de Créditos em kWh	Obrigatório, uma vez	—
vSaldAtual	Saldo Atual de Créditos em kWh	Obrigatório, uma vez	410

NF3e/infNF3e/gSCEE/gTipoSaldo

1 campo

Campo	O que é	Ocorrência	Regras
nTipoSaldo	Número referente ao agrupador de saldos por posto tarifário	Obrigatório, uma vez	—

NF3e/infNF3e/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 mod. 06 (AAAAMM)	Obrigatório, uma vez	—
hash115	Hash do registro no arquivo do convênio 115	Opcional, no máximo uma vez	—

NF3e/infNF3e/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	—

NF3e/infNF3e/NFdet/det

4 campos

Campo	O que é	Ocorrência	Regras
detItem	Grupo de informações referentes a item da NF3e	Obrigatório, uma vez	—
detItemAnt	Grupo de informações referentes a item da NF3e anterior	Obrigatório, uma vez	261 262
gAjusteNF3eAnt	Grupo de identificação do ajuste do item de NF3e anterior	Opcional, no máximo uma vez	—
nItem	Número do item da NF3e	Obrigatório, uma vez	260

NF3e/infNF3e/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	—

NF3e/infNF3e/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	—

NF3e/infNF3e/total/ICMSTot

7 campos

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

NF3e/infNF3e/total/vRetTribTot

4 campos

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

NF3e/infNF3e/gANEEL/gHistFat/gGrandFat

3 campos

Campo	O que é	Ocorrência	Regras
qtdDias	Quantidade de dias de medição	Obrigatório, uma vez	—
uMed	Unidade Básica de Medida	Obrigatório, uma vez	—
vFat	Valor Faturado	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem

8 campos

Campo	O que é	Ocorrência	Regras
gAdBand	Grupo de Adicional de Bandeira	0 a 3 vez(es)	—
gContab	Grupo de Informações Contábeis	0 a 99 vez(es)	—
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	—
nItemAnt	Número do item da NF3e anterior que este item está substituindo. Deve sempre existir um detItemAnt que corresponda	Opcional, no máximo uma vez	—
prod	Dados do Produto ou Serviço	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItemAnt

7 campos

Campo	O que é	Ocorrência	Regras
cClass	Código de classificação	Obrigatório, uma vez	265 276 277 279
indDevolucao	Indicador de devolução do valor do item	Opcional, no máximo uma vez	278
pICMS	Alíquota do ICMS	Opcional, no máximo uma vez	267
qFaturada	Quantidade Faturada	Obrigatório, uma vez	263 435
retTrib	Grupo de informações de retenção de tributos federais do item anterior	Opcional, no máximo uma vez	—
vICMSST	Valor do ICMS ST retido	Opcional, no máximo uma vez	485
vItem	Valor unitário do item	Obrigatório, uma vez	435

NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt

2 campos

Campo	O que é	Ocorrência	Regras
motAjuste	Motivo do Ajuste	Obrigatório, uma vez	638
tpAjuste	Tipo de ajuste a ser aplicado ao item	Obrigatório, uma vez	258 259 260

NF3e/infNF3e/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	—

NF3e/infNF3e/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	—

NF3e/infNF3e/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	—

NF3e/infNF3e/NFdet/det/detItem/gAdBand

6 campos

Campo	O que é	Ocorrência	Regras
dFimAdBand	Data de fim da aplicação do adicional	Obrigatório, uma vez	—
dIniAdBand	Data de início da aplicação do adicional	Obrigatório, uma vez	—
motDifBand	Motivo da diferença do adicional aplicado	Obrigatório, uma vez	—
tpBand	Tipo da bandeira tarifária	Obrigatório, uma vez	—
vAdBand	Valor do Adicional tarifário	Obrigatório, uma vez	—
vAdBandAplic	Valor do adicional tarifário aplicado	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/gContab

4 campos

Campo	O que é	Ocorrência	Regras
cContab	Número da Conta Contábil do lançamento	Obrigatório, uma vez	—
tpLanc	Tipo de lançamento contábil	Obrigatório, uma vez	446
vContab	Valor do lançamento na conta contábil	Obrigatório, uma vez	—
xContab	Descrição da conta contábil	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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)	—
pFCP	Percentual de ICMS relativo ao Fundo de Combate à Pobreza (FCP).	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	—

NF3e/infNF3e/NFdet/det/detItem/gTarif

10 campos

Campo	O que é	Ocorrência	Regras
anoAto	Ano do Ato da ANEEL (AAAA)	Obrigatório, uma vez	—
cPosTarif	Tipo de posto tarifário	Obrigatório, uma vez	436
dFimTarif	Data de fim da aplicação da tarifa	Obrigatório, uma vez	—
dIniTarif	Data de início da aplicação da tarifa	Obrigatório, uma vez	—
motDifTarif	Motivo da diferença de tarifa aplicada com a homologada	Obrigatório, uma vez	—
nAto	Número do Ato da ANEEL	Obrigatório, uma vez	—
tpAto	Tipo de Ato da ANEEL	Obrigatório, uma vez	—
tpTarif	Tarifa de aplicação	Obrigatório, uma vez	—
vTarifAplic	Valor da tarifa aplicada	Obrigatório, uma vez	—
vTarifHom	Valor da tarifa homologada pela ANEEL	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/imposto

14 campos

Campo	O que é	Ocorrência	Regras
COFINS	Dados do COFINS	Opcional, no máximo uma vez	—
COFINSEfet	Dados do COFINS Efetivo	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	Opcional, no máximo 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	—
ICMS90	ICMS Outros	Obrigatório, uma vez	—
indSemCST	Sem Situação Tributária para o ICMS	Obrigatório, uma vez	—
PIS	Dados do PIS	Opcional, no máximo uma vez	—
PISEfet	Dados do PIS Efetivo	Opcional, no máximo uma vez	—

NF3e/infNF3e/NFdet/det/detItem/prod

8 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	—
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	442 443
indPrecoACL	Preço ACL	Opcional, no máximo uma vez	438 439
vItemLiq	Valor unitário do item sem tributos	Obrigatório, uma vez	—
xProd	Descrição do produto ou serviço	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItemAnt/retTrib

1 campo

Campo	O que é	Ocorrência	Regras
vBCIRRF	Base de cálculo do IRRF	Obrigatório, uma vez	—

NF3e/infNF3e/total/IBSCBSTot/gIBS/gIBSMun

1 campo

Campo	O que é	Ocorrência	Regras
vIBSMun	Valor total do IBS Municipal	Obrigatório, uma vez	—

NF3e/infNF3e/total/IBSCBSTot/gIBS/gIBSUF

1 campo

Campo	O que é	Ocorrência	Regras
vIBSUF	Valor total do IBS Estadual	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/imposto/COFINSEfet

2 campos

Campo	O que é	Ocorrência	Regras
pCOFINSEfet	Alíquota Efetiva do COFINS (em percentual)	Obrigatório, uma vez	—
vBCCOFINSEfet	Valor da BC do COFINS efetivo	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	Indica se a operação é de doação	Opcional, no máximo uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/imposto/PIS

1 campo

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

NF3e/infNF3e/NFdet/det/detItem/imposto/PISEfet

2 campos

Campo	O que é	Ocorrência	Regras
pPISEfet	Alíquota efetiva do PIS (em percentual)	Obrigatório, uma vez	—
vBCPISEfet	Valor da BC do PIS efetivo	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/prod/gMedicao/gMedida

8 campos

Campo	O que é	Ocorrência	Regras
pPerdaTran	Perda de Transformação(percentual)	Obrigatório, uma vez	—
tpGrMed	Tipo de grandeza medida	Obrigatório, uma vez	—
vConst	Indicar o fator de multiplicação do medidor	Obrigatório, 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	—
vMedPerdaTec	Valor medido após perda técnica	Opcional, no máximo uma vez	—
vMedPerdaTran	Valor medido após perda de transformação	Obrigatório, uma vez	—

NF3e/infNF3e/NFdet/det/detItem/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 347

NF3e/infNF3e/NFdet/det/detItem/imposto/IBSCBS/gIBSCBS/gIBSMun

1 campo

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

NF3e/infNF3e/NFdet/det/detItem/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

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/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	—

NF3e/infNF3e/NFdet/det/detItem/imposto/IBSCBS/gIBSCBS/gCBS/gDif

1 campo

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

NF3e/infNF3e/NFdet/det/detItem/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 NF3e?

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

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

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.