Um script em Python que monta um relatório curto a partir dos seus arquivos Excel e o envia por e-mail da sua própria caixa

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Se alguém no escritório abre o mesmo arquivo Excel toda manhã, copia os totais e os escreve em um e-mail, este script em Python pode fazer essa parte. Ele lê os arquivos que você indicar, como a exportação de vendas de ontem ou uma planilha de estoque em uma pasta compartilhada, calcula o que você pedir (totais, contagens, médias por loja ou produto, as linhas acima de um limite) e envia um e-mail curto com uma tabela organizada para as pessoas que você listar, da sua própria conta de e-mail, com o arquivo anexado a partir do Padrão. Você mesmo coloca a senha de envio da conta de e-mail nas configurações; ela nunca vai para o código. Os destinatários são os seus próprios colegas ou clientes, bem dentro dos limites de envio do seu serviço de e-mail. Ele informa os números dos seus arquivos; não os confere nem os explica.

O que está incluído

• O que você recebeUm arquivo ZIP com o script em Python, um README com instruções passo a passo e, a partir do Padrão, um arquivo de configurações com arquivos, destinatários e dados de e-mail; o código também aparece na página do pedido.
• Seus númerosTotais, contagens e médias que você escolher
• Um e-mail legívelUma tabela curta que abre no celular
• Da sua caixa de e-mailA sua própria conta de e-mail, com a senha fora do código
• Arquivo anexadoA partir do Padrão, o arquivo Excel ou um resumo dele
• Código legívelCom comentários, fácil de incluir um número depois

Como funciona

1. 1
   TarefaVocê envia um arquivo de exemplo e um modelo do e-mail que quer
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê roda só com o seu próprio endereço na lista
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Um dos arquivos Excel de onde o relatório sai, reduzido a algumas linhas ou com os números trocados, onde os arquivos aparecem (uma pasta, um drive compartilhado) e como são nomeados, o que o e-mail deve mostrar (escreva como faria à mão), quem o recebe e de qual conta de e-mail (dizer o serviço de e-mail basta; a senha você mesmo coloca). Quando ele deve sair, e o computador em que vai rodar: Windows, macOS ou Linux.

Vamos perguntar:

• De quais arquivos sai o relatório?
• O que o e-mail deve mostrar?
• Quem o recebe, e quando?
• Onde ele vai rodar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte