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.

Plugin PPL zakoupíte zde: Toret PPL pro WooCommerce

Instalace pluginu

Po zakoupení pluginu PPL obdržíte e-mailem 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)

Pozor! Podpora myAPI v pluginu končí ke 31.3.2026. Po tomto datu lze používat plugin pouze s CPL API.

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:

• Sazby a daně (DPH, daňová třída dobírky, chování kuponu na dopravu zdarma)
• Vlastní příplatky – lze nastavit pro produkt, variantu, kategorii, zemi, dopravu či globálně
• Štítky – formát, poznámka a reference
• Nastavení widgetu – otevírání, umístění tlačítky, skrytí boxů a dobírky
• Adresy svozových míst pro vyzvednutí zásilek kurýrem
• Zobrazení ikon pro jednotlivé dopravy v pokladně
• Hlavní nastavení (funkce pro pokladnu a e-mail)
• Vícenásobné zásilky (automatické rozdělení objednávky do více balíků na základě hmotnosti)

Nastavení dopravců v pluginu PPL

Jednotlivé typy doprav doručení najdete v pluginu PPL na záložce Způsoby dopravy (Toret Plugins > PPL > Způsoby dopravy). Po kliknutí na tlačítko Nastavení u konkrétní země uvidíte přehled doprav dostupných pro danou zemi.

Po aktivaci dané dopravy zaškrtnutím checkboxu a kliknutím na Uložit se zobrazí nastavení dané metody.

V pluginu Toret PPL můžete nastavit dopravu:

• PPL Private (doručení na adresu)
• PPL Parcelshop (výdejní místa pro Českou republiku, Slovensko, Polsko, Německo)
• PPL Business (doručení na firemní adresu)
• PPL Dopolední balík
• PPL Parcel Return Connect Import (Zpětné zasílání zásilek ze zahraničí do Česka. Služba je možná pouze z podporovaných zemí. Tyto země musí být nastaveny jako adresa pro vyzvednutí (odesílatel).)
• PPL Parcel CZ Smart do boxu

Pro každý způsob dopravy a zemi doručení lze nastavit následující možnosti:

• cena dopravy – jednotná nebo dle hmotnosti
• doprava zdarma nad částku
• použití kupónu pro dopravu zdarma
• paušální cena v ostatních měnách
• maximální hmotnost a maximální rozměr (při překročení se způsob dopravy v pokladně nezobrazí)
• dostupnost dle hodnoty košíku, množství položek v košíku nebo ceny produktu (při překročení se způsob dopravy v pokladně nezobrazí)
• dobírka (pokud ji PPL pro daný způsob dopravy a zemi podporuje)
• příplatek dobírky – jednotný nebo dle ceny objednávky
• dobírka zdarma nad částku
• večerní doručení (pokud jej PPL pro daný způsob dopravy a zemi podporuje)
• zpětná zásilka (pokud ji PPL pro daný způsob dopravy a zemi podporuje)

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

Nastavení ceny

Nejprve vyberte Typ výpočtu dopravy. Cenu za dopravu lze nastavit jednotně – pevnou částkou, která se zadá do pole Jednotná cena,

nebo nastavit vlastní pravidla ceny dle hmotnosti zásilky.

Paušální sazba v ostatních měnách: Zde můžete nastavit pevné ceny dopravy, které se použijí, pokud je objednávka v jiné měně, než je výchozí měna e-shopu.

Doprava zdarma

Dopravu zdarma nastavíte přímo v pluginu PPL (Toret Plugins > PPL > Způsoby dopravy) 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í.

Dobírka

Pro nastavení dobírky k dopravě je nutné zaškrtnout checkbox Povolit dobírku.

Následně je možné nastavit:

Zdarma od: Od zadané hodnoty objednávky bude dobírka bez příplatku.

Maximální povolená hodnota: Při překročení této hodnoty objednávky nebude dobírka v pokladně k dispozici.

Typ výpočtu poplatku: Můžete zvolit pevní příplatek – Jednotná cena,

nebo příplatek škálovat podle hodnoty objednávky – Celková cena a nastavit vlastní pravidla ceny.

Hmotnostní a rozměrové limity

Pokud aktivujete kontrolu hmotnosti/rozměrů a zadáte hodnoty pro maximální rozměr/hmotnost, při překročení limitů se doprava v pokladně skryje. Hmotnost/rozměry plugin načítá z hodnot nastavených u produktů.

Dostupnost

V sekci Dostupnost lze nastavit minimální a maximální hodnotu košíku, počty položek v košíku nebo cenu produktu. Pokud objednávky překročí některý z limitů, doprava nebude v pokladně dostupná.

Večerní doručení

Večerní doručení aktivujete zaškrtnutím checkboxu Povolit PPL večerní doručení (17:00 – 21:00). Večerní doručení je dostupné pouze u některých způsobů dopravy.

V pokladně se zobrazí jako dodatkový checkbox ke způsobu dopravy.

Služba vrácení balíku

Pro podporované způsoby dopravy je k dispozici také vrácení balíku – s odevzdáním v ParcelShopu. Službu je nutné aktivovat – checkbox Povolit PPL Return balík v pokladně (PPL Private, PPL Private s dobírkou). Příjemce odnese balík do PPL Parcelshopu.

Následně je možné nastavit text, příplatek a předzaškrtnutí pole. V pokladně se zobrazí jako dodatkový checkbox ke způsobu dopravy.

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í.

Ve WooCommerce > Nastavení > Doprava 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. Stav daně lze zvolit Zdanitelný nebo Žádný. 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 na kartě Automatické odesílání.

V sekci Odeslat data do systému PPL při změně stavu objednávky zvolte pro jednotlivé metody platby stav objednávky, při kterém se automaticky odešlou data do systému PPL.

V sekci Hlavní nastavení lze nastavit, zda se bude při vytvoření zásilky automaticky vytvářet také štítek a objednávat svoz.

Provedené změny nezapomeňte uložit.

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ě Automatické odesílání, v sekci 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+.

Tisk štítků

Nastavení tisku štítku s 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í“

Nastavení formátu štítku, poznámky a referenčního čísla

Nastavení formátu štítku, poznámky a reference na štítek můžete provést v pluginu PPL, na kartě Hlavní nastavení.

Stažení a tisk štítků

Š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ě Sledování (Toret Plugins > PPL > Sledování). Cron pak nastavíte ve svém hostingu včetně požadovaného intervalu jeho spouštění.

Změna stavu objednávky na základě stavu zásilky v přepravě

Na kartě Sledování lze dále nastavit změnu stavu objednávky podle stavu zásilky u přepravce. Pro dané stavy PPL jednoduše přiřadíte stavy objednávek ve WooCommerce a provedené změny uložíte.

Např. Při úspěšném doručení zásilky PPL se stav objednávky změní na Dokončeno.

Časté dotazy

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

Sazbu DPH pro dobírku nastavíte v Hlavním nastavení pluginu, sekce Sazby a daně. Daňovou sazbu lze určovat podle položek v košíku či ji nastavit fixně,