Hlavní nastavení 5.x

Pro použití pluginu Zásilkovna, je nutné mít vytvořený účet u společnosti Zásilkovna. Po vytvoření účtu se můžete přihlásit pomocí tohoto formuláře.

Po přihlášení, klikněte v horní lište na vaše jméno.

Zobrazí se informace o vašem účtu a v pravé části najdete Heslo API, které budete potřebovat k implementaci.

Kromě API hesla budete ještě potřebovat zadat název eshopu, který jste zadali, při vytváření odesílatele.

Otevřete v levém menu sekci Informace o uživateli → Odesílatelé.

Hodnotu z pole označení vložte v pluginu Zásilkovna do pole NÁZEV ODESÍLATELE.

Upozornění! Hodnotu z pole Označení, musíte zkopírovat zcela přesně, i s diakritikou.

V případě, že označení obsahuje znak „&“, je potřeba  označení v administraci účtu Zásilkovny upravit tak, aby neobsahoval tento znak.

Pokud by označení obsahovalo znak &, tak by se nepodařilo pluginem odesílat do Zásilkovny objednávky z webu.

Implementační údaje Heslo API a Název odesílatele vložte do pole v nastavení pluginu a tlačítkem uložte.

V nastavení pluginu v části Základní nastavení Zásilkovny (Toret plugins → Zásilkovna → Hlavní nastavení → Základní nastavení Zásilkovny) si projdeme možnosti nastavení.

Můžete upřesnit, kdy se v případě nastavení dopravy zdarma bude tato doprava zobrazovat. V pluginu je ve výchozím stavu nastaveno „Zdarma budou všechny druhy dopravy“. Výběr záleží na tom, jaká si nastavíte kritéria prodeje, např. výše minimálního nákupu, atd.

Při dopravě zdarma máte možnost ponechat nebo zrušit příplatek za dobírku.

„Zaokrouhlení dobírky“ slouží k zaokrouhlení dobírkové částky posílané do Zásilkovny, protože do ní nelze poslat dobírku s desetinným místem. Zaokrouhlení dobírky si nastavte stejné jako zaokrouhlení u faktury!

Pokud chcete změnit výchozí ikonu výdejního místa, tak si musíte ikonu stáhnout z internetu, poté vložit do médii v administraci WordPresu a URL tohoto loga vložit do pole pro změnu ikony.

U zaškrtávacích políček zapínáte funkce:
Odesílat upozornění e-mailem o chybě vytvoření zásilky

Aktivovat reklamačního asistenta – vysvětlení viz. sekce v dokumentaci „Reklamační asistent“

Povolit pro Zásilkovnu navýšení hmotnosti na 20 a 30 Kg

Nastavovat cenu včetně DPH – ve výchozím stavu se v pluginu nastavují ceny bez DPH, bez ohledu na nastavení DPH ve WooCommerci. Po zaškrtnutí checkboxu můžete v puginu zadávat ceny včetně DPH.

Vypnout nastavení ceny podle váhy – zaškrtnutím vypnete box pro nastavení ceny podle váhy u všech dopravců.

Vypnout nastavení přípatku za dobírku podle ceny – zaškrtnutím vypnete box pro nastavení ceny dobírky podle celkové ceny objednávky u všech dopravců.

V pluginu je možné nastavit automatické odesílaní dat do Zásilkovny, tedy při změně stavu objednávky se podá zásilka do Zásilkovny. 

Nastavení automatického podání zásilek je pod kartou „Automatické odesílání“ v pluginu Zásilkovna. 

Nejprve je nutné povolit automatické odesílání pomocí checkboxu aktivovat a poté nastavit k jednotlivým platebním metodám stavy objednávek, při kterých se data do Zásilkovny odešlou. 

Poznámka: 

Pokud nebudou mít produkty nastavenou váhu, tak automatické podání fungovat nebude, protože před podáním bude plugin vyžadovat váhu zásilky. Jedná se ikonu vykřičníku v přehledu objednávek u takové objednávky, která nemá hodnotu váhy již z nastavení produktu.

Pokud se takový stav na webu vyskytl, tak je nutné k produktům doplnit váhu a plugin si již převezme váhu z objednávky, tedy se vykřičník pro doplnění váhy u nových objednávek nezobrazí. 

Pro správné fungování pluginu je nezbytné nastavit Dobírku z pluginu. Často bývá zákazníky v nastavení zaměněna s dobírkou z WooCommerce. To pak způsobuje, že se Dobírka do administrace Zásilkovny nepropíše.

Ve WooCommece → Nastavení → Pokladna budete mít na výběr dvě dobírky, ta z pluginu Zásilkovna se jmenuje „Dobírka – Platba na dobírku Umožňuje zákazníkům platit zboží při doručení (na dobírku).“
Rozdíl také poznáte v URL. Pokud rozkliknete v tomto nastavení dobírku z WooCommerce, tak na konci odkazu je =cod, dobírka z pluginu Zásilkovna má na konci odkazu =dobirka.

Nejprve nastavte cenu dobírky v pluginu Zásilkovna. Ta se zadává v nastavení cen u jednotlivých dopravců. (Toret plugins → Zásilkovna → karta státu „Česko“ → Příplatek za dobírku) a nastavení uložte.

Pokud zadáváte dobírku s desetinnými místy, je nutné používat desetinnou tečku (ne čárku). Například 1.69€

1. Nastavení ceny dobírky 

Zde si nastavíte globální cenu dobírky, cenu nastavujte vč. DPH.

2. Nastavení maximální výše dobírky

Zde si nastavíte maximální celkovou cenu v pokladně, pro kterou se dobírka bude zobrazovat, po překročení nastavené ceny, se dobírka v pokladně skryje. Cenu nastavujte vč. DPH.

2.1 Vypnutí dobírky pro jednotlivé dopravce

Pokud máte aktivovanou dobírku, ale nechcete ji mít v nabídce pro některého z nastaveným dopravců, tak u tohoto dopravce do pole „Nastavení maximální výše dobírky“ napište hodnotu 0 (nula).

3. Škálování ceny dobírky

Zde si nastavíte škálování ceny dobírky podle celkové ceny v pokladně. Pokud chcete aby byla cena dobírky zdarma od určité sumy, tak do pole příplatek napište 0 (nula) viz. screen. Cenu nastavujte vč. DPH.

Poté je nutné dobírku nastavit přímo ve WooCommerce (Woocommerce → Nastavení → Pokladna → Dobírka).

Otevře se nastavení dobírky, kde:

1. Zaškrtněte políčko povolit platbu na dobírku
2. V Titulku zadejte, jak se bude způsob dopravy jmenovat a zobrazovat
3. V popisu napište, jak bude platba popsána zákazníkovi a jak se zobrazí
4. Instrukce jsou důležitá informace pro zákazníka, která se zobrazí na Děkovné stránce i v potvrzovacím e-mailu
5. V poli Povolit způsob dopravy zadejte Zásilkovna nebo nechte pole prázdné = povoleno u všech
6. V poli Povolit pro země přidejte země, pro které chcete Zásilkovnu povolit nebo nechte prázdné = povoleno u všech
7. V poli Stav objednávky vyberte stav, ve kterém bude objednávka po jejím vytvoření při výběru platby na dobírku
8. Nakonec zaškrtněte políčko Započítat daň podle toho, jak máte daň nastavenou ve Woocommerci
9. Pro započítání příplatku dobírky při nastavení dopravy zdarma, zaškrtněte Zobrazit dobírku, pokud je cena zásilky 0. 
10. Nastavení uložte tlačítkem

Dobírka se bude zobrazovat při vytváření objednávky na Pokladně nebo po jejím dokončení na Děkovné stránce, v potvrzovacím e-mailu nebo v přehledu objednávek v Můj účet po přihlášení zákazníka na Vašem webu.

Pokladna

Děkovná stránka

Potvrzovací e-mail

Můj účet

Změna DPH příplatku dobírky

plugin je naprogramovaný aby, DPH příplatků se počítalo podle DPH produktů v košíku. Tedy pokud je v košíku jeden produkt s DPH 10%, tak DPH dobírky a dopravy bude také 10% (u dopravy také záleží na nastavení WooCommerce, zda máte fixní standardní sazbu, nebo nastavení DPH podle košíku). Pokud v košíku bude produkt s 10% a produkt s 21% započítá se k příplatků 21% DPH, takto byla funkce naprogramována po konzultaci s FÚ. Nicméně si můžete DPH dobírky fixně nastavit pomocí filtru zde:

Definice filtru:
$tax_class = apply_filters( ‚zasilkovna_taxclass_dobirka‘, $FeeData[‚tax_class‘] );

(includes/class-zasilkovna-fee.php ř.:89)

Příklad filtru:

add_filter( "zasilkovna_taxclass_dobirka","change_cost_zasilkovna_for_product", 10, 1 );

function change_fee_zasilkovna( $FeeData ){

}

Aby se filtr při další aktualizaci Zásilkovny nesmazal, je nutné jej vložit do child šablony nebo do prázdného pluginu ZDE.

Po odeslání zásilky do Zásilkovny se informace o zásilce uloží do eshopu a budou se zobrazovat u objednávky v administraci WordPressu a zároveň na portále Zásilkovna.

Nejprve si tedy ukážeme, jak vypadá zobrazení ve WooCommerce v administraci a jaké jsou zde důležité údaje. 

1 ID objednávky

Ve sloupci označeném „Objednávka“ je číslo objednávky, pod kterým se také zobrazí v Zásilkovně.

2 Trasovací číslo

Trasovací číslo je identifikační číslo objednávky, které jí bude vygenerováno po jejím odeslání do Zásilkovny (ať už automatickém či ručním). Pod tímto označení zásilky ji bude možné dohledat i v Zásilkovně.

Kliknutím na trasovací číslo dojde k přesměrování na na stránku na serveru Zásilkovny, kde bude zobrazen aktuální stav zásilky.

Obdobně fungují i odkazy na sledování, které jsou přidávány do emailů a detailu objednávek.

3 Zásilkovna

Podrobnější vysvětlení si zaslouží sloupec Zásilkovna, kde si můžete všimnout, že objednávky mají ve sloupci tlačítko s ikonou šipky dolů.

Tyto objednávky s ikonou mají trasovací číslo, znamená to, že zásilka byla v pořádku vytvořena a ikona se šipkou dolů slouží ke stažení pdf se štítkem.

Pokud objednávka nemá přiřazené trasovací číslo, znamená to, že zásilka nebyla odeslána do systému Zásilkovny a ikona se čtvercem a šipkou nahoru doprava slouží k manuálnímu odeslání do Zásilkovny.

Tato situace může nastat v případě, že nastala chyba při automatickém odesílání objednávky do systému Zásilkovna nebo pokud je stav objednávky pro odesílání do Zásilkovny jiný, než byl zvolen při nastavování pluginu. Z toho důvodu doporučujeme objednávky raději překontrolovat a případně odeslat ručně.

Vedle ikony šipky dolů je ikona osoby – reklamační asistent, po kliknutí na tuto ikonu vytvoříte a administraci Zásilkovny → Podané zásilky nově vytvořenou podanou zásilku reklamačního procesu. Ikona osoby se změní na ikonu široké šipky, kliknutím na tuto šipku stáhnete štítek k reklamačnímu procesu.

4 Stav Zásilkovny

V tomto sloupci vidíte v jakém stavu se nachází zásilka u společnosti Zásilkovna. Pokud chcete vidět aktuální stav zásilky, tak je nutné nastavit CRON, který najdete v hlavním nastavení pluginu → Automatické načítání stavu zásilky.

Po nastavení CRONu se budou aktualizovat stavy zásilek u všech objednávek, které jsou ve stavu „Čeká na platbu“, „Čeká na vyřízení“ a „Zpracovává se“. Běh jednoho CRONU aktualizuje stav balíku dvaceti objednávek, aktualizace probíhá od nejstarších po nejnovější objednávky.

Funkce je primárně určena na změnu stavu objednávky při změně stavu balíku, proto není ve funkci defaultně nastaven stav „Dokončeno“. Pokud by funkce obsahovala stav „Dokončeno“ a na webu by bylo tisíce objednávek, tak by se naskytl problém v tom, že jeden běh CRONu aktualizuje stavy dvaceti objednávek a trvalo by nesmyslně dlouho, než by se aktualizovaly všechny objednávky.

Pokud si chcete do funkce přidat další stavy objednávek, které budou kontrolovány, tak si tuto funkci můžete upravit pomocí filtru:

apply_filters( 'zasilkovna_status_cron_order_status',array('wc-pending', 'wc-processing', 'wc-on-hold'))

Pokud si chcete upravit počet objednávek na jeden běh CRONu, tak si tuto funkci můžete upravit pomocí filtru:

'limit' => apply_filters( 'zasilkovna_status_cron_limit', 20 )

Zásilky v systému Zásilkovny

V administraci Zásilkovny → Podané zásilky jsou uvedeny všechny podané zásilky, včetně zásilek z reklamačního asistenta. Ve sloupci Objednávka, Trasovací číslo a Stav se shodují informace  z objednávek z WooCommerce.

TPomocí pluginu si můžete vypnout vybrané dopravce pro vybraný produkt, variantu nebo kategorii.

Vypnutí dopravce na úrovni produktu:

Nastavení najdete při úpravě produktu v boxu Data produktu a záložce Zásilkovna.

Vypnutí dopravce na úrovni varianty:

Pro každou varinatu zvlášť je možné vypnout jednotlivé dopravce z pluginu Zásilkovnu. Jejich možnost vypnutí najdete v nastavení varianty.

Vypnutí dopravce na úrovni kategorie:

Také pro každou kategorii můžete vypnout dopravce z pluginu Zásilkovna. Vypnutí můžete provést jak při vytvoření nové kategorie, tak v úpravě již vytvořené kategorie.

!!!Pokud se objednávka skládá z více produktů a alespoň jeden produkt má nastavené toto omezení, tak vybraný dopravce není pro objednávku dostupný.

V případě, že používáte ruční odeslání objednávky do Zásilkovny a objednávka obsahuje produkty, které nemají nastavenou váhu, můžete zadat váhu balíku.

Pokud máte nějakou objednávku k ručnímu odeslání do Zásilkovny a není u ní uvedena váha, zobrazí se ve sloupci Zásilkovna tlačítko s ikonou vykřičníku.

Po kliknunutí na tlačítko se zobrazí formulář pro zadání váhy objednávky.

Jednotka hmotnosti pro zadávání váhy balíku se automaticky nastavuje podle nastavení ve WooCommerce.

Po zadání hmotnosti a kliknutí na Uložit se zobrazí standardní tlačítko pro odeslání zásilky.

Nechcete zadávat hmotnost přes vykřičník před odesláním zásilky?

Pokud nechcete zadávat hmotnost váhy před odesláním, tak je nutné, aby všechny produkty měly nastvenou hmotnost. Poté si plugin převezeme hmotnost produktů z objednávky a vykřičník se nezobrazí

V přehledu objednávek ve sloupci Status Zásilkovny je uvedeno v jakém stavu se zásilka nachází. Pokud chcete vidět aktuální stav zásilky, tak je nutné nastavit CRON, který najdete v hlavním nastavení pluginu → Automatické načítání stavu zásilky.

Po nastavení CRONu se budou aktualizovat stavy zásilek u všech objednávek, které jsou ve stavu „Čeká na platbu“, „Čeká na vyřízení“ a „Zpracovává se“. Běh jednoho CRONU aktualizuje stav balíku dvaceti objednávek, aktualizace probíhá od nejstarších po nejnovější objednávky.

Funkce je primárně určena na změnu stavu objednávky při změně stavu balíku, proto není ve funkci defaultně nastaven stav „Dokončeno“. Pokud by funkce obsahovala stav „Dokončeno“ a na webu by bylo tisíce objednávek, tak by se naskytl problém v tom, že jeden běh CRONu aktualizuje stavy dvaceti objednávek a trvalo by nesmyslně dlouho, než by se aktualizovaly všechny objednávky.

Pokud si chcete do funkce přidat další stavy objednávek (vlastní nebo z WooCommerce), které budou kontrolovány, tak si tuto funkci můžete upravit pomocí filtru. Je nutné vypsat všechny stavy, které chcete funkcí kontrolovat, pokud tedy chcete kromě vlastních stavů kontrolovat také stavy WooCommerce, tak je nutné do filtru vypsat také je.

Definice filtru:
apply_filters( 'zasilkovna_status_cron_order_status',array('wc-pending', 'wc-processing', 'wc-on-hold'))

Příklad filtru:
add_filter( 'zasilkovna_status_cron_order_status', 'zasilkovna_pridat_vlastni_stavy_objednavky',10,1);

function zasilkovna_pridat_vlastni_stavy_objednavky() {

return array(

‚wc-pending‘,

‚wc-processing‘,

‚wc-on-hold‘,

‚wc-odeslano-dobirk‘,

‚wc-zaplaceno-dobir‘,

‚wc-odeslano-zaplac‘

);

}

*Jedná se pouze o příklad filtru pro vlastní stavy, pokud budete filtr programovat, je nutné dodržet slug vlastních stavů, které používáte.

Pokud si chcete upravit počet objednávek na jeden běh CRONu, tak si tuto funkci můžete upravit pomocí filtru.

Definice filtru:

'limit' => apply_filters( 'zasilkovna_status_cron_limit', 20 )

Příklad filtru:

add_filter('zasilkovna_status_cron_limit', 'zasilkovna_status_cron_limit_fce', 10, 1);

}

počet objednávek, které funkce zkontroluje upravíte ve filtru u hodnoty „return 5;“. Nicméně nedoporučujeme nastavovat kontrolu velkého počtu objednávek na jeden běh CRONU, pokud budete dotazy příliš zatěžovat servery Zásilkovny, tak Vás může Zásilkovna dočasně od této funkce odstřihnout.