Como automatizar relatórios com Python? Este código lê suas planilhas, cria relatórios e envia eles por email

Neste artigo você vai aprender a automatizar relatórios com Python e o envio deles por e-mail com um código de 12 linhas.

Vamos ver como é possível criar relatórios a partir de dados em Excel e enviá-los automaticamente por e-mail usando o Outlook. Paraisso, vamos usar as bibliotecas Pandas e win32com.

Para fazer o download do(s) arquivo(s) utilizados na aula, preencha com o seu e-mail:

Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.

Por que automatizar relatórios com Python?

Automatizar a criação e o envio de relatórios elimina a necessidade de criar e enviar arquivos manualmente. Por isso, a automação de relatórios economiza tempo.

Outros pontos importantes são:

  • Eficiência: Gera relatórios personalizados para cada cliente ou área com um clique.
  • Escalabilidade: Funciona para bases pequenas mas também com milhares de linhas.
  • Personalização: Permite criar indicadores, como valores totais, e anexos específicos.
  • Integração: Usa o Outlook para envio sem configurações complexas de autenticação.

Essa abordagem é ideal para gerentes, analistas ou qualquer profissional que precise enviar relatórios periódicos.

Como configurar o ambiente?

Pra começar, você precisará das bibliotecas Pandas e openpyxl para manipular arquivos Excel, e pywin32 para integrar com o Outlook. Siga os passos:

  1. Instale as bibliotecas: pip install pandas openpyxl
    • A biblioteca win32com (parte do pywin32) geralmente já está incluída no Python para Windows, mas se necessário instale com: pip install pywin32
  2. Verifique o Outlook: Certifique-se de que o Outlook está instalado e configurado com uma conta de e-mail (pode ser um Gmail configurado no Outlook).

Como criar o código de automação?

O script abaixo realiza a automação completa: lê uma base de dados em Excel, filtra por cliente, gera relatórios personalizados e envia e-mails com anexos.

A base de dados deve ter colunas como "Cliente" e "Valor Total".

Python
import pandas as pd
import win32com.client as client
import os

# Ler a base de dados
tabela = pd.read_excel("base_dados.xlsx")

# Criar lista de clientes únicos
clientes = tabela["Cliente"].unique()

# Conectar ao Outlook
outlook = client.Dispatch("Outlook.Application")

# Para cada cliente, gerar relatório e enviar e-mail
for cliente in clientes:
    # Filtrar dados do cliente
    tabela_cliente = tabela[tabela["Cliente"] == cliente]
    
    # Calcular valor total
    valor_total = tabela_cliente["Valor Total"].sum()
    
    # Gerar relatório em Excel
    nome_arquivo = f"relatorio_{cliente.replace(' ', '')}.xlsx"
    tabela_cliente.to_excel(nome_arquivo, index=False)
    
    # Criar e-mail
    email = outlook.CreateItem(0)  # 0 indica um e-mail
    email.To = f"pythonimpressionador+{cliente.lower().replace(' ', '')}@gmail.com"
    email.Subject = f"Relatório da empresa {cliente}"
    email.Body = f"""
    Olá {cliente},
    Segue em anexo o relatório completo.
    Valor total: R$ {valor_total}
    Atenciosamente,
    Python L.
    """
    
    # Adicionar anexo com caminho completo
    caminho_arquivo = os.path.join(os.getcwd(), nome_arquivo)
    email.Attachments.Add(caminho_arquivo)
    
    # Enviar e-mail
    email.Send()

Explicação do código:

  • Leitura da base: pd.read_excel carrega o arquivo Excel (ex.: base_dados.xlsx).
  • Clientes únicos: tabela["Cliente"].unique() cria uma lista com valores únicos da coluna "Cliente" (ex.: Empresa A, Empresa B, Empresa C).
  • Filtro por cliente: Para cada cliente, filtra a tabela com tabela[tabela["Cliente"] == cliente].
  • Cálculo de indicadores: Soma a coluna "Valor Total" com .sum().
  • Geração de relatórios: to_excel cria um arquivo Excel para cada cliente, sem o índice (index=False).
  • Envio de e-mail: Usa win32com para criar um e-mail no Outlook, definir destinatário, assunto, corpo e anexo, e enviar com .Send().
  • Caminho do anexo: os.path.join concatena o caminho do diretório atual (os.getcwd()) com o nome do arquivo para garantir compatibilidade com o Outlook.

Se você quer aprender a usar pandas em Python do zero, passo a passo, confira nosso artigo introdutório.

Ícone PythonPython Impressionador

Você vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.

Black Friday · Lote Especial · Lote 1 · Último Lote

De R$ 1.497 56% OFF54% OFF53% OFF

por 12x R$ 6467,5069

Preço do Lote Especial por tempo limitadoPreço do Lote Especial só até amanhã, 13/11, às 23h59Preço do Lote Especial até 13/11, às 23h59Último dia do Lote Especial: o preço vale até hoje, às 23h59Preço do Lote 1 por tempo limitadoPreço do Lote 1 só até amanhã, 20/11, às 23h59Preço do Lote 1 até 20/11, às 23h59Último dia do Lote 1: o preço vale até hoje, às 23h59Preço do Último Lote por tempo limitadoPreço do Último Lote só até amanhã, 27/11, às 23h59Preço do Último Lote até 27/11, às 23h59Último dia do Último Lote: o preço vale até hoje, às 23h59

Começar agoraQuero a oferta de Black FridaySeta para a direita
Fundo PythonTelas Python
Luz Python

Como personalizar o relatório?

Como adicionar mais indicadores ou gráficos?
Além do valor total, você pode personalizar o relatório:

  • Indicadores: Calcule médias, máximos, mínimos, etc., usando métodos como tabela_cliente["Valor Total"].mean().
  • Gráficos: Use bibliotecas como Matplotlib ou Seaborn para criar gráficos e salvá-los como imagens para incluir no e-mail.
  • Corpo do e-mail: Adicione mais variáveis no corpo, como um resumo de vendas ou destaques.

Exemplo de cálculo adicional:

Python
valor_medio = tabela_cliente["Valor Total"].mean()
email.Body = f"""
Olá {cliente},
Segue em anexo o relatório completo.
Valor total: R$ {valor_total}
Valor médio: R$ {valor_medio:.2f}
Atenciosamente,
Python L.
"""

O que fazer se o e-mail não chegar?

Por que o e-mail pode demorar ou não aparecer?
Se o e-mail não chegar imediatamente:

  • Caixa de saída: Verifique a pasta "Caixa de Saída" no Outlook, pois o envio pode estar em processamento.
  • Configuração do Outlook: Certifique-se de que a conta de e-mail está ativa e configurada corretamente.
  • Erro no código: Confirme que o arquivo Excel foi gerado e que o caminho do anexo está correto.

Conclusão

Vimos aqui que com menos de 20 linhas de código podemos automatizar a criação de relatórios a partir de planilhas do Excel, além do envio desses relatórios por e-mail. Tudo isso usando Python e apenas duas bibliotecas, pandas e win32com.

Essa solução é prática e funcional para empresas que precisam enviar relatórios para diferentes clientes, filiais ou áreas, economizando tempo e mantendo a precisão.

Se quiser desenvolver mais esse código, experimente adicionar gráficos ou mais indicadores personalizados, por exemplo.

E se você gostou desse guia, vai gostar também dos nossos outros conteúdos sobre a biblioteca pandas. Também temos muitos guias e tutoriais sobre Python em geral!

Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

O que você aprende neste vídeo

Resposta rápida: A aula filtra uma base em Excel por cliente com pandas, gera uma planilha para cada um e manda cada arquivo por e-mail pelo Outlook, com o valor total do cliente no corpo. O caminho exige o Outlook instalado no computador e com uma conta já configurada, e os endereços dos clientes são simulados, porque a base do exemplo não os tem.

Neste vídeo (17 min):

  • 2:04 - Instalação do pandas e do openpyxl, porque a base está em Excel
  • 3:13 - A base entra no código com pd.read_excel
  • 4:37 - unique tira da coluna de clientes a lista sem repetição: empresa A, B e C
  • 5:43 - Um laço filtra a tabela de cada cliente, com a condição entre colchetes
  • 6:09 - A soma do valor total de cada cliente
  • 7:33 - Um arquivo Excel por cliente, gerado com to_excel e index=False
  • 8:06 - A conexão do código com o Outlook do computador
  • 9:47 - Endereços de teste, um para cada cliente
  • 10:29 - O nome do cliente em minúscula e sem espaço, com lower e replace, para caber no endereço
  • 11:24 - Assunto e corpo do e-mail com o nome e o valor total do cliente, o corpo em várias linhas entre três aspas
  • 12:22 - O relatório entra como anexo
  • 14:32 - O envio de cada e-mail dentro do laço
  • 16:09 - Os três e-mails chegam, cada um com o seu valor total e a sua planilha

Trechos do vídeo:

  • No anexo, só o nome do arquivo não basta: o Python sabe que o arquivo está na pasta em que o código roda, mas o Outlook não. O anexo leva o caminho completo, montado com os.path.join a partir de os.getcwd().
  • Enviando pelo Outlook do computador, o código não precisa configurar autenticação nem senha: o Outlook, com a conta já configurada nele, cuida disso, mesmo quando a conta é do Gmail.
  • Para testar o envio sem os e-mails reais dos clientes, a aula põe um + antes do @ de um endereço do Gmail, seguido de qualquer texto: a mensagem cai na caixa de entrada principal, e dá para ver para qual variante ela foi.
  • Se o código não deu erro e o e-mail não chegou depois de alguns minutos, ele pode estar na caixa de saída do Outlook, que às vezes demora um pouco para enviar.
  • Com a planilha na mesma pasta do código, o read_excel só precisa do nome do arquivo; em outro lugar, precisa do caminho completo.

Hashtag Treinamentos

Para acessar outras publicações de Python, clique aqui!


Quer aprender mais sobre Python com um minicurso básico gratuito?

Posts mais recentes de Python

Posts mais recentes da Hashtag Treinamentos