Dokumentace

Instalace pluginu

Instalace pluginu probíhá stejně, jako u jiného WordPress pluginu, kdy v sekci pluginy, kliknete na Instalace pluginů, vyberete možnost nahrát plugin a nahrajete zip soubor, který jste si stáhli po dokončení objednávky.

Nastavení pluginu

Po instalaci pluginu, se v bočním menu objeví nová položka – ePodací Hárok. Tam najdete kompletní nastavení pluginu a navíc logování všech odeslaných a přijatých dat.

Nastavení účtu

V nastavení pluginu najdete tabulku, obsahující položky, které je třeba vyplnit.

Nastavení účtu obsahuje:

  • WSDL url
  • User id
  • API key

Údaje získáte z administrace ePodacího Hároku, viz. obrázky

1. V pravém hormín roku administrace ePodacího Hároku klikněte na ikonu postavy.

2. Klikněte na tlačítko Nastavenia

3. Aktivujte WebEPH API

4. Zkopírujte údaje a uložte je v nastavení pluginu

 

Nastavení odesílatele

Odesílatel jste vy. Vyplňte tedy v nastavení pluginu údaje vašeho e-shopu. 

  • jméno
  • organizace
  • ulice
  • město
  • psč
  • země
  • telefon
  • email
  • číslo účtu

Nastavení adresy pro vrácení

V případě nevyzvednutí zásilky, využije Slovenská poštu tuto nastavenou adresu, pro vrácení zásilky. Pro správné fungování musíte vyplnit i toto nastavení.

  • jméno
  • organizace
  • ulice
  • město
  • psč
  • země
  • telefon
  • emil

Nastavení zpracování

Následující nastavení určuje, jakou službu a jakým způsobem budete využívat. 

Všechny údaje můžete nastavit podle číselníků, které Slovenská Pošta má a pokud nebudete vědět, co jaká položk znamená, zástupce Slovenké Pošty vám pomůže vybrat správné hodnoty. 

 

Dopravy a platby

Přiřazení dobírky – toto nastavení určuje, jakou platební metodu budete používat pro identifikaci dobírkovného. Pošta totiž musí vědět, že jde o dobríku a peníze pro vás vybrat.

Dopravní metody – na e-shopu můžete mít více dopravních metod, ne jenom Slovenskou poštu. Proto je třeba určit, kterých doprav se odesílání týká. Do pole přidejte názvy dopravních metod, tak jak je máte nastavené v dopravních zónách a oddělte je čárkou.

Přiřazení doprav

Do Hároku musíte posílat zásilky s označením – Balíček, List, atd. Protože plugin musí vědět, jaký typ dopravy má připřadit dopravě v e-shopu, musíte v nastavení pluginu spárovat dopravy Hároku s dopravami e-shopu. 

Do nastavení se vkládá název dopravní metody a pokud potřebujete přiřadit jedné službě více metod, oddělte je čárkou. 

Přiřazení již vytvořených objednávek

Po instalaci pluginu, si ten začne každou objednávku označovat podle toho, zda má napárovanou dopravu. Tak plugin pozná, že se jedná o objednávky, které chcete odeslat do Hároku. Pokud máte nějaké objednávky, vytvořené před instalací, můžete je označit v hromadných akcích objednávek. Každá zaškrtnutá objednávka se přiřadí do fronty pro dávku.

 

Hmotnost objednávky

Odesílání hmotnosti zásilky je v základu vypnuté. Pokud chcete k zásilce přidat hmotnost, musíte to povolit v nastavení plugin. Ten pak sčítá hmotnost zboží a tuto hodnotu odešle v dávce. 

Plugin navíc umožňuje manuální zadání hmotnosti zásilky přímo v detailu objednávky a ta je pak upřednostněna. Můžete tak navýšit hmotnost  v případě nějakého speciálního balení.

 

Zásilky v eHároku

Po vytvoření obejdnávky a odeslání dat do eHároku, které proběhne automaticky, naleznete vaše importované zásilky v rozhraní, podle toho o jaký typ zásilky se jedná. Například balíky se vám zobrazí takto:

 

Ruční odeslání

Bohužel, odesílání do Hároku není možné plně automatizovat. V případě odesílání jedné objednávky po druhé do Hároku, vznikají samostatná podání a Slovenská pošta to odmítá přijímat. 

Z toho důvodu je v pluginu položka „Vytvořit dávku“. 

Všechny objednávky, které obsahují jednu z doprav, které jste nadefinovali v přiřazení doprav se zobrazí v seznamu objednávek, které jsou k dispozici pro odeslání do Hároku. 

Před odesláním vyberete druh zásilky, třídu zásilky a druh služby. Objednávky se zobrazují tak jak mají přiřazené dopravy, takže, pokud máte Slovenskou poštu přiřazenou balíku, nemůžete je odeslat jako doporučený list. 

Před odesláním si vyberete objednávky, které chcete odeslat a dávka se odešle do Hároku.  

Logování přenosů

Plugin obsahuje log každého přenosu, takže je možné z uložených dat zjistit, co přesně se do Hároku posílá a přípdané problémy řešit. Na obrázku níže vidíte serializovaná data requestu a odpovědí. Ukládá se odpověď po zaslání sheetu a odpověď na dotaz na stav sheetu.

Tisk štítků

Bohužel, api rozhraní ePodacího Hároku neobsahuje možnost stážení pdf souboru se stítkem pro zásilku. Toto musíte učitnit přímo v aplikaci. V případě, že se toto v budoucnu změní, bude do pluginu doplněno.

Čárový kód

Slovenská Pošta vám umožňuje mít vlastní čárový kód v určitém rozsahu. Pokud tuto možnost povolíte v nastavení, muíste také vyplnit počátek přiděleného rozsahu a jeho konec. V případě, že číslování překročí povolenný rozsah, přestane se do Hároku posílat čárový kód a informace o tom se uloží do meta objednávky.