Skrypt Google Apps Script, który pobiera potrzebne kursy walut do Twojego Arkusza Google z wybranego przez Ciebie źródła

Przykładowy rezultat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Folder: sales/2026-10, znaleziono 9 plików
2026-11-02 09:14:03 INFO  shop-01.csv: 1284 wiersze
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 wierszy
2026-11-02 09:14:04 WARN  shop-07.csv: pominięto 3 wiersze bez ceny (linie 88, 412, 913)
2026-11-02 09:14:05 INFO  Gotowe: 10 412 wierszy -> report-2026-10.xlsx (arkusze „Sprzedaż” i „Podsumowanie”)

[columns]
date = Data, Data sprzedaży, Dzień
product = Produkt, Towar, Nazwa
quantity = Ilość, Szt., Liczba sztuk
price = Cena, Cena jedn.

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Wczytuje plik jednego sklepu i nadaje mu nazwy kolumn raportu."""
    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}: brak kolumny dla '{name}' (szukano: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

O usłudze

Jeśli Twoje ceny, faktury lub raporty zależą od kursów walut, łatwo zapomnieć o wpisywaniu ich każdego ranka. Ten skrypt Google Apps Script odczytuje kursy z wybranego przez Ciebie publicznego źródła, na przykład kursy publikowane przez Twój bank centralny lub serwis kursowy, w którym masz własny klucz, i zapisuje potrzebne waluty w Twoim Arkuszu Google z datą. Od pakietu Standard prowadzi kartę historii z wierszem na każdy dzień, dzięki czemu Twoje formuły mogą sprawdzić kurs z dowolnej daty; pakiet Premium dodaje drugie źródło na wypadek, gdyby pierwsze nie odpowiadało, i uzupełnia daty wsteczne. Arkusze Google mają własną funkcję GOOGLEFINANCE dla niektórych walut; ten skrypt jest na wypadek, gdy potrzebujesz konkretnego źródła lub zapisanej historii. Kursy pochodzą ze źródła; nie udzielamy porad finansowych.

Co obejmuje usługa

• Co otrzymaszArchiwum ZIP z kodem Apps Script i plikiem README, który pokazuje, jak dodać go do arkusza, zezwolić na dostęp i ustawić codzienne uruchamianie; kod widać też na stronie zamówienia.
• Twoje źródłoKursy oficjalne lub z serwisu, który wybierzesz
• Twoje walutyTylko te, których potrzebujesz, względem Twojej waluty bazowej
• Historia z datamiOd pakietu Standard wiersz na każdy dzień do wyszukiwania
• Klucz poza kodemJeśli źródło go wymaga, wpisujesz go sam
• Czytelny kodZ komentarzami, łatwo później dodać walutę

Jak to działa

1. 1
   ŹródłoPodajesz waluty i źródło, któremu ufasz
2. 2
   KodPiszemy skrypt według dokumentacji źródła i instrukcję instalacji
3. 3
   WypróbujUruchamiasz go w kopii arkusza i porównujesz ze stroną źródła
4. 4
   ZmianyZgłaszasz poprawki w ramach pakietu i przesyłasz ewentualny komunikat o błędzie

Czego potrzebujemy od Ciebie

Potrzebne waluty i Twoja waluta bazowa, źródło, z którego chcesz korzystać (link do strony lub dokumentacji, gdzie publikuje kursy, albo nasza propozycja publicznych źródeł do wyboru), jak często i o której godzinie potrzebujesz kursów i gdzie mają trafiać w arkuszu. Jeśli potrzebujesz dat wstecznych (Premium), od jakiej daty. Jeśli źródło wymaga klucza, utwórz go na swoim koncie; nigdy nam go nie przesyłaj.

Zapytamy Cię:

• Jakich walut potrzebujesz?
• Z jakiego źródła ma korzystać?
• Jak często i do kiedy?
• Czy potrzebujesz dat wstecznych?

Porównaj pakiety

Pytania i odpowiedzi

Nie ma tu odpowiedzi? Zapytaj nas