🚀 Sistema de Importação e Relatórios de Pedidos

Integração completa com API Tiny ERP para análise de vendas

🎯Sistema Completo para Gestão de Pedidos

Este sistema Python oferece importação automatizada de pedidos da API Tiny ERP, prevenção inteligente de duplicatas e geração de relatórios analíticos em Excel.

🚫Prevenção de Duplicatas

Verificação Inteligente

Combina ID do pedido + ID do produto para evitar duplicatas de forma precisa

Importação Incremental

Só busca pedidos posteriores ao último registrado, otimizando performance

Remoção Automática

Remove duplicatas automaticamente mantendo os registros mais recentes

Auditoria de Dados

Script de verificação para auditar e limpar dados existentes

📊Sistema de Relatórios

9 Relatórios Individuais Disponíveis:

  1. Dados gerais importados do Tiny
  2. Resumo por Pedidos - Visão consolidada sem duplicatas
  3. Vendas por Cliente - Ranking com ticket médio
  4. Produtos Mais Vendidos - Análise de performance de
  5. Pedidos por Situação - Distribuição de status
  6. Vendas Mensais - Evolução temporal
  7. Pedidos sem Entrega - Problemas operacionais
  8. Vendas por Estado - Distribuição geográfica

🛠️Arquivos do Sistema

  • import_pedidos.py - Script principal de importação
  • import_produtos_estoque.py - Script de importação dos produtos e estoque
  • requirements.txt - Dependências do projeto

⚙️Instalação e Configuração

1. Instalar Dependências

pip install pandas requests openpyxl

2. Configurar Token

Edite o arquivo import_pedidos.py e substitua o token:

token = "SEU_TOKEN_AQUI" # Substitua pelo seu token da API Tiny
⚠️ Importante: Nunca compartilhe seu token da API. Mantenha-o seguro e privado.

🚀Como Usar

Execução Básica

# Executar importação completa
# python import_pedidos.py
# Gerar apenas relatórios (sem importar novos dados)
# python gerar_relatorios.py
# Verificar duplicatas
# python verificar_duplicatas.py

Configurações Disponíveis

Características Principais

Zero Duplicatas

Sistema inteligente de prevenção e remoção de duplicatas

Incremental

Só importa dados novos desde a última execução

Performance

Processamento em blocos para otimizar velocidade

Organizado

Relatórios salvos em pasta separada e bem estruturados

Flexível

Pode gerar relatórios sem necessidade de nova importação

Robusto

Tratamento de erros e backup automático dos dados

🔧Solução de Problemas

Erro de Token Inválido

Erro de Dependências

# Reinstalar dependências
# pip uninstall pandas requests openpyxl
# pip install pandas requests openpyxl

Performance Lenta

🎉Pronto para Usar!

O sistema está configurado e pronto para importar seus pedidos do Tiny ERP. Os relatórios serão gerados automaticamente após cada importação, fornecendo insights valiosos sobre suas vendas.

📞Suporte

Para dúvidas ou sugestões sobre este sistema, consulte a documentação da API Tiny ERP ou revise os comentários no código fonte dos scripts.

📝Exemplo de Uso Completo

1. Configurar o sistema
- token = "seu_token_aqui"
- data_final = "31/12/2024"
- arquivo_excel = "meus_pedidos.xlsx"

2. Executar
- python import_pedidos.py

3. Verificar resultados
- Arquivo principal: pedidos_detalhados.xlsx
- Logs de execução no terminal

4. Análise dos dados
- Abrir relatório consolidado
- Revisar vendas por cliente
- Analisar produtos mais vendidos