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. 

Kdy odesílat – nastavení odesílání do hároku můžete nastavit na změnu stavu objednávky, nebo na děkovnou stránku. Záleží na vás. 

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á. Jak zjistit id dopravy, nejdete v tomto videu https://www.youtube.com/watch?v=t563CMRc0Sw

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:

 

Automatické a ruční odeslání

Plugin je připraven tak, aby bylo možné přenos dat automatizovat. Přesto je možné, že přenos selže, nebo vy naopak nebudete chtít přenášet data automaticky. 

Plugin proto přidává do objednávek sloupec eHárok, v kterém je buď informace o stavu přenosu, nebo ikonka umožňující manuální odeslání do Hároku.

V případě, že se po kliknutí na ikonku nic nestane, s největší pravděpodobností přenos selhal. 

Pokud není u objednávku nic zobrazeno, jedná se o objednávku s jinou dopravní metodou. 

 

Zobrazení informace o selhání

 

V případě, že dojde k selhání, uloží tuto infomraci plugin do poznámek objednávky, takže ihned vidíte, z jakého důvodu se to stalo. Na přiloženém screenu vidíte, že je překročena povolená suma dobírky a je neplatné psč.

Aby jste nemuseli po opravě objednávky znovu jít do seznamu objednávek, přidává plugin do akcí objednávek novou položku, jak je vidět na obrázku níže. 

Uložená data

Při odeslání dat do eHároku, získá plugin sheet id a sheet status, který se uloží do custom fieldů objednávky.

 

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.

Vypsání logu pro konkrétní objednávku

Do logu můžete vstoupit přes boční menu, kdy se ale vypíší všechna uložená data. 

Pokud chcete zobrazit data pro konkrétní objednávku, můžete tak učinit pomocí odkazu v detailu objednávky.

 

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.