Jak přidat PPL widget do Shoptetu

PPL je jedním ze tří největších přepravců v České republice a v segmentu B2C zásilek konkuruje [Zásilkovně](/articles/jak-[konkuruje propojit sítí](/articles/jak-propojit-gls-se-shoptetem)-zasilkovnu-se-shoptetem) sítí přibližně 4 500 ParcelShopů a vlastními parcelboxy. Výhodou PPL je rozsáhlejší kurýrní pokrytí firemních adres a B2B sazeb. Tento návod vás krok za krokem provede aktivací PPL ve Shoptetu, zapnutím widgetu výdejních míst, nastavením exportu a tisku štítků a zorientuje vás v častých chybách, které stojí za 90 % support ticketů.

Co budete potřebovat

• E-shop na platformě Shoptet — stačí libovolný placený tarif (Start, Profi, Mega, Premium); PPL modul je v základu.
• Smlouvu s PPL — uzavírá se přes obchodní oddělení a typicky trvá 5–10 pracovních dnů. Nutná je IČO, předpokládaný měsíční objem zásilek a typ zboží (regulované zboží jako alkohol nebo lithium baterie potřebují zvláštní souhlas).
• Přístup do MyAPI portálu PPL — login a heslo dostanete e-mailem po podpisu smlouvy; v MyAPI najdete API klíč pro Shoptet.
• Administrátorský přístup do Shoptetu s právy na úpravu dopravců (běžné účty Marketing nebo Pokladní práva nemají).
• Vyplněné rozměry a hmotnosti u všech aktivních produktů. PPL má přísné limity (max. 50 kg / 200 cm součet stran) a chybějící údaje vedou k odmítnutí zásilky.

Pro multi-carrier setup, kde PPL doplňuje Zásilkovnu nebo DoDo, si nejdříve definujte business pravidla — kdy se zákazníkovi zobrazí který přepravce. Zbytečně velký výběr v pokladně snižuje konverzi.

Postup krok za krokem

Krok 1: Aktivace PPL v administraci Shoptetu

Přihlaste se do Shoptetu a přejděte do Doprava a platby → Dopravci. PPL najdete v seznamu dostupných modulů — klikněte na Aktivovat. Otevře se dialog s poli pro:

• Číslo zákaznického účtu PPL (ne IČO; jde o 8-10ciferný číselný kód).
• API klíč z MyAPI portálu (sekce Nastavení → API přístup).
• Heslo k API (volitelné, jen pokud máte aktivovanou dvoufázovou autentizaci).
• Výchozí ParcelShop pro testování — přiřaďte si některý velký pražský ParcelShop, abyste mohli widget otestovat bez nutnosti reálné objednávky.

Shoptet po vyplnění zavolá testovací endpoint a ověří přístup. Pokud uvidíte chybu „Neplatné přihlašovací údaje", v 95 % případů jde o:

1. Nesoulad mezi sandbox a produkčními credentials (sandbox API klíč nefunguje proti produkčnímu Shoptetu).
2. Ne plně aktivovanou smlouvu — PPL aktivuje API přístup až po prvním obratu na účtu.
3. Překlep v API klíči (jsou case-sensitive a mají 32 znaků).

Krok 2: Konfigurace ParcelShop widgetu

Po úspěšné aktivaci se v nastavení dopravce objeví podsekce PPL ParcelShop. Zapněte ji a nastavte:

• Cena pro zákazníka — typicky o 10–20 Kč nižší než doručení na adresu (zákazník platí pohodlí poboček).
• Doprava zdarma od X Kč — typicky 1 500–2 000 Kč.
• Hmotnostní limity — PPL ParcelShop má limit 15 kg / 35×35×60 cm; nad limit přepněte automaticky na doručení na adresu.
• DPH třída — pro ČR je dopravná služba 21 %.

Widget se automaticky zobrazí v pokladně po výběru přepravní metody. Zákazník klikne na Vybrat výdejní místo, otevře se interaktivní mapa s ~4 500 ParcelShopy, klikne na bod a uvidí adresu, otevírací dobu, fotku pobočky a vzdálenost od zadané doručovací adresy.

Test čtyřmi zařízeními: desktop Chrome, desktop Safari, mobil Chrome, mobil Safari. Mapa občas v Safari potřebuje povolit GPS pro automatické zacílení — pokud zákazník GPS zamítne, widget musí ukázat výchozí lokaci (Praha, centrum).

Krok 3: Nastavení doručení na adresu

Kromě ParcelShopu nastavte i klasické doručení na adresu přes PPL Standard nebo PPL Privát. Hlavní rozdíly:

• PPL Privát — doručení do 21:00, sobota i neděle, vyšší sazba, skenuje zásilku vícekrát během dne (lepší tracking).
• PPL Standard — doručení v pracovní dny do 18:00, nižší sazba, jeden pokus + uložení do nejbližšího ParcelShopu.

Definujte:

• Cenové hladiny podle hmotnosti: 0–2 kg, 2–5 kg, 5–10 kg, 10–15 kg, 15+ kg.
• Limity rozměrů: Standard má limit 200 cm součet stran, Privát 175 cm.
• Doprava zdarma od X Kč — typicky o 500 Kč vyšší než u ParcelShopu (kurýrní doručení vás stojí víc).

PPL nabízí i expresní doručení do 3 hodin v Praze (PPL Express); to nastavte jako samostatnou metodu jen pro PSČ z Prahy a okolí.

Krok 4: Export zásilek a tisk štítků

Shoptet podporuje tři způsoby předání objednávek do PPL systému:

1. Manuální export přes XML/CSV — v sekci Objednávky → Export → PPL vygenerujete soubor a nahrajete do MyAPI portálu, který vám vrátí PDF se štítky.
2. Automatické API odesílání — Shoptet pošle objednávku do PPL přímo, zpět dostane trackingové číslo. Vhodné pro objem 30+ zásilek denně.
3. Hromadné předání přes Make — zachytí všechny objednávky v daném stavu a přes Webhook PPL vygeneruje štítky + e-mail s trackingem zákazníkovi v jednom scénáři.

Štítky stahujte v PDF formátu A6 (pro termo tiskárnu Zebra/Brother) nebo A4 4× (pro běžnou laserovou tiskárnu). PPL Standard štítky mají bílé pozadí, PPL Privát modré — pomáhá to při řazení balíků na konci dne.

Krok 5: Sledování zásilek a notifikace

Po naskenování zásilky v depu PPL přijde do Shoptetu webhook s aktualizací stavu. Trackingové číslo se propíše do detailu objednávky a do e-mailu zákazníka. PPL umí posílat notifikace přímo zákazníkovi (SMS i e-mail) při třech klíčových stavech: „Předáno přepravci", „Připraveno k vyzvednutí" / „V autě k doručení", „Doručeno".

Doporučujeme vlastní e-mail šablony ve Shoptetu — generická notifikace od PPL působí studeně, vlastní s vaším logem a tonem zvyšuje opakované nákupy o 10–15 %. Šablony najdete v Marketing → E-maily → Stav objednávky.

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

Widget ParcelShop se nenačítá

Nejčastější příčina je Custom šablona pokladny, která nepoužívá standardní hooks Shoptetu. Otevřete vývojářské nástroje (F12) → záložka Console a hledejte chyby z domény mapa.ppl.cz. CSP (Content Security Policy) blok řeší nastavení v Shoptetu Šablona → Vlastní HTML hlavička, kde přidáte výjimku pro mapa.ppl.cz a myapi.ppl.cz.

Chybné rozměry balíku

PPL Standard má limit součtu stran 200 cm, ParcelShop 130 cm. Pokud máte produkt s rozměry na hraně limitu (např. 70×40×35 = 145 cm), zkontrolujte, zda do hodnoty počítáte i obal. Doporučujeme přidat „obalový offset" 5–10 cm k deklarovaným rozměrům produktů, abyste se vyhnuli odmítnutí v depu.

Export zásilek selže s chybou „Chybí povinný údaj"

PPL vyžaduje e-mail i telefon příjemce — Shoptet to defaultně vynucuje, ale pokud máte API objednávky z marketplace nebo importu, může pole chybět. V administraci objednávky doplňte ručně, nebo aktivujte ve Shoptetu validaci na vstupu objednávky.

Štítek se vygeneruje, ale tracking nejde

PPL aktivuje tracking až po fyzickém naskenování v prvním depu. Pokud balík ještě nepřevzal kurýr, tracking ukazuje „Štítek vytvořen". Při dlouhém prodlení (3+ pracovní dny) zavolejte na zákaznickou linku PPL — občas se balík ze sklizně nedostane do depa.

Přepravce neaktualizuje stav „Doručeno"

Občas kurýr zaznamená doručení až večer při uzavírání směny — stav se může propsat s 12-24h zpožděním. Pokud zákazník reklamuje, ověřte přes MyAPI portál PPL „Foto doručení" (povinná podpisová evidence).

Tipy pro pokročilé

1. Conditional logic v pokladně: skryjte ParcelShop pro objednávky obsahující křehké zboží (sklo, elektronika nad 5 000 Kč). Ve Shoptetu nastavíte přes Vlastní pravidla → Skrýt dopravce podle kategorie produktu.

2. PPL ParcelBox pilotní program: v Praze a Brně PPL pilotuje ParcelBoxy (samoobslužné schránky 24/7). Pokud váš e-shop cílí na mileniály, zapojte se přes obchodního zástupce — sazby jsou výhodnější.

3. Webhook do CRM: nasměrujte tracking webhook PPL na Make, který aktualizuje status v HubSpotu nebo jiném CRM. Sales/podpora vidí status zásilky bez přepínání mezi nástroji.

4. A/B test prahu dopravy zdarma: PPL je dražší než než Zásilkovna takže, takže práh dopravy zdarma musí být vyšší. Vyzkoušejte 1 999 Kč proti 2 499 Kč — vyšší práh často zvedne AOV (average order value) o 12–18 % bez snížení konverze.

5. Hromadné štítky před vyzvednutím: pokud kurýr PPL k vám jezdí jednou denně (typicky odpoledne), nastavte ve Shoptetu automatický export v 14:30. Když přijde řidič v 15:00, máte připraveno všechno.

6. Integrace s Fakturoid a sklady: po vygenerování štítku spustí scénář Make: vystaví fakturu, sníží sklad, založí pohyb v účetnictví, pošle e-mail zákazníkovi. Plně automatizovaný workflow.

Často kladené otázky

Kolik stojí aktivace PPL ve Shoptetu?

Modul samotný je zdarma — součást každého placeného tarifu Shoptetu. PPL účtuje pouze za reálně odeslané zásilky podle ceníku ve smlouvě (ten je individuální podle objemu — od 70 Kč za ParcelShop, od 110 Kč za doručení na adresu).

Můžu kombinovat PPL se Zásilkovnou v jednom e-shopu?

Ano, dokonce to doporučujeme. Pravidlo „one shipper to rule them all" v ČR neplatí — Zásilkovna pokrývá city sites lépe, PPL B2B doručení a venkov silněji. Ve Shoptetu si nastavte oba dopravce paralelně a nechte zákazníka vybrat.

Co s objednávkami nad 30 kg, které PPL nepřijme?

PPL Standard má limit 50 kg, ale nad 30 kg už doporučujeme paletovou dopravu (Toptrans, DACHSER, Geis). Ve Shoptetu si přidejte nového dopravce a nastavte ho na hmotnost 30+ kg.

Jak zajistit, aby ParcelShop widget byl rychlý na mobilu?

Mapa PPL používá Mapbox GL JS, který je ~250 KB JavaScriptu. Pro mobilní rychlost doporučujeme lazy load widget — načte se až ve chvíli, kdy zákazník vybere přepravní metodu PPL ParcelShop. Ve Shoptetu to nastavíte v Šablona → Pokročilé → Lazy load externích widgetů.

Jak řešit reklamaci, když PPL ztratí balík?

Reklamaci podávejte přes MyAPI portál PPL, ne přes Shoptet. Připravte: trackingové číslo, fotku obalu (pokud máte), fakturu zboží. Pojištění do 5 000 Kč je standardně, vyšší limity za 0,5 % z hodnoty zboží.

Lze používat PPL pro mezinárodní zásilky?

Ano, PPL přes mezinárodní síť síť DPD group obsluhujegroup obsluhuje SK, PL, DE, AT, HU. Sazby a limity jsou jiné — nastavte ve Shoptetu jako samostatné přepravní metody pro každou zemi.

Závěr

Přidání PPL do Shoptetu rozšíří vaši nabídku dopravy o síť ParcelShop a kurýrní doručení s vyšším B2B podílem. Zákazníci ocení interaktivní mapu výdejních míst přímo v košíku, vy ušetříte čas na exportu zásilek díky API integraci. Nezapomeňte propojit i s Make pro post-sale automatizace a vyvarovat se častých chyb (chybějící rozměry, custom šablony pokladny). Pro maximální flexibilitu doporučujeme PPL kombinovat s Zásilkovnou — multi-carrier setup je v ČR standard, ne luxus.