PPL ve VirtueMartu
Výdejní místa, ParcelBoxy i doručení na adresu — přímo v košíku
Jeden plugin. Mapa v košíku, export zásilky, etiketa i storno z administrace.
PPL patří k nejrozšířenějším dopravcům v Česku — tisíce výdejních míst, ParcelBoxy i doručení na adresu. SemaShipping PPL přináší celou dopravu přímo do VirtueMartu: od výběru výdejního místa na mapě v košíku až po export zásilky, tisk etikety a případné storno v administraci. Bez další komponenty a bez zásahů do šablony.
Proč to potřebujete
Doprava je poslední krok, kde se objednávka ještě dá ztratit. Když si zákazník nemůže vybrat konkrétní výdejní místo, odchází — a když se pak zásilky přepisují ručně do portálu dopravce, platí se to časem a chybami.
Co zákazník čeká v košíku
- Výběr konkrétního výdejního místa na mapě, ne jen jméno dopravce
- ParcelBoxy vedle klasických výdejních míst
- Možnost nechat si zásilku poslat rovnou na adresu
- Dobírku, když nechce platit předem
- Vybrané místo, které nezmizí při změně platby
Proč nechcete ruční odbavení?
- Přepisování adres z objednávek do portálu dopravce
- Překlepy v údajích, které se projeví až u řidiče
- Ruční hlídání dobírkových částek a variabilních symbolů
- Etikety tištěné z jiného systému než z e-shopu
- Zásilky, které nakonec nepojedou a u PPL zůstanou viset
Co SemaShipping PPL řeší
Nainstalujete jeden ZIP, vyplníte Client ID a Client Secret k CPL API a ve VirtueMartu založíte metodu dopravy. Hotovo. Žádná další komponenta, žádné programování, žádné měsíční poplatky.
Výdejní místa a doručení
- PPL mapový widget 2.0 — interaktivní mapa pro výběr výdejního místa přímo v košíku
- Výdejní místa i ParcelBoxy — ve widgetu lze zobrazit obojí, nebo jen jeden typ
- Doručení na adresu — samostatná metoda dopravy bez mapy, adresa z objednávky
- Jen místa s dobírkou — u dobírkových objednávek lze nabídnout jen ta, která dobírku přijímají
- Výběr přežije košík — zvolené místo se neztratí při změně platby ani při přepočtu košíku
Odbavení objednávek
- Export zásilek — vytvoření zásilky v PPL jedním kliknutím z detailu objednávky
- Hromadný export — označíte objednávky v přehledu a odešlete je jednou dávkou
- Tisk etiket — PDF, ZPL, PNG, JPEG i SVG; sloučená etiketa A4 se čtyřmi pozicemi na archu
- Dotisk na načatý arch — před hromadným tiskem vyberete na obrázku archu pole, od kterého se má tisknout
- Automatická dobírka — plugin sám přepne kód produktu na dobírkový a doplní částku, měnu i variabilní symbol
- Storno zásilky — jednotlivě i hromadně; PPL storno u nepodaných zásilek vyžaduje
- Přehled nepodaných zásilek — co je u PPL založené a čeká na předání řidiči, včetně čísel zásilek přímo v přehledu objednávek
- Kontrola stavů — plugin se doptá PPL na skutečný stav nepodaných zásilek a uloží ho česky
- Objednání svozu — datum, počet balíků, čas i poznámka pro řidiče; objednané svozy lze zrušit
- Zásilky u PPL — výpis všeho, co PPL vede na vašem zákaznickém účtu za zvolené období, včetně cen za dopravu a váhy zvážené v depu; označí i zásilky, které v e-shopu nevznikly
- Tisk přehledu — seznam se vytiskne na šířku i se součtem za období, bez administrace kolem
- Číslo objednávky na etiketě — posílá se jako externí číslo, PPL ho tiskne a propisuje do fakturace
Nastavení a provoz
- Odesílatel z VirtueMartu — adresa se bere od prodejce, kdykoli přepsatelná v konfiguraci
- Cena dopravy — základní cena, poplatek za balení, daňová sazba, doprava zdarma od částky
- Omezení metody — země, blokované země, minimální a maximální váha
- Více metod dopravy — jeden plugin obslouží výdejní místa i doručení na adresu vedle sebe
- Log API volání — auditní záznam požadavků a odpovědí, tajné údaje maskované
- Vícejazyčný — čeština, slovenština a angličtina v balení
- Automatické aktualizace — přes SemaHub, přímo z administrace Joomly
Jak to funguje
Pro zákazníka
Zvolí PPL
V košíku vybere mezi dopravami PPL — buď na výdejní místo, nebo rovnou na adresu.
Vybere výdejní místo
Otevře se mapa PPL widgetu 2.0. Zákazník najde výdejní místo nebo ParcelBox, potvrdí ho — a hned ho vidí u dopravy.
Dokončí objednávku
Zvolené místo se uloží k objednávce a přežije i změnu platby nebo úpravu košíku. Vybírat znovu nemusí.
Pro provozovatele e-shopu
- Jedno nastavení — Client ID a Client Secret k CPL API zadáte jednou v konfiguraci pluginu, klíč mapy k tomu.
- Export jedním kliknutím — Zásilku vytvoříte v PPL přímo z detailu objednávky, nebo hromadně z přehledu objednávek.
- Etiketa k tisku — PDF na arch A4 i jednotlivě, pro termotiskárnu ZPL — bez přihlašování do portálu PPL. Načatý arch se dá dotisknout od zvolené pozice.
- Úklid po zrušených objednávkách — Zásilku, která nepojede, stornujete jedním kliknutím, dokud jste balík nepředali řidiči.
- Přehled i svoz na jednom místě — Vidíte, co čeká na předání řidiči, a svoz objednáte rovnou z administrace e-shopu — zásilky z API se v portálu PPL nezobrazují.
- Náklady na dopravu na očích — U každé zásilky vidíte, co si za ni PPL účtuje, a pod seznamem součet za období — dá se porovnat s tím, co jste vybrali od zákazníků. Seznam jde vytisknout.
- Auditní stopa — Každé volání API se zaloguje i s odpovědí, přístupové údaje jsou v logu maskované.
Co vše lze nastavit
| Parametr | Popis |
|---|---|
| Prostředí API | Produkční nebo testovací CPL API |
| Client ID a Client Secret | Přístupy k CPL API (OAuth2), zůstávají na serveru |
| API klíč mapy | Klíč widgetu 2.0, vázaný na doménu e-shopu |
| Adresa odesílatele | Z prodejce ve VirtueMartu, přepsatelná po jednotlivých polích |
| ID plateb = dobírka | ID platebních metod, které jsou dobírkou |
| Typ doručení | Výdejní místo (s mapou) nebo doručení na adresu |
| Kód produktu PPL | Kód ze smlouvy zákazníka, zvlášť pro běžnou a dobírkovou zásilku |
| Typ bodů v mapě | Vše / jen výdejní místa / jen ParcelBoxy, volitelně jen místa s dobírkou |
| Formát etikety | PDF, ZPL, PNG, JPEG, SVG; arch A4 nebo jedna etiketa, pozice 1–4 (u hromadného tisku se vybírá před každým tiskem) |
| Cena dopravy | Základní cena + poplatek za balení, doprava zdarma od částky |
| Omezení metody | Země, blokované země, minimální a maximální váha |
| Stav pro hromadný export | Ze kterého stavu objednávek se plní fronta exportu |
Technické údaje
| Vlastnost | Hodnota |
|---|---|
| Typ rozšíření | VirtueMart shipment plugin |
| Element | semappl |
| Joomla | 4.x, 5.x |
| VirtueMart | 4.x |
| PHP | 8.0+ |
| PPL API | CPL API (myAPI2), REST JSON, OAuth2 |
| Widget | PPL mapový widget 2.0 |
| Jazyk | Čeština, slovenština, angličtina |
| Licence | GPL v2+ |
| Automatické aktualizace | Ano (přes SemaHub) |
Časté dotazy
Potřebuji smlouvu s PPL?
Ano. Plugin se připojuje k CPL API pod vaším zákaznickým číslem — potřebujete Client ID a Client Secret, které vydává PPL.
Je klíč mapy totéž co Client ID?
Ne. Mapový widget má vlastní klíč z klientské sekce PPL a je vázaný na doménu e-shopu. CPL API žádný API klíč nemá, ověřuje se přes OAuth2.
Jak plugin pozná dobírku?
V konfiguraci uvedete ID platebních metod, které jsou dobírkou. Plugin pak sám přepne kód produktu na dobírkovou variantu (například SMAR na SMAD) a doplní částku, měnu i variabilní symbol.
Mohu mít současně výdejní místa i doručení na adresu?
Ano. Stačí vytvořit dvě metody dopravy — jednu s typem „výdejní místo“ a mapou, druhou s typem „na adresu“ a odpovídajícím kódem produktu.
Proč se po exportu hned neobjeví číslo zásilky?
CPL API zpracovává zásilky v dávkách asynchronně. Plugin na výsledek čeká sám; když PPL potřebuje víc času, zůstane objednávka ve stavu „zpracovává se“ a číslo doplníte tlačítkem Obnovit stav.
Co když PPL zásilku odmítne?
Chybu z API uvidíte přímo v administraci. Odmítnutá zásilka v PPL nevznikne, objednávka se vrátí mezi neexportované a po opravě dat export zopakujete. V hromadné dávce plugin vadné zásilky vyřadí a zbytek odešle.
Musím stornovat zásilku, která nepojede?
Ano, PPL to vyžaduje — jinak ji vede jako čekající na podání. Stornovat jde jedním kliknutím z objednávky nebo hromadně nad výběrem, dokud jste balík fyzicky nepředali řidiči.
Tiskne se na etiketu číslo objednávky?
Ano. Posílá se jako externí číslo s kódem CUST; PPL ho tiskne na etiketu a propisuje do fakturace.
Můžu tisknout na termotiskárnu?
Ano. Kromě PDF umí plugin ZPL, PNG, JPEG i SVG. U PDF si vyberete mezi archem A4 se čtyřmi etiketami a jednou etiketou na stránku. U archu A4 se plugin před hromadným tiskem zeptá, od kterého pole tisknout, takže se dá dotisknout arch, ze kterého jste už část odlepili.
Zvládne plugin víc objednávek najednou?
Ano. V přehledu objednávek zaškrtnete, co má jít do PPL, a plugin to odešle jako jednu dávku — včetně hromadného stažení etiket a hromadného storna.
Kde uvidím založené zásilky a jak objednám svoz?
V administraci e-shopu. Zásilky založené přes rozhraní PPL se v portálu klient.ppl.cz nezobrazují — PPL to potvrdilo v srpnu 2026. Plugin proto ukazuje čísla zásilek i jejich stav přímo u objednávek, umí vypsat vše, co čeká na předání řidiči, doptat se PPL na aktuální stavy a objednat svoz včetně počtu balíků a poznámky pro řidiče.
Uvidím, kolik mě doprava stála?
Ano. Přehled Zásilky u PPL u každé zásilky ukáže naceněnou dopravu od PPL — přepravu, mýto, palivový příplatek i poplatek za dobírku — a pod seznamem součet za zvolené období. Vidíte i váhu, kterou zásilce naměřilo depo. Ceny doplňuje PPL s odstupem, u čerstvé zásilky bývá pole ještě prázdné.
Mažou se záznamy o exportech při odinstalaci?
Ne. Tabulka #__sema_ppl_log zůstává i s daty — je to auditní stopa toho, co se do PPL odeslalo.
Kolidují spolu SemaShipping PPL a SemaShipping Packeta na jednom webu?
Ne. Obě rozšíření běží vedle sebe, mají oddělené ovládací prvky v administraci a ovládají se stejně.
PPL® je registrovaná ochranná známka PPL CZ s.r.o., společnosti skupiny DHL Group. Tento produkt je nezávislé rozšíření a není s PPL CZ s.r.o. ani DHL Group spojen ani jimi schválen.
Jak to vypadá v praxi
