PunchOut via OCI | Create OCI and cXML PunchOut Catalogues

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

Parameters	Note
username	see PunchCommerce customer
password	see PunchCommerce customer
HOOK_URL	The return address to the calling system is to be transferred here, e.g. a URL or the value SAPEVENT:POST

Return 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.

Parameters	Note
NEW_ITEM-DESCRIPTION	Name of the product
NEW_ITEM-QUANTITY	Quantity in basket
NEW_ITEM-UNIT	Unit currently always "PCE"
NEW_ITEM-PRICE	Net sales price
NEW_ITEM-CURRENCY	Currency currently always "Euro"
NEW_ITEM-VENDORMAT	Article number
NEW_ITEM-EXT_PRODUCT_ID	Id of the product in our system
NEW_ITEM-LEADTIME	Delivery time in days if set

Extended 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:

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

Sourcing / Product Search

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

Additional required parameters:

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=knopf

Further information on the OCI protocol

Further documentation on the OCI 5.0 standard can be found in the SAP Wiki at https://wiki.scn.sap.com/wiki/download/attachments/395284636/OCI_50_EN20130121.pdf