Verfügbare Datenfelder
Hier sind alle Datenfelder aufgeführt, die im Connector zur Verfügung stehen. Diese Felder können in der OCI- und cXML-Konfiguration als Primärfeld oder Fallback eingesetzt werden.
Die Spalte Protokolle zeigt, in welchem Kontext das jeweilige Feld verfügbar ist.
Kontext
Felder, die sich auf den allgemeinen Sitzungskontext (Sales Channel, Sprache, Währung) beziehen.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
currencyIsoCode | ISO-Währungscode der im Kontext aktiven Währung (z. B. EUR) | OCI, cXML |
languageShortCode | Sprach-Kurzcode des Sales Channel (z. B. de-DE) | cXML |
Warenkorb-Position
Felder, die sich auf die einzelne Warenkorb-Position beziehen.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
lineItemQuantity | Bestellmenge der Position | OCI, cXML |
lineItemReference | Referenz-ID der Warenkorb-Position | OCI, cXML |
lineItemTotalPrice | Gesamtpreis der Position (Menge × Einzelpreis) | OCI, cXML |
lineItemUnitPrice | Einzelpreis der Position | OCI, cXML |
lineItemPayloadField | Liest einen Wert aus dem Payload einer Warenkorbposition über einen konfigurierbaren Zusatz-Schlüssel — den Payload-Schlüssel im Konfigurator angeben | OCI, cXML |
Produkt
Felder, die Stammdaten des Produkts zurückgeben.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
productId | Interne Shopware-Produkt-ID | OCI, cXML |
productName | Produktname (sprachabhängig) | OCI, cXML |
productTranslatedName | Übersetzter Produktname | OCI, cXML |
productDescription | Produktbeschreibung (HTML) | OCI, cXML |
productTranslatedDescription | Übersetzte Produktbeschreibung | OCI, cXML |
productNumber | Artikelnummer (SKU) | OCI, cXML |
productEan | EAN / GTIN | OCI, cXML |
productWeight | Gewicht (in Kilogramm) | OCI, cXML |
productWidth | Breite | OCI, cXML |
productHeight | Höhe | OCI, cXML |
productLength | Länge | OCI, cXML |
productTaxRate | Steuersatz in Prozent | OCI, cXML |
productPurchaseUnit | Einkaufseinheit | OCI, cXML |
productPackingUnit | Verpackungseinheit | OCI, cXML |
productPackingUnitPlural | Verpackungseinheit (Plural) | OCI, cXML |
productSystemUnit | Mengeneinheit des Produkts, ermittelt aus der am Connector-System konfigurierten Einheiten-Zuordnung (OCI-/cXML-Einheiten) | OCI, cXML |
productManufacturerName | Herstellername | OCI, cXML |
productManufacturerTranslatedName | Übersetzter Herstellername | OCI, cXML |
productManufacturerNumber | Herstellerartikelnummer (MPN) | OCI, cXML |
Connector Custom Fields (Produkt)
Diese Felder lesen Connector-eigene Custom Fields am Produkt aus.
| Datenfeld | Beschreibung | Custom-Field-Schlüssel | Protokolle |
|---|---|---|---|
productOciEClass | eClass-Klassifikationsnummer | agiqon_oci_e_class | OCI, cXML |
productOciMe | Verpackungseinheit (OCI-spezifisch) | agiqon_oci_me | OCI, cXML |
productUnspsc | UNSPSC-Warengruppenschlüssel | agiqon_connector_unspsc | OCI, cXML |
Shopware Custom Fields (Produkt)
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
productCustomField | Beliebiges Shopware Custom Field am Produkt — den technischen Feldnamen im Konfigurator angeben | OCI, cXML |
Angepasstes Produkt
Felder für Produkte, die mit dem Plugin Customized Products konfiguriert wurden. Für normale Produkte liefern diese Felder keinen Wert.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
customizedProductLabels | Alle Optionsbezeichnungen des angepassten Produkts, verbunden mit | (z. B. Vorname|Nachname) | OCI, cXML |
customizedProductOptions | Alle Optionswerte des angepassten Produkts im Format Bezeichnung: Wert, verbunden mit Zeilenumbruch | OCI, cXML |
Warenkorb
Felder, die sich auf den gesamten Warenkorb beziehen, nicht auf eine einzelne Position.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
cartTaxAmount | Summe der berechneten Steuern des Warenkorbs | OCI, cXML |
Versand
Felder für den Versandposten. Diese Felder sind nur verfügbar, wenn Versand anhängen in der Connector-Konfiguration aktiviert ist.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
shippingName | Name aus der Versandart-Erweiterung, ersatzweise Name der Versandart (siehe Versandarten) | OCI, cXML |
shippingMethodTranslatedName | Übersetzter Name der Versandart — ignoriert die Versandart-Erweiterung bewusst | OCI, cXML |
shippingNumber | Versandnummer — konfigurierbar je Versandart (siehe Versandarten) | OCI, cXML |
shippingInternArticleNumber | Interne Artikelnummer der Versandart | OCI, cXML |
shippingCostsTotalPrice | Gesamtbetrag der Versandkosten (brutto) | OCI, cXML |
shippingCostsNetPrice | Nettobetrag der Versandkosten | OCI, cXML |
shippingCostsTaxAmount | Steueranteil der Versandkosten | OCI, cXML |
shippingCostsTaxRate | Steuersatz der Versandkosten in Prozent (berechnet aus Steueranteil und Gesamtpreis) | OCI, cXML |
shippingName und shippingMethodTranslatedName lassen sich als Primärfeld und Fallback kombinieren: shippingName bevorzugt den in der Versandart-Erweiterung gepflegten Namen, shippingMethodTranslatedName liefert immer den übersetzten Shopware-Namen.
System
Felder, die Werte aus der Connector-Systemkonfiguration des jeweiligen Sales Channel zurückgeben.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
systemDefaultUnit | Standard-Mengeneinheit aus der Connector-Konfiguration | OCI, cXML |
systemTechnicalName | Technischer Name des Connector-Systems | OCI, cXML |
Übertragung
Felder, die Informationen zur laufenden Übertragungssitzung zurückgeben.
| Datenfeld | Beschreibung | Protokolle |
|---|---|---|
sessionTransmissionId | Eindeutige ID der aktuellen Übertragungssitzung | OCI, cXML |
transmissionAdditionalDataField | Liest einen Wert aus dem Zusatzfelder-Payload einer Übertragung über einen konfigurierbaren Zusatz-Schlüssel — den Zusatzfeld-Schlüssel im Konfigurator angeben | OCI, cXML |