Magento 2 / Adobe Commerce | OCI und cXML PunchOut-Kataloge erstellen | PunchCommerce                           ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

Magento 2 / Adobe Commerce
==========================

Unsere kostenlose Erweiterung für Magento 2 ermöglicht Ihne die Nutzung unseres OCI- oder cXML-Gateway-PunchOuts in Verbindung mit Ihrem Magento-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 die aktuelle Version der Erweiterung herunter und installieren Sie sie in Ihrem Magento 2 Onlineshop. Die aktuelle Version unseres Moduls finden Sie [hier](/de/downloads)

#### Einrichtung 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) inkl. der Platzhalter {{uID}} und {{sID}} und die Kundenkennung konfigurieren

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

```
https://../punchcommerce/authenticate/index/?sId={{sID}}&uId={{uID}}
```

#### Installation in Magento 2

![](https://www.punchcommerce.de/storage/media/support-articles/magento-2/plugin-configuration.png)

Das Modul kann auf zwei unterschiedliche Arten installiert werden:

- **Variante 1:** Platzieren Sie das Modul in einem Path-Repository für composer und führen Sie den nachfolgenden Befehl aus: `composer require ecentral/module-punchcommerce`
- **Variante 2:** Kopieren Sie die Modul-Dateien in das Verzeicnis `./app/code/Ecentral/PunchCommerce`

Im nächsten Schritt müssen Sie, unabhängig davon welche der beiden Varianten Sie gewählt haben, die nachfolgenden Befehle ausführen:

```
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
```

#### Konfiguration in Magento 2

![](https://www.punchcommerce.de/storage/media/support-articles/magento-2/customer-configuration.png)

1. Erstellen Sie einen Magento-Kunden und legen Sie im Attribut „PunchCommerce-Kunden-ID“ eine PunchCommerce-Kennung fest.
2. Aktivieren Sie das Modul unter "Stores > Konfiguration > PunchCommerce > PunchCommerce-Einstellungen"
3. Legen Sie fest, ob der Benutzer vor dem Aktualisieren der Sitzung gefragt werden soll, ob der Warenkorb zwangsweise geleert werden soll.
4. Um den Punchout in einem iFrame mit auszuführen, müssen Sie das Konfigurationsfeld „Frame Ancestor“ auf die Domäne setzen, die den iFrame bereitstellt. Sie können mehrere durch Leerzeichen getrennte Domänen festlegen. 5.Passen Sie die Produktzuordnung an. Die zugehörige Dokumentation finden Sie auch unterhalb des Konfigurationsfelds im Magento-Backend.
5. **Optional** Legen Sie die Hook-URL so fest, dass sie auf Ihre PunchCommerce Server-Instanz verweist. Sie müssen diesen Wert nur anpassen, wenn Sie PunchCommerce-Enterprise-Nutzer sind.

**Beispiel-Konfiguration Feldzuordnung in Magento**

```
{
  "field1": {
    "type":
    "target":
    "value":
  },
  "field2": {
    ...
  },
  ...
}
// Must contain definitions for fields: brand, price, tax_rate, purchase_unit, packaging_unit, shipping_time
```

### Anpassungen an Ihrem Webserver

Da bei einem PunchOut Ihr Onlineshop i.d.R. als iFrame innerhalb der E-Procurement-Anwendung Ihres Kunden dargestellt wird, ist eine Anpassung der Webserver-Konfiguration erforderlich.

**Apache**

Es ist notwendig, die Zeile 289 in der Datei pub/.htaccess zu entfernen oder zu kommentieren:

```
Header set X-Frame-Options SAMEORIGIN
```

Diese Zeile verhindert, dass die Website in iFrames geladen wird.

**Hinweis:** Stellen Sie sicher, dass durch diese Änderung keine Sicherheitsrisiken entstehen. Es könnte nötig sein, andere Sicherheitsmaßnahmen zu verstärken, um den Schutz vor Clickjacking-Angriffen beizubehalten.

**Nginx**

Die folgende Zeile könnte ebenfalls verhindern, dass die Website in iFrames geladen wird:

```
add_header X-Frame-Options "SAMEORIGIN";
```

**Hinweis:** Da diese Konfiguration noch nicht getestet wurde, ist es empfehlenswert, Tests durchzuführen, um sicherzustellen, dass keine Funktionalität der Website beeinträchtigt wird. Es kann nötig sein, die Konfiguration anzupassen oder alternative Sicherheitsmaßnahmen zu ergreifen.

 [ PunchCommerce® ist ein Produkt der ![Netzdirektion GmbH](https://www.punchcommerce.de/static/netzdirektion-logo.png "PunchCommerce® ist ein Produkt der netzdirektion | Gesellschaft für digitale Wertarbeit mbH") ](https://netzdirektion.de)

 [Feedback erwünscht - Ihre Meinung hilft uns, noch besser zu werden!](https://easy-feedback.de/umfrage/1883200/5FuM95 "Ihre Meinung hilft uns, noch besser zu werden!")