Řešení problémů

Tato stránka shrnuje nejčastější problémy nahlášené obchodníky a jejich řešení.

Widget se nezobrazuje v pokladně

Toto je nejčastější problém.

Příčina 1: Klíčové slovo neodpovídá názvu přepravní metody

Widget se aktivuje pouze tehdy, když zákazník zvolí přepravní metodu, jejíž název obsahuje klíčové slovo nastavené v aplikaci. Neshoda je nejčastější příčina.

1. V administraci Shopify přejděte do Nastavení → Expedice a doručení a zkopírujte přesný název přepravní metody Zásilkovny.
2. Otevřete aplikaci a přejděte do Interface Settings. Zkontrolujte nastavené klíčové slovo.
3. Ověřte, že klíčové slovo je součástí názvu přepravní metody (velká/malá písmena ani diakritika nehrají roli).

Příklad: pokud je přepravní metoda pojmenována „Zásilkovna – výdejní místo” a klíčové slovo je zasilkovna, nastavení funguje správně. Klíčové slovo pickup by neodpovídalo.

Podrobnější vysvětlení najdete v sekci Nastavení klíčového slova.

Příčina 2: Chybí blok checkout extension

Widget se zobrazí pouze tehdy, když je blok aplikace přidán v příslušném editoru.

Widget se nezobrazuje přímo v průběhu pokladny — zobrazuje se na stránce s poděkováním (Thank You page) a na stránce stavu objednávky v zákaznickém účtu. Zobrazení v průběhu pokladny je dostupné pouze pro obchody na plánu Shopify Plus.

1. V administraci Shopify přejděte do Nastavení → Pokladna a klikněte na Přizpůsobit.
2. V editoru přejděte na stránku Thank You.
3. Ověřte, že blok Zásilkovna / Packeta Pickup Point je přidán a aktivní.
4. Pokud chybí, klikněte na Add block a přidejte ho ze sekce bloků aplikace.

Pro stránku stavu objednávky v zákaznickém účtu přejděte do Nastavení → Zákaznické účty → Přizpůsobit.

---

Widget se otevře, ale nezobrazuje žádná výdejní místa

Mapa nebo seznam výdejních míst se nenačte.

Možné příčiny:

• API přepravce pro výdejní místa je dočasně nedostupné
• Klíčové slovo je nastaveno na špatného přepravce
• Síťový problém na straně zákazníka brání načtení dat

Řešení:

1. Ověřte, že klíčové slovo v Interface Settings odpovídá správnému přepravci.
2. Zkontrolujte, zda jsou výdejní místa dostupná přímo na webu přepravce.
3. Pokud problém nastává jen u části zákazníků, může jít o problém na jejich straně (prohlížeč, síť).

---

Widget se zobrazuje u špatných přepravních metod (i u doručení na adresu)

Pokud se widget zobrazuje zákazníkům, kteří zvolili doručení na adresu, je klíčové slovo příliš obecné a odpovídá i nechtěným přepravním metodám.

Řešení: Použijte specifičtější klíčové slovo. Pokud výraz „zasilkovna” obsahují jak metody pro výdejní místa, tak metody pro doručení na adresu, přejmenujte metody pro doručení na adresu tak, aby klíčové slovo neobsahovaly.

Viz sekce Přepravci — konkrétně část „Doručení na adresu vs. výdejní místa”.

---

Výběr výdejního místa se nezobrazuje na mobilních zařízeních

Tlačítko pro výběr přepravce nebo samotný widget se na menších obrazovkách nezobrazuje správně.

Řešení: Jednalo se o známou chybu vyřešenou v nedávné aktualizaci aplikace. Aktualizujte aplikaci na nejnovější verzi. Pokud problém přetrvává i po aktualizaci, kontaktujte podporu.

---

Chyba „Link expired” při prvním výběru výdejního místa

Při prvním pokusu zákazníka o výběr výdejního místa se zobrazí chyba „link expired”.

Řešení: Jednalo se o známou chybu vyřešenou v nedávné aktualizaci aplikace. Pokud chyba přetrvává i po aktualizaci, kontaktujte podporu.

---

Widget není viditelný na stránce stavu objednávky

Widget výdejního místa se nezobrazuje na stránce stavu objednávky po dokončení nákupu.

Řešení: Blok extension je nutné přidat samostatně pro zákaznické účty.

1. V administraci Shopify přejděte do Nastavení → Zákaznické účty.
2. Klikněte na Přizpůsobit.
3. Přidejte blok Zásilkovna do sekce stavu objednávky.
4. Uložte změny.

---

Všechny stránky aplikace zobrazují 404 / „Invalid token” / aplikace se nenačítá

Pokud všechny stránky v aplikaci vrací chybu 404 nebo vidíte chybu „Invalid token”, postupujte takto:

1. Zkontrolujte API klíč: V nastavení aplikace ověřte, že API klíč odpovídá klíči ve vašem účtu Zásilkovna/Packeta na client.packeta.com.
2. Přeinstalujte aplikaci: Pokud je API klíč správný, ale aplikace stále nefunguje, odinstalujte ji a nainstalujte znovu z Shopify App Store. Historie objednávek a štítky jsou uloženy v Shopify a nebudou ztraceny.
3. Kontaktujte podporu, pokud ani přeinstalace nepomůže.

---

Export se zasekl ve stavu „probíhá”

Export do Zásilkovny se spustí, ale nikdy nedokončí.

Řešení:

1. Obnovte stránku — export mohl proběhnout na pozadí.
2. Zrušte export a zkuste znovu s menší dávkou (10–20 objednávek).
3. Ověřte, že exportované objednávky mají štítek zasilkovna_selected — exportovat lze pouze objednávky s potvrzeným výběrem výdejního místa.

---

Widget zobrazuje anglický text místo češtiny

Widget zobrazuje anglické texty, přestože obchod je v češtině.

Řešení:

1. Přejděte do sekce Translations v aplikaci.
2. Zkontrolujte, zda jsou vyplněna všechna 4 textová pole v češtině.
3. Všechna pole jsou povinná — pokud je některé prázdné, aplikace může použít výchozí anglické texty.
4. Po uložení otestujte v anonymním okně prohlížeče, abyste předešli problémům s cache.

---

Objednávky nemají správné štítky

Objednávky neobdrží štítky zasilkovna_selected nebo zasilkovna_unselected automaticky.

Řešení:

1. Otevřete aplikaci a zkontrolujte, zda nejsou zobrazeny žádné nevyřízené žádosti o oprávnění — pokud ano, schvalte je.
2. Přejděte do Nastavení → Aplikace a ověřte, že aplikace Zásilkovna má oprávnění pro správu objednávek (write).
3. Pokud oprávnění chybí: odinstalujte aplikaci, nainstalujte ji znovu z Shopify App Store a při instalaci přijměte všechna požadovaná oprávnění.

---

Widget zobrazuje špatného přepravce

Widget se zobrazuje, ale ukazuje výdejní místa Zásilkovny, přestože zákazník zvolil GLS, DPD nebo jiného přepravce.

Příčina: Klíčové slovo pro daného přepravce není nastaveno nebo je příliš obecné a překrývá se s jiným přepravcem.

Řešení:

1. V Interface Settings zkontrolujte, že každý přepravce má nastaveno vlastní klíčové slovo.
2. Dbejte na to, aby se klíčová slova nepřekrývala — pokud název přepravní metody obsahuje klíčová slova více přepravců, aplikace použije první shodu.
3. Pojmenujte přepravní metody tak, aby byly jednoznačně rozlišeny. Viz Přepravci.

---

Odinstalace aplikace

Aplikaci Zásilkovna odinstalujete takto:

1. V administraci Shopify přejděte do Nastavení → Aplikace.
2. Najděte Pickup Points CZ/SK/HU v seznamu.
3. Klikněte na Smazat nebo Odinstalovat a potvrďte.

Po odinstalaci:

• Štítky objednávek (zasilkovna_selected apod.) a vlastní atributy zůstanou v Shopify — nebudou smazány.
• Metaobjekty překladů zůstanou v obsahu obchodu.
• Předplatné je automaticky zrušeno.
• Při opětovné instalaci bude nutné znovu nastavit konfiguraci.

---

Potřebujete další pomoc?

E-mail: integrace@soundsgood.agency

Uveďte prosím URL vašeho Shopify obchodu, popis problému a případné snímky obrazovky. Nezapomeňte zmínit kroky, které jste již vyzkoušeli.