Tags XML da NF-e: tabela completa dos campos do XML

A NF-e, Nota Fiscal Eletrônica modelo 55, não é apenas um documento fiscal em formato digital. Na prática, ela é um arquivo XML estruturado, assinado digitalmente, autorizado pela SEFAZ e utilizado como base para escrituração fiscal, integração com ERP, conferência de mercadorias, auditoria de impostos, recuperação de documentos e cruzamentos do SPED.

Cada informação da nota fiscal fica dentro de uma tag XML. Essas tags identificam dados como emitente, destinatário, produtos, CFOP, NCM, CST, CSOSN, ICMS, IPI, PIS, COFINS, IBS, CBS, transporte, pagamento, totais e protocolo de autorização.

Neste guia, você encontrará uma tabela ampla das principais tags do XML da NF-e, organizada por grupos, com explicação prática da função de cada bloco.

Importante: a presença de cada tag depende da operação fiscal, do regime tributário, da finalidade da NF-e, do CST/CSOSN, da UF, do tipo de produto, da existência de transporte, pagamento, importação, exportação, substituição tributária, Simples Nacional, combustíveis, medicamentos, armas, cana-de-açúcar, Reforma Tributária e das regras de validação vigentes da SEFAZ.

A Receita Federal publicou exemplo oficial de XML de NF-e em versão 4.00, com raiz nfeProc, referência ao schema procNFe_v4.00.xsd, grupos ide, emit, dest, det, prod, imposto, IBSCBS, total, transp, pag, infAdic, infRespTec, assinatura digital e protocolo de autorização.


O que é uma tag XML da NF-e?

Uma tag XML é um campo estruturado dentro do arquivo da NF-e.

Exemplo:

<CFOP>5102</CFOP>
<NCM>84713012</NCM>
<CST>00</CST>
<vNF>1250.00</vNF>

Cada tag tem uma finalidade específica:

TagSignificado prático
CFOPCódigo Fiscal de Operações e Prestações
NCMClassificação fiscal da mercadoria
CSTCódigo de Situação Tributária
CSOSNCódigo de Situação da Operação no Simples Nacional
vNFValor total da NF-e
vICMSValor do ICMS
vPISValor do PIS
vCOFINSValor da COFINS
cClassTribCódigo de classificação tributária ligado à Reforma Tributária

Diferença entre tag XML, campo do DANFE e informação fiscal

Um erro muito comum é confundir campo visual do DANFE com tag real do XML.

O DANFE é apenas a representação gráfica da NF-e. O documento fiscal com validade jurídica é o XML autorizado.

Exemplo:

InformaçãoAparece no XML?Observação
CNPJ do emitenteSimTag emit/CNPJ
Nome do destinatárioSimTag dest/xNome
CFOP do itemSimTag det/prod/CFOP
NCM do produtoSimTag det/prod/NCM
Logo da empresa no DANFENão necessariamenteGeralmente é configuração do sistema emissor
Código de barras impresso no DANFENão é a tag fiscal principalÉ representação da chave de acesso
Tarja “NF-e Cancelada”Não é tag da NF-e originalEstá ligada ao evento de cancelamento

Por isso, quando uma empresa deseja auditar NF-e, integrar XML ao ERP ou recuperar documentos fiscais, ela deve trabalhar com o arquivo XML autorizado, e não apenas com o DANFE em PDF.


Estrutura principal do XML da NF-e

A NF-e autorizada normalmente aparece dentro da estrutura nfeProc, que reúne a nota fiscal, a assinatura e o protocolo de autorização.

<nfeProc versao="4.00">
  <NFe>
    <infNFe>
      <ide>...</ide>
      <emit>...</emit>
      <dest>...</dest>
      <det>...</det>
      <total>...</total>
      <transp>...</transp>
      <pag>...</pag>
      <infAdic>...</infAdic>
    </infNFe>
    <Signature>...</Signature>
  </NFe>
  <protNFe>
    <infProt>...</infProt>
  </protNFe>
</nfeProc>

Tabela geral das tags do XML da NF-e

A seguir, veja os principais grupos e tags da NF-e modelo 55.


1. Grupo raiz da NF-e autorizada

Caminho/tagFunção
nfeProcGrupo raiz do XML processado/autorizado
nfeProc/@versaoVersão do leiaute da NF-e
NFeGrupo que contém a NF-e propriamente dita
infNFeGrupo principal das informações da NF-e
infNFe/@IdIdentificador da NF-e, formado pela chave de acesso
infNFe/@versaoVersão do leiaute
protNFeGrupo do protocolo de autorização
infProtInformações do protocolo retornado pela SEFAZ
SignatureAssinatura digital do XML

2. Grupo ide — identificação da NF-e

O grupo ide identifica a operação fiscal: UF, número da NF-e, série, emissão, finalidade, ambiente, tipo de emissão e presença do comprador.

TagFunção
ideGrupo de identificação da NF-e
cUFCódigo da UF do emitente
cNFCódigo numérico que compõe a chave de acesso
natOpNatureza da operação
modModelo do documento fiscal, normalmente 55 para NF-e
serieSérie da NF-e
nNFNúmero da NF-e
dhEmiData e hora de emissão
dhSaiEntData e hora de saída ou entrada
tpNFTipo da operação: entrada ou saída
idDestIdentificador do destino da operação: interna, interestadual ou exterior
cMunFGCódigo IBGE do município de ocorrência do fato gerador
tpImpFormato de impressão do DANFE
tpEmisTipo de emissão
cDVDígito verificador da chave de acesso
tpAmbAmbiente: produção ou homologação
finNFeFinalidade da NF-e
indFinalIndica se a operação é destinada a consumidor final
indPresIndicador de presença do comprador
indIntermedIndicador de operação com intermediador ou marketplace
procEmiProcesso de emissão
verProcVersão do aplicativo emissor
dhContData e hora de entrada em contingência
xJustJustificativa da contingência

Atenção fiscal

O grupo ide é um dos mais importantes para auditoria. Uma inconsistência em tpNF, idDest, finNFe, indFinal ou indPres pode afetar CFOP, tributação, partilha, DIFAL, escrituração e análise de operação.


3. Grupo NFref — documentos fiscais referenciados

Esse grupo aparece quando a NF-e referencia outro documento fiscal, como devolução, complemento, remessa, retorno, ajuste, exportação ou operação vinculada.

TagFunção
NFrefGrupo de documentos referenciados
refNFeChave de acesso de NF-e referenciada
refCTeChave de acesso de CT-e referenciado
refNFGrupo de nota fiscal modelo 1 ou 1A referenciada
refNF/cUFUF da nota referenciada
refNF/AAMMAno e mês da emissão
refNF/CNPJCNPJ do emitente da nota referenciada
refNF/modModelo do documento referenciado
refNF/serieSérie do documento
refNF/nNFNúmero da nota referenciada
refNFPGrupo de nota fiscal de produtor referenciada
refNFP/cUFUF do produtor
refNFP/AAMMAno e mês da emissão
refNFP/CNPJCNPJ do produtor
refNFP/CPFCPF do produtor
refNFP/IEInscrição Estadual do produtor
refNFP/modModelo do documento
refNFP/serieSérie
refNFP/nNFNúmero
refECFGrupo de cupom fiscal referenciado
refECF/modModelo do ECF
refECF/nECFNúmero de ordem sequencial do ECF
refECF/nCOONúmero do contador de ordem de operação

Exemplo prático

Em uma NF-e de devolução, a chave da nota original deve ser informada em NFref/refNFe. Sem essa referência, a operação pode ficar inconsistente para o destinatário, para o SPED e para uma futura auditoria fiscal.


4. Grupo emit — dados do emitente

TagFunção
emitGrupo do emitente da NF-e
CNPJCNPJ do emitente
CPFCPF do emitente, quando aplicável
xNomeRazão social ou nome do emitente
xFantNome fantasia
enderEmitGrupo de endereço do emitente
xLgrLogradouro
nroNúmero
xCplComplemento
xBairroBairro
cMunCódigo IBGE do município
xMunNome do município
UFUnidade da Federação
CEPCEP
cPaisCódigo do país
xPaisNome do país
foneTelefone
IEInscrição Estadual
IESTInscrição Estadual do substituto tributário
IMInscrição Municipal
CNAECNAE fiscal
CRTCódigo de Regime Tributário

Atenção fiscal

A tag CRT é decisiva para separar empresa do Simples Nacional de empresa em Regime Normal. Ela influencia a validação de ICMS, CST, CSOSN e o grupo tributário que deve ser usado no XML.


5. Grupo avulsa — NF-e avulsa

Esse grupo aparece em situações específicas de emissão avulsa, geralmente associadas ao fisco.

TagFunção
avulsaGrupo de emissão avulsa
CNPJCNPJ do órgão emitente
xOrgaoÓrgão emissor
matrMatrícula do agente
xAgenteNome do agente
foneTelefone
UFUF
nDARNúmero do documento de arrecadação
dEmiData de emissão
vDARValor do documento de arrecadação
repEmiRepartição fiscal emitente
dPagData de pagamento

6. Grupo dest — dados do destinatário

TagFunção
destGrupo do destinatário
CNPJCNPJ do destinatário
CPFCPF do destinatário
idEstrangeiroIdentificação do destinatário estrangeiro
xNomeNome ou razão social do destinatário
enderDestGrupo de endereço do destinatário
xLgrLogradouro
nroNúmero
xCplComplemento
xBairroBairro
cMunCódigo IBGE do município
xMunNome do município
UFUnidade da Federação
CEPCEP
cPaisCódigo do país
xPaisNome do país
foneTelefone
indIEDestIndicador da Inscrição Estadual do destinatário
IEInscrição Estadual
ISUFInscrição na SUFRAMA
IMInscrição Municipal
emailE-mail do destinatário

Atenção fiscal

A tag indIEDest merece atenção. Ela indica se o destinatário é contribuinte do ICMS, contribuinte isento ou não contribuinte. Esse campo pode impactar operações interestaduais, consumidor final, DIFAL e validações da SEFAZ.


7. Grupo retirada — local de retirada

TagFunção
retiradaGrupo do local de retirada da mercadoria
CNPJCNPJ do local de retirada
CPFCPF do local de retirada
xNomeNome ou razão social do local
xLgrLogradouro
nroNúmero
xCplComplemento
xBairroBairro
cMunCódigo IBGE do município
xMunNome do município
UFUnidade da Federação
CEPCEP
cPaisCódigo do país
xPaisNome do país
foneTelefone
emailE-mail
IEInscrição Estadual

Esse grupo é comum em operações com armazém, depósito fechado, operador logístico ou retirada em local diferente do emitente.


8. Grupo entrega — local de entrega

TagFunção
entregaGrupo do local de entrega
CNPJCNPJ do local de entrega
CPFCPF do local de entrega
xNomeNome ou razão social
xLgrLogradouro
nroNúmero
xCplComplemento
xBairroBairro
cMunCódigo IBGE do município
xMunNome do município
UFUnidade da Federação
CEPCEP
cPaisCódigo do país
xPaisNome do país
foneTelefone
emailE-mail
IEInscrição Estadual

9. Grupo autXML — pessoas autorizadas a acessar o XML

TagFunção
autXMLGrupo de autorização de acesso ao XML
CNPJCNPJ autorizado a acessar o XML
CPFCPF autorizado a acessar o XML

Esse grupo é muito usado para autorizar contador, transportador, operador logístico, software fiscal ou outra empresa a consultar o XML da NF-e.


10. Grupo det — itens da NF-e

Cada item da NF-e fica dentro de um grupo det.

TagFunção
detGrupo do item da NF-e
det/@nItemNúmero sequencial do item
prodGrupo de dados do produto ou mercadoria
impostoGrupo de impostos do item
infAdProdInformação adicional do produto

11. Grupo prod — dados do produto

TagFunção
cProdCódigo interno do produto
cEANCódigo de barras comercial
xProdDescrição do produto
NCMNomenclatura Comum do Mercosul
NVENomenclatura de Valor Aduaneiro e Estatística
CESTCódigo Especificador da Substituição Tributária
indEscalaIndicador de produção em escala relevante
CNPJFabCNPJ do fabricante
cBenefCódigo de benefício fiscal
EXTIPICódigo de exceção da TIPI
CFOPCódigo Fiscal de Operações e Prestações
uComUnidade comercial
qComQuantidade comercial
vUnComValor unitário comercial
vProdValor total do produto
cEANTribCódigo de barras tributável
uTribUnidade tributável
qTribQuantidade tributável
vUnTribValor unitário tributável
vFreteValor do frete do item
vSegValor do seguro do item
vDescValor do desconto do item
vOutroOutras despesas acessórias
indTotIndica se o valor do item compõe o total da NF-e
xPedNúmero do pedido de compra
nItemPedItem do pedido de compra
nFCINúmero da FCI
nRECOPINúmero do RECOPI

Atenção fiscal

As tags CFOP, NCM, CEST, cBenef, CST, CSOSN, vProd, vDesc, vFrete e indTot são fundamentais para auditoria. Um erro nelas pode gerar divergência entre XML, escrituração, SPED Fiscal, apuração de impostos e relatórios gerenciais.


12. Grupo DI — Declaração de Importação

TagFunção
DIGrupo de Declaração de Importação
nDINúmero da DI
dDIData da DI
xLocDesembLocal de desembaraço
UFDesembUF do desembaraço
dDesembData do desembaraço
tpViaTranspVia de transporte internacional
vAFRMMValor da AFRMM
tpIntermedioForma de importação/intermediação
CNPJCNPJ do adquirente ou encomendante
UFTerceiroUF do adquirente ou encomendante
cExportadorCódigo do exportador

Grupo adi — adições da DI

TagFunção
adiGrupo de adição da DI
nAdicaoNúmero da adição
nSeqAdicNúmero sequencial do item dentro da adição
cFabricanteCódigo do fabricante estrangeiro
vDescDIValor do desconto da DI
nDrawNúmero do ato concessório de drawback

13. Grupo detExport — exportação do item

TagFunção
detExportGrupo de detalhes de exportação
nDrawNúmero do drawback
exportIndGrupo de exportação indireta
nRENúmero do Registro de Exportação
chNFeChave da NF-e recebida para exportação
qExportQuantidade efetivamente exportada

14. Grupo rastro — rastreabilidade

TagFunção
rastroGrupo de rastreabilidade do produto
nLoteNúmero do lote
qLoteQuantidade do lote
dFabData de fabricação
dValData de validade
cAgregCódigo de agregação

Esse grupo é relevante para medicamentos, produtos regulados, alimentos, cosméticos e mercadorias que exigem rastreabilidade.


15. Grupo med — medicamentos

TagFunção
medGrupo de medicamentos
cProdANVISACódigo do produto na ANVISA
xMotivoIsencaoMotivo da isenção da ANVISA
vPMCPreço máximo ao consumidor

16. Grupo arma — armamentos

TagFunção
armaGrupo de armamento
tpArmaTipo da arma
nSerieNúmero de série
nCanoNúmero do cano
descrDescrição da arma

17. Grupo comb — combustíveis

TagFunção
combGrupo de combustíveis
cProdANPCódigo ANP do produto
descANPDescrição ANP
pGLPPercentual de GLP
pGNnPercentual de gás natural nacional
pGNiPercentual de gás natural importado
vPartValor de partida
CODIFCódigo de autorização ou registro CODIF
qTempQuantidade à temperatura ambiente
UFConsUF de consumo
pBioPercentual de biodiesel

Grupo CIDE

TagFunção
CIDEGrupo da CIDE
qBCProdQuantidade da base de cálculo
vAliqProdValor da alíquota
vCIDEValor da CIDE

Grupo encerrante

TagFunção
encerranteGrupo de encerrante
nBicoNúmero do bico
nBombaNúmero da bomba
nTanqueNúmero do tanque
vEncIniValor inicial do encerrante
vEncFinValor final do encerrante

Grupo origComb

TagFunção
origCombOrigem do combustível
indImportIndicador de importação
cUFOrigUF de origem
pOrigPercentual originário

18. Grupo imposto — impostos do item

O grupo imposto contém os tributos incidentes sobre cada item da NF-e.

TagFunção
impostoGrupo de impostos do item
vTotTribValor aproximado total dos tributos
ICMSGrupo de ICMS
IPIGrupo de IPI
IIGrupo de Imposto de Importação
PISGrupo de PIS
PISSTGrupo de PIS por substituição tributária
COFINSGrupo de COFINS
COFINSSTGrupo de COFINS por substituição tributária
ISSQNGrupo de ISSQN
ICMSUFDestGrupo do ICMS da UF de destino
IBSCBSGrupo de IBS e CBS
impostoDevolGrupo de imposto devolvido

19. Tags do ICMS — Regime Normal

O ICMS é informado por grupos diferentes conforme o CST e a operação.


ICMS00 — tributada integralmente

TagFunção
ICMS00Grupo do CST 00
origOrigem da mercadoria
CSTCódigo de Situação Tributária
modBCModalidade de determinação da base de cálculo
vBCValor da base de cálculo
pICMSAlíquota do ICMS
vICMSValor do ICMS
pFCPPercentual do FCP
vFCPValor do FCP

ICMS10 — tributada com ICMS-ST

TagFunção
ICMS10Grupo do CST 10
origOrigem da mercadoria
CSTCódigo de Situação Tributária
modBCModalidade da base do ICMS próprio
vBCBase de cálculo do ICMS próprio
pICMSAlíquota do ICMS próprio
vICMSValor do ICMS próprio
vBCFCPBase de cálculo do FCP
pFCPPercentual do FCP
vFCPValor do FCP
modBCSTModalidade da base de cálculo da ST
pMVASTPercentual de MVA
pRedBCSTPercentual de redução da base da ST
vBCSTBase de cálculo do ICMS-ST
pICMSSTAlíquota do ICMS-ST
vICMSSTValor do ICMS-ST
vBCFCPSTBase do FCP-ST
pFCPSTPercentual do FCP-ST
vFCPSTValor do FCP-ST

ICMS20 — com redução de base

TagFunção
ICMS20Grupo do CST 20
origOrigem da mercadoria
CSTCódigo de Situação Tributária
modBCModalidade da base
pRedBCPercentual de redução da base
vBCBase de cálculo
pICMSAlíquota
vICMSValor do ICMS
vBCFCPBase do FCP
pFCPPercentual do FCP
vFCPValor do FCP
vICMSDesonValor do ICMS desonerado
motDesICMSMotivo da desoneração

ICMS30 — isenta ou não tributada com ST

TagFunção
ICMS30Grupo do CST 30
origOrigem
CSTCódigo de Situação Tributária
modBCSTModalidade da base ST
pMVASTMVA
pRedBCSTRedução da base ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ICMS-ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST
vICMSDesonValor desonerado
motDesICMSMotivo da desoneração

ICMS40, ICMS41 e ICMS50

TagFunção
ICMS40Isenta
ICMS41Não tributada
ICMS50Suspensão
origOrigem da mercadoria
CSTCódigo de Situação Tributária
vICMSDesonValor do ICMS desonerado
motDesICMSMotivo da desoneração

ICMS51 — diferimento

TagFunção
ICMS51Grupo do CST 51
origOrigem
CSTCódigo de Situação Tributária
modBCModalidade da base
pRedBCRedução da base
vBCBase de cálculo
pICMSAlíquota
vICMSOpValor do ICMS da operação
pDifPercentual de diferimento
vICMSDifValor do ICMS diferido
vICMSValor do ICMS devido
vBCFCPBase do FCP
pFCPPercentual do FCP
vFCPValor do FCP

ICMS60 — ICMS cobrado anteriormente por ST

TagFunção
ICMS60Grupo do CST 60
origOrigem
CSTCódigo de Situação Tributária
vBCSTRetBase de cálculo ST retida anteriormente
pSTAlíquota suportada pelo consumidor final
vICMSSubstitutoValor do ICMS do substituto
vICMSSTRetValor do ICMS-ST retido
vBCFCPSTRetBase do FCP-ST retido
pFCPSTRetPercentual do FCP-ST retido
vFCPSTRetValor do FCP-ST retido
pRedBCEfetPercentual de redução da base efetiva
vBCEfetBase de cálculo efetiva
pICMSEfetAlíquota efetiva
vICMSEfetValor do ICMS efetivo

ICMS70 — redução de base com ST

TagFunção
ICMS70Grupo do CST 70
origOrigem
CSTCódigo de Situação Tributária
modBCModalidade da base própria
pRedBCRedução da base própria
vBCBase própria
pICMSAlíquota própria
vICMSValor do ICMS próprio
vBCFCPBase FCP próprio
pFCPPercentual FCP próprio
vFCPValor FCP próprio
modBCSTModalidade da base ST
pMVASTMVA-ST
pRedBCSTRedução da base ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST
vICMSDesonICMS desonerado
motDesICMSMotivo da desoneração

ICMS90 — outros

TagFunção
ICMS90Grupo do CST 90
origOrigem
CSTCódigo de Situação Tributária
modBCModalidade da base
vBCBase de cálculo
pRedBCRedução da base
pICMSAlíquota
vICMSValor do ICMS
vBCFCPBase FCP
pFCPPercentual FCP
vFCPValor FCP
modBCSTModalidade ST
pMVASTMVA-ST
pRedBCSTRedução ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST
vICMSDesonICMS desonerado
motDesICMSMotivo da desoneração

ICMSPart — partilha em operação interestadual

TagFunção
ICMSPartGrupo de partilha do ICMS
origOrigem
CSTCódigo de Situação Tributária
modBCModalidade da base
vBCBase de cálculo
pRedBCRedução da base
pICMSAlíquota
vICMSValor do ICMS
modBCSTModalidade ST
pMVASTMVA-ST
pRedBCSTRedução ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
pBCOpPercentual da base da operação própria
UFSTUF para qual é devido o ICMS-ST

ICMSST — ICMS-ST para UF de destino

TagFunção
ICMSSTGrupo de ICMS-ST
origOrigem
CSTCódigo de Situação Tributária
vBCSTRetBase ST retida
pSTAlíquota suportada
vICMSSubstitutoICMS do substituto
vICMSSTRetICMS-ST retido
vBCFCPSTRetBase FCP-ST retido
pFCPSTRetPercentual FCP-ST retido
vFCPSTRetValor FCP-ST retido
vBCSTDestBase ST da UF de destino
vICMSSTDestValor ST da UF de destino
pRedBCEfetRedução da base efetiva
vBCEfetBase efetiva
pICMSEfetAlíquota efetiva
vICMSEfetICMS efetivo

20. Tags do ICMS no Simples Nacional

Empresas optantes pelo Simples Nacional usam grupos ICMSSN.


ICMSSN101

TagFunção
ICMSSN101Tributada pelo Simples com permissão de crédito
origOrigem da mercadoria
CSOSNCódigo de Situação da Operação no Simples Nacional
pCredSNPercentual de crédito do Simples Nacional
vCredICMSSNValor do crédito do ICMS aproveitável

ICMSSN102, ICMSSN103, ICMSSN300 e ICMSSN400

TagFunção
ICMSSN102Tributada pelo Simples sem permissão de crédito
ICMSSN103Isenção do ICMS no Simples para faixa de receita
ICMSSN300Imune
ICMSSN400Não tributada pelo Simples Nacional
origOrigem da mercadoria
CSOSNCódigo de Situação da Operação no Simples Nacional

ICMSSN201

TagFunção
ICMSSN201Simples Nacional com permissão de crédito e ICMS-ST
origOrigem
CSOSNCódigo CSOSN
modBCSTModalidade da base ST
pMVASTMVA-ST
pRedBCSTRedução da base ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST
pCredSNPercentual de crédito SN
vCredICMSSNValor do crédito SN

ICMSSN202 e ICMSSN203

TagFunção
ICMSSN202Simples Nacional sem permissão de crédito com ICMS-ST
ICMSSN203Isenção no Simples com ICMS-ST
origOrigem
CSOSNCódigo CSOSN
modBCSTModalidade ST
pMVASTMVA-ST
pRedBCSTRedução ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST

ICMSSN500

TagFunção
ICMSSN500ICMS cobrado anteriormente por ST ou antecipação
origOrigem
CSOSNCódigo CSOSN
vBCSTRetBase ST retida
pSTAlíquota suportada
vICMSSubstitutoICMS do substituto
vICMSSTRetICMS-ST retido
vBCFCPSTRetBase FCP-ST retido
pFCPSTRetPercentual FCP-ST retido
vFCPSTRetValor FCP-ST retido
pRedBCEfetRedução da base efetiva
vBCEfetBase efetiva
pICMSEfetAlíquota efetiva
vICMSEfetICMS efetivo

ICMSSN900

TagFunção
ICMSSN900Outros casos no Simples Nacional
origOrigem
CSOSNCódigo CSOSN
modBCModalidade da base
vBCBase de cálculo
pRedBCRedução da base
pICMSAlíquota
vICMSValor do ICMS
modBCSTModalidade ST
pMVASTMVA-ST
pRedBCSTRedução ST
vBCSTBase ST
pICMSSTAlíquota ST
vICMSSTValor ST
vBCFCPSTBase FCP-ST
pFCPSTPercentual FCP-ST
vFCPSTValor FCP-ST
pCredSNPercentual de crédito
vCredICMSSNValor do crédito

21. Tags de ICMS monofásico para combustíveis

Algumas operações com combustíveis usam grupos específicos de ICMS monofásico.

Grupo/tagFunção
ICMS02Tributação monofásica própria sobre combustíveis
ICMS15Tributação monofásica própria e com responsabilidade por retenção
ICMS53Tributação monofásica com diferimento
ICMS61Tributação monofásica cobrada anteriormente
qBCMonoQuantidade tributada monofasicamente
adRemICMSAlíquota ad rem do ICMS
vICMSMonoValor do ICMS monofásico
qBCMonoRetenQuantidade da base monofásica sujeita à retenção
adRemICMSRetenAlíquota ad rem da retenção
vICMSMonoRetenValor do ICMS monofásico retido
qBCMonoRetQuantidade da base monofásica retida anteriormente
adRemICMSRetAlíquota ad rem retida anteriormente
vICMSMonoRetValor do ICMS monofásico retido anteriormente
pDifPercentual de diferimento
vICMSMonoDifValor diferido do ICMS monofásico
vICMSMonoOpValor do ICMS monofásico da operação
pRedAdRemPercentual de redução da alíquota ad rem
motRedAdRemMotivo da redução da alíquota ad rem

22. Tags do IPI

TagFunção
IPIGrupo do IPI
clEnqClasse de enquadramento do IPI
CNPJProdCNPJ do produtor
cSeloCódigo do selo de controle
qSeloQuantidade de selo
cEnqCódigo de enquadramento legal do IPI
IPITribGrupo de IPI tributado
IPINTGrupo de IPI não tributado
CSTCST do IPI
vBCBase de cálculo do IPI
pIPIAlíquota do IPI
qUnidQuantidade total na unidade padrão
vUnidValor por unidade tributável
vIPIValor do IPI

23. Tags do II — Imposto de Importação

TagFunção
IIGrupo do Imposto de Importação
vBCBase de cálculo do II
vDespAduDespesas aduaneiras
vIIValor do Imposto de Importação
vIOFValor do IOF

24. Tags do PIS

Grupo/tagFunção
PISGrupo principal do PIS
PISAliqPIS por alíquota
PISQtdePIS por quantidade
PISNTPIS não tributado
PISOutrOutras operações de PIS
CSTCST do PIS
vBCBase de cálculo do PIS
pPISAlíquota do PIS
qBCProdQuantidade da base de cálculo
vAliqProdAlíquota em valor
vPISValor do PIS
PISSTPIS por substituição tributária

25. Tags da COFINS

Grupo/tagFunção
COFINSGrupo principal da COFINS
COFINSAliqCOFINS por alíquota
COFINSQtdeCOFINS por quantidade
COFINSNTCOFINS não tributada
COFINSOutrOutras operações de COFINS
CSTCST da COFINS
vBCBase de cálculo da COFINS
pCOFINSAlíquota da COFINS
qBCProdQuantidade da base de cálculo
vAliqProdAlíquota em valor
vCOFINSValor da COFINS
COFINSSTCOFINS por substituição tributária

26. Tags do ISSQN

TagFunção
ISSQNGrupo do ISSQN no item
vBCBase de cálculo do ISS
vAliqAlíquota do ISS
vISSQNValor do ISSQN
cMunFGMunicípio do fato gerador
cListServCódigo da lista de serviços
vDeducaoValor de dedução
vOutroOutros valores
vDescIncondDesconto incondicionado
vDescCondDesconto condicionado
vISSRetValor do ISS retido
indISSIndicador da exigibilidade do ISS
cServicoCódigo do serviço
cMunMunicípio de incidência
cPaisCódigo do país
nProcessoNúmero do processo
indIncentivoIndicador de incentivo fiscal

27. Tags do ICMS da UF de destino — ICMSUFDest

TagFunção
ICMSUFDestGrupo do ICMS da UF de destino
vBCUFDestBase de cálculo na UF de destino
vBCFCPUFDestBase de cálculo do FCP na UF de destino
pFCPUFDestPercentual do FCP na UF de destino
pICMSUFDestAlíquota interna da UF de destino
pICMSInterAlíquota interestadual
pICMSInterPartPercentual de partilha
vFCPUFDestValor do FCP da UF de destino
vICMSUFDestValor do ICMS da UF de destino
vICMSUFRemetValor do ICMS da UF remetente

28. Tags de IBS e CBS — Reforma Tributária

Com a Reforma Tributária, a NF-e passa a incorporar grupos e campos relacionados ao IBS e à CBS. Em exemplo oficial da Receita Federal, o XML da NF-e já apresenta o grupo IBSCBS, com tags como CST, cClassTrib, gIBSCBS, gIBSUF, gIBSMun, gCBS, além de totais em IBSCBSTot.

TagFunção
IBSCBSGrupo de IBS e CBS no item
CSTCódigo de Situação Tributária do IBS/CBS
cClassTribCódigo de classificação tributária
gIBSCBSGrupo de tributação do IBS/CBS
vBCBase de cálculo do IBS/CBS
gIBSUFGrupo do IBS estadual
pIBSUFAlíquota do IBS da UF
vIBSUFValor do IBS da UF
gIBSMunGrupo do IBS municipal
pIBSMunAlíquota do IBS municipal
vIBSMunValor do IBS municipal
vIBSValor total do IBS
gCBSGrupo da CBS
pCBSAlíquota da CBS
vCBSValor da CBS
pDifPercentual de diferimento
vDifValor diferido
pDevTribPercentual de devolução do tributo
vDevTribValor de devolução do tributo
pRedAliqPercentual de redução de alíquota
pAliqEfetAlíquota efetiva
gTribRegularGrupo de tributação regular
CSTRegCST da tributação regular
cClassTribRegClassificação tributária regular
gIBSCredPresGrupo de crédito presumido do IBS
gCBSCredPresGrupo de crédito presumido da CBS
cCredPresCódigo de crédito presumido
pCredPresPercentual de crédito presumido
vCredPresValor do crédito presumido
vCredPresCondSusCrédito presumido em condição suspensiva
gTribCompraGovGrupo de tributação em compra governamental
gEstornoCredGrupo de estorno de crédito
vIBSEstCredValor do estorno de crédito do IBS
vCBSEstCredValor do estorno de crédito da CBS
gIBSCBSMonoGrupo de IBS/CBS monofásico
qBCMonoQuantidade da base monofásica
adRemIBSAlíquota ad rem do IBS
adRemCBSAlíquota ad rem da CBS
vIBSMonoValor do IBS monofásico
vCBSMonoValor da CBS monofásica
qBCMonoRetenQuantidade monofásica sujeita à retenção
adRemIBSRetenAlíquota ad rem do IBS retido
vIBSMonoRetenValor do IBS monofásico retido
adRemCBSRetenAlíquota ad rem da CBS retida
vCBSMonoRetenValor da CBS monofásica retida
qBCMonoRetQuantidade monofásica retida anteriormente
adRemIBSRetAlíquota ad rem do IBS retido anteriormente
vIBSMonoRetValor do IBS retido anteriormente
adRemCBSRetAlíquota ad rem da CBS retida anteriormente
vCBSMonoRetValor da CBS retida anteriormente
pDifIBSPercentual de diferimento do IBS monofásico
vIBSMonoDifValor diferido do IBS monofásico
pDifCBSPercentual de diferimento da CBS monofásica
vCBSMonoDifValor diferido da CBS monofásica
vTotIBSMonoItemTotal de IBS monofásico no item
vTotCBSMonoItemTotal de CBS monofásica no item
gTransfCredGrupo de transferência de crédito
vIBSValor do IBS transferido
vCBSValor da CBS transferida
gCredPresIBSZFMGrupo de crédito presumido IBS na Zona Franca de Manaus
tpCredPresIBSZFMTipo de crédito presumido IBS ZFM
vCredPresIBSZFMValor do crédito presumido IBS ZFM

Atenção fiscal

As tags de IBS e CBS devem ser tratadas com cautela. A existência do grupo no leiaute não significa que ele será preenchido em todas as NF-e. A obrigatoriedade depende do cronograma de implantação, da operação, do CST, do cClassTrib, das regras de validação e da versão técnica vigente.


29. Grupo impostoDevol — imposto devolvido

TagFunção
impostoDevolGrupo de imposto devolvido
pDevolPercentual da mercadoria devolvida
IPIGrupo de IPI devolvido
vIPIDevolValor do IPI devolvido

Esse grupo é comum em operações de devolução quando há destaque ou controle de IPI devolvido.


30. Grupo total — totais da NF-e

O grupo total consolida os valores da NF-e.

TagFunção
totalGrupo de totais da NF-e
ICMSTotGrupo de totais do ICMS
ISSQNtotGrupo de totais do ISSQN
retTribGrupo de retenções de tributos
IBSCBSTotGrupo de totais de IBS e CBS
vNFTotValor total da NF-e considerando campos da Reforma Tributária

