Automatyczna aktualizacja kursów walut NBP z marżą

PP-M022
Integracje i API
  • 1.7.7 + | 8.x | 9.x
  • EN, FR, IT, DE, PL
  • 1.0.0
  • 2026-02-26

Automatyczna aktualizacja kursów walut to moduł PrestaShop, który automatyzuje krytyczny obszar e-commerce: aktualizację kursów walut w oparciu o API NBP i Twoje własne zasady marżowe. Rozwiązanie idealne dla sprzedaży B2B/B2C, gdzie opóźnione przeliczniki bezpośrednio obniżają rentowność oferty. Administrator zyskuje pełną kontrolę i logi, a zespół techniczny – bezpieczny proces synchronizacji z wykorzystaniem CRON w środowisku multistore

Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
Automatyczne kursy walut NBP PrestaShop + Marże | Moduł
174,00 zł Netto

Parametry Informacyjne:

  • 1.0.0
  • Wersja Sklepu Wersja PHP
    1.7.7 + 7.1 – 7.4
    8.x 8.1 – 8.3
    9.x 8.1 – 8.5
  • 2026-02-26
  • EN, FR, IT, DE, PL
  • ✅
  • ✅
  • ✅
  • ✅

Najważniejsze korzyści

  • Stabilna polityka cenowa — automatyczne pobieranie kursów z API NBP zmniejsza ryzyko sprzedaży na nieaktualnych przelicznikach.
  • Kontrola marży walutowej — niezależne korekty (stałe lub procentowe) per waluta pozwalają precyzyjnie zarządzać rentownością oferty.
  • Mniej pracy operacyjnej — bezpieczny harmonogram CRON i aktualizacja manualna redukują czas administracji cenami w sklepie.
  • Bezpieczny proces produkcyjny — tryb SSL-only i token security ograniczają ryzyko nadużyć oraz błędnych wywołań skryptu.
  • Skalowalność dla multistore — konfiguracja i logika działania przelicznika walut PrestaShop działają niezależnie per sklep, bez konfliktu między kontekstami.

Zastosowania modułu

  • Sklepy eksportowe rozliczające sprzedaż w wielu walutach i wymagające codziennej synchronizacji kursów.
  • E-commerce B2B z indywidualną polityką marż, gdzie precyzyjne różnice kursowe wpływają na finalną ofertę handlową.
  • Marki D2C prowadzące kilka storefrontów i potrzebujące spójnych przeliczeń cen w modelu multistore.
  • Sklepy o dużej rotacji cenowej, które muszą skrócić czas reakcji na zmiany rynkowe i wyeliminować ręczne poprawki.

Funkcjonalności – Back Office

1. Status i update on-demand

Administrator widzi datę ostatniej aktualizacji, datę pobranej tabeli NBP i walutę domyślną sklepu.

  • Manual update uruchamiany jednym kliknięciem z poziomu panelu.
  • Kontrola operacyjna bez potrzeby logowania do serwera.
  • Szybki monitoring zmian kursów z jednego, czytelnego widoku.

2. Marże per waluta

Panel umożliwia osobną konfigurację marży stałej (np. w PLN) i procentowej (%) dla każdej waluty w sklepie.

  • Pełna kontrola nad rentownością sprzedaży na poszczególnych rynkach.
  • Walidacja danych i automatyczne odrzucanie niepoprawnych wartości.
  • Natychmiastowe przeliczenie kursów po zapisaniu nowych ustawień.

3. Integracja z NBP i wybór tabeli

Moduł w pełni obsługuje tabele walut A, B oraz A+B w zależności od zakresu rynków docelowych.

  • Dopasowanie źródła danych do konkretnego modelu sprzedaży.
  • Obsługa walut niedostępnych w danej tabeli (skrypt nie blokuje procesu aktualizacji).
  • Cross-rate support dla sklepów z walutą domyślną inną niż PLN.

