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

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

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

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

ParametersNoteusernamesee PunchCommerce customerpasswordsee PunchCommerce customerHOOK\_URLThe return address to the calling system is to be transferred here, e.g. a URL or the value SAPEVENT:POSTReturn to the purchasing system
-------------------------------

On the way back to the calling system, we transfer the following values for each item in the shopping basket back to the calling system. You have the option of configuring a separate field assignment for each of your PunchOut customers.

ParametersNoteNEW\_ITEM-DESCRIPTIONName of the productNEW\_ITEM-QUANTITYQuantity in basketNEW\_ITEM-UNITUnit currently always "PCE"NEW\_ITEM-PRICENet sales priceNEW\_ITEM-CURRENCYCurrency currently always "Euro"NEW\_ITEM-VENDORMATArticle numberNEW\_ITEM-EXT\_PRODUCT\_IDId of the product in our systemNEW\_ITEM-LEADTIMEDelivery time in days if setExtended OCI functions (OCI 5.0 only)
-------------------------------------

This document describes access to the extended OCI function calls introduced with the OCI standard in version 5.0.

**Note:** The customer-specific field assignment is taken into account for all functionalities.

### Detailed Display of a Product or Service

Use this function to access the detailed view of a product, which is identified by the 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 required parameters:**

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 in the SRM server application and this term is transferred to all catalogues that transferred 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 in 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!")