Como ler e utilizar o XML da nota fiscal eletrônica

Entender o XML da nota fiscal ajuda a conferir compras, cumprir obrigações fiscais e manter os documentos da loja organizados, sem depender de impressões ou buscas manuais.

Resposta rápida

O XML da nota fiscal é o arquivo digital que registra os dados estruturados da NF-e, como emitente, destinatário, itens, tributos, transporte, cobrança, assinatura e autorização fiscal. Para usá-lo, baixe o arquivo do emissor ou do portal fiscal, abra-o em um leitor próprio ou editor de texto e confira a validade da assinatura e do protocolo. Quando precisar compartilhar uma representação visual, converta o XML em PDF ou gere o DANFE, lembrando que o PDF não substitui o XML original. A loja deve guardar os arquivos pelo prazo legal e manter um processo organizado para localização e conferência.

Resumo

• O XML registra a NF-e em formato digital, estruturado e com validade fiscal.
• A assinatura digital e o protocolo da SEFAZ ajudam a comprovar autoria e autorização.
• Leitores próprios facilitam a leitura, enquanto editores mostram o conteúdo bruto.
• O PDF é útil para visualização, mas o XML original deve ser preservado.
• A consulta pode ser feita pelo portal fiscal, com certificado digital e chave de acesso quando solicitados.

O que é o XML da nota fiscal?

O XML da nota fiscal é o arquivo digital que representa a NF-e e reúne, de forma organizada, os dados da operação comercial. Ele tem validade contábil e fiscal quando é autorizado, assinado e preservado conforme as exigências aplicáveis.

XML significa Extensible Markup Language, uma linguagem de marcação recomendada pela W3C para criar documentos com dados organizados hierarquicamente. No contexto do varejo, o XML da nota fiscal é a versão digital da NF-e propriamente dita, diferente do DANFE, que é a representação visual usada para acompanhar ou consultar a operação.

Dentro desse arquivo ficam os elementos que descrevem a venda ou compra: quem emitiu, quem recebeu, quais itens foram informados, como os tributos foram calculados e qual foi o resultado do processamento fiscal. Por isso, o XML interessa tanto à loja que vende quanto à empresa que recebe mercadorias.

A autorização da Secretaria de Estado da Fazenda acrescenta ao arquivo o protocolo de processamento e outros dados que comprovam que a NF-e foi validada e possui valor fiscal. Sem essa etapa, ter um arquivo com aparência correta não basta para demonstrar que a operação foi autorizada.

O arquivo também precisa ser tratado como documento, não como um simples anexo. O Portal da Nota Fiscal Eletrônica informa que a empresa é responsável por armazenar os XMLs das notas recebidas e emitidas pelo período exigido por lei: 5 anos, além do ano vigente. Imprimir a NF-e não substitui essa guarda digital.

Na rotina de uma loja, a organização faz diferença. Separar os arquivos por período, fornecedor, cliente ou chave de acesso torna mais simples responder a uma solicitação fiscal, conferir uma compra, localizar uma devolução ou esclarecer uma divergência no cadastro. A LojistaPro recomenda que esse cuidado faça parte do fluxo de faturamento, com emissão, armazenamento e monitoramento no mesmo ambiente de gestão.

Quais informações estão no XML da NFe?

O XML da NF-e reúne informações cadastrais, comerciais, tributárias e financeiras da operação. A quantidade de detalhes depende dos campos preenchidos na emissão, mas o arquivo deve permitir identificar a transação e seu tratamento fiscal.

Dados do emissor e destinatário

O grupo inicial reúne dados gerais da nota, como data de emissão, número, série, tipo e finalidade. Esses campos ajudam a reconhecer a operação antes mesmo da leitura dos produtos e dos valores.

Na identificação do emitente aparecem informações da empresa que realizou a emissão, incluindo CNPJ, inscrição estadual e endereço. No destinatário ficam os dados da pessoa ou empresa para quem a nota foi emitida, como CNPJ ou CPF, inscrição estadual quando aplicável e endereço.

Essa conferência é especialmente útil no recebimento de mercadorias. Compare a razão social, o documento e o endereço do XML com o pedido, o cadastro do fornecedor e o estabelecimento que efetivamente receberá os itens. Um dado cadastral incorreto pode dificultar escrituração, devolução ou contato posterior.

Informações sobre produtos e serviços

Cada item informado pode trazer descrição, código de barras, CFOP, NCM, CEST, quantidade e preço. Esses campos conectam o documento fiscal à mercadoria cadastrada na loja e ajudam a conferir se o que foi faturado corresponde ao que foi comprado ou vendido.

A descrição sozinha não deve ser o único critério de conferência. Código, unidade, quantidade e valor precisam ser analisados em conjunto, principalmente quando existem variações de tamanho, cor, modelo ou apresentação. Uma leitura cuidadosa reduz divergências entre entrada fiscal, estoque e contas a pagar.

No comércio eletrônico, essa checagem também protege a expedição. O pedido pode ter sido registrado em um canal digital, enquanto a NF-e é emitida pelo sistema de gestão. Se os itens do XML não correspondem ao pedido, a correção deve ocorrer antes do envio ou da escrituração.

Impostos e encargos

O XML informa os tributos aplicados à operação, que podem incluir ICMS, PIS, COFINS, IPI e II, conforme a natureza da transação e o enquadramento fiscal. Também aparecem bases, alíquotas, valores e códigos que explicam o tratamento dado a cada item.

Depois da discriminação dos produtos e tributos, a NF-e apresenta a totalização da operação. Essa parte permite confrontar o valor dos itens, descontos, frete, acréscimos e impostos com o total cobrado ou pago.

A leitura não substitui a orientação do profissional responsável pela escrita fiscal. Porém, a equipe da loja pode identificar sinais práticos de erro, como total diferente do pedido, código fiscal incompatível com o cadastro ou imposto inesperado, antes de encaminhar o documento para conferência.

Dados de transporte e cobrança

Quando preenchidos na emissão, os campos de transporte registram a empresa responsável, modalidade e informações relacionadas ao deslocamento. Eles ajudam a conectar a NF-e ao pedido de coleta, à entrega e aos documentos usados na logística.

Na parte de cobrança e pagamento, podem aparecer duplicatas, parcelas, formas de pagamento e valores. Essa informação é importante para comparar o documento fiscal com o lançamento financeiro e evitar que uma compra seja registrada com vencimento ou valor incorreto.

O emitente ainda pode acrescentar informações adicionais sem campo específico, inclusive observações de controle interno. Elas devem ser lidas com atenção, mas não substituem os campos oficiais nem corrigem, por si só, uma informação fiscal preenchida de forma errada.

Como é a estrutura do arquivo XML?

A estrutura do XML funciona como uma árvore. O elemento raiz contém grupos maiores, e cada grupo abriga elementos menores, chamados tags. Em vez de apresentar os dados como uma página pronta para impressão, o arquivo descreve cada informação por sua função, permitindo que sistemas diferentes interpretem o conteúdo.

No leiaute informado pelo Manual de Orientação ao Contribuinte da NF-e em vigor em 2026, o XML deve seguir a recomendação W3C XML 1.0 e usar codificação UTF-8. Isso favorece a leitura correta de acentos, símbolos e caracteres comuns nos cadastros brasileiros.

Cada arquivo deve conter uma única declaração XML. O manual também exige um namespace único no elemento raiz, seguindo o padrão portalfiscal.inf.br/nfe. Esses detalhes parecem técnicos, mas são importantes para que o documento seja reconhecido pelos sistemas fiscais e validado contra o leiaute esperado.

A validação técnica ocorre com um Schema XML, também chamado XSD. A Secretaria da Fazenda do Paraná descreve a submissão do arquivo a esse esquema disponibilizado pela SEFAZ como parte do fluxo técnico. O XSD funciona como uma espécie de contrato: verifica se tags, formatos e relações estão de acordo com a estrutura prevista.

Ao abrir o documento, é comum encontrar blocos de identificação, emitente, destinatário, itens, tributos, total, transporte, cobrança, informações adicionais, assinatura e protocolo. A ordem visual pode parecer confusa no começo, mas ela acompanha a lógica da operação e permite que um sistema faça a leitura automática.

Uma boa prática é não editar o XML manualmente. Alterar uma tag, remover um trecho ou salvar o arquivo com codificação inadequada pode comprometer a validação e a assinatura. Se houver erro, o caminho correto é solicitar a correção ou a emissão adequada ao responsável, preservando o arquivo original.

Como abrir e ler um arquivo XML?

Para abrir e ler um XML, use um leitor específico quando quiser uma visualização organizada ou um editor de texto quando precisar examinar o conteúdo bruto. Em ambos os casos, preserve o arquivo original e evite alterações.

