Um script em Python que junta muitos arquivos CSV e Excel em uma tabela só, com as colunas alinhadas

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

Exportações mensais, relatórios de filiais, arquivos de vários fornecedores: quando os mesmos dados chegam em dezenas de arquivos CSV e Excel, copiar tudo à mão para uma tabela é lento e fácil de errar. Este script em Python lê todos os arquivos da pasta que você definir, incluindo várias abas de uma mesma pasta de trabalho, alinha as colunas pelo nome, inclui uma coluna com o arquivo de origem e salva um único arquivo CSV ou Excel. A partir do Padrão, ele lida com colunas que têm nomes diferentes em arquivos diferentes e mantém um log das linhas que não conseguiu ler. Envie dois ou três arquivos de exemplo com algumas linhas cada. Você mesmo roda o script no seu computador. O Excel comporta até 1.048.576 linhas por aba, então um resultado maior é salvo em CSV.

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 a sua pasta e os nomes das colunas; o código também aparece na página do pedido.
• CSV e Excel juntosArquivos dos dois tipos em uma pasta, várias abas por pasta de trabalho
• Colunas alinhadasPelo nome, mesmo quando a ordem muda entre os arquivos
• Coluna de origemCada linha mostra de qual arquivo veio
• Codificações e separadoresVírgulas ou pontos e vírgulas, UTF-8 ou codificações antigas do Windows
• Código legívelCom comentários, fácil de incluir uma coluna depois

Como funciona

1. 1
   ExemplosVocê envia dois ou três arquivos de exemplo e diz como o resultado deve ficar
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê roda em uma cópia da sua pasta e confere os totais
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Dois ou três dos arquivos que você junta, reduzidos a algumas linhas (troque nomes ou valores reais, se quiser), mais ou menos quantos arquivos são e de que tamanho, e como deve ser o resultado: CSV ou Excel, quais colunas e em que ordem, e se as linhas repetidas devem ficar. Se os arquivos forem diferentes (outros nomes de colunas, linhas extras de cabeçalho), um exemplo de cada tipo. O seu sistema: Windows, macOS ou Linux.

Vamos perguntar:

• Quais arquivos você junta?
• Como o resultado deve ficar?
• Os arquivos são diferentes entre si?
• Onde ele vai rodar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte