📊 NF-e Consolidator

Consolide notas fiscais eletrônicas em segundos. Extraia dados de arquivos XML e gere planilhas profissionais automaticamente.

✨ Características

• ✅ Processamento em lote - Processa múltiplos XMLs de uma vez
• ✅ Extração automática - Chave, datas, CNPJ/CPF, empresa, número e valor
• ✅ Interface gráfica - Aplicativo desktop amigável em Tkinter
• ✅ Sem configuração - Selecione pasta e gere a planilha
• ✅ Portável - Executáveis disponíveis para Windows (32 e 64 bits)
• ✅ Resistente a erros - Continua processando mesmo se um XML falhar

---

📋 Requisitos

• Python 3.11+ (caso execute o código-fonte)
• Windows, macOS ou Linux
• Dependências:
  • pandas - Manipulação de dados
  • openpyxl - Geração de planilhas Excel
  • pyinstaller - Empacotamento (apenas para compilar)

---

🚀 Instalação

Opção 1: Usar o Executável (Recomendado)

1. Baixe o executável em Releases
2. Descompacte o arquivo
3. Execute NF-e-Consolidator.exe ou NF-e-Consolidator-x86.exe (32 bits)
4. ✅ Pronto!

Opção 2: Executar do Código-Fonte

1. Clone o repositório:

   git clone https://github.com/PedroNettoDs/NF-e-Consolidator.git
   cd NF-e-Consolidator

2. Crie um ambiente virtual (opcional, mas recomendado):

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # macOS/Linux
   source venv/bin/activate

3. Instale as dependências:

   pip install -r requirements.txt

4. Execute o aplicativo:

   python app.py

---

📖 Como Usar

Passo 1: Preparar os arquivos

Coloque todos os arquivos XML de NF-e em uma pasta:

minha_pasta_notas/
├── nf_001.xml
├── nf_002.xml
├── nf_003.xml
└── ...

Passo 2: Abrir o aplicativo

Execute o programa (executável ou python app.py)

Passo 3: Processar

1. Clique em "Selecionar Pasta" e escolha a pasta com os XMLs
2. Clique em "Gerar XLSX"
3. Aguarde a conclusão - a planilha será salva com o nome Resultado.xlsx na mesma pasta

Passo 4: Verificar resultado

Abra Resultado.xlsx no Excel, Google Sheets ou similar

---

📊 Dados Extraídos

O arquivo Resultado.xlsx contém as seguintes colunas:

Campo	Descrição
Chave	Chave de acesso da NF-e
Emissão	Data de emissão
Emitente CNPJ/CPF	CNPJ ou CPF do emitente
Emitente	Razão social da empresa emitente
Destinatário CNPJ/CPF	CNPJ ou CPF do destinatário
Destinatário	Razão social da empresa destinatária
Número	Número da nota fiscal
Valor	Valor total da nota

---

🛠️ Compilar Executável

Se deseja criar seu próprio executável:

Windows 64 bits

pip install pyinstaller
pyinstaller --onefile --windowed app.py

Windows 32 bits

Instale Python 32 bits e repita o comando acima.

Verifique a arquitetura do Python:

python -c "import struct; print(struct.calcsize('P')*8)"

Os executáveis estarão em dist/

---

🔧 Estrutura do Projeto

NF-e-Consolidator/
├── app.py              # Aplicativo principal com interface GUI
├── app.spec            # Configuração para PyInstaller
├── requirements.txt    # Dependências Python
├── README.md          # Este arquivo
└── dist/              # Executáveis compilados (após build)

---

⚠️ Troubleshooting

Erro: "Nenhum XML encontrado"

• Verifique se os arquivos têm extensão .xml (minúsculas)
• Certifique-se de que estão na pasta selecionada

Erro: "Falha ao processar arquivo"

• O arquivo XML pode estar corrompido
• Verificar o console para mensagens de erro específicas
• O programa continua processando outros arquivos

Arquivo aberto no Excel impedindo geração

• Feche Resultado.xlsx antes de gerar uma nova versão

Aplicativo não abre

• Verifique se tem Python 3.11+ instalado
• Tente executar do código-fonte para ver mensagens de erro

---

🤝 Contribuindo

Contribuições são bem-vindas! Para ajudar:

1. Faça um Fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

Ideias para contribuições:

• Suporte a outros formatos (CSV, JSON)
• Filtros avançados de dados
• Suporte a múltiplos idiomas
• Melhorias na interface
• Testes automatizados

---

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

📧 Suporte

Encontrou um bug ou tem uma sugestão? Abra uma Issue

---

🙏 Agradecimentos

• Comunidade Python
• Documentação do Tkinter, pandas e openpyxl
• Todos que contribuem com feedback

---

Desenvolvido por Pedro Netto

Última atualização: Abril 2026