Dokumentace pluginu Toret DPD

Nacházíte se na stránkách dokumentace pluginu Toret DPD, který do e-shopu integruje dopravce DPD.

Instalace pluginu

Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete zde.

Aktivace pluginu

Po instalaci pluginu si otevřete plugin DPD (Toret Plugins > DPD CZ nebo DPD SK). Na kartě Hlavní nastavení vložte do příslušného pole licenční klíč a ověřte licenci.

Napojení na DPD CZ

Plugin DPD obsahuje možnost napojení na DPD CZ (GeoAPI nebo DPD Shipping) a DPD SK (DPD Shipper nebo dpdporta.sk).

DPD CZ

Pro použití napojení na DPD CZ je nutné mít vytvořený DPD účet pro GeoAPI nebo DPD Shipping. Pro vytvoření účtu kontaktujte podporu DPD. Nejedná se o účet do mojedpd.cz

!!! Dopravní společnost DPD má oba systémy (GeoAPI a mojedpd.cz) oddělené, tedy podané balíčky přes API se nepropisují pod účet mojedpd.cz.

DPD CZ nemá administraci pro účty zřízené k napojení na API, tedy se není kam u DPD přihlásit. Přehled podaných zásilek je možné pouze přes plugin v přehledu objednávek.

Po nainstalování a aktivaci pluginu pokračujte na jeho nastavení, které se nachází v sekci Toret plugins → DPD CZ.

Pro napojení pluginu s DPD GeoAPI/Shipping účtem je potřeba povolit DPD CZ, následně zvolit API, ke které máte přístupy, a vyplnit přístupové údaje, které jste získali od DPD.

Pokud máte zahraniční hosting a tedy zahraniční IP adresu serveru, napište na podporu DPD, aby Vám tuto IP adresu přidali na Whitelist.

Napojení na DPD SK

Slovenské napojení je dále rozdělené na připojení ke službě DPD Shipper nebo k dpdporta.sk. Nejprve je nutné povolit DPD SK.

DPD Shipper

Pro použití napojení na DPD Shipper, je nutné mít vytvořený účet u DPD Shipper (https://www.dpdshipper.sk/).

Po nainstalování a aktivaci pluginu pokračujte na jeho nastavení, které se nachází v sekci Toret plugins → DPD SK.

Pro napojení pluginu s DPD Shipper účtem je potřeba povolit API DPD SK, následně zvolit DPD Shipper a vyplnit API klíč, Portál e-mail,  ID adresy vyzvednutí, DelisID a ID bankovního účtu DPD. Údaje najdete ve svém DPD Shipper účtu, případně vám je zašle podpora DPD.

dpdportal.sk

Účet dpdportal.sk je původní možnost napojení dopravce DPD. Od ledna 2022 zavedlo na Slovensku DPD novou službu DPD Shipper včetně nového API, kterou dále rozvijí a byla jí nahrazena služba dpdportal.sk.

Pokud máte u dpdportal.sk účet, je možné jej také napojit v pluginu DPD. V prvním kroku vyberte API dpdportal.sk a poté vyplňte API klíč, Portál e-mail,  ID adresy vyzvednutí, DelisID a ID bankovního účtu DPD. Údaje najdete ve svém dpdportal.sk účtu, případně vám je zašle podpora DPD.

Hlavní nastavení

Kromě propojení s API na kartě hlavní nastavení dále nastavíte:

  • automatické načítání stavu zásilky
  • kontakt pro vyzvednutí balíčků (adresa, e-mail, telefon)
  • daně
  • údaje pro přijímání plateb na dobírku
  • automatické odeslání při změně stavu objednávky
  • ikony dopravních metod pro použití v pokladně
  • výchozí rozměry zásilky
  • zdroj směnných kurzů
  • validaci doručovací adresy
  • doplňková nastavení pro pokladnu a štítky

Automatické načítání stavu zásilky

Plugin obsahuje funkci automatického načítání stavu zásilky pomocí cronu. URL pro cron najdete na kartě Hlavní nastavení (Toret Plugins > DPD CZ/SK) a cron nastavíte na svém hostingu.

V pluginu pak lze nastavit počet zkontrolovaných objednávek na jeden běh cronu, počet dní pro zpětnou kontrolu a vyloučit stavy objednávek, které se kontrolovat nebudou.

Po nastavení cronu uvidíte aktuální stav zásilky v dopravě přímo ve WooCommerce administraci – v přehledu objednávek ve sloupci Stav DPD nebo v detailu objednávky v metaboxu DPD.

Nastavení dopravců v pluginu DPD

Karty pro nastavení jednotlivých dopravních metod najdete v pluginu (Toret Plugins > DPD CZ/SK) v horní části obrazovky.

DPD CZ

V pluginu DPD můžete pro české napojení nastavit dopravu:

  • Private (doručení na adresu)
  • Classic (doručení na firemní adresu)
  • DPD 10:00 (doručení do 10:00)
  • DPD 12:00 (doručení do 12:00)
  • DPD 18:00 (doručení do 18:00)
  • Pickup (doručení do výdejních míst)
  • Shop2Shop (doručení z výdejního místa na výdejní místo)
  • Shop2Home (doručení z výdejního místa na adresu)

KONTROLA ROZMĚRŮ A OBJEMU – DPD ve svém ceníku rozděluje zásilky podle hmotnosti a také zásilky limituje maximálními rozměry. V pluginu si u každého typu dopravy můžete zapnout nebo vypnout kontrolu hmotnosti a rozměrů. Pokud si kontrolou hmotnosti nebo rozměrů zapnete, je nutné mít u produktů tyto hodnoty vyplněné.

Pokud je ve WooCommerci nastaveno DPH, tak cenu v pluginu nastavujte bez DPH. 

DPD Private

Pod kartou Private je možné nastavit dopravu zásilek na adresu.

  • pro Českou republiku
  • Mezinárodní dopravu pro:  Slovensko, Belgii, Francii, Litvu, Lucembursko, Německo, Nizozemí, Polsko, Portugalsko, Rakousko, Španělsko, Švýcarsko, Velkou Británii, Rumunsko, Chorvatsko, Lotyšsko, Norsko, Slovinsko, Irsko, Estonsko, Itálii, Maďarsko, Švédsko, Finsko, Lichtenštejnsko.

Globálně lze pro tuto metodu nastavit:

  • maximální hmotnost zásilky
  • maximální rozměry zásilky

U České republiky je možné nastavit:

  • cenu dopravy dle hmotnosti, rozměrů nebo jednotně
  • doprava zdarma nad částku
  • maximální hmotnost a rozměry zásilky
  • dobírku, včetně příplatků a dobírky zdarma nad částku
  • výměnnou zásilku

U mezinárodní dopravy je možné nastavit:

  • cenu dopravy dle hmotnosti, rozměrů nebo jednotně
  • nejdelší stranu (plošné nastavení pro celou mezinárodní dopravu)
  • doprava zdarma nad částku
  • maximální hmotnost a rozměry zásilky
  • dobírku (pouze Slovensko a Polsko)
  • dobírka zdarma nad částku

Tip: pokud chcete v pokladně spustit dopravu nebo dobírku zdarma např. od 500, v pluginu nastavte 499.

Obdobné nastavení je k dispozici také pro dopravu DPD Classic, která slouží k dopravě na firemní adresy.

DPD 10:00, 12:00, 18:00

Na kartě DPD 10:00, 12:00 nebo 18:00 lze nastavit podmínky pro tyto dopravní metody, které garantují doručení do dané hodiny dalšího dne. Toto doručení je dostupné pro Českou republiku.

Lze nastavit následující možnosti:

  • cenu dopravy dle hmotnosti, rozměrů či jednotně
  • doprava zdarma nad částku
  • maximální hmotnost a rozměry zásilky
  • dobírku, včetně příplatků a dobírky zdarma nad částku
  • výměnnou zásilku

DPD Pickup

Dopravní službu Pickup je možné nastavit pro doručení na výdejní místa v České republice a 15 zemích Evropy.

Pro DPD Pickup je možné nastavit:

  • cenu dopravy dle hmotnosti, rozměrů nebo jednotně
  • doprava zdarma nad částku
  • maximální hmotnost a rozměry zásilky
  • dobírku, včetně příplatků a dobírky zdarma nad částku
  • výměnnou zásilku

Mezinárodní dopravu lze nastavit pro: Slovensko, Belgii, Estonsko, Francii, Litvu, Lotyšsko, Lucembursko, Německo, Nizozemí, Polsko, Portugalsko, Rakousko, Španělsko, Švýcarsko a Velkou Británii.

DPD Shop2Shop, Shop2Home

Dopravní metody Shop2Shop a Shop2Home slouží k odesílání zásilek z výdejního místa na výdejní místo nebo na adresu. Tyto dopravní metody jsou dostupné pro Česko, Slovensko a Polsko.

Pro DPD Shop2Shop a Shop2Home je možné nastavit:

  • cenu dopravy dle hmotnosti, rozměrů nebo jednotně
  • doprava zdarma nad částku
  • maximální hmotnost a rozměry zásilky
  • dobírku, včetně příplatků a dobírky zdarma nad částku
  • výměnnou zásilku

Nastavení dopravních zón

Po nastavení dopravců v pluginu DPD je potřeba nastavit také stejnojmenné dopravce v dopravních zónách WooCommerce. Bez jejich nastavení v zónách dopravy se dopravci z pluginu DPD v pokladně nezobrazí.

Podání zásilky z webu do DPD

Podání balíku vyžaduje uvést jeho hmotnost. Doporučujeme nastavit hmotnost na úrovni produktů – bez nastavené hmotnosti u produktů nebude fungovat automatické podání zásilek při změně stavu objednávky.

V pluginu máte dvě možnosti podání zásilky do systému DPD.

Manuální podání zásilky

Manuálně přes tlačítko v přehledu objednávek nebo v detailu objednávky

Automatické podání při změně stavu objednávky

Automatického podání lze nastavit v pluginu DPD → Hlavní nastavení. Data k zásilce budou při zvoleném stavu objednávky automaticky odeslána do systému DPD a také se automaticky objedná svoz na další pracovní den.

Objednání vyzvednutí balíku

Přes plugin je možné si objednat vyzvednutí balíku. Objednání svozu je možné provést dvěma způsoby.

Manuálně

V přehledu objednávek je u podaných objednávek do systému DPD ikona auta. Po kliknutí na ikonu se nad přehledem objednávek zobrazí box s možností výběru datumu, na kdy vyzvednutí balíku objednat.

Automaticky

Na kartě Hlavní nastavení v pluginu DPD je možné nastavit automatické objednání vyzvednutí zásilky na další den při vytvoření zásilky, viz Automatické podání při změně stavu objednávky.

Doprava zdarma

Dopravu zdarma nastavíte přímo v pluginu DPD u každé dopravní metody pro jednotlivé státy. 

Nastavení dopravy zdarma je „nad“ částku, tedy doprava zdarma se na webu aktivuje po překonání nastavení částky v košíku. Pokud máte ve WooCommerci nastavené DPH, tak se hodnota pro spuštění dopravy zdarma zadává bez DPH.

PŘÍKLAD: Pokud chcete dopravu zdarma od 500,- tak do pluginu nastavte částku 499.

Nastavení částky dopravy zdarma se vztahuje pouze pro produkty, nezapočítává se cena dopravy.

PŘÍKLAD: Pokud máte nastavenou dopravu zdarma od 500,- a v košíku je produkt za 450,- + cena dopravy 65,- = 515,- Kč, tak se doprava zdarma neaktivuje. Je potřeba překonat nastavenou cenu produktem, tedy aby se takto nastavená doprava zdarma aktivovala, je zapotřebí vložit do košíku produkt(y) hodnoty minimálně 500,- Kč.

Tisk štítků

Štítky podaných balíků je možné si stáhnout pouze v administraci webu. V systému DPD podané objednávky přes GeoAPI nenajdete.

V přehledu objednávek u již podané objednávky do systému DPD klikněte na ikonu dokumentu PDF (viz obrázek) u vybrané objednávky. Štítek se uloží ve formátu PDF a poté jej můžete vytisknout.

U podané zásilky je možné štítek také stáhnout v detailu objednávky.

Testování pluginu

Pro účely testování můžete využít:

  • subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web)
  • localhost (127.0.0.1)

Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání.

Přejít nahoru