Overview
The OrderRequest integration is used to communicate order details between Unimarket and an external system. The OrderRequest may be used by Unimarket to update external systems (outbound) or for external system to update Unimarket (inbound). The OrderRequest message follows the cXML standard for orders.
Why use this integration?
This integration is commonly used to update supplier systems and external ERP/Finance systems with order details when a Purchase Order is generated within Unimarket. Example below:
OrderRequest Technical Documentation
Technical details relating to the OrderRequest integration can be found below:
Supplier Setup
Login to the supplier eStore and go to Edit Store, then select the Integration tab.
| Field | Purpose |
| Dispatch Mechanism | Determines how the electronic message will be sent to the supplier. This must be set to the mechanism the supplier supports (ask the supplier). |
| URL | This is the URL where the electronic PO's will be sent. The supplier will provide the URL. If a Gateway such as Tranzsoft is being used to pass messages between Unimarket and the supplier then the URL will be the gateway URL not the supplier URL. The supplier or Gateway service provider will provide this. |
| FROM Credential Domain | This identifies the Community Domain where the orders are being sent from. This is the key information for the supplier to identify the customer that is sending them the order. If the supplier sets the 'FROM Credential Identity' as their DUNS number then this is usually set to the word DUNS (but can be anything). |
| FROM Credential Identity | This identifies the Community where the orders are being sent from. This is the key information for the supplier to identify the customer that is sending them the order. It can be set to anything but it is commonly set to the Communities DUNS number. |
| TO Credential Domain | This identifies the Supplier Domain where the orders are being sent to. If the supplier sets the 'TO Credential Identity' as their DUNS number then this is usually set to the word DUNS (but can be anything). It is rarely verified by the supplier. |
| TO Credential Identity | This Supplier Identity where the orders are being sent to. It is commonly set to the suppliers DUNS number (but can be anything). It is rarely verified by the supplier. |
| Shared Secret | This is a password that must be set within Unimarket and within the supplier's system. The 2 must match. |
The bulk of the order integration settings above stay the same for all Communities. The 2 credentials that must change for each community are the FROM Credentials. These are used to uniquely identify the specific community.