Návod k použití modulu PPL parcelshop pro Prestashop

Instalace

Modul se instaluje stejně jako většina ostatních modulů pro Prestashop - nahráním Zip balíčku v administraci

Nastavení modulu

Záložka Nastavení Parcelshopu

Zde vyplňte dopravce který bude pro Parcelshop použit. Modul při instalaci přidá nového dopravce, nezapomeňte mu nastavit cenu (Doručení - Dopravci) pokud jej chcete používat, jinak jej zakažte.

Záložka API Klíč

Zní to technicky ale je to velmi jednoduché. Záložku otevřete, okopírujte  text žádosti, který tam najdete a napište na PPL. Přijde Vám několik málo údajů které snadno vyplníte.  Pak už se jen zeptejte svého obchodního zástupce na   číslo depa ze kterého si jezdí pro Vaše zásilky.

Záložka nastavení API

Nejde o nic složitého, ale musíte vyplnit vše. V sekci odesílatel vyplňujete údaje o své firmě. V sekci Nastavení dobírky jsou  údaje o účtu na který si necháte posílat vybrané peníze. Dále seznam platebních modulů, vyberte ty u kterých se jedná o dobírku, tedy nikoliv o platbu předem.

Nastavení záložky exportu

Modul Vám do sekce objednávky přidal několik nových záložek, uvedení nastavení se týká záložky PPL export zásilek. V nastavení modulu volíte v podstatě 3 věci

  • do jakého stavu se má objednávka přesunout po úspěšném exportu
  • které objednávky se mají pro export nabízet na základě stavu objednávky
  • které objednávky se mají pro export nabízet na základě dopravce .... takže ano,  pokud máte jednoho PPL dopravce pro parcelshop a druhého pro doručení na adresu, můžete exportovat objednávky pro oba 

Nově přidané záložky

PPL export zásilek - viz nastavení výše. Nepřehlédněte možnost hromadného exportu. A je tu jedna malá zákeřnost - zásilky exportované přes API nenajdete na https://klient.ppl.cz/ jak jste byli zvyklí ale na https://www1.ppl.cz/  .... Vaše přihlašovací údaje tam platí!

PPL tisk  - zde je seznam dávek. Dávku tvoří zásilky které jste najednou okamžiku odeslali na PPL. Pokud jste odeslali jednu zásilku funkcí exportovat, je to jedna dávka. Pokud jste odeslali 100 zásilek hromadným exportem, je to jedna dávka. Kliknutím na PDF se vygeneruje PDF soubor k dané dávce.

PPL přehled - zde je přehled zásilek exportovaných na PPL, s možností je mazat. Aby přehled fungoval, nastavte si crontab, url cronu najdete v konfiguraci modulu.

Úprava vzhledu

základní barevné nastavní je přímo v administraci modulu

Pokud je  zobrazení vybrané pobočky nastaveno pod řádek dopravce, může Váš webmaster upravovat rozložení prvků v  šabloně

modules/pplparcelshop/views/templates/hook/pod_vysledek.tpl případně do ní přidat další proměnné. Id pobočky je potřeba ponechat.

Řešení problémů

Pokud API vrátí nějakou chybu, modul ji zapíše do logu: Nástroje - Chybové záznamy. Chyby jsou v angličtině a mohou vypadat složitě, ale většinou stačí přečíst poslední větičku. Zde je pár příkladů s vysvětlením příčin:

Did not obtain token from server, httpd code 401, not 200 return code

špatně zadaný tajný klíč v nastavení modulu

PPL PRODUCT TYPE NOT DEFINED FOR PPL parcelshop

nebo

Invalid combination of country and product type

v nastavení modulu je potřeba nejen vybrat dopravce s parcelshopem (záložka Nastavení parcelshopu) ale také tohoto dopravce povolit pro export do API a přiřadit mu správný typ PPL produktu (záložka Nastavení záložky exportu). Co se PPL produktu týče,  pro ČR to může být   PPL parcel private, ale ověřte si ve smlouvě s PPL. Pro SK to bude jiný produkt, třeba PPL parcel Smart Europe. Pokud tedy potřebujete jak ČR tak SK, založte si dalšího dopravce, nastavte mu parcelshop (Nastavení parcelshopu) a správný produkt pro SK (Nastavení záložky exportu).