Jak nastavit PPL doručení ve [WooCommerce](/articles/jak-propojit Pokud-zasilkovnu-s-woocommerce)

Pokud provozujete e-shop na WooCommerce a chcete nabídnout doručení přes PPL, narazíte na to, že WooCommerce nemá pro české přepravce nativní podporu — na rozdíl od Shoptetu, kde je PPL modul v základu. Musíte sáhnout po některém z komunitních pluginů, případně si integraci postavit přes API. V tomto návodu projdeme všechny tři varianty: rychlé řešení přes plugin, středně pokročilou cestu přes Make a custom řešení pro vývojáře, kteří chtějí maximální kontrolu.

Co budete potřebovat

• WordPress 6.0+ s aktivním WooCommerce (verze 5.0 minimum, doporučujeme 8.0+ kvůli HPOS — High Performance Order Storage).
• PHP 8.0+ na serveru. Starší PHP 7.4 oficiálně nepodporují ani WooCommerce ani většina přepravních pluginů.
• Smluvní vztah s PPL — uzavírá obchodní oddělení PPL, typicky 5–10 pracovních dnů od první žádosti. Bez aktivní smlouvy nelze získat MyAPI přístup.
• Přihlašovací údaje do MyAPI portálu PPL — zákaznické číslo, API klíč, heslo. Najdete je po prvním přihlášení do MyAPI v sekci Nastavení → API přístup.
• Plugin pro integraci PPL — viz Krok 1, doporučujeme Toret Shipping for WooCommerce (placený) nebo WP Zásilky (community).
• Backup před instalací — UpdraftPlus / BackWPup. Plugin přepravy mění checkout flow, takže rollback na sebe nesmí čekat.

Pokud teprve začínáte a porovnáváte přepravce, projděte si paralelně návod na nastavení Zásilkovny ve WooCommerce — drtivá většina českých e-shopů jede multi-carrier (PPL + Zásilkovna jako základ, případně Balíkovna nebo DoDo navrch).

Postup krok za krokem

Krok 1: Instalace přepravního pluginu

WooCommerce nemá nativní podporu PPL, takže vybíráte z komunitních a placených pluginů. Tři nejpoužívanější:

• Toret Shipping for WooCommerce (placený, ~3 500 Kč/rok) — pokrývá PPL, PPL Zásilkovnu Českou, Českou poštu, GLS, DPD. Nejlepší support a aktivní vývoj.
• WP Zásilky (community / placená Pro verze) — slušná free verze, Pro doplňuje pokročilé štítky a hromadné akce.
• PPL CZ Shipping for WooCommerce (oficiální komunitní plugin) — pokrývá jen PPL, free, ale aktualizace občas pokulhávají.

V administraci WordPressu přejděte do Pluginy → → Přidat nový nový** a vyhledejte zvolený plugin. Nainstalujte a aktivujte. U placených verzí dostanete licenční klíč e-mailem — vložte ho v nastavení pluginu, jinak nedostanete updates.

Plugin po aktivaci přidá do menu WP novou položku (typicky PPL nebo Toret Shipping). Pokud používáte multisite, plugin aktivujte na úrovni jednotlivého e-shopu, ne network-wide.

Krok 2: Zadání API přístupů

V nastavení pluginu vyplňte:

• Zákaznické číslo PPL (číselný kód 8–10 znaků, ne IČO).
• API klíč z MyAPI (32znakový hexadecimální řetězec).
• API heslo (krátký alfanumerický řetězec).
• Odesílací adresa — bude tištěná na štítky a v notifikacích zákazníkovi.
• Kontaktní telefon a e-mail — pro případné změny doručení.

Klikněte na Otestovat spojení — plugin pošle ověřovací request a vrátí odpověď. Pokud uvidíte zelenou hlášku „Spojení úspěšné", je hotovo. Pokud červenou:

1. Zkontrolujte, že server má povolený outbound HTTPS na myapi.ppl.cz a mapa.ppl.cz. Některé sdílené hostingy (CZK levné) outbound requesty defaultně blokují.
2. Ověřte, že nepoužíváte sandbox API klíč v produkčním pluginu.
3. Zkontrolujte, že smlouva s PPL je aktivní (PPL aktivuje API až po prvním obratu).

Po úspěšném ověření plugin stáhne aktuální ceník PPL a seznam ParcelShopů (~4 500 záznamů). Synchronizace trvá 30–60 sekund.

Krok 3: Konfigurace přepravních metod

Přejděte do WooCommerce → Nastavení → Doprava → Přepravní zóny a buď upravte stávající zónu pro ČR, nebo vytvořte novou:

1. Zóna: Česká republika (případně přidejte Slovensko jako samostatnou zónu).
2. Přidat přepravní metodu → vyberte PPL (název podle pluginu).
3. V detailu metody nastavte:
   • Druh dopravy: PPL Standard (na adresu), PPL Privát (s víkendem), PPL ParcelShop (výdejní místo).
   • Cena pro zákazníka: pevná částka nebo podle hmotnosti (např. 0–2 kg = 99 Kč, 2–5 kg = 129 Kč, 5–10 kg = 169 Kč).
   • Doprava zdarma od: typicky 1 999 Kč pro ParcelShop, 2 499 Kč pro doručení na adresu.
   • Hmotnostní limity: PPL Standard max 50 kg, ParcelShop max 15 kg.
   • Daňová třída: pro ČR 21 %.

Pro PPL ParcelShop přidejte samostatnou přepravní metodu s widgetem pro výběr výdejního místa. Plugin obvykle widget vykresluje pomocí WooCommerce hooku woocommerce_after_shipping_rate. Pokud vám widget v pokladně chybí, řešení je v Kroku 4 ze sekce Časté problémy.

Pro produkty s nestandardními rozměry (paletové zboží, velké balíky) nastavte třídy dopravy v WooCommerce → Nastavení → Doprava → Třídy dopravy a přiřaďte je jednotlivým produktům. Plugin pak může pro tyto třídy zakázat PPL nebo přepnout na alternativního přepravce.

Krok 4: Automatické generování štítků

V nastavení pluginu zapněte automatické generování štítků při přechodu objednávky do stavu „Odesláno" nebo „Připraveno k odeslání":

1. Plugin zavolá MyAPI a vytvoří zásilku.
2. PPL vrátí trackingové číslo a URL na PDF štítek.
3. Plugin uloží tracking do meta dat objednávky (_ppl_tracking_number).
4. V detailu objednávky uvidíte tlačítko Stáhnout štítek — formát A6 pro termo tiskárny, A4 4× pro běžné laserové.
5. Pošle se automatický e-mail zákazníkovi s tracking odkazem.

Pro hromadné odesílání používejte Hromadné akce v seznamu objednávek: označte zásilky → Akce → Odeslat do PPL. Vygeneruje se jediné PDF se všemi štítky, které vytisknete najednou.

Pro objem 50+ zásilek denně doporučujeme propojení s MyAPI batch endpoint — plugin pošle všechny zásilky najednou v jednom requestu, což šetří čas i náklady na API limity.

Krok 5: Testování celého procesu

Před spuštěním na produkci proveďte end-to-end test:

1. Vytvořte testovací objednávku s reálnou adresou (nejlépe vaši kancelář).
2. Vyberte přepravu PPL ParcelShop a zkontrolujte, že widget načte mapu.
3. Vyberte výdejní místo a dokončete objednávku.
4. V administraci přepněte objednávku do stavu Odesláno.
5. Ověřte, že se vygeneroval štítek (PDF) a tracking číslo.
6. Zkontrolujte, že e-mail zákazníkovi obsahuje tracking link.
7. Otevřete PDF štítek a ověřte, že na něm jsou všechny povinné údaje (adresa, tracking, čárový kód, PPL logo).

Pokud cokoli z kroků 1–7 selže, vraťte se k odpovídajícímu kroku v tomto návodu — typicky jde o nesprávné API údaje nebo blokaci JavaScriptu šablonou.

Časté problémy a jejich řešení

Plugin nevidí PPL API

V 70 % případů jde o blokaci outbound requestů na hostingu. Vstupte do nastavení hostingu (cPanel, Plesk) a ověřte, že odchozí HTTPS na myapi.ppl.cz (port 443) je povolený. Pokud jste na sdíleném hostingu typu Wedos nebo Active24, kontaktujte podporu — některé balíčky outbound requesty defaultně blokují kvůli ochraně proti spamu.

Druhá častá příčina: WordPress firewall plugin (Wordfence, Sucuri) blokuje outbound. Vypněte dočasně firewall, otestujte spojení, a pokud funguje, přidejte do whitelistu domény PPL.

Špatné ceny dopravy

Plugin počítá cenu podle celkové hmotnosti košíku (suma _weight meta polí všech produktů). Pokud máte produkty bez vyplněné hmotnosti, cena bude buď 0 (a plugin nabídne metodu zdarma) nebo se přepne na výchozí sazbu. Řešení:

1. V Produkty → Editor produktů → Doprava vyplňte u všech produktů hmotnost v kg.
2. Pro produkty s nestandardní hmotností (paletové zboží) nastavte třídu dopravy a v pluginu definujte zvláštní sazbu pro tuto třídu.
3. Pokud máte stovky produktů, použijte hromadnou aktualizaci přes WP-CLI: wp post meta update <id> _weight <kg>.

Duplicitní přepravní metody v pokladně

Pokud máte víc pluginů pro dopravu (typicky Toret + Zásilkovna oficiální + custom), můžou se metody duplikovat. Ponechte jeden plugin pro PPL a deaktivujte ostatní. Pokud potřebujete víc přepravců, vyberte jeden multi-carrier plugin (Toret) místo kombinace pěti single-purpose pluginů.

Widget ParcelShop se nezobrazuje

Stejně jako u Zásilkovny, nejčastější příčina je vlastní šablona pokladny nebo Block Checkout (od WC 8.3+) místo Classic. Pluginy PPL zatím Block Checkout neumí — přepněte na Classic v WooCommerce → Nastavení → Pokročilé → Page Setup.

Druhá příčina: cache plugin (WP Rocket, LiteSpeed, W3TC) cachuje stránku pokladny. Přidejte stránku Pokladna do whitelistu „Don't cache" a vyloučte cookies woocommerce_cart_hash a woocommerce_items_in_cart.

Tracking číslo se generuje, ale URL nejde otevřít

PPL aktivuje tracking až po fyzickém naskenování zásilky v depu. Než kurýr balík odveze, link tracking.ppl.cz/?id=XXX ukazuje 404 nebo „Zásilka nenalezena". Po naskenování (typicky večer téhož dne) tracking začne fungovat. Pokud i po 24 hodinách nejede, kontaktujte podporu PPL — balík se mohl ztratit ve sklizni.

Tipy pro pokročilé

1. Custom integrace přes MyAPI: pokud nechcete být závislí na pluginu, MyAPI PPL je RESTové a má dobrou dokumentaci. Endpoint myapi.ppl.cz/v1/Shipment/Batch přijme JSON pole zásilek a vrátí trackingy. Pluginový kód můžete použít jako referenci pro vlastní implementaci.

2. Webhook pro real-time tracking: v MyAPI aktivujte webhook na změnu stavu zásilky a nasměrujte ho na Make nebo vlastní endpoint. Když balík dorazí na ParcelShop, automaticky pošle SMS zákazníkovi přes Twilio nebo aktualizuje stav v HubSpot CRM.

3. Vlastní e-mail šablony: WooCommerce template emails/customer-completed-order.php přepište v child-theme/woocommerce/emails/. Vykreslete $order->get_meta('_ppl_tracking_number') jako klikací odkaz — zákazník nepotřebuje hledat e-mail od PPL.

4. Hromadné štítky podle stavu: nastavte WP-CLI cron, který každý den v 14:30 vygeneruje štítky pro všechny objednávky ve stavu „Připraveno k odeslání". Když přijde kurýr v 15:00, máte vše vytištěné.

5. A/B test sazeb dopravy: WooCommerce sám neumí A/B testy přepravních sazeb, ale plugin AB Press Optimizer ano. Vyzkoušejte 99 Kč proti 119 Kč pro PPL ParcelShop a sledujte konverze. Většina e-shopů zjistí, že 20 Kč rozdíl konverzi nesnižuje, ale marži zlepší o 8–12 %.

6. Multi-carrier setup s Make: postavte scénář, který podle PSČ a hmotnosti automaticky vybere nejlevnějšího přepravce. Pro malé balíky do Prahy DoDo, pro střední Zásilkovna, pro velké PPL. Plně automatizované, transparentní, šetří 5–15 % nákladů na dopravu.

Často kladené otázky

Existuje free plugin pro PPL ve WooCommerce?

Ano, PPL CZ Shipping for WooCommerce je oficiální komunitní plugin zdarma. Nabízí základní funkce (generování štítků, ParcelShop widget), ale aktualizace občas pokulhávají. Pro produkční e-shop doporučujeme placený Toret Shipping (~3 500 Kč/rok), který je multi-carrier a má aktivní support.

Jak řešit reklamaci ztracené zásilky?

Reklamaci podávejte přímo v MyAPI portálu PPL, ne přes WooCommerce nebo plugin. Připravte trackingové číslo, fakturu zboží a fotku obalu (pokud máte). Pojištění do 5 000 Kč je standardní, vyšší limity za 0,5 % z hodnoty zboží. PPL reklamace typicky vyřídí do 14 pracovních dnů.

Lze pomocí PPL doručovat do zahraničí?

Ano, přes mezinárodní síť DPDgroup obsluhuje PPL SK, PL, DE, AT, HU. Sazby a limity jsou jiné — ve WooCommerce přidejte zahraniční země jako samostatné přepravní zóny a pro každou definujte vlastní cenovou strukturu PPL.

Co když plugin přestane fungovat po update WooCommerce?

Komunitní pluginy občas nestíhají s major updaty WooCommerce. Před update WooCommerce vždy: 1) zazálohujte web, 2) ověřte, že váš plugin podporuje cílovou verzi WC, 3) updatujte na staging (klon produkce), 4) až pak na produkci. Pokud používáte placený Toret, support reaguje typicky do 24 hodin a vydají hotfix.

Jak rychle plugin zatíží stránku pokladny?

Toret Shipping přidává cca 60 KB JavaScriptu, oficiální PPL plugin cca 80 KB. Na běžně rychlém hostingu to znamená +100 ms LCP. Pokud měříte Core Web Vitals striktně, zvažte lazy-load widgetu až po výběru přepravní metody PPL — vyžaduje custom úpravu pluginu, ale výrazně zlepší skóre.

Kdy se vyplatí vlastní integrace přes MyAPI místo pluginu?

Vlastní integrace dává smysl při: 1) objemu 200+ zásilek denně, 2) vlastním ERP/skladu, který si chcete řídit, 3) speciálních pravidlech (např. dropshipping s odesílatelem partnera). Pod 100 zásilek denně se cena vývoje vlastní integrace (50–150 tis. Kč) nikdy nevrátí oproti placenému pluginu.

Závěr

Nastavení PPL doručení ve WooCommerce vyžaduje instalaci třetího pluginu (na rozdíl od Shoptetu, kde je modul nativní), ale výsledkem je plně automatizovaný proces s tiskem štítků, sledováním zásilek a notifikacemi zákazníkovi. Pro multi-carrier setup zvažte placený Toret Shipping, který pokrývá i Zásilkovnu, Českou poštu a GLS. Pro pokročilé scénáře propojte přes Make nebo n8n — automatizace post-sale workflow (recenze, sleva na další nákup, restock notifikace) zvyšuje LTV zákazníka výrazně víc než snížení sazeb dopravy.