Jak ustawić różne waluty w PrestaShop

Sklep, który sprzedaje do wielu krajów, potrzebuje poprawnie skonfigurowanych walut, przejrzystych cen oraz stabilnych integracji płatności. W PrestaShop możesz obsłużyć różne rynki w jednym panelu, dodać lokalne waluty, ustawić kursy, zasady zaokrągleń, a nawet automatycznie aktualizować przeliczenia. Poniżej znajdziesz praktyczną, krok‑po‑kroku instrukcję, jak to zrobić poprawnie, bez utraty marż, z pełną kontrolą nad wyświetlaniem cen, koszykiem i integracjami bramek płatniczych.

Przygotowanie sklepu i włączenie obsługi wielu walut

Sprawdź wersję i kopię zapasową

Zanim zaczniesz, upewnij się, że pracujesz na aktualnej wersji PrestaShop 1.7/8, a także wykonaj kopię zapasową bazy i plików. Zmiany w walutach wpływają na wyświetlanie cen w całym katalogu i zamówieniach, dlatego rollback musi być szybki i pewny. Jeśli korzystasz ze środowiska testowego (staging), wprowadzaj zmiany najpierw tam, a dopiero później wdrażaj na produkcję.

Ustal domyślne ustawienia lokalizacji

Przejdź do Międzynarodowy > Lokalizacja > Lokalizacja i:

• Ustaw kraj domyślny (wpływa m.in. na format liczb i podatki).
• Ustal język domyślny i domyślną walutę (ta waluta będzie bazą przeliczeń).
• W razie potrzeby zainstaluj pakiet lokalizacyjny dla krajów, do których sprzedajesz (dostępne są paczki z formatami, jednostkami, podatkami, a często także walutami).

Włącz selektor waluty dla klientów

Klient powinien móc ręcznie wybrać walutę. W większości domyślnych motywów pasek wyboru waluty znajduje się w headerze. Jeśli go nie widzisz:

• Sprawdź, czy moduł odpowiedzialny za wybór waluty/blok walut jest włączony w Moduły > Menedżer modułów.
• Upewnij się, że hook w motywie (np. displayTop) ma podpięty blok walut.
• W razie personalizacji motywu dodaj widżet selektora w odpowiednim hooku.

To proste rozwiązanie ogranicza liczbę błędnych domysłów na temat kraju klienta i redukuje ryzyko nieporozumień cenowych.

Rozważ automatyczne dopasowanie położenia

Jeśli chcesz sugerować walutę na podstawie kraju, włącz geolokalizacja w Międzynarodowy > Lokalizacja > Geolokalizacja. Włącz wykrywanie po IP (wymaga bazy GeoLite lub podobnej), zezwól na kraje, do których sprzedajesz, a także zdefiniuj zachowanie dla niezidentyfikowanych użytkowników. Pamiętaj, że VPN i błędy wykrywania lokalizacji się zdarzają; zawsze pozostaw możliwość ręcznej zmiany waluty.

Dodawanie i konfiguracja nowych walut

Włącz i dodaj waluty w panelu

Przejdź do Międzynarodowy > Lokalizacja > Waluty. Tutaj:

• Aktywuj istniejące waluty, których potrzebujesz (np. EUR, USD, GBP, PLN).
• Kliknij Dodaj nową walutę, aby wprowadzić kolejne pozycje.

Podczas dodawania:

• Wybierz kod ISO (np. USD, EUR, CHF). Dzięki temu PrestaShop zna symbol, separator i standardowy format liczbowy.
• Ustal symbol waluty (np. €, $, zł) i jego pozycję względem kwoty (przed/po).
• Ustaw liczbę miejsc po przecinku i preferowane separatory (np. 1 234,56 vs 1,234.56).
• Zdefiniuj kurs względem waluty domyślnej – o tym szerzej w kolejnym rozdziale.

Po zapisaniu sprawdź, czy nowa waluta wyświetla się poprawnie w sklepie oraz w back‑office (karty produktów, cenniki). Jeśli korzystasz z cache (np. memcached, Redis) lub CDN, odśwież zawartość.

Precyzyjny format liczbowy i zaokrąglenia

Różne rynki mają inne przyzwyczajenia. Ustawienia znajdziesz w Międzynarodowy > Lokalizacja > Waluty oraz w Parametry sklepu > Ogólne:

• Zaokrąglanie – do najbliższej, w górę, w dół; wybierz regułę akceptowalną podatkowo na Twoich rynkach.
• Poziom zaokrąglania – na pozycję, na sumę, na linię koszyka; spójna polityka ułatwi rozliczenia i minimalizuje reklamacje.
• Prezentacja cen z/bez VAT – dopasuj do przepisów i oczekiwań klientów (B2C zazwyczaj z VAT, B2B częściej bez VAT).

Sprawdź też, czy sposób grupowania tysięcy i separator dziesiętny odpowiada lokalnym standardom (np. w Polsce 1 234,56 zł).

Ustaw walutę domyślną dla sklepu i kanałów

Waluta domyślna służy jako baza wyceny w katalogu i przeliczania na inne waluty. Znajdziesz ją w Międzynarodowy > Lokalizacja > Lokalizacja. W przypadku sprzedaży omnichannel (marketplace, feedy produktowe, reklamowe) upewnij się, że eksportery i integracje korzystają z odpowiedniej waluty docelowej. Dla porównywarek cenowych często warto tworzyć osobne feedy per kraj/waluta.

Scenariusze wielosklepowe

Jeżeli masz uruchomiony multisklep (włącz w Zaawansowane parametry > Multistore), każdemu sklepowi lub grupie sklepów przypisz własną listę dozwolonych walut i własną walutę domyślną. Pamiętaj:

• Pracuj w poprawnym kontekście (przełącznik górny: Wszystkie sklepy / Grupa / Sklep).
• Waluty mogą być aktywne w jednym sklepie, a nieaktywne w innym – to ułatwia separację rynków.
• Różne polityki cenowe i koszty dostawy per sklep wymagają spójnego planu zaokrągleń i kursów.

To pozwoli uniknąć przypadkowego włączenia waluty w sklepie, gdzie nie obsługujesz płatności lub nie masz odpowiednich stawek VAT.

Aktualizacja kursów i automatyczna synchronizacja

Ręczne ustawianie kursów

W Międzynarodowy > Lokalizacja > Waluty wybierz walutę i ustaw jej kurs względem waluty bazowej. Przykład: jeśli PLN to baza, a chcesz przeliczać na EUR, wpisz kurs odpowiadający 1 PLN w EUR lub odwrotnie (zależnie od interfejsu). Po zapisaniu sprawdź przykładowe produkty, aby upewnić się, że wartości w koszyku i na liście produktów wyglądają poprawnie.

Automatyczna aktualizacja kursów

Wahania rynkowe potrafią wyzerować marżę. Włącz automatyczną synchronizacja kursów:

• Na liście walut znajdziesz przycisk Odśwież kursy lub link do CRON – skopiuj adres zadania.
• Zainstaluj moduł zadań CRON (np. Cron jobs) w Moduły > Menedżer modułów i dodaj nowe zadanie, które uruchamia wskazany URL codziennie, co godzinę lub według Twojej polityki.
• Testowo uruchom zadanie ręcznie i sprawdź, czy kursy zostały zaktualizowane.

Zadbaj, by harmonogram nie kolidował z generowaniem feedów i indeksowaniem wyszukiwarki w sklepie – jednoczesne obciążenie może spowolnić witrynę.

Źródła kursów i integracje

Domyślne aktualizery korzystają z publicznych źródeł, jednak w sprzedaży międzynarodowej lepiej bazować na sprawdzonym źródle bankowym lub systemie ERP. Jeśli Twoje ERP wystawia API, rozważ integrację:

• Wywołuj endpoint z aktualnymi kursami i aktualizuj je w PrestaShop poprzez moduł integracyjny.
• Wprowadź walidację: odchylenie kursu powyżej ustalonego progu powinno wysyłać alert.
• Loguj datę i źródło aktualizacji, aby mieć ślad audytowy na wypadek sporów cenowych.

Dobra praktyka: oprócz kursu rynkowego dodaj bufor (np. +1–2%), by zabezpieczyć się przed nagłymi wahaniami i kosztami przewalutowań operatora.

Zaokrąglenia i minimalne kroki cenowe

W niektórych krajach minimalny nominał gotówki jest większy (np. brak monet 1c). Jeżeli obsługujesz również płatności gotówkowe w punkcie odbioru, ustaw zaokrąglenia do 0,05 jednostki. Zadbaj o spójność z platformą księgową – suma netto, VAT i brutto muszą się sumować dokładnie po przeliczeniu i zaokrągleniach, aby uniknąć rozbieżności w fakturach.

Prezentacja cen, metody płatności i testowanie

Wyświetlanie cen w sklepie i w koszyku

Prawidłowa prezentacja cen zwiększa konwersję i redukuje porzucone koszyki. Skontroluj:

• Listy produktów, karty produktowe, moduły promocyjne – czy waluta i symbol są konsekwentne.
• Koszyk i checkout – czy sumy, dostawa i podatki przeliczają się na właściwą walutę.
• Wiadomości e‑mail i PDF (zamówienie, faktura, korekta) – odpowiedni symbol i format liczb.

Jeśli oferujesz rabaty procentowe oraz kwotowe, sprawdź, czy kwotowe rabaty są poprawnie liczone po konwersja waluty i czy reguły cenowe nie powodują ujemnych cen końcowych.

Ograniczenia metod płatności według waluty

Nie wszystkie bramki obsługują każdą walutę. W Płatności > Metody płatności (lub Płatności > Preferencje, zależnie od wersji) skonfiguruj Ograniczenia według waluty:

• Włącz metody tylko dla wspieranych walut (np. karta, lokalny portfel, przelew natychmiastowy).
• Jeśli operator zwraca środki w innej walucie, jasno komunikuj to w checkout.
• Przetestuj transakcję end‑to‑end, aby upewnić się, że operator rozpoznaje walutę.

Brak właściwej konfiguracji prowadzi do odrzuceń płatności. Dobrą praktyką jest label przy przycisku (np. Wyślij płatność – USD), aby użytkownik rozumiał, w jakiej walucie płaci.

Delivery, podatki i kompatybilność z rynkami

Koszty dostawy i podatki muszą być spójne z walutą i krajem:

• Strefy i przewoźnicy – w Wysyłka > Przewoźnicy ustaw cenniki w walucie sklepu; sprawdź przeliczenia na inne waluty w koszyku.
• Stawki VAT – w Międzynarodowy > Podatki przypisz reguły do krajów docelowych. Cenę brutto w każdej walucie weryfikuj na produktach z różnymi stawkami.
• Opłaty za płatność w walucie – niektórzy operatorzy pobierają prowizję walutową; uwzględnij ją w marży lub jako osobną pozycję (zgodnie z prawem lokalnym).

Pamiętaj, że marketplace’y (np. Amazon, eBay) mają własne reguły walut i podatków – integracja powinna obsługiwać niezależne przeliczenia.

Testy funkcjonalne i kontrola jakości

Zanim uruchomisz nową walutę publicznie:

• Wybierz 5–10 produktów o różnych cenach i wariantach, przetestuj koszyk w każdej aktywnej walucie.
• Wykonaj testowe płatności wszystkimi metodami przypisanymi do danej waluty.
• Zweryfikuj dokumenty księgowe (faktury PDF), maile transakcyjne i panel zamówień.
• Sprawdź zwroty i anulacje – czy zwrot jest rozliczany w walucie płatności.
• Skontroluj raporty sprzedaży i eksporty księgowe – waluta, kurs, wartości netto/brutto.

Udokumentuj wyniki testów i dopiero po akceptacji włącz walutę dla wszystkich użytkowników (zamiast tylko dla Administratorów lub ograniczonej grupy klientów testowych).

UX i komunikacja dla klienta

Widoczny i zrozumiały selektor waluty zmniejsza niejasności. Dobre praktyki:

• Wyświetl skrót waluty obok ceny produktu oraz w nagłówku/koszyku.
• Unikaj mieszania formatów (np. separatorów i pozycji symbolu).
• Dodaj krótki tooltip: Ceny w wybranej walucie przeliczane po aktualnym kursie.
• Jeśli stosujesz dynamiczne kursy, informuj o czasie ostatniej aktualizacji.

