Como converter XML de NF-e em Excel, nota por nota e item por item

Todo mês a mesma cena: uma pasta com dezenas de XMLs de NF-e, alguém pedindo o resumo de compras e vendas (o cliente, o contador ou a própria diretoria) e pouco tempo para conferir. Abrir arquivo por arquivo não escala. Copiar valores à mão gera erro.
Neste artigo você vai ver o que existe dentro do XML da NF-e, quais campos viram colunas úteis no fechamento, como montar a planilha no xml2xlsx, como usar o resultado para mandar o lote ao contador ou acompanhar uma empresa e quais armadilhas costumam bagunçar os números.
O que tem dentro do XML da NF-e
O XML que o contador recebe normalmente é o arquivo de distribuição, com a tag raiz nfeProc. Segundo o Manual de Orientação do Contribuinte (MOC), ele reúne a NF-e assinada (NFe) e o protocolo de autorização ou denegação (protNFe).
Dentro de infNFe, os grupos que mais interessam são estes:
| Grupo | O que traz | Campos úteis no fechamento |
|---|---|---|
ide | Identificação da nota | mod, serie, nNF, dhEmi, tpNF (0 = Entrada, 1 = Saída), tpAmb |
emit | Emitente | CNPJ ou CPF, xNome, IE |
dest | Destinatário | CNPJ ou CPF, xNome |
det / prod | Cada item (até 990 por nota) | xProd, NCM, CFOP, qCom, vUnCom, vProd |
total / ICMSTot | Totais da nota | vProd, vDesc, vFrete, vNF |
protNFe | Protocolo de autorização | chNFe, nProt, dhRecbto, cStat |
Um recorte simplificado, com dados fictícios, ajuda a visualizar:
<nfeProc versao="4.00">
<NFe>
<infNFe Id="NFe35261199888777000100550010000012341000012340">
<ide><mod>55</mod><nNF>1234</nNF><dhEmi>2026-11-05T14:30:00-03:00</dhEmi><tpNF>1</tpNF><tpAmb>1</tpAmb></ide>
<emit><CNPJ>99888777000100</CNPJ><xNome>EMPRESA EXEMPLO LTDA</xNome></emit>
<det nItem="1"><prod><xProd>PRODUTO FICTICIO</xProd><NCM>00000000</NCM><CFOP>5102</CFOP><qCom>2.0000</qCom><vProd>150.00</vProd></prod></det>
<total><ICMSTot><vProd>150.00</vProd><vNF>150.00</vNF></ICMSTot></total>
</infNFe>
</NFe>
<protNFe><infProt><chNFe>35261199888777000100550010000012341000012340</chNFe><nProt>000000000000000</nProt></infProt></protNFe>
</nfeProc>
A chave de acesso tem 44 caracteres numéricos e é formada por UF, ano e mês, CNPJ ou CPF do emitente, modelo, série, número, forma de emissão, código numérico e dígito verificador. A chave do exemplo é inventada e não passa em nenhuma consulta.
Quais colunas importam no fechamento mensal
Para o fechamento, quase sempre você precisa de duas visões:
- Uma linha por nota: chave, número, série, modelo, data de emissão, emitente, destinatário, tipo de operação e valor total (
vNF). É a base para conferir faturamento, compras e livros fiscais. - Uma linha por item: descrição, NCM, CFOP, quantidade e valor. É onde aparecem erros de classificação, CFOP trocado e itens que não deveriam estar ali.
A separação em duas abas evita o problema clássico de repetir o valor total da nota em cada linha de item e somar tudo em dobro.
Passo a passo no xml2xlsx
O xml2xlsx é uma mesa de trabalho gratuita que funciona no navegador. Os XMLs são lidos no servidor só para extrair os dados e não ficam guardados lá; a conversa, com as notas e os arquivos, fica salva no seu próprio navegador. Não é preciso criar conta para usar.
1. Abra a mesa e solte os arquivos
Acesse a mesa e arraste os arquivos .xml para a área indicada, ou selecione-os pelo botão. A mesa aceita NF-e (modelo 55), NFC-e (65), CT-e (57), NFS-e Padrão Nacional e eventos como cancelamento e carta de correção. Cada conversa comporta até 2.000 notas, enviadas de 100 em 100.
2. Confira o Panorama
Assim que os arquivos são lidos, o Panorama mostra:
- o total marcado, considerando apenas notas válidas;
- o total válido da conversa;
- o total de canceladas, que fica fora da soma;
- chips por tipo de documento e uma tabela mensal por tipo.
O filtro de contexto Todas / Entrada / Saída usa como referência o CNPJ da empresa. A mesa sugere o CNPJ mais frequente no lote, e você pode trocá-lo se a empresa que você quer acompanhar for outra.
3. Revise os alertas
Antes de exportar, olhe os alertas: notas canceladas (quando o evento de cancelamento da mesma chave está no lote), duplicadas (mesma chave) e emitidas em homologação (tpAmb igual a 2). Um botão desmarca canceladas e duplicadas de uma vez, com opção de desfazer.
4. Investigue o que parecer estranho
Na tabela de notas você pode buscar e filtrar por tipo, emitente e data. Ao abrir uma nota, o painel de detalhe lista os itens com descrição, NCM, CFOP, quantidade e valor.
5. Exporte
Gere o XLSX com as abas "Notas", "Itens" e "Resumo por tipo". Se precisar entregar o pacote completo, o ZIP traz os XMLs originais, o XLSX e um arquivo LEIAME. A aba "Exportações" guarda o histórico daquela conversa, e o botão "Baixar de novo" refaz o arquivo com as mesmas notas.
Dois usos comuns da planilha
Se você vai mandar o lote ao contador
Muitas empresas juntam os XMLs do mês e repassam ao escritório de contabilidade. Antes de enviar, vale uma conferência rápida na mesa:
- junte as notas emitidas e as recebidas, as NFS-e de serviços tomados e os XMLs dos eventos de cancelamento do período;
- confira o Panorama e os alertas para ver se nada ficou faltando ou repetido;
- desmarque só as duplicadas. Deixe as canceladas marcadas: o ZIP leva cada uma com o seu evento de cancelamento, e a planilha mostra essas notas separadas das válidas;
- exporte o ZIP, que traz os XMLs originais sem alteração, o XLSX e o LEIAME com o resumo.
A contabilidade também precisa saber das notas canceladas, mesmo quando elas não representam receita. Combine com o seu contador o formato e a data de envio que funcionam melhor para o escritório.
Para acompanhar uma empresa pelo Panorama
Com a empresa de referência escolhida, o filtro Entrada / Saída mostra o que ela comprou e o que vendeu no período, e o detalhe de cada nota traz os itens com NCM, CFOP, ST e tributos. A aba "Itens" do XLSX permite repetir essa análise numa tabela dinâmica, agrupando por NCM, CFOP ou CST, e cruzar com a aba "Notas" pela chave para saber de quem é cada item.
Armadilhas comuns
A chave de 44 dígitos precisa ser texto
Planilhas tratam sequências longas de dígitos como número e, acima de 15 dígitos, perdem precisão. O resultado é uma chave com zeros no final ou em notação científica, que não serve para conferência nem para procurar a nota. Sempre que a coluna passar por outra ferramenta (importação CSV, cópia e cola, sistema contábil), garanta que ela esteja formatada como texto.
O mesmo vale para CNPJ, CPF, NCM e CEP: o leiaute da NF-e define esses campos com tamanho fixo e sem formatação, e um zero à esquerda perdido muda o código.
Separador decimal
No XML, os valores usam ponto como separador decimal (por exemplo, 150.00). Em uma planilha configurada em português, o separador é a vírgula. Se você copiar valores do XML para a planilha sem conversão, 1.500 pode virar mil e quinhentos em vez de um e meio. Confira sempre se a coluna de valor está como número antes de somar.
Datas e fuso horário
O campo dhEmi vem no formato AAAA-MM-DDThh:mm:ssTZD, com o deslocamento de fuso no final, como -03:00. Uma nota emitida às 23h30 do último dia do mês, no horário local, cai no dia seguinte se alguém converter tudo para UTC. Para o fechamento, o que costuma importar é a data no fuso em que a nota foi emitida. Se o seu sistema converter datas, confira as notas de virada de mês.
Total da nota não é a soma dos itens
O vNF do grupo ICMSTot não é simplesmente a soma de vProd dos itens. Pela regra de validação do leiaute, ele considera, entre outros, produtos, menos descontos e ICMS desonerado, mais ICMS-ST, frete, seguro, outras despesas, IPI e II. Além disso, o campo indTot de cada item indica se aquele valor compõe ou não o total.
Por isso, use o total da aba de notas para conferir faturamento e a aba de itens para análise por NCM ou CFOP. Se as duas somas não baterem, isso não é necessariamente erro: verifique frete, descontos e impostos antes de concluir. Em caso de dúvida sobre o tratamento contábil ou fiscal, confirme com a legislação do seu estado.
Notas de homologação misturadas
XMLs de teste aparecem com mais frequência do que se imagina. Em NF-e de homologação, o leiaute exige que o nome do destinatário seja "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL". Esses documentos não devem entrar no fechamento, e o alerta de homologação existe justamente para isso.
Comece pelo lote deste mês
Separe os XMLs do período, solte tudo na mesa e confira o Panorama antes de exportar. Em poucos minutos você tem a planilha, nota por nota e item por item, pronta para conferir, sem cadastro e sem guardar os XMLs no servidor. Abrir a mesa
Fontes
- Contabilidade.com: Preciso enviar as notas fiscais canceladas para o contador? (abre em nova aba)
- Portal Nacional da NF-e: Manuais (abre em nova aba)
- Manual de Orientação ao Contribuinte (MOC) versão 7.0, NF-e e NFC-e (PDF) (abre em nova aba)
- MOC 7.0, Anexo I: Leiaute e Regras de Validação, NF-e e NFC-e (PDF) (abre em nova aba)
- NF-e
- XML
- Excel
- fechamento mensal