31. Grupo ICMSTot — totais de ICMS

TagFunção
vBCBase de cálculo total do ICMS
vICMSValor total do ICMS
vICMSDesonValor total do ICMS desonerado
vFCPValor total do FCP
vBCSTBase de cálculo total do ICMS-ST
vSTValor total do ICMS-ST
vFCPSTValor total do FCP-ST
vFCPSTRetValor total do FCP-ST retido
vProdValor total dos produtos
vFreteValor total do frete
vSegValor total do seguro
vDescValor total dos descontos
vIIValor total do Imposto de Importação
vIPIValor total do IPI
vIPIDevolValor total do IPI devolvido
vPISValor total do PIS
vCOFINSValor total da COFINS
vOutroOutras despesas acessórias
vNFValor total da NF-e
vTotTribValor aproximado total dos tributos

No exemplo oficial da Receita, o grupo ICMSTot aparece com campos como vBC, vICMS, vProd, vFrete, vSeg, vDesc, vIPI, vPIS, vCOFINS, vOutro e vNF.


32. Grupo ISSQNtot — totais do ISSQN

TagFunção
ISSQNtotGrupo de totais de ISSQN
vServValor total dos serviços
vBCBase de cálculo do ISS
vISSValor total do ISS
vPISValor de PIS sobre serviços
vCOFINSValor de COFINS sobre serviços
dCompetData de competência
vDeducaoValor de dedução
vOutroOutros valores
vDescIncondDesconto incondicionado
vDescCondDesconto condicionado
vISSRetValor do ISS retido
cRegTribCódigo do regime especial de tributação

33. Grupo retTrib — retenções

TagFunção
retTribGrupo de retenções tributárias
vRetPISValor retido de PIS
vRetCOFINSValor retido de COFINS
vRetCSLLValor retido de CSLL
vBCIRRFBase de cálculo do IRRF
vIRRFValor do IRRF
vBCRetPrevBase de retenção previdenciária
vRetPrevValor da retenção previdenciária

34. Grupo IBSCBSTot — totais de IBS e CBS

TagFunção
IBSCBSTotGrupo totalizador do IBS/CBS
vBCIBSCBSBase total do IBS/CBS
gIBSGrupo de totalização do IBS
gIBSUFTotal do IBS da UF
vDifValor diferido
vDevTribValor de devolução do tributo
vIBSUFValor total do IBS da UF
gIBSMunTotal do IBS municipal
vIBSMunValor total do IBS municipal
vIBSValor total do IBS
vCredPresValor total do crédito presumido
vCredPresCondSusCrédito presumido sob condição suspensiva
gCBSGrupo de totalização da CBS
vCBSValor total da CBS
gMonoGrupo de totalização monofásica
vTotIBSMonoTotal de IBS monofásico
vTotCBSMonoTotal de CBS monofásica
vTotNFValor total da nota conforme estrutura de IBS/CBS, quando aplicável

No exemplo oficial de XML de NF-e da Receita Federal, o total de IBS/CBS aparece dentro de IBSCBSTot, com vBCIBSCBS, gIBS, gIBSUF, gIBSMun, gCBS, vIBS e vCBS.


35. Grupo transp — transporte

TagFunção
transpGrupo de transporte
modFreteModalidade do frete
transportaGrupo do transportador
retTranspGrupo de retenção do ICMS do transporte
veicTranspGrupo do veículo de transporte
reboqueGrupo de reboque
vagaoIdentificação do vagão
balsaIdentificação da balsa
volGrupo de volumes

36. Grupo transporta

TagFunção
CNPJCNPJ do transportador
CPFCPF do transportador
xNomeNome ou razão social do transportador
IEInscrição Estadual do transportador
xEnderEndereço do transportador
xMunMunicípio do transportador
UFUF do transportador

37. Grupo retTransp

TagFunção
vServValor do serviço de transporte
vBCRetBase de cálculo da retenção
pICMSRetAlíquota do ICMS retido
vICMSRetValor do ICMS retido
CFOPCFOP do serviço de transporte
cMunFGMunicípio do fato gerador

38. Grupo veicTransp e reboque

TagFunção
placaPlaca do veículo ou reboque
UFUF da placa
RNTCRegistro Nacional de Transportador de Carga

39. Grupo vol — volumes transportados

TagFunção
volGrupo de volumes
qVolQuantidade de volumes
espEspécie dos volumes
marcaMarca dos volumes
nVolNumeração dos volumes
pesoLPeso líquido
pesoBPeso bruto
lacresGrupo de lacres
nLacreNúmero do lacre

40. Grupo cobr — cobrança

TagFunção
cobrGrupo de cobrança
fatGrupo de fatura
dupGrupo de duplicatas

Grupo fat

TagFunção
nFatNúmero da fatura
vOrigValor original da fatura
vDescValor do desconto
vLiqValor líquido da fatura

Grupo dup

TagFunção
nDupNúmero da duplicata
dVencData de vencimento
vDupValor da duplicata

41. Grupo pag — pagamento

TagFunção
pagGrupo de pagamento
detPagDetalhamento do pagamento
vTrocoValor do troco

Grupo detPag

TagFunção
indPagIndicador de pagamento
tPagMeio de pagamento
xPagDescrição do meio de pagamento
vPagValor pago
cardGrupo de cartão

Grupo card

TagFunção
tpIntegraTipo de integração do pagamento
CNPJCNPJ da credenciadora
tBandBandeira do cartão
cAutCódigo de autorização
CNPJRecebCNPJ do beneficiário do pagamento
idTermPagIdentificador do terminal de pagamento

42. Grupo infIntermed — intermediador da transação

TagFunção
infIntermedGrupo do intermediador ou marketplace
CNPJCNPJ do intermediador
idCadIntTranIdentificador cadastrado no intermediador

Esse grupo é relevante em operações com marketplace, plataformas digitais e intermediadores de pagamento ou venda.


43. Grupo infAdic — informações adicionais

TagFunção
infAdicGrupo de informações adicionais
infAdFiscoInformações adicionais de interesse do fisco
infCplInformações complementares de interesse do contribuinte
obsContObservação de interesse do contribuinte
obsFiscoObservação de interesse do fisco
procRefProcesso referenciado

Grupo obsCont e obsFisco

TagFunção
xCampoIdentificação do campo
xTextoTexto da observação

Grupo procRef

TagFunção
nProcNúmero do processo
indProcIndicador da origem do processo

44. Grupo exporta — informações de exportação

TagFunção
exportaGrupo de exportação
UFSaidaPaisUF de saída do país
xLocExportaLocal de exportação
xLocDespachoLocal de despacho

45. Grupo compra — informações de compra

TagFunção
compraGrupo de compra
xNEmpNota de empenho
xPedPedido
xContContrato

46. Grupo cana — operações com cana-de-açúcar

