Um script em Python que transforma os seus arquivos CSV em JSON ou XML exatamente na estrutura que o seu sistema espera

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

Muitos sistemas só aceitam dados em JSON ou XML: uma importação para uma loja ou um CRM, o envio para um parceiro, um feed para um app. Este script em Python lê a sua exportação em CSV e grava o arquivo na estrutura de que você precisa: os nomes dos campos, quais campos ficam dentro de outros, números e datas nos tipos certos e a codificação. No Premium, ele também pode agrupar linhas em um único registro, como um pedido com todos os seus itens. Envie algumas linhas do CSV e um exemplo ou uma descrição do JSON ou XML que o outro lado quer (a documentação ou um arquivo de exemplo). Você mesmo roda o script no seu computador. Ele converte os dados que você passa: não envia o resultado para lugar nenhum nem o confere no outro sistema.

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 colunas para campos; o código também aparece na página do pedido.
• JSON ou XMLOu os dois lado a lado a partir de um CSV
• Sua estruturaNomes de campos e aninhamento como no seu exemplo ou na documentação
• Tipos certosNúmeros, true ou false, datas no formato de que você precisa
• Codificações resolvidasSaída em UTF-8 a partir de CSV em qualquer codificação comum
• Código legívelCom comentários, fácil de incluir um campo depois

Como funciona

1. 1
   AmostrasVocê envia algumas linhas do CSV e uma amostra do JSON ou XML de que precisa
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê converte o seu arquivo e testa no sistema que precisa dele
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

De 10 a 20 linhas do seu CSV (valores inventados servem) e como o resultado deve ficar: um arquivo JSON ou XML de exemplo, a parte da documentação do outro sistema que o descreve ou um schema XSD, se houver. Qual coluna vai para qual campo, como datas e números devem ser escritos e se várias linhas formam um registro. O seu sistema: Windows, macOS ou Linux.

Vamos perguntar:

• Para onde vai o JSON ou XML?
• Como é o CSV?
• Como o resultado deve ficar?
• Onde ele vai rodar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte