Um script em Python que transforma o extrato CSV do seu banco no formato de importação que o seu programa de contabilidade 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

Os bancos exportam extratos no próprio layout de CSV, e os programas de contabilidade querem o deles: outros nomes de colunas, datas como DD.MM.AAAA ou AAAA-MM-DD, um valor com sinal de menos ou débito e crédito separados, uma codificação específica. Este script em Python converte o extrato que você baixa do internet banking no arquivo de importação do seu programa, pelo modelo ou arquivo de exemplo que esse programa fornece. A partir do Padrão, ele também pode colocar cada lançamento em uma categoria pelas suas regras, como pagamentos que mencionam Aluguel vão para Aluguel. Ele roda no seu computador e nunca se conecta ao seu banco nem ao programa de contabilidade; você baixa o extrato e importa o resultado você mesmo. Ele muda só o layout, não os valores, e não dá orientação contábil ou fiscal. Confira os totais depois da primeira importação.

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 colunas e regras de categorias; o código também aparece na página do pedido.
• O formato do seu programaPelo modelo de importação ou por um arquivo de exemplo dele
• Datas e valores certosFormatos, sinais e separadores decimais convertidos
• Categorias pelas suas regrasA partir do Padrão, palavras-chave que você define
• Fica no seu computadorNenhuma conexão com o banco nem com outro lugar
• Código legívelCom comentários, fácil de incluir uma regra depois

Como funciona

1. 1
   AmostrasVocê envia linhas inventadas no layout do seu banco e o modelo do seu programa
2. 2
   CódigoEscrevemos o script e o guia para rodá-lo
3. 3
   TesteVocê converte um extrato, importa em uma empresa ou período de teste e confere os totais
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

A linha de cabeçalho e de 10 a 20 linhas do CSV do seu banco com valores, nomes e números de conta inventados, mas no mesmo layout, o nome do seu programa de contabilidade e o modelo de importação dele, a página de documentação ou um arquivo de exemplo que ele aceite. Para o Padrão, as suas regras de categorias (quais palavras vão para qual categoria). Para o Premium, uma amostra de cada banco ou conta. Nunca envie extratos reais, números de conta nem dados de acesso ao banco.

Vamos perguntar:

• Qual exportação do banco você tem?
• Qual programa de contabilidade, e qual o formato de importação dele?
• Você precisa de categorias?
• Quantos bancos ou contas?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte