[Jak propojit](/articles/jak-propojit-dpd-se-shoptetem) Zásilkovnu se Shoptetem

Zásilkovna patří mezi nejoblíbenější přepravce v Česku díky síti zhruba 9 000 výdejních míst, dostupným cenám a tomu, že koncový zákazník dnes Z-Box nebo Z-Point bere jako standard. Propojení se Shoptetem vám umožní nabídnout pohodlný výběr výdejního místa přímo v pokladně, automatizovat tisk štítků a sledování zásilek a zbavit se manuálního přepisování objednávek mezi systémy. V tomto návodu projdeme kompletní propojení od registrace až po pokročilé tipy, které vám ušetří desítky minut týdně.

Co budete potřebovat

Než se pustíte do nastavování, ujistěte se, že máte:

• Aktivní e-shop na platformě Shoptet (libovolný tarif — modul Zásilkovny funguje i v základní verzi).
• Aktivní účet a smlouvu se Zásilkovnou. Smlouvu uzavřete online v klientské sekci a aktivace běžně trvá 1–2 pracovní dny.
• API klíč Zásilkovny (najdete jej v klientské sekci v Nastavení → API). Pro Shoptet potřebujete tzv. „API password" pro v6 API.
• Administrátorský přístup do Shoptetu (běžné účty „Marketing" nebo „Pokladní" na nastavení dopravců nemají oprávnění).
• Vyplněnou adresu odesílatele a typ obalu, který typicky používáte (váhové a rozměrové limity).

Pokud zatím nemáte žádný balíkový systém a teprve si vybíráte mezi dopravci, mrkněte se na [srovnání variant doručení v ČR](/articles/jak-[ČR](/articles/jak nastavit —](/articles/jak-nastavit-balikovna-pro-e-shop)-balikovna-pro-e-shop) — Zásilkovna se hodí hlavně tam, kde převažují malé balíky do 5 kg a B2C zákazníci.

Postup krok za krokem

Krok 1: Aktivace modulu Zásilkovny ve Shoptetu

Přihlaste se do administrace Shoptetu a přejděte do sekce Doprava a platby → Dopravci. V seznamu dostupných dopravců najdete Zásilkovnu — modul je zdarma a součástí standardní instalace. Klikněte na Aktivovat a do dialogového okna zadejte svůj API klíč a API password z klientské sekce Zásilkovny.

Shoptet automaticky ověří platnost klíče (volá testovací endpoint Zásilkovny) a po úspěchu modul aktivuje. Pokud dostanete chybu „Neplatné přihlašovací údaje", nejčastěji jde o záměnu API klíče s číslem zákazníka — API klíč je 32znakový hexadecimální řetězec, ne číselný účet.

Po aktivaci modulu se v administraci objeví nová sekce Zásilkovna, kde uvidíte přehled odeslaných zásilek, importované výdejní body a logy synchronizací.

Krok 2: Nastavení způsobů doručení

Po aktivaci modulu si v sekci Doprava a platby → Způsoby dopravy nastavte, které varianty Zásilkovny chcete zákazníkům nabídnout:

• Výdejní místo (Z-Point a Z-Box) — nejlevnější varianta, zákazník si balík vyzvedne sám. Z-Boxy běží 24/7 a nemají frontu — pro městské zákazníky preferovaná volba.
• Doručení na adresu (Zásilkovna Home) — služba kurýrního doručení, dražší, ale pohodlnější pro objemnější zboží.
• Doručení v zahraničí — Zásilkovna obsluhuje SK, PL, HU, RO, DE a další; sazby si nastavte zvlášť pro každou destinaci.

Pro každou variantu nastavte:

• Cenu pro zákazníka (statická částka nebo podle hmotnosti).
• Hmotnostní a rozměrové limity (Z-Box má limit 70 × 36 × 50 cm a 5 kg).
• Podmínky pro dopravu zdarma (nejčastěji nad 1 500 Kč nebo nad 2 500 Kč v závislosti na marži).
• Pravidla viditelnosti — můžete například skrýt Zásilkovnu Home pro objednávky pod 500 Kč, kde by byla nákladově ztrátová.

Krok 3: Widget pro výběr výdejních míst

Shoptet automaticky integruje oficiální widget Zásilkovny do pokladny. Zákazník při výběru dopravy uvidí mapu, na které si klikne na konkrétní výdejní místo. Widget zobrazuje otevírací dobu, adresu, fotku pobočky a info o tom, zda jde o Z-Box (24/7) nebo Z-Point (s obsluhou).

Ověřte vždy:

1. Že se widget načítá v desktopové i mobilní verzi pokladny.
2. Že po výběru místa se identifikátor správně propíše do objednávky (vidíte ho v detailu objednávky jako Zásilkovna ID).
3. Že na karte „Děkujeme za nákup" zákazník vidí, kam si pro balík přijde — snižuje to počet dotazů na zákaznickou podporu.

Mobilní zobrazení je nejčastější bolavé místo: vlastní úpravy šablony pokladny ho můžou rozbít. Pokud máte custom šablonu, kontaktujte vašeho vývojáře, ať ověří, že není zablokovaný JavaScript ze widget.packeta.com.

Krok 4: Automatický export zásilek

V administraci Shoptetu přejděte na Objednávky → Export zásilek → Zásilkovna. Tady nastavíte, jak často se mají objednávky odesílat do systému Zásilkovny:

• Manuální export — vyberete objednávky a kliknete na „Odeslat do Zásilkovny". Vhodné, dokud máte malý objem nebo si chcete každou objednávku zkontrolovat.
• Automatický export po změně stavu — typicky při přechodu objednávky do stavu „Připraveno k odeslání". Tohle je sweet spot pro většinu e-shopů.
• Hromadný export v nastavený čas — například každý den v 15:00 odešle všechny objednávky z předchozích 24 hodin. Vhodné, pokud balíte ve várkách.

Po exportu Zásilkovna vrátí trackingové číslo, které se automaticky propíše k objednávce. Štítky si pak můžete stáhnout jako jeden hromadný PDF přímo ze Shoptetu — Zásilkovna je generuje ve formátu A6 (vhodné pro většinu termo tiskáren) i A4 (4 štítky na list).

Pokud objednávek máte víc než 50 denně, zvažte i automatizaci přes Make (Integromat), který umí export pustit dle libovolných pravidel a navíc reportovat chyby do Slacku.

Krok 5: Sledování zásilek a notifikace

Po předání balíku k přepravě začne Zásilkovna posílat zákazníkovi automatické notifikace — e-mailem i SMS — od „Balík je na cestě" přes „Připraveno k vyzvednutí" až po „Vyzvednuto". Notifikace běží v rámci základního ceníku.

Ve Shoptetu se trackingové číslo objeví v detailu objednávky a zákazník ho vidí v e-mailu i ve svém zákaznickém účtu. Doporučujeme nastavit vlastní e-mailové šablony — vlastní e-mailové šablony s logem a tonem značky výrazně zvyšují důvěru a snižují počet dotazů „Kdy mi to dorazí?".

Pro pokročilé reporty si v Zásilkovně aktivujte Webhooks — Zásilkovna pošle POST request při každé změně stavu zásilky. To můžete zachytit v Make nebo vlastním endpointu a třeba aktualizovat status v interním CRM nebo poslat dotaz na recenzi po doručení.

Časté problémy a jejich řešení

Widget se nezobrazuje v pokladně

Nejčastější příčina je vlastní úprava šablony pokladny, která blokuje načítání externích skriptů z widget.packeta.com. Otevřete vývojářské nástroje prohlížeče (F12) a v záložce Console zkontrolujte chyby. Pokud vidíte CSP (Content Security Policy) chybu, ozvěte se podpoře Shoptetu — ta vám doplní výjimku. Pokud se chyba neobjeví, ale widget chybí vizuálně, přepněte na výchozí šablonu a zkuste znovu.

Chybné nebo žádné trackingové číslo

Ujistěte se, že máte v Shoptetu správně zadaný API klíč (ne číslo zákazníka). Dále zkontrolujte v sekci Zásilkovna → Logy synchronizací, zda export proběhl bez chyb. Typický důvod selhání: chybějící váha balíku v objednávce, nevyplněná adresa odesílatele nebo objednávka nad limit Z-Boxu (5 kg / 70×36×50 cm).

Nesouhlasí ceny dopravy

Ceník v Zásilkovně se aktualizuje, ale do Shoptetu se ceny nepřepíšou automaticky — Shoptet pracuje s vašimi koncovými cenami pro zákazníka, ne s nákladovými cenami od dopravce. Při změně ceníku ze strany Zásilkovny vždy ručně upravte i své prodejní ceny v Doprava a platby → Způsoby dopravy.

Zákazník dostal balík do špatného Z-Boxu

Pravděpodobně při exportu nebyl předán picksUpId (ID výdejního místa). Zkontrolujte v detailu objednávky pole Zásilkovna ID — pokud je prázdné, widget nefunguje správně. Ručně dohledejte ID v aplikaci Zásilkovny a upravte zásilku, dokud není odeslána.

Štítky se generují prázdné nebo bez čárového kódu

Toto je obvykle problém s tiskárnou nebo PDF prohlížečem. Zkuste stáhnout PDF a otevřít v Adobe Acrobat Reader místo prohlížeči — Chrome a Firefox občas nezvládnou vykreslit termo formát A6. Pokud používáte termo tiskárnu (Zebra, Brother), zvolte při tisku „Skutečná velikost" a ne „Přizpůsobit stránce".

Tipy pro pokročilé

1. Automatizace přes Make/Zapier: napojte výstup ze Zásilkovny na Make a po doručení automaticky pošlete dotaz na recenzi do Heureky nebo Trustpilotu. Konverze recenzí roste z typických 2 % na 8–10 %, když jde request 24 h po doručení.

2. Webhooks pro real-time tracking: aktivujte webhooks v Zásilkovně a poslouchejte je v Make. Při stavu „Připraveno k vyzvednutí" pošlete vlastní SMS z Twilio s vaším brandovaným textem — výrazně lepší než generická notifikace od přepravce.

3. A/B test ceny dopravy: vyzkoušejte zdarma dopravu nad 1 500 Kč proti zdarma nad 1 999 Kč. Většina e-shopů zjistí, že vyšší práh zvedne průměrnou hodnotu objednávky o 8–15 % bez snížení konverze.

4. Skryté výdejní místo pro dropshipping: pokud expedujete přes externí sklad, můžete v Zásilkovně přidat „Místo podání" sklad partnera. Štítek se vygeneruje s jejich adresou jako odesílatel a vám zůstane jen koordinace.

5. Hromadné štítky podle stavu: nastavte si filtr objednávek na stav „Připraveno k odeslání" a stažení všech štítků proveďte jednou denně. Šetří to 30–60 minut týdně oproti tisku po jednotlivých objednávkách.

6. Integrace s Fakturoid přes Make: po vygenerování štítku spustí Make scénář, který vystaví fakturu, pošle ji zákazníkovi a založí pohyb ve skladu. Plně automatizovaný workflow od pokladny po zaúčtování.

Často kladené otázky

Kolik stojí propojení Zásilkovny se Shoptetem?

Propojení samotné je zdarma — modul je standardní součástí Shoptetu a Zásilkovna za API přístup neúčtuje žádné poplatky. Platíte jen za reálně odeslané zásilky podle ceníku Zásilkovny (od cca 49 Kč za výdejní místo, od cca 79 Kč za doručení na adresu, ceny se průběžně mění).

Funguje propojení na všech tarifech Shoptetu?

Ano, modul Zásilkovny je dostupný i v základním tarifu. Některé pokročilé funkce (například hromadný export přes API nebo webhooks) jsou ale zpřístupněné jen ve vyšších tarifech Shoptet PROFI a vyšší.

Jak dlouho trvá aktivace API klíče u Zásilkovny?

Po podpisu smlouvy se Zásilkovnou se klientská sekce a API přístup obvykle aktivují do 1–2 pracovních dnů. Pokud klíč v sekci Nastavení → API ještě nevidíte, kontaktujte podporu Zásilkovny a požádejte o ruční aktivaci.

Co dělat, když Zásilkovna nedoručí balík do termínu?

Reklamaci zadávejte přímo přes klientskou sekci Zásilkovny — Shoptet samotnou reklamaci nezpracovává. Přiložte trackingové číslo a fakturu. Při ztrátě balíku se náhrada řeší podle pojištění, které máte sjednáno (běžně do 5 000 Kč v základní variantě, vyšší limity za příplatek).

Lze propojit více Zásilkovenských účtů s jedním Shoptetem?

Standardně ne — Shoptet podporuje jeden API klíč na e-shop. Pokud potřebujete oddělit B2B a B2C zásilky, řešením je buď oddělit je v Zásilkovně přes „Místa podání" v rámci jednoho účtu, nebo provozovat dva oddělené e-shopy.

Můžu přes Zásilkovnu posílat i do zahraničí?

Ano, Zásilkovna obsluhuje SK, PL, HU, RO, DE, AT a další. Každou destinaci nastavte ve Shoptetu jako samostatný způsob dopravy s vlastní cenou — Zásilkovna účtuje různé sazby podle země, hmotnosti a typu doručení.

Závěr

Propojení Zásilkovny se Shoptetem je díky nativnímu modulu otázkou patnácti minut. Co stojí za to investovat dál: nastavení automatického exportu, vlastní e-mailové šablony s trackingem a propojení s Make pro post-sale automatizace. Pokud máte víc než 30 objednávek denně, doporučujeme zvážit i alternativy jako Balíkovna nebo DoDo jako sekundární variantu — žádný jediný dopravce není ideální pro 100 % zásilek a multi-carrier setup vám dá flexibilitu při výpadcích.