XML da nota fiscal: o que é, para que serve e por quanto tempo o vendedor online precisa guardar

O XML é a nota fiscal eletrônica de verdade. Pelo Ajuste SINIEF 07/2005, a NF-e existe só em formato digital, num arquivo no padrão XML, assinado pelo emitente e autorizado pela Sefaz. O papel que vai colado na caixa, o DANFE, é apenas uma representação dele, com uma chave de acesso de 44 dígitos para consulta. Quem vende online precisa do XML para três coisas: liberar a etiqueta no marketplace, conferir o custo da compra e guardar por no mínimo 5 anos para o fisco.

Muita gente só descobre o XML quando o Mercado Livre trava uma venda com "nota pendente" ou quando o contador pede "os XMLs do mês". Vou explicar o que tem dentro do arquivo, onde ele aparece na sua rotina e o que fazer para não perder nenhum.

#O que é o XML da nota fiscal?

É um arquivo de texto organizado em etiquetas (as tags), num formato que qualquer sistema consegue ler. O nome vem de Extensible Markup Language, uma linguagem de marcação. Dentro dele estão todos os dados da venda ou da compra:

• quem vendeu e quem comprou (CNPJ ou CPF, endereço, inscrição estadual);
• cada produto, com quantidade, valor, NCM (o código fiscal da mercadoria) e CFOP (o código da operação);
• os impostos destacados, o frete, o desconto e o valor total;
• a assinatura digital do emitente e o protocolo de autorização da Sefaz.

A regra é do Ajuste SINIEF 07/2005, o acordo entre os estados que criou a NF-e: a nota é um documento "de existência apenas digital", e a validade jurídica vem da assinatura e da autorização de uso. Ou seja, o XML não é uma cópia da nota. Ele é a nota.

#Qual a diferença entre XML, DANFE e chave de acesso?

A diferença é que só o XML tem valor de nota. Os outros dois servem para acompanhar e para consultar.

O Ajuste SINIEF diz que o DANFE existe "para acompanhar o trânsito das mercadorias" e para facilitar a consulta. Por isso ele traz a chave de acesso e o código de barras. No Portal Nacional da NF-e, qualquer pessoa digita os 44 dígitos e vê se a nota está autorizada, cancelada ou se nem existe.

Eu tenho uma regra simples: PDF não é nota. Se o fornecedor mandou só o DANFE em PDF, peça o XML. Se você emite e guarda só o PDF, mude isso hoje.

#Para que o vendedor online usa o XML no dia a dia?

Em quatro momentos, e cada um tem um custo se o arquivo faltar.

1. Para liberar a etiqueta no Mercado Livre. Quem tem CNPJ e emite a nota num emissor próprio, fora do Faturador do ML, precisa importar o XML da venda. Pela documentação oficial, isso vale para envios por agência (Places), coleta, coleta rápida e drop off. Enquanto o XML não chega, o envio fica com o status de nota pendente e a etiqueta não sai. Vendedor pessoa física ou PJ não contribuinte usa outro documento, a DC-e (declaração de conteúdo eletrônica), e tem até 3 dias corridos depois da venda para emitir.

2. Para entregar a nota ao comprador. O emitente deve mandar o XML e o protocolo ao destinatário logo depois da autorização. Em marketplace, isso acontece quando você sobe o arquivo no pedido ou usa o emissor integrado.

3. Para saber o custo real do que você comprou. O XML do fornecedor é a fonte mais confiável do custo: preço unitário, frete, IPI e ICMS-ST (o ICMS cobrado antecipado na substituição tributária) estão lá, item por item. É o que eu uso para montar o custo de compra, e expliquei o passo a passo em nota fiscal de entrada.

4. Para o contador fechar o mês. No Simples Nacional, o contador apura o imposto pelo faturamento do mês. Sem os XMLs de venda e de compra, ele trabalha com relatório do marketplace, e aí qualquer diferença vira dor de cabeça na fiscalização.

#Por que o Mercado Livre recusa o XML?

Porque o arquivo não bate com a venda ou com o seu cadastro. A documentação do ML lista os erros mais comuns ao importar a nota, e quase todos são evitáveis:

O erro de valor é o mais traiçoeiro. Imagine uma venda de R$ 89,90 de um anúncio que custava R$ 99,90 até ontem, e o seu emissor puxou o preço antigo do cadastro. O ML recusa, a etiqueta não sai e o prazo de despacho continua correndo. Se a nota já foi autorizada, você tem até 24 horas para cancelar, desde que a mercadoria não tenha saído, e emitir outra com o valor certo.

Na prática. Um exemplo com números redondos: uma loja com CNPJ emite 30 notas de venda por dia, num emissor fora do Mercado Livre. São cerca de 900 XMLs por mês e 10.800 por ano. Se ela importa o XML à mão em cada pedido e 1 em cada 30 volta com erro de valor, são 30 vendas por mês paradas esperando nota nova. Com o emissor integrado ao marketplace, ou com a importação automática pela API, o XML sobe sozinho e o erro aparece na hora, antes do horário de corte.

#Por quanto tempo é preciso guardar o XML?

Por no mínimo 5 anos completos depois do ano da emissão. O Ajuste SINIEF manda o emitente manter a NF-e em arquivo digital "pelo prazo estabelecido na legislação tributária". Essa legislação é o Código Tributário Nacional:

• o art. 195 manda conservar os documentos fiscais até a prescrição dos créditos tributários;
• o art. 173 dá ao fisco 5 anos, contados do primeiro dia do ano seguinte, para cobrar o imposto;
• o art. 174 dá mais 5 anos para a cobrança na Justiça depois que o débito é constituído.

Na prática, uma nota emitida em outubro de 2026 pode ser fiscalizada até o fim de 2031. Se houver um auto de infração no meio do caminho, o prazo se estende. Por isso eu guardo tudo, sempre, e nunca apago nada com menos de 6 anos. Arquivo de nota ocupa pouco espaço; perder um custa caro.

Quem recebe a nota também guarda. O destinatário deve conferir se a NF-e é válida e autorizada e mantê-la em arquivo. Se você compra de fornecedor, o XML dele é seu documento de entrada. Prazos estaduais podem ser maiores em situações específicas, então confirme com o seu contador.

#Como organizar os XMLs sem virar bagunça?

Com um passo a passo que você monta uma vez e segue todo mês:

1. Centralize a emissão. Se você usa o emissor do ML, ele já guarda as notas no painel. Se usa ERP ou emissor próprio, confira se ele exporta os XMLs por período.
2. Peça o XML de toda compra. Combine com cada fornecedor que a nota chega por e-mail com o arquivo XML anexo, não só o PDF.
3. Separe em pastas por ano, mês e tipo: vendas, compras, devoluções e canceladas. Ex.: 2026/10/vendas.
4. Faça cópia em dois lugares. Um na nuvem, outro num disco externo ou num segundo serviço. O Ajuste SINIEF permite guardar fora da empresa.
5. Mande para o contador até o dia combinado. O DAS do Simples vence no dia 20 do mês seguinte, e o contador precisa das notas antes disso.
6. Confira as notas recebidas. Consulte pela chave de acesso as notas de fornecedor novo. Nota cancelada ou inexistente não gera crédito e pode esconder golpe.

Se você ainda emite sem sistema, veja as opções em emissor de nota fiscal gratuito. E se o assunto é a nota em si (quem emite, CFOP, quando é obrigatória), comece por nota fiscal eletrônica (NF-e) e por CFOP para venda online.

#O que o XML tem a ver com a sua margem?

Tudo o que você paga para ter o produto está no XML de compra, e esse é o número que mais se erra na conta do lucro. Frete do fornecedor, IPI e ICMS-ST entram por cima do preço da tabela, e o quanto pesam muda de produto para produto. Quem calcula a margem com o preço da tabela, e não com o custo da nota, acha que ganha mais do que ganha.

A Milewa não emite nota nem lê o arquivo da Sefaz. O que ela faz é usar o custo que você lança, com custo médio e histórico de compras, para calcular a margem real de cada pedido do Mercado Livre e da Shopee, já com comissão da categoria, custo de envio cobrado, taxa fixa, imposto do seu regime, embalagem e ADS. Lançando o custo que está no XML, a margem que aparece na tela é a que cai no caixa. Para testar um preço antes, a calculadora faz a mesma conta por anúncio.

Regras fiscais mudam por estado e por regime, e a reforma tributária já mexe nos campos da nota desde 2026. Para dúvida sobre o que destacar no seu XML, o caminho é o contador.