Usando leitores de XML online

Leitores de XML online permitem abrir o arquivo diretamente no navegador, sem instalar programa. Em geral, eles exibem a árvore do documento e permitem expandir ou recolher os nós, o que facilita localizar emitente, destinatário, item, imposto, total e protocolo.

Esse formato é útil para uma conferência rápida, especialmente quando a loja recebeu muitos arquivos e precisa confirmar dados antes de lançar a entrada. Há leitores que processam XML de NF-e, NFC-e, CT-e e SPED, mostrando as informações essenciais para a apuração fiscal.

Antes de enviar um documento a qualquer serviço online, verifique a política de privacidade e a necessidade real de compartilhar dados fiscais. O XML pode conter CNPJ, CPF, endereço, valores, condições de pagamento e informações comerciais. Para documentos sensíveis, prefira um ambiente sob controle da empresa ou um sistema de gestão com armazenamento próprio.

O leitor ajuda a enxergar o conteúdo, mas não deve ser usado para alterar o arquivo. Faça o download da fonte oficial, confira se o documento corresponde à operação e mantenha a versão original arquivada após a consulta.

Abrindo com editores de texto

O XML também pode ser aberto no Bloco de Notas do Windows, no TextEdit do Mac, no VS Code ou no Sublime Text. Outra alternativa é arrastar o arquivo para navegadores como Chrome, Edge, Firefox ou Safari. O conteúdo será exibido como texto ou como uma árvore simples, dependendo do programa.

A vantagem do editor é mostrar todos os dados acessíveis no arquivo. A desvantagem é a leitura menos amigável: tags, códigos e blocos repetidos podem dificultar a identificação de um item ou valor. Para uma inspeção pontual, ele resolve; para rotina fiscal, uma visualização estruturada tende a ser mais eficiente.

Procure primeiro a identificação da nota, o emitente, o destinatário, os itens e a totalização. Em seguida, confira os tributos, a assinatura e o protocolo. Use a busca do editor para encontrar termos como CNPJ, xNome, vNF, chNFe ou nProt, lembrando que os nomes técnicos podem variar conforme o grupo consultado.

Não salve o arquivo depois de fazer anotações nele e não troque sua extensão para tentar convertê-lo. O XML deve continuar íntegro. Se precisar de uma apresentação mais clara para outra pessoa, gere uma cópia em PDF sem substituir o documento fiscal original.

1. Baixe o XML diretamente do emissor ou do portal fiscal.
2. Escolha um leitor estruturado ou um editor de texto confiável.
3. Localize os grupos de identificação, itens, tributos e totalização.
4. Confira assinatura, protocolo e correspondência com a operação.
5. Preserve o arquivo original em uma pasta organizada.

Como converter XML para PDF?

Para converter XML em PDF, envie o arquivo a uma ferramenta de conversão ou use uma função de exportação disponível no sistema que armazena os documentos. O resultado costuma ser um DANFE ou uma representação visual, útil para leitura e compartilhamento, mas sem substituir o XML.

O processo começa com a seleção do XML correto. Confira o nome do arquivo, a chave de acesso e os dados básicos antes de converter. Em uma compra, isso evita transformar o documento errado e encaminhar ao financeiro ou ao estoque uma representação que não corresponde ao recebimento.

Ferramentas online podem converter XML de NF-e e CT-e para PDF sem exigir conta ou login. Também existem soluções que transformam vários arquivos em uma única operação e entregam os PDFs individualmente ou em um arquivo compactado. Para uma loja com movimento elevado, essa possibilidade reduz tarefas repetitivas.

Depois de gerar o PDF, abra o documento e confira se a leitura está completa. Observe nome das partes, itens, valores, tributos, chave de acesso e protocolo. Se o arquivo vier cortado, com campos sobrepostos ou sem informações essenciais, refaça a conversão em outro ambiente ou consulte o XML diretamente.

O PDF serve para apresentar o conteúdo de forma visual, imprimir quando houver necessidade operacional ou anexar a uma comunicação interna. A obrigação de guarda continua ligada ao XML autorizado. Portanto, mantenha os dois arquivos relacionados, com nomes padronizados e uma pasta que permita localizar o original.

No LojistaPro, o monitor de XML integra o acompanhamento dos documentos fiscais ao ambiente de gestão da loja. Essa centralização ajuda a aproximar faturamento, estoque e financeiro, reduzindo a dependência de pastas dispersas e conferências feitas apenas por planilha.

