Nastavenie Torevo • Zasilkovna

Torevo • Zasilkovna je samostatná Shopify aplikácia pre český zásielkový proces. Má vlastnú inštaláciu, predplatné, runtime, databázu, účet poskytovateľa a konfiguráciu. S aplikáciou Packeta SK zdieľa iba technický základ Torevo Shipping.

Ako vyzerá pracovný postup v Shopify

Prehľad spája Shopify pripojenie, predplatné, účet dopravcu, český profil, mapovanie dopravy a zákaznícke rozšírenia do jedného kontrolného zoznamu. Prvú zásielku vytvorte až po dokončení všetkých desiatich krokov.

Nastavenia oddeľujú súkromné API heslo iba na zápis od verejného Widget API kľúča. Uložené heslo sa už nezobrazuje. Výsledok overenia prístupov, odosielateľa a widgetu zostáva viditeľný.

Prihlásený zákazník môže potvrdiť české výdajné miesto aj zo svojho detailu objednávky. Server vždy overí, že používateľ patrí k danej objednávke, a výber pred vytvorením zásielky znova validuje cez poskytovateľa.

Čo potrebujete zo Zásilkovna účtu

V Klientskej sekcii Packeta Network si pripravte:

• súkromné 32-znakové API heslo pre serverové operácie,
• verejný 16-znakový Widget API kľúč pre výber miesta zákazníkom,
• presné označenie odosielateľa zo sekcie s odosielateľmi,
• účet s povolenými českými službami, ktoré chcete ponúkať.

Zásilkovna neposkytuje samostatný sandbox. Aj vyhradený testovací účet používa produkčné API, preto vytvorenú testovaciu zásielku nikdy neodovzdávajte dopravcovi a po overení štítka a sledovania ju zrušte.

Účet alebo konfigurácia aplikácie Torevo • Packeta SK nie sú dostupné v aplikácii Torevo • Zasilkovna. Každá aplikácia drží vlastné šifrované prístupy a mapovania poskytovateľa.

Pripojte a overte účet

1. Otvorte Torevo • Zasilkovna → Nastavenia.
2. Zadajte interný názov účtu, API heslo, Widget API kľúč a presné označenie odosielateľa.
3. Nechajte profil Zásilkovna Česko zapnutý a uložte nastavenia.
4. Vyberte Overiť pripojenie Zásilkovna Česko.

Výsledok uvádza prístupy, odosielateľa a Widget samostatne. Neúspešnú položku opravte ešte pred mapovaním dopravy alebo vytvorením zásielky.

Namapujte české služby

Každý český spôsob dopravy v Shopify explicitne priraďte k zvolenej službe Zásilkovna. Ak obchod ponúka interné výdajné miesta aj Z-BOX, držte ich v samostatných mapovaniach.

Službu neurčujte podľa preloženého alebo skráteného názvu dopravy. Ak sa názov zmení, Torevo prípravu zablokuje, kým obchodník mapovanie neopraví.

Nastavte výber výdajného miesta

V Online Store → Themes → Customize pridajte do šablóny košíka blok Torevo na výber výdajného miesta. Nainštalovaná aplikácia dodá český profil automaticky. Obchodník ani zákazník nevyberá poskytovateľa alebo krajinu. Overte stabilné uloženie výberu aj po zmene košíka.

Otestujte:

1. české interné výdajné miesto,
2. český Z-BOX,
3. pokračovanie bez povinného výdajného miesta,
4. slovenské výdajné miesto odovzdané českej aplikácii,
5. zastaraný alebo neplatný identifikátor výdajného miesta,
6. české, slovenské aj anglické texty zákazníckeho rozšírenia.

Server pred vytvorením zásielky znovu overí krajinu aj bod. Výber z iného trhu musí bezpečne zlyhať.

Overte prvú zásielku

Použite syntetickú objednávku s českým cieľom, kontaktom príjemcu, známou hmotnosťou, českým výdajným miestom a namapovanou dopravou. V Objednávkach pred voľbou Pripraviť zásielku skontrolujte platbu, službu, výdajné miesto, údaje príjemcu a odosielateľa.

Po potvrdení otvorte detail zásielky a overte:

• že vznikla práve jedna vzdialená zásielka,
• opätovné stiahnutie PDF a nakonfigurovaný ZPL postup,
• obnovenie sledovania tej istej zásielky,
• fulfillment v Shopify iba pri výslovnom potvrdení,
• bezpečnú časovú os, opakovanie a zosúladenie neistého výsledku,
• zrušenie syntetickej zásielky pred fyzickým odovzdaním.

Čo robia ostatné stránky aplikácie

Stránka	Účel
Dávky	Pripraví viac vybraných objednávok a výsledok vyhodnotí po každej položke.
Chýbajúce výdajné miesta	Zobrazí objednávky, pri ktorých musí zákazník alebo obchodník bezpečne doplniť cieľ.
Zásielky	Sprístupní štítok, tracking, fulfillment, zrušenie a detail udalostí.
Prevádzka	Ukáže stav fronty, workera, webhookov a bezpečný diagnostický balík bez osobných údajov.
Predplatné	Zobrazí kanonický stav plánu potvrdený a účtovaný cez Shopify.
Nastavenia	Spravuje účet, profil, služby, mapovania, dobierku, štítky, automatizáciu a zákaznícke rozšírenia.

Bezpečná prevádzka

• Konfigurácia českej aplikácie zostáva oddelená od aplikácie Packeta SK.
• Nejasný výsledok poskytovateľa pred opakovaním zosúlaďte.
• Pri rotácii prístupových údajov nemažte historické snapshoty zásielok potrebné na obnovu štítka a trackingu.
• Kombináciu meny alebo služby, ktorú aplikácia neuvádza, považujte za nepodporovanú až do overenia.
• Podpore posielajte iba bezpečné ID, časy a chybové kódy.