additionalCosts in MERGEPORT

Das Feld additionalCosts in MERGEPORT-Bestellungen enthält zusätzliche Gebühren, die von der jeweiligen Bestellplattform erhoben werden.

Verständnis dynamischer Zusatzkosten

Das Feld additionalCosts ist kein fest definiertes Enum. Die Werte sind freie Textfelder und hängen vollständig vom jeweiligen Anbieter ab (z. B. Wolt, Lieferando, Uber Eats, Foodora).

Das bedeutet:

Es gibt keine feste Liste möglicher Werte.
Neue Werte können jederzeit auftreten.
Bezeichnungen können sich zwischen Plattformen unterscheiden.

Beispiele für Werte

Hier sind einige Beispiele für additionalCosts, die bisher in der Praxis beobachtet wurden:

Delivery (Liefergebühr)
Service Fee (Servicegebühr)
Extra Distance (Entfernungszuschlag)
Discount Delivery (Rabattierte Lieferung)
Minimum Order Surcharge (Mindestbestellwert-Zuschlag)
Campaign Surcharge (Kampagnenzuschlag)
Priority Delivery Fee (Priorisierte Lieferung)

Empfohlene Implementierung

Für eine robuste Integration sollte das Kassensystem oder Backend folgende Punkte berücksichtigen:

1. Bekannte Werte gezielt behandeln

Falls für die Benutzeroberfläche (UI) oder die interne Logik notwendig, können bekannte Werte übersetzt oder gemappt werden:

Delivery → Liefergebühr
Service Fee → Servicegebühr

2. Unbekannte Werte korrekt verarbeiten

Es darf nicht davon ausgegangen werden, dass alle Werte vorab bekannt sind. Das System sollte:

Unbekannte Werte trotzdem anzeigen oder verarbeiten.
Nicht fehlschlagen oder Daten ignorieren.
Diese als generische Zusatzkosten behandeln.

3. Leichte Normalisierung anwenden (empfohlen)

Wir empfehlen eine einfache Normalisierungsschicht im Backend/Kassensystem:

Entfernen von Unterstrichen (z. B. service_fee → Service Fee)
Umwandlung von camelCase in lesbaren Text (z. B. serviceFee → Service Fee)
Mapping ähnlicher Begriffe auf gemeinsame Kategorien

Best Practice

Hardcoden Sie keine feste Liste von Zusatzkosten.
Verarbeiten Sie alle Einträge, die im Feld additionalCosts übergeben werden.
Gestalten Sie die Implementierung flexibel und zukunftssicher.

Eskalation / Support

Wenn diese Schritte das Problem nicht beheben, wenden Sie sich an support@mergeport.com.