PPL plugin (CZ)

Plugin PPL umožňuje zákazníkovi na stránce pokladny e-shopu nopCommerce výběr možnosti doručení na adresu nebo s pomocí grafického widgetu vybrat vhodné výdejní místo PPL Parcelshop nebo výdejní box PPL Parcelbox. Prostřednictvím aplikačního rozhraní systému PPL (CPL API v1) z administrace e-shopu založí novou zásilku, vytiskne dopravní štítek, objedná svoz zásilek, automaticky synchronizuje stav doručované zásilky do eshopu... Umožňuje zadat detailní podmínku, při níž se bude zákazníkovi dopravní možnost objevovat na stránce pokladny s nastavenou cenou dopravy. Nezbytnou podmínkou pro fungováni API propojení je registrace u dopravce PPL a zažádání, obdržení a nastavení přihlašovacích údajů k aplikačnímu rozhraním CPL.

Plugin umí fungovat i bez napojení na API a v administraci pak funguje v manuálním režimu.

POZOR: Před nákupem plné verze vždy nejprve otestujte zkušební verzi!

Aktuální plugin poskytujeme pro nejnovější verzi nopCommerce v4.90 a starší v4.80 + v4.70.

Co umí plugin PPL na stránce pokladny:

• Zobrazí možnost doručení na soukromu adresu. Tedy pokud je tato možnost v konfiguraci pluginu nastavena.
• Zobrazí oficiální widget PPL pro výběr výdejního místa nebo boxu. Děje se tak v kroku výběru "Způsob dopravy" mezi ostatními vyhodnocenými způsoby dopravy.
• Pamatuje si poslední zákazníkem vybrané výdejní místo. Zákazník tak může rychleji docílit potvrzení objednávky.
• Nedovolí postup k dalšímu kroku bez vybraného platného výdejního místa. Nemůže se tak stát, že zákazník sice zvolí možnost dopravy na výdejní místo PPL, ale samotné místo nevybere.
• Funguje i s pluginem OnePageCheckout od nop-templates.com. Výběr výdejního místa jsme upravily, aby korektně fungoval i v tomto jednostránkovém pluginu jiného dodavatele.

Co umí plugin PPL v administraci:

• Detailní nastavení podmínky pro zobrazení dopravní možnosti. Na konfigurační stránce pluginu jde zadat libovolný počet dopravních možností službou PPL, ze kterých se zákazníkovi na stránce pokladny vybírá to první, které vyhovuje s ohledem na aktuální obsah košíku a cílovou adresu. Lze tak kombinovat hmotnostní a rozměrové omezení pro danou možnost i s možností určení, zda se pro tento případ mají zákazníkovi nabízet i výdejní boxy (ty mají striktnější pravidla pro uložení zásilky) nebo jestli se v tomto případě jedná o doručení na adresu. Nastavit lze i omezení na roli zákazníka.
• [API] Přidáním zásilky v e-shopu přes vylepšený formulář se založí zásilka do systému PPL. Tj. žádný ruční přepis adresních údajů nebo údajů o zásilce. Pokud nebyla zásilka ještě uhrazena, je i předvyplněna dobírka (možnost ručně upravit).
• [API] Napojení již existující zásilky PPL na novou nebo existující zásilku v eshopu. Je tak možné zadáním čísla zásilky ze systému PPL propojit zásilku eshopu se zásilkou PPL a nechat sesynchronizovat do eshopu reálný stav zásilky. POZOR, při tomto dodatečném propojení nelze z administrace e-shopu pro danou zásilku vytisknout dopravní štítek.
• [API] Tisk dopravního štítku pro založené zásilky. Lze tisknout i více štítků zaráz (nopCommerce používá formát PDF a požadavek na více štítků se v pluginu spojí do jednoho výsledného PDF). Kromě přizpůsobení originálu získané etikety ve formátu blízkém A6 (natočení, oříznutí, zvětšení) lze zvolit i sestavu čtyř štítků na A4 s možností přeskočení pozic na první stránce.
• [API] Objednat svoz zásilek dopravcem. Na novém přehledu "Zásilky dopravců" lze pro označené zásilek objednat datum svozu vybraných zásilek. Objednaný svoz jde i zrušit.

Co umí plugin PPL automaticky:

• [API] Synchronizuje stav zásilky v systému PPL do eshopu. Tj. posouvá stav zásilky a objednávky v e-shopu podle aktuálního stavu přepravy a doručení. E-shop nopCommerce tak může automaticky zareagovat na změnu stavu objednávky a odeslat příslušnou zprávu zákazníkovi, je-li povolená.
• [API] Zruší zásilku v eshopu, pokud ji stornujete na portále PPL. Tj. není potřeba administrovat zásilky pouze ze strany eshopu - můžete si pomáhat i klientským portálem PPL  POZOR, aktuálně je tato možnost limitovaná možností použitého rozhraní (CPL v1), které neumožňuje pracovat na portále PPL se zásikami, které byly založeny přes API (tj. z administrace e-shopu). Tato situace se může časem změnit.

K tomuto pluginu máme i zkušební verzi, která je plně funkční po dobu 10i dní. Neobjednávejte plugin, pokud jste jej nevyzkoušeli! Všechny případné problémy se musí odladit ještě se zkušební verzí. Na pozdější problémy vyplývající z nestandardní instalace, customizací původního zdrojového kódu nopCommerce, použití neobvyklých (někdy i špatně zimplementovaných) rozšíření třetích stran aj. nebudeme brát zřetel a taková reklamace bude zamítnuta. V případě objevení problému s testovací verzí nás neváhejte kontaktovat.

Plugin nabízíme v licenci pro jednu i více domén. Od dokončení objednávky budete mít možnost stahovat bezplatně aktualizace po dobu 1 roku v rámci servisního období. Před vypršením aktuálního servisního období vám s předstihem 30 dní nabídneme možnost zvýhodněného prodloužení na další rok.

Stručný návod k pluginu PPL

Důležité aktualizace pluginu PPL:

• 48.9.27 (2.10.2025) ... efektivnější cachování výdejních míst do databáze
• 48.8.17 (3.7.2025) ... přidáno omezení zobrazení dopravní možnosti na roli zákazníka
• 47.3.23 + 46.6.12 (20.6.2024) ... první úplná veřejná verze