Zásilkovna

Modul Packeta je nativně integrované API, které vám umožní odesílat do Zásilkovny objednávky a zpět si automaticky generovat štítky na balíky a to hromadně, na pár kliků.

Zásilkovna (Packeta)

 Modul Zásilkovna slouží k propojení vašeho e-shopu s přepravní službou Paketa (Zásilkovna). Díky API propojení můžete jednoduše exportovat objednávky, generovat štítky a sledovat stav zásilek – vše přímo z administrace systému IRIUS bez nutnosti ručního přepisování údajů.

Jak modul Packeta najdeme:

1. Pomocí interního vyhledávače v administraci

 – Stačí zadat klíčové slovo „zásilkovna“ nebo „paketa“.

2.  Přes levé menu
 → Nastavení e-shopu
 → Globální nastavení → Nastavení doprav
 → Zásilkovna (nebo Paketa, název se může lišit podle verze systému)

Globální nastavení API

Získání API údajů

  1. Přihlaste se do administrace Zásilkovny (Paketa).
  2. Vpravo nahoře klikněte na název účtu → sekce s názvem účtu.
  3. Zkopírujte si API Key a poté i API Password.

Nastavení API v Iriusu

  1. V systému IRIUS otevřete modul Zásilkovna (vyhledáním nebo přes: Nastavení e-shopu → Globální nastavení → Dopravy → Paketa).

  2. Vložte údaje do polí:
     • API key
     • API password

Uložte nastavení.

Nastavení odesílatele

  1. V administraci Zásilkovny přejděte do sekce Informace o uživateliOdesílatelé.
  2. Vytvořte nového odesílatele nebo upravte stávajícího.
  3. Vyplňte:
     • Název – zobrazuje se na štítku
     • Označení – slouží k párování
  4. V IRIUSu vložte pole „Označení odesílatele“ do odpovídajícího místa v modulu Zásilkovna.

Nastavení parametrů dopravy

  1. V modulu Zásilkovna můžete upravit:
     • maximální hmotnost (v kg),
     • délku, šířku a výšku balíku (v cm).
  2. Tyto hodnoty musí odpovídat omezením Zásilkovny a jsou již přednastavené. Můžete je samozřejmě změnit podle Vašich požadavků.
  3. Změny nezapomínejte průběžně ukládat.

Nyní jsme si vytvořili API propojení a přesuneme se do modulu doprav.

Publikace dopravy Zásilkovnou v e-shopu

  1. Otevřete modul Dopravy (Nastavení e-shopu → Doprava). 
  2. Najděte dopravu „Zásilkovna“ a klikněte na checkox „Publikovat“ hned vlevo v základních informacích.
  3. Zkontrolujte
    • Pevně definovanou dopravu: Zásilkovna
    • přiřazení platebních metod (nutné pro zobrazení dopravy),
    • nastavení ceny.
  4. Uložte.

Povolení dopravy ve státech

  1. Otevřete modul Státy (Nastavení e-shopu → Nastavení státu → Státy). 
  2. Vyberte stát (např. Česká republika). 

  3. V poli Doprava přidejte „Zásilkovna“ (pomocí našeptávače, pokud tam již není)
  4. Uložte.

Test funkčnosti na e-shopu

  1. Vložte produkt do košíku.
  2. V sekci Doprava a Platba se zobrazí doprava „Zásilkovna“.
  3. Kliknutím na „Vybrat pobočku“ se otevře widget Zásilkovny.
  4. Vyberte výdejní místo – to se uloží k objednávce automaticky.

Doručování do zahraničí (address delivery)

  1. V modulu Zásilkovna přejděte do sekce Doručení do zahraničí.
  2. Přidávejte jednotlivé státy pomocí kódu (např. PL – Polsko) a ID přepravce (např. Polská pošta).
  3. Seznam přepravců najdete:
    • v Zásilkovně v sekci Ceník,
    • nebo kliknutím na odkaz „Seznam povolených států zde“ – otevře se XML soubor s ID a názvy.
    • Nebo pomocí našeptávače

  4. Dopravu si pro vybraný stát pojmenujte dle specifikace
  5. Každou dopravu pro vybraný stát je třeba zveřejnit v modulu Dopravy

Tip

Vyberte si pro Adress Delivery místního dopravce a v modulu doprava si vytvořte tohoto dopravce, stačí jej spárovat se Zásilkovna adress delivery a můžete mu také nastavit název a logo na jaké jsou lidé ve své lokalitě zvyklí.

Orientace v XML feedu se seznamem států

Po kliknutí na Seznam povolených států se otevře XML soubor, ve kterém se zobrazí seznam všech povolených států.

 

Vytvoření dopravy pro zahraničí

V rámci nastavení zásilkovny je nutné si vytvořit v modulu Dopravy novou dopravu 

a poté správně vybrat ze seznamu Zásilkovna - address delivery

Aktivace automatické úlohy (cron)

Tato úloha zajišťuje zpětné získání informací o stavu zásilek, aktualizaci stavu objednávky (např. „Doručeno“) a kontrolu ztracených nebo zdržovaných zásilek.

  1. Otevřete modul Zásilkovny a přejděte do spodní části Plánované úlohy.
  2. Nastavte časování úlohy. Doporučujeme ponechat defaultní nastavení. Nejnižší doporučená hodnota je každých 15 minut, doporučená je 1x za hodinu. Nenastavujte úlohu na každých 5 minut, mohlo by to způsobit zbytečné zpomalení systému a nechceme přetěžovat servery Zásilkovny.
  3. Klikněte na „Aktivovat úlohu“.

Export objednávek a tisk štítků

  1. Otevřete modul Objednávky.
  2. Vyberte objednávky s dopravou Zásilkovna.
  3. V horní části klikněte na „Hromadné akce“ → „Export objednávek přepravci“.
  4. Objednávky se odešlou přes API do Zásilkovny a automaticky se vygenerují štítky.
  5. Pro tisk: zvolte „Tisk štítků“ a spusťte akci tlačítkem "Vykonat".

 

Upozornění

Kolem Vánočního období dochází k přetěžování serverů Zásilkovny/Packety a to způsobuje výpadky API. Irius v případě výpadku API automaticky tento typ dopravy zablokuje. V e-shopu bude stále viditelná, ale zákazník ji nebude moci vybrat. Vždy tedy mějte k dispozici aktivní i jiný způsob přepravy, např. PPL.