CalMate

Doplněk CalMate automaticky vypočítá hodnotu pole „Volitelný parametr 2“ (OP2) zásilky na základě částky dobírky. Výpočet se provede po vytvoření zásilky. Pro doplněk lze zadat výchozí vzorec, případně i samostatný vzorec pro každého zákazníka.

Předpoklady

• předplacené připojení k API Deliveo;
• předplacené využití webhooků Deliveo;
• oprávnění k instalaci, nastavení a používání doplňku.

Instalace a přístup

Doplněk lze nainstalovat na dispečerském portálu v nabídce Doplňky. Po instalaci je k dispozici v nabídce Doplňky / CalMate. Doplněk může nainstalovat a používat pouze uživatel s příslušným oprávněním.

Princip fungování

Ve vzorci x znamená částku za dobírku.

Příklad:

(x * 0.1) + 100

Pokud je částka dobírky 1000, pak:

• x = 1000
• vypočítaná hodnota OP2 je 200

Matematické operace, které lze ve vzorci použít:

• +
• -
• *
• /
• ()

Důležité pravidla

• Výpočet se provede po vytvoření zásilky.
• Pokud v poli OP2 již existuje hodnota, doplňková hodnota ji přepíše.
• Výsledek výpočtu nesmí být záporný.
• Délka výsledku nesmí překročit maximální délku pole OP2.
• V případě chybného vzorce se výpočet neprovede.

Nastavení webhooku

Aby doplněk fungoval, je třeba vytvořit webhook.

1. Otevřete položku menu Nastavení / Webhook.
2. Vytvořte jednoduchý webhook.
3. Jako událost vyberte událost Vytvoření zásilky.
4. Zkopírujte URL webhooku zobrazenou na stránce CalMate.
5. Uložte webhook.

URL webhooku je pro každou instalaci jedinečná, proto vždy používejte adresu zobrazenou přímo na stránce CalMate.

Výchozí vzorec OP2

Výchozí vzorec OP2 se vztahuje na všechny zásilky zákazníků, pro které není zadán žádný specifický vzorec. Nastavení:

1. Zadejte vzorec do pole Výchozí vzorec OP2.
2. Ověřte vzorec pomocí tlačítka Vyzkoušet vzorec.
3. Klikněte na tlačítko Uložit.

Příklad:

10+(x*2)/10

Vzorce specifické pro zákazníka

V části „Vzorce pro zákazníky“ lze zadat výpočty, které se liší podle jednotlivých zákazníků. K tomu jsou potřebné dva údaje:

• ID zákazníka
• Vzorec

ID zákazníka je interní číselný identifikátor, který je uveden ve sloupci ID v seznamu Základní údaje / Zákazníci na portálu dispečera. Přidání vzorce specifického pro zákazníka:

1. Vyhledejte ID zákazníka v nabídce Základní údaje / Zákazníci.
2. Zadejte ID do pole ID zákazníka.
3. Zadejte vzorec příslušný pro daného zákazníka.
4. V případě potřeby vzorec otestujte.
5. Klikněte na tlačítko Přidat.

Stávající vzorce pro zákazníky lze odstranit pomocí tlačítka Odstranit, které se nachází na konci řádku.

Pořadí použití vzorců

Při vytváření zásilky systém:

1. zkontroluje, zda k danému zákazníkovi patří nějaký specifický vzorec;
2. pokud ano, použije vzorec specifický pro daného zákazníka;
3. pokud neexistuje žádný specifický vzorec, použije výchozí vzorec.

Testování vzorce

Vzorec lze před uložením vyzkoušet.

1. Do testovacího pole zadejte x hodnotu, tedy částku dobírky, kterou chcete otestovat.
2. Klikněte na tlačítko Vyzkoušet vzorec.
3. Systém provede výpočet vzorce.
4. V případě úspěšného testu se zobrazí vypočítaný výsledek.

Test nezmění zásilku, pouze ověří fungování vzorce.

Chybný vzorec

Pokud zadaný vzorec nelze vyhodnotit:

• výpočet se neprovede;
• pole vzorce se na krátkou dobu obklopí červeným rámečkem.

V takovém případě zkontrolujte:

• správnost závorek;
• použitelné operátory;
• zda používáte pouze proměnnou x proměnnou;
• zda se nevyskytuje překlep nebo chybějící operátor.

Příklady

Přidání pevné částky

x+100

K částce dobírky se přičte 100.

Výpočet procentuální hodnoty

x*0.1

Hodnota OP2 činí 10 % částky dobírky.

Procentní hodnota a pevná částka dohromady

(x*0.1)+100

Hodnota OP2 činí 10 % částky dobírky plus 100.

Odpočet pevné částky

x-100

Systém odečte 100 od částky dobírky. Výsledek nesmí být záporný.

Časté chyby

Hodnota OP2 se neaktualizuje

Zkontrolujte:

• zda je webhook vytvořen;
• zda je událostí webhooku „Vytvoření zásilky“;
• zda je ve webhooku uvedena správná URL adresa;
• zda je u zásilky uvedena částka za dobírku;
• zda je vzorec uložen.

Nespouští se očekávaný vzorec

Zkontrolujte:

• zda existuje pro daného zákazníka samostatný vzorec;
• zda je zadáno správné ID zákazníka;
• zda je uložen požadovaný výchozí vzorec.

Vzorec specifický pro klienta má přednost před výchozím vzorcem.

Výsledek je záporný

Doplněk nesmí používat zápornou hodnotu OP2. Upravte vzorec tak, aby výsledek byl alespoň nulový pro všechny očekávané částky dobírky.

Testování vzorce selhalo

Zkontrolujte:

• syntaxi vzorce;
• závorky;
• operátory;
• použití x použití proměnné.

Předchozí hodnota OP2 zmizela

Doplněk při vytvoření zásilky přepíše předchozí hodnotu pole OP2. Je to součástí fungování systému.