Dokumentace pluginu Toret PPL

Nacházíte se na stránkách dokumentace pluginu Toret PPL pro WooCommerce, který implementuje tuto službu dopravy do e-shopu.

Pro použití pluginu PPL, musíte mít vytvořený účet u společnosti PPL.

Dále je potřeba u PPL zažádat o přístupy do CPL API. Do žádosti uveďte, že budete využívat řešení integrátora:

Toret plugins s.r.o.
IntegrID: 4257736.

Instalace pluginu

Po zakoupení pluginu PPL obdržíte emailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete zde.

Aktivace pluginu

Po instalaci pluginu si otevřete plugin Toret PPL, do příslušného pole vložíte licenční klíč a tlačítkem aktivujte.

Videonávod

Napojení na PPL

Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení. To se nachází v sekci Toret plugins → PPL

Pro napojení pluginu s PPL účtem je potřeba vybrat typ API, pro kterou máte přístupové údaje.

Přístupové údaje vložte do odpovídajících polí a uložte.

Pro připojení k CPL API (Create package label) potřebujete:

  • ClientID
  • Client secret

Rozsah čísel zásilky (pouze pro myAPI)

Dále je nutné si od PPL vyžádat rozsah čísel zásilek, který vložíte do nastavení pluginu na kartě „Hlavní nastavení“. Pokud by časem rozsah čísel zásilek docházel, u podpory PPL si jej nechte navýšit a tuto hodnotu upravte v nastavení pluginu.

Toto nastavení je nutné pouze pokud používáte propojení přes starší verzi api – myAPI.

Rozsah čísel na screenu je pouze příklad. Vyžádejte si vlastní u podpory PPL.

Hlavní nastavení

Na kartě Hlavní nastavení (Toret plugins > PPL) lze dále nastavit:

  • Nastavení sazeb za dopravné s/bez DPH
  • Automatické odesílání balíku při změně stavu objednávky (viz dále)
  • Vlastní příplatky, které lze nastavit globálně i individuálně podle různých kritérií
  • Reference a formát štítku
  • Adresy svozových míst pro vyzvednutí zásilek kurýrem
  • Vlastní ikony pro jednotlivé dopravy, které se zobrazí v pokladně
  • Hlavní nastavení (funkce pro přizpůsobení v pokladně a e-mailu)
  • Načítání měnových kurzů
  • Cron pro načítání stavu zásilky (viz dále)

Nastavení dopravců v pluginu PPL

Jednotlivé typy doprav najdete v plugin PPL (Toret Plugins > PPL) pod kartami v horní části obrazovky.

V pluginu Toret PPL můžete nastavit dopravu:

  • PPL Private (doručení na adresu)
  • PPL Morning (dopolední doručení na adresu)
  • PPL Parcelshop (výdejní místa)
  • PPL Business (doručení na firemní adresu)
  • PPL Return (zpětná zásilka)

Pokud je ve WooCommerci nastaveno DPH, tak cenu v pluginu nastavujte bez DPH. 

PPL Private

Pod kartou PPL Private je možné nastavit dopravu pro doručení do 21 států.

Pro každý povolený stát lze nastavit následující možnosti:

  • cena dopravy
  • maximální hmotnost a maximální rozměr
  • doprava zdarma nad částku
  • škálování ceny dopravy podle hmotnosti
  • dobírka (pokud ji PPL do daného státu podporuje)
  • dobírka zdarma nad částku
  • škálování příplatku dobírky podle ceny objednávky
  • večerní doručení
  • zpětná zásilka (jen pro podporované státy)

Tip: pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500, v pluginu nastavte 499.

PPL Morning

Na kartě PPL Morning si nastavíte dopravu s dopoledním doručením. Služba je dostupná pouze pro Českou republiku.

Lze nastavit následující možnosti:

  • cena dopravy
  • maximální hmotnost a maximální rozměr
  • doprava zdarma nad částku
  • škálování ceny dopravy podle hmotnosti
  • dobírka
  • dobírka zdarma nad částku
  • škálování příplatku dobírky podle ceny objednávky

PPL Parcelshop

Dopravní službu PPL Parcelshop pro doručení do výdejních míst a boxů je možné nastavit pro Českou republiku, Slovensko, Polsko, Německo.

Lze nastavit následující možnosti:

  • cena dopravy
  • maximální hmotnost a maximální rozměr
  • doprava zdarma nad částku
  • škálování ceny dopravy podle hmotnosti
  • dobírka (pokud ji PPL do daného státu podporuje)
  • dobírka zdarma nad částku
  • škálování příplatku dobírky podle ceny objednávky
  • zpětná zásilka (jen pro podporované státy)

PPL Business

Pod kartou PPL Business je možné nastavit dopravu pro doručení na firemní adresy ve 23 státech.

Lze nastavit následující možnosti:

  • cena dopravy
  • maximální hmotnost a maximální rozměr
  • doprava zdarma nad částku
  • škálování ceny dopravy podle hmotnosti
  • dobírka (pokud ji PPL do daného státu podporuje)
  • dobírka zdarma nad částku
  • škálování příplatku dobírky podle ceny objednávky

Tip: pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500, v pluginu nastavte 499.

PPL Parcel Return Connect Import

Pod kartou PPL Parcel Return Connect Import je možné nastavit zpětné zasílání zásilek pro Českou republiku. Tuto službu můžete nabízet zákazníkům již při nákupu v pokladně a štítek pro zpětnou zásilku přidávat do balíku.

Lze nastavit následující možnosti:

  • cena dopravy
  • maximální hmotnost a rozměr
  • doprava zdarma nad částku
  • škálování ceny dopravy podle hmotnosti

Nastavení dopravních zón

Po nastavení dopravců v pluginu Toret PPL je potřeba nastavit také stejnojmenné dopravce ve vašich dopravních zónách WooCommerce. Bez jejich nastavení v zónách dopravy se dopravci z pluginu PPL v pokladně nezobrazí.

Vyberte zónu, ve které chcete umožnit dopravu prostřednictvím PPL. Klikněte na „Upravit“.

V nastavení zóny klikněte na „Přidat způsob dopravy“.

Ze seznamu vyberte vámi požadovaný způsob a klikněte na Pokračovat.

Políčko Povolit nechte zatržené, můžete dle potřeby upravit Titulek a Popisek. Po kliknutí na Create and save bude způsob dopravy dostupný pro danou zónu.

Nastavení na úrovni produktu a kategorie

Plugin PPL přidává také další možnosti nastavení do detailu produktů a kategorie.

V detailu produktu tak můžete nastavit:

  • Ověření věku (viz dále)
  • Doprava zdarma pro produkt
  • Zakázání způsobu dopravy
  • Dobírka zdarma pro produkt
  • Deaktivace výdejních boxů pro produkt
  • Příplatek pro produkt (Ten musí být nejprve vytvořen v hlavním nastavení pluginu)

V detailu kategorie lze nastavit:

  • Zakázání způsobu dopravy
  • Doprava zdarma
  • Dobírka zdarma
  • Zakázání výdejních boxů
  • Příplatek podle kategorie (Ten musí být nejprve vytvořen v hlavním nastavení pluginu)

Podání zásilky z webu do PPL

V pluginu máte dvě možnosti podání zásilky do sytému PPL.

Podání balíku vyžaduje hmotnost. Doporučujeme nastavit váhu na úrovni produktů, bez nastavené váhy u produktů nebude fungovat automatické podání zásilek při změně stavu objednávky.

Zásilky odeslané přes plugin najdete také v Zákaznické zóně PPL.

1) Manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky

2) Automatické odeslání balíku při změně stavu objednávky

Automatické podání lze nastavit v pluginu PPL  → Hlavní nastavení.

Objednání vyzvednutí balíku

Přes plugin je možné si objednat vyzvednutí balíku. Objednávku vyzvednutí je možné provést dvěma způsoby.

Manuálně

V přehledu objednávek je u podaných objednávek do systému PPL ikona auta. Po kliknutí na ikonu se nad přehledem objednávek zobrazí box s možností výběru data, na kdy vyzvednutí balíku objednat.

Automaticky

Na kartě „Hlavní nastavení“ v pluginu PPL je možné nastavit automatické objednání vyzvednutí zásilky na další den při vytvoření zásilky.

Ověření věku

Plugin PPL podporuje ověření věku. To je možné nastavit pro libovolný produkt přímo v detailu produktu na kartě PPL, kde pro aktivaci stačí požadavek Ověření věku zaškrtnout.

Vše funguje automaticky. Pokud se v objednávce nachází alespoň jeden produkt, který vyžaduje při předání ověření věku, tak bude celá objednávka vyžadovat ověření věku.

Vybrat můžete mezi hranicí 15+ a 18+.

Doprava zdarma

Dopravu zdarma nastavíte přímo v pluginu PPL (Toret Plugins > PPL) u každého typu dopravy, pro každou zemi zvlášť.

Nastavení dopravy zdarma je „nad“ částku, tedy doprava zdarma se na webu aktivuje po překonání nastavení částky v košíku.

