Aktualizace kurzů NBP Pro — měnové kurzy v PrestaShopu

Nejdůležitější vlastnosti a funkce modulu

• Data z API Polské národní banky: stahování kurzovních tabulek přes HTTPS s kontrolou správnosti odpovědi a dat publikace.
• Čtyři varianty zdroje kurzů: tabulka A, spojené tabulky A a B, nákupní kurz z tabulky C nebo prodejní kurz z tabulky C.
• Výběr měn zahrnutých do aktualizace: určení existujících, aktivních cizích měn přiřazených k vybranému obchodu v PrestaShopu.
• Cenový buffer pro každou měnu: samostatná procentní hodnota od 0 do 50 %, zohledněná při výpočtu kurzu obchodu.
• Podpora různých základních měn: přepočet přes referenční hodnoty v PLN, pokud jsou základní měna i vybrané měny dostupné v používaném zdroji.
• Náhled před ručním potvrzením: porovnání aktuálního kurzu s navrhovaným, procentního rozdílu, data a čísla tabulky NBP a přepočtu 100 jednotek základní měny.
• Platnost náhledu po dobu 10 minut: potvrzení zaměstnancem, který jej vytvořil, po opětovné kontrole kurzů, nastavení a základní měny.
• Maximální povolená změna kurzu: překročení nastaveného prahu u jedné z vybraných měn zablokuje uložení celého balíčku.
• Přeskakování drobných změn: práh minimální změny od 0 do 5 %, který umožňuje ponechat kurz bez uložení při menších rozdílech.
• Kontrola stáří publikace: limit od 1 do 30 kalendářních dnů, zohledňující data údajů použitých pro přepočet.
• Společné uložení kurzů a historie: transakce databáze a blokace operací tohoto modulu pro daný obchod omezují riziko částečného uložení a souběžných aktualizací.
• Historie s přístupem k detailům: datum operace, ruční režim nebo CRON, stav, důvod zaznamenané blokace nebo chyby a detaily vytvořeného náhledu nebo změny.
• Obnovení dřívějších kurzů: vrácení uložené aktualizace je dostupné, pokud jí zahrnuté kurzy stále odpovídají výsledku této operace.
• Automatizace přes CRON: soukromá adresa pro obchod, minimální odstup mezi pokusy od 15 do 1440 minut a možnost změny přístupového klíče.
• Simulace automatické úlohy: parametr dry_run=1 zkontroluje plán aktualizace bez změny kurzů obchodu.
• Aktualizace podmnožiny měn přes CRON: parametr currencies omezuje volání na uvedené měny z těch, které byly dříve v modulu zapnuty.
• Informace o přepočtu pro zákazníka: volitelná zpráva na stránce produktu a v košíku zobrazuje skutečný kurz obchodu pro vybranou cizí měnu.
• Konfigurace zvlášť pro obchody: v multistore se nastavení, historie, klíč CRON a záznamy kurzů týkají konkrétního obchodu.
• Panel se šesti záložkami: Přehled, Měny, Nastavení, Automatizace, Historie a Pomoc uspořádávají konfiguraci i obsluhu aktualizací.
• Doba uchovávání historie: nastavení od 7 do 365 dnů s čištěním starších záznamů po správně zpracovaných aktualizacích CRON; simulace čištění nespouští.

Jaké kurzy NBP lze v obchodě použít?

Vybraný zdroj musí obsahovat základní měnu obchodu i aktualizované měny. PLN tvoří referenci s hodnotou 1. Tabulky A a B mohou mít různá data publikace, proto modul kontroluje stáří dat potřebných pro daný přepočet.

Jak funguje přepočet kurzů a cenový buffer?

PrestaShop ukládá počet jednotek cílové měny připadající na jednu jednotku základní měny obchodu. Modul tento kurz vypočítá jako: hodnota základní měny v PLN ÷ hodnota cílové měny v PLN × (1 + procentní buffer ÷ 100). Výsledek ukládá s přesností na šest desetinných míst.

