Proč potřebujete Sema Zásilkovna pro VirtueMart
Zásilkovna (Packeta) je nejpopulárnější přepravní služba v České republice a na Slovensku. Tisíce výdejních míst, Z-Boxy a doručení na adresu — to vše zákazníci očekávají v každém e-shopu. Sema Zásilkovna přináší kompletní integraci přímo do VirtueMart: od výběru výdejního místa v košíku až po export zásilky a tisk štítku v administraci.
Funkce
- 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
- Export zásilek — vytvoření zásilky v Packetě jedním kliknutím z detailu objednávky
- Tisk štítků — PDF štítek (A6/A7) ke stažení přímo z administrace
- Automatická dobírka (COD) — detekce dobírkové platby a nastavení částky
- Doprava zdarma — konfigurovatelný limit pro bezplatnou dopravu
- Filtr dopravců — zobrazení jen vybraných typů bodů (Z-Boxy, pickup, konkrétní dopravci)
- Session persistence — vybraný bod přežije změnu platby i aktualizaci košíku
- API log — auditní záznam všech API volání (požadavek + odpověď, heslo maskováno)
- Více metod — jeden plugin = více metod dopravy (pickup + HD, CZ + SK, …)
- Vícejazyčný — čeština a angličtina v balení
Jak to funguje
- Nainstalujte — nahrajte ZIP přes Joomla instalátor a povolte plugin.
- Nastavte API — zadejte API klíč (Widget) a API heslo z klientské sekce Packety.
- Vytvořte metodu dopravy — ve VirtueMart založte shipment method a zvolte typ doručení (výdejní místa nebo doručení na adresu).
- Zákazník objednává — v košíku vybere Zásilkovnu a přes widget zvolí výdejní místo (nebo při HD jen potvrdí adresu).
- Exportujte zásilku — v detailu objednávky jedním kliknutím vytvoříte zásilku v Packetě.
- Vytiskněte štítek — stáhněte PDF štítek a přiložte k balíku.
Konfigurace
| 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 |
Technická specifikace
| Vlastnost | Hodnota |
|---|---|
| Typ rozšíření | VirtueMart shipment plugin |
| Element | semazasilkovna |
| Joomla | 4.x, 5.x, 6.x |
| VirtueMart | 4.x |
| PHP | 8.0+ |
| Packeta API | REST XML (createPacket, labels) |
| Widget | Packeta Widget v6 |
| Jazyk | Čeština, Angličtina |
| Licence | GPL v2+ |
| Automatické aktualizace | Ano (přes SemaHub) |
Často kladené 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ě metodu pro výdejní místa i doručení na adresu?
Ano. Stačí vytvořit dvě metody dopravy ve VirtueMart — 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í platební metodu 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?
V aktuální verzi se zásilky exportují jednotlivě z detailu objednávky. Hromadný export je plánován pro budoucí verzi.