Zásilkovna ve VirtueMartu
Výdejní místa, Z-Boxy i doručení na adresu — přímo v košíku
Jeden plugin. Widget v košíku, export zásilky i štítek z administrace.
Zásilkovna (Packeta) je nejpoužívanější přepravní služba v Česku a na Slovensku. Tisíce výdejních míst, Z-Boxy i doručení na adresu dnes zákazník v e-shopu jednoduše očekává. SemaShipping Packeta přináší kompletní integraci přímo do VirtueMartu: od výběru výdejního místa v košíku až po export zásilky a tisk štítku v administraci.
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 klientské sekce Packety, 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
- Z-Boxy a další externí body vedle poboček Zásilkovny
- Možnost nechat si zásilku poslat rovnou na adresu
- Dobírku, když nechce platit předem
- Vybraný bod, který nezmizí při změně platby
Proč nechcete ruční odbavení?
- Přepisování adres z objednávek do klientské sekce Packety
- Překlepy v údajích, které se projeví až u dopravce
- Ruční hlídání dobírkových částek
- Štítky tištěné z jiného systému než z e-shopu
Co SemaShipping Packeta řeší
Nainstalujete jeden ZIP, zadáte API klíč a heslo z klientské sekce Packety a ve VirtueMartu založíte metodu dopravy. Hotovo. Žádné úpravy šablony, žádné programování.
Výdejní místa a doručení
- Packeta Widget v6 — interaktivní mapa pro výběr výdejního místa přímo v košíku
- Výdejní místa + Z-Boxy — podpora interních bodů Zásilkovny i externích (Z-Box, Alzabox aj.)
- Doručení na adresu (HD) — samostatná metoda dopravy bez widgetu, adresa z objednávky
- Filtr dopravců — zobrazení jen vybraných typů bodů (Z-Boxy, pobočky, konkrétní dopravci)
- Session persistence — vybraný bod přežije změnu platby i aktualizaci košíku
- One Page Checkout — funguje i v One Page Checkoutu od RuposTelu (
com_onepage2.0.x), bez dalšího nastavování
Odbavení objednávek
- Export zásilek — vytvoření zásilky v Packetě jedním kliknutím z detailu objednávky
- Hromadný export — celá fronta objednávek do Packety jedním tlačítkem, i z několika stavů najednou
- Storno zásilky — zrušení zásilky v Packetě z detailu objednávky a vytvoření nové
- Automatická změna stavu — objednávka se po exportu sama přepne do zvoleného stavu
- Tisk štítků — PDF štítek (A6/A7) ke stažení přímo z administrace, jednotlivě i hromadně; hromadný tisk bere jen zásilky, které ještě čekají na předání, nebo zaškrtnuté objednávky
- Dotisk na načatý arch — u formátu na arch A4 vyberete před hromadným tiskem pole, od kterého se má tisknout
- Automatická dobírka (COD) — detekce dobírkové platby a nastavení částky
- Číslo zásilky v přehledu — odznak s číslem zásilky rovnou pod číslem objednávky, u stornované přeškrtnutý
- Stavy zásilek — aktuální stav z Packety se při otevření přehledu objednávek doplní sám a vypíše se česky pod číslem; okamžitě ho načte tlačítko Zkontrolovat stavy
- Sledování pro zákazníka — v e-mailu o odeslání i v sekci Moje objednávky vidí zákazník číslo zásilky s odkazem na sledování u Packety
- API log — auditní záznam všech volání API (požadavek + odpověď, heslo maskováno)
Nastavení a provoz
- Doprava zdarma — konfigurovatelný limit pro bezplatnou dopravu
- Více metod dopravy — jeden plugin = více metod (výdejní místa + HD, CZ + SK…)
- Vícejazyčný — čeština, slovenština, angličtina, němčina a polština v balení
- Automatické aktualizace — přes SemaHub, přímo z administrace Joomla
Jak to funguje
Pro zákazníka
Zvolí Zásilkovnu
V košíku vybere mezi dopravami Zásilkovnu — buď na výdejní místo, nebo rovnou na adresu.
Vybere výdejní místo
Otevře se mapa Packeta Widgetu v6. Zákazník najde pobočku nebo Z-Box, potvrdí ho — a vybraný bod hned vidí u dopravy.
Dokončí objednávku
Zvolený bod se uloží k objednávce a přežije i změnu platby nebo úpravu košíku. Přepisovat ho znovu nemusí.
Pro provozovatele e-shopu
- Jedno nastavení — API klíč a heslo z klientské sekce Packety zadáte jednou v parametrech metody dopravy.
- Export jedním kliknutím — Zásilku vytvoříte v Packetě přímo z detailu objednávky ve VirtueMartu.
- Štítek k tisku — PDF ve formátu A6 nebo A7 stáhnete hned vedle, bez přihlašování do Packety. Načatý arch A4 se dá dotisknout od zvolené pozice, takže nepřijdete o zbylá pole.
- Odbavení dávkou — V přehledu objednávek odešlete jedním tlačítkem všechny objednávky, které čekají na expedici, a štítky k nim stáhnete v jediném PDF.
- Stav se přepne sám — Po úspěšném exportu plugin objednávku převede do stavu, který si zvolíte. Ruční přepínání odpadá.
- Oprava omylu — Špatně vytvořenou zásilku stornujete přímo z objednávky a založíte novou. Číslo původní zásilky zůstane dohledatelné.
- Přehled bez proklikávání — Číslo zásilky i její stav vidíte rovnou v seznamu objednávek. Stavy se z Packety doplňují samy při otevření přehledu, takže detail objednávky otevíráte jen tehdy, když je to opravdu potřeba.
- Auditní stopa — Každé volání API se zaloguje i s odpovědí, heslo je v logu maskované.
Co vše lze nastavit
| Parametr | Popis |
|---|---|
| API klíč (Widget) | Veřejný klíč pro Packeta Widget v6 (16 znaků) |
| API heslo | Tajné heslo pro REST API (export, štítky) |
| Identifikátor e-shopu | Název odesílatele v Packetě |
| Typ doručení | Výdejní místa + Z-Boxy / Doručení na adresu |
| Země pro widget | ISO kód země (cz, sk) |
| Filtr dopravců | Čárkou oddělená ID dopravců pro widget |
| HD Carrier ID | ID externího dopravce pro doručení na adresu |
| Cena dopravy | Základní cena + poplatek za balení |
| Doprava zdarma od | Limit pro bezplatnou dopravu |
| Dobírka (COD) | ID platebních metod, které jsou dobírkou |
| Formát štítku | A6 on A4, A7 on A4, A6 on A6, A7 on A7; u archu A4 se pozice vybírá před každým hromadným tiskem |
| Výchozí váha | Náhradní váha zásilky, není-li u produktu |
| Stav objednávek pro export | Stavy, ze kterých se bere hromadný export (lze víc, oddělené čárkou) |
| Stav objednávky po exportu | Stav, do kterého se objednávka přepne po vytvoření zásilky |
Technické údaje
| Vlastnost | Hodnota |
|---|---|
| Typ rozšíření | VirtueMart shipment plugin |
| Element | semazasilkovna |
| Joomla | 4.x, 5.x |
| VirtueMart | 4.x |
| PHP | 8.0+ |
| Packeta API | REST XML (createPacket, labels, packetStatus) |
| Widget | Packeta Widget v6 |
| Checkout | VirtueMart i One Page Checkout od RuposTelu (com_onepage 2.0.x) |
| Jazyk | Čeština, slovenština, angličtina, němčina, polština |
| Licence | GPL v2+ |
| Automatické aktualizace | Ano (přes SemaHub) |
Časté dotazy
Potřebuji účet u Zásilkovny?
Ano. Plugin se připojuje k Packeta API — potřebujete aktivní účet s API klíčem a API heslem.
Funguje plugin s externími body (Z-Boxy, Alzabox)?
Ano. Widget v6 podporuje jak interní body Zásilkovny, tak externí body (Z-Boxy, Alzaboxy a další). Typ bodu se automaticky rozpozná a správně exportuje.
Mohu mít současně výdejní místa i doručení na adresu?
Ano. Stačí vytvořit dvě metody dopravy ve VirtueMartu — jednu s typem „Výdejní místa + Z-Boxy“ a druhou s typem „Doručení na adresu“.
Podporuje plugin dobírku?
Ano. V nastavení zadáte ID platebních metod, které jsou dobírkou. Při exportu zásilky se dobírková částka nastaví automaticky.
Funguje plugin se slovenskými výdejními místy?
Ano. V nastavení metody dopravy nastavte „Země pro widget“ na sk.
Co se stane, když zákazník změní platbu po výběru bodu?
Vybraný bod zůstane zachován. Data se ukládají do PHP session a přežijí změnu platby, aktualizaci košíku i přechod mezi kroky objednávky.
Mohu filtrovat, které body se zobrazí?
Ano. Parametr „Filtr dopravců“ umožňuje zobrazit jen vybrané typy bodů (například jen Z-Boxy nebo jen určité dopravce). ID dopravců najdete v Packeta carrier feedu.
Jaký formát má API komunikace?
Packeta API používá REST XML (ne JSON). Plugin komunikaci řeší automaticky — nemusíte se starat o formát.
Mažou se záznamy o exportech při odinstalaci?
Ne. Tabulka #__sema_zasilkovna_log (auditní záznamy) se při odinstalaci záměrně neodstraňuje. Slouží jako audit trail.
Podporuje plugin hromadný export?
Ano. V přehledu objednávek VirtueMart přibude tlačítko, které jedním kliknutím odešle do Packety všechny dosud neexportované objednávky ve zvolených stavech (stavů může být víc, oddělených čárkou), a druhé, které stáhne štítky k nim v jediném PDF. Hromadné štítky pokrývají interní výdejní místa Zásilkovny; u Z-Boxů a doručení na adresu se štítek stahuje jednotlivě z detailu objednávky.
Můžu dotisknout arch, ze kterého jsem už štítky odlepil?
Ano. Na arch A4 se vejdou čtyři štítky A6 a plugin se před každým hromadným tiskem zeptá, od kterého pole má začít. Načatý arch tak dotisknete místo toho, abyste zakládali nový.
Funguje plugin s One Page Checkoutem?
Ano. Od verze 1.4.0 plugin podporuje One Page Checkout od RuposTelu (com_onepage) a nastavovat nemusíte nic navíc. Widget i vybraný bod fungují i při AJAX přepočtu košíku a výdejní místo se nikdy nepřenese mezi zákazníky. Ověřeno kompletní objednávkou včetně exportu a storna na Joomla 4.4 s VirtueMartem 4.4 i 4.6 a OPC 2.0.460.
Dá se zásilka stornovat, když ji vytvořím omylem?
Ano. V detailu objednávky je tlačítko „Stornovat zásilku“. Zásilka se zruší v Packetě, číslo zůstane u objednávky dohledatelné a jedním kliknutím vytvoříte novou. Stornovat lze do chvíle, než zásilku fyzicky převezme dopravce.
Musím po exportu přepínat stav objednávky ručně?
Nemusíte. V nastavení zvolíte stav, do kterého se objednávka po vytvoření zásilky sama přepne (například „Expedováno“). Ponecháte-li pole prázdné, plugin stav nemění. Zda o změně odejde e-mail zákazníkovi, řídí nastavení VirtueMartu.
Ze kterých stavů objednávek se dá exportovat?
Z těch, které si zvolíte — a klidně z několika najednou (například E,Q). Kódy stavů si každý e-shop upravuje, takže se podíváte do VirtueMart › Objednávky › Stavy objednávek a vyberete ten, ve kterém u vás objednávky čekají na expedici.
Poznám ze seznamu objednávek, kde zásilka je?
Ano. Pod číslem objednávky svítí odznak s číslem zásilky a pod ním její stav česky — stornovaná zásilka je přeškrtnutá. Stavy se doplňují samy: při otevření přehledu se plugin na pozadí doptá Packety na zásilky, které dlouho nikdo nekontroloval (interval si nastavíte, výchozí je hodina). Okamžitě je načte tlačítko Zkontrolovat stavy. Stav, který nemáme přeložený, se vypíše tak, jak přišel z Packety — nikdy nezůstane prázdno.
Jak to vypadá v praxi
Packeta® a Zásilkovna® jsou registrované ochranné známky jejich příslušných vlastníků. Tento produkt je nezávislé rozšíření a není s provozovatelem služby Packeta / Zásilkovna spojen ani jím schválen.