Um script em Python que transforma o arquivo de produtos do seu fornecedor ou da sua loja antiga em um CSV pronto para importar na Shopify

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

A Shopify importa produtos de um arquivo CSV, mas só no próprio layout: um Handle para um produto e todas as variantes, nomes e valores de opções em colunas definidas, imagens como links públicos. Este script em Python transforma o arquivo que você tem, a tabela de preços de um fornecedor, uma exportação da sua loja antiga ou o seu próprio Excel, nesse layout. Ele mapeia as suas colunas para as da Shopify, transforma tamanhos e cores em variantes a partir do Padrão, limpa preços e estoque e inclui tags. Ele segue o modelo atual de CSV de produtos da Shopify, que você pode baixar no seu painel. As imagens precisam estar em links que a Shopify consiga abrir. Você mesmo importa o arquivo na Shopify; nunca entramos na sua loja. Teste antes com alguns produtos: o resultado só é tão completo quanto os seus dados.

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 mapa de colunas; o código também aparece na página do pedido.
• O layout da ShopifyPelo modelo atual de CSV de produtos da Shopify
• Variantes agrupadasA partir do Padrão, tamanhos e cores dentro de um produto
• Preços e estoque limposNúmeros que a Shopify aceita, sem símbolos de moeda nem espaços
• Problemas listadosLinhas sem preço, SKU ou imagem são informadas
• Código legívelCom comentários, fácil de incluir uma coluna depois

Como funciona

1. 1
   ArquivosVocê envia uma amostra do seu arquivo de produtos e diz o que vai onde
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê importa alguns produtos na Shopify e confere
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

De 20 a 30 linhas do arquivo que você tem (tabela de preços do fornecedor, exportação da loja antiga ou a sua própria planilha), como as variantes estão escritas nele (uma linha por tamanho ou os tamanhos em uma célula), onde estão as imagens (links ou arquivos que você vai subir antes para a Shopify) e como os preços devem ser definidos. Se tiver, uma exportação de alguns produtos da sua loja Shopify, para as colunas baterem exatamente. O seu sistema: Windows, macOS ou Linux.

Vamos perguntar:

• Que arquivo você tem hoje?
• Como as variantes estão escritas nele?
• Onde estão as imagens?
• Como os preços devem ser definidos?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte