OCI intergration

If you want to integrate Transaction-Network into the system of your customers, this can be done by using the OCI interface integration.
With OCI integration you will be able to use the full functionality of the platform but you will not create an order/offer from the cart but you will transfer the cart into the provided system as punch-out.

To enable your customers using this punch-out integration you need to set up an OCI user for each customer (see https://transaction-network.atlassian.net/wiki/spaces/TNOEM/pages/264634503)
The customer then will have to use the provided URLs and start up parameters below to set up his system.
As result of the punch-out integration the punch-out parameters will be returned to his system.


URLs

Testing the OCI integration - QA system

To test the OCI integration on customer site you can use this URL to validate if the startup and punch-out is working as expected

URL: https://api-qa.transaction-network.io/customer/api/auth/oci-login

Productive OCI integration - PROD system

For the productive OCI integration on customer site you have to use this URL

URL: https://api.transaction-network.io/customer/api/auth/oci-login


Startup parameters

These parameters can be passed as POST parameters to the URL (see above) to login into the platform.

Parameter

Description

Required

Parameter

Description

Required

username

The user name of the technical OCI user

YES

password

Password for the technical OCI user

YES

hook_url

The URL where we should send the data to

YES

Punch-out parameters

These parameters are returned as form fields to the “hook_url” (see startup parameters) when you punch-out the items from the cart..

Parameter

Description

Parameter

Description

NEW_ITEM-DESCRIPTION[n]

max. 40 characters of the name of the item in the cart

NEW_ITEM-QUANTITY[n]

quantity of the item in the cart

NEW_ITEM-UNIT[n]

ISO Code of the item in the cart

NEW_ITEM-PRICE[n]

price per unit of the item in the cart

NEW_ITEM-CURRENCY[n]

ISO Code of the currency of the item in the cart

NEW_ITEM-VENDORMAT[n]

part number of the item in the cart

NEW_ITEM-CUST_FIELD1[n]

ID of the machine that is assigned to the item

 

© TRANSACTION-NETWORK
One and for all

Have fun today working together