4. CRON i bezpieczeństwo

System generuje gotowe adresy URL oraz komendę CLI do automatyzacji aktualizacji kursów na serwerze.

  • Tokenized endpoint do autoryzacji wywołań przez CRON.
  • Regeneracja tokenu bezpieczeństwa jednym kliknięciem, bez zmian w kodzie.
  • SSL-only mode (domyślnie aktywny) dla ochrony środowisk produkcyjnych.

5. Logi i retencja

Wbudowany dziennik aktualizacji zapisuje wpisy INFO / WARNING / ERROR z możliwością automatycznego czyszczenia.

  • Pełny audyt procesu i błyskawiczna diagnostyka ewentualnych problemów.
  • Retencja logów zapobiega nadmiernemu rozrostowi bazy danych.
  • Lepszy workflow techniczny na linii administrator – developer.

Funkcjonalności – Front Office

1. Niewidoczny dla klienta, kluczowy dla cen

Moduł nie dodaje obciążających widżetów UI we Front Office, ale bezpośrednio aktualizuje rdzienne dane PrestaShop, co rzutuje na ostateczne ceny w sklepie.

  • Lepszy UX cenowy dzięki zawsze aktualnym i spójnym przeliczeniom.
  • Mniej reklamacji wynikających z rozjazdów kursowych na etapie koszyka.
  • Większa wiarygodność oferty w oczach klientów zagranicznych.

Wpływ na sprzedaż i SEO

  • Automatyzacja skraca czas reakcji na zmiany rynkowe z wielu godzin do zaplanowanego interwału CRON.
  • Stabilne przeliczniki ograniczają błędne ceny i poprawiają współczynnik konwersji na walutowych landing page'ach.
  • Spójne ceny między kanałami (karta produktu, listing, checkout) budują zaufanie i obniżają wskaźnik porzuconych koszyków.
  • Dla SEO: spójność cen w sklepie zapobiega błędom w danych strukturalnych (Schema.org), co chroni ofertę przed odrzuceniem w Google Merchant Center i nagłymi spadkami widoczności.

Uwaga!

Przed wdrożeniem na produkcji wykonaj pełną kopię bezpieczeństwa (pliki sklepu + baza danych) i przetestuj konfigurację CRON oraz politykę SSL w środowisku staging. Zmiana tabeli NBP, tokenu CRON lub marż bezpośrednio wpływa na ceny w całym sklepie, dlatego rekomendujemy procedurę change management i przygotowanie planu szybkiego przywrócenia systemu (rollback).

Pliki do pobrania:

Instalacja modułu PrestaShop (625.83KB)

Uniwersalna dokumentacja opisująca proces instalacji modułów dla PrestaShop.

Aktualizacja kursów walut NBP (116.46KB)

Instrukcja obsługi

## [1.0.0] - 2026-02-25

### Added

- Initial public release of `ppcurrencyautoupdate`.
- NBP API integration with table selection: `A`, `B`, `A + B`.
- Manual update action in BO (`Update rates now`).
- CRON support (HTTP and CLI) with security token.
- Per-currency margin management:
  - fixed margin (PLN),
  - percentage margin (%).
- Automatic recalculation of PrestaShop conversion rates after margin save.
- Validation summary after save: saved/rejected/recalculated counters.
- Update log panel with levels `INFO`, `WARNING`, `ERROR`.
- Log retention settings with automatic old-entry cleanup.
- SSL mode switch with secure default (`SSL-only = ON`) and optional dev fallback.
- Non-PLN default currency handling (cross-rate computation).
- BO tabbed interface: Status, Exchange rates & margins, Settings, CRON Configuration, Update log.
- Multistore-aware configuration and per-shop processing.
- Integration with PP updater and admin tab installer components.

### Changed

- Improved admin UX for margin editing and save feedback.
- Clearer help text for fixed margin behavior (net/gross clarification).
- Persistent active tab in BO after form submissions.

