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