Plugin Packeta naviaže doručovaciu metódu na Packetu (Zásielkovňu) — po potvrdení objednávky sa automaticky vytvorí zásielka a štítok cez API Packety a v pokladni sa zákazníkovi ponúkne výber výdajného miesta cez oficiálny widget Packety.
Čo plugin robí
Po prijatí objednávky s doručovacou metódou naviazanou na Packetu vytvorí zásielku (SOAP API createPacket) a v tej istej operácii stiahne PDF štítok vo zvolenom formáte. Sledovanie zásielky sa dá overiť cez plugin, ale zákazníkovi sa v pokladni tracking odkaz nezobrazuje automaticky — sledovanie funguje priamo cez API stav.
Požiadavky
Účet v klientskej zóne Packety (client.packeta.com) a jeho API heslo.
Nastavenia
| Pole | Význam |
|---|---|
| API heslo | API heslo z klientskej zóny Packeta. Widget kľúč sa odvodí automaticky (prvých 16 znakov). Po uložení sa zašifruje. |
| Označenie e-shopu (eshop) | Identifikátor odosielateľa priradený Packetou (pole eshop). |
| ID dopravcu pre doručenie na adresu | ID Packeta dopravcu pre doručenie domov (addressId). Pri doručení na výdajné miesto sa použije ID zvoleného miesta. |
| Predvolená hmotnosť (kg) | Použije sa, ak objednávka nemá zaznamenanú hmotnosť. Predvolené: 1. |
| Formát štítku | A6 na A4 / A6 (termo) / A7 (termo). Predvolené: A6 na A4. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin Packeta.
- V jeho Nastaveniach vyplňte API heslo z klientskej zóny Packety.
- Doplňte Označenie e-shopu, prípadne ID dopravcu pre doručenie na adresu, ak dopravu na adresu využívate.
- Zvoľte Formát štítku podľa vašej tlačiarne.
- Uložte nastavenia.
- V Doprava & Platby > Doprava priraďte dopravcu Packeta k príslušnej doručovacej metóde (pole Dopravca).
Testovací/sandbox režim
Plugin nemá samostatný testovací režim ani prepínač sandboxu — pracuje vždy priamo s produkčným API Packety podľa zadaného API hesla.
Čo sa deje na objednávke
Pri potvrdení objednávky sa vytvorí zásielka a stiahne štítok vo zvolenom formáte. V pokladni si zákazník vyberie výdajné miesto priamo cez oficiálny JS widget Packety — výber funguje aj bez vyplneného API hesla, pretože widget kľúč nie je na výber miesta potrebný (dôležité pre obchod, ktorý si dopravu ešte len chystá nastaviť). Sledovanie prebieha cez interné API volanie, bez verejného odkazu na sledovanie.
Refundácie
Plugin nemá vlastnú funkciu refundácie — s dopravou nesúvisí, rieši sa cez platobnú metódu objednávky.
Webhook
Plugin nemá webhook — Packeta neposiela žiadne spätné notifikácie do Ecommio.
Časté problémy
- Zásielka sa nevytvorila. Skontrolujte, či má objednávka vyplnenú doručovaciu (prípadne fakturačnú) adresu — bez adresy Packeta zásielku odmietne.
- Widget na výber výdajného miesta sa nenačíta. Overte pripojenie na internet v prehliadači zákazníka; samotné API heslo pritom nemusí byť príčinou, keďže widget funguje aj bez neho.
- Chyba pri vytváraní zásielky s popisom konkrétneho poľa. Packeta API vracia chybu SOAP s presným poľom, ktoré nesedí (napríklad chýbajúca hmotnosť) — skontrolujte údaje objednávky a nastavenú Predvolenú hmotnosť.
- Doprava zadarmo, ale plugin nie je vidno pri dopravcovi. Skontrolujte, či je plugin zapnutý v Systém > Pluginy — vypnutý plugin sa v zozname dopravcov na doručovacej metóde nezobrazí.