OCI

Open Catalog Interface

Starting the OCI process

There are two ways to start the OCI process:

1. By means of GET (parameter transfer in the URL)
2. By means of POST (directly from SAP SRM / parameters are stored in the SAP configuration)

The GET case requires you to know the HOOK_URL for your system. You start the OCI process for our online shops by calling the following URLs:

https://www.alltron.ch/oci
https://www.brack.ch/oci

Both online shops support both the GET case and the POST case.

It is important that you note the following:

• The way in which the URL and parameters are written (upper and lower case letters)
• Passwords are not permitted to contain a # character
• You cannot call the MyAccount area for the shops after starting the process via OCI
• In the USERNAME and PASSWORD parameters, you submit your web shop login data

Sample URL (GET case):

https://www.alltron.ch/oci?HOOK_URL=www.url.ch&USERNAME=oci@brack.ch&PASSWORD=1234

Process

• When you call OCI URL, the web shop account submitted in the USERNAME parameter is automatically logged on in our online shop and the submitted HOOK_URL is saved. At the same time, the shopping basket is emptied.
• The shopping basket can now be filled with the desired products.
• To send the contents of the shopping basket to the submitted HOOK_URL, go to checkout or view the shopping basket.
• To transfer the products to your system, press the red «SEND OCI» button at the end of the shopping basket overview.

IN parameters (submitted when the function is called)

Name	Value
HOOK_URL	URL to which you want to send the shopping basket (mandatory field for GET)
USERNAME	Email address of your web shop account (mandatory field)
PASSWORD	Password of your web shop account (mandatory field)
matgroup	If submitted, returned via parameter NEW_ITEM-MATGROUP
vendor	If submitted, returned via parameter NEW_ITEM-VENDOR
language	fr/de (language displayed when you start the shop)
FUNCTION=DETAIL&PRODUCTID=SKU	If submitted, display corresponding product detail page

 

OUT parameters (returned to the calling system)

Name	Value
NEW_ITEM-DESCRIPTION	Item short text
NEW_ITEM-QUANTITY	Quantity
NEW_ITEM-UNIT	Unit of measure (fixed value PCE)
NEW_ITEM-PRICE	Net item price (excluding VAT)
NEW_ITEM-CURRENCY	Currency (fixed value CHF)
NEW_ITEM-LEADTIME	Number of days from today until the product is available
NEW_ITEM-VENDORMAT	SKU (item number)
NEW_ITEM-MATGROUP	eClass number (or value from IN parameter "matgroup")
NEW_ITEM-PRICEUNIT	1
NEW_ITEM-CUST_FIELD1	VAT percentage
NEW_ITEM-VENDOR	Value from IN parameter "vendor"