CalMate

Добавката CalMate автоматично изчислява стойността на полето „Опционален параметър 2“ (OP2) на пратката въз основа на сумата за наложен платеж. Изчислението се извършва след създаването на пратката. За приложението може да се зададе формула по подразбиране, както и отделна формула за всеки клиент.

Предпоставки

• абонамент за Deliveo API;
• абонамент за използване на Deliveo webhook;
• права за инсталиране, настройка и използване на добавката.

Инсталиране и достъп

Добавката може да бъде инсталирана в Диспечерския портал, в менюто „Добавки“. След инсталирането тя е достъпна в менюто „Добавки / CalMate“. Добавката може да бъде инсталирана и използвана само от потребител, разполагащ с необходимите права.

Принцип на действие

В формулата x означава сумата на наложеното плащане.

Пример:

(x * 0.1) + 100

Ако сумата на наложеното плащане е 1000, тогава:

• x = 1000
• изчислената стойност на OP2 е 200

Математически операции, които могат да се използват във формулата:

• +
• -
• *
• /
• ()

Важни правила

• Изчислението се извършва след създаването на пратката.
• Ако в полето OP2 вече има стойност, допълнителната стойност я заменя.
• Изчисленият резултат не може да бъде отрицателен.
• Дължината на резултата не може да надвишава максималната дължина на полето OP2.
• При грешна формула изчислението не се извършва.

Настройка на уебхук

За да работи добавката, трябва да се създаде уебхук.

1. Отворете менюто „Настройки“ / „Уебхук“.
2. Създайте прост уебхук.
3. Като събитие изберете „Създаване на пратка“.
4. Копирайте URL адреса на уебхука, който се показва на страницата на CalMate.
5. Запазете уебхука.

URL адресът на уебхука е уникален за всяка инсталация, затова винаги използвайте адреса, който се показва в интерфейса на CalMate.

Стандартна формула OP2

Формулата „OP2 по подразбиране“ се отнася за всички пратки на клиенти, за които не е зададена отделна формула, специфична за клиента. За да я настроите:

1. Въведете формулата в полето „Стандартна формула OP2“.
2. Проверете формулата с бутона „Изпробвайте формулата“.
3. Кликнете върху бутона „Запази“.

Пример:

10+(x*2)/10

Формули, специфични за клиента

В раздела „Формули за клиенти“ може да се зададе различно изчисление за всеки клиент. За целта са необходими две данни:

• Идентификационен номер на клиента
• Формула

Идентификационният номер на клиента е вътрешен цифров идентификатор, който се намира в колоната „Идентификационен номер“ в списъка „Основни данни / Клиенти“ на портала за диспечери. За да добавите формула, специфична за клиента:

1. Намерете ID-то на клиента в менюто „Основни данни / Клиенти“.
2. Въведете ID-то в полето „Идентификационен номер на клиента“.
3. Въведете формулата, свързана с клиента.
4. Ако е необходимо, тествайте формулата.
5. Кликнете върху бутона „Добави“.

Съществуващите формули за клиенти могат да бъдат премахнати с бутона за изтриване, намиращ се в края на реда.

Ред на прилагане на формулите

При създаването на пратката системата:

1. проверява дали към клиента има специфична формула;
2. ако да, използва формулата, специфична за клиента;
3. ако няма специфична формула, прилага формулата по подразбиране.

Тестване на формулата

Формулата може да бъде тествана преди запазването.

1. В полето за тестване въведете x стойност, т.е. сумата на наложен платеж, която искате да тествате.
2. Кликнете върху бутона „Изпробвайте формулата“.
3. Системата ще изпълни формулата.
4. При успешен тест ще се покаже изчисленият резултат.

Тестът не променя пратката, а само проверява функционирането на формулата.

Грешна формула

Ако въведената формула не може да бъде интерпретирана:

• изчислението не се изпълнява;
• полето на формулата за кратко време се огражда с червена рамка.

В такъв случай проверете:

• правилността на скобите;
• дали са използвани допустими оператори;
• дали използвате само променливата x променлива;
• дали няма правописни грешки или липсващи оператори.

Примери

Добавяне на фиксирана сума

x+100

Към сумата за наложен платеж се добавя 100.

Изчисляване на процентна стойност

x*0.1

Стойността на OP2 е 10% от сумата на наложеното плащане.

Процент и фиксирана сума заедно

(x*0.1)+100

Стойността на OP2 е 10% от сумата за наложен платеж, плюс 100.

Приспадане на фиксирана сума

x-100

Системата приспада 100 от сумата на наложеното плащане. Резултатът не може да бъде отрицателен.

Чести грешки

Стойността на OP2 не се актуализира

Проверете:

• дали уебхукът е създаден;
• дали събитието на уебхука е „Създаване на пратка“;
• дали в уебхука е посочен правилният URL адрес;
• дали за пратката има сума за наложен платеж;
• дали формулата е запазена.

Не се изпълнява очакваната формула

Проверете:

• дали има отделна формула за клиента;
• дали е въведен правилният идентификационен номер на клиента;
• дали е запазена желаната формула по подразбиране.

Формулата, специфична за клиента, има предимство пред формулата по подразбиране.

Резултатът е отрицателен

Добавката не може да използва отрицателна стойност на OP2. Промени формулата така, че резултатът да бъде поне нула за всяка очаквана сума за наложен платеж.

Тестът на формулата е неуспешен

Проверете:

• синтаксиса на формулата;
• скобите;
• операционните знаци;
• използването на x използването на променливите.

Предишната стойност на OP2 е изчезнала

Добавката презаписва предишната стойност на полето OP2 при създаването на пратката. Това е част от функционирането на системата.