📦 Pakowanie produktów z appką to mniej błędów i szybsza praca Twojego zespołu
- Bieżące kursy walut NBP w Twoim sklepie PrestaShop
- Aktualny kurs NBP na zamówieniach
- Ręczny kurs - cena widoczna dla klienta
- Wszystkie operacje związane z kursami w jednym miejscu
- Wszystkie ważne funkcje w krótkiej liście
- Automatyzacja w tle — jeden token, dwie opcje
- Bezpieczeństwo
- Dla kogo jest PrestaShop NBP?
- Ułatwienia dla programistów
- Hooki PrestaShop
- Wymagania techniczne
Opis szczegółowy
Kursy prosto z NBP — oficjalny feed
PrestaShop domyślnie pobiera kursy z własnego, zewnętrznego źródła zakotwiczonego w EUR — niezwiązanego z Narodowym Bankiem Polskim. Nasz moduł zastępuje je oficjalną, publiczną tabelą kursów NBP.
Automatyzacja w tle — link URL i CRON
Jeden, zabezpieczony token obsługuje CRON — pasuje zarówno do hostingu współdzielonego, jak i serwera z dostępem SSH.
Dodatkowy, ręczny kurs do przeliczenia ceny produktu — rozwiązanie gotowe pod fakturę
Niezależnie od kursu NBP możesz ustawić dodatkowy kurs używany do przeliczenia cen produktów. Jest to kurs niewidocznego dla klienta. Każde zamówienie w obcej walucie dostaje zapisany prawdziwy kurs NBP z dnia zakupu.
To jedyna funkcja tego typu wśród modułów kursowych do PrestaShop.
- Przy złożeniu zamówienia w obcej walucie moduł bierze aktualny kurs z wcześniej pobranego kursu referencyjnego NBP - checkout nie łączy się z NBP, więc awaria NBP nie wpływa na czas składania zamówienia.
- Aktualny kurs nadpisuje pole conversion_rate zamówienia w PrestaShop, używane przez raporty i statystyki.
- Kwota, którą zapłacił klient, nigdy się nie zmienia - dane są zachowane w chwili powstania zamówienia.
- Pełny zestaw danych trafia do osobnej tabeli: kurs z checkoutu, realny kurs NBP, tabela i data NBP, kwoty brutto/netto przeliczone na walutę domyślną sklepu.
Czasem sklep chce pokazać klientowi ceny inne, niż to wynika z przeliczenia innego, niż rynkowe - na potrzeby promocji, zaokrągleń albo testów.
- Wpisujesz kurs taki sam jak NBP lub dowolny inny.
- Podgląd przeliczenia na żywo w przeglądarce, jeszcze przed zapisaniem.
- Wyczyszczenie pola przywraca automatyczne przeliczanie z NBP.
- Kurs referencyjny NBP jest cały czas widoczny i aktualizowany obok — niezależnie od ustawionego kursu ręcznego.
- Do zamówienia idą dwie informacje: kurs NBP - na potrzeby księgowości i kurs ręczny - na potrzeby wyliczenia cen.
Panel modułu pokazuje każdą walutę sklepu w jednym wierszu: aktualny kurs NBP (punkt odniesienia), kurs ustawiany ręcznie - widoczny dla klienta oraz czytelny status.
- Aktualny kurs – niezależny, stale odświeżany kurs NBP, widoczny nawet dla walut z ustawionym kursem ręcznym.
- Kurs widoczny dla klienta – to, co faktycznie trafia do conversion_rate PrestaShop i decyduje o cenach na froncie.
- Status – Domyślna, Aktualizowana, Ręczny kurs, Wykluczona lub Nieaktywna.
- Przycisk „Aktualizuj teraz" działa zawsze, niezależnie od automatyzacji w tle.
Wszystkie ważne funkcje w krótkiej liście
- Kursy prosto z NBP – tabela A lub B pobierane bezpośrednio z api.nbp.pl
- Aktualizacja jednym kliknięciem – przycisk „Aktualizuj teraz" działa zawsze, niezależnie od automatyzacji
- Automatyzacja w tle (cron) – link URL dla hostingów bez PHP CLI (cron-job.org i podobne) lub CRON przez SSH
- Wykluczanie walut – wybrane waluty sklepu można całkowicie pominąć przy aktualizacji
- Waluta domyślna zawsze bezpieczna – nigdy nie jest ruszana, zgodnie z wymaganiami PrestaShop
- Ręczny kurs dla klienta – ustal własny, stały kurs dla dowolnej waluty z podglądem przeliczenia na żywo, bez utraty śledzenia realnego kursu NBP
- Realny kurs NBP na zamówieniach – niezależnie od kursu dla klienta, każde zamówienie w obcej walucie dostaje zapisany prawdziwy kurs NBP z dnia zakupu
- Podgląd stanu – czytelna tabela wszystkich walut sklepu ze statusem: domyślna / aktualizowana / ręczny kurs / wykluczona / nieaktywna
- Tłumaczenia PL i EN – pełna lokalizacja panelu, plus instrukcja obsługi PL/EN wbudowana w panel modułu
Zgodność z NBP
Kursy pobierane są bezpośrednio z oficjalnego, publicznego API api.nbp.pl — tabela A (główne waluty, codziennie) lub B (pozostałe, raz w tygodniu).
Waluta domyślna sklepu nigdy nie jest ruszana — jej kurs zawsze pozostaje 1, zgodnie z wymaganiami PrestaShop.
kontrola nad kursem do przeliczenia cen
Ustal własny, stały kurs dla dowolnej waluty — np. na potrzeby promocji albo testów — z podglądem przeliczenia na żywo w przeglądarce.
Kurs referencyjny NBP jest dalej śledzony w tle, niezależnie od ustawionego kursu ręcznego.
Zero ręcznej pracy przy fakturach
Każde zamówienie w obcej walucie dostaje zapisany kurs NBP z dnia zakupu lub z dnia roboczego poprzedzającego dzień zakupu.
- Opcja 1 — link URL – dla paneli typu home.pl, OVH, nazwa.pl czy cron-job.org, które uruchamiają cron tylko przez wywołanie adresu.
- Opcja 2 — crontab – gotowa linia dla serwerów z dostępem SSH.
- Token można w każdej chwili unieważnić i wygenerować nowy jednym przyciskiem.
Losowy, regenerowalny token
Link do automatycznej aktualizacji zawiera tajny token — bez niego serwer odpowiada 403 Forbidden. Token można w każdej chwili unieważnić i wygenerować nowy jednym przyciskiem w panelu.
Losowy, regenerowalny token
Link do automatycznej aktualizacji zawiera tajny token — bez niego serwer odpowiada 403 Forbidden. Token można w każdej chwili unieważnić i wygenerować nowy jednym przyciskiem w panelu.
Jeden endpoint, brak duplikatów
Obie opcje crona (link URL i crontab) trafiają w dokładnie to samo, zabezpieczone miejsce — nie ma osobnego skryptu, który mógłby ominąć weryfikację tokenu.
Sklepy wielowalutowe
Sprzedaż w EUR, USD i innych walutach z rozliczeniem VAT w Polsce — kursy zawsze zgodne z tabelą NBP, bez ręcznego przeliczania.
Biura rachunkowe i księgowość sklepu
Gotowe, udokumentowane dane pod fakturę w walucie obcej, zgodne z wymogiem stosowania kursu NBP — bez ręcznego wyszukiwania kursu z dnia zamówienia.
Sklepy testowe i deweloperskie
Pełna kontrola nad kursem wyświetlanym klientowi, niezależna od realnego kursu NBP śledzonego w tle — wygodne przy testowaniu cen i przeliczeń.
Ułatwienia dla programistów
- Cała logika kursów znajduje się w niezależnych serwisach (NbpClient, CurrencyRateUpdater, OrderRealRateApplier) — łatwe do rozbudowy i ponownego użycia.
- Dedykowana tabela ps_pshownbp_order_rate (jeden wiersz na zamówienie) — minimalne obciążenie bazy danych, gotowa do odczytu przez własny generator faktur.
- Pokryty testami jednostkowymi PHPUnit — bezpieczne wprowadzanie własnych modyfikacji.
Hooki PrestaShop
- actionValidateOrder – zapis aktualnego kursu NBP i danych pod fakturę przy złożeniu zamówienia.
Changelog (0)
## 1.2.30 - 2026-09-11
-----
* Fixed: right after installing, reinstalling, or upgrading the module, orders placed in that
short window could keep the checkout rate instead of getting the real NBP rate for invoicing.
New orders placed any time after that already worked correctly — this closes that narrow gap.
## 1.2.29 - 2026-09-11
-----
* Fixed: if your shop's main currency wasn't covered by the selected NBP table (e.g. table B with
a main currency like USD or EUR), none of your other currencies got updated either, even ones
the table did cover. Fixed — the main currency's rate is now fetched automatically when needed.
## 1.2.28 - 2026-09-11
-----
* Fixed: after switching the NBP table, a currency no longer covered by the new table could keep
showing its old rate as if it were still current. It now correctly shows as unmatched instead.
## 1.2.27 - 2026-09-11
-----
* Fixed: on PrestaShop 9, the automatic-update link could be blocked by the server before it even
reached the module, so scheduled updates never actually ran. Fixed.
## 1.2.26 - 2026-09-11
-----
* Fixed: the module was still showing the wrong publisher name in the back-office modules list.
## 1.2.25 - 2026-09-09
-----
* Fixed: in some cases, saving a manual rate or running an update could report success but the
rate wouldn't actually be applied. Rate updates now always take effect reliably.
## 1.2.24 - 2026-09-09
-----
* Security: the module's own test scripts are now restricted to command-line use only, so they
can't be triggered by a direct web request on hosting setups that don't already block that on
their own (e.g. Nginx).
## 1.2.23 - 2026-09-09
-----
* Improved: the suggested automatic-update schedule now runs early every morning (including
weekends) instead of once on business-day afternoons, so orders placed any time of day always
get the correct rate, not one left over from the previous run. Explained in the settings page
and the manual.
## 1.2.22 - 2026-09-09
-----
* Changed: every update (manual or automatic) now uses the exchange rate from the last business
day before today, not today's own rate — required by Polish law for VAT invoicing, and correct
no matter what time of day the update runs. Explained on the settings page and in the manual.
## 1.2.21 - 2026-09-09
-----
* Fixed: on PrestaShop versions older than 1.7.4, syncing rates for more than one shop in a row
could mix up currency rates between shops. Fixed for every supported PrestaShop version, from
1.7.0 onward.
## 1.2.20 - 2026-09-09
-----
* Fixed: the PL/EN tabs on the in-admin manual page could stop switching depending on which
PrestaShop version/theme was rendering the page. They now work the same way everywhere.
## 1.2.19 - 2026-09-09
-----
* Fixed: technical log entries (visible under Advanced Parameters > Logs) were a mix of Polish and
English regardless of the shop's admin language. They're now consistently in English, like other
technical/developer-facing log entries.
## 1.2.18 - 2026-09-09
-----
* Fixed: in the rare case of a database hiccup while recording the invoicing audit trail, the order
could end up with its rate changed but no audit record to show for it. The two are now saved
together — if either fails, neither one does.
## 1.2.17 - 2026-09-09
-----
* New: order pages now show the real NBP rate used for invoicing right next to the rate the
customer actually paid at checkout, plus both totals converted to your shop's default currency —
no more digging through the database to see it.
## 1.2.16 - 2026-09-09
-----
* Fixed: the automatic-update link now works reliably even while the shop is in maintenance mode
or has SSL/multilingual redirects — it no longer depends on the shop's normal page routing.
## 1.2.15 - 2026-09-09
-----
* Improved: "Update now" now shows a clear warning when the selected NBP table doesn't cover any
of the shop's currencies, instead of a misleading "success" message.
## 1.2.14 - 2026-09-09
-----
* Fixed: an unused generic settings page could show a confusing, empty form — it now takes you to the real settings on the "Currency rates" page instead.
## 1.2.13 - 2026-09-09
-----
* Fixed: uninstalling the module now removes all of its data, so reinstalling starts from a completely clean state.
## 1.2.12 - 2026-09-09
-----
* Fixed: module name and description now display correctly in English store back offices.
## 1.2.11 - 2026-09-09
-----
* Fixed: the module's currency rates are no longer overwritten by PrestaShop's built-in currency updater.
## 1.2.10 - 2026-09-09
-----
* Fixed: automatic update status is now correctly reported when the feature is turned off.
## 1.2.9 - 2026-09-09
-----
* Improved: more reliable connection when fetching rates from NBP, with clearer error messages if it fails.
## 1.2.8 - 2026-09-09
-----
* Fixed: order invoicing data could be incorrectly overwritten in rare duplicate-processing cases (e.g. a payment retry).
## 1.2.7 - 2026-09-09
-----
* New: added an "A + B" NBP table option, so currencies from both NBP tables can be tracked at once.
## 1.2.6 - 2026-09-09
-----
* Fixed: excluding a currency now takes effect immediately, without waiting for the next update.
## 1.2.5 - 2026-09-09
-----
* Fixed: clearing a manual rate field now correctly reverts that currency to the NBP rate.
## 1.2.4 - 2026-09-09
-----
* Fixed: invalid manual rates are now rejected with a clear error instead of being silently ignored.
## 1.2.3 - 2026-09-09
-----
* Fixed: manual rates can now be entered using a comma as the decimal separator (e.g. "4,5").
## 1.2.2 - 2026-09-04
-----
* Fixed: excluded currencies are now fully left untouched by the module.
* Fixed: manual rates for other currencies are no longer lost when saving settings.
* Fixed: an issue that could prevent invoicing data from being saved for an order.
* Improved: failed automatic updates are now clearly reported instead of failing silently.
* New: multistore support — one automatic update now refreshes rates for every shop.
## 1.2.1 - 2026-09-04
-----
* Fixed: invoices now show the correct NBP rate date.
* Improved: checkout reliability when recording invoicing data.
* Improved: automatic update schedule now matches NBP's publication time.
## 1.2.0 - 2026-09-02
-----
* New: orders now record the real NBP rate for invoicing/accounting, separate from the rate shown to customers at checkout.
## 1.1.0 - 2026-08-19
-----
* New: set your own customer-facing exchange rate per currency, automatically converted for the storefront.
## 1.0.0 - 2026-08-18
-----
* Initial release — automatic currency rate updates from NBP, manual and automatic (cron) update options, per-currency exclusion list, PL/EN documentation.
-----
* Fixed: right after installing, reinstalling, or upgrading the module, orders placed in that
short window could keep the checkout rate instead of getting the real NBP rate for invoicing.
New orders placed any time after that already worked correctly — this closes that narrow gap.
## 1.2.29 - 2026-09-11
-----
* Fixed: if your shop's main currency wasn't covered by the selected NBP table (e.g. table B with
a main currency like USD or EUR), none of your other currencies got updated either, even ones
the table did cover. Fixed — the main currency's rate is now fetched automatically when needed.
## 1.2.28 - 2026-09-11
-----
* Fixed: after switching the NBP table, a currency no longer covered by the new table could keep
showing its old rate as if it were still current. It now correctly shows as unmatched instead.
## 1.2.27 - 2026-09-11
-----
* Fixed: on PrestaShop 9, the automatic-update link could be blocked by the server before it even
reached the module, so scheduled updates never actually ran. Fixed.
## 1.2.26 - 2026-09-11
-----
* Fixed: the module was still showing the wrong publisher name in the back-office modules list.
## 1.2.25 - 2026-09-09
-----
* Fixed: in some cases, saving a manual rate or running an update could report success but the
rate wouldn't actually be applied. Rate updates now always take effect reliably.
## 1.2.24 - 2026-09-09
-----
* Security: the module's own test scripts are now restricted to command-line use only, so they
can't be triggered by a direct web request on hosting setups that don't already block that on
their own (e.g. Nginx).
## 1.2.23 - 2026-09-09
-----
* Improved: the suggested automatic-update schedule now runs early every morning (including
weekends) instead of once on business-day afternoons, so orders placed any time of day always
get the correct rate, not one left over from the previous run. Explained in the settings page
and the manual.
## 1.2.22 - 2026-09-09
-----
* Changed: every update (manual or automatic) now uses the exchange rate from the last business
day before today, not today's own rate — required by Polish law for VAT invoicing, and correct
no matter what time of day the update runs. Explained on the settings page and in the manual.
## 1.2.21 - 2026-09-09
-----
* Fixed: on PrestaShop versions older than 1.7.4, syncing rates for more than one shop in a row
could mix up currency rates between shops. Fixed for every supported PrestaShop version, from
1.7.0 onward.
## 1.2.20 - 2026-09-09
-----
* Fixed: the PL/EN tabs on the in-admin manual page could stop switching depending on which
PrestaShop version/theme was rendering the page. They now work the same way everywhere.
## 1.2.19 - 2026-09-09
-----
* Fixed: technical log entries (visible under Advanced Parameters > Logs) were a mix of Polish and
English regardless of the shop's admin language. They're now consistently in English, like other
technical/developer-facing log entries.
## 1.2.18 - 2026-09-09
-----
* Fixed: in the rare case of a database hiccup while recording the invoicing audit trail, the order
could end up with its rate changed but no audit record to show for it. The two are now saved
together — if either fails, neither one does.
## 1.2.17 - 2026-09-09
-----
* New: order pages now show the real NBP rate used for invoicing right next to the rate the
customer actually paid at checkout, plus both totals converted to your shop's default currency —
no more digging through the database to see it.
## 1.2.16 - 2026-09-09
-----
* Fixed: the automatic-update link now works reliably even while the shop is in maintenance mode
or has SSL/multilingual redirects — it no longer depends on the shop's normal page routing.
## 1.2.15 - 2026-09-09
-----
* Improved: "Update now" now shows a clear warning when the selected NBP table doesn't cover any
of the shop's currencies, instead of a misleading "success" message.
## 1.2.14 - 2026-09-09
-----
* Fixed: an unused generic settings page could show a confusing, empty form — it now takes you to the real settings on the "Currency rates" page instead.
## 1.2.13 - 2026-09-09
-----
* Fixed: uninstalling the module now removes all of its data, so reinstalling starts from a completely clean state.
## 1.2.12 - 2026-09-09
-----
* Fixed: module name and description now display correctly in English store back offices.
## 1.2.11 - 2026-09-09
-----
* Fixed: the module's currency rates are no longer overwritten by PrestaShop's built-in currency updater.
## 1.2.10 - 2026-09-09
-----
* Fixed: automatic update status is now correctly reported when the feature is turned off.
## 1.2.9 - 2026-09-09
-----
* Improved: more reliable connection when fetching rates from NBP, with clearer error messages if it fails.
## 1.2.8 - 2026-09-09
-----
* Fixed: order invoicing data could be incorrectly overwritten in rare duplicate-processing cases (e.g. a payment retry).
## 1.2.7 - 2026-09-09
-----
* New: added an "A + B" NBP table option, so currencies from both NBP tables can be tracked at once.
## 1.2.6 - 2026-09-09
-----
* Fixed: excluding a currency now takes effect immediately, without waiting for the next update.
## 1.2.5 - 2026-09-09
-----
* Fixed: clearing a manual rate field now correctly reverts that currency to the NBP rate.
## 1.2.4 - 2026-09-09
-----
* Fixed: invalid manual rates are now rejected with a clear error instead of being silently ignored.
## 1.2.3 - 2026-09-09
-----
* Fixed: manual rates can now be entered using a comma as the decimal separator (e.g. "4,5").
## 1.2.2 - 2026-09-04
-----
* Fixed: excluded currencies are now fully left untouched by the module.
* Fixed: manual rates for other currencies are no longer lost when saving settings.
* Fixed: an issue that could prevent invoicing data from being saved for an order.
* Improved: failed automatic updates are now clearly reported instead of failing silently.
* New: multistore support — one automatic update now refreshes rates for every shop.
## 1.2.1 - 2026-09-04
-----
* Fixed: invoices now show the correct NBP rate date.
* Improved: checkout reliability when recording invoicing data.
* Improved: automatic update schedule now matches NBP's publication time.
## 1.2.0 - 2026-09-02
-----
* New: orders now record the real NBP rate for invoicing/accounting, separate from the rate shown to customers at checkout.
## 1.1.0 - 2026-08-19
-----
* New: set your own customer-facing exchange rate per currency, automatically converted for the storefront.
## 1.0.0 - 2026-08-18
-----
* Initial release — automatic currency rate updates from NBP, manual and automatic (cron) update options, per-currency exclusion list, PL/EN documentation.
Komentarze ()
Opinie zamieszczane w naszym sklepie nie są w żaden sposób sponsorowane. Weryfikujemy również, czy zostały dodane przez klientów, którzy dokonali u nas zakupów. Jeśli chcesz dowiedzieć się więcej na ten temat zapoznaj się z naszym Regulaminem.
Moduł robi co do niego należy, ps8
Wymagania techniczne
Wymagania techniczne
- PHP 7.1 - 8.x
- Rozszerzenie serwera ionCube Loader
Wsparcie i aktualizacje
Wsparcie = Aktualizacje + HelpDesk
Otrzymujesz 90 dni (3 miesiące) dostępu do kompletnego pakietu wsparcia PrestaShow.
Aktualizacje modułów
Moduły poinformują Cię o dostępnych aktualizacjach. Zapoznaj się z listą zmian (changelog) i wykonaj aktualizację modułu 1-kliknięciem bezpośrednio w Twoim sklepie.
Panel HelpDesk
To panel, w którym dostarczymy Ci pomoc. Na HelpDesk możesz zgłaszać problemy, zamówić darmową instalację i aktualizację modułu oraz zamawiać modyfikacje i indywidualne prace programistyczne.
> > > Wydłuż wsparcie
Po wygaśnięciu wsparcia możesz korzystać z modułu bez żadnych ograniczeń. Dostęp do wsparcia możesz odnowić w dowolnym momencie, gdy będziesz tego potrzebował.
Baza Wiedzy & FAQ
Za darmo na zawsze
Baza wiedzy
Jest dostępna dla wszystkich. Znajdziesz w niej dokumentacje modułów oraz instrukcje, filmy i odpowiedzi na najczęściej zadawane pytania.
Licencja
Dożywotnia licencja na moduł
- Moduł możesz używać bez ograniczeń w 1 sklepie = 1 domena.
- Możesz używać dodatkowej domeny, np. dla kopi developerskiej.
- Za niewielką opłatą możesz samodzielnie zmienić domenę dla modułu.
Dodatkowe domeny dla Multistore
- Wszystkie nasze moduły obsługują PrestaShop Multistore.
- Obsługa nielimitowanej liczby domen dla PrestaShop Multistore wymaga zakupienia obsługi multistore dla modułu.
Modyfikowanie kodu
- Kod modułu związany z integracją ze sklepem oraz z wyglądem (.tpl, .css, .js) ma otwarty kod źródłowy i możesz go dowolnie modyfikować.
- Kod źródłowy modułu (.php) szyfrowany jest ionCube, a jego modyfikacja wiąże się z utratą gwarancji.
Demo
Demo - przetestuj moduł
- Ten moduł nie posiada sklepu demo
Brak powiązanych wpisów blogowych.