Przejrzysta komunikacja redukuje porzucenia koszyka i reklamacje związane z niespodziewaną zmianą kwoty na etapie płatności.

Zgodność z księgowością i ERP

Jeśli Twoje zamówienia trafiają do systemu finansowo‑księgowego lub ERP:

• Uzgodnij mapowanie walut i kursów – która strona jest masterem danych.
• Zapisuj kurs użyty dla zamówienia w jego metadanych, aby rozliczenia były powtarzalne.
• W raportach uwzględniaj zarówno walutę transakcji, jak i walutę rozliczeniową.

W procesach B2B spotyka się fakturę w jednej walucie i płatność w innej – procedury księgowe muszą przewidywać różnice kursowe (przychody/koszty finansowe).

Bezpieczeństwo i wydajność

Aktualizacje kursów i renderowanie cen to operacje częste:

• Cache’uj widoki list produktowych i modułów promocyjnych per waluta.
• Monitoruj obciążenie CRON; jeśli aktualizujesz kursy bardzo często, rozważ limity i okna serwisowe.
• Zabezpiecz link CRON kluczem lub IP allowlist, aby zablokować nadużycia.
• W logach serwera oznaczaj wykonania zadania, aby łatwo diagnozować problemy.

Dodatkowo, jeśli korzystasz z zewnętrznych widżetów cenowych, upewnij się, że nie konfliktują z logiką sklepu (podwójne przeliczenia prowadzą do chaosu i błędów w koszyku).

Częste problemy i szybkie rozwiązania

Typowe sytuacje i jak je rozwiązać:

• Ceny wyglądają identycznie w każdej walucie – sprawdź, czy kurs ≠ 1 oraz czy cache nie podaje starej wersji.
• Metoda płatności znika – włącz ją dla danej waluty w Ograniczeniach według waluty.
• Niespójne sumy VAT – zweryfikuj poziom zaokrągleń (pozycja vs suma) i ustawienia podatków per kraj.
• Brak waluty na liście – upewnij się, że motyw ma włączony selektor i waluta jest aktywna w aktualnym kontekście sklepu.
• Błędne formaty liczb – sprawdź ustawienia formatu w walucie i w lokalizacji, zaktualizuj pakiet lokalizacyjny.

Zawsze po większych zmianach czyszcz cache aplikacji i przeglądarki oraz odśwież CDN.

Zaawansowane scenariusze i dalsze usprawnienia

Gdy podstawy działają, możesz iść krok dalej:

• Cenniki regionalne – zamiast jednego kursu, definiuj niezależne ceny katalogowe per kraj/waluta (np. poprzez reguły cenowe i katalog per sklep w trybie multistore).
• Dynamiczny margines walutowy – automatycznie doliczaj bufor do kursu w godzinach zwiększonej zmienności rynkowej.
• Segmentacja grup klientów – różne prezentacje cen (netto/brutto) oraz różne waluty dostępne dla segmentów B2B vs B2C.
• Eksport danych – generuj feedy produktowe per waluta dla Google Merchant Center, Facebook Catalog itp., aby uniknąć odrzuceń za niespójność waluty z krajem kierowania.
• Kontraktowe kursy z operatorem płatności – jeśli rozliczasz się po stałym kursie z PSP, zsynchronizuj go z ustawieniami sklepu.

Pamiętaj, by każdą automatyzację testować na sandboxie operatora i kopii sklepu; różnice kursowe wpływają bezpośrednio na przychody i marżę.

Checklist wdrożeniowy krok po kroku

Na koniec praktyczna lista działań, które pomogą przejść proces bez pominięć:

• Ustal walutę bazową i import pakietów lokalizacyjnych dla docelowych krajów.
• Dodaj i aktywuj potrzebne waluty; ustaw symbole, formaty i zaokrąglenia.
• Skonfiguruj kursy: ręcznie oraz CRON dla automatyki.
• Włącz selektor waluty w motywie i przetestuj jego działanie.
• Skonfiguruj ograniczenia metod płatności według waluty.
• Zweryfikuj koszty dostawy i podatki w każdej walucie.
• Przetestuj koszyk, checkout, dokumenty i e‑maile we wszystkich walutach.
• Skonfiguruj logowanie źródeł kursów i alerty odchyleń.
• W trybie multisklep rozdziel waluty i ustawienia per sklep.
• Po wdrożeniu monitoruj konwersję, chargebacki i reklamacje – wprowadzaj korekty.

