PunchOut über OCI Gateway | OCI und cXML PunchOut-Kataloge erstellen | PunchCommerce                           ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

PunchOut über OCI Gateway
=========================

Der Gateway-Modus ermöglicht den direkten Einkauf innerhalb Ihrer E-Commerce-Anwendung ohne, dass diese sich auf einer technischen Ebene mit dem OCI-Protokoll auseinandersetzen muss.

Verwaltung von Kunden
---------------------

Die initiale Anlage und die spätere Aktualisierung von Kunden erfolgt durch Sie über die PunchCommerce-Weboberfläche. Für jeden Kunden sind durch Sie die nachfolgenden Parameter zu pflegen:

ParameterBeschreibungFeldmappingFür den Kunden zu verwendendes FeldmappingEinsprungadresseAdresse zu der der Kunde nach erfolgreicher Authentifizierung weitergeleitet wirdKundenkennungWert der zur Identifizierung des Kunden an die Einsprungadresse übergeben wirdAuthentifizierung und Weiterleitung in Ihren Onlineshop
-------------------------------------------------------

Die Authentifizierung am Gateway erfolgt wie üblich durch Aufruf der PunchCommerce Einsprungadresse und Übergabe der nachfolgenden Parameter.

ParameterWertusernameKunden-Benutzername aus der PunchCommerce-OberflächepasswordKunden-Passwort aus der PunchCommerce-OberflächeHOOK\_URLRücksprungadresse in das ERP-System, Standard ist "SAPEVENT:POST"actions\[\]Liste der OCI-Actions (detail, search, background-search)ordernumberBestellnummer, wird für die detail Action übergebenkeywordSuchbegriff, wird für search und background-search Action übergebenNach der erfolgreichen Authentifizierung des Kunden erfolgt die Weiterleitung an die, in der Kundenkonfiguration (siehe Verwaltung von Kunden) definierte, Einsprungadresse.

Die Einsprungadresse wird hierbei um die Parameter sID (Session-Identifier) und uID (Kundenkennung) erweitert, sodass die endgültige URL nach dem nachfolgenden Schema aufgebaut ist:

```
    https://{hostname}.{domain}.{tld}?sID={UUID}&uID={customer.identifier}
```

Die Authentifizierung im Lieferantensystem obliegt dem Lieferanten. Für Shopware, JTL und Magento 2 bieten wir fertige Erweiterungen an, die Sie aus dem jeweiligen Plugin-Store beziehen können.

Unterstütze OCI-Funktionalität
------------------------------

PunchCommerce unterstützt den PunchOut in einem iFrame innerhalb des aufrufenden Systems und den PunchOut in einem separaten Browser. Die funktionalen Erweiterungen des OCI-Standards, die durch die Version 5.0 des OCI-Protokolls ergänzt wurden, werden für den Gateway-Betrieb wie folgt unterstützt:

- DETAIL
- SOURCING
- BACKGROUND\_SEARCH

Die SAP OCI 5.0 Spezifikation ist abrufbar unter [https://www.punchcommerce.de/static/OCI\_50\_EN20130121.pdf](https://www.punchcommerce.de/static/OCI_50_EN20130121.pdf)

Übermittlung des Warenkorbes (PunchOut)
---------------------------------------

Nachdem der Kunde seinen Einkaufsprozess abgeschlossen hat, muss die E-Commerce-Anwendung des Lieferanten den Warenkorb als JSON-Objekt gemeinsam mit dem Session-Identifer (sID) zurück an unsere Gateway-Lösung übermitteln.

Hier ist ein http-POST-Request auf die Adresse } auszuführen der Request-Body sollte den Warenkorb analog der nachfolgenden Struktur enthalten.

```
{
  "basket":[
        {
            "product_ordernumber": "10001",
            "product_name": "Klettergerüst",
            "quantity": 1.50,
            "item_price": 100,
            "price": 178.50,
            "price_net": 150,
            "tax_rate": 19,
            "product": {
                "id": "42",
                "ordernumber": "10001",
                "brand": "Netzdirektion",
                "brand_ordernumber": "999999",
                "customer_ordernumber": "2342343295649586"
                "title": "Klettergerüst",
                "category": "Kinderspielgeräte",
                "description": "Ein pädagogisch wertvolles Klettergerüst.",
                "description_long": "Nullam quis risus eget urna mollis ornare vel eu leo. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Vestibulum id ligula porta felis euismod semper. Donec id elit non mi porta gravida at eget metus.",
                "image_url": "",
                "price": 2623,
                "tax_rate": 19,
                "purchase_unit": null,
                "reference_unit": null,
                "unit": null,
                "unit_name": null,
                "packaging_unit": "Palette",
                "weight": 230,
                "shipping_time": 23,
                "classification_type": "ECLASS",
                "classification": "90909090",
                "custom_field1": "0.19",
                "custom_field2": "BX",
                ...
                "custom_field10": null
            }
        }
    ]
}
```

PunchCommerce wendet die für Ihren Kunden definierte Feldzuordnung auf den Warenkorb an und übermittelt den Warenkorb an das aufrufende ERP-System über das OCI-Protokoll.

Swagger-Dokumentation
---------------------

Die jeweils aktuelle API-Spezifikation finden Sie unter:

 [ 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!")