Zásilkovna/Packeta je nejoblíbenější síť výdejních míst v ČR a SK — zákazníci ji znají a aktivně ji vyžadují v checkoutu. Aby ale výběr výdejního místa fungoval správně, nestačí jen přidat Packetu jako metodu dopravy. Zákazník musí mít možnost vybrat konkrétní Z-Point nebo Z-Box ze zobrazené mapy — k tomu slouží Packeta Widget.

1. Co je Packeta Widget a proč ho musíš mít

Widget je JavaScript komponenta, která se otevře jako modální okno nebo inline mapa v checkoutu. Zákazník klikne na “Zásilkovna”, mapa se zobrazí, on si vybere nejbližší Z-Point nebo Z-Box a potvrdí. Widget vrátí ID vybrané pobočky — které pak předáš Packeta API při vytváření zásilky.

Bez widgetu zákazník vybere “Zásilkovna” jako metodu, ale nevybere konkrétní pobočku. Zásilka pak buď nejde vytvořit, nebo ji Packeta přiřadí k prvnímu Z-Pointu v databázi (což není to, co zákazník chce). Výsledek: zásilka leží na špatné pobočce, zákazník ji nevyzvedne, vrácení.

2. Shoptet — integrace za 5 minut

Shoptet má s Packetou nativní integraci přes App Store. Žádný kód nepotřebuješ.

V administraci Shoptetu jdi do Doplňkové moduly → App Store.
Vyhledej “Packeta” nebo “Zásilkovna” a klikni Nainstalovat (plugin je zdarma).
V nastavení pluginu vlož svůj API klíč z client.packeta.com (Nastavení → API klíč).
Plugin automaticky přidá Zásilkovnu jako metodu dopravy a zapojí widget do checkoutu.
V Packeta administraci nastav webhook URL pro stavové notifikace (URL dostaneš v nastavení pluginu).

Po instalaci se v checkoutu zobrazí tlačítko “Vybrat pobočku” — zákazník klikne, mapa se otevře, vybere Z-Point nebo Z-Box a objednávka se uloží s ID pobočky.

3. WooCommerce — plugin WooCommerce Zásilkovna

V administraci WordPressu jdi do Pluginy → Přidat nový a vyhledej WooCommerce Zásilkovna (autor: Zásilkovna s.r.o.).
Instaluj a aktivuj plugin.
V nastavení pluginu (WooCommerce → Nastavení → Zásilkovna) vlož API klíč.
Plugin přidá Zásilkovnu jako metodu dopravy ve WooCommerce → Doručení → Metody doručení. Nastav cenu dopravy a minimální hodnotu košíku pro dopravu zdarma.
Widget se automaticky zobrazí v checkoutu po výběru metody Zásilkovna.

Plugin podporuje HPOS (High-Performance Order Storage) i klasické WC objednávky. Exportuje zásilky hromadně do Packeta CSV nebo přes API.

4. Vlastní eshop — Widget API 6 (JavaScript)

Pokud máš vlastní eshop (React, Vue, PHP, custom), integruješ widget přímo přes JavaScript API.

Krok 1 — Načti CDN skript

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

Skript načti v <head> nebo těsně před </body> na stránce checkoutu.

Krok 2 — Otevři widget po výběru dopravy

// Zavolej po kliknutí na "Zásilkovna" jako metodu dopravy
Packeta.Widget.pick(
  'TVŮJ_API_KLÍČ',           // 16místný hex klíč z client.packeta.com
  {
    country: 'cz',           // 'cz' nebo 'sk' — filtruje pobočky
    language: 'cs',          // 'cs', 'sk', 'en'
    vendors: [{ picked: 'packeta' }], // pouze Packeta Z-Pointy a Z-Boxy
  },
  function callback(point) {
    if (point) {
      // Zákazník vybral pobočku — ulož data
      selectedPointId   = point.id;       // např. "12345"
      selectedPointName = point.name;     // např. "Lékárna Benu, Praha 2"
      selectedPointCity = point.city;
      selectedPointZip  = point.zip;
    }
    // point === null → zákazník zavřel widget bez výběru
  }
);

Krok 3 — Zobraz vybranou pobočku v checkoutu

Po výběru zobraz zákazníkovi název a adresu vybrané pobočky — aby věděl, kde zásilka bude čekat.

Krok 4 — Předej ID pobočky při vytváření zásilky

Při volání Packeta API (REST nebo SOAP) pro vytvoření zásilky předej addressId = ID vybrané pobočky. Bez tohoto pole Packeta zásilku odmítne s chybou “Chybí cílové výdejní místo”.

5. PrestaShop

Packeta poskytuje oficiální PrestaShop modul ke stažení na packeta.cz/ke-stazeni. Instalace stejná jako u WooCommerce — nahrát přes správce modulů, zadat API klíč, widget se integruje automaticky.

6. Nejčastější chyby při integraci

Chyba	Příčina	Řešení
Widget se neotevře	Chybný nebo neexistující API klíč	Ověř klíč v client.packeta.com → Nastavení
Zásilka jde na špatnou pobočku	ID pobočky se nepředává při vytváření zásilky	Zkontroluj, zda `addressId` v API volání = `point.id` z callbacku
Zákazník vidí pobočky z jiné země	Chybí parametr `country: ‘cz’` v options	Přidej `country` filtr podle adresy zákazníka
Widget zobrazuje i Balíkovny ČP	Chybí `vendors` filtr	Nastav `vendors: [{ picked: ‘packeta’ }]` pro pouze Z-Pointy/Z-Boxy
Widget nefunguje v SPA (React/Vue)	Skript se načte před hydratací	Volej `Packeta.Widget.pick()` až po `DOMContentLoaded` nebo v `useEffect`

7. Testování widgetu

Packeta nemá sandbox prostředí — widget funguje přímo s produkčním API klíčem. Pro testování:

Použij testovací API klíč 0000000000000000 (16× nula) — widget se otevře v demo módu bez reálných dat.
Pro ověření celého flow (widget → zásilka → štítek) použij svůj produkční klíč a vytvoř testovací zásilku. Testovací zásilky lze smazat přes client.packeta.com před jejich fyzickým podáním.

Rychlý přehled faktů

Zásilkovna widget — jak ho integrovat na Shoptet, WooCommerce a custom eshop

schedule Aktualizováno 13. 4. 2026

Souhrn

Packeta (Zásilkovna) Widget API 6 je JavaScriptová komponenta zobrazující mapu Z-Pointů a Z-Boxů přímo v e-shopovém checkoutu. Bez ní zákazník nemůže vybrat konkrétní výdejní místo — dostane jen obecnou adresu. Na Shoptetu: App Store → plugin Packeta (zdarma). Na WooCommerce: plugin "WooCommerce Zásilkovna" z wordpress.org. Na vlastním eshopu: CDN skript + Packeta.Widget.pick() volání po výběru dopravy Zásilkovna.

Widget API verze: 6 (aktuální, doporučená) — legacy v5 funguje, ale nedoporučeno
CDN skript: https://widget.packeta.com/v6/www/js/library.js
Shoptet plugin: App Store → Packeta (zdarma) — automatická integrace widgetu
WooCommerce plugin: "WooCommerce Zásilkovna" na wordpress.org — aktivní vývoj, zdarma
PrestaShop modul: packeta.com/cs/ke-stazeni — oficiální modul ke stažení
API klíč: Povinný — získáš v klientské sekci na client.packeta.com
Výsledná data: Widget vrátí: id pobočky, název, adresu, GPS — tyto data musíš uložit k objednávce

fact_check

Přesnost dat

Orientační informace — ověř u zdroje

Limity hmotnosti, ceny, dostupnost zemí a podmínky se mění v čase. Údaje na této stránce jsou orientační — slouží k výběru vhodného dopravce, ne k závazné kalkulaci. Před odesláním si vždy ověř aktuální podmínky přímo na webu dopravce.

Naposledy revidováno

event 2026-04-13

Oficiální zdroje

Nahlásit chybu: Najdeš nepřesnost? Napiš nám — opravíme do 24 h. info@preprava-baliku.cz

link Zdroje a metodika

Podobní průvodci

Jak poslat balík přes Zásilkovnu (Packetu) — krok za krokem

8 min. čtení

Jak vybrat dopravce pro e-shop — průvodce 2026

10 min. čtení

Výdejní místa v ČR — Packeta vs PPL vs DPD: kde je síť největší a jak ji využít

7 min. čtení