Umsetzungstabellen

Überblick

• Umsetzungstabellen werden verwendet, um Werte beim Datenaustausch zwischen Shopware und WinLine zu transformieren.
• Typische Anwendungsfälle: Anreden umsetzen (mr → Herr), Zahlungsarten zuordnen, Versandarten mappen.
• Die Tabellen werden sowohl beim Bestellimport (Order-Mapping) als auch bei der Feldzuordnung (Artikel-Mapping) eingesetzt.
• Umsetzungstabellen werden als JSON- oder YAML-Dateien im Unterordner Umsetzungstabellen/ des Mapping-Verzeichnisses abgelegt.
• Es wird ein Wildcard-Zeichen (*) unterstützt für flexible Zuordnungen.

Ziel ist es mit Umsetzungstabellen die aus Shopware kommenden Werte beim Belegimport, auf WinLine Werte zu mappen.

Beispiel: Aus einem englischen Anredekürzel aus Shopware soll eine deutsche Anrede für den WinLine Beleg generiert werden.

Einrichtung - einfache Umsetzung

mapping:

"Anrede":{
    "winline": "Lief.Anrede",
    "shop": "salutation", 
    "eval": "self.umsetzungstabelle('Umsetzung_Anrede', wl_data)"
    },

Order-Mapping\Umsetzungstabellen\Umsetzung_Anrede.json (oder .yml)

{
    "mr": "Herr",
    "mrs": "Frau"
}

zweifache Umsetzung

Im nachfolgenden Beispiel werden aus der Kombination aus payment.id & paymentStatus.id ein entsprechender Belegart-Wert in der WinLine generiert.
mapping:

"OP-Kennzeichen": {
        "winline": "Belegart",
        "shop": ["payment.id", "paymentStatus.id"],
        "concat_string_shop": "|",
        "eval": "self.umsetzungstabelle('Umsetzung_OP', wl_data)"
        },

Order-Mapping\Umsetzungstabellen\Umsetzung_OP.json (oder .yml)
“*” - dient als Füllwert für nicht explizit genannte Kombinationsoptionen

{
    "5|*": "B",
    "7|12": "P", 
    "7|17": "O",
    "7|18": "O",
    "7|*": "O"
}

Siehe auch: Feldzuordnung für die Verwendung von Umsetzungstabellen im Mapping.