1. Selecione o XML autorizado que será convertido.
2. Escolha a opção de conversão ou exportação para PDF.
3. Gere a representação visual do documento.
4. Abra o PDF e compare os principais dados com a operação.
5. Salve o PDF junto do XML original, sem substituir o arquivo fiscal.

Qual a importância da assinatura digital no XML?

A assinatura digital demonstra que a NF-e foi vinculada à empresa que a transmitiu e ajuda a preservar a integridade do arquivo. Ela é gerada a partir do certificado digital da empresa e participa da validação do documento antes da autorização fiscal.

No XML, a assinatura aparece depois das informações da nota. Ela funciona como uma evidência técnica de autoria e integridade: se o conteúdo relevante for alterado depois da assinatura, a verificação tende a apontar inconsistência.

A assinatura não deve ser confundida com a autorização da SEFAZ. São etapas relacionadas, mas diferentes. O certificado identifica e assina a transmissão; a Secretaria de Estado da Fazenda processa a NF-e e, quando autoriza, acrescenta o protocolo e dados que confirmam o valor fiscal do documento.

Ao receber uma nota, a loja deve evitar confiar somente no nome do arquivo ou em uma imagem enviada por mensagem. O ideal é conferir o XML, verificar a situação da NF-e no ambiente fiscal adequado e relacionar o documento à compra efetivamente realizada.

Se a assinatura estiver ausente, inválida ou incompatível, interrompa o lançamento até entender o problema. Uma correção pode exigir novo envio ou outro procedimento do emitente. A SEF de Minas Gerais, por exemplo, informa que o cancelamento de uma NF-e pode exigir a geração de um arquivo XML específico, o que mostra por que cada evento deve ser tratado dentro do fluxo fiscal correspondente.

Para a operação diária, o melhor resultado vem de um processo que registre o documento original, sua autorização e seus eventos. Assim, a equipe não precisa reconstruir a história da nota a partir de anexos espalhados ou capturas de tela.

1. Obtenha o XML transmitido pelo emitente.
2. Confira a presença da assinatura digital no arquivo.
3. Verifique o protocolo de autorização da SEFAZ.
4. Compare a situação fiscal com a operação registrada.
5. Guarde o XML e os eventos relacionados no mesmo histórico.

Como consultar o XML da NFe?

A consulta do XML da NF-e pode ser feita pelo portal fiscal correspondente, normalmente com a chave de acesso e, para o download do arquivo, certificado digital quando exigido. O caminho mais seguro é consultar a nota em ambiente oficial e salvar o XML autorizado junto aos registros da loja.

Comece reunindo os dados da operação: chave de acesso, identificação do emitente, destinatário e data aproximada. A chave de acesso usada em consultas de NF-e possui 44 dígitos, por isso uma única troca pode impedir a localização do documento. Copie e cole a sequência sempre que possível, em vez de digitá-la manualmente.

No portal de consulta, informe a chave e complete a autenticação solicitada. A consulta resumida pode mostrar situação, emitente, destinatário e valores gerais. Para obter o arquivo completo, o ambiente pode exigir certificado digital vinculado à empresa ou ao responsável autorizado.

O portal da SVRS informa que a consulta completa oferece o botão Download Arquivo da NF-e, permitindo baixar o XML com certificado digital. O mesmo ambiente reúne especificações técnicas, leiaute, serviços e notas técnicas evolutivas para documentos fiscais eletrônicos.

Depois do download, renomeie o arquivo sem remover sua extensão e adote um padrão que facilite a pesquisa. Uma organização por ano, mês, fornecedor ou filial pode funcionar bem, desde que seja consistente. Registre também a relação entre a nota, o pedido de compra, o lançamento financeiro e a entrada no estoque.

Para notas recebidas, não dependa apenas do fornecedor enviar o arquivo por e-mail. Estabeleça uma rotina de conferência e recuperação no ambiente fiscal. Para notas emitidas, mantenha o XML autorizado disponível desde a transmissão e acompanhe rejeições, cancelamentos, cartas de correção e demais eventos aplicáveis.

A consulta também é um momento de decisão. Se a nota não aparece, se o protocolo diverge ou se os dados não correspondem ao pedido, não avance automaticamente. Separe o documento para análise e procure o responsável fiscal ou o emissor antes de escriturar, pagar ou expedir.

