CalMate

Doplnok CalMate automaticky vypočíta hodnotu poľa „Voliteľný parameter 2“ (OP2) zásielky na základe sumy dobierky. Výpočet prebieha po vytvorení zásielky. Pre doplnok je možné zadať predvolený vzorec, ako aj samostatný vzorec pre každého zákazníka.

Predpoklady

• predplatené pripojenie k rozhraniu Deliveo API;
• predplatené používanie webhookov Deliveo;
• oprávnenie na inštaláciu, nastavenie a používanie doplnku.

Inštalácia a prístup

Doplnok je možné nainštalovať na dispečerskom portáli v ponuke Doplnky. Po inštalácii je dostupný v ponuke Doplnky / CalMate. Doplnok môže nainštalovať a používať len používateľ s príslušnými oprávneniami.

Princíp fungovania

V vzorci x predstavuje sumu platby pri prevzatí.

Príklad:

(x * 0.1) + 100

Ak je suma dobierky 1000, potom:

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

Matematické operácie, ktoré možno použiť vo vzorci:

• +
• -
• *
• /
• ()

Dôležité pravidlá

• Výpočet prebieha po vytvorení zásielky.
• Ak je v poli OP2 už nejaká hodnota, doplnok ju prepíše.
• Výsledok výpočtu nemôže byť záporný.
• Dĺžka výsledku nesmie prekročiť maximálnu dĺžku poľa OP2.
• V prípade nesprávneho vzorca sa výpočet neuskutoční.

Nastavenie webhooku

Aby doplnok fungoval, je potrebné vytvoriť webhook.

1. Otvorte položku menu Nastavenia / Webhook.
2. Vytvorte jednoduchý webhook.
3. Ako udalosť vyberte udalosť Vytvorenie zásielky.
4. Skopírujte URL webhooku zobrazenú na stránke CalMate.
5. Uložte webhook.

URL webhooku je pre každú inštaláciu jedinečná, preto vždy používaj adresu zobrazenú priamo na stránke CalMate.

Predvolený vzorec OP2

Vzorec „Predvolený OP2“ sa vzťahuje na všetky zásielky zákazníkov, pre ktoré nie je zadaný žiadny špecifický vzorec pre daného zákazníka. Postup nastavenia:

1. Zadajte vzorec do poľa Vzorec OP2 (predvolený).
2. Skontrolujte vzorec pomocou tlačidla Vyskúšať vzorec.
3. Kliknite na tlačidlo Uložiť.

Príklad:

10+(x*2)/10

Vzorce špecifické pre zákazníka

V časti Vzorce pre zákazníkov je možné zadať pre každého zákazníka odlišný výpočet. Na to sú potrebné dva údaje:

• ID zákazníka
• Vzorec

ID zákazníka je interné číselné identifikačné číslo, ktoré sa nachádza v stĺpci ID v zozname Základné údaje / Zákazníci na portáli dispečera. Pridanie vzorca špecifického pre zákazníka:

1. Vyhľadajte ID zákazníka v ponuke Základné údaje / Zákazníci.
2. Zadajte ID do poľa ID zákazníka.
3. Zadajte vzorec príslušný pre daného zákazníka.
4. V prípade potreby vzorec otestujte.
5. Kliknite na tlačidlo Pridať.

Existujúce vzorce pre zákazníkov je možné odstrániť pomocou tlačidla Odstrániť, ktoré sa nachádza na konci riadku.

Poradie použitia vzorcov

Pri vytváraní zásielky systém:

1. skontroluje, či k zákazníkovi patrí osobitný vzorec;
2. ak áno, použije vzorec špecifický pre daného zákazníka;
3. ak neexistuje žiadny špecifický vzorec, použije predvolený vzorec.

Testovanie vzorca

Vzorec je možné vyskúšať pred uložením.

1. Do testovacieho poľa zadajte x hodnotu, teda sumu dobierky, ktorú chcete otestovať.
2. Kliknite na tlačidlo Vyskúšať vzorec.
3. Systém spustí výpočet vzorca.
4. V prípade úspešného testu sa zobrazí vypočítaný výsledok.

Test nemení zásielku, iba overuje fungovanie vzorca.

Chybný vzorec

Ak zadaný vzorec nie je zrozumiteľný:

• výpočet sa nevykoná;
• pole vzorca sa na krátku dobu obklopí červeným rámčekom.

V takom prípade skontrolujte:

• správnosť zátvoriek;
• povolené operačné znaky;
• či používate iba premennú x premenná;
• či nie sú v texte preklepy alebo chýbajúce operátory.

Príklady

Pridanie pevnej sumy

x+100

K sume dobierky sa pripočíta 100.

Výpočet percentuálnej hodnoty

x*0.1

Hodnota OP2 je 10 % sumy dobierky.

Percentuálna hodnota a pevná suma spolu

(x*0.1)+100

Hodnota OP2 predstavuje 10 % sumy dobierky plus 100.

Odpočet pevnej sumy

x-100

Systém odpočíta 100 od sumy dobierky. Výsledok nemôže byť záporný.

Časté chyby

Hodnota OP2 sa neaktualizuje

Skontrolujte:

• či je webhook vytvorený;
• či je udalosťou webhooku „Vytvorenie zásielky“;
• či je v webhooku uvedená správna URL adresa;
• či je k zásielke priradená suma za dobierku;
• či je vzorec uložený.

Nespúšťa sa očakávaný vzorec

Skontrolujte:

• či existuje pre daného zákazníka samostatný vzorec;
• či je zadané správne ID zákazníka;
• či je uložený požadovaný predvolený vzorec.

Vzorec špecifický pre zákazníka má prednosť pred predvoleným vzorcom.

Výsledok je záporný

Doplnok nesmie používať zápornú hodnotu OP2. Upravte vzorec tak, aby výsledok bol aspoň nula pri každej očakávanej sume dobierky.

Testovanie vzorca nebolo úspešné

Skontrolujte:

• syntax vzorca;
• zátvorky;
• operátory;
• použitie x použitie premennej.

Predchádzajúca hodnota OP2 zmizla

Doplnok pri vytvorení zásielky prepíše predchádzajúcu hodnotu poľa OP2. Je to súčasťou fungovania.