Shoptet
Pomocí tohoto modulu je možné propojit scénáře s daty Shoptetu
Pro instalaci najděte na doplnky.shoptet.cz náš doplňek MessageOk a klikněte na Objednat doplněk.
- 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.
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. 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].statusid}}
ID stavu objednávky. ID stavu objednávky. Příklad:Např.: 2
.{{[box].billing}}
Platební metoda. Textový název platební metody. Příklad:Např.: Dobírkou, Hotově, Bankovní převod
.{{[box].shipping}}
Přepravce. Textový název zvoleného přepravce. Příklad:Např.: Zásilkovna, PPL, Kurýr Geis
.{{[box].paid}}
Zaplaceno. Logická hodnota true nebo false, která říká, jestli je objednávka zaplacená. Příklad:Např.: true
.{{[box].topay}}
K úhradě. Částka k úhradě (celková cena objednávky) bez měny. Příklad:Např.: 1230.50
.{{[box].currency}}
Měna. Označení měny, ve které zákazník objednávku platí. Příklad:Např.: CZK
.{{[box].tracking}}
Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky. Příklad:Např.: Z123456789
.{{[box].trackingurl}}
Tracking URL. Odkaz pro sledování zásilky na stránkách přepravce{{[box].paymenturl}}
URL pro platbu. Odkaz pro platbu objednávky online na stránkách platební brány
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. 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. 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}}
.
ID zákazníka: ID zákazníka je identifikátor (GUID), který odpovídá náhodnému řetězci vygenerovaném při založení zákaznického účtu. Můžete ho získat z vloženého kódu na webu.
Výsledek volání aplikace
Ano: Aplikace vrací další proměnné, které můžete dále ve scénáři používat:
{{[box].address}}
Fakturační adresa. Seznam, který obsahuje "ulici", "PSČ" a "město"). Příklad:Např.: Nová 1, 11000, Praha 1
.{{[box].address2}}
Doručovací adresa. Seznam, který obsahuje "ulici", "PSČ" a "město"). Pokud je doručovací adresa stejná jako fakturační, je hodnota prázdná. Příklad:Např.: Nová 1, 11000, Praha 1
.{{[box].billing}}
Platební metoda. Textový název platební metody. Příklad:Např.: Dobírkou, Hotově, Bankovní převod
.{{[box].company}}
Název firmy. Textový název firmy. Pokud objednávka není firmu, hodnota neexistuje. Příklad:Např.: Messageok s.r.o.
.{{[box].companyid}}
Identifikace firmy. Seznam, který IČ a DIČ "id", "taxid" a "vatid"). Pokud parametry IČ a DIČ nejsou u objednávky uvedeny, jsou hodnoty prázdné. Příklad:Např.: 04222245, CZ04222245
.{{[box].country}}
Země. Označení země, ze které objednávka pochází. Příklad:Např.: CZ
.{{[box].currency}}
Měna. Označení měny, ve které zákazník objednávku platí. Příklad:Např.: CZK
.{{[box].customer}}
Zákazník. Označení zákazníka{{[box].items}}
Položky objednávky. Seznam položek (zboží) objedn��vky (každá položka dále obsahuje "name", "brand" a "code"){{[box].name}}
Jméno a příjmení zákazníka. Jméno a příjmení zákazníka (uvedené v Shoptetu v záložce Kontakt na zákazníka). Příklad:Např.: Jan Novák
.{{[box].name2}}
Jméno a příjmení zákazníka (adresát). Jméno a příjmení zákazníka (uvedené v Shoptetu v záložce Doručovací adresa). Příklad:Např.: Jan Novák
.{{[box].orderid}}
Číslo objednávky. Číslo objednávky v Shoptetu. Příklad:Např.: 2024000021
.{{[box].paid}}
Zaplaceno. Logická hodnota true nebo false, která říká, jestli je objednávka zaplacená. Příklad:Např.: true
.{{[box].payment}}
Typ platby. Textový název platební metody. Příklad:Např.: Dobírkou, Hotově, Bankovní převod
.{{[box].paymenlink}}
URL pro platbu. Odkaz pro platbu objednávky online na stránkách platební brány. Pokud neexistuje, je hodnota prázdná{{[box].phone}}
Telefonní číslo. Telefonní číslo zákazníka. Příklad:Např.: +420601223344
.{{[box].shipping}}
Přepravce. Textový název zvoleného přepravce. Příklad:Např.: Zásilkovna, PPL, Kurýr Geis
.{{[box].shippingAdditionalInfo}}
Info k doručení. Detailní info k doručení. Pokud neexistuje, je hodnota prázdná{{[box].url}}
URL administrace. Adresa do administrace objednávky. Příklad:Např.: https://eshop.myshoptet.com/admin/objednavky-detail/?id=1
.{{[box].status}}
Stav objednávky. Textový popis stavu objednávky. Příklad:Např.: Nevyřízeno
.{{[box].statusid}}
ID stavu objednávky. ID stavu objednávky. Příklad:Např.: -4
.{{[box].topay}}
K úhradě. Částka k úhradě (celková cena objednávky) bez měny. Příklad:Např.: 1230.50
.{{[box].tracking}}
Tracking číslo. Text (nebo číslo), které slouží pro sledování zásilky. Příklad:Např.: Z123456789
.{{[box].trackingurl}}
Tracking URL. Odkaz pro sledování zásilky na stránkách přepravce{{[box].update}}
Datum poslední změny. Datum, kdy někdo objednávku v administraci naposledy změnil. Příklad:Např.: 2024-06-18T15:09:44+0200
.{{[box].weigth}}
Váha. Váha objednávky v kg (ze Shoptetu). Příklad:Např.: 0.4
.
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}}
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 Shoptet 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. 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. 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}}
.
ID stavu: Ve výchozím nastavení má Shoptet tyto stavy:-1 nevyřízená-2 vyřizuje se-3 vyřízena-4 stornovánaJak zjistit ID stavu se dozvíte v naší nápovědě https://www.messageok.com/shoptet/stavy.
Odesílání e-mailů a SMS: Shoptet při změně stavu může odesílat e-mail nebo SMS zákazníkovi.
Vytváření souvisejících dokumentu: Shoptet při změně stavu může vytvářet související dokumenty (daňový doklad apod.)
Výsledek volání aplikace
Ano: Pokud se podaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu true (pravda). Aplikace vám vrátí hodnotu Ano.
Ne: Pokud se nepodaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
Změnit stav objednávky bez e-mailu zákanzíka
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 Shoptet 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. Příklad: {{obj}}
.
ID stavu: Ve výchozím nastavení má Shoptet tyto stavy:-1 nevyřízená-2 vyřizuje se-3 vyřízena-4 stornovánaJak zjistit ID stavu se dozvíte v naší nápovědě https://www.messageok.com/shoptet/stavy.
Odesílání e-mailů a SMS: Shoptet při změně stavu může odesílat e-mail nebo SMS zákazníkovi.
Vytváření souvisejících dokumentu: Shoptet při změně stavu může vytvářet související dokumenty (daňový doklad apod.)
Výsledek volání aplikace
Ano: Pokud se podaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu true (pravda). Aplikace vám vrátí hodnotu Ano.
Ne: Pokud se nepodaří změnit stav objednávky, obsahuje {{promenna}}
hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
Ověřit zákazníka podle e-mailu
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.
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. 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. 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. Příklad: {{email}}
.
Výsledek volání aplikace
Ano: Pokud objednávka existuje, je hodnotou {{promenna}}
objekt, u kterého můžete přistupovat k následujícím klíčům = používat tyto proměnné.
Ne: Pokud se nepodaří ověřit zákazníka podle e-mailu, obsahuje {{promenna}}
hodnotu false (nepravda). Aplikace vám vrátí hodnotu Ne.
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. Příklad: {{obj}}
.
Text komentáře: Text, který vyplníte se doplní doplní do komentáře k objednávce.