Z tak uporządkowanym procesem unikniesz najczęstszych pułapek i zapewnisz klientom spójne doświadczenie zakupowe w wielu walutach.

FAQ: krótkie odpowiedzi na częste pytania

• Czy mogę ustawić różne ceny katalogowe, a nie tylko przeliczać kurs? Tak – w trybie multistore lub z wykorzystaniem reguł cenowych per grupa/kraj.
• Czy PrestaShop automatycznie dobiera walutę do kraju? Może zasugerować na bazie geolokalizacji, ale zawsze pozostaw selektor użytkownikowi.
• Jak często aktualizować kursy? Minimum raz dziennie; przy dużych wahaniach częściej, z buforem bezpieczeństwa.
• Czy faktury pokażą właściwą walutę? Tak, o ile waluta była aktywna podczas złożenia zamówienia i szablony PDF są zgodne z ustawieniami formatu.
• Co z raportowaniem finansowym? Rejestruj walutę transakcji i kurs zastosowany w zamówieniu; raporty rozdzielaj per waluta lub konwertuj do waluty rozliczeniowej.

Dobrze skonfigurowane waluty to fundament skalowania sprzedaży międzynarodowej – technicznie i operacyjnie.

Integracje zewnętrzne i utrzymanie

Regularnie audytuj:

• Logikę przeliczeń w modułach rabatowych i subskrypcyjnych – unikniesz niedoliczeń.
• Wyświetlanie waluty w mikrodatach/strukturze danych dla SEO – niespójność może powodować błędne ceny w wynikach wyszukiwania.
• Odświeżanie cache po zmianach walut i kursów – ustaw odpowiednie TTL per rynek.
• Obsługę zwrotów w bramkach – czy zwrot trafia w walucie płatności, czy po przeliczeniu.

Jeśli korzystasz z systemów BI, oznaczaj zamówienia atrybutami: waluta transakcyjna, waluta rozliczeniowa, data aktualizacji kursu, źródło kursu. To ułatwia kontroling i prognozy.

Podsumowanie operacyjne dla zespołów

Choć nie wymaga to zmian developerskich na dużą skalę, praca operacyjna jest kluczowa:

• Commerce ustala politykę cen i buforów kursowych.
• Księgowość akceptuje zasady zaokrągleń i rozpoznawania różnic kursowych.
• IT/DevOps utrzymuje CRON, monitoruje błędy i dba o dostępność źródeł kursów.
• Support ma gotowe skrypty odpowiedzi dotyczące walut, podatków i zwrotów.

Wspólny playbook minimalizuje ryzyko i pozwala bezpiecznie rozszerzać listę obsługiwanych walut wraz z rozwojem biznesu.

Najlepsze praktyki produkcyjne

• Przed dużymi kampaniami zamroź kursy na określony czas, aby uniknąć różnic w kreacjach reklamowych a cenach live.
• Utrzymuj listę kompatybilności: metody płatności × waluty × kraje i aktualizuj ją przy każdej zmianie oferty.
• W szablonach e‑mail i PDF korzystaj z tych samych helperów formatu waluty co na froncie, aby uniknąć rozjazdów.
• W razie problemów włącz tryb debug na krótką chwilę i sprawdź, czy moduły nie nadpisują formaterów cen.

Dyscyplina operacyjna i ciągłe testy A/B w checkout potrafią istotnie zwiększyć współczynnik konwersji w rynkach wielowalutowych.

Kiedy warto skorzystać z zewnętrznego wsparcia

Jeśli:

• Posiadasz kilkanaście rynków i rozbudowane ERP/PSP,
• Utrzymujesz rozbieżne polityki cen (nie tylko prosta konwersja),
• Potrzebujesz SLA na aktualizację kursów, walidację i alerty,

rozważ wdrożenie dedykowanego modułu integracyjnego z ERP/bankiem oraz audyt ustawień walut. To skróci czas reakcji na wahania rynkowe i ograniczy koszty błędów.