PPL

API napojení a tisk štítků

Modul umožňuje automatizované zakládání balíků "jedním kliknutím" přes API PPL a přímý tisk přepravních štítků přímo z administrace e-shopu. Výrazně tak usnadňuje a zrychluje proces expedice objednávek.

1. Nastavení a aktivace modulu

Před prvním použitím je nutné modul správně nastavit a propojit s vaším účtem u PPL.

• Kde modul najdete: V administraci e-shopu přejděte do sekce Nastavení  →  PPL (případně na URL `.../admin/settings/pplPackage`).
• Potřebné údaje: Pro úspěšné napojení je nutné vyplnit Client Id a Client Secret.
• Důležité: Tyto přístupové údaje (hodnoty) vám poskytne přímo společnost PPL.

Provozní režimy: K dispozici máte jak testovací, tak produkční režim. Doporučujeme nejprve funkčnost ověřit v testovacím režimu (obdobně jako u platebních bran) a následně přepnout do ostrého produkčního provozu.
Nezapomeňte modul po vyplnění údajů Zapnout.

2. Generování a tisk štítků

Štítky lze tisknout buď jednotlivě pro konkrétní objednávku, nebo hromadně.

A. Tisk štítku pro jednu objednávku

1. Otevřete si detail konkrétní objednávky.
2. Vpravo nahoře klikněte na tlačítko Akce.
3. Zde najdete možnost pro vygenerování a vytištění PPL štítku.

B. Hromadný tisk štítků (pro více objednávek)

1. V přehledu objednávek označte (zaškrtněte) ty objednávky, které mají zvolenou dopravu PPL a chcete je expedovat.
2. Vlevo nahoře klikněte z "Všechny" na "Označené".
3. Využijte nástroj pro hromadné úlohy (nabídka Akce vedle možnéstí Všechny/Označené).
4. Zvolte hromadné vygenerování štítků pro vybrané položky.

3. Rozdělení balíku (vícekusové a nadměrné zásilky)

Pokud máte nadměrný balík nebo zásilku, kterou potřebujete rozdělit do více krabic (a potřebujete tedy více přepravních štítků), postupujte následovně:

1. Objednávku je nejprve nutné rozdělit přímo v administraci. Otevřete detail konkrétní objednávky a přejděte do sekce Úkony. Zde klikněte na tlačítko Rozdělit objednávku.
2. Systém vám nabídne seznam produktů v objednávce. Vyberte ty produkty, které chcete oddělit do nového balíku (nové objednávky).
3. Jakmile je objednávka rozdělená na dvě (či více), můžete pro každou z nich standardně vygenerovat samostatný PPL štítek v sekci Úkony.

Poznámka k nastavení oprávnění pro rozdělování objednávek: Aby mohli administrátoři e-shopu objednávky rozdělovat, musí mít k tomu přidělená práva:

• Přejděte do Nastavení → Administrátoři (`.../admin/settings/admin-users`).
• Buď vytvořte novou skupinu administrátorů s právy na míru, nebo u stávající skupiny povolte oprávnění "Order Split".

PPL Widget

Od 31. srpna 2026 je nutné přejít na novou verzi. Více o změně na stránkách PPL: www.ppl.cz/w/novy-mapovy-widget-ppl

Návod: Jak nastavit nový PPL widget

Kde získat a upravit API klíč: klient.ppl.cz/widgetadmin 

Postup vytvoření klíče v portálu PPL:

1. Přidejte Vaši doménu bez www (#1).
2. U pole Typ produktu vyberte možnost "Vlastní nastavení".
3. Vyberte všechny dostupné možnosti v sekci "Typy výdejních míst" (#2). Poznámka: Zobrazení výdejních míst si na webu následně upravíte podle potřeby přímo v administraci (v sekci /admin/settings/delivery-setup). V PPL proto zaškrtněte vše.
4. Nastavení polí Země, Výchozí země a Jazyk si zvolte přímo dle Vašich preferencí.
5. V sekci Typ zobrazení vyberte možnost "Vložený do stránky (Inline)" (#3).
6. Klikněte na tlačítko "Aktivovat". (Upozornění: Může trvat několik minut, než se změny v systému PPL plně projeví.)

Nasazení:

1. Přejděte do administrace do sekce /admin/settings/pplExport.
2. Vložte nově vytvořený API klíč, zaškrtněte políčko "Store Selection Widget Enabled" a klikněte na Uložit.
3. Zobrazení výdejních míst si následně upravíte podle potřeby přímo v administraci v sekci /admin/settings/delivery-setup.

Vizuální návod (snímky obrazovky s označenými kroky #1, #2 a #3), který Vám s nastavením pomůže: