Dokumentace pluginu Toret DPD

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

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). Na kartě Hlavní nastavení vložte do příslušného pole licenční klíč a ověřte licenci.

Napojení na DPD

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

DPD poskytovatel

V sekci DPD poskytovatel (Toret Plugins > DPD > DPD poskytovatel) vyberte, zda chcete e-shop napojit na DPD Czech Republic nebo DPD Slovakia.

Pozor! Dostupné funkce pluginu se mohou lišit podle toho, zda využíváte DPD CZ či DPD SK. Jedná se o rozdílné API, jejichž podpora jednotlivých funkcí a služeb je rozdílná.

DPD CZ

Pro použití napojení na DPD CZ je nutné mít vytvořený DPD účet pro GeoAPI (starší) nebo DPD Shipping (doporučujeme). 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.

Pro napojení pluginu s DPD GeoAPI/Shipping účtem je potřeba:

1. Zvolit API, ke které máte přístupy
2. Vyplnit přístupové údaje, které jste získali od dopravce DPD
3. Uložit

Pozor! 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.

* Funkce Povolit zápis API volání do DPD logu slouží pro testování a řešení problémů.

DPD SK – Shipper

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

Pro napojení pluginu s DPD Shipper účtem je potřeba:

1. Vyplnit přístupové údaje. Údaje najdete ve svém DPD Shipper účtu, případně vám je zašle podpora DPD.
2. Uložit

Hlavní nastavení

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

Kontakt pro vyzvednutí balíčků (pouze DPD CZ)

Umožňuje zadat kontaktní telefon, e-mail a jméno osoby pro komunikaci ohledně svozu balíčků.

Kontakt pro vrácení balíčků (pouze DPD CZ)

Umožňuje vytvářet návratové zásilky a zadat adresu, na kterou budou doručeny.

Nastavení dobírky (pouze DPD CZ)

Umožňuje zadat číslo účtu, kód banky a název účtu a banky pro vyplácení doběrečného. Pokud chcete použít výchozí hodnoty z účtu DPD, není třeba vyplňovat.

Validace adresy (pouze DPD CZ)

Umožňuje zakázat validaci nebo naopak zobrazit chybovou zprávu, pokud je zadané neplatné PSČ a země doručení. Zobrazenou info hlášku lze nastavit vlastní.

Informace o skrytém odesílateli (maskovaná adresa) (pouze DPD CZ)

Umožňuje nastavit adresu, která se zobrazní na štítku jako odesílací. Tato adresa může být odlišná od skutečného místa odeslání.

Vícenásobné zásilky (pouze DPD CZ)

Umožňuje nastavit automatické rozdělení zásilek do více kusů na základě zadaného prahu hmotnosti.

Štítek zásilky – formát

Zde můžete zvolit formát štítku – A4 nebo A6.

Poplatky a daně

V této sekci lze zvolit nastavení sazeb (s DPH nebo bez DPH), daňovou třídu dobírky a skrytí poplatku za dobírku, pokud je zdarma.

Tip: Pokud aktivujete funkci Nastavení sazeb s DPH, ceny zadávejte včetně DPH.

TIP2: Daňová sazba pro dobírku je pro ČR doporučována určovat podle položek v košíku.

Nastavení ikon v pokladně

V této sekci je možné zapnout zobrazení ikon u způsobů dopravy a u tlačítka pro otevření widgetu a také je nastylovat vlastním css.

TIP: Plugin obsahuje přednastavená loga dopravce. Pokud chcete nastavit ikony vlastní, můžete tak provést v nastavení konkrétních způsobů dopravy (viz dále)

Výchozí parametry balíčku

Zde nastavíte výchozí reference, rozměry a hmotnost balíčku, včetně použitých jednotek. Tyto výchozí hodnoty se použijí, pokud nejsou k dispozici údaje pro všechny produkty v objednávce.

Funkce Ignorovat rozměry produktu a použít výchozí hodnoty při odesílání balíčku použije zde zadané výchozí parametry i v případě, že jsou u produktů hodnoty uvedené.

Pro reference balíčku, které se také zobrazují na štítku, lze použít vlastní text či proměnné:

• {order_id}
• {order_number}
• {product_ids}
• {qty_product_ids}
• {qty_product_sku}
• {customer_note}
• {meta_key}

Nastavení widgetu s mapou

V sekci Widget pro místo vyzvednutí lze nastavit:

• Použít adresu výdejního místa jako dodací adresu – zákazník nemusí vyplňovat svou adresu při doručení na výdejní místo
• Automaticky zobrazit mapu s výběrem výdejního místa při výběru dopravy – automaticky otevře mapu při volbě dopravy na výdejní místo. Tlačítko pro otevření zůstává zachováno pro případnou změnu.
• Umístění tlačítka widgetu pro výběr poboček – tlačítko lze umístit ihned pod dopravu na výdejní místo nebo až na konec seznamu doprav.
• Widget pro výběr pobočky – pro DPD CZ je k dispozici widget DPD CZ, pro DPD SK lze vybrat mezi widgetem DPD CZ a DPD SK (vyžaduje Widget API klíč)
• Zakázat všechny boxy při výběru výdejního místa – při výběru výdejního místa nenabídne ve widgetu boxy.

