Elbuz sam aktualizuje kursy walut — z banku narodowego kraju Twojej waluty głównej lub z Twojego źródła — i według nich przelicza ceny z cenników dostawców w walutach obcych.
Kiedy to się przyda:
- Dostawca wystawia cennik w dolarach, a Ty sprzedajesz w złotych — ceny przeliczają się po świeżym kursie jednym przyciskiem.
- Kurs ze źródła skoczył o ponad 30% — program nie zastosuje go, dopóki go nie potwierdzisz.
- Kupujesz walutę drożej niż po kursie bankowym — dodatek „BC + %” uwzględnia różnicę w cenie.
- Musisz wiedzieć, po jakim kursie liczono miesiąc temu — historia przechowuje kurs każdej waluty dzień po dniu.
Od czego zacząć: sprawdź źródło kursów i ustaw aktualizację według harmonogramu.
Co potrafi słownik walut
- Waluta główna — punkt odniesienia: w niej liczone są ceny katalogu, kwoty dokumentów i zysk.
- Automatyczna aktualizacja — kursy przychodzą według harmonogramu lub po kliknięciu ⟳; skok o ponad 30% nie jest stosowany sam.
- Gotowe źródła — banki narodowe, Europejski Bank Centralny, PrivatBank i zbiorczy kurs rynkowy.
- Własne źródło — kursy z Twojego systemu księgowego lub od banku pod linkiem.
- Własny kurs dla cennika — jeden dostawca liczony jest po swoim kursie, niezależnie od słownika.
- Przeliczanie cen — cenniki i katalog po nowym kursie jednym przyciskiem.
- Historia kursów — wykresy i odczyty dzień po dniu, domyślnie z dwóch lat.
Jak wybrać walutę główną
Jedna waluta w słowniku jest oznaczona jako główna. Jej kurs zawsze wynosi jeden i właśnie w niej program liczy wszystko: ceny katalogu, kwoty dokumentów, zysk. Kursy pozostałych walut odpowiadają na pytanie „ile waluty głównej kosztuje jedna jednostka tej waluty”.
Nie musisz jej szukać w tabeli: nad listą jest pasek podsumowania, który wprost pokazuje, ile jest walut, ile aktywnych, która jest bazowa, kiedy ostatnio aktualizowano kursy i jaki dostawca jest wybrany.
W tabeli jest też osobna kolumna „Waluta główna strony”. Można nią oznaczyć tylko jedną walutę: gdy zaznaczysz inną, z poprzedniej zaznaczenie znika. To oznaczenie nie jest przekazywane na Twoją stronę — co dokładnie jest eksportowane, opisano nieco niżej.
Walutę główną ustawia się raz, na starcie. Zmiana jej w działającym katalogu zmienia sens wszystkich cen: liczby zostają te same, ale zaczynają oznaczać coś innego. Jeśli walutę główną trzeba zmienić, najpierw przeczytaj, co stanie się z cenami katalogu i niezamkniętymi dokumentami — to zaraz poniżej.
Każda waluta w słowniku ma jeszcze kilka pól: kod (USD, EUR, PLN), symbole po lewej i prawej stronie kwoty, liczbę miejsc po przecinku w cenach, flagi aktywności, eksportu na stronę i pokazywania na stronie. Nieaktywne waluty nie są aktualizowane i nie biorą udziału w obliczeniach.
Co oznaczają kolumny „Eksport na stronę” i „Pokazuj na stronie”
- „Eksport na stronę” działa przy eksporcie przez tunel. Tunel przekazuje na stronę tylko te waluty, które mają zaznaczone i „Aktywność”, i to pole: kod, nazwę, kurs i oznaczenie waluty głównej w ewidencji. Waluta bez zaznaczenia nie trafia na stronę.
- „Pokazuj na stronie” i „Waluta główna strony” tunel w ogóle nie przekazuje. Nie wpływają na to, jakie waluty pokaże Twoja strona i w jakiej walucie się otwiera — to ustawia się w panelu administracyjnym samej strony.
Sklep Elbuz CMS dostaje waluty nie tunelem, ale razem z ustawieniami sklepu podczas eksportu. Trafiają tam wszystkie waluty z „Aktywność” i kursem.
„Pokazuj na stronie” decyduje, czy klienci zobaczą walutę. Waluta główna Elbuz staje się walutą główną sklepu i jest widoczna zawsze. „Eksport na stronę” nie działa na sklep Elbuz CMS.
Co stanie się z dokumentami, jeśli zmienisz walutę główną
Samo odznaczenie „Waluta główna” nic nie da: jeśli odznaczysz je w jedynej walucie głównej, program bez komunikatu przywróci poprzedni stan. Główną ustawia się inną walutę — wtedy z poprzedniej zaznaczenie znika samo.
W momencie zmiany program robi trzy rzeczy: odznacza poprzednią walutę główną, nowej ustawia kurs 1 i zeruje jej „BC + %”. W dokumentach, magazynach i rezerwacjach nie zmienia się przy tym ani jeden wiersz.
Dlatego niezamknięte dokumenty zostają policzone według starej logiki:
- kwota dokumentu i ceny w jego wierszach — te same liczby, w walucie samego dokumentu;
- kurs zapisany w dokumencie przy utworzeniu lub zatwierdzeniu też zostaje na miejscu — i to przez niego mnożone są wszystkie kwoty zbiorcze: rozrachunki z kontrahentem, kafelki, raporty;
- w efekcie zestawienia liczone są po kursie wziętym względem starej waluty głównej. Dopóki kurs w dokumencie nie zostanie poprawiony, podsumowania pokażą nie te liczby.
Dawna waluta główna zostaje z kursem 1 do pierwszej aktualizacji kursów: do tego czasu program traktuje ją jako równą nowej walucie głównej jeden do jednego. Po zmianie waluty głównej od razu kliknij ⟳.
Kurs pojedynczego dokumentu poprawia się na jego karcie, w polu „Kurs waluty”. Jeśli zmienisz walutę w dokumencie, program wstawi kurs z daty dokumentu: najbliższy wpis historii nie późniejszy niż ta data, a jeśli historii z tego okresu nie ma — bieżący kurs ze słownika. Kursu wpisanego ręcznie przy tym nie rusza.
Ceny katalogu i cenników po zmianie waluty głównej też zostają tymi samymi liczbami. Ale kolejne przeliczenie policzy ceny z cenników już od nowej waluty głównej: ma ona kurs 1, a liczby w cennikach zaczną oznaczać nową walutę.
Jak kursy aktualizują się same
Kursów nie wpisuje się ręcznie codziennie — pobiera je program. Źródło wybiera się w oknie dialogowym „Źródło kursów”, które otwiera się kliknięciem plakietki „Dostawca kursów” nad tabelą walut; jest ono jedno dla całego konta.
Z tego okna aktualizację uruchamia się na dwa sposoby: ręcznie przyciskiem ⟳ lub automatycznie według harmonogramu — menu ≡ → „Ustawienia harmonogramu”. Podczas pobierania kursów program pokazuje „Aktualizacja kursów walut, proszę czekać...”, a po zakończeniu — „Kursy walut zaktualizowane”.
Domyślnie ustawiona jest opcja „Automatycznie — według waluty głównej”: program sam wybiera bank narodowy kraju Twojej waluty głównej — dla złotego nbp.pl, dla hrywny bank.gov.ua, dla tenge nationalbank.kz, dla euro Europejski Bank Centralny, dla leja rumuńskiego bnr.ro, dla korony czeskiej cnb.cz, dla leja mołdawskiego bnm.md, dla liry tcmb.gov.tr, dla rubla białoruskiego nbrb.by.
Dla każdej innej waluty głównej — open.er-api.com. W nawiasie opcja pokazuje, jakie źródło jest teraz wybrane. Alpha Vantage usunięto z listy: u kogo był wybrany, kursy pobierane są teraz tak samo jak przy „Automatycznie”.
Kursy pochodzą z zapasu serwera, a nie za każdym razem z banku: według harmonogramu i przed importem cennika — odpowiedź źródła nie starsza niż 60 minut, przyciskiem ⟳ — nie starsza niż 5 minut. Dlatego po zmianie źródła wystarczy kliknąć ⟳, żeby dostać świeże dane.
Jeśli źródło nie odpowiedziało, program bierze ostatni dobry kurs z tego samego źródła, o ile nie jest starszy niż 24 godziny, i pokazuje nad tabelą „Kurs z dnia …, źródło nie odpowiedziało (…)”.
Jeśli nie ma i takiego — kursy zostają bez zmian, do historii nic się nie zapisuje, a nad tabelą i w „Dzienniku operacji” pojawia się „Źródło kursów „…” nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano. Wybierz inne źródło…”. Zerowy ani pusty kurs nigdy nie jest zapisywany.
Kurs zmienił się o ponad 30%
Gwałtowny skok kursu częściej oznacza błąd źródła niż prawdziwą zmianę, a od kursu zależą ceny.
Dlatego według harmonogramu, przed importem cennika i w procesach taki kurs nie jest stosowany sam: waluta zostaje ze starym kursem, a nad tabelą walut i w dzienniku pojawia się „Kurs nie został zastosowany automatycznie — zmiana przekracza 30%: USD 30 → 44.8871 (+49.6%). Sprawdź i kliknij „Pobierz kursy walut”, aby zastosować go ręcznie.”. Pozostałe waluty aktualizują się normalnie.
Taki kurs można zastosować tylko ręcznie: przycisk ⟳ pokaże pytanie „Kurs zmienił się o ponad 30%: … Zastosować nowy kurs? Od kursu zależą ceny produktów.” z przyciskami „Zastosuj” i „Anuluj”. Jeśli zmieniono walutę główną, ochrona jednorazowo nie działa: wszystkie kursy w uzasadniony sposób przeliczają się od nowej waluty głównej.
1
Ostrzeżenie o skoku kursu2
Pytanie „Zastosować nowy kurs?”3
Przycisk „Zastosuj”- Ostrzeżenie mówi, że nowy kurs różni się od bieżącego o ponad 30% i nie został zastosowany automatycznie.
- Okno pokazuje stary i nowy kurs i pyta, czy zastosować nowy, bo od niego zależą ceny produktów.
- „Zastosuj” przyjmuje nowy kurs; „Anuluj” zostawia bieżący.
Jakie źródło kursów wybrać
Zasada jest prosta: wybierz bank narodowy kraju, którego waluta jest u Ciebie główna. To kurs oficjalny — według niego liczy księgowość, a Twoja waluta główna na pewno w nim jest. Jeśli takiego banku nie ma na liście, wybierz open.er-api.com: zna ponad 160 walut i działa z każdą walutą główną.
| Opcja na liście | Waluta główna, z którą działa | Co warto wiedzieć |
|---|---|---|
| Automatycznie — według waluty głównej | dowolna | ustawiona domyślnie: bank narodowy kraju waluty głównej, w przeciwnym razie open.er-api.com |
| nationalbank.kz — Narodowy Bank Kazachstanu (KZT) | KZT, a także UAH, USD, EUR, PLN, BYN, MDL, RON, CZK, TRY | oficjalny kurs Narodowego Banku Kazachstanu |
| bank.gov.ua — Narodowy Bank Ukrainy (UAH) | UAH, a także KZT, USD, EUR, PLN, MDL, RON, CZK, TRY | oficjalny kurs NBU; nie ma w nim rubla białoruskiego |
| nbp.pl — Narodowy Bank Polski (PLN) | PLN, a także UAH, USD, EUR, RON, CZK, TRY | nie ma w nim tenge |
| ecb.europa.eu — Europejski Bank Centralny (EUR) | EUR, a także USD, PLN, RON, CZK, TRY | nie ma w nim hrywny ani tenge |
| bnr.ro — Narodowy Bank Rumunii (RON) | RON, a także UAH, USD, EUR, PLN, MDL, CZK, TRY | nie ma w nim tenge |
| cnb.cz — Czeski Bank Narodowy (CZK) | CZK, a także USD, EUR, PLN, RON, TRY | nie ma w nim hrywny ani tenge |
| bnm.md — Narodowy Bank Mołdawii (MDL) | MDL, a także UAH, KZT, USD, EUR, PLN, BYN, RON, CZK, TRY | oficjalny kurs Narodowego Banku Mołdawii |
| tcmb.gov.tr — Bank Centralny Turcji (TRY) | TRY, a także KZT, USD, EUR, RON | pobierany jest kurs sprzedaży; nie ma w nim hrywny, złotego ani korony czeskiej |
| open.er-api.com — ExchangeRate-API, 160+ walut, dowolna waluta główna | dowolna | nie kurs konkretnego banku, tylko zbiorczy kurs rynkowy; aktualizowany raz na dobę. Pasuje, gdy banku narodowego Twojego kraju nie ma na liście |
| liqpay.ua — PrivatBank, kurs sprzedaży (UAH) | UAH, USD lub EUR | kurs sprzedaży PrivatBanku, tylko dla dolara, euro i hrywny. Innych walut w nim nie ma |
| nbrb.by — Narodowy Bank Białorusi (BYN) | BYN, a także UAH, KZT, USD, EUR, PLN, MDL, CZK, TRY | oficjalny kurs Narodowego Banku Białorusi; nie ma w nim leja rumuńskiego |
| Własne źródło — z linku | dowolna, jeśli jest w odpowiedzi źródła | kurs z Twojego systemu księgowego lub od banku (własne źródło) |
Można też wybrać bank narodowy innego kraju — program przeliczy kursy przez Twoją walutę główną. Na przykład waluta główna to złoty, a źródło — Europejski Bank Centralny: publikuje on i dolara, i złotego w euro, więc kurs dolara w złotych program uzyska, dzieląc jeden przez drugi.
Warunek jest ten sam co dla własnego źródła: Twoja waluta główna musi być w tabeli banku. Jeśli jej tam nie ma — jak hrywny w Europejskim Banku Centralnym — nie zaktualizuje się żadna waluta, a w oknie pojawi się czerwony komunikat „Źródło kursów nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano.”.
Gotowe źródła mają 15 sekund na odpowiedź. Jeśli nie zdążą, zadziała zapas serwera z ostatnich 24 godzin, a jeśli go nie ma, kursy zostają bez zmian i aktualizację można powtórzyć później.
Aktualizowane są tylko aktywne waluty i tylko te, które nie są główną: waluta główna z definicji ma kurs jeden. Waluta, której nie ma w źródle, zostaje ze starym kursem — program o tym nie ostrzega, więc po zmianie źródła warto przejrzeć kolumnę „Data aktualizacji”.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Po aktualizacji kursów ceny produktów nie przeliczają się same. Przeliczenie uruchamia się osobno — przyciskiem z różdżką w tym samym oknie. Tak jest celowo: inaczej każdy ruch kursu przepisywałby cały katalog.
Jak ustawić własny kurs i co go nadpisze
Kurs poprawia się bezpośrednio w tabeli: dwuklik w komórkę „Kurs”, nowa wartość — i wiersz się zapisuje. Program zapisze ją, w kolumnie „Zmiana” pokaże różnicę względem starego kursu, w „Dacie aktualizacji” wstawi bieżący czas, a do historii doda wpis ze źródłem „Ręcznie” — jeśli wpisu z tego dnia jeszcze tam nie ma.
Ta wartość żyje dokładnie do następnej aktualizacji kursów: jest nadpisywana bez komunikatu, bez pytania i bez oznaczenia „tu poprawiano ręcznie”.
Nadpisać ją może nie tylko przycisk ⟳ — kursy pobiera też harmonogram, działanie „Aktualizuj kursy walut” w procesach Elbuz Flows, prośba do konsultanta AI o aktualizację kursów, a także import cennika, jeśli w ustawieniach włączono „Aktualizuj kurs przed importem” („Ustawienia systemu” → „Cenniki” → „Import i przetwarzanie”, domyślnie wyłączone).
Własny kurs można utrwalić na dwa sposoby i oba — poza słownikiem:
- Kurs dla jednego cennika. W ustawieniach kolumn cennika są pola „Kurs waluty” i „+%”. Jeśli w polu „Kurs waluty” jest wartość inna niż zero i jeden, słownik dla tego cennika nie jest w ogóle odpytywany — produkty przeliczą się po Twoim kursie, niezależnie od tego, co pokazuje słownik. Szczegóły: co ustawia się dla pojedynczej kolumny.
- Odznaczyć „Aktywność” waluty. Nieaktywnych walut źródło nie aktualizuje — ale wypadają one też z przeliczania cen: kurs takich walut nie jest stosowany do produktów, a cena zostaje w walucie pliku dostawcy.
1
Pole „Kurs waluty”2
Pole „+%”- Kurs waluty — kurs, po którym przeliczana jest cena z kolumny (44.8 dla USD).
- +% — narzut na ten kurs.
Ręczna zmiana kursu ma skutek uboczny w cennikach. Cenniki z zaznaczonym „Przetwarzaj cennik tylko wtedy, gdy zmieniły się dane w pliku”, w których cena lub RRP podane są w tej walucie, po zmianie kursu zaimportują się następnym razem nawet wtedy, gdy plik dostawcy się nie zmienił: program celowo zeruje zapisaną sumę kontrolną pliku, żeby ceny przeliczyły się po nowym kursie.
I dwie rzeczy, których program nie zrobi, choć o tym nie powie. Nazwy i kodu waluty ze standardowego zestawu nie można zmienić: pozostałe pola wiersza się zapiszą, a te dwa zostaną bez zmian. Takiej waluty nie da się też usunąć — pojawi się komunikat „Rekord usunięty”, wiersz zniknie z tabeli, ale po aktualizacji wróci. Niepotrzebną walutę wyłącza się polem „Aktywność”.
Jak podłączyć własne źródło kursów
Gotowe źródła nie pasują każdemu: u jednych kurs przychodzi z własnego systemu księgowego, u innych — z banku, z którym zawarto umowę. Na takie przypadki jest opcja własnego linku: podajesz adres, z którego program pobiera kursy, a dalej wszystko działa tak samo.
Wymagania wobec tego, co jest pod linkiem, są proste, ale ścisłe. Adres musi zwracać JSON z dwoma polami:
base— kod waluty, względem której podano kursy;rates— lista „kod waluty → kurs”.
Wygląda to mniej więcej tak:
{"base": "USD", "rates": {"UAH": 41.5, "EUR": 0.92, "PLN": 3.95}}
Na liście musi być kod Twojej waluty głównej. Bez niego program nie przeliczy kursów krzyżowych i nie zaktualizuje żadnej waluty, a w oknie pojawi się czerwony komunikat „Źródło kursów nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano.”. To najczęstsza przyczyna sytuacji „podłączyłem własne źródło, a kursy są stare”.
Dalej program sam liczy kursy krzyżowe: bierze kurs Twojej waluty głównej w źródle i dzieli go przez kurs każdej innej. Dlatego nie ma znaczenia, w jakiej walucie źródło prowadzi swoje base — byle Twoja waluta główna tam była.
Jeszcze dwa szczegóły, które ratują w trudnych przypadkach. Jeśli waluta w źródle ma inny kod niż u Ciebie, zadziała dodatkowy kod waluty — program szuka najpierw po kodzie głównym, potem po dodatkowym. Dotyczy to wszystkich walut oprócz głównej: jej kod w źródle musi być taki sam jak w słowniku. Poza tym na odpowiedź jest 30 sekund, więc źródło musi być szybkie.
Jak przeliczyć ceny po nowym kursie
Świeży kurs w słowniku sam w sobie niczego nie zmienia: ceny w cennikach i w katalogu zostają takie, jak je ostatnio policzono. Przeliczenie uruchamia osobny przycisk z różdżką w tym samym oknie — w podpowiedzi nazywa się „Zastosuj narzut dla produktów z cenników”.
1
Pobierz kursy walut2
Zastosuj narzut (różdżka)3
Menu dodatkowych operacji- Pobierz kursy walut — pobiera kursy od wybranego dostawcy.
- Różdżka — stosuje narzut do produktów z cenników; widoczna jest podpowiedź.
- Menu dodatkowych operacji — zawiera ustawienia harmonogramu.
Nie ma tu wyboru, co dokładnie przeliczać: przycisk bierze wszystkie aktywne cenniki aktywnych dostawców. Wyłączony cennik lub wyłączony dostawca jest pomijany bez komunikatu.
Dla każdego cennika program robi kolejno cztery rzeczy:
- przywraca cenę i RRP do wartości wyjściowych z pliku dostawcy — tych sprzed jakichkolwiek narzutów;
- wstawia kurs: najpierw ze słownika walut — razem z dodatkiem „BC + %”, tak samo jak przy imporcie cennika — a jeśli dla cennika ustawiono własny kurs w ustawieniach kolumn — ten kurs. Waluta z odznaczoną „Aktywnością” kursu nie daje: cena w niej zostaje w walucie pliku;
- ponownie stosuje wszystkie reguły narzutu tego cennika;
- przelicza formuły pól — najpierw reguły samego cennika, potem wspólne dla wszystkich cenników.
Po cennikach osobnym krokiem przeliczane są ceny produktów katalogu bazowego — ale według reguł narzutu KB od ceny zakupu, a nie z cennika. Nowa cena z cennika nie jest tym przebiegiem przenoszona do kart katalogu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Krok z kursem wykonuje się tylko dla tych cenników, na których liście narzutów jest rodzaj „Cena + kurs walut. Źródło ustawień: słownik walut + cennik.”. Bez tego rodzaju cennik przejdzie przeliczenie bez kursu, a ceny w nim zostaną poprzednie. To najczęstsza przyczyna sytuacji „kliknąłem, a część cenników się nie zmieniła”.
1
Cena + kurs walut- Pierwszy wiersz, „Cena + kurs walut”, bierze ustawienia ze słownika walut i z cennika.
Produktów katalogu bazowego z oznaczeniami „Stała cena” i „Nie aktualizuj” reguły narzutu KB nie ruszają — ich cena zostaje taka, jaką ustawiono ręcznie.
O przebiegu pracy program pisze w „Dzienniku operacji”: dla każdego cennika pojawia się wiersz „Zastosowanie narzutu/rabatu (bez importu cennika)”, a na końcu — „Zastosowanie narzutu/rabatu zakończone”. Jeśli ostatniego wiersza nie ma, przebieg nie dotarł do końca; część cenników jest przeliczona, część nie, a ponowne uruchomienie to naprawi.
Kolejki tu nie ma: przeliczenie idzie w tym samym zapytaniu, gdy okno czeka na odpowiedź. Na ten czas przycisk jest zablokowany, a na ekranie widnieje komunikat „Przetwarzanie danych, proszę czekać”; gdy wszystko się skończy, pojawi się „Operacja wykonana pomyślnie”. Jeśli zamkniesz okno, nie zobaczysz ani potwierdzenia, ani błędu i trzeba będzie zajrzeć do dziennika.
Limitu liczby produktów nie ma: każdy cennik program przelicza w całości, zestawem zapytań do bazy, a nie wiersz po wierszu.
Dodatek do kursu „BC + %”
W tabeli jest kolumna „BC + %” — procentowy dodatek do kursu. Przydaje się, gdy nie chcesz sprzedawać dokładnie po kursie źródła: kurs bankowy i kurs, po którym faktycznie kupujesz walutę, zwykle się różnią, a ta różnica powinna być w cenie, a nie zjadać marżę.
Dodatek dotyczy kursu, a nie ceny produktu: wszystkie późniejsze przeliczenia idą już po podwyższonym kursie.
Jak przejrzeć historię kursów
Osobne okno „Historia kursów” pokazuje, co działo się z każdą walutą: wykres zmian, wykres zmiany procentowej w okresie i tabelę odczytów dzień po dniu. Okres wybiera się u góry — od 30 dni do całej historii.
Odczyt zapisywany jest raz na dobę dla każdej waluty, i to nie tylko przy aktualizacji ze źródła: ręczna edycja kursu i wstawienie kursu do dokumentu też zostawiają wpis.
Okres przechowywania ustawia się przyciskiem z miotłą; domyślnie historia przechowywana jest przez 730 dni, czyli dwa lata. Starsze wpisy są usuwane automatycznie przy każdej aktualizacji kursów, a tam też jest przycisk do natychmiastowego ich usunięcia.
Czyszczenie historii nie dotyczy dokumentów. Kurs, po którym policzono konkretny dokument, jest przechowywany w samym dokumencie — dlatego nawet jeśli przytniesz historię do miesiąca, zeszłoroczna faktura pozostanie policzona poprawnie.
Scenariusze
Dostawca podaje cennik w dolarach, a ceny są potrzebne w złotych
Co włączyć. Na karcie cennika, w sekcji „Kolumny” → „Kreator kolumn”, w wierszu pola „Cena” otwórz ustawienia kolumny i w grupie „Waluta” wybierz USD. „Kurs waluty” zostaw na 0. Sprawdź, czy w łańcuchu rodzajów narzutu samego cennika jest „Cena + kurs walut. Źródło ustawień: słownik walut + cennik.” — nowy cennik dostaje go od razu. Ogólne reguły narzutu tego rodzaju nie zastępują: kurs daje tylko rodzaj z listy cennika. Następnie zaimportuj cennik.
Efekt. Podczas przeliczania cena z pliku jest mnożona przez kurs USD ze słownika, razem z dodatkiem „BC + %”, jeśli jest wypełniony. Kolejne rodzaje — narzut, zaokrąglenie — liczone są już od ceny w złotych. Gdy kurs się zmieni, ceny przeliczy kolejny import lub przycisk z różdżką.
Czego nie będzie. Formuła kursu nie jest tu potrzebna. Jeśli przy ustawionej walucie kolumny wpiszesz jeszcze formułę {Cennik: Cena} * {CURRENCY_RATE_USD}, kurs zostanie zastosowany dwa razy: formuła mnoży cenę, którą przeliczenie już zamieniło na złote (albo przeliczenie — tę, którą zamieniła formuła). Bez rodzaju „Cena + kurs walut” na liście cennika waluta kolumny nic nie daje: cena zostanie w dolarach.
Dostawca wystawia cennik w dolarach, Ty sprzedajesz w złotych i chcesz świeżego kursu codziennie
Co włączyć. Wybierz źródło w oknie „Źródło kursów” (kliknięcie plakietki „Dostawca kursów”) i ustaw aktualizację według harmonogramu: menu ≡ → „Ustawienia harmonogramu”. Cennik dostawcy musi mieć na liście rodzajów narzutu „Cena + kurs walut. Źródło ustawień: słownik walut + cennik.”. Po aktualizacji kursów kliknij przycisk z różdżką „Zastosuj narzut dla produktów z cenników”.
Efekt. Harmonogram aktualizuje kursy w słowniku, a różdżka przelicza wszystkie aktywne cenniki aktywnych dostawców po tych kursach.
Czego nie będzie. Zadanie harmonogramu tylko pobiera kursy — cen cenników i katalogu nie przelicza, robi to wyłącznie różdżka lub kolejny import cennika. Dokumenty już utworzone zostają ze swoim kursem.
Dostawca liczy po swoim kursie, a nie po kursie źródła
Co włączyć. Na karcie cennika, w sekcji „Kolumny” → „Kreator kolumn”, w wierszu pola ceny otwórz ustawienia kolumny i w grupie „Waluta” podaj walutę kolumny oraz „Kurs waluty” — dowolną wartość oprócz 0 i 1 (przy 0 kurs jest brany ze słownika, jak w scenariuszu wyżej). Jeśli do tego kursu trzeba dodać dodatek, wypełnij „+%”. Przeliczenie przyciskiem z różdżką tego dodatku nie dolicza: dla produktów w walucie kolumny bierze czysty „Kurs waluty”.
Efekt. Ten cennik przelicza się po Twoim kursie, a pozostałe — jak dotąd, według słownika.
Czego nie będzie. Aktualizacja kursów słownika nie dotyczy tego cennika i sam słownik też się nie zmienia: kurs w ustawieniach kolumny żyje tylko w tym cenniku.
Kursy mają przychodzić z Twojego systemu księgowego lub od banku
Co włączyć. W oknie „Źródło kursów” wybierz „Własne źródło — JSON z linku” i wpisz adres w polu o tej samej nazwie pod listą. Odpowiedź musi zawierać base i rates, a w rates — kod Twojej waluty głównej.
Jeśli źródło nazywa jakąś inną walutę inaczej niż słownik, wpisz jej dodatkowy kod. Dla waluty głównej dodatkowy kod nie działa: w rates musi być pod tym samym kodem co w słowniku.
Efekt. Program sam liczy kursy krzyżowe: kurs waluty głównej w źródle dzieli przez kurs każdej innej. Na odpowiedź jest 30 sekund.
Czego nie będzie. Jeśli w rates nie ma kodu waluty głównej albo źródło nie odpowiedziało, nie zaktualizuje się żadna waluta: w oknie pojawi się czerwony komunikat „Źródło kursów nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano.”, w „Dzienniku operacji” — czerwony wiersz z tym samym tekstem, a do historii kursów nic się nie zapisze.
Cennik ma się importować po kursie aktualnym w chwili importu
Co włączyć. „Ustawienia systemu” → „Cenniki” → „Import i przetwarzanie”, przełącznik „Aktualizuj kurs przed importem” (domyślnie wyłączony).
Efekt. Przed importem cennika w dzienniku importu pojawia się osobny krok „Import kursów walut”. Źródło jest przy tym odpytywane tylko wtedy, gdy w ciągu ostatniej godziny nikt go jeszcze nie odpytał — przyciskiem ⟳, harmonogramem lub poprzednim importem, przy czym liczy się też nieudana próba: niedostępne źródło nie będzie spowalniać każdego cennika; w przeciwnym razie cennik idzie po kursach, które już są w słowniku.
Czego nie będzie. Kurs poprawiony ręcznie w słowniku nie przetrwa: pierwszy import cennika, który odpyta źródło, nadpisze go wartością ze źródła, jeśli się różni. Jeśli potrzebujesz stałego kursu dla jednego dostawcy, skorzystaj z poprzedniego scenariusza.
Co zrobić, gdy kursy lub ceny są nie takie
Aktualizacja kursów została przerwana
Program najpierw dostaje od źródła całą odpowiedź, a dopiero potem zapisuje kursy — po jednej walucie, szybkim przebiegiem. Dlatego przerwanie podczas zapytania do źródła — utrata połączenia, zamknięte okno — w ogóle nie zmienia kursów. Część walut z nowym kursem, a część ze starym zostanie tylko wtedy, gdy przerwanie wypadło akurat na zapis. Co i gdzie, widać w kolumnie „Data aktualizacji”: w zaktualizowanych jest dzisiejsza.
Odczyt do historii, czyszczenie starych wpisów i wiersz w dzienniku wykonywane są na samym końcu, po wszystkich walutach. Przerwany przebieg nie zostawia wiersza „Aktualizacja kursów walut” w „Dzienniku operacji” (Panel klienta → Dziennik operacji) — to właśnie znak, że nie dotarł do końca.
Zakończony przebieg zapisuje tam listę uzyskanych kursów; jeśli źródło nic nie zwróciło, wiersz będzie czerwony, z tekstem „Źródło kursów nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano.”.
Powtarzanie jest bezpieczne. Kurs jest nadpisywany tylko wtedy, gdy różni się od bieżącego, a w historii na każdą walutę przypada jeden wpis na dobę — drugi przebieg tego samego dnia niczego nie podwaja.
Historia z danej doby przechowuje pierwszą wartość dnia, a nie ostatnią. Jeśli rano kursy przyszły ze źródła, a w ciągu dnia poprawiono kurs ręcznie, na wykresie z tego dnia zostanie poranna liczba z oznaczeniem „Dostawca”. W samym słowniku będzie przy tym Twoja wartość.
Z harmonogramem jest jedna różnica. Jeśli przerwano przebieg według harmonogramu, zadanie zostaje oznaczone jako uruchomione i następnym razem planista je pominie. Strażnik zdejmuje taką blokadę, gdy od startu minie godzina — potem harmonogram działa jak wcześniej. Przyciskiem ⟳ możesz zaktualizować kursy ręcznie także wcześniej.
Ceny przeliczono po błędnym kursie
To zwykła sytuacja: źródło zwróciło dziwną liczbę albo ktoś wpisał kurs z błędem, a przeliczenie już przeszło. Osobnego przycisku „cofnij” nie ma — i nie jest tu potrzebny.
Przeliczenie za każdym razem zaczyna się od wyjściowej ceny z pliku dostawcy, więc błędny kurs nie nakłada się drugą warstwą na poprzedni. Kolejność działań: popraw kurs w słowniku — ręcznie lub aktualizując go ze źródła — i kliknij przycisk przeliczenia jeszcze raz. Ceny będą takie, jakby błędnego przebiegu nie było.
Jeden wyjątek: jeśli w cenniku cena wyjściowa jest zerowa, a bieżącej wartości nie zapisały kroki narzutu, nie wraca ona do wyjściowej — taka cena zostanie bez zmian.
Po jakim kursie policzono konkretny produkt, sprawdzisz w jego menu kontekstowym: pozycja „Historia narzutu produktu”. Pokazuje ona cenę wyjściową i wszystkie kroki po kolei, w tym wiersz „Kurs:” z zastosowaną wartością. A jaki kurs był w słowniku tego dnia, pokaże okno „Historia kursów”.
Przeliczenie nie dotyka dokumentów. Kurs, po którym policzono fakturę lub zamówienie, jest zapisany w samym dokumencie i przycisk w słowniku walut go nie zmienia. Jeśli błędny kurs trafił do dokumentu, poprawić trzeba pole „Kurs waluty” w tym dokumencie.
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Po kliknięciu „Pobierz kursy walut” nic się nie zmieniło | źródło nie zwróciło danych (wtedy pojawia się czerwony komunikat „Źródło kursów nie zwróciło danych — kursy nie zostały zaktualizowane, do historii nic nie zapisano.”) albo nie ma w nim żadnej z Twoich aktywnych walut | przy czerwonym komunikacie spróbuj później lub wybierz inne źródło; bez niego przejrzyj kolumnę „Data aktualizacji” i sprawdź kody walut |
| Nad tabelą „Kurs nie został zastosowany automatycznie — zmiana przekracza 30%…” | źródło podało kurs, który różni się od bieżącego o ponad 30%; taki kurs nie jest stosowany automatycznie | sprawdź kurs w banku i kliknij ⟳ → „Zastosuj” (skok kursu) |
| Nad tabelą „Kurs z dnia …, źródło nie odpowiedziało” | źródło jest teraz niedostępne, wzięto ostatni kurs z zapasu serwera (do 24 godzin) | nic; później kliknij ⟳ lub wybierz inne źródło |
| Własne źródło podłączone, kursy stare | w odpowiedzi nie ma kodu Twojej waluty głównej — bez niego kursy krzyżowe się nie liczą | dodaj walutę główną do listy rates swojego źródła |
| Zaktualizowała się część walut | pozostałych nie ma w źródle pod kodem, który masz zapisany | wpisz walucie dodatkowy kod — ten, którym nazywa ją źródło |
| Kursy się zaktualizowały, a ceny w katalogu są stare | przeliczanie cen jest osobne i nie uruchamia się samo | kliknij przycisk przeliczania cen w tym samym oknie |
| Kurs poprawiony ręcznie następnego dnia znów jest inny | kurs nadpisała kolejna aktualizacja: harmonogram, proces Flows lub import cennika z włączonym „Aktualizuj kurs przed importem” | utrwal swój kurs w ustawieniach kolumn cennika lub odznacz w walucie „Aktywność” (kurs ręczny) |
| Ceny przeliczono po błędnym kursie | nic strasznego: przeliczenie zawsze zaczyna się od wyjściowej ceny z pliku dostawcy | popraw kurs i kliknij przycisk przeliczenia jeszcze raz (błędny kurs) |
| Po kliknięciu przeliczenia część cenników się nie zmieniła | na ich liście narzutów nie ma rodzaju „Cena + kurs walut” | dodaj ten rodzaj narzutu do cennika (przeliczanie cen) |
| Usunięta waluta wróciła | waluty ze standardowego zestawu są systemowe i nie są usuwane, choć komunikat mówi co innego | odznacz w niej „Aktywność” — nie będzie już brała udziału w obliczeniach |
| Historia jest pusta | w wybranym okresie nie ma odczytów — albo okres jest krótki, albo kursy dawno nie były aktualizowane | poszerz okres lub zaktualizuj kursy |
| Kurs w dokumencie nie zgadza się z bieżącym | tak ma być: dokument przechowuje kurs z chwili utworzenia | nic; właśnie dlatego historię można czyścić bez skutków dla dokumentów |
Najczęstsze pytania
Jakie źródło kursów wybrać?
Zostaw „Automatycznie”: program weźmie bank narodowy kraju Twojej waluty głównej, a jeśli go nie ma na liście — open.er-api.com. Przy umowie z bankiem lub własnym systemie księgowym podłącz własny link (wszystkie źródła).
Dlaczego nowy kurs nie został zastosowany, a nad tabelą jest ostrzeżenie o 30%?
Kurs zmienił się o ponad 30% — tak program chroni ceny przed błędem źródła. Sprawdź kurs i kliknij ⟳: pojawi się pytanie „Zastosować nowy kurs?”, a po kliknięciu „Zastosuj” kurs zostanie zapisany.
Jaki format ma zwracać moje źródło?
JSON z polami base i rates, gdzie rates to lista „kod waluty → kurs”. Warunek obowiązkowy: na liście musi być kod Twojej waluty głównej, inaczej program nie policzy kursów krzyżowych.
Dlaczego po aktualizacji kursów ceny zostały stare?
Przeliczanie cen to osobne działanie — przycisk z różdżką w tym samym oknie. Tak jest celowo: inaczej każda zmiana kursu przepisywałaby cały katalog bez Twojej wiedzy.
Do czego służy kolumna „BC + %”?
To dodatek do kursu. Jeśli kupujesz walutę drożej niż po kursie bankowym, wpisz różnicę w procentach, a wszystkie przeliczenia pójdą już po Twoim kursie.
Jak długo przechowywana jest historia kursów?
Domyślnie 730 dni. Okres zmienia się przyciskiem z miotłą w oknie historii; stare wpisy usuwają się same przy każdej aktualizacji kursów.
Czy można cofnąć ceny przeliczone po błędnym kursie?
Cofać nie trzeba: przeliczenie za każdym razem zaczyna się od wyjściowej ceny z pliku dostawcy. Popraw kurs i kliknij przycisk przeliczenia jeszcze raz (błędny kurs).
Co stanie się z niezamkniętymi dokumentami, jeśli zmienię walutę główną?
Nic się nie przeliczy: kwoty i kurs zapisany w dokumencie zostaną te same, a podsumowania zbiorcze będą liczone względem starej waluty głównej. Poprawia się pole „Kurs waluty” samego dokumentu (zmiana waluty głównej).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Waluty i kursy
- Zaktualizuj kursy teraz
- przycisk ⟳ w oknie słownika
- Historia kursów
- z tego samego okna, przycisk „Historia kursów”
- Uprawnienia
- okna „Waluty i kursy” i „Historia kursów”
1
Kurs2
Oznaczenie waluty głównej3
BC + %4
Dostawca kursów- Kurs — ile waluty głównej kosztuje jedna jednostka tej waluty.
- Oznaczenie waluty głównej — jej kurs zawsze wynosi 1 i w niej liczone jest wszystko.
- BC + % — dodatek do kursu, gdy kupujesz walutę drożej niż po kursie bankowym.
- Dostawca kursów — skąd program pobiera kursy.
Powiązane tematy
- Jeśli walutę i kurs trzeba ustawić dla kolumny cennika — Co ustawia się dla pojedynczej kolumny.
- Jeśli cena po kursie ma dostać narzut — Reguły narzutu dla cennika.
- Jeśli aktualizację kursów trzeba zautomatyzować — Harmonogram i kolejka zadań.
- Jeśli angielska wersja witryny ma pokazywać ceny w euro — kolumna „Domyślny kod waluty” w językach.
