Toret PPL 4.0: odesílací fronta a hromadné štítky — a čtyři věci, které vyřešte před aktualizací

Expedice je na malém e-shopu skoro vždycky to nejnudnější místo dne. Objednávky přijdou, balíky se zabalí — a pak se člověk posadí k počítači a klikáním je jeden po druhém předává dopravci. U deseti balíků se to dá vydržet. U padesáti je to půlhodina, kterou nikdo nezaplatí.

Plugin Toret PPL, který propojuje WooCommerce s PPL, vyšel v nové verzi 4.0 a míří přesně sem. Přepracoval způsob, jakým se zásilky podávají, a hlavně rozvázal hromadný tisk štítků od hromadného podání. Zároveň je to ale aktualizace, u které se nevyplatí kliknout na „Aktualizovat“ a jít si pro kávu — verze 4 má několik podmínek, bez kterých vám pokladna nebo expedice přestane fungovat.

Níže je obojí: co nová verze přináší i co je potřeba mít připravené předtím, než ji nasadíte.

Odesílací fronta: podávání běží na pozadí

Tohle je hlavní změna. Dřív platilo, že když jste zásilku předávali dopravci, čekali jste na odpověď PPL. Administrace se zasekla na několik vteřin, a pokud jste podávali dávku objednávek najednou, dokázalo to spolehlivě vytočit i trpělivého člověka. U větších dávek hrozilo, že požadavek prostě vyprší.

Verze 4 zavádí odesílací frontu. Objednávku označíte k podání, plugin ji zařadí do fronty a vrátí vám administraci zpátky. Komunikace s PPL pak probíhá na pozadí — čísla zásilek a štítky se v přehledu objednávek doplňují průběžně a u každé vidíte, v jakém stavu je: čeká ve frontě, čeká na odpověď PPL, hotovo.

Prakticky to znamená, že expedice a podávání se od sebe oddělily. Můžete balit dál a nedívat se, jestli už to proběhlo. Frontu jde v administraci i ručně popostrčit tlačítkem.

Hromadný tisk štítků bez hromadného podání

Druhá změna je menší na popis, ale v provozu ji poznáte hned. Dřív byly hromadné podání a hromadný štítek svázané — abyste dostali jeden PDF soubor se štítky, museli jste zásilky podat jako jednu dávku.

Nově to neplatí. Zásilky se můžou podávat průběžně, ručně i automaticky podle stavu objednávky, a hromadný štítek si vyžádáte až potom — a jen pro ty, které vyberete.

Pro běžný provoz je to rozdíl mezi „musím expedici nashromáždit do jedné dávky“ a „balím, jak chodí objednávky, a před svozem si vytisknu, co je hotové“. Tiskárnu štítků tak pustíte jednou denně místo desetkrát.

Co plugin umí kromě toho

Zbytek funkcí zůstává, případně přibyl. Ve zkratce to, co dává smysl vypíchnout:

• Výdejní místa přímo v pokladně. Mapa s vyhledáváním, zákazník si pobočku vybere bez odcházení z objednávky.
• Širší záběr než jen Česko. Parcelshop v šesti zemích, adresní doručení ve dvou desítkách evropských zemí, firemní doručení a služby Smart Europe.
• IDCheck s ověřením věku. Kontrola 15+ a 18+ při předání — podstatné, pokud prodáváte něco s věkovým omezením.
• Vratky, včetně ze zahraničí. Podpora PPL Return a Parcel Return Connect Europe.
• Objednání svozu v časovém okně přímo z e-shopu.
• Ceník dopravy podle vašich pravidel. Pevná cena, podle hmotnosti nebo pásmová, doprava zdarma od částky či podle produktů a kategorií, dobírka s příplatkem.
• Technické zázemí. HPOS, multisite, WPML a přepínače měn, kontrola hmotnosti a rozměrů.

Čtyři věci, které vyřešte před aktualizací

A teď ta méně příjemná část. Verze 4 je přepsaná dost na to, aby si vynutila pár věcí na vaší straně. Pokud je přeskočíte, projeví se to buď tím, že nepůjde podávat, nebo tím, že zákazníkovi nenaskočí mapa v pokladně — a to druhé je horší, protože o tom nevíte, dokud si někdo nestěžuje.

1. Přístupy k CPL API

Plugin pracuje výhradně s CPL API. Starší myAPI verze 4 nepodporuje a už se k němu nevrátíte — podpora myAPI v pluginu skončila 31. března 2026 a samotné rozhraní PPL plánuje vypnout do poloviny roku 2028.

Jestli tedy ještě jedete na jménu a heslu, potřebujete si v zákaznické administraci PPL vyžádat Client ID a Client secret. Při nastavení se zadává i ID integrátora, u Toretu 4257736.

Tohle si vyřiďte jako první a s předstihem. Není to věc na pět minut a zbytek nastavení na tom stojí.

2. API klíč k widgetu 2.0

Mapa výdejních míst v pokladně běží v nové verzi jen na widgetu PPL 2.0. Starší widget je ukončený a plugin ho nepodporuje.

Klíč si vygenerujete v administraci PPL na client.ppl.cz/widgetadmin, kde zároveň povolíte doménu svého e-shopu, a vložíte ho do nastavení pokladny v pluginu. Bez klíče se mapa nenačte a zákazník si nemá kde vybrat pobočku.

Na povolenou doménu pozor zvlášť — když web provozujete i na testovací adrese, je potřeba přidat obě.

3. Skutečný serverový CRON, ne WP-cron

Tady je drobnost, kterou je snadné přehlédnout a která rozhoduje o tom, jestli vám fronta bude k něčemu dobrá.

WordPress má vlastní plánovač (WP-cron), jenže ten není časovač — spouští se návštěvou stránky. Na e-shopu, kde je v deset večer klid, se tedy fronta nezpracuje, dokud někdo nepřijde. Zásilky tak můžou čekat hodiny na to, aby se vůbec podaly.

Řešení je naplánovaný CRON na hostingu, který volá adresu z administrace pluginu — v sekci Stav ji najdete i s tokenem. Doporučený interval je každých pět minut. Fronta pak běží nezávisle na provozu.

Většina rozumných českých hostingů plánované úlohy v administraci umí a je to otázka jednoho řádku. Pokud si nejste jistí, jestli to ten váš zvládne, je to dobrý důvod podívat se, na čem vlastně WordPress provozujete — u e-shopu se to hodí vědět tak jako tak.

4. Nastavte nový e-mail se sledovacím odkazem

Tohle je přímý důsledek fronty a stojí za vysvětlení, protože jinak působí jako chyba.

Při automatickém podání se zásilka předává na pozadí. Standardní e-mail WooCommerce ke změně stavu objednávky ale odejde okamžitě — tedy ve chvíli, kdy zásilka frontou ještě neprošla a číslo zásilky zkrátka neexistuje. Sledovací odkaz proto v takovém e-mailu nebude.

Toret to řeší novým typem automatického e-mailu, který odchází až ve chvíli podání, kdy už je číslo k dispozici. Není zapnutý sám od sebe, je potřeba ho v nastavení aktivovat. Jestli na to zapomenete, zákazníkům prostě přestanou chodit sledovací odkazy.

Minimální požadavky: zkontrolujte je předem

Verze 4.0 si žádá WordPress 7.1, WooCommerce 11.0 a PHP 8.1. To je znatelný skok oproti tomu, co stačilo dřív, a je to nejčastější důvod, proč aktualizace nevyjde.

Než plugin aktualizujete, projděte si tedy tohle:

• Verzi PHP na hostingu. Bývá v administraci hostingu nebo ve Nástroje → Zdraví webu ve WordPressu.
• Verzi WooCommerce. Velký skok WooCommerce si zaslouží vlastní zálohu a vlastní den — nedělejte ho společně s aktualizací dopravního pluginu.
• Zálohu celého webu. Banální rada, ale u pluginu, který sahá na objednávky, obzvlášť namístě.
• Testovací objednávku po aktualizaci. Projděte pokladnu jako zákazník, vyberte výdejní místo, objednávku podejte a zkontrolujte, že přišel štítek i e-mail.

Na produktové stránce pluginu jsou zatím uvedené starší, nižší požadavky — ty platí pro předchozí řadu. Pro verzi 4.0 se řiďte čísly výše.

Kolik to stojí

Plugin se prodává za 1 990 Kč ročně. V ceně je rok aktualizací a podpory a 14denní garance vrácení peněz. Ke koupi se aktuálně přidávají tři měsíce Toret WooCommerce Manageru zdarma.

Pokud si nastavení nechcete dělat sami, nabízí Toret instalaci a nastavení za 1 290 Kč jednorázově. Vzhledem k tomu, že u verze 4 je potřeba vyřídit přístupy k CPL, klíč k widgetu i CRON, není to u méně technického provozovatele úplně zbytečná položka.

Roční model znamená, že po roce plugin nepřestane fungovat, ale přestanou chodit aktualizace. U dopravního pluginu je to citlivější než jinde — dopravci mění rozhraní, jak se jim zlíbí, a přesně to je vidět na celém přechodu z myAPI na CPL. Neaktualizovaný plugin propojený s dopravcem je otázka času.

Komu se to vyplatí a komu ne

Vyplatí se, pokud přes PPL posíláte pravidelně a denní objednávky počítáte na desítky. Tam se dvě tisícovky ročně vrátí na ušetřeném čase během prvních týdnů — samotné odpadnutí ručního přepisování adres a čísel zásilek za to stojí.

Vyplatí se i tehdy, když posíláte do zahraničí nebo řešíte vratky. Ruční odbavení zahraniční zásilky je pokaždé malý projekt a tohle je přesně ta agenda, kterou má smysl hodit na software.

Nevyplatí se, pokud posíláte pár balíků týdně a PPL je jen jednou z možností. Při takovém objemu je ruční podání na portálu dopravce rychlejší než nastavovat CRON a API klíče.

Rozmyslete si to i v případě, že běžíte na starším hostingu s PHP 7.x a starší WooCommerce. Pak totiž nekupujete jen plugin, ale celou modernizaci e-shopu — což bývá dobrý nápad, jen je férové vědět, do čeho jdete.

Shrnutí

Toret PPL 4.0 řeší reálné úzké hrdlo: podávání už neblokuje práci a štítky se tisknou hromadně, aniž byste kvůli tomu museli dávkovat podání. Na e-shopu s desítkami balíků denně je to ta správná změna na tom správném místě.

Nejde ale o aktualizaci, kterou odkliknete mezi řečí. CPL přístupy, klíč k widgetu 2.0, serverový CRON a zapnutí nového e-mailu — čtyři věci, a všechny čtyři se vyplatí mít hotové dřív, než plugin aktualizujete. Vyhradit si na to hodinu v klidný den je mnohem levnější než to řešit v pátek odpoledne, kdy čeká svoz.