Shopware 6 Plugin

Unsere kostenlose Erweiterung für Shopware 6 ermöglicht Ihne die Nutzung unseres OCI- oder cXML-Gateway-PunchOuts in Verbindung mit Ihrem Shopware-Onlineshop. In diesem Szenario übernehmen wir die Kommunikation mit Ihren Kunden bzw. dessen System (Ariba, Oracle oder SAP) und leiten den Kunden nach erfolgreicher Authentifizierung in Ihren Onlineshop weiter.

Einrichtung des Gateway-PunchOuts

Laden Sie zunächst das Plugin über den Shopware-Store herunter und installieren sowie aktivieren Sie es.

In PunchCommerce

1. Legen Sie einen neuen Kunden an und wählen Sie als Modus OCI- oder cXML-Gateway aus
2. Schließen Sie in PunchCommerce die Konfiguration des Kunden ab, in dem Sie die Einsprungadresse (in Ihren Onlineshop) und die Kundenkennung konfigurieren

Hinweis Als Einsprungadresse konfigurieren Sie die Url Ihres Onlineshops nach dem folgenden Schema:

> https://<ihre-domain>.<tld>/<opt. sales-channel>/punchcommerce/authenticate

In Shopware

1. Öffnen Sie einen Kunden der per OCI- oder cXML auf Ihren Shop zugreifen soll
2. Tragen sie die in PunchCommerce vergebene Kundenkennung in das Feld "PunchCommerce-uID" ein
3. Übermitteln Sie Ihrem Kunden die in PunchCommerce erzeugte Zugangsanleitung als PDF

Feldzuordnung für PunchCommerce-Zusatzfelder in Shopware ändern

Hier können Sie beliebige Produkt-Felder aus Shopware während des PunchOut's an PunchCommerce als Zusatzfeld [2 - 10] übergeben. Die Zusatzfelder stehen Ihnen innerhalb von PunchCommerce dann zur Verfügung und können über ein "Feldmapping" (Menü: Kunden -> Feldzuordnungen) dem jeweilgen Protokoll-Feld zugeordnet werden.

Neue Feldzuordnungsoption anlegen

Wenn Ihnen die bereits bestehenden Option nicht ausreichen, weil Sie bspw. ein CustomField des Produktes übergeben möchten, haben Sie die Möglichkeit eigene Feldzurordnungsoptionen anzulegen.

Beispiel:

Sie haben das CustomField "additionInformation" am Produkt in Shopware hinterlegt und möchten nun dass dieses Feld im Rahmen des PunchOuts übergeben wird. Hierzu gehene Sie wie folgt vor:

1. In der Plugin-Konfiguration in Shopware legen wir ein neue Feldzuordnungsoption an. Die Option entspricht dem Mapping auf einem Feld in Shopware. Standardmäßig steht Ihnen hier nur die Entität "product" zur Verfügung. Für unser CustomField "additionInformation" definieren wir die Option wie folgt: "product.customFields.additionInformation"

Erklärung:

  "product": Entspricht dem Namen der Shopware-Entität
  "customFields": Ist der Bezeichner für Zusatzfelder in Shopware
  "additionInformation": Ist der Name Ihres CustomFields

2. Anschließend nehmen Sie die Feldzurdnung nach PunchCommerce vor. In unserem Beispiel würden wir das "Zusatzfeld 2" verwenden. Entsprechend wählen wir nun in der Plugin-Konfiguration für das "Zusatzfeld 2" die Option "product.customFields.additionInformation" aus, welche wir gerade angelegt haben. Das Feld wird nun als "Zusatzfeld 2" im PunchOut an PunchCommerce übergeben.

3. Damit Ihr CustomField "additionInformation" nun von PunchCommerce an Ihr OCISystem übergeben wird müssen Sie in PunchCommerce ein Mapping anlegen (Menü: Kunden -> Feldzuordnungen) und dort das "Zusatzfeld 2" dem gewünschten ProtokollWert zuweisen.

Kompatibilität mit Custom Products für Shopware

Alle zu einem Produkt konfigurierten Optionen werden auf das Feld custom_field1 in unserem Datenmodell nach dem folgenden Schema gemappt:

  {
  "product": {
        [...]
        "custom_field1":"Mit extra So\u00dfe: on; Wunschtext: Mein Wunschprodukt; Datum: 2022-07-14T00:00:00+00:00; Color: Rot,Blau; Zahl: 99; "
       [...]
  }

Gemapped werden nur Konfigurator-Optionen mit einem der folgenden Typen:

[
    'checkbox',
    'colorselect',
    'datetime',
    'textfield',
    'numberfield',
    'select',
    'textarea',
    'timestamp'
]

Das Schema entspricht:

Option-Name . ': ' . Option-Value '; '[...]