PŘÍKLAD: Pokud chcete dopravu zdarma od 500,- tak do pluginu nastavte částku 499.

Tip: Pokud máte ve WooCommerci nastavené DPH, tak se hodnota pro spuštění dopravy zdarma zadává bez DPH.

Nastavení částky dopravy zdarma se vztahuje pouze pro produkty, nezapočítává se cena dopravy.

PŘÍKLAD: Pokud máte nastavenou dopravu zdarma od 500,- a v košíku je produkt za 450,- + cena dopravy 65,- = 515,- Kč, tak se doprava zdarma neaktivuje. Je potřeba překonat nastavenou cenu produktem, tedy aby se takto nastavená doprava zdarma aktivovala, je zapotřebí vložit do košíku produkt(y) hodnoty minimálně 500,- Kč.

Dopravu zdarma pro konkrétní produkt nastavíte v jeho detailu na kartě PPL.

Dopravu zdarma pro zboží z konkrétní produktové kategorie lze povolit v nastavení kategorie.

Kupóny pro dopravu zdarma

Plugin podporuje kupóny pro dopravu zdarma. Ty lze nastavit globálně, pro všechny PPL dopravy, nebo pro konkrétní druh doručení. Chování kuponu nastavíte v hlavním nastavení pluginu (Toret plugins > PPL > Hlavní nastavení).

Pokud zvolíte možnost Vybraný způsob dopravy zdarma, povolte kupóny v nastavení dané konkrétní metody, pro kterou chcete mít kupón aktivní.

Tisk štítků (pouze pro myAPI)

! Doporučujeme používat API Create package label (CPL), která nastavení rozsahu čísel zásilek nepotřebuje. U nových registrací vám PPL vystaví rovnou API CPL.

Pokud máte starší registraci a chcete zůstat u myAPI, je nutné si od PPL vyžádat rozsah čísel zásilek, který vložíte do nastavení pluginu na kartě „Hlavní nastavení“. Pokud by časem rozsah čísel zásilek docházel, u podpory PPL si jej nechte navýšit a tuto hodnotu upravte v nastavení pluginu.

Rozsah čísel na screenu je pouze příklad. Vyžádejte si vlastní u podpory PPL.

Nastavení údajů na štítku

Štítek je vytvářený naším pluginem. Aby štítek obsahoval všechny potřebné údaje, které PPL vyžaduje, je nutné kromě rozsahu čísel zásilek také vyplnit:

  • Název společnosti odesílatele viditelný na štítku
  • Kontaktní osoba odesílatele viditelná na štítku
  • E-mail odesílatele viditelný na štítku
  • Telefonní číslo odesílatele viditelné na štítku

Nastavení štítku zásilky najdete na kartě „Hlavní nastavení“

Štítky podaných balíků je možné si stáhnout rovnou v administraci webu.

V přehledu objednávek u již podané objednávky do systému PPL klikněte na ikonu dokumentu PDF (viz. obrázek) u vybrané objednávky. Štítek se uloží ve formátu PDF a poté jej můžete vytisknout.

U podané zásilky je možné štítek také stáhnout v detailu objednávky.

Automatické načítání stavu zásilky

Abyste přímo v přehledu objednávek mohli sledovat stav zásilky v přepravě, je možné využít cron. Ten najdete na kartě Hlavní nastavení (Toret Plugins > PPL) a zde zároveň funkci aktivujete.

Cron pak nastavíte ve svém hostingu včetně požadovaného intervalu jeho spouštění.

Testování pluginu

Pro účely testování můžete využít:

  • subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web)
  • localhost (127.0.0.1)

Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání.

Časté dotazy

Vlastní sazba DPH u příplatku dobírky

Plugin je naprogramovaný tak, aby se DPH příplatků se počítalo podle DPH produktů v košíku. Tedy pokud je v košíku jeden produkt s DPH 10%, tak DPH dobírky a dopravy bude také 10% (u dopravy také záleží na nastavení WooCommerce, zda máte fixní standardní sazbu, nebo nastavení DPH podle košíku). Pokud v košíku bude produkt s 10% a produkt s 21% započítá se k příplatků 21% DPH, takto byla funkce naprogramována po konzultaci s FÚ. Nicméně si můžete DPH dobírky fixně nastavit pomocí filtru zde:

add_filter( 'tppl_taxclass_dobirka','ppl_change_cod_tax_rate');

function ppl_change_cod_tax_rate( $FeeData ){
return [ "tax_class" => "21"];
}

Aby se filtr při další aktualizaci pluginu PPL nesmazal, je nutné jej vložit do child šablony nebo do prázdného pluginu ZDE.

Přejít nahoru