XML da Nota Fiscal: o que é, como funciona e onde é aplicado na NF-e

XML da Nota Fiscal: o que é, como funciona e onde é aplicado na NF-e

Quando sua empresa emite uma nota fiscal eletrônica, o que realmente é enviado para a SEFAZ não é um PDF nem uma imagem — é um arquivo XML. Esse arquivo é o documento fiscal em sua forma oficial, com validade jurídica, estrutura padronizada e assinatura digital. O DANFE que você imprime ou envia por e-mail é apenas uma representação visual simplificada desse XML.

Entender o que é o XML da nota fiscal, quais informações ele contém, como ele é organizado e por que sua guarda é obrigatória é essencial para qualquer empresário, contador ou profissional da área fiscal. E com a Reforma Tributária em andamento — que adiciona mais de 200 novos campos ao layout da NF-e a partir de 2026 — esse conhecimento se torna ainda mais estratégico.

O que é XML?

XML é a sigla para eXtensible Markup Language (Linguagem de Marcação Extensível). Trata-se de um formato de arquivo de texto padronizado, recomendado pelo W3C (World Wide Web Consortium), criado para organizar dados de forma hierárquica, estruturada e legível tanto por humanos quanto por sistemas computacionais.

A linguagem XML utiliza tags (marcadores) para delimitar cada informação dentro do documento. Uma tag de abertura e uma de fechamento envolvem o conteúdo, formando um par:

<emitente>
  <CNPJ>12345678000199CNPJ>
  <xNome>Empresa Exemplo LtdaxNome>
  <UF>SPUF>
emitente>

No exemplo acima, a tag abre um grupo de dados; dentro dele, , e são campos com seus respectivos valores; e fecha o grupo. Essa estrutura hierárquica é o que permite que qualquer sistema — da Receita Federal ao ERP da empresa — leia, interprete e processe o documento de forma automática e padronizada.

Por que o XML é o formato oficial da nota fiscal eletrônica?

O XML se tornou o padrão dos documentos fiscais eletrônicos brasileiros por três razões principais:

1. Estrutura hierárquica clara O XML organiza os dados em grupos e subgrupos aninhados, refletindo exatamente a estrutura lógica de uma nota fiscal: dados do emitente, dados do destinatário, itens, impostos, totais, transporte e pagamento — tudo em camadas bem definidas.

2. Validação automática por schema O governo federal publica arquivos de schema (.XSD) que definem exatamente quais campos são obrigatórios, seus tipos de dados, tamanhos mínimos e máximos e regras de preenchimento. Qualquer sistema pode validar automaticamente se um XML está correto antes de enviá-lo à SEFAZ — evitando rejeições.

3. Interoperabilidade universal Por ser um padrão aberto e amplamente adotado, qualquer sistema — ERP, contador, SEFAZ, Receita Federal, transportadora — consegue ler e processar o mesmo XML sem necessidade de conversão ou adaptação.

🔔 Importante: o arquivo XML é o documento fiscal oficial. O DANFE (Documento Auxiliar da Nota Fiscal Eletrônica) é apenas uma representação visual para acompanhar a mercadoria ou para consulta rápida. Em caso de divergência entre o DANFE e o XML, prevalece sempre o XML.

Onde o XML é aplicado nos documentos fiscais eletrônicos

O formato XML é a base técnica de todos os documentos fiscais eletrônicos (DF-e) utilizados no Brasil:

Todos esses documentos seguem o mesmo princípio: um arquivo XML assinado digitalmente, enviado à SEFAZ ou ao autorizador correspondente, que retorna uma autorização (protocolo) confirmando a validade do documento.

Como o XML da NF-e é estruturado

O XML de uma NF-e segue um layout padronizado em nível nacional, definido pelo Ajuste SINIEF e pelas Notas Técnicas publicadas pelo CONFAZ e pela Receita Federal. Ele é organizado em grupos de informações, cada um responsável por um conjunto de dados específicos:

Grupo A — Raiz do documento NF-e

O nível mais alto do arquivo. Contém a versão do layout utilizado e engloba todos os demais grupos.

Grupo B — Identificação da NF-e

Dados que identificam a nota fiscalmente:

• Código da UF do emitente
• Código numérico da NF-e (cNF)
• Natureza da operação (ex.: "Venda de mercadoria")
• Número da nota, série e modelo
• Data e hora de emissão
• Tipo da operação (entrada ou saída)
• Finalidade da emissão (normal, complementar, ajuste, devolução)
• CFOP principal
• Indicador de presença (presencial, internet, teleatendimento etc.)

Grupo C — Dados do emitente

• CNPJ ou CPF
• Razão social e nome fantasia
• Endereço completo (logradouro, número, bairro, município, UF, CEP)
• Telefone
• Inscrição Estadual e, se houver, Inscrição Municipal
• CNAE
• CRT (Código de Regime Tributário): 1 = Simples Nacional, 2 = Simples Nacional com excesso, 3 = Regime Normal, 4 = MEI

Grupo E — Dados do destinatário

• CNPJ ou CPF
• Razão social
• Endereço completo
• Inscrição Estadual (se contribuinte)
• Indicador de IE (contribuinte, não contribuinte, isento)
• E-mail para envio do XML autorizado

Grupo I — Dados dos produtos e serviços

É o grupo mais extenso e o mais crítico para a conformidade fiscal. Para cada item da nota, são informados:

• cProd: código interno do produto no sistema do emitente
• cEAN / GTIN: código de barras do produto
• xProd: descrição do produto
• NCM: código da Nomenclatura Comum do Mercosul (8 dígitos)
• CEST: Código Especificador da Substituição Tributária (quando aplicável)
• CFOP: natureza da operação do item
• uCom: unidade de comercialização (UN, KG, CX, LT etc.)
• qCom: quantidade comercializada
• vUnCom: valor unitário de comercialização
• vProd: valor total do produto
• indTot: indica se o item compõe o total da NF-e

Dentro de cada item, há ainda os subgrupos de impostos:

ICMS: CST ou CSOSN, origem da mercadoria, modalidade de determinação da base de cálculo, base de cálculo, alíquota e valor do ICMS, dados de substituição tributária (ICMS-ST) quando aplicável.

IPI: CST do IPI, base de cálculo, alíquota ad valorem ou valor por unidade (alíquota específica), valor do IPI.

PIS e COFINS: CST, base de cálculo, alíquota e valor de cada contribuição.

II (Imposto de Importação): base de cálculo, despesas aduaneiras e valor do II, quando aplicável.

Grupo W — Totais da NF-e

Soma de todos os valores dos itens e impostos:

• Total dos produtos (vProd)
• Total do ICMS (vICMS)
• Total do ICMS-ST (vST)
• Total do IPI (vIPI)
• Total do PIS (vPIS)
• Total do COFINS (vCOFINS)
• Valor do frete, seguro e outras despesas
• Valor dos descontos
• Valor total da NF-e (vNF)

Grupo X — Dados do transporte

• Modalidade do frete (por conta do emitente, destinatário, terceiros ou sem frete)
• Dados da transportadora (CNPJ, razão social, IE, endereço)
• Dados do veículo e do motorista
• Volumes transportados (quantidade, espécie, marca, peso bruto e líquido)

Grupo Y — Dados da cobrança

• Dados da fatura (número, valor original, desconto e valor líquido)
• Parcelas (número, vencimento e valor de cada duplicata)

Grupo YA — Informações de pagamento

• Meio de pagamento utilizado (dinheiro, cheque, cartão de crédito, débito, Pix, boleto, etc.)
• Valor correspondente a cada meio
• Dados da operação com cartão (bandeira, CNPJ da credenciadora, número de autorização)

Grupo Z — Informações adicionais

• infAdFisco: informações adicionais de interesse do fisco (ex.: código de benefício fiscal, referência a convênios etc.)
• infCpl: informações complementares de interesse do contribuinte (ex.: número do pedido, prazo de entrega, observações gerais)

Grupo ZA — Responsável técnico

Dados do desenvolvedor do sistema que emitiu a NF-e: CNPJ, contato e telefone.

Assinatura digital e protocolo de autorização

O XML é assinado digitalmente com o certificado digital do emitente (e-CNPJ ou e-CPF, padrão ICP-Brasil). Após o envio à SEFAZ, o arquivo retorna com a chave de acesso de 44 dígitos e o número do protocolo de autorização, que são adicionados ao XML final — confirmando que a nota foi autorizada e é válida.

A chave de acesso: o identificador único de cada NF-e

Dentro do XML, cada NF-e recebe uma chave de acesso de 44 dígitos que a identifica de forma única no Brasil. Ela é composta por:

Com essa chave, qualquer pessoa pode consultar a autenticidade da nota no portal da SEFAZ ou na Receita Federal, digitando os 44 dígitos.

DANFE x XML: qual é a diferença?

Um ponto que gera muita confusão no dia a dia é a relação entre o DANFE e o XML. É importante entender claramente:

⚠️ Atenção: não é necessário imprimir o XML da NF-e recebida. A legislação não exige isso — e inclusive desencoraja, pois o processo digital foi criado para eliminar o papel. O que é obrigatório é guardar o arquivo .xml em local seguro pelo prazo legal.

Por quanto tempo o XML da NF-e deve ser armazenado?

A legislação brasileira exige que tanto o emitente quanto o destinatário guardem os arquivos XML pelo prazo de 5 anos + o ano vigente, a contar da data de emissão da nota. Esse prazo corresponde ao período em que a Receita Federal pode fiscalizar as operações.

A obrigação de guarda vale mesmo que a SEFAZ e a Receita Federal também tenham cópias dos arquivos em seus servidores. A responsabilidade do contribuinte de manter o arquivo é independente do armazenamento do fisco.

As formas mais comuns de armazenamento são:

• ERP com repositório integrado de XMLs
• Sistemas especializados de gestão de documentos fiscais
• Servidores próprios ou em nuvem com backup redundante

💡 Sistemas como o Actana armazenam automaticamente os XMLs das notas emitidas, sem necessidade de gestão manual pelo usuário.

O que muda no XML da NF-e com a Reforma Tributária

A Reforma Tributária em andamento no Brasil está promovendo a maior atualização no layout do XML da NF-e desde a criação do documento fiscal eletrônico. A Nota Técnica 2025.002, publicada pela Receita Federal e pelo ENCAT, define as mudanças necessárias para que a NF-e e a NFC-e comportem os novos tributos: IBS, CBS e Imposto Seletivo (IS).

Novos campos adicionados ao XML

A NT 2025.002 adiciona mais de 200 novos campos ao layout da NF-e. Os principais grupos novos incluem:

• Grupo gIBSCBS: campos específicos para IBS e CBS por item da nota, incluindo alíquota efetiva (pAliqEfet), valor do IBS por UF (vIBSUF), valor do IBS por município (vIBSMun) e valor da CBS (vCBS)
• cClassTrib: Código de Classificação Tributária, novo campo que define o enquadramento do item nos novos tributos
• vCredPres: valor do crédito presumido, para operações com regimes especiais
• Novos grupos no total da NF-e (W03): totalização de IBS, CBS e IS na nota
• Novas finalidades de NF-e: nota de crédito e nota de débito, para ajustes na apuração assistida do IBS e CBS

Cronograma de implementação

🔔 Empresas do Simples Nacional e MEI estão, a princípio, dispensadas da obrigatoriedade dos novos campos IBS/CBS em 2026, conforme LC 214/2025. Porém, como o cronograma ainda está em fase de definições, é essencial acompanhar as atualizações da Receita Federal.

O novo sistema tributário previsto para a Reforma será o maior sistema fiscal digital do mundo — capaz de processar aproximadamente 70 bilhões de documentos por ano. Toda essa rastreabilidade passa pelo XML.

Erros mais comuns relacionados ao XML da NF-e

1. Confundir DANFE com o XML Guardar o DANFE (PDF) e descartar o XML é um erro grave. Apenas o XML tem validade jurídica e é o documento que o fisco pode exigir em uma auditoria.

2. Não armazenar o XML das notas recebidas A obrigação de guarda vale tanto para o emitente quanto para o destinatário. Empresas que recebem NF-e também devem guardar os XMLs pelo prazo legal.

3. Preenchimento incorreto de campos obrigatórios Campos como NCM, CEST, CFOP, CST/CSOSN e as bases de cálculo de cada imposto devem ser preenchidos corretamente no XML. Erros nesses campos geram rejeição pela SEFAZ ou inconsistências no SPED.

4. Não atualizar o sistema para novos layouts A cada Nota Técnica publicada pelo governo, o layout do XML é atualizado. Sistemas desatualizados podem emitir notas com schema antigo, causando rejeições após a vigência do novo layout.

5. Não validar o XML antes do envio Sistemas de emissão sérios validam o XML contra o schema (XSD) antes de enviá-lo à SEFAZ. Pular essa etapa aumenta a taxa de rejeição e interrompe operações.

Como o Actana gerencia o XML das notas fiscais

O Actana é um sistema ERP online que cuida de todo o ciclo de vida do XML da nota fiscal de forma automática:

• 📄 Emissão de NF-e, NFC-e e NFS-e com geração do XML no padrão vigente, validação contra o schema e envio à SEFAZ;
• ✅ Autorização em tempo real com retorno do protocolo e da chave de acesso;
• 🗂️ Armazenamento automático dos XMLs emitidos, sem necessidade de gestão manual;
• 📧 Envio do XML e DANFE por e-mail ao destinatário;
• 🔄 Atualização de layouts conforme as Notas Técnicas publicadas pela Receita Federal;
• 📦 Cadastro de produtos com NCM, CEST e CFOP corretos, garantindo XMLs válidos desde o primeiro campo.

Perguntas frequentes sobre o XML da nota fiscal

1. O XML da NF-e tem o mesmo valor jurídico que a nota fiscal impressa? Sim — e vai além. O XML é o documento fiscal oficial. A nota fiscal impressa (DANFE) é apenas uma representação auxiliar. Em uma fiscalização, o fisco exige o XML, não o DANFE.

2. Preciso imprimir o XML da nota fiscal? Não. A legislação não exige a impressão do XML. O processo eletrônico foi criado justamente para eliminar papel. O que é obrigatório é guardar o arquivo digital pelo prazo de 5 anos + o ano vigente.

3. Por quanto tempo devo guardar o XML? Por 5 anos + o ano vigente a partir da data de emissão. Essa obrigação vale tanto para emitentes quanto para destinatários.

4. O que acontece se eu perder o XML de uma nota? Se a nota estiver autorizada, você pode obter uma cópia pela SEFAZ ou pelo portal da Receita Federal usando a chave de acesso de 44 dígitos. Porém, o ideal é nunca depender disso — mantenha backups regulares dos seus XMLs.

5. Qual é a diferença entre XML e XSD? O XML é o arquivo de dados da nota fiscal. O XSD (XML Schema Definition) é o arquivo de schema que define as regras de estrutura e validação do XML — publicado pelo governo e usado pelos sistemas para verificar se o XML está correto antes do envio.

6. O XML muda com a Reforma Tributária? Sim. A Nota Técnica 2025.002 adicionou mais de 200 novos campos ao layout da NF-e para comportar o IBS, a CBS e o Imposto Seletivo. Para empresas do Regime Normal, esses campos passam a ser obrigatórios a partir de janeiro de 2026.

7. Empresa do Simples Nacional precisa se preocupar com os novos campos do XML? Em 2026, empresas do Simples Nacional e MEI estão, a princípio, dispensadas dos novos campos IBS/CBS. Mas como o cronograma ainda está em definição, é importante acompanhar as atualizações da Receita Federal e manter o sistema atualizado.

Conclusão

O XML é muito mais do que um arquivo técnico — é o documento fiscal oficial de todas as operações da sua empresa. Entender sua estrutura, saber quais informações cada grupo contém, cumprir a obrigação de guarda pelo prazo correto e acompanhar as atualizações de layout são responsabilidades que impactam diretamente a conformidade fiscal do seu negócio.

Com a Reforma Tributária adicionando mais de 200 novos campos ao XML da NF-e a partir de 2026, contar com um sistema ERP atualizado — como o Actana — não é apenas uma conveniência: é uma necessidade para emitir notas fiscais corretas, evitar rejeições e manter a empresa em conformidade com a nova realidade tributária brasileira.