Nastavenie Torevo • Packeta SK

Torevo • Packeta SK je samostatná Shopify aplikácia pre doručenie cez slovenské výdajné miesta Packeta. Vlastná inštalácia drží prístupy k účtu, mapovanie dopravy, výber miesta, stav zásielky, štítky a sledovanie spolu v Shopify Admin.

Ako vyzerá pracovný postup v Shopify

Prehľad spája pripojenie, profil trhu, mapovanie, výber miesta a prevádzkovú pripravenosť do jedného kontrolného zoznamu. Nastavený obchod tak overí všetky povinné kroky ešte pred prvou zásielkou.

Nastavenia vysvetľujú rozdiel medzi súkromným API heslom iba na zápis a verejným Widget API kľúčom bez zobrazenia uloženej súkromnej hodnoty.

Stránka Objednávky spája platbu, namapovanú dopravu, vybrané miesto, pripravenosť a akciu zásielky. Neznáme mapovanie zostane zablokované namiesto odhadnutia.

Čo potrebujete z Packeta účtu

V Klientskej sekcii Packeta 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 Informácie o používateľovi → Odosielatelia,
• účet s povolenými slovenskými službami, ktoré chcete ponúkať.

Packeta neposkytuje sandbox. Aj samostatný testovací účet používa produkčný API endpoint. Torevo API heslo šifruje a už ho nezobrazí. Verejný Widget kľúč publikuje iba do nakonfigurovaného výberu miesta.

Pripojte a overte účet

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

Výsledok uvádza prístupy, označenie odosielateľa a konfiguráciu Widgetu oddelene. Neúspešnú položku opravte skôr, než namapujete dopravu alebo vytvoríte zásielku.

Mapujte dopravu zámerne

Pre každý podporovaný spôsob dopravy Shopify vytvorte explicitné mapovanie. Ak ponúkate výdajné miesto aj Z-BOX, vytvorte samostatné mapovania. Doručenie na adresu ani inú službu nepoužívajte, pokiaľ ju aplikácia neuvádza ako podporovanú.

Po premenovaní alebo opätovnom vytvorení sadzby v Shopify mapovanie aktualizujte a urobte ďalšiu testovaciu objednávku. Neznámy spôsob zostane zablokovaný namiesto odhadnutia služby.

Zapnite a otestujte výber miesta

V Online Store → Themes → Customize pridajte do šablóny košíka blok Torevo na výber výdajného miesta. Aplikácia dodá slovenský profil automaticky. Obchodník ani zákazník si nevyberá krajinu alebo poskytovateľa.

Otestujte:

1. slovenské výdajné miesto Packeta,
2. slovenský Z-BOX,
3. pokračovanie bez povinného výberu,
4. zastarané alebo neplatné ID miesta,
5. obnovenie košíka a anglické, slovenské aj české texty.

Torevo pred vytvorením zásielky vybrané miesto znovu overí. Údaj z prehliadača sa nepovažuje za dôkaz, že je miesto stále platné.

Overte prvú zásielku

Použite syntetickú objednávku so slovenským cieľom, kontaktom príjemcu, známou hmotnosťou a namapovanou dopravou. V Objednávkach pred voľbou Pripraviť zásielku skontrolujte platbu, mapovanie dopravy, výdajné miesto a pripravenosť.

Po potvrdení otvorte detail zásielky a overte:

• Packeta packet ID a sledovacie číslo,
• PDF a nakonfigurovaný ZPL/štítkový postup,
• obnovenie sledovania a mapovaný stav,
• vybavenie objednávky v Shopify iba pri výslovnom potvrdení,
• bezpečnú časovú os a akcie opakovania alebo zosúladenia,
• zrušenie syntetického Packeta záznamu po teste.

Automatizácia a bezpečné obnovenie

Automatické vytváranie zapnite až po úspešnom manuálnom teste platenej objednávky aj dobierky pre každý spôsob dopravy. Najprv používajte malé dávky.

Pri timeoute alebo neznámom výsledku použite zosúladenie skôr než opakovanie. Torevo nesmie vytvoriť druhý packet, kým nepreukáže, že pôvodná požiadavka neuspela. Na diagnostiku použite bezpečný balík podpory. Neposielajte prístupy, štítky, celé údaje zákazníka ani surové odpovede Packety.