Automatyczna aktualizacja kursów walut NBP z marżą

PP-M022
Integracje
1.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

    174,00 zł Netto

    Wprowadź domenę dla tego produktu

    event Ważne: Możliwość zmiany domeny expand_more

    Jeśli moduł będzie testowany, wpisz podczas zakupu domenę testową.

    Zmianę na domenę produkcyjną zgłosisz później.

    W przypadku błędnie podanej domeny również prosimy o kontakt.

    Zmiana domeny na produkcyjną jest możliwa jednorazowo i wymaga zgłoszenia w ciągu 3 dni od rozpoczęcia jej używania.

    Zgłoszenia: shop@prestapremium.com

    W treści podaj:

    • numer zamówienia
    • nazwę produktu
    • obecną domenę
    • nową domenę

    Szczegóły

    shopping_cart Zostanie dodane do koszyka 1 sztuk tego produktu (jedna dla każdej domeny)

    Parametry Informacyjne:

    • 1.0.0
    • 2026-02-26
    • 1.7, 8.x, 9.x
    • EN, FR, IT, DE, PL

    Najważniejsze korzyści

    • Stabilna polityka cenowaautomatyczne 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.

    ## [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

    • 1. Jakie metody płatności akceptujecie?

      Akceptujemy płatności kartą kredytową/debetową, przelewem bankowym oraz przez systemy płatności online, takie jak Przelewy24, PayPal. Szczegóły znajdziesz na stronie płatności.

    • 2. Czy mogę przetestować moduł przed zakupem?

      Nie udostępniamy modułów do testowania na indywidualnych instancjach PrestaShop. Jeśli dany moduł posiada wersję demonstracyjną, jest ona dostępna na naszym sklepie testowym, gdzie możesz zapoznać się z jego funkcjonalnością. Na stronie produktu znajdziesz również szczegółowy opis, zrzuty ekranu oraz materiały instruktażowe. W przypadku pytań zapraszamy do kontaktu – chętnie udzielimy dodatkowych informacji.

    • 3. 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.

    • 4. Jak mogę pobrać zakupiony moduł?

      Po opłaceniu zamówienia i zaksięgowaniu płatności, link do pobrania modułu pojawi się na Twoim koncie w zakładce „Historia i szczegóły zamówień” (przycisk „Szczegóły”). Dodatkowo wyślemy Ci wiadomość e-mail z linkiem do pobrania.

    • 5. Czy mogę uzyskać pomoc w instalacji modułu lub szablonu?

      Tak, oferujemy usługę instalacji i konfiguracji jako dodatkową opcję. Możesz ją dodać do koszyka przy zakupie produktu lub zamówić oddzielnie.

    • 6. Czy moduły są zgodne z regulacjami GDPR/RODO?

      Nasze moduły projektujemy z myślą o zgodności z wymogami RODO. Jeżeli moduł przetwarza dane osobowe, w jego opisie znajdziesz szczegółowe informacje na temat zgodności z przepisami. Dokładamy wszelkich starań, aby nasze rozwiązania spełniały aktualne standardy ochrony danych.

    • 7. Czy mogę zlecić audyt mojego sklepu przed zakupem modułu?

      Tak, oferujemy usługę audytu sklepu, aby pomóc w wyborze odpowiednich modułów i zidentyfikować obszary wymagające poprawy. Skontaktuj się z nami, aby uzyskać więcej informacji.

    • 8. Czy mogę otrzymać rabat jako stały klient?

      Tak, dla naszych stałych klientów oferujemy program lojalnościowy z atrakcyjnymi zniżkami. Sprawdź szczegóły w swoim panelu klienta. Jeśli nie widzisz takiej opcji, skontaktuj się z nami – chętnie pomożemy!

    • 9. Co zrobić, jeśli produkt nie spełnia moich oczekiwań?

      Jeśli produkt nie spełnia Twoich oczekiwań, prosimy o kontakt z naszym działem obsługi klienta. Ewentualne zwroty są rozpatrywane indywidualnie, zgodnie z naszym regulaminem.

    • 10. Czy mogę modyfikować zakupiony moduł lub szablon?

      Tak, możesz modyfikować zakupione produkty na własne potrzeby, jednak nie możesz ich odsprzedawać ani udostępniać osobom trzecim. Szczegóły znajdziesz w regulaminie licencji.

    • 11. Czy mogę używać zakupionego modułu na wielu sklepach?

      Zakupione moduły są licencjonowane na jeden sklep. Wyjątek stanowi korzystanie z funkcji multishop w ramach jednej instalacji PrestaShop. W takim przypadku możesz używać modułu na wielu sklepach, nawet z różnymi domenami, pod warunkiem, że:

      • wszystkie sklepy działają w tej samej instalacji PrestaShop,
      • moduł jest kompatybilny z funkcją multishop.
    • 12. Jak mogę sprawdzić, czy moduł będzie działał z moimi innymi zainstalowanymi modułami?

      Nasze moduły są projektowane tak, aby były jak najbardziej kompatybilne z innymi popularnymi rozszerzeniami PrestaShop. Jeśli masz wątpliwości, skontaktuj się z nami i prześlij listę swoich modułów – pomożemy to zweryfikować.

    • 13. Czy moduły są przetłumaczone na różne języki?

      Większość naszych modułów jest dostępna w kilku językach, w tym w polskim i angielskim. Informacja o dostępnych językach znajduje się w opisie modułu.

    • 14. Jak długo trwa realizacja zamówienia?

      Realizacja zamówienia odbywa się automatycznie po zaksięgowaniu płatności. Produkt wówczas można pobrać natychmiast po opłaceniu zamówienia.

    • 15. Co zrobić, jeśli instalacja modułu zakończyła się błędem?

      Sprawdź, czy wersja Twojej PrestaShop jest kompatybilna z modułem oraz czy masz odpowiednie uprawnienia do instalacji. Jeśli problem nadal występuje, skontaktuj się z naszym wsparciem technicznym – pomożemy Ci rozwiązać problem.

    • 16. Czy mogę zamówić moduł, który nie jest dostępny w waszej ofercie?

      Tak, zajmujemy się tworzeniem modułów na zamówienie. Skontaktuj się z nami, aby omówić szczegóły i wycenę.

    • 17. Jak mogę przedłużyć wsparcie techniczne lub dostęp do aktualizacji?
      • Przedłużenie wsparcia i aktualizacji:

        • Jeśli opcja przedłużenia wsparcia i aktualizacji jest dostępna, możesz ją zamówić bezpośrednio w naszym sklepie.
        • Wystarczy dodać odpowiednią opcję do koszyka i sfinalizować zamówienie.
      • Brak dostępnej opcji przedłużenia:

        • Jeśli przedłużenie wsparcia i aktualizacji nie jest oferowane, konieczne będzie ponowne zakupienie modułu.
    • 18. Jak długo mogę korzystać z modułu po zakupie?

      Zakupione produkty są dostępne do użytku bez ograniczeń czasowych. Natomiast dostęp do aktualizacji oraz wsparcia technicznego jest zazwyczaj ograniczony do 6 lub 12 miesięcy od daty zakupu, w zależności od produktu. (szczegóły na temat aktualizacji/wsparcia są zawsze uwzględnione na danej karcie produktu)

    • 19. Czy oferujecie wsparcie techniczne dla produktów?

      Tak, zapewniamy wsparcie techniczne w ramach okresu wsparcia przypisanego do danego produktu. Możesz skontaktować się z nami za pośrednictwem formularza kontaktowego lub e-maila.

    • 20. Czy mogę zaktualizować moduł do nowszej wersji?

      Tak, w ramach okresu wsparcia i aktualizacji możesz bezpłatnie pobrać nowe wersje produktu. Po upływie tego czasu możesz odnowić subskrypcję na aktualizacje.

    • 21. Czy mogę prosić o dostosowanie modułu do moich potrzeb?

      Tak, oferujemy usługę personalizacji modułów. Opisz nam swoje potrzeby, a przygotujemy indywidualną wycenę.

    • 22. o zrobić, jeśli mam problem z pobraniem modułu?

      Jeśli masz trudności z pobraniem modułu, upewnij się, że płatność została zaksięgowana. W przypadku dalszych problemów skontaktuj się z nami, a udostępnimy Ci moduł ręcznie.

    • 23. Czy oferujecie pomoc w optymalizacji sklepu po zainstalowaniu modułów?

      Tak, możemy pomóc w optymalizacji Twojego sklepu, aby moduły działały w pełni wydajnie. Zapytaj o naszą usługę wsparcia technicznego.

    • 24. Jak wygląda proces aktualizacji modułów?

      Jeśli moduł wymaga aktualizacji, możesz pobrać jego najnowszą wersję z panelu klienta. Przed aktualizacją zalecamy wykonanie kopii zapasowej sklepu.

    • 25. Czy mogę zmienić domenę, na której działa moduł?

      Tak, jeśli chcesz przenieść moduł na inną domenę, skontaktuj się z nami, aby omówić szczegóły i warunki przeniesienia licencji.

    • 26. Co zrobić, jeśli mój sklep przestanie działać po instalacji modułu?

      Jeśli Twój sklep napotka problemy po instalacji modułu, natychmiast skontaktuj się z naszym działem wsparcia technicznego. Pomożemy zdiagnozować i rozwiązać problem.

    • 27. Czy mogę prosić o poradę w wyborze modułu?

      Oczywiście! Skontaktuj się z nami, a doradzimy, który moduł najlepiej odpowiada Twoim potrzebom.

    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!