← Portfólio

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.

TipoPessoal
PapelConcepção e desenvolvimento
PeríodoMai/2026
EstadoConcluído
TecnologiasReact · TypeScript · Vite · Tailwind CSS · fast-xml-parser

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.

Editor de XML de NF-e com um produto de demonstração e seus campos de edição abertos
Captura do editor publicado. O produto e os valores exibidos são fictícios.Ampliar imagem ↗

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.

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.

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.

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.

Uma ideia em movimento?

Vamos transformar a próxima pergunta em algo que funciona.

Conversar sobre um projeto ↗