Um script em Python que transforma o seu arquivo de produtos em um CSV para o importador de produtos nativo do WooCommerce

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

O WooCommerce tem o próprio importador de produtos, mas ele espera as próprias colunas: Type, SKU, Name, Regular price, Categories com > entre os níveis, imagens como links e, para roupas ou outras opções, um produto pai mais uma linha por variação ligada por Parent. Este script em Python transforma a tabela de preços do seu fornecedor, uma exportação de outra loja ou a sua própria planilha nesse arquivo. Ele mapeia as suas colunas, monta as categorias e, a partir do Padrão, produtos variáveis com atributos como tamanho e cor, e lista as linhas sem preço, SKU ou imagem. As imagens precisam estar em links que o seu site consiga baixar. Você mesmo roda o importador no painel do WordPress; nunca entramos no seu site. Teste antes com alguns produtos e mantenha um backup da sua loja.

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.
• As colunas do WooCommerceComo o importador de produtos nativo as espera
• Variações ligadasA partir do Padrão, produtos pai com tamanhos e cores
• Categorias aninhadasRoupas > Feminino > Vestidos, como o WooCommerce lê
• 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 em uma cópia da sua loja ou em um site de teste
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 seu arquivo de produtos, como as opções estão escritas nele (uma linha por tamanho ou os tamanhos em uma célula), a sua árvore de categorias, onde estão as imagens (links ou arquivos já na biblioteca de mídia do WordPress) e como os preços devem ser definidos. Uma exportação de alguns produtos da sua loja WooCommerce ajuda as colunas a baterem exatamente. O seu sistema: Windows, macOS ou Linux.

Vamos perguntar:

• Que arquivo você tem hoje?
• Os seus produtos têm opções?
• Qual é a sua árvore de categorias?
• Onde estão as imagens?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte