Produkt-Erweiterungen
Der AgiqonConnector liest am Shopware-Produkt drei zusätzliche Custom Fields aus, die speziell für die OCI- und cXML-Übertragung gedacht sind.
Custom Fields am Produkt
Die Felder stehen beim Bearbeiten eines Artikels unter Produkte → Spezifikationen → Zusatzfelder zur Verfügung, verteilt auf zwei Karten:
| Feld | Karte | Technischer Name (Datenfeld) | Beschreibung |
|---|---|---|---|
| eClass-Nummer | Agiqon OCI Produkt | productOciEClass | Klassifikationsnummer nach eCl@ss-Standard (z.B. 19-09-08-01) |
| Verpackungseinheit | Agiqon OCI Produkt | productOciMe | Artikelspezifische Einheit — in der Standardkonfiguration als Primärfeld vor System- und Standardeinheit |
| UNSPSC-Nummer | Agiqon Connector | productUnspsc | Warengruppenschlüssel nach UNSPSC |
Die Karte Agiqon Connector mit der UNSPSC-Nummer wird seit 3.7.500 / 3.6.300 vom Plugin selbst angelegt — bei der Installation wie beim Update. Die Felder der Karte Agiqon OCI Produkt stammen aus der Vorgängerversion und werden vom Connector nur gelesen; fehlen sie, müssen sie als Shopware-Zusatzfelder manuell angelegt werden.
eClass-Nummer
eCl@ss ist ein internationaler Standard für die Klassifikation und Beschreibung von Produkten und Dienstleistungen. Viele Procurement-Systeme, besonders im B2B- und öffentlichen Bereich, erwarten diesen Code in der Übertragung.
Verwendung: Das Datenfeld productOciEClass kann in der Feld-Konfiguration eines OCI- oder cXML-Systems als Primärfeld oder Fallback für ein beliebiges Übertragungsfeld eingesetzt werden — z.B. für NEW_ITEM-MATGROUP (OCI) oder eine entsprechende cXML-Klassifikation.
UNSPSC-Nummer
UNSPSC (United Nations Standard Products and Services Code) ist ein internationaler Warengruppenschlüssel. In cXML ist er die übliche Domain des Classification-Elements, in OCI kann er als Warengruppenschlüssel dienen.
Verwendung: Die cXML-Standardsysteme befüllen damit ab Werk <Classification domain="UNSPSC">. In der Feld-Konfiguration lässt sich das Datenfeld productUnspsc wie jedes andere als Primärfeld oder Fallback einsetzen — in OCI zum Beispiel für NEW_ITEM-MATGROUP.
Verpackungseinheit am Produkt
Die artikelspezifische Verpackungseinheit wird über das Datenfeld productOciMe gelesen. Ob sie Vorrang vor der Systemeinheiten-Tabelle (productSystemUnit) und der Standardeinheit (systemDefaultUnit) hat, hängt davon ab, ob productOciMe im Feld-Mapping als Primärfeld konfiguriert ist — in der Standardkonfiguration ist das der Fall. Eine feste, eingebaute Rangfolge gibt es nicht.
Wann verwenden: Für Artikel, bei denen der Einheitencode vom allgemeinen Standard abweicht — z.B. ein Artikel, der in Metern statt in Stück verkauft wird, während der Rest des Sortiments in Stück übertragen wird.
Mehr zur Einheitenlogik: Maßeinheiten