Maßeinheiten

Procurement-Systeme erwarten bei der Warenkorb-Übertragung häufig standardisierte Einheitencodes — zum Beispiel PCE für Stück oder KGM für Kilogramm. Der Connector stellt dafür drei eigenständige Datenfelder zur Verfügung, die im Feld-Mapping frei kombiniert werden können.

Drei Datenfelder für Maßeinheiten

Für die Maßeinheit eines Artikels stehen drei unterschiedliche Datenfelder zur Verfügung:

Datenfeld	Herkunft des Werts
productOciMe	Custom Field am Produkt
productSystemUnit	Systemeinheiten-Tabelle des jeweiligen OCI-/cXML-Systems
systemDefaultUnit	Standardeinheit aus der Systemkonfiguration

Diese drei Felder werden wie jedes andere Datenfeld über Primärfeld und Fallback 1–3 im Feld-Mapping kombiniert (siehe Felder konfigurieren). Der Connector prüft die konfigurierten Quellen von links nach rechts und verwendet den ersten nicht-leeren Wert.

hinweis

Es gibt keine automatische, fest eingebaute Reihenfolge dieser drei Felder. Jedes Feld kann einzeln, in beliebiger Reihenfolge oder gar nicht verwendet werden — die Kombination muss explizit im Feld-Mapping konfiguriert werden.

Empfohlene Beispiel-Konfiguration

So könnte eine typische Standardkonfiguration für ein Maßeinheiten-Feld aussehen:

Primärfeld       Fallback 1            Fallback 2
productOciMe  →  productSystemUnit  →  systemDefaultUnit

Damit wird zuerst eine am Produkt individuell hinterlegte Einheit verwendet. Liefert productOciMe keinen Wert, greift productSystemUnit (Systemeinheiten-Tabelle). Liefert auch das keinen Treffer, wird die globale systemDefaultUnit verwendet.

productOciMe – Custom Field am Produkt

Am Artikel selbst kann im Tab Custom Fields eine Verpackungseinheit hinterlegt werden. Ist dieser Wert gesetzt und als Primärfeld konfiguriert, überschreibt er die anderen Felder für dieses Produkt.

Pfad: Produkte → [Produkt auswählen] → Spezifikationen → Zusatzfelder → Agiqon OCI Produkt

Datenfeld: productOciMe — in der Feld-Konfiguration des Systems verfügbar.

productSystemUnit – Systemeinheiten-Tabelle

Im Tab Maßeinheiten jedes OCI- oder cXML-Systems können Shopware-Einheiten auf die erwarteten Codes des Procurement-Systems gemappt werden. Das Datenfeld productSystemUnit prüft ausschließlich diese Tabelle für die Einheit des jeweiligen Produkts — findet sich dort kein Eintrag, liefert das Feld keinen Wert (kein automatischer Rückgriff auf Custom Field oder Standardeinheit).

Beispiel:

Shopware-Einheit	Übertragungswert
Stück	PCE
Kilogramm	KGM
Liter	LTR
Meter	MTR

So können unterschiedliche Systeme dieselben Shopware-Einheiten auf unterschiedliche Codes mappen.

systemDefaultUnit – Standardeinheit des Systems

In der Systemkonfiguration (OCI oder cXML) unter Tab: Allgemein kann eine Standardeinheit hinterlegt werden. Als Fallback-Feld eingesetzt, greift sie, wenn die vorherigen Felder im Mapping keinen Wert liefern.

Empfehlung: Den häufigsten Einheitencode des Sortiments eintragen (z.B. PCE für Stück).

Wann welches Feld?

• productOciMe: Für Artikel mit einer individuellen, vom Standard abweichenden Einheit
• productSystemUnit: Für unterschiedliche Einheitencodes je Procurement-System
• systemDefaultUnit: Für Sortimente, bei denen fast alles dieselbe Einheit hat