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)

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ě,