Packeta API kľúč: čo patrí do mapy a čo musí zostať skryté?

Tvoj slovenský e-shop ukáže mapu Packety, zákazník klikne na miesto a objedná. Až pri balení zistíš, že do administrácie prešiel iba názov dopravy. Alebo správca vložil do verejnej stránky iný prístupový údaj. Obe chyby môžu zostať ukryté za peknou mapou. Pri preberaní napojenia preto kontroluj výsledok celého nákupu. Nemusíš sám programovať, aby si vedel pomenovať, ktorý údaj chýba a aký dôkaz funkčnosti potrebuješ od dodávateľa.

Prečo API kľúč a API heslo nie sú zameniteľné? #

Packeta vo svojom návode na aktualizáciu widgetu výslovne požaduje API Key a zakazuje použitie API Password. Upozorňuje na zverejnenie hesla aj nesprávne fungovanie mapy. Verejný výber miesta a oprávnenie vykonávať operácie pre obchod majú rozdielny účel. Ak správca žiada údaj len pod názvom kľúč, nech presne uvedie, ktoré pole nastavuje. Nevyberaj podľa toho, ktorý reťazec vyzerá dlhší alebo ktorý si naposledy skopíroval.

Pri odovzdávaní prístupu používaj postup určený pre dôverné údaje. V návode pre zamestnanca ani v zadaní na verejnom fóre nemajú byť skutočné prihlasovacie údaje. Ak potrebuješ ukázať problém, zakry tajné hodnoty a nechaj viditeľný názov poľa, chybové hlásenie a čas pokusu. Pri podozrení na zverejnené heslo rieš jeho výmenu a kontrolu napojení s povereným správcom. Vymazanie snímky z jednej správy ešte nepreukazuje odstránenie všetkých kópií.

Ktorú verziu mapy má správca skontrolovať? #

Oficiálny aktualizačný návod označuje widgety v2 až v5 za zastarané a pre výber výdajných miest uvádza prechod na v6. Zároveň menuje staršie knižnice branch.js a packetaWidget.js, ktoré sa majú nahradiť library.js. Sú to konkrétne kontrolné body pri prevzatí staršieho obchodu. Názov doplnku ani dátum posledného upravenia šablóny nehovorí, akú knižnicu stránka skutočne načítava. Požiadaj správcu o kontrolu aktívnej verzie priamo v nasadenej pokladnici.

Po aktualizácii zopakuj zákaznícke scenáre, aj keď mapa predtým fungovala. Najmä otvorenie na telefóne, zrušenie výberu, návrat do košíka a zmenu krajiny. Prevezmi výsledok podľa uložených údajov, nie podľa fotografie mapy. Ak používaš externý modul, over jeho podporovanú verziu a postup u dodávateľa. Svojvoľná výmena jedného odkazu v hotovom module môže rozbiť ďalšie časti. Tento článok poskytuje kontrolné otázky pre odovzdanie práce, nenahrádza dokumentáciu konkrétneho e-shopového systému.

Ako odovzdať programátorovi zrozumiteľný test pokladnice? #

Testovací nákup si priprav tak, aby si jeho výsledok vedel spätne nájsť a bezpečne odlíšiť od skutočnej expedície. Zvolený režim skúšania potvrď s dodávateľom; nepredpokladaj, že každé tlačidlo Test automaticky bráni vzniku účtovanej zásielky. Pri skúške prenášaj iba údaje, ktoré potrebuješ. V protokole postačí výsledok jednotlivých krokov a vysvetlenie odchýlky. Nie je potrebné zhromažďovať zákaznícke adresy v široko dostupnej dokumentácii.

Prečo samotné číslo objednávky neurčuje odosielateľa? #

Dokumentácia nastavenia účtu Packety mapuje Sender Indication na pole eshop pri volaní createPacket(). Znamená to, že integrácia potrebuje aj správne priradenie odosielateľa. Pre obchod s viacerými značkami je užitočné otestovať každú používanú konfiguráciu. Ak zásielka vznikne, stále ešte over, pod ktorým obchodom. Úspešné technické volanie môže obsahovať nesprávne obchodné priradenie, rovnako ako správne vytlačený štítok môže skončiť na nesprávnej krabici.

V prevádzkovom prehľade spoj zákaznícku objednávku, zásielku dopravcu a pracovné zadanie na balenie. Ku každému záznamu urč, ktorý systém je zdrojom pravdy. Číslo objednávky nemení identitu zásielky a pridanie poznámky nenahrádza opravu nesprávneho miesta. Keď sa údaj zmení po vytvorení podania, správca musí vysvetliť podporovaný spôsob opravy. Nežiadaj človeka pri baliacom stole, aby nejasný export vyriešil odhadom podľa mena zákazníka.

Čo preveriť pri oficiálnom doplnku WooCommerce? #

Oficiálny návod Packety pre WooCommerce pracuje s API heslom v nastavení doplnku a odporúča pre štítky formát A6, s variantom tlače podľa zariadenia. To neodporuje pravidlu o kľúči v zákazníckej mape: doplnok môže mať svoju zabezpečenú administráciu a zabezpečovať viac operácií. Dôležité je, kde sa údaj použije a komu sa sprístupní. Pole v administrácii nie je automaticky to isté ako hodnota odoslaná každému návštevníkovi stránky.

Preberaj aj tlačový výstup. Over čitateľnosť na zariadení človeka, ktorý balí, orientáciu, veľkosť a väzbu na konkrétnu krabicu. Z náhľadu na veľkom monitore nezistíš, ako dopadne skutočná tlač. Zvlášť si potvrď, ktorý štítok je aktuálny po oprave objednávky. Staré súbory pomenuj a odstráň z pracovného miesta tak, aby sa nedali omylom použiť. Postup s produktmi dopĺňa článok o skladových zásobách u domáceho odosielateľa.

Ktoré údaje potrebuje človek pripravujúci zásielku? #

Človek pri balení potrebuje rozumieť obsahu, variantom, množstvu a tomu, ku ktorej objednávke patrí pracovný podklad. Potrebuje aj aktuálny postup označenia a odovzdania. Celé API heslo obchodu tieto informácie nenahradí. Ak mu dáš iba tabuľku mien a voľne uložené súbory štítkov, vzniká zbytočný priestor na zámenu. Priprav jeden dohľadateľný pracovný záznam a pravidlo pre zmenu už rozpracovanej objednávky. Pri nejasnom variante má byť jasné, koho sa opýtať.

AirPost funguje ako sieť ľudí, ktorým obchod zverí zásobu na domácu prípravu a podanie objednávok. Rozsah dohody si pozri pri outsourcingu expedície. Vlastné napojenie Packety neznamená automatické prepojenie s AirPost. Pri návrhu procesu potvrď každý skutočný prenos údajov osobitne. Ak objednávku zadávaš ručne, kontroluj ju voči zdrojovému systému. Pri zmene zásoby sa riaď fyzickými kusmi na danom mieste, aby sa export neodoslal človeku bez potrebného výrobku.

Prečo musí export zachovať aj skutočný formát balíka? #

Na porovnanie prípravy vezmi jedinú objednávku. Pri odporúčanej odmene AirPost pre malý balík je príprava s platformovým poplatkom 3,10 €; pri štandardnom balíku 3,85 €. Rozdiel je 0,75 €, ešte bez dopravného. Výpočet používa odporúčania a konštanty overené 19. 10. 2026. Nie je to tarifný rozdiel Packety ani garancia konkrétnej odmeny odosielateľa.

Pre vývojára z toho plynie prevádzková požiadavka: nestratiť údaje potrebné na správnu ponuku a prípravu. Nejde o to mechanicky mapovať názov produktu na jednu veľkosť. Finálny rozmer závisí aj od kombinácie výrobkov a obalu. Pri nejasnej hodnote má proces vyžiadať kontrolu, nie predstierať presné údaje. Podmienky dopravcu vždy over podľa služby. Vyššia odmena za balenie sama nedokazuje, že sa zásielka zmestí do limitov zvolenej dopravy.

Pri odovzdaní integrácie si nechaj vysvetliť aj bežnú údržbu: kto sleduje zmeny doplnku, kto rieši neúspešný export a kde obchod uvidí čakajúcu opravu. Poruchu treba vedieť rozpoznať bez programátorského nástroja. Zákaznícka objednávka nemá zmiznúť z pozornosti len preto, že prenos zlyhal. Prevádzkovú prípravu nového účtu dopĺňa registrácia Packety a prvé podanie. Funkčné napojenie spoznáš podľa správnej zásielky a dohľadateľného výsledku, nie podľa počtu zapnutých automatizácií.

Pri prvej chybe si vytvor stručný záznam: čo zákazník zvolil, čo sa uložilo, čo sa exportovalo a čo bolo na štítku. Pridaj čas a identifikátor objednávky. Tak dokážeš odlíšiť chybu mapy od chyby exportu alebo tlače. Neposielaj správcovi iba vetu Packeta nefunguje. Konkrétna odchýlka umožňuje opraviť správny krok a zopakovať presne ten scenár, ktorý predtým zlyhal. Rovnaký protokol potom poslúži pri ďalšej aktualizácii.

Pri dlhšom výpadku si potvrď aj náhradný pracovný postup. Kto rozhodne, či sa objednávka vytvorí iným podporovaným spôsobom, a kto potom zabráni jej opätovnému exportu? Bez tejto dohody môže neskoršie obnovenie integrácie spracovať už vybavenú objednávku znova. Náhradné podanie označ vo svojom zdrojovom prehľade a priraď k nemu výslednú zásielku. Tak zostane práca dohľadateľná aj po vyriešení technickej chyby a človek pri balení nemusí rozhodovať podľa neúplnej spomienky.