Shopify Private API
Pomocí tohoto modulu je možné propojit scénáře s Shopify
- Sami si můžete nastavit, jaký text pro jaký stav se má zobrazit.
- Pokud objednávka čeká na zaplacení, zobrazíme zákazníkovi odkaz na platební bránu a nebo vygenerujeme QR kód pro okamžitou platbu bankovním převodem.
- Pokud se objednávka již doručuje, zobrazíme přímo na stránkách vašeho e-shopu podrobný průběh doručování díky propojení na Českou poštu, Zásilkovnu, Balíkobot a další. Včesné a přesné informace napomáhají vyšší doručitelnosti.
- Jak snížit procento nedoručených zásilek? Umožněte jednoduché a automatizované strono objednávky.
- Vše si můžete přizpůsobit tomu, jak vám to vyhovuje a co vy potřebujete.
- Doména e-shopu (Doména je vždy ve formátu nazev.myshopify.com. Pokud máte administraci na adrese admin.shopify.coom tedy pokud v url vidíte např. "admin.shopify.com/store/mujeshop" vyplňte "mujeshop.myshopify.com")
- Admin API access token
Funkce aplikace
Ověřit číslo objednávky
Ověření, jestli 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}}. Příklad: {{obj}}.
Výsledek volání aplikace
Objednávka existuje: 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].billing}}Platební metoda. Textový název platební metody, např.: Hotově{{[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 úhradě. Částka k úhradě (celková cena objednávky) např.: 1230.50{{[box].currency}}Měna. Měna, např.: EUR nebo CZK{{[box].tracking}}Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky{{[box].trackingurl}}Tracking URL. Odkaz pro sledování zásilky na stránkách přepravce{{[box].statusurl}}URL pro detail stavu objednávky. Stav objednávky s možností platby
Objednávka neexistuje: Pokud objednávka neexistuje, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
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 ze Shoptetu.
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}}. Příklad: {{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. Příklad: {{email}}.
Výsledek volání aplikace
Ano: Aplikace vrací další proměnné, které můžete dále ve scénáři používat:
{{[box].url}}URL administrace. Adresa do administrace objednávky{{[box].phone}}Telefonní číslo. Telefonní číslo zákazníka např.: +420601223344{{[box].status}}Stav objednávky. Textový popis stavu objednávky např.: Nevyřízeno{{[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].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{{[box].tracking}}Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky{{[box].trackingurl}}Tracking URL. Odkaz pro sledování zásilky na stránkách přepravce{{[box].items}}Položky objednávky. Seznam položek (zboží) objednávky (každá položka dále obsahuje "name", "brand" a "code"){{[box].statusurl}}URL pro detail stavu objednávky. Stav objednávky s možností platby
Ne: Pokud objednávka neexistuje, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
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}}
Přidat komentář k objednávce
Pokud chce zákazník složitější změnu, například změnit fakturační údaje, je potřeba dobře informovat kolegy, kteří budou změnu provádět. Tady jim můžete připravit návod včetně informací, které vám vyplnil zákazník v samoobsluze. Vše se pak vloží přímo k objednávce v Shoptetu.
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}}. Příklad: {{obj}}.
Text komentáře: Text, který vyplníte se doplní doplní do komentáře k objednávce.
Výsledek volání aplikace
Ano: Pokud se podaří přidat komentář k objednávce, obsahuje {{promenna}} hodnotu true (pravda). Aplikace vám vrátí hodnotu Ano.
Ne: Pokud se nepodaří přidat komentář k objednávce, 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
Čí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}}. Příklad: {{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. Příklad: {{email}}.
Za časové období
Telefonní číslo zákazníka
Výsledek volání aplikace
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"
Ne: Pokud se nepodaří načíst seznam objednávek, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
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 seznam objednávek zákazníka dle telefonního čísla
Pokud zadáte telefonní číslo zákazníka, lze načíst seznam jeho vytvořených objednávek, ze kterých si vybere tu, která ho právě zajímá.
Parametry aplikace
Za časové období
Telefonní číslo zákazníka
Výsledek volání aplikace
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"
Ne: Pokud se nepodaří načíst seznam objednávek, obsahuje {{promenna}} hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
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}}