VirtueMart a doprava

Oficiální modul Zásilkovny (Packety) propojí e-shop ve VirtueMartu s výdejními místy, Z-BOXy i externími dopravci. Zákazník si místo vybere přímo v košíku a provozovatel může objednávky podat přes API, exportovat do CSV a tisknout štítky.

Aktuální větev modulu je určená pro VirtueMart 4 a Joomla! 4 nebo 5. Níže najdete praktický postup instalace, nastavení cen dopravy i kontrolní seznam před spuštěním.

Oficiální modul ke stažení

Instalační balíček vždy stahujte z oficiálních GitHub Releases projektu Zásilkovny.

Stáhnout aktuální modul Zásilkovny

Co modul umí

Výběr výdejního místa

Packeta Widget v6 nabídne pobočky, Z-BOXy a podporované výdejní body externích dopravců.

Ceny podle země a hmotnosti

Nastavíte pravidla pro jednotlivé státy, hmotnostní pásma i hranici dopravy zdarma.

Podání zásilek

Objednávky lze odeslat přes API nebo exportovat do CSV a následně zpracovat v klientské sekci Packety.

Štítky a správa objednávek

Modul podporuje tisk štítků, hromadnou úpravu hmotnosti a zobrazení kódu zásilky u objednávky.

Co si připravit před instalací

  • aktivní účet u Zásilkovny / Packety,
  • API klíč a identifikátor e-shopu nebo odesílatele,
  • Joomla! 4 nebo 5 a aktuální VirtueMart 4,
  • správně vyplněné hmotnosti produktů,
  • zálohu webu a databáze před instalací.

Instalace modulu do Joomla!

1

Stáhněte poslední vydání

Na stránce Releases stáhněte instalační ZIP. Balíček nerozbalujte, pokud dokumentace konkrétního vydání neuvádí jinak.

2

Nainstalujte rozšíření

V administraci otevřete Systém → Instalace → Rozšíření, nahrajte ZIP a po instalaci zkontrolujte, že jsou související pluginy povolené.

3

Doplňte přístupové údaje

V nastavení komponenty nebo pluginu vyplňte API klíč a údaje o odesílateli. Přístupový klíč nezveřejňujte a neposílejte v běžném e-mailu.

Nastavení dopravy ve VirtueMartu

V administraci VirtueMartu otevřete Obchod → Způsoby dopravy, vytvořte nový způsob a jako plugin zvolte Zasilkovna VM3. Přiřaďte země, měnu, daňové pravidlo a publikujte dopravu pro požadované skupiny zákazníků.

V konfiguraci nastavte cenu pro jednotlivé země a hmotnostní rozsahy. Pokud nabízíte dopravu zdarma, určete minimální hodnotu objednávky. Produkty bez hmotnosti mohou výpočet dopravy zkreslit, proto je před spuštěním zkontrolujte.

Výdejní místa, Z-BOXy a externí dopravci

V košíku zákazník otevře mapový widget a vybere pobočku. Vybrané místo se uloží k objednávce. Ověřte funkčnost v responzivním zobrazení a také po změně země doručení. Modul podporuje také výdejní místa externích dopravců dostupná v síti Packety.

Platby, One Page Checkout a podání zásilek

Vazby mezi dopravou a platbou nastavujte v nativním nastavení platebních metod VirtueMartu. Oficiálně je uváděna podpora One Page Checkout řešení RuposTel; u jiných checkoutů je nutné kompatibilitu otestovat, protože mohou přepisovat standardní košík.

Hotové objednávky lze podat přes API nebo vyexportovat do CSV. Před tiskem štítků zkontrolujte adresu, telefon, e-mail, hmotnost a zvolenou pobočku. Automatické podání po změně stavu objednávky zapínejte až po úspěšném testu.

Kontrolní seznam před spuštěním

  • zobrazuje se doprava ve všech povolených zemích,
  • widget funguje na mobilu i počítači,
  • výdejní místo se uloží do objednávky,
  • cena odpovídá zemi, hmotnosti a hodnotě košíku,
  • fungují povolené kombinace dopravy a plateb,
  • testovací zásilka projde do Packety a lze vytisknout štítek.

Pravidelně sledujte nové verze modulu i VirtueMartu. Aktualizaci nejprve ověřte na kopii webu, zejména pokud používáte nestandardní košík nebo vlastní šablonu.

Časté dotazy

Ano. Aktuální dokumentace projektu uvádí modul pro VirtueMart 4 a Joomla! 4 nebo 5. Před instalací vždy ověřte požadavky konkrétního vydání.

Ano, novější vydání podporují VirtueMart 4. Používejte aktuální verzi a před nasazením ji otestujte s konkrétní šablonou a checkoutem.

API klíč a identifikaci odesílatele najdete v klientské sekci Packety po aktivaci účtu a e-shopu.

Nejčastější příčinou je nepovolená země, chybné hmotnostní pásmo, nepublikovaný způsob dopravy, špatný API klíč nebo konflikt s nestandardním checkoutem.

Oficiálně je uváděna podpora RuposTel One Page Checkout. U jiných řešení kompatibilitu ověřte na testovacím webu.

Objednávky lze odeslat přes API nebo exportovat do CSV. Po vytvoření zásilky modul umožní vytisknout přepravní štítek.