https://github.com/gnneto/nf-analyzer

Script Python para extrair dados de Notas Fiscais Eletrônicas (XML) e gerar Excel consolidado, com foco na extração de informações financeiras, como vencimentos e valores, para uma análise mais detalhada e eficiente. mantendo formatação numérica.
https://github.com/gnneto/nf-analyzer

data-analysis excel finance nf-analyzer pandas python xlm

Last synced: 2 months ago
JSON representation

Script Python para extrair dados de Notas Fiscais Eletrônicas (XML) e gerar Excel consolidado, com foco na extração de informações financeiras, como vencimentos e valores, para uma análise mais detalhada e eficiente. mantendo formatação numérica.

• Host: GitHub
• URL: https://github.com/gnneto/nf-analyzer
• Owner: gnneto
• Created: 2025-10-04T21:29:58.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-10-04T21:40:15.000Z (9 months ago)
• Last Synced: 2025-10-13T11:52:50.947Z (8 months ago)
• Topics: data-analysis, excel, finance, nf-analyzer, pandas, python, xlm
• Language: Python
• Homepage:
• Size: 3.91 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Análise Financeira de Notas Fiscais Eletrônicas (NF-e)

Este projeto realiza a leitura e análise de arquivos XML de Notas Fiscais Eletrônicas (NF-e), com foco na extração de informações financeiras, como vencimentos e valores, para uma análise mais detalhada e eficiente.

## Funcionalidades

- Leitura de arquivos XML de NF-e em uma pasta específica.

- Extração de informações financeiras, como parcelas, vencimentos e valores.

- Consolidação dos dados em um arquivo Excel (`notas.xlsx`) para facilitar a análise.

- Formatação de datas e valores monetários no padrão brasileiro.

- Evita duplicação de registros com base no número da nota e parcela.

## Como usar

1. **Pré-requisitos**:

   - Python 3.7 ou superior.

   - Bibliotecas necessárias: `pandas`, `openpyxl`.

   Para instalar as dependências, execute:

   ```bash

   pip install pandas openpyxl

   ```

2. **Estrutura do projeto**:

   - Certifique-se de que os arquivos XML das NF-e estão em uma pasta chamada `nfs` no mesmo diretório do script.

   - O script gera ou atualiza o arquivo `notas.xlsx` no mesmo diretório.

3. **Execução**:

   - Execute o script `NF_Vendas.py`:

     ```bash

     python NF_Vendas.py

     ```

   - O arquivo `notas.xlsx` será gerado ou atualizado com os dados extraídos.

## Observações

- **Foco financeiro**: O projeto prioriza a análise de vencimentos e valores das parcelas, permitindo uma visão detalhada das obrigações financeiras.

- **Namespace**: O script trata namespaces nos arquivos XML (NFe) automaticamente.

- **Formatação**: Datas são formatadas no padrão `DD/MM/AAAA` e valores monetários no formato brasileiro `1.234,56`.

## Estrutura do Arquivo Excel

O arquivo gerado (`notas.xlsx`) contém as seguintes colunas:

- **Numero NF**: Número da nota fiscal.

- **Data Emissao**: Data de emissão da nota.

- **Destinatario**: Nome do destinatário.

- **Parcela**: Número da parcela (se aplicável).

- **Vencimento**: Data de vencimento da parcela (se aplicável).

- **Valor parcela**: Valor da parcela (se aplicável).

- **Valor total NF**: Valor total da nota fiscal.

- **Forma pgto**: Forma de pagamento.

- **Emitente**: Nome do emitente.