Příklad: při PLN jako základní měně a kurzu 1 EUR = 4 PLN činí kurz obchodu 0,25 EUR za 1 PLN. Buffer 2 % jej zvýší na 0,255, takže částka 100 PLN přepočtená podle tohoto kurzu dává 25,50 EUR. Buffer ovlivňuje standardní přepočet cen, ale není bankovním poplatkem ani zárukou marže.

Co získá obsluha obchodu?

• Méně ručního přepisování kurzů: data pocházejí z vybraného zdroje NBP a po přidání harmonogramu může aktualizace provádět CRON.
• Kontrola před změnou cen v cizích měnách: náhled umožňuje posoudit navrhovaný přepočet a buffery i prahy změn přizpůsobit pravidlům obchodu.
• Přístup k předchozím hodnotám: detaily uložené aktualizace usnadňují kontrolu rozdílu a případné obnovení kurzů.
• Oddělená obsluha multistore: pro jednotlivé obchody lze používat různé zdroje, buffery a pravidla automatizace.

Jakou informaci získá zákazník?

Po zapnutí zprávy může zákazník používající cizí měnu na kartě produktu a v košíku vidět přepočet ve formě „1 jednotka základní měny = kurz v měně zákazníka“. Zpráva také informuje, že ceny používají kurz obchodu, který může obsahovat cenový buffer. Čas uložené aktualizace a datum publikace NBP se zobrazí, když záznam z načítané poslední historie odpovídá aktuální základní měně a kurzu zákazníka; po obnovení kurzů se nové datum NBP nedopisuje.

Zpráva je skrytá pro základní měnu a lze ji vypnout v nastavení. Zobrazení vyžaduje, aby šablona poskytovala podporovaná místa na stránce produktu a v košíku. Při zobrazování těchto stránek modul načítá uložený kurz obchodu bez stahování tabulek NBP.

Jak spustit aktualizaci kurzů NBP v PrestaShopu?

1. Vyberte obchod a na záložce Měny označte aktivní cizí měny a nastavte jejich buffery.
2. V Nastavení vyberte zdroj NBP, maximální a minimální změnu kurzu a povolené stáří publikace.
3. Načtěte náhled v Přehledu a porovnejte navrhované hodnoty. Samotný náhled kurzy nemění.
4. Potvrďte správný náhled a zkontrolujte výsledek v historii.
5. Pokud potřebujete automatizaci, zapněte ji na záložce Automatizace a na serveru přidejte úlohu, která bude volat vygenerovanou adresu CRON. Dostupná simulace umožňuje předem zkontrolovat výsledek bez uložení kurzů.

Podmínky fungování a rozsah aktualizace

Modul je určen pro PrestaShop 1.7.x, 8.x a 9.x. Vyžaduje PHP ve verzi podporované daným vydáním obchodu, rozšíření cURL, správnou podporu certifikátů HTTPS a přístup serveru k API NBP. Tabulky uchovávající kurzy měn obchodu a historii modulu musí používat engine InnoDB. Základní měna musí být aktivní a mít kurz rovný 1; modul ji nemění na jinou.

Aktualizují se kurzy měn daného obchodu, nikoli záznamy cen produktů ani dřívější objednávky. Speciální ceny, pevné částky v cizích měnách, kupóny a zaokrouhlování zachovávají nativní fungování PrestaShopu. V jednom obchodě je třeba používat jeden mechanismus automatické aktualizace kurzů.

Instalace nemění aktuální kurzy a ponechává CRON vypnutý. Výchozí buffer činí 0 %, maximální změna 10 %, minimální změna 0,05 %, povolené stáří publikace 10 dnů, minimální odstup automatických pokusů 60 minut a doba historie 90 dnů. Obnovení vyžaduje zachovaný záznam historie, stále odpovídající kurzy a stejnou základní měnu; neslouží k přepsání pozdějších změn.