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.
| Parameter | Note |
|---|---|
| username | see PunchCommerce customer |
| password | see PunchCommerce customer |
| HOOK_URL | The redirect URL to the calling system must be provided here; for example, a URL or the value SAPEVENT:POST |
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.
| Parameter | Note |
|---|---|
| NEW_ITEM-DESCRIPTION | Product name |
| NEW_ITEM-QUANTITY | Quantity in the shopping basket |
| NEW_ITEM-UNIT | Unit (currently always “PCE”) |
| NEW_ITEM-PRICE | Net sales price |
| NEW_ITEM-CURRENCY | Currency (currently always “Euro”) |
| NEW_ITEM-VENDORMAT | Item number |
| NEW_ITEM-EXT_PRODUCT_ID | Product ID in our system |
| NEW_ITEM-LEADTIME | Delivery time in days, if set |
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.
This functionality allows you to access the detailed view of a product, which is identified by its order number.
Additional required parameters:
| Parameter | Note |
|---|---|
| FUNCTION | DETAIL |
| PRODUCTID | Product order number |
Example URL:
https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=DETAIL&PRODUCTID=50123
This functionality corresponds to a search that returns a list of all matching products.
Additional parameters required:
| Parameter | Note |
|---|---|
| FUNCTION | SOURCING |
| SEARCHSTRING | Search term |
Example URL:
https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=SOURCING&SEARCHSTRING=knopfCross-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.
| Parameter | Note |
|---|---|
| FUNCTION | BACKGROUND_SEARCH |
| SEARCHSTRING | Search term |
Example URL:
https://punchcommerce.de/gateway/v3/authenticate?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=BACKGROUND_SEARCH&SEARCHSTRING=knopfFurther documentation on the OCI 5.0 standard can be found on the SAP Wiki at https://www.punchcommerce.de/static/OCI_50_EN20130121.pdf
