Setup
Integration Hub Setup
This setup contains company wide setting that are used by the Integration Hub.
| Field | Purpose |
|---|---|
| Handle Failed Message | Specifies how to handle the original failed messages when they get retried. |
| Enable Workflows for Integration | Specifies that you want to handle integration events with workflows. The recommended approach is using Integration Handlers rather than workflows, as they perform better. |
| Outbound Wait (m/s) | Specifies the delay added after sending each outbound message when sending delayed messages. The purpose of this setting is to avoid hitting API limits. |
| EDI Unit Price Tolerance (+/-) | Specifies the tolerance before the difference between an EDI price and the sales price is deemed a variance. Any difference greater than or equal to this value is deemed a variance. This logic is currently only available for sales documents such as sales orders. |
| Sales Unit Price Field ID | Specifies an alternative field to compare the sales line's unit price to the EDI unit price. |
| Net Price Computation | Specifies the Net Price Computation formula applied to sales documents' Net Unit Price field. |
| Allow Ext. Doc Change to EDI Sales Document | Specifies that you allow changes to the external document number for EDI transactions. Usually, this is not permitted, as the external document number matches the document to the external document. |
| Allow EDI Fields Edit | Specifies that EDI system fields are editable. This is only intended for testing in a sandbox environment. |
| Track Sales Price Changes | Specifies that the sales line is updated to reflect if the sales price on the line has been changed. The effect is that the sales lines will reflect if a user changes the price or discount and if there is a price/order multiple issue. |
| Track Price Change Type | Specifies which method to use when tracking sales price changes. |
| Show Cost in Price Detail | Specifies that cost values are shown on the price overview page, accessible from sales documents to view variances. |
| Enable Price Variance Calculation on Credit Memo | Specifies that you want to enable the EDI price logic for credit memos. Usually, this is disabled since most organisations do not integrate inbound credit notes from customers. |
API Endpoints
Here you configure the API Endpoints that are referenced in by Outbound Integration Handlers.
| Field | Purpose |
|---|---|
| General | |
| Code | Specifies the code. |
| Name | Specifies the name of the endpoint. |
| Endpoint Type | Specifies the type of endpoint which influences how the outbound messages are sent. Refer to the online documentation for more information. |
| Endpoint URI | Specifies the Endpoint URI. |
| Skip error on failed call | Specifies that when the HTTP request fails, no error will be raised. |
| Encode Message Details | Specifies that you want the message to be encoded as Base64 text. |
| Remove Special Characters | Specifies that special characters get removed from the message during HTTP calls if you send the message as Base64 encoded. This setting will affect all messages using this endpoint. You can update the integration handler only to affect a specific message. |
| Authentication | |
| Authentication Type | Specifies the type of Authentication to use. |
| Basic | |
| Access Key | Specifies the Access Key. |
| Access Key Value | Specifies the Access Key Value |
| OAuth | |
| OAuth 2.0 Endpoint | Specifies the the OAuth 2.0 Endpoint. |
| Grant Type | Specifies the Grant Type. |
| Client ID | Specifies the Client ID. |
| Client Secret | Specifies the client secret. |
| Scope | Specifies the scope. |
| Event | |
| Event Topic | Specifies the Event Topic for the Event Grid or the Topic for the Service Bus. |
| Event Subject | Specifies the Event Subject for the Event Grid or the Subscriber for the Service Bus. |