CalMate

Suplimentul CalMate calculează automat valoarea câmpului „Parametru opțional 2” (OP2) al expedierii pe baza sumei de plată la livrare. Calculul se efectuează după crearea expedierii. Pentru acest modul suplimentar se poate specifica o formulă implicită, precum și o formulă separată pentru fiecare client.

Cerințe preliminare

• abonament la conexiunea API Deliveo;
• abonament la serviciul webhook Deliveo;
• drepturi de instalare, configurare și utilizare a suplimentului.

Instalare și acces

Extensia poate fi instalată pe Portalul dispeceratului, din meniul Extensii. După instalare, aceasta este accesibilă din meniul Extensii / CalMate. Extensia poate fi instalată și utilizată numai de către utilizatorii care dețin drepturile corespunzătoare.

Principiul de funcționare

În formulă, x reprezintă suma plății la livrare.

Exemplu:

(x * 0.1) + 100

Dacă suma plății la livrare este 1000, atunci:

• x = 1000
• valoarea calculată a OP2 este 200

Operații matematice care pot fi utilizate în formulă:

• +
• -
• *
• /
• ()

Reguli importante

• Calculul se efectuează după crearea expedierii.
• Dacă câmpul OP2 conține deja o valoare, suplimentul o va suprascrie.
• Rezultatul calculat nu poate fi negativ.
• Lungimea rezultatului nu poate depăși lungimea maximă a câmpului OP2.
• În cazul unei formule eronate, calculul nu se efectuează.

Configurarea webhook-ului

Pentru ca suplimentul să funcționeze, trebuie creat un webhook.

1. Deschideți meniul Setări / Webhook.
2. Creați un webhook simplu.
3. Ca eveniment, selectează evenimentul „Creare expediere”.
4. Copiați adresa URL a webhook-ului afișată pe pagina CalMate.
5. Salvează webhook-ul.

URL-ul webhook-ului este unic pentru fiecare instalare, de aceea folosește întotdeauna adresa afișată pe propria interfață CalMate.

Formula OP2 implicită

Formula OP2 implicită se aplică tuturor expedierilor clienților pentru care nu a fost specificată o formulă specifică clientului. Pentru configurare:

1. Introduceți formula în câmpul „Formula OP2 implicită”.
2. Verificați formula folosind butonul „Testați formula”.
3. Faceți clic pe butonul „Salvare”.

Exemplu:

10+(x*2)/10

Formule specifice clientului

În secțiunea „Formule specifice clientului” se pot specifica calcule diferite pentru fiecare client. Pentru aceasta sunt necesare două date:

• ID-ul clientului
• Formulă

ID-ul clientului este un identificator numeric intern afișat în coloana „ID” din lista „Date de bază / Clienți” a Portalului dispeceratului. Pentru a adăuga o formulă specifică clientului:

1. Căutați ID-ul clientului în meniul Date de bază / Clienți.
2. Introduceți ID-ul în câmpul „ID client”.
3. Introduceți formula corespunzătoare clientului.
4. Dacă este necesar, testați formula.
5. Faceți clic pe butonul „Adăugare”.

Formulele existente ale clienților pot fi șterse folosind butonul de ștergere situat la sfârșitul rândului.

Ordinea de aplicare a formulelor

La crearea expedierii, sistemul:

1. verifică dacă există o formulă specifică pentru client;
2. dacă da, utilizează formula specifică clientului;
3. dacă nu există o formulă specifică, aplică formula implicită.

Testarea formulei

Formula poate fi testată înainte de salvare.

1. În câmpul de testare, introduceți x , adică suma de plată la livrare pe care doriți să o testați.
2. Faceți clic pe butonul „Testați formula”.
3. Sistemul va rula formula.
4. În cazul unui test reușit, va afișa rezultatul calculat.

Testul nu modifică expedierea, ci doar verifică funcționarea formulei.

Formulă incorectă

Dacă formula introdusă nu poate fi interpretată:

• calculul nu se execută;
• câmpul formulei va fi încadrat pentru scurt timp într-un chenar roșu.

În acest caz, verificați:

• corectitudinea parantezelor;
• dacă sunt utilizate semnele de operație permise;
• dacă folosești doar variabila x variabila;
• dacă nu există greșeli de tastare sau semne de operație lipsă.

Exemple

Adăugarea unei sume fixe

x+100

La suma plății la livrare se adaugă 100.

Calcularea unei valori procentuale

x*0.1

Valoarea OP2 este de 10% din suma plății la livrare.

Procent și sumă fixă împreună

(x*0.1)+100

Valoarea OP2 este de 10% din suma plății la livrare, plus 100.

Deducerea unei sume fixe

x-100

Sistemul scade 100 din suma plății la livrare. Rezultatul nu poate fi negativ.

Erori frecvente

Valoarea OP2 nu se actualizează

Verificați:

• dacă webhook-ul a fost creat;
• dacă evenimentul webhook-ului este „Creare expediere”;
• dacă URL-ul corespunzător este inclus în webhook;
• dacă există o sumă de ramburs pentru expediere;
• dacă formula a fost salvată.

Nu se execută formula așteptată

Verificați:

• dacă există o formulă separată pentru client;
• dacă a fost introdus un ID de client corect;
• dacă formula implicită dorită este salvată.

Formula specifică clientului are prioritate față de formula implicită.

Rezultatul este negativ

Componenta suplimentară nu poate utiliza o valoare OP2 negativă. Modificați formula astfel încât rezultatul să fie cel puțin zero pentru orice sumă preconizată a plății la livrare.

Testarea formulei a eșuat

Verificați:

• sintaxa formulei;
• parantezele;
• semnele operaționale;
• utilizarea x utilizarea variabilelor.

Valoarea anterioară a OP2 a dispărut

Suplimentul suprascrie valoarea anterioară a câmpului OP2 la crearea mesajului. Aceasta face parte din funcționalitatea sistemului.