TIP: Doručení do boxu můžete zakázat také pouze pro konkrétní produkty – v detailu produktu. Viz dále

ID bankovního účtu DPD dle země odeslání (pouze DPD SK)

Funkce umožňuje nastavit ID bankovních účtů, které máte zadané ve svém DPD účtu, pro platbu dobírky zákazníky z různých zemí.

Sobotní doručení (pouze DPD SK)

Aktivuje funkci soborní doručení pro DPD Home a DPD Classic. Zákazník v pokladně uvidí zaškrtávací pole pro výběr sobotního doručení, které můžete dle libosti otextovat a nastavit příplatek.

Nastavení způsobů dopravy v pluginu DPD

Nastavení jednotlivých způsobů dopravy najdete v administraci pluginu, v sekci Způsoby dopravy (Toret Plugins > DPD > Způsoby dopravy).

Ve sloupci Země (1) si vyberte zemi, pro kterou chcete dopravu DPD nastavit. Ve sloupci Aktivní dopravci (2) se zobrazují již nastavené způsoby dopravy. Do samotného nastavení se prokliknete tlačítkem s tužkou ve sloupci Akce (3).

V sekci Globální nastavení (4) lze nastavit hodnoty, které se použijí pro všechny země, které je nemají vyplněné. Nastavení pro konkrétní země je těmto hodnotám nadřazené. Jde o:

• aktivaci kontroly rozměrů a hmotnosti
• rozměrové a hmotností limity zásilek (při překročení limitu se v pokladně daná doprava nenabídne)

Pozor! Pokud si kontrolou hmotnosti nebo rozměrů zapnete, je nutné mít u produktů tyto hodnoty vyplněné.

V pluginu DPD můžete pro DPD CZ 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)

Pro DPD SK jsou k dispozici:

• DPD SK Home (doručení na adresu)
• DPD SK Pickup (doručení na výdejní místo)
• DPD SK Classic (doručení na firemní adresu)
• DPD SK 10:00 (doručení do 10:00)
• DPD SK 12:00 (doručení do 12:00)
• DPD SK 18:00 (doručení do 18:00)

Aktivace

Na stránce Způsoby dopravy rozklikněte nastavení u požadované země (sloupec Akce) a v bočním panelu vyberte způsob dopravy, který chcete nastavovat (1). V bočním panelu najdete vždy jen ty způsoby dopravy, které jsou pro danou zemi k dispozici.

Každý ze způsobů dopravy je nutné nejprve aktivovat (2)

Nastavení ikony

Zde můžete nahrát ikonu, která se u daného způsobu dopravy zobrazí v pokladně.

Nastavení hmotnostních a rozměrových limitů

Pokud zadáte maximální hmotnost a rozměry, při jejich překročení se v pokladně daný způsob dopravy nenabídne. Aby to bylo možné, je nutné mít u produktů tyto hodnoty vyplněné.

Nastavení ceny a dopravy zdarma

V sekci ceny nastavíte:

• Doprava zdarma nad částku: Zde zadejte hodnotu objednávky, při jejímž dosažení bude způsob dopravy zdarma. Cena dopravy se do hodnoty objednávky nezapočítává.
• Typ výpočtu ceny dopravy: Cenu dopravy je možné nastavit jednotně nebo škálovat dle hmotnosti nebo rozměrů objednávky.

Pravidla pro škálování ceny nastavíte kliknutím na tlačítko Přidat hmotnost/rozměr

Nastavení dobírky

Dobírku pro daný způsob dopravy je třeba aktivovat checkboxem Povolit dobírku. Následně je možné nastavit:

• Zdarma od: zadejte částku, při jejímž dosažení bude dobírka bez příplatku (Do částky se nezapočítává cena dopravy ani dobírky)
• Typ kalkulace poplatku: Lze zvolit jednotnou sazbu (Jednotná cena) nebo sazbu škálovat dle ceny objednávky (Celková cena).

Pravidla pro škálování ceny nastavíte kliknutím na tlačítko Přidat příplatek.

Výměnná zásilka – SWAP

Pro některé ze způsobů dopravy/země je k dispozici výměnná zásilka. Ta umožňuje, aby si zákazník v pokladně přiobjednal zpětnou zásilku.

Funkci je třeba aktivovat zaškrtnutím checkboxu. Následně je možné zadat text, který se zákazníkům zobrazí u checkboxu v pokladně, text poplatku a cenu.

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í.

Dopravní metodu nastavte ve WooCommerce > Nastavení > Doprava > požadovaná zóna dopravy > Přidat způsob dopravy.

Vyberte z nabízených způsobů dopravy a klikněte na Pokračovat.

V dalším kroku zvolte Titulek a Popisek dopravní metody a Stav daně (Zdanitelný nebo Žádný). Klikněte na Vytvořte a uložte. Nový způsob dopravy je vytvořen.

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 ani kontrola hmotnosti.

Pokud nemáte uvedenou hmotnost u produktů, je možné ji doplnit při manuálním podání ve vyskakovacím okně.

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

Manuální podání zásilky

Manuálně jde podat balík přes tlačítko v přehledu objednávek nebo v detailu objednávky.

V následném dialogovém okně lze upřesnit další vlastnosti balíku (rozměry, reference) i objednat svoz. Volbu Bez vyzvednutí aktivujte, pokud zásilku fyzicky odnesete na sběrné místo sami (bez svozu kurýrem).

Hromadné podání

Z přehledu objednávek je možné podávat zásilky hromadnou akcí „Odeslat na DPD“.

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

Při automatickém podání dojde k podání při vámi zvolené změně stavu objednávky. Např. změníte stav objednávky na Zpracovává se. Balík bude automaticky podán do systému DPD.

Automatické podání lze nastavit v administraci pluginu DPD → Automatické odesílání. Pro jednotlivé způsoby platby nastavte stavy objednávek, při kterých dojde k podání (1). Můžete také zvolit, zda se automaticky objedná svoz na další pracovní den. (2)

Objednání vyzvednutí balíku

Přes plugin je možné si objednat vyzvednutí balíku. Objednání svozu je možné již v dialogovém okně při manuálním podání balíku nebo později.

Volbu Bez vyzvednutí aktivujte, pokud zásilku fyzicky odnesete na sběrné místo sami (bez svozu kurýrem).

Manuálně

Pokud neobjednáte svoz při podání, v přehledu objednávek je u podaných objednávek do systému DPD ikona auta. Po kliknutí na ikonu se zobrazí vyskakovací okno s možností výběru data, na kdy vyzvednutí balíku objednat. Přidat zde můžete také referenci k balíku.

Volbu Bez vyzvednutí aktivujte, pokud zásilku fyzicky odnesete na sběrné místo sami (bez svozu kurýrem).

Automaticky

Svoz je možné také objednávat automaticky při podání zásilky. Automatické objednání svozu nastavíte v sekci Automatické odesílání, viz Automatické podání při změně stavu objednávky.

Stav a zrušení svozu

Stav objednání svozu uvidíte v přehledu objednávek ve sloupci DPD svoz (a). Zrušit objednaný svoz je možné kliknutím na tlačítko s křížkem (b) nebo hromadnou akcí.

Také v přehledu objednávek zjistíte datum svozu – v metaboxu DPD.

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 API nenajdete.

V přehledu objednávek u již podané zásilky 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.

Využít můžete také hromadný tisk štítků pomocí hromadné akce v přehledu objednávek.

Formát štítku a reference lze nastavit jako výchozí v Hlavním nastavení pluginu (Toret Plugins > DPD > Hlavní nastavení) nebo jednotlivě v dialogových oknech při manuálním vytváření zásilky (reference) a tisku (formát a pozice tisku).

Sledování zásilek

Sledování zásilek je možné více způsoby:

Prokliknutí do systému DPD

Klikutím na ikonu lupy v přehledu nebo detailu objednávky se dostanete na stránku pro sledování dané zásilky v systému DPD

Načtení stavu zásilky z DPD a jeho zobrazení v administraci

Stav zásilky je možné načítat manuálně kliknutím na ikonu s kruhovou šipkou v přehledu či detailu objednávky nebo nastavit automatické načítání stavu (viz dále). Stav zásilky pak uvidíte ve sloupci Stav DPD nebo v metaboxu v detailu objednávky.

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ě Sledování (Toret Plugins > DPD > Sledování) 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.

Sledovací e-mail pro zákazníky

Odkazy ke sledování zásilky se automaticky přidávají do WooCommerce e-mailů pro zákazníky. Odkaz se přidává pouze u již podaných zásilek. Tzn. pokud podáte balík ve stavu Zpracovává se, odkaz se zobrazí v e-mailu ke stavu zásilky Zpracovává se. V dřívějších e-mailech ne.

Informace o vybrané pobočce doručení se také automaticky zobrazí ve WooCommerce e-mailech o objednávce, a to i u dosud nepodaných zásilek.

Změna stavu objednávky na základě stavu zásilky v přepravě

Na kartě Sledování lze dále nastavit změnu stavu objednávky podle stavu zásilky u přepravce. Funkci aktivujte a pro dané stavy DPD jednoduše přiřaďte stavy objednávek ve WooCommerce. Provedené změny uložte.

Např. Při úspěšném doručení zásilky DPD se stav objednávky změní na Dokončeno.

Doprava zdarma

Dopravu zdarma nastavíte přímo v pluginu DPD u každého způsobu dopravy pro jednotlivé státy (Toret plugins > DPD > Způsoby dopravy > Země (např. Česko) > Způsob dopravy (např. DPD Private) > Ceny) – viz Nastavení ceny a dopravy zdarma

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č.