Com uma plataforma em nuvem voltada a lojas físicas e virtuais, a LojistaPro reúne faturamento, monitoramento de XML, estoque e financeiro em uma gestão integrada. O próximo passo é avaliar se o fluxo atual permite localizar, conferir e acompanhar cada documento sem retrabalho.

1. Reúna a chave de acesso e os dados básicos da operação.
2. Acesse o portal fiscal adequado à NF-e.
3. Informe a chave de acesso e conclua a autenticação.
4. Baixe o XML completo usando certificado digital quando solicitado.
5. Confira autorização, assinatura e correspondência com o pedido.
6. Arquive o XML e relacione-o ao estoque e ao financeiro.

• Conferir uma nota recebida antes de dar entrada na mercadoria → Abra o XML em um leitor estruturado, compare emitente, itens, impostos e total com o pedido e só depois conclua o lançamento.
• Compartilhar a nota com alguém que precisa apenas visualizar os dados → Converta uma cópia para PDF, mas mantenha o XML autorizado arquivado junto do documento visual.
• Localizar uma NF-e diretamente no ambiente fiscal → Use a chave de acesso, conclua a autenticação solicitada e faça o download do arquivo completo quando o portal permitir.
• Reduzir retrabalho com documentos fiscais da loja → Adote um fluxo integrado para emissão, monitoramento de XML, estoque e financeiro, como a gestão em nuvem oferecida pela LojistaPro.

Leia também

• como emitir nota fiscal em Campinas
• como realizar a emissão de nota fiscal como microempreendedor individual
• guia para escolher o melhor sistema ERP para pequenas empresas

Perguntas frequentes

O XML da nota fiscal substitui o DANFE?

Não. O XML é o arquivo digital estruturado e tem validade contábil e fiscal quando autorizado. O DANFE é uma representação visual da NF-e, útil para acompanhamento e leitura, mas não substitui o XML original.

Preciso imprimir o XML da NF-e?

Não. O arquivo deve ser preservado digitalmente pelo prazo legal. O Portal da Nota Fiscal Eletrônica informa que não é necessário imprimir os XMLs das NF-e recebidas.

Por quanto tempo devo guardar o XML?

A orientação apresentada neste artigo é guardar os arquivos por 5 anos, além do ano vigente. A responsabilidade pela guarda é da empresa, que deve manter os documentos acessíveis e íntegros.

Posso abrir o XML no Bloco de Notas?

Sim. O Bloco de Notas mostra o conteúdo bruto do arquivo, assim como outros editores de texto. Para localizar informações com mais facilidade, um leitor estruturado costuma oferecer uma visualização mais clara.

Converter XML para PDF elimina a obrigação de guardar o XML?

Não. O PDF é uma cópia visual para consulta ou compartilhamento. Preserve o XML autorizado, porque ele é o arquivo fiscal estruturado e contém assinatura e protocolo.

O que fazer se a assinatura digital estiver inválida?

Evite lançar ou usar o documento como se estivesse regular. Confira se o arquivo é o original, consulte a situação fiscal e peça ao emitente ou ao responsável fiscal que analise a correção necessária.

Como baixar o XML de uma NF-e consultada?

Acesse o portal fiscal, informe a chave de acesso e conclua a autenticação. Na consulta completa, o download pode exigir certificado digital, conforme o ambiente utilizado.

O XML pode ser editado para corrigir um dado?

Não é recomendável editar o arquivo. Uma alteração pode comprometer a assinatura e a validade do documento. Quando houver erro, solicite o procedimento fiscal adequado ao emitente e preserve o original.

Glossário

XML: Linguagem e formato de arquivo usado para organizar dados da NF-e em uma estrutura que sistemas conseguem interpretar.

NF-e: Nota Fiscal Eletrônica que registra uma operação comercial e é transmitida para autorização fiscal.

DANFE: Representação visual simplificada da NF-e, usada para acompanhar e consultar a operação.

SEFAZ: Secretaria de Estado da Fazenda responsável pelo processamento e autorização fiscal conforme a operação.

Assinatura digital: Mecanismo vinculado ao certificado digital que comprova autoria e ajuda a preservar a integridade do XML.

Protocolo de autorização: Registro acrescentado após o processamento fiscal, indicando que a NF-e foi autorizada.

XSD: Schema usado para validar se a estrutura e os campos do XML seguem o leiaute esperado.