### Fixed

- Updater output visibility issue caused by namespace mismatch.
- Immediate propagation of recalculation flow after margin save/settings changes.
- Translation coverage in `pl`, `de`, `fr`, `it` language files.

FAQs

  • Czy moduły są kompatybilne z moją wersją PrestaShop?

    Każdy moduł w naszym sklepie zawiera informację o kompatybilności z dana wersjami PrestaShop. Prosimy o dokładne sprawdzenie tych danych przed zakupem. Jeśli nie masz pewności, skontaktuj się z nami.

  • Skąd moduł pobiera kursy walut do aktualizacji?

    Moduł pobiera kursy z API Narodowego Banku Polskiego. W konfiguracji można wybrać tabelę A, B albo A+B, zależnie od rynków i walut używanych w sklepie. Mechanizm obsługuje również sytuację, w której dana waluta nie występuje w wybranej tabeli, bez blokowania całej aktualizacji.

  • Czy można ustawić osobną marżę dla każdej waluty?

    Tak. Panel pozwala zdefiniować dla każdej waluty niezależną korektę stałą lub procentową. Ułatwia to utrzymanie własnej polityki rentowności na różnych rynkach. Moduł waliduje wprowadzane dane i po zapisaniu ustawień przelicza kursy, aby zmiany były od razu uwzględnione w bieżącej konfiguracji sklepu.

  • Jak uruchomić automatyczną aktualizację kursów?

    Do automatyzacji służy CRON. Moduł generuje gotowy adres URL oraz komendę CLI, które można dodać do harmonogramu serwera. Aktualizację da się także uruchomić ręcznie z panelu administracyjnego. Wywołanie CRON jest zabezpieczone tokenem, a token można w razie potrzeby zregenerować bez zmian w kodzie modułu.

  • Czy aktualizacja kursów działa w środowisku multistore?

    Tak. Konfiguracja oraz logika przeliczania działają niezależnie dla każdego sklepu w środowisku multistore. Pozwala to prowadzić różne zasady kursowe i marżowe bez konfliktów między kontekstami sklepowymi. Administrator może więc kontrolować aktualizacje osobno tam, gdzie oferta wymaga odmiennych ustawień walut oraz oddzielnej polityki cenowej.

  • Jak sprawdzić przebieg synchronizacji kursów walut?

    Moduł zapisuje dziennik aktualizacji z wpisami INFO, WARNING i ERROR. W logach można sprawdzić przebieg procesu oraz szybciej zdiagnozować ewentualne problemy. Dostępna jest też retencja logów, która automatycznie usuwa starsze wpisy i pomaga ograniczać nadmierny rozrost danych w bazie oraz zachować porządek operacyjny.

10 innych produktów w tej samej kategorii:

Walidacja VAT i VIES B2B dla PrestaShop

Walidacja VAT i VIES dla B2B w PrestaShop

PP VAT Checker to niezawodny moduł dla PrestaShop, który automatyzuje weryfikację numerów VAT (NIP) Twoich klientów biznesowych. Dzięki bezpośredniej integracji z bazą...

89,00 zł

Potrzebujesz dodatkowych funkcji lub indywidualnych rozwiązań dla Twojego sklepu?

  • Modyfikacja modułu zgodnie z Twoimi wymaganiami.
  • Rozbudowa o nowe funkcje zwiększające możliwości Twojego sklepu.
  • Tworzenie dedykowanych modułów dostosowanych do specyficznych potrzeb.
  • Integracja zewnętrznych systemów i dodatkowych narzędzi.
  • Optymalizacja i ulepszenia dla lepszej wydajności i wygody użytkowania.

Masz pomysł, jak ulepszyć to oprogramowanie? Zgłoś swoje sugestie dotyczące optymalizacji, nowych funkcji lub znalezionych błędów – chętnie je przeanalizujemy!

Skontaktuj się z nami!