WooCommerce
Pomocí tohoto modulu je možné propojit scénáře s daty WooCommerce e-shopu
- API URL
Jak to funguje
Aby mohlo propojení správně fungovat, je nutné nainstalovat plugin a získat tak tzv. API URL (najdete v nastavení pluginu) a vyplnit jej v zde v nastavení modulu.
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}}
Stav objednávky. Textový popis stavu objednávky, např.: Nevyřízeno{{[box].total}}
K úhradě. Částka k úhradě (celková cena objednávky) vč. měny, např.: 1230.50 Kč{{[box].tracking}}
Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky
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 WooCommerce.
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 neexistuje kombinace čísla objednávky a e-mailu, 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].first_name}}
Jméno. Křestní jméno zákazníka, které vyplnil u objednávky, např.: Petr.{{[box].last_name}}
Příjmení. Příjmení zákazníka, které vyplnil u objednávky, např.: Novák.{{[box].adress}}
Ulice. Ulice + číslo popisné a orientačná (fakturační), např.: Zelená 1234/12.{{[box].city}}
Město. Město (fakturační), např.: Olomouc.{{[box].zip}}
PSČ. PSČ (fakturační), např.: 14200{{[box].country}}
Země. Země (fakturační), např.: CZ{{[box].shipping.first_name}}
Jméno. Křestní jméno zákazníka (doručovací), např.: Petr{{[box].shipping.last_name}}
Jméno. Příjmení zákazníka (doručovací), např.: Novák{{[box].shipping.company}}
Název společnosti. Název společnosti, pokud si zákazník objednává zboží na IČ{{[box].shipping.address}}
Ulice. Ulice + číslo ppisné a orientační (doručovací), např. Zelená 1234/12{{[box].shipping.city}}
Město. Město (doručovací), např.: Olomouc{{[box].shipping.zip}}
PSČ. PSČ (doručovací), např.: 14200{{[box].shipping.country}}
Země. Země (doručovací), např.: CZ{{[box].shipping.email}}
E-mail. E-mail zákazníka (kontaktní), např.: [email protected]{{[box].shipping.phone}}
Telefon. Telefon zákazníka (kontaktní), např.: 777888999{{[box].map}}
Mapa doručení. URL odkaz pro mapu doručovací adresy{{[box].status}}
Stav objednávky. Textový popis stavu objednávky, např.: Nevyřízeno{{[box].payment}}
Typ platby. Textový název typu platby, např.: Hotově{{[box].pay}}
Zaplaceno. Logická hodnota true nebo false, která říká, jestli je objednávka zaplacená{{[box].payed_days}}
Zaplaceno dní. Číslo, které udává pčet dní ode dne zaplacení objednávky{{[box].total}}
K úhradě. Částka k úhradě (celková cena objednávky) např.: 1230.50{{[box].currency}}
Měna. Měna, např.: EUR nebo CZK{{[box].invoice_url}}
Faktura URL. URL adresa, kde si zákazník může stáhnout svou fakturu k objednávce{{[box].tracking}}
Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky{{[box].items}}
Položky objednávky. Seznam položek (zboží) objednávky (každá položka dále obsahuje "name", "brand" a "code")
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}}
Změnit stav objednávky
Pro lepší přehlednost a práci s objednávkami, můžete měnit jejich stavy. Například když zakázník v samoobsluze zažádá o storno objednávky, rovnou ji stornujete atd. Díky napojení na WooCommerce navíc můžete pracovat i se stavy, které jste si sami vytvořili.
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.
Stav: Ve výchozím nastavení má WooCommerce tyto stavy:pending čeká na platbuprocessing zpracovává seon-hold on-holdcompleted dokončenocancelled zrušenarefunded vrácenofailed selhaloJak zjistit ID stavu se dozvíte v naší nápovědě https://www.messageok.com/woocommerce/stavy.
Výsledek volání aplikace
Ne: Pokud se nepodaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
Ano: Pokud se podaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu true (pravda)
Načíst e-mail zákazníka dle ID objednávky
Načte e-mail, ze kterého byla vytvořena objednávka dle zadaného čísla objednávky. Pozor, při uložení výsledku aplikace do proměnné, můžete vyzradit tyto informace jiným návštěvníkům internetu. Doporučujeme proto proměnnou pojmenovat tak, aby začínala znakem $, takové proměnné nejsou přenášeny do prohlížeče.
Parametry aplikace
Výsledek volání aplikace
Ne: Pokud se nepodaří načíst e-mail zákazníka, obsahuje {{promenna}}
hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
Na číst seznam objednávek zákazníka
Pokud je zákazník na e-shopu přihlášený, nemusí vyplňovat číslo objednávky. Můžete mu rovnou načíst seznam jeho vytvořených objednávek, ze kterých si vybere tu, která ho právě zajímá.
Parametry aplikace
Identifikátor uživatele.
Výsledek volání aplikace
Ne: Pokud se nepodaří načíst seznam objednávek, 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].count}}
Počet objednávek. Obsahuje číslo, které odpovídá počtu objednávek{{[box].orders}}
Objednávky. Obsahuje seznam objednávek s klíči "orderid", "date" a "price"
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}}
Stornovat objednávku
Pokud si zákazník přes samoobsluhu zažádá o storno objednávky, nemusíte si požadavek posílat na e-mail a ručně ji pak stornovat. Přes tuto aplikaci ji stornujete rovnou přímo v systému WooCommerce.
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 neexistuje kombinace čísla objednávky a e-mailu, obsahuje {{promenna}}
hodnotu false (nepravda)
Ano: Pokud se podaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu true (pravda)
Ověřit zákazníka podle e-mailu
Pro zabezpečení dat zákazníků vždy vyžadujeme znát kombinaci e-mailu a čísla objednávky. Jen se znalostí těchto dvou údajů dovolujeme zákazníkům zobrazit obsah objednávky nebo provádět změny jejich stavů.
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.