PunchOut via OCI | Create OCI and cXML PunchOut Catalogues | PunchCommerce                            ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

PunchOut via OCI
================

We support PunchOut via the OCI protocol. The functions introduced in OCI 5.0 (Validate, Sourcing, Detail, etc.) are also supported. Please ensure that the calling system passes all parameters via HTTP-POST.

Calling up the PunchOut catalogue
---------------------------------

ParameterNoteusernamesee PunchCommerce customerpasswordsee PunchCommerce customerHOOK\_URLThe redirect URL to the calling system must be provided here; for example, a URL or the value SAPEVENT:POSTResponse to the purchasing system
---------------------------------

On the return path to the calling system, we return the following values for each item in the shopping basket to the calling system. You have the option to configure a separate field mapping for each of your PunchOut customers.

ParameterNoteNEW\_ITEM-DESCRIPTIONProduct nameNEW\_ITEM-QUANTITYQuantity in the shopping basketNEW\_ITEM-UNITUnit (currently always “PCE”)NEW\_ITEM-PRICENet sales priceNEW\_ITEM-CURRENCYCurrency (currently always “Euro”)NEW\_ITEM-VENDORMATItem numberNEW\_ITEM-EXT\_PRODUCT\_IDProduct ID in our systemNEW\_ITEM-LEADTIMEDelivery time in days, if setExtended OCI functions (OCI 5.0 only)
-------------------------------------

This document describes how to access the extended OCI function calls introduced with the OCI Standard version 5.0.

**Note:** Customer-specific field mapping is taken into account for all functions.

### Detailed Display of a Product or Service

This functionality allows you to access the detailed view of a product, which is identified by its order number.

**Additional required parameters:**

ParameterNoteFUNCTIONDETAILPRODUCTID*Product order number***Example URL:**

```
https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=DETAIL&PRODUCTID=50123

```

---

### Sourcing / Product Search

This functionality corresponds to a search that returns a list of all matching products.

**Additional parameters required:**

ParameterNoteFUNCTIONSOURCINGSEARCHSTRING*Search term***Example URL:**

```
  https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=SOURCING&SEARCHSTRING=knopf
```

### Background Search

Cross-catalogue product search. The user enters a search term once into the SRM server application, and this term is passed on to all catalogues that support this function when the catalogues are called up.

ParameterNoteFUNCTIONBACKGROUND\_SEARCHSEARCHSTRING*Search term***Example URL:**

```
  https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=BACKGROUND_SEARCH&SEARCHSTRING=knopf
```

Further information on the OCI protocol
---------------------------------------

Further documentation on the OCI 5.0 standard can be found on the SAP Wiki at [https://www.punchcommerce.de/static/OCI\_50\_EN20130121.pdf](https://www.punchcommerce.de/static/OCI_50_EN20130121.pdf)

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

 [Give feedback now - your opinion helps us to become even better!](https://easy-feedback.de/umfrage/1883200/5FuM95 "Your opinion helps us to become even better!")