🎯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:
- Dados gerais importados do Tiny
- Resumo por Pedidos - Visão consolidada sem duplicatas
- Vendas por Cliente - Ranking com ticket médio
- Produtos Mais Vendidos - Análise de performance de
- Pedidos por Situação - Distribuição de status
- Vendas Mensais - Evolução temporal
- Pedidos sem Entrega - Problemas operacionais
- 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
2. Configurar Token
Edite o arquivo import_pedidos.py e substitua o token:
🚀Como Usar
Execução Básica
# 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
- data_final: Data limite para importação
- arquivo_excel: Nome do arquivo de destino
- tamanho_bloco: Quantidade de pedidos por bloco
- situacao: Filtro por situação do pedido
✅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
- Verifique se o token está correto
- Confirme se o token tem permissões para acessar pedidos
- Teste o token diretamente na API Tiny
Erro de Dependências
# pip uninstall pandas requests openpyxl
# pip install pandas requests openpyxl
Performance Lenta
-
Reduza o
tamanho_blocopara processar menos pedidos por vez -
Aumente o intervalo entre requisições (
time.sleep) - Use filtros de data mais específicos
🎉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
- 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