TagFunção
canaGrupo de cana-de-açúcar
safraSafra
refMês e ano de referência
forDiaGrupo de fornecimento diário
diaDia do fornecimento
qtdeQuantidade fornecida no dia
qTotMesQuantidade total do mês
qTotAntQuantidade total anterior
qTotGerQuantidade total geral
deducGrupo de deduções
xDedDescrição da dedução
vDedValor da dedução
vForValor dos fornecimentos
vTotDedValor total das deduções
vLiqForValor líquido dos fornecimentos

47. Grupo infRespTec — responsável técnico

TagFunção
infRespTecGrupo do responsável técnico pelo sistema emissor
CNPJCNPJ do responsável técnico
xContatoNome do contato
emailE-mail do responsável técnico
foneTelefone
idCSRTIdentificador do CSRT
hashCSRTHash do CSRT

No exemplo oficial de XML, a Receita Federal apresenta o grupo infRespTec com CNPJ, contato, e-mail e telefone do responsável técnico.


48. Grupo Signature — assinatura digital

A assinatura digital garante integridade e autenticidade do XML.

TagFunção
SignatureGrupo da assinatura digital
SignedInfoInformações assinadas
CanonicalizationMethodMétodo de canonicalização
SignatureMethodMétodo de assinatura
ReferenceReferência ao conteúdo assinado
TransformsTransformações aplicadas
TransformTransformação específica
DigestMethodMétodo de digest
DigestValueValor do digest
SignatureValueValor da assinatura
KeyInfoInformações da chave
X509DataDados do certificado digital
X509CertificateCertificado digital em formato X509

49. Grupo protNFe — protocolo de autorização

TagFunção
protNFeGrupo do protocolo da NF-e
infProtInformações do protocolo
infProt/@IdIdentificador do protocolo
tpAmbAmbiente de autorização
verAplicVersão da aplicação autorizadora
chNFeChave de acesso da NF-e
dhRecbtoData e hora de recebimento/autorização
nProtNúmero do protocolo
digValDigest value
cStatCódigo do status de autorização
xMotivoMotivo/status retornado pela SEFAZ

No exemplo oficial da Receita, o protocolo aparece com cStat igual a 100 e xMotivo indicando autorização de uso da NF-e.


Exemplo simplificado de XML da NF-e

<nfeProc versao="4.00">
  <NFe>
    <infNFe Id="NFe35250999999999000199550010000082961922091810" versao="4.00">
      <ide>
        <cUF>35</cUF>
        <natOp>Venda de mercadoria adquirida de terceiros</natOp>
        <mod>55</mod>
        <serie>1</serie>
        <nNF>8296</nNF>
        <dhEmi>2025-11-06T09:49:49-03:00</dhEmi>
        <tpNF>1</tpNF>
        <idDest>1</idDest>
        <finNFe>1</finNFe>
        <indFinal>1</indFinal>
      </ide>

      <emit>
        <CNPJ>99999999000199</CNPJ>
        <xNome>EMPRESA EMITENTE LTDA</xNome>
        <IE>9999999999</IE>
        <CRT>3</CRT>
      </emit>

      <dest>
        <CNPJ>99999999000199</CNPJ>
        <xNome>CLIENTE DESTINATÁRIO LTDA</xNome>
        <indIEDest>1</indIEDest>
      </dest>

      <det nItem="1">
        <prod>
          <cProd>001</cProd>
          <xProd>Produto de exemplo</xProd>
          <NCM>84713012</NCM>
          <CFOP>5102</CFOP>
          <uCom>UN</uCom>
          <qCom>1.0000</qCom>
          <vUnCom>1000.00</vUnCom>
          <vProd>1000.00</vProd>
          <indTot>1</indTot>
        </prod>

        <imposto>
          <ICMS>
            <ICMS00>
              <orig>0</orig>
              <CST>00</CST>
              <modBC>3</modBC>
              <vBC>1000.00</vBC>
              <pICMS>18.0000</pICMS>
              <vICMS>180.00</vICMS>
            </ICMS00>
          </ICMS>

          <PIS>
            <PISAliq>
              <CST>01</CST>
              <vBC>1000.00</vBC>
              <pPIS>1.6500</pPIS>
              <vPIS>16.50</vPIS>
            </PISAliq>
          </PIS>

          <COFINS>
            <COFINSAliq>
              <CST>01</CST>
              <vBC>1000.00</vBC>
              <pCOFINS>7.6000</pCOFINS>
              <vCOFINS>76.00</vCOFINS>
            </COFINSAliq>
          </COFINS>
        </imposto>
      </det>

      <total>
        <ICMSTot>
          <vBC>1000.00</vBC>
          <vICMS>180.00</vICMS>
          <vProd>1000.00</vProd>
          <vPIS>16.50</vPIS>
          <vCOFINS>76.00</vCOFINS>
          <vNF>1000.00</vNF>
        </ICMSTot>
      </total>

      <transp>
        <modFrete>9</modFrete>
      </transp>

      <pag>
        <detPag>
          <tPag>99</tPag>
          <vPag>1000.00</vPag>
        </detPag>
      </pag>

      <infAdic>
        <infCpl>Informações complementares da operação.</infCpl>
      </infAdic>
    </infNFe>
  </NFe>
</nfeProc>

Tags mais importantes para auditoria fiscal

Embora todas as tags tenham função dentro do XML, algumas são mais críticas para a rotina fiscal e contábil.

ÁreaTags críticas
IdentificaçãocUF, mod, serie, nNF, dhEmi, tpNF, idDest, finNFe
Emitenteemit/CNPJ, emit/IE, emit/CRT
Destinatáriodest/CNPJ, dest/CPF, dest/indIEDest, dest/IE
ProdutocProd, xProd, NCM, CEST, CFOP, cBenef, uCom, qCom, vProd
ICMSCST, CSOSN, vBC, pICMS, vICMS, vBCST, vICMSST
PIS/COFINSCST, vBC, pPIS, vPIS, pCOFINS, vCOFINS
IPICST, cEnq, vBC, pIPI, vIPI
IBS/CBSCST, cClassTrib, vBC, pIBSUF, pIBSMun, pCBS, vIBS, vCBS
TotaisvProd, vFrete, vDesc, vICMS, vPIS, vCOFINS, vNF
ProtocolochNFe, nProt, cStat, xMotivo, dhRecbto

Erros comuns nas tags XML da NF-e

1. CFOP incompatível com a operação

O CFOP precisa refletir corretamente a natureza da operação. Uma venda interna, interestadual, exportação, devolução, remessa, retorno ou industrialização exige códigos diferentes.

Exemplo:

SituaçãoAtenção
Venda interna de mercadoria adquirida de terceirosCFOP da família 5.102
Venda interestadual de mercadoria adquirida de terceirosCFOP da família 6.102
Devolução de compraCFOP específico de devolução
Remessa para industrializaçãoCFOP específico de remessa
Retorno de industrializaçãoCFOP específico de retorno

2. NCM incorreto

A tag NCM impacta tributação, IPI, ICMS-ST, CEST, benefícios fiscais, importação, exportação e obrigações acessórias.

