Plugin SPS naviaže doručovaciu metódu na SPS (Slovak Parcel Service) — po potvrdení objednávky sa vytvorí zásielka a štítok cez Webship API a v pokladni sa ponúka výber z výdajných miest cez oficiálny widget SPS Balíkomat.
Čo plugin robí
Vytvorí zásielku (SOAP Webship createAndPrintCifShipment), ktorá v odpovedi vráti odkaz na štítok aj číslo zásielky. Podporuje doručenie na Balíkomat aj dobierku. Nemá živé sledovanie stavu — zákazníkovi ponúka len verejný odkaz na sledovanie na stránke SPS.
Požiadavky
Prihlasovacie údaje do SPS Webship (používateľské meno a heslo).
Nastavenia
| Pole | Význam |
|---|---|
| Webship používateľ | Prihlasovacie meno do SPS Webship. |
| Webship heslo | Heslo do SPS Webship. Po uložení sa zašifruje. |
| Odosielateľ — názov/firma, ulica, mesto, PSČ, krajina, telefón, e-mail | Adresa a kontakt odosielateľa uvedené na štítku. |
| URL sledovania zásielky | Odkaz na verejné sledovanie SPS; {tracking} sa nahradí číslom zásielky. Predvolené: https://www.sps-sro.sk/sledovanie-zasielky/?trackingNumber={tracking}. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin SPS.
- V Nastaveniach vyplňte Webship používateľa a heslo.
- Vyplňte kompletnú adresu Odosielateľa — používa sa na každom vytvorenom štítku.
- Podľa potreby upravte URL sledovania zásielky, ak chcete zákazníkom ponúknuť iný formát odkazu.
- Uložte a v Doprava & Platby > Doprava priraďte dopravcu SPS k príslušnej doručovacej metóde.
Testovací/sandbox režim
Plugin nemá samostatný testovací režim ani prepínač sandboxu — pracuje priamo s produkčným Webship API podľa zadaných prihlasovacích údajov.
Čo sa deje na objednávke
Po potvrdení objednávky sa vytvorí zásielka a stiahne štítok. SPS vyžaduje pri každej zásielke uvedenie poistnej hodnoty — Ecommio ju automaticky nastaví na celkovú sumu objednávky. V pokladni zákazník vyberá výdajné miesto (Balíkomat) cez oficiálny JS widget SPS, rovnako ako pri Packete — výber prebieha priamo cez widget, nie cez zoznam v pokladni. Sledovanie prebieha cez verejný odkaz SPS.
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 — SPS neposiela spätné notifikácie do Ecommio. Stav zásielky sa dá overiť len cez verejný odkaz na sledovanie, nie priamo v administrácii Ecommio.
Časté problémy
- Zásielka sa nevytvorila. Skontrolujte kompletnosť adresy odosielateľa a prihlasovacie údaje do Webship.
- Widget Balíkomatu sa nenačíta. Skontrolujte pripojenie na internet v prehliadači zákazníka — widget sa načítava priamo zo stránky SPS.
- Odkaz na sledovanie nefunguje. Overte formát URL sledovania zásielky — musí obsahovať presne
{tracking}. - Dobierka sa nezúčtovala. Skontrolujte, či platobná metóda objednávky obsahuje slovo dobierka/COD.
- Vytvorenie zásielky zlyhá s chybou poistnej hodnoty. SPS vyžaduje poistnú hodnotu na každej zásielke — Ecommio ju posiela automaticky ako sumu objednávky, chyba preto zvyčajne znamená problém s inými povinnými údajmi (adresa, prihlásenie), nie s hodnotou samotnou.