Um Google Apps Script que carrega as taxas de câmbio de que você precisa na sua planilha do Google a partir de uma fonte que você escolher

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

Se os seus preços, faturas ou relatórios dependem de taxas de câmbio, digitá-las toda manhã é fácil de esquecer. Este Google Apps Script lê as taxas de uma fonte pública que você escolher, como as cotações que o seu banco central publica ou um serviço de câmbio em que você obtém a sua própria chave, e grava as moedas de que você precisa na sua planilha do Google com a data. A partir do Padrão, ele mantém uma aba de histórico com uma linha por dia, para as suas fórmulas buscarem a taxa de qualquer data; o Premium inclui uma segunda fonte se a primeira não responder e preenche datas passadas. O Planilhas Google tem a própria função GOOGLEFINANCE para algumas moedas; este script é para quando você precisa de uma fonte específica ou de um histórico guardado. As taxas são as da fonte; não damos orientação financeira.

O que está incluído

• O que você recebeUm arquivo ZIP com o código do Apps Script e um README que mostra como adicioná-lo à sua planilha, autorizar o acesso e programá-lo para rodar todo dia; o código também aparece na página do pedido.
• Sua fonteAs cotações oficiais ou do serviço que você escolher
• Suas moedasSó as de que você precisa, em relação à sua moeda base
• Um histórico datadoA partir do Padrão, uma linha por dia para consultas
• Chave fora do códigoSe a fonte exigir uma, você mesmo a coloca
• Código legívelCom comentários, fácil de incluir uma moeda depois

Como funciona

1. 1
   FonteVocê indica as moedas e a fonte em que confia
2. 2
   CódigoEscrevemos o script pela documentação da fonte e o guia de instalação
3. 3
   TesteVocê roda em uma cópia da planilha e compara com o site da fonte
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

As moedas de que você precisa e a sua moeda base, a fonte que você quer usar (um link para a página ou a documentação onde ela publica as taxas, ou deixe que sugerimos fontes públicas para você escolher), com que frequência você precisa das taxas e em que horário, e onde elas devem ficar na sua planilha. Se você precisar de datas passadas (Premium), a partir de qual data. Se a fonte pedir uma chave, crie-a na sua conta; nunca a envie para nós.

Vamos perguntar:

• De quais moedas você precisa?
• Qual fonte ele deve usar?
• Com que frequência e até que horas?
• Você precisa de datas passadas?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte