Zásilkovňa widget — ako ho integrovať na Shoptet, WooCommerce a vlastný eshop

Zásilkovňa/Packeta je najobľúbenejšia sieť výdajných miest v SR — zákazníci ju poznajú a aktívne ju vyžadujú v checkoutu. Aby výber výdajného miesta fungoval správne, zákazník musí mať možnosť vybrať konkrétny Z-Point alebo Z-Box zo zobrazenej mapy — na to slúži Packeta Widget.

1. Čo je Packeta Widget a prečo ho musíš mať

Widget je JavaScript komponenta, ktorá sa otvorí ako modálne okno v checkoutu. Zákazník klikne na “Zásilkovňa”, mapa sa zobrazí, vyberie najbližší Z-Point alebo Z-Box a potvrdí. Widget vráti ID vybranej pobočky — ktoré potom odovzdáš Packeta API pri vytváraní zásielky.

Bez widgetu zákazník vyberie “Zásilkovňa” ako metódu, ale nevyberie konkrétnu pobočku. Výsledok: zásielka leží na zlej pobočke alebo sa vráti odosielateľovi.

2. Shoptet — integrácia za 5 minút

1. V administrácii Shoptetu choď do Doplnkové moduly → App Store.
2. Vyhľadaj “Packeta” a klikni Nainštalovať (zadarmo).
3. V nastavení pluginu vlož svoj API kľúč z client.packeta.com.
4. Plugin automaticky pridá Zásilkovňu ako metódu dopravy a zapojí widget do checkoutu.

3. WooCommerce — plugin WooCommerce Zásilkovna

1. V administrácii WordPressu choď do Pluginy → Pridať nový a vyhľadaj WooCommerce Zásilkovna.
2. Nainštaluj a aktivuj plugin.
3. V nastavení vlož API kľúč a nastav krajinu na SK.
4. Widget sa automaticky zobrazí v checkoutu po výbere metódy Zásilkovňa.

4. Vlastný eshop — Widget API 6

<script src="https://widget.packeta.com/v6/www/js/library.js"></script>

Packeta.Widget.pick(
  'TVOJ_API_KĽÚČ',
  {
    country: 'sk',           // 'sk' pre slovenské pobočky
    language: 'sk',
    vendors: [{ picked: 'packeta' }],
  },
  function callback(point) {
    if (point) {
      selectedPointId   = point.id;
      selectedPointName = point.name;
    }
  }
);

5. Najčastejšie chyby

6. Testovanie widgetu

Použi testovací API kľúč 0000000000000000 (16× nula) — widget sa otvorí v demo móde bez reálnych dát. Pre overenie celého flow použi produkčný kľúč a vytvor testovaciu zásielku, ktorú môžeš zmazať v client.packeta.com.