Dokumentace pluginu Toret Česká pošta

Nacházíte se na stránkách dokumentace pluginu WooCommerce Česká pošta, který  implementuje tuto službu dopravy do e-shopu.

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 Toret Česká pošta (Toret Plugins > Česká pošta), do příslušného pole vložíte licenční klíč a tlačítkem Ověřit aktivujte.

Napojení na Českou poštu

Po nainstalovaní a aktivaci pluginu pokračujte na jeho nastavení (Toret plugins > Česká pošta).

Pro propojení pluginu s API B2BZasilka České pošty je nutné do pluginu vložit implementační údaje. Tyto údaje získáte od obchodního zástupce České pošty (příp. v aplikaci Podání Online, viz dále) Seznam obchodních zástupců najdete zde.

Implementační údaje lze zjistit také v aplikaci Podání Online (po předchozím schválení obchodním zástupcem):

API token a Tajný klíč (Privátní klíč): postaonline.cz > Služby pro firmy > Správa B2B profilu

Technologické číslo: Podání Online > Nastavení > Technologická čísla

Podací pošta: Podání Online > Nastavení > Podací pošty

ID smlouvy (ID CČK): Číslo najdete v pravém horním rohu v Podání Online (v závorce za jménem účtu)

Číslo podacího místa: Po kliknutí na Stáhnout místa vyzvednutí (v pluginu) se zobrazí nabídka vašich podacích míst. Čísla PM lze také zjistit v Podání Online > Nastavení > Odesílatel.

Pokud zde nemáte k dispozici žádná podací místa, je třeba založit nové.

Založení podacího místa

Pokud v Podání Online, v sekci Odesílatel nemáte k dispozici podací místo, je třeba podací místo založit. V pravém rohu klikněte na tlačítko Nový odesílatel.

Nyní se nacházíte na stránce s formulářem, který je třeba vyplnit:

• Vyplňte pole v sekci Odesílatel a Adresa odesílatele.
• Sekci Adresa adresáta dobírkové částky nemusíte vyplňovat, pokud budete chtít vyplácet dobírku pouze bezhotovostně.
• Sekci Adresát dobírkové částky vyplňujete pouze, pokud chcete využívat službu Du (Dobírka). Pro využití služby 41 (Reklamace výplaty dobírkové částky) jsou třeba dodatečné kroky na straně Balíkovny (nutné kontaktovat obchodního zástupce).
• Uložte.

Nyní máte v sekci Odesílatel k dispozici podací místo a jeho číslo.

Nastavení pluginu Česká pošta

V pluginu Toret Česká pošta můžete nastavit využívat tyto způsoby dopravy:

• Balíkovna
• Balíkovna – Na adresu
• Balík Na poštu
• Balík Do ruky
• Cenný balík
• EMS (expresní doručování)
• Doporučený balíček
• Standardní balík do zahraničí
• Cenné psaní
• Firemní psaní
• Obyčejné psaní
• Doporučené psaní
• Doporučené psaní – Ekonomické
• Obyčejný balík
• Balík Nadrozměr

Jednotlivé dopravní metody najdete v pluginu (Toret Plugins > Česká pošta) v horní navigační liště.

Nastavení sazeb DPH

Pokud je ve WooCommerci nastaveno DPH, cenu v pluginu nastavujte bez DPH. Nastavení cen s/bez DPH najdete v Hlavním nastavení pluginu (Toret plugins > Česká pošta).

Hlavní nastavení

V Hlavním nastavení lze dále nastavit:

• výchozí vlastnosti balíčku (hmotnost, rozměry, datum podání)
• výchozí vlastnosti štítku (pozice štítku, ID formuláře pro tisk)
• nastavení automatického vytváření balíčku při změně stavu objednávky
• použití adresy výdejního místa jako dodací adresy
• automatické otevírání widgetu s mapou
• umístění tlačítka pro otevření widgetu (pod danou dopravní metodou nebo až na konci seznamu doprav)
• povolení Garantovaného doručení v sobotu
• vlastní ikony pro platební metody v pokladně
• nastavení automatického načítání stavu zásilky

Možnosti nastavení doprav

Pod jednotlivými kartami doprav (v horní liště) lze nastavit následující možnosti:

• povolené země pro doručení (v případě, že lze metodu použít pro doručení mimo ČR)
• ID formuláře štítků
• podmínění dostupnosti dopravy (dle hodnoty objednávky, množství a ceny produktů nebo hmotnosti košíku)
• cenu dopravy (jednotnou či škálovanou dle hmotnosti, rozměrů nebo hodnoty objednávky)
• dopravu zdarma nad částku
• maximální hmotnost, maximální rozměr, limit počtu produktů nebo ceny
• dobírku, její typ a příplatek za dobírku (jednotný nebo škálovaný dle hodnoty objednávky)
• dobírku zdarma nad částku

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

Pobočky

Doprava Balíkovna a Balík Na poštu vyžadují v pokladně výběr pobočky zákazníkem. Plugin obsahuje Widget České pošty, ve kterém jsou vždy pobočky aktuální a není potřeba je pravidelně je aktualizovat. 

Nastavení dopravních zón

Po nastavení dopravců v pluginu Toret Česká pošta 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 Česká pošta v pokladně nezobrazí.

Správa zásilek

Díky napojení na API České pošty je možné zásilky kompletně spravovat z administrace e-shopu.

Vytvoření balíčku

Vytvoření balíčku, resp. odeslání dat o zásilce do systému České pošty, lze provést:

Manuálně z přehledu či detailu objednávky

Pro manuální odeslání stačí kliknout na ikonu ve sloupci Česká pošta v přehledu objednávek.

V detailu objednávky najdete tlačítko v pro vytvoření v metaboxu Česká pošta.

Hromadně z přehledu objednávek

Plugin podporuje také hromadné akce v přehledu objednávek. Vytvořit balíček tak můžete i pro více zásilek najednou.

Automaticky na základě změny stavu objednávky

Vytváření balíčků lze automatizovat na základě změny stavu objednávky. Toto automatické vytváření nastavíte v hlavním nastavení pluginu (Toret plugins > Česká pošta), v sekci Vytvoření balíčku při změně stavu objednávky.

Zde pro jednotlivé metody platby nastavíte, v jakém stavu objednávky bude balíček vytvořen a data odeslána do systému České pošty.

Tisk štítků

U zásilek, u kterých byl již balíček vytvořen, je možné stáhnout štítky ve formátu PDF a vytisknout je. To můžete udělat z přehledu (jednotlivě či hromadně) nebo z detailu objednávky.

Z přehledu objednávek

Pro stažení štítku použijte ikonu PDF souboru ve sloupci Česká pošta nebo hromadné akce.

Z detailu objednávky

V detailu objednávky najdete tlačítko pro tisk štítků v metaboxu Česká pošta.

Nastavení štítků

Nastavení pozice štítku pro tisk a ID formuláře pro tisk štítku lze znovu nastavovat při každém stažení štítků ve vyskakovacím okně, nebo lze vyskakovací okno vypnout a nastavit výchozí hodnoty v nastavení pluginu (Toret plugins > Česká pošta).

ID formuláře štítku pak lze nastavit ještě pro každou dopravní metodu zvlášť v nastavení dopravy (např. Toret plugins > Česká pošta > Balíkovna).

Tabulku, která určuje, které ID formuláře lze použít pro konkrétní způsoby doručení, najdete zde.

Sledování zásilky

Plugin umožňuje sledování stavu zásilky v přepravě.

V přehledu objednávek

V přehledu objednávek najdete ve sloupci Česká pošta ikonu lupy, která vás přesměruje do systému České pošty na sledování dané zásilky. Ikona kruhové šipky načte stav zásilky v přepravě, který následně uvidíte ve sloupci Česká pošta stav. Pro načtení stavu zásilek lze využít také hromadné akce.

V detailu objednávky

Stav zásilky v přepravě lze zjistit také v detailu objednávky. Opět se můžete prokliknout přímo do systému pošty nebo manuálně aktualizovat stav, který se zobrazí přímo v metaboxu Česká pošta.

Automatické načítání stavu objednávky pomocí CRONu

Stav zásilek v přepravě lze také automaticky načítat pomocí CRONU. Najdete jej v hlavním nastavení pluginu (Toret plugins > Česká pošta), v sekci Automatické načtení stavu zásilky.

CRON je nutné nastavit na vašem hostingu, a to včetně požadovaného intervalu jeho spouštění. V nastavení pluginu určíte, kolik objednávek se bude kontrolovat za běh CRONu, kolik dní zpětně a jaké stavy objednávek se kontrolovat nebudou.

Odkaz pro zákazníky

Odkaz na sledování zásilky se automaticky přidává do e-mailu o objednávce pro zákazníky.

Export zásilek do účtu České pošty

Pokud nechcete využívat napojení přes API České pošty, je možné manuální podání zásilek do systému prostřednictvím exportu CSV souboru a následného importu do vašeho účtu u České pošty. V pluginu vytvoříte soubor CSV s daty o zásilkách, který jednoduše nahrajete v aplikaci Pošta Online České pošty.

Na kartě „Nastavení exportu“ je nutné nejprve nastavit, jaké hodnoty z objednávky se mají zapsat do souboru csv.

Poté na kartě „Export“ je nutné vybrat objednávky, které se mají zapsat do souboru csv. Po kliknutí na tlačítko „Export“ se do počítače stáhne soubor s daty objednávek. Ten následně nahrajete ve vašem účtu u České pošty.

Doprava zdarma

Dopravu zdarma nastavíte přímo v pluginu Česká pošta u každého dopravce (sekce Ceny).

Nastavení pluginu dopravy zdarma je „nad“ částku, tedy doprava zdarma se na webu aktivuje po překonání nastavení částky v košíku.

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

Tip: Pokud máte ve WooCommerci nastavené DPH, tak se hodnota pro spuštění dopravy zdarma zadává bez DPH.

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

DPH příplatku dobírky

Plugin je naprogramovaný tak, aby se DPH příplatků 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:

/*** Vlastní třída daně pro výpočet ceny dobírky **/
add_filter('tcp_taxclass_dobirka', 'custom_taxclass_dobirka');
function custom_taxclass_dobirka($tax_class){
return 'nulova-sazba'; // slug daně
}

Do filtru dosadíte slug daňové třídy, kterou chcete pro příplatek dobírky použít. Slug najdete v URL daňové třídy, pokud jste v jejím nastavení. Je uveden za selection=

Např. https://ceskaposta.toret.dev/wp-admin/admin.php?page=wc-settings&tab=tax&section=nulova-sazba

Aby se filtr při další aktualizaci pluginu Česká pošta nesmazal, je nutné jej vložit do child šablony nebo do prázdného pluginu např. https://toret.cz/produkt/boilerplate/.