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 arquivo de NF-e pode precisar de revisão antes de entrar em um sistema de gestão. Campos de identificação podem chegar com pontuação, códigos longos podem ser alterados por planilhas e a estrutura XML pode precisar de ajustes para o fluxo do ERP. Muitas mensagens de importação não apontam com clareza o campo a revisar.
Solução
Como funciona
A pessoa carrega no navegador um XML de NF-e 4.00 de até 10 MB 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 revisado; variantes tributárias que o formulário não edita ficam preservadas e sinalizadas. O editor também aceita vários detalhes de pagamento e permite adicionar ou remover produtos.
Três recursos cuidam dos problemas mais comuns:
Ajuste de formatação: uma ação corrige pontuação e completa zeros à esquerda em identificadores numéricos selecionados.
Diagnóstico local: confere a sintaxe XML e algumas seções/campos, avisa sobre protocolo de autorização e aponta chaves digitadas em notação científica.
Reorganização e prévia: os principais grupos são ordenados, o XML gerado pode ser conferido e o arquivo pode ser baixado.
A ferramenta não executa validação XSD completa nem consulta a SEFAZ. O recálculo dos totais é auxiliar e deve ser conferido em uma ferramenta fiscal antes da importação.
Meu papel
Decisões e limites
Construí a ferramenta com React, TypeScript e Vite, e usei fast-xml-parser para validar a sintaxe, ler e gerar o XML. O recálculo monetário usa centavos inteiros para evitar erro de ponto flutuante. 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 específica, disponível na web, para revisar dados de uma NF-e no próprio navegador. O arquivo não é enviado pelo aplicativo a uma API do projeto; não há contas, banco de dados do usuário nem etapa de instalação. O repositório não declara licença para reutilização do código.


