Přeskočit na hlavní obsah

Eshop-rychle

Pomocí tohoto modulu je možné propojit scénáře s daty Eshop-rychle

Instalace
  • Nejprve je nutné se přihlásit do vaší webové administrace e-shopu.
  • Potom klikneme na položku "E-shop" v levém menu.
  • Najdeme položku "Export".
  • A následně položku "Export objednávek".
  • Na nově otevřené stránce najděte sekci API a vyberte "Zapnout objednávkové API".
  • Po potvrzení si označte URL adresu s objednávkami a vložte ji do našeho formuláře.
Budete potřebovat
  • API URL

Jak to funguje

Aby mohlo propojení správně fungovat, je nutné nastavit tzv. API URL, které získáte ve své administraci na E-shop rychle.

Následně, vždy když zákazník využije náš widget nebo hlasovou samoobsluhu, tak se připojíme na API URL kde si v exportu dat dohledáme konkrétní objednávku a na základě informací v exportu zákazníkovi zobrazíme odpovídající box z editoru.


Funkce aplikace

Ověřit číslo objednávky

Ověření, zda zákazník zadává správné číslo objednávky je jednou ze základních funkcí. Díky tomu budete vždy vědět, jakou objednávku zákazník řeší a eliminujete všechny problémy spojené s překlepy či záměnou s jinými doklady (VS, číslo faktury apod.).

Parametry aplikace

Číslo objednávky: Tady vyplňte proměnnou (ve složených závorkách), do které jste si uložili zadané číslo objednávky od uživatele, např.: {{obj}}.

Výsledek volání aplikace

Ne: Pokud objednávka neexistuje, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.

Ano: Aplikace vrací další proměnné, které můžete dále ve scénáři používat:

  • {{[box].status}} ID stavu objednávky. Textový popis stavu objednávky, např.: 1
  • {{[box].billing}} Platební metoda. Textový název platební metody, např.: Hotově
  • {{[box].shipping}} Přepravce. Textový název zvoleného přepravce, např.: PPL
  • {{[box].payment}} Platební metoda. Textový název platební metody, např.: Převodem
  • {{[box].paid}} Zaplaceno. Logická hodnota true nebo false, která říká, jestli je objednávka zaplacená
  • {{[box].topay}} K úhradě. Částka k úhradě (celková cena objednávky), např.: 1230.50
  • {{[box].currency}} Měna. Měna, např.: EUR nebo CZK
Info

Co je {{[box]...}} ? Jedná se o zápis názvu proměnné. Protože každá proměnná má volitelný název, zobrazujeme univerzální [box]. V hranatých závorkách proto, abyste věděli že je nutné tuto část nahradit za reálný název proměnné. Pokud tedy je název vaší proměnné "app" a aplikace vrací {{[box].id}} pak je nutné ve scénáři použít {{app.id}}

Načíst detail objednávky

Pro zobrazení stavu objednávky, nebo rozhodnutí, co může zákazník se svou objednávkou provést za akce, potřebujete znát detaily jeho objednávky. K tomu vám stačí pouze zjistit od zákazníka číslo objednávky. Všechny detaily si pak načtete přímo z Upgates.

Parametry aplikace

Číslo objednávky: Tady vyplňte proměnnou (ve složených závorkách), do které jste si uložili zadané číslo objednávky od uživatele, např.: {{obj}}.

E-mail zákazníka: E-mail vyplňte stejně jako číslo objednávky jako proměnnou (ve složených závorkách), do které jste si uložili zadaný e-mail od uživatele, např.: {{email}}. Pro zabezpečení dat vždy vyžadujeme od zákazníka, aby správně zadal kombinaci čísla objednávky a e-mailu. Jen pokud se tyto dva údaje shodují, můžeme zákazníkovi zobrazit obsah objednávky a nechat ho provádět změny.

Výsledek volání aplikace

Ne: Pokud objednávka neexistuje, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.

Ano: Aplikace vrací další proměnné, které můžete dále ve scénáři používat:

  • {{[box].name}} Jméno a příjmení. Jméno a příjmení zákazníka
  • {{[box].address}} Adresa. Adresa zákazníka
  • {{[box].status}} ID stavu objednávky. Textový popis stavu objednávky, např.: Nevyřízeno
  • {{[box].payment}}
  • {{[box].shipping}} Přepravce. Textový název zvoleného přepravce, např.: PPL
  • {{[box].paid}} Zaplaceno. Logická hodnota true nebo false, která říká, jestli je objednávka zaplacená
  • {{[box].topay}} K úhrafě. Částka k úhradě (celková cena objednávky), např.: 1230.50
  • {{[box].currency}} Měna. Měna, např.: EUR nebo CZK
  • {{[box].items}} Položky objednávky. Seznam položek (zboží) objednávky (každá položka dále obsahuje "name", "variant","amount","price" a "code")
Info

Co je {{[box]...}} ? Jedná se o zápis názvu proměnné. Protože každá proměnná má volitelný název, zobrazujeme univerzální [box]. V hranatých závorkách proto, abyste věděli že je nutné tuto část nahradit za reálný název proměnné. Pokud tedy je název vaší proměnné "app" a aplikace vrací {{[box].id}} pak je nutné ve scénáři použít {{app.id}}