Software & automação · estudo de caso
Editor de XML de NF-e
Uma ferramenta no navegador para ajustar XMLs de NF-e que o ERP recusa por formatação, sem enviar o arquivo a nenhum servidor.
Visão geral
O projeto em poucas palavras
O Editor de XML de NF-e é uma ferramenta web para carregar um arquivo de Nota Fiscal Eletrônica (versão 4.00), corrigir o que impede a importação em um sistema de gestão (ERP), como o Bling, e baixar o resultado. Tudo acontece no navegador: o arquivo não é enviado a um servidor.
A ferramenta está no ar em editor-xml-nfe-danfe.vercel.app.
Desafio
O ponto de partida
Um XML de nota fiscal costuma passar por planilhas e outras ferramentas antes de chegar ao ERP, e pequenos estragos aparecem no caminho: zeros à esquerda somem de CNPJs, inscrições estaduais e NCMs; a chave e outros códigos longos viram notação científica; e a ordem das tags deixa de seguir o esquema oficial. O resultado é a mensagem de “estrutura inválida” na importação, sem indicar qual campo causou o problema.
Solução
Como funciona
A pessoa carrega o XML e navega por seções que espelham a nota: identificação, emitente, destinatário, produtos, totais, transporte, pagamento, cobrança e observações. Cada item pode ser editado com os impostos por produto (ICMS, IPI, PIS e COFINS), e é possível adicionar ou remover itens, com a numeração ajustada, e recalcular os totais.
Três recursos cuidam dos problemas mais comuns:
Limpeza automática: campos como CNPJ, CPF e inscrição estadual aceitam apenas números.
Diagnóstico de integridade: aponta campos obrigatórios ausentes, avisa quando o arquivo possui protocolo de autorização (e, portanto, será alterado) e detecta chaves corrompidas por notação científica.
Reordenação das tags: ao baixar, o editor organiza os elementos na ordem exigida pelos validadores do esquema, evitando o erro de estrutura no ERP.
Uma visualização do XML gerado, em tempo real, permite conferir o resultado antes do download.
Meu papel
Decisões e limites
Construí a ferramenta com React, TypeScript e Vite, e usei um leitor e gerador de XML que preserva atributos e a estrutura da nota. O foco é o XML: apesar de o nome do repositório mencionar o DANFE, o aplicativo não gera esse documento.
A segunda decisão foi ser explícito sobre o que a ferramenta não resolve. Editar uma nota já autorizada tem consequências fiscais, e deixar isso claro na interface era parte do produto.
Resultados
Resultado
Uma ferramenta pequena e específica, pública e gratuita, que resolve uma dor recorrente de quem importa notas em sistemas de gestão. Ela não tem contas, banco de dados nem etapa de instalação.