Um NCM errado pode gerar:

  • tributação incorreta;
  • uso indevido de CST ou CSOSN;
  • CEST incompatível;
  • erro de classificação fiscal;
  • risco em auditoria;
  • divergência no SPED.

3. CST ou CSOSN incompatível com o regime tributário

Empresa do Simples Nacional normalmente usa grupos ICMSSN e códigos CSOSN.

Empresa do Regime Normal usa grupos de ICMS com CST.

O erro entre CST, CSOSN e CRT é uma das inconsistências mais comuns na validação fiscal.


4. Total da NF-e diferente da soma dos itens

As tags de totalização precisam fechar com os itens:

ItemTotal relacionado
det/prod/vProdtotal/ICMSTot/vProd
det/imposto/ICMS/vICMStotal/ICMSTot/vICMS
det/imposto/PIS/vPIStotal/ICMSTot/vPIS
det/imposto/COFINS/vCOFINStotal/ICMSTot/vCOFINS
det/prod/vFretetotal/ICMSTot/vFrete
det/prod/vDesctotal/ICMSTot/vDesc
total/ICMSTot/vNFValor final da NF-e

5. Falta de XML autorizado

O XML válido para escrituração e guarda fiscal deve conter protocolo de autorização. Por isso, a presença de protNFe, infProt, nProt, cStat e xMotivo é essencial para comprovar que a NF-e foi autorizada.


Como usar as tags XML da NF-e na prática

As tags da NF-e podem ser usadas para:

  • importar documentos fiscais no ERP;
  • conferir entradas contra pedidos de compra;
  • validar CFOP, CST, CSOSN, NCM e CEST;
  • cruzar XML com SPED Fiscal;
  • auditar créditos de ICMS, PIS, COFINS e IPI;
  • identificar notas emitidas contra o CNPJ;
  • controlar manifestação do destinatário;
  • recuperar XMLs ausentes;
  • gerar relatórios gerenciais;
  • validar dados de fornecedores;
  • rastrear divergências entre DANFE, XML e escrituração.

XML da NF-e e SPED Fiscal

A escrituração fiscal depende diretamente das informações do XML.

Exemplos de relação prática:

XML da NF-eReflexo fiscal
ide/dhEmiData de emissão
ide/tpNFEntrada ou saída
emit/CNPJParticipante emitente
dest/CNPJParticipante destinatário
det/prod/CFOPCFOP escriturado
det/prod/NCMClassificação fiscal
det/imposto/ICMS/CSTSituação tributária do ICMS
det/imposto/PIS/CSTSituação tributária do PIS
det/imposto/COFINS/CSTSituação tributária da COFINS
total/ICMSTot/vNFValor contábil da nota
protNFe/infProt/nProtAutorização de uso

Quando o XML está incompleto, ausente ou armazenado apenas em PDF, a empresa perde capacidade de auditoria, rastreabilidade e defesa fiscal.


Perguntas frequentes sobre tags XML da NF-e

O que são tags XML da NF-e?

São os campos estruturados do arquivo XML da Nota Fiscal Eletrônica. Cada tag armazena uma informação fiscal, comercial, tributária ou técnica da nota.

Toda NF-e tem todas as tags?

Não. A NF-e possui muitos grupos opcionais. As tags aparecem conforme a operação, o produto, o regime tributário, o CST/CSOSN, a UF, a finalidade da nota e as regras de validação.

Qual é a tag do CFOP no XML da NF-e?

A tag do CFOP fica no item da nota, dentro de:

<det>
  <prod>
    <CFOP>5102</CFOP>
  </prod>
</det>

Qual é a tag do NCM?

A tag do NCM fica em:

<det>
  <prod>
    <NCM>84713012</NCM>
  </prod>
</det>

Qual é a tag do valor total da NF-e?

A principal tag de valor total da NF-e é:

<total>
  <ICMSTot>
    <vNF>1000.00</vNF>
  </ICMSTot>
</total>

Qual é a tag do protocolo de autorização?

O protocolo fica no grupo:

<protNFe>
  <infProt>
    <nProt>...</nProt>
    <cStat>100</cStat>
    <xMotivo>Autorizado o uso da NF-e</xMotivo>
  </infProt>
</protNFe>

Onde ficam ICMS, IPI, PIS e COFINS?

Eles ficam dentro do grupo imposto, em cada item da NF-e:

<det>
  <imposto>
    <ICMS>...</ICMS>
    <IPI>...</IPI>
    <PIS>...</PIS>
    <COFINS>...</COFINS>
  </imposto>
</det>

Onde ficam IBS e CBS no XML da NF-e?

As informações de IBS e CBS ficam no grupo IBSCBS no item e no grupo IBSCBSTot nos totais, quando aplicáveis conforme leiaute e regras vigentes.

XML e DANFE são a mesma coisa?

Não. O XML é o documento fiscal eletrônico com validade jurídica. O DANFE é apenas uma representação gráfica auxiliar da NF-e.

Preciso guardar o XML da NF-e?

Sim. O XML é o documento fiscal que deve ser mantido pela empresa para fins fiscais, contábeis, operacionais e de auditoria.


Checklist para auditar tags XML da NF-e

Antes de importar, escriturar ou auditar uma NF-e, confira:

  • A NF-e possui protNFe com autorização?
  • O cStat indica autorização de uso?
  • O CNPJ do emitente está correto?
  • O CNPJ ou CPF do destinatário está correto?
  • O CFOP reflete a operação real?
  • O NCM está compatível com o produto?
  • O CEST foi informado quando necessário?
  • O CST ou CSOSN está compatível com o regime tributário?
  • O CRT do emitente está coerente?
  • Os valores dos itens fecham com os totais?
  • O ICMS próprio, ICMS-ST e FCP foram tratados corretamente?
  • PIS e COFINS estão com CST, base, alíquota e valor corretos?
  • IPI foi informado quando aplicável?
  • IBS e CBS foram tratados conforme a regra vigente?
  • O XML está armazenado e disponível para auditoria?
  • A nota foi manifestada quando necessário?
  • O XML foi integrado corretamente ao ERP?

Fontes oficiais e referências técnicas

Este conteúdo foi estruturado com base no leiaute da NF-e modelo 55, na estrutura XML da NF-e 4.00, nos grupos de tributação atualmente utilizados no documento fiscal eletrônico e em exemplo oficial de XML de NF-e publicado pela Receita Federal, com menção ao schema procNFe_v4.00.xsd e grupos de IBS/CBS.

Para manter este post sempre atualizado, recomenda-se revisar periodicamente:

  • Manual de Orientação do Contribuinte da NF-e;
  • Notas Técnicas da NF-e;
  • Pacotes de Schemas XML da NF-e;
  • Tabelas oficiais de CFOP, CST, CSOSN, NCM, CEST e cBenef;
  • Documentação da Reforma Tributária do Consumo;
  • Regras de validação publicadas pela SEFAZ.

Deixe um comentário