Integration Procurement systems

Datum: 2023-01-23
Versie: 0.2

Corporate customers often use Procurement systems for their purchasing processes. Ecmanage can integrate with these systems as long as the validation functionality in the Ecmanage shopping cart is used and the customer uses individual user accounts to access their ecmanage environment.

There are two common variants for this type of integration OCI Punch in Punch out and cXML protocol.

How is the integration structured

This infographic describes the interaction between the respective systems:

ecmanage oci integration purchasing systems.

The integration between Ecmanage and procurement systems can also work with Single Sign On to prevent the end user having to identify themselves through an Ecmanage login page.

Template based shoppingcart transfer using OCI

When we configure the OCI integration for your customer we agree the data to be transferred through a template. As an example we usually have the following fields in the template:

OCI Field

Value

1

NEW_ITEM-DESCRIPTION[1]

Ladies Uniform jumper Blue

2

NEW_ITEM-QUANTITY[1]

1

3

NEW_ITEM-PRICE[1]

36.55

4

NEW_ITEM-EXT_PRODUCT_ID[1]

CUSTDEMO215559

5

NEW_ITEM-VENDORMAT[1]

58561_6200-34

6

NEW_ITEM-VENDOR[1]

SUPPLIER_ABC

7

NEW_ITEM-CURRENCY[1]

EUR

8

NEW_ITEM-UNIT[1]

34

cXML protocol

The cXML protocol follows the following pattern: Ecmanage receives a PunchOutSetupRequest message through an http POST. Ecmanage answers using PunchOutSetupResponse with a reference to the correct StartPage. This startpage has a limited lifetime. Using the startpage a purchaser can place an order, at the end of the ordering process the shopping cart is sent to the procurement system using a PunchOutOrderMessage. The orders then needs to be approved in the procurement system.

Confirmation message approval purchase order

In order to tell the Ecmanage environment that the purchase order has been approved we expect a message to have the Ecmanage ordernumber and the purchase ordernumber. This message can be sent using an https POST message with a cxml payload.