Um script em Python que transforma as suas exportações de contatos em um CSV limpo, pronto para importar no seu serviço de e-mail marketing

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

Contatos exportados de uma loja, de um CRM ou de inscrições em eventos raramente batem com o que um serviço de e-mail marketing quer importar: outros nomes de colunas, nome e sobrenome em uma célula, tags em lugares estranhos, pessoas que se descadastraram ainda na lista. Este script em Python lê as suas exportações e grava um único CSV limpo no layout de importação do seu serviço: nomes separados, se necessário, campos e tags mapeados, e-mails com formato inválido e duplicados deixados de fora e, a partir do Padrão, só as pessoas com marca de consentimento mantidas e as descadastradas removidas, com um arquivo das linhas descartadas para você conferir. Ele é para os seus próprios contatos, que concordaram em receber notícias suas, nunca para listas compradas ou coletadas de sites. Ele roda no seu computador e não se conecta ao serviço; você mesmo importa o arquivo.

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 o mapeamento de campos e tags; o código também aparece na página do pedido.
• O layout do seu serviçoPelo modelo de importação ou por um arquivo de exemplo dele
• Consentimento respeitadoA partir do Padrão, só quem concordou, sem descadastrados
• Sem duplicados e erros de digitaçãoEndereços com formato inválido e repetidos deixados de fora
• Linhas descartadas guardadasUm arquivo separado mostrando o que ficou de fora e por quê
• Código legívelCom comentários, fácil de incluir um campo depois

Como funciona

1. 1
   AmostrasVocê envia linhas inventadas de cada exportação e o formato de importação do seu serviço
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê roda, confere as linhas descartadas e importa uma pequena lista de teste
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

O cabeçalho e de 10 a 20 linhas de cada exportação com nomes e e-mails inventados, mas no mesmo layout, qual coluna mostra o consentimento e qual mostra o descadastro, o serviço de e-mail marketing que você usa e o modelo de importação dele ou um link para a página de ajuda de importação, e como as tags ou os segmentos devem ser definidos. Como os contatos foram reunidos (sua loja, formulário de inscrição, eventos). Nunca envie a lista real.

Vamos perguntar:

• De onde vêm os contatos?
• Em qual serviço de e-mail marketing você vai importar?
• Como o consentimento é registrado?
• Você precisa de tags ou segmentos?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte