CalMate

A CalMate kiegészítő automatikusan kiszámítja a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. Opcionális paraméter 2 (OP2) mezőjének értékét az utánvét összegéből. A számítás a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozása után fut le. A kiegészítőhöz megadható egy alapértelmezett képlet, valamint ügyfelenként külön képlet is.

Előfeltételek

• előfizetett Deliveo API-kapcsolat;
• előfizetett Deliveo webhookhasználat;
• jogosultság a kiegészítő telepítéséhez, beállításához és használatához.

Telepítés és elérés

A kiegészítő a Diszpécserportálon, a Kiegészítők menüpont alatt telepíthető. Telepítés után a Kiegészítők / CalMate menüpontban érhető el. A kiegészítőt csak megfelelő jogosultsággal rendelkező felhasználó telepítheti és használhatja.

Működési elv

A képletben az x az utánvét összegét jelenti.

Példa:

(x * 0.1) + 100

Ha az utánvét összege 1000, akkor:

• x = 1000
• az OP2 számított értéke 200

A képletben használható matematikai műveletek:

• +
• -
• *
• /
• ()

Fontos szabályok

• A számítás a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozása után fut le.
• Ha az OP2 mezőben már van érték, a kiegészítő felülírja.
• A számított eredmény nem lehet negatív.
• Az eredmény hossza nem haladhatja meg az OP2 mező maximális hosszát.
• Hibás képlet esetén a számítás nem történik meg.

Webhook beállítása

A kiegészítő működéséhez webhookot kell létrehozni.

1. Nyisd meg a Beállítások / Webhook menüpontot.
2. Hozz létre egy egyszerű webhookot.
3. Eseményként válaszd a KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozás eseményt.
4. Másold be a CalMate oldalán megjelenő webhook URL-t.
5. Mentsd el a webhookot.

A webhook URL telepítésenként egyedi, ezért mindig a CalMate saját felületén megjelenő címet használd.

Alapértelmezett OP2 képlet

Az Alapértelmezett OP2 képlet minden olyan ügyfél küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.ére vonatkozik, amelyhez nincs külön ügyfélspecifikus képlet megadva. A beállításhoz:

1. Írd be a képletet az Alapértelmezett OP2 képlet mezőbe.
2. Ellenőrizd a képletet a Próbáld ki a képletet gombbal.
3. Kattints a Mentés gombra.

Példa:

10+(x*2)/10

ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét.specifikus képletek

Az ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét. képletek szakaszban ügyfelenként eltérő számítás adható meg. Ehhez két adat szükséges:

• ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét. ID
• Képlet

Az ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét. ID a Diszpécserportál Törzsadatok / Ügyfelek listájában, az ID oszlopban látható belső numerikus azonosító. ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét.specifikus képlet hozzáadásához:

1. Keresd meg az ügyfél ID-jét a Törzsadatok / Ügyfelek menüpontban.
2. Add meg az ID-t az ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét. ID mezőben.
3. Írd be az ügyfélhez tartozó képletet.
4. Szükség esetén teszteld a képletet.
5. Kattints a Hozzáadás gombra.

A meglévő ügyfélképletek a sor végén található törlés gombbal távolíthatók el.

A képletek alkalmazási sorrendje

A rendszer a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozásakor:

1. megvizsgálja, tartozik-e az ügyfélhez külön képlet;
2. ha igen, az ügyfélspecifikus képletet használja;
3. ha nincs külön képlet, az alapértelmezett képletet alkalmazza.

Képlet tesztelése

A képlet a mentés előtt kipróbálható.

1. A tesztmezőben add meg az x értékét, vagyis a tesztelni kívánt utánvét összeget.
2. Kattints a Próbáld ki a képletet gombra.
3. A rendszer lefuttatja a képletet.
4. Sikeres teszt esetén megjeleníti a számított eredményt.

A teszt nem módosít küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.t, csak ellenőrzi a képlet működését.

Hibás képlet

Ha a megadott képlet nem értelmezhető:

• a számítás nem fut le;
• a képlet mezője rövid időre piros keretet kap.

Ilyenkor ellenőrizd:

• a zárójelek helyességét;
• a használható műveleti jeleket;
• hogy csak az x változót használod-e;
• hogy nincs-e elírás vagy hiányzó műveleti jel.

Példák

Fix összeg hozzáadása

x+100

Az utánvét összegéhez 100 kerül hozzáadásra.

Százalékos érték számítása

x*0.1

Az OP2 értéke az utánvét összegének 10%-a.

Százalék és fix összeg együtt

(x*0.1)+100

Az OP2 értéke az utánvét 10%-a, plusz 100.

Fix összeg levonása

x-100

A rendszer 100-at levon az utánvét összegéből. Az eredmény nem lehet negatív.

Gyakori hibák

Az OP2 értéke nem frissül

Ellenőrizd:

• hogy a webhook létre van-e hozva;
• hogy a webhook eseménye KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozás;
• hogy a megfelelő URL szerepel-e a webhookban;
• hogy a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.hez van-e utánvét összeg;
• hogy a képlet mentve van-e.

Nem a várt képlet fut le

Ellenőrizd:

• hogy van-e az ügyfélhez külön képlet;
• hogy helyes ÜgyfélAz Ügyfél (számlafizető) fizet a Futárszolgálatnak a csomagok kiszállításáért. Lehet egyben a feladója / címzettje is a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.nek. Ő használja a Deliveo ügyfél felületét. ID van-e megadva;
• hogy a kívánt alapértelmezett képlet van-e elmentve.

Az ügyfélspecifikus képlet elsőbbséget élvez az alapértelmezett képlettel szemben.

Az eredmény negatív

A kiegészítő nem használhat negatív OP2 értéket. Módosítsd úgy a képletet, hogy az eredmény minden várható utánvét összegnél legalább nulla legyen.

A képlet tesztelése sikertelen

Ellenőrizd:

• a képlet szintaxisát;
• a zárójeleket;
• a műveleti jeleket;
• az x változó használatát.

Az OP2 korábbi értéke eltűnt

A kiegészítő a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozásakor felülírja az OP2 mező korábbi értékét. Ez a működés része.