Plugin DPD doprava naviaže doručovaciu metódu na DPD — po potvrdení objednávky sa vytvorí zásielka a štítok cez API DPD a v pokladni sa ponúka vyhľadanie výdajných miest podľa adresy.
Čo plugin robí
Vytvorí zásielku (JSON-RPC shipment) a samostatne stiahne PDF štítok podľa odkazu, ktorý DPD vráti. Nemá živé sledovanie stavu — zákazníkovi ponúka len verejný odkaz na sledovanie na stránke DPD.
Požiadavky
Účet v klientskom portáli DPD s API kľúčom (ClientKey), e-mailom, Delis ID a ID odosielateľskej adresy.
Nastavenia
| Pole | Význam |
|---|---|
| ClientKey (API kľúč) | API kľúč z DPD klientskeho portálu. Po uložení sa zašifruje. |
| E-mail (DPD účet) | E-mail priradený k DPD API prístupu. |
| Delis ID | Vaše DPD Delis ID. |
| ID adresy odosielateľa | ID odosielateľskej adresy nastavenej v DPD portáli (addressSender.id). |
| ID bankového účtu (dobierka) | ID bankového účtu pre výplatu dobierky (bankAccount.id). Potrebné len ak používate dobierku. |
| Produkt / služba DPD | Kód prepravného produktu DPD (napríklad Classic), podľa vašej zmluvy. |
| Typ príjemcu | B2C (súkromná osoba) alebo B2B (firma). Predvolené: B2C. |
| Notifikácie zákazníkovi | Pošle DPD e-mail/SMS notifikáciu o doručení. Predvolené: zapnuté. |
| URL sledovania zásielky | Odkaz na verejné sledovanie DPD; {tracking} sa nahradí číslom zásielky. Predvolené: https://tracking.dpd.de/status/sk_SK/parcel/{tracking}. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin DPD doprava.
- V Nastaveniach vyplňte ClientKey, E-mail, Delis ID a ID adresy odosielateľa z DPD portálu.
- Ak využívate dobierku, doplňte ID bankového účtu.
- Nastavte Produkt / službu DPD podľa vašej zmluvy a Typ príjemcu.
- Uložte a v Doprava & Platby > Doprava priraďte dopravcu DPD 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 API DPD podľa zadaných prístupových údajov.
Čo sa deje na objednávke
Po potvrdení objednávky sa vytvorí zásielka, z odpovede sa vygeneruje číslo zásielky a samostatne stiahne PDF štítok. V pokladni zákazník vyhľadá výdajné miesto zadaním PSČ (výsledky sú v okruhu 50 km od zadanej adresy) — bez zadaného PSČ sa zoznam nezobrazí, keďže DPD miesta neposkytuje ako celú sieť naraz. Sledovanie prebieha cez verejný odkaz DPD, nie cez API stav v administrácii.
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 — DPD neposiela spätné notifikácie do Ecommio.
Časté problémy
- Zásielka sa nevytvorila. Skontrolujte kompletnosť ID adresy odosielateľa a doručovacej adresy objednávky.
- Dobierka sa nedá vytvoriť. Chýba vyplnené ID bankového účtu (dobierka).
- Zoznam výdajných miest je prázdny. Vyhľadávanie funguje len so zadaným PSČ — bez neho DPD API nevráti žiadne výsledky.
- Odkaz na sledovanie nefunguje. Overte formát URL sledovania zásielky — musí obsahovať presne
{tracking}. - Notifikácie zákazníkovi neprichádzajú. Skontrolujte prepínač Notifikácie zákazníkovi — ide o notifikácie od DPD, nie od Ecommio.