Skip to content

y918an/excel-report-automation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

📊 Excel Report Automation

Pipeline automatizado de geração de relatórios Excel com Python — execução agendada, formatação condicional, fórmulas complexas e zero intervenção humana.

Python Excel Agendado Status


📌 Sobre o Projeto

Solução completa para geração automática de relatórios Excel a partir de dados extraídos de APIs e bancos de dados. Desenvolvida para o setor bancário, com execução diária agendada às 02h00, garantindo que os relatórios estejam prontos no início do expediente — sem nenhuma intervenção manual.

Problema resolvido: analistas gastavam horas diárias copiando dados e formatando planilhas. Hoje o processo é 100% automático.


⚙️ Funcionalidades

  • Extração de dados — Conexão com SQL Server e APIs REST
  • Multi-abas — Geração de workbooks com múltiplas planilhas organizadas
  • Formatação condicional — Regras automáticas de cor por status/valor
  • Fórmulas complexas — Inserção e AutoFill de fórmulas Excel (SOMASE, PROCV, etc.)
  • Agendamento — Execução diária via Task Scheduler (Windows) ou cron (Linux)
  • Logging — Registro de execuções com status e erros
  • Tratamento de erros — Retry automático e notificação em caso de falha

🚀 Como Usar

1. Clone o repositório

git clone https://github.com/yaneskenazi/excel-report-automation.git
cd excel-report-automation

2. Instale as dependências

pip install -r requirements.txt

3. Configure o ambiente

DB_SERVER=seu_servidor
DB_NAME=sua_base
DB_USER=usuario
DB_PASSWORD=senha
API_URL=https://sua-api.com
OUTPUT_PATH=C:/Relatorios/

4. Execute

python main.py

🗂️ Estrutura do Projeto

excel-report-automation/ │ ├── main.py ├── config.py ├── requirements.txt ├── .env.example │ ├── extractors/ │ ├── sql_extractor.py │ └── api_extractor.py │ ├── builders/ │ ├── workbook_builder.py │ ├── formatter.py │ └── formula_engine.py │ ├── scheduler/ │ └── task_setup.py │ └── logs/ └── report_automation.log


🔑 Abordagem Técnica

Etapa Biblioteca Motivo
Criação do arquivo openpyxl Sem dependência do Excel instalado
Formatação condicional openpyxl Suporte nativo a regras
AutoFill de fórmulas xlwings openpyxl não suporta AutoFill real
Renderização final xlwings Garante que fórmulas calculem corretamente

🧰 Tecnologias

Tecnologia Uso
Python 3.10+ Linguagem principal
openpyxl Criação e formatação de Excel
xlwings AutoFill e renderização de fórmulas
pyodbc Conexão com SQL Server
requests Extração via API
schedule Agendamento de tarefas
python-dotenv Gerenciamento de credenciais

📄 Licença

MIT License — livre para uso e adaptação.


Desenvolvido por Yan Eskenazi · LinkedIn

About

utomated Excel report pipeline using Python — scheduled execution, conditional formatting, complex formulas

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors