CalMate

Das CalMate-Add-on berechnet automatisch den Wert des Feldes „Optionaler Parameter 2“ (OP2) der Sendung anhand des Nachnahmebetrags. Die Berechnung erfolgt nach der Erstellung der Sendung. Für das Add-on kann eine Standardformel sowie eine separate Formel pro Kunde angegeben werden.

Voraussetzungen

• abonnierte Deliveo-API-Verbindung;
• abonnierte Nutzung des Deliveo-Webhooks;
• Berechtigung zur Installation, Konfiguration und Nutzung des Add-ons.

Installation und Zugriff

Das Add-on kann im Dispatcher-Portal unter dem Menüpunkt „Add-ons“ installiert werden. Nach der Installation ist es unter dem Menüpunkt „Add-ons / CalMate“ verfügbar. Das Add-on darf nur von Benutzern mit entsprechenden Berechtigungen installiert und genutzt werden.

Funktionsweise

In der Formel steht x den Betrag der Nachzahlung.

Beispiel:

(x * 0.1) + 100

Wenn der Nachzahlungsbetrag 1000 beträgt, dann:

• x = 1000
• beträgt der berechnete Wert von OP2 200

In der Formel verwendbare mathematische Operationen:

• +
• -
• *
• /
• ()

Wichtige Regeln

• Die Berechnung erfolgt nach der Erstellung der Sendung.
• Wenn im Feld OP2 bereits ein Wert vorhanden ist, wird dieser durch den Zusatzwert überschrieben.
• Das berechnete Ergebnis darf nicht negativ sein.
• Die Länge des Ergebnisses darf die maximale Länge des Feldes OP2 nicht überschreiten.
• Bei einer fehlerhaften Formel wird die Berechnung nicht durchgeführt.

Webhook einrichten

Für die Funktion des Add-ons muss ein Webhook erstellt werden.

1. Öffnen Sie den Menüpunkt „Einstellungen / Webhook“.
2. Erstellen Sie einen einfachen Webhook.
3. Wählen Sie als Ereignis „Sendung erstellen“ aus.
4. Kopiere die auf der CalMate-Seite angezeigte Webhook-URL.
5. Speichere den Webhook.

Die Webhook-URL ist für jede Installation einzigartig, verwende daher immer die Adresse, die auf der CalMate-Oberfläche angezeigt wird.

Standard-OP2-Formel

Die Standard-OP2-Formel gilt für alle Sendungen eines Kunden, für die keine separate kundenspezifische Formel angegeben wurde. So nehmen Sie die Einstellung vor:

1. Geben Sie die Formel in das Feld „Standard-OP2-Formel“ ein.
2. Überprüfen Sie die Formel mit der Schaltfläche „Formel testen“.
3. Klicken Sie auf die Schaltfläche „Speichern“.

Beispiel:

10+(x*2)/10

Kundenspezifische Formeln

Im Abschnitt „Kundenformeln“ können für jeden Kunden unterschiedliche Berechnungen festgelegt werden. Dazu sind zwei Angaben erforderlich:

• Kunden-ID
• Formel

Die Kunden-ID ist die interne numerische Kennung, die im Dispatcher-Portal unter „Stammdaten / Kunden“ in der Spalte „ID“ angezeigt wird. So fügen Sie eine kundenspezifische Formel hinzu:

1. Suchen Sie die Kunden-ID im Menüpunkt „Stammdaten / Kunden“.
2. Geben Sie die ID in das Feld „Kunden-ID“ ein.
3. Geben Sie die zum Kunden gehörende Formel ein.
4. Testen Sie die Formel bei Bedarf.
5. Klicken Sie auf die Schaltfläche „Hinzufügen“.

Bestehende Kundenformeln können über die Schaltfläche „Löschen“ am Ende der Zeile entfernt werden.

Reihenfolge der Formelauswertung

Bei der Erstellung einer Sendung prüft das System:

1. ob für den Kunden eine eigene Formel vorhanden ist;
2. wenn ja, wendet es die kundenspezifische Formel an;
3. gibt es keine eigene Formel, wendet es die Standardformel an.

Formel testen

Die Formel kann vor dem Speichern getestet werden.

1. Geben Sie im Testfeld den x Wert ein, d. h. den zu testenden Nachnahme-Betrag.
2. Klicken Sie auf die Schaltfläche „Formel testen“.
3. Das System führt die Formel aus.
4. Bei erfolgreichem Test wird das berechnete Ergebnis angezeigt.

Der Test nimmt keine Änderungen an der Sendung vor, sondern überprüft lediglich die Funktionsweise der Formel.

Fehlerhafte Formel

Wenn die angegebene Formel nicht interpretiert werden kann:

• wird die Berechnung nicht ausgeführt;
• wird das Feld der Formel kurzzeitig rot umrandet.

Überprüfen Sie in diesem Fall:

• die Richtigkeit der Klammern;
• die zulässigen Rechenzeichen;
• ob du ausschließlich die x Variable verwendet wird;
• ob es keine Tippfehler oder fehlende Rechenzeichen gibt.

Beispiele

Addition eines festen Betrags

x+100

Zum Nachnahmebetrag werden 100 addiert.

Berechnung eines prozentualen Werts

x*0.1

Der Wert von OP2 beträgt 10 % des Nachnahme-Betrags.

Prozentsatz und Festbetrag zusammen

(x*0.1)+100

Der Wert von OP2 beträgt 10 % des Nachnahme-Betrags plus 100.

Abzug eines Festbetrags

x-100

Das System zieht 100 vom Nachnahmebetrag ab. Das Ergebnis darf nicht negativ sein.

Häufige Fehler

Der Wert von OP2 wird nicht aktualisiert

Überprüfen Sie:

• ob der Webhook eingerichtet ist;
• ob das Webhook-Ereignis „Sendung erstellen“ ist;
• ob die richtige URL im Webhook angegeben ist;
• ob für die Sendung ein Nachnahmebetrag angegeben ist;
• ob die Formel gespeichert ist.

Es wird nicht die erwartete Formel ausgeführt

Überprüfen Sie:

• ob für den Kunden eine eigene Formel vorhanden ist;
• ob die richtige Kunden-ID angegeben ist;
• ob die gewünschte Standardformel gespeichert ist.

Die kundenspezifische Formel hat Vorrang vor der Standardformel.

Das Ergebnis ist negativ

Das Add-on darf keinen negativen OP2-Wert verwenden. Passen Sie die Formel so an, dass das Ergebnis bei jedem erwarteten Nachzahlungsbetrag mindestens null beträgt.

Die Formelprüfung ist fehlgeschlagen

Überprüfen Sie:

• die Syntax der Formel;
• die Klammern;
• die Rechenzeichen;
• die x Verwendung der Variablen.

Der vorherige Wert von OP2 ist verschwunden

Das Addendum überschreibt bei der Erstellung der Sendung den bisherigen Wert des Feldes OP2. Dies ist Teil der Funktionsweise.