Interfaces – OCI2
Text only available in english
Only difference with OCI interface is the NEW_ITEM-EXT_PRODUCT_ID is now of type long instead of guid. This is needed for further API calls.
As per 2013-03-01 Unifeed can also be used as a SAP OCI 4.0 Provider. In short, the Unifeed catalog can be initiated from the SRM Server and retrieve information from the catalog using the OCI (Open Catalog Interface).
| Interfaces |
Article, Selection list |
|---|---|
| Action | POST to hookUrl |
| Message | OCI message with one or more tradeitems. The tradeitems will be posted as an (one-based) array. |
| Example URL |
For non SAP: https://unifeed.2ba.nl/?interfaceType=OCI2&interface=3&hookUrl=http%3A%2F%2Fmijn.domein.nl%2F |
| Example response |  |
Implementation details (SAP)
- SAP Documentation:
- Version: 4.0
- Method: Call-UP using GET and data return using “Fields” POST (XML variant not implemented)
- Supported additional functions: DETAIL
- Unsupported functions: SOURCING, BACKGROUND_SEARCH and VALIDATE are not implemented. Please contact us if you want to use one of these functions
- URL: https://unifeed.2ba.nl/OCI/Login/
You can define the catalog using code SPRO (Transaction customisations / process flow).
This documentation can be used for PM (Pant Maintenance), PS (Project System) and MM (Material Management) although less settings are possble.
Define catalog in SAP:
Define call detail of catalog (please use your credentials)
!! Pay attention! Change interfaceType to OCI2 in below image.
Define ordertype of catalogus / Map OCI fields to SAP fields (RIHFCOM_XL)
OCI Format mapping
| Field name | Details | Mapping 2BA |
|---|---|---|
| NEW_ITEM-DESCRIPTION[n] char 40 |
Description of the item | TradeItem.Description (Cut to length 40) |
| NEW_ITEM-MATNR[n] char 40 |
SRM product number of the item | |
| NEW_ITEM-QUANTITY[n] char 15 |
Item quantity; 11 digits before the decimal point, 3 after it. Do not use commas for thousands. | The entered quantity on selection or from selectionlist |
| NEW_ITEM-UNIT[n] char 3 |
Quantity unit for item quantity | TradeItem.OrderUnitMeasureUnitCode (ISO codes like PCE, MTR) |
| NEW_ITEM-PRICE[n] char 15 |
Price of an item per price unit; 11 digits before the decimal point, 3 after it. Do not use commas for thousands. | TradeItem.GrossPricePerOrderUnit * Quantity (or when condition server is active and a netprice is found, the netprice will be used) |
| NEW_ITEM-CURRENCY[n] char 5 |
Item currency; Must be maintained as ISO code in the SRM Server. | TradeItem.CurrencyCode |
| NEW_ITEM-PRICEUNIT[n] char 9 |
Price unit of the item (if empty, 1 is used) | |
| NEW_ITEM-LEADTIME[n] char 5 |
Delivery time of the item in days | TradeItem.DeliveryTime (only when TradeItem.DeliveryTimeMeasureUnitCode == 803(days)) |
| NEW_ITEM-LONGTEXT_n:132[] char 8 |
Long text for the item | TradeItem.LongDescription (Mostly not filled) |
| NEW_ITEM-VENDOR[n] char 10 |
SRM vendor number (business partner) for the item | TradeItem.SupplierGLN |
| NEW_ITEM-VENDORMAT[n] char 40 |
Vendor product number for the item | TradeItem.TradeItemId |
| NEW_ITEM-MANUFACTCODE[n] char 10 |
SRM manufacturer number of the item | TradeItem.ManufacturerGLN / Product.ManufacturerGLN |
| NEW_ITEM-MANUFACTMAT[n] char 40 |
Item’s manufacturer part number | TradeItem.ManufacturersProductId / Product.ManufacturersProductId |
| NEW_ITEM-MATGROUP[n] char 10 |
SRM material group for the item | TradeItem.AllowanceGroup |
| NEW_ITEM-SERVICE[n] char 1 |
Flag: the item is a service. | |
| NEW_ITEM-CONTRACT[n] char 10 |
SRM contract to which the item refers | |
| NEW_ITEM-CONTRACT_ITEM[n] char 5 |
Item within the SRM contract | |
| NEW_ITEM-EXT_QUOTE_ID[n] char 35 |
Number of an external bid for this item (as reference for a subsequent purchase order) | |
| NEW_ITEM-EXT_QUOTE_ITEM[n] char 10 |
Item of external bid | |
| NEW_ITEM-EXT_PRODUCT_ID[n] char 40 |
Unique database key for this item in the catalog | TradeItem.ID (2BA’s internal ID, used in back-link of the DETAIL function) |
| NEW_ITEM-ATTACHMENT[n] char 255 |
URL of the attachment (the attachment must be accessible for downloading under this URL) | |
| NEW_ITEM-ATTACHMENT_TITLE[n] char 255 |
Title of the attachment (if this is empty the file name from the URL above is used) | |
| NEW_ITEM-ATTACHMENT_PURPOSE[n] char 1 |
Purpose of the attachment. C corresponds here to configuration. | |
| NEW_ITEM-EXT_SCHEMA_TYPE[n] char 10 |
Name of a schema via which it was imported in the SRM Server | |
| NEW_ITEM-EXT_CATEGORY_ID[n] char 60 |
Unique key for an external category from the schema above, independent of the version of the schema | |
| NEW_ITEM-EXT_CATEGORY[n] char 40 |
Unique key for an external category from the schema above, dependent on the version of the schema | |
| NEW_ITEM-SLD_SYS_NAME[n] char 60 |
Name of a system in the System Landscape Directory (SLD)
|
|
| NEW_ITEM-CUST_FIELD1[n] char 10 |
An ETIM product class is a standard description of a group of products that correspond physically and / or functionally and can therefore be described with the same set of characteristics and limit values according to the ETIM classification. | Productclass |
| NEW_ITEM-CUST_FIELD2[n] char 10 |
Number that indicates how many units per order must be taken as a minimum. | MinimumOrderQuantity |
| NEW_ITEM-CUST_FIELD3[n] char 10 |
The number that indicates in which multiple the article can be ordered.Example: The minimum purchase is one box of light bulbs (1 piece), where the step size is 5 pieces. One can then place orders in the series 5, 10, 15, 20, etc. boxes of light bulbs. | OrderMultiple |
| NEW_ITEM-CUST_FIELD4[n] char 20 |
User-defined field | TradeItem.SupplierGLN (same as NEW_ITEM-VENDOR[n]) |
| NEW_ITEM-CUST_FIELD5[n] char 50 |
User-defined field | TradeItem.Price.GrossPriceInOrderUnit (the gross price of one ordered tradeitemid) |
