What is DDMS?
DDMSPLUS® ERP software enables dealers worldwide to access information, analyze operations from multiple locations, improve efficiencies, and grow their businesses through additional business lines and vertical markets, in brick-and-mortar locations, and via ecommerce.
Install from the App Store
Enable the ECI DDMS PLUS App from the App Store under the Erp category. Go to the EvolutionX Admin and click App Store → ECI DDMS PLUS Integration.
DDMS Guest Customer Account: Sets the Account number that is going to be used for guests users
Shipping Country Code: Sets the country code for all shipping user addresses when synchronizing DDMS customers with EvolutionX. ISO Alpha-2 code must be used
SKU prefix: Sets the SKU prefix that will be added to off catalogues products
DDMS prepaid status: Sets the status that is configured as prepaid in the erp
ECI API ID: Sets the API ID provided by ECI
ECI Consumer ID: Sets the Consumer ID provided by ECI
ECI API Endpoint URL: Sets the API endpoint provided by ECI
ECI E-Procurement endpoint URL: Sets the E-Procurement endpoint provided by ECI
ECI E-Procurement Identity: Sets the E-Procurement Identity provided by ECI
ECI E-Procurement Secret: Sets the E-Procurement Secret provided by ECI
Evolution API key: Evolution API key to be used from the App, can be set in Create EvolutionX API key
Error notification e-mail: E-mail receiver for errors
Customer Account and Department Sync
Each night a one-way sync of all accounts and departments reads data from ECI Interactive customer tables and will create or update customers on EvoltionX.
You can also trigger a one-way sync of all accounts and departments from the DDMS App Store in EvolutionX.
Customer Field Mapping
Here are some important EvolutionX fields and how they are mapped with data from DDMS.
Customer Account Code — EvolutionX sets this value as the DDMS Customer Account Code.
Customer Seller Reference — EvolutionX sets this value as the DDMS Customer Department Code
Customer Address Title — EvolutionX sets this value as the DDMS Customer Department Name.
New Order Processing to DDMS
EvolutionX will send order file in cXML format to ECI procurement for processing into DDMS. Here are some notes about order fields.
Billing and Shipping Address
EvolutionX supports three address lines but DDMS supports two. EvolutionX will concatenate the order address Line 2 and Line 3 so that they are sent together as Line 2 to DDMS.
The DDMS Ship To Address Name for a Guest Order is set as the Shipping Address Name on the EvolutionX Order. Account Orders will set the DDMS Ship To Address Name as the EvolutionX Shipping Address Title.
EvolutionX shipping charges will be added as a line item when sending the order to DDMS.
EvolutionX SKU is a string which consists of two parts from DDMS. The first three characters are used as the DDMS Item "Company" value. The remaining characters are used as the DDMS Item "Number" value.
Example: An EvolutionX Item with SKU "ABC10000" will be sent to DDMS on an order as a line item with Company = "ABC" and Number="10000".
A guest order will go to the DDMS guest customer account as configured in the App Store Settings but the Department will be set dynamically as the State/Province code on the Shipping Address of the EvolutionX Order. This is because each state or province may have different tax treatment or routes in DDMS and this allows each to be configured in DDMS and then applied to the guest order correctly.
Example: Order from a guest customer shipping to Alberta, Canada will go to the Guest Account Code as defined in the App Store Settings and the Department "AB" (the Province code of Alberta).
Customer PO and Order Number
The DDMS Web Order Reference is set as the EvolutionX Customer PO if set, otherwise it is set to the EvolutionX Order ID without the prefix.
The DDMS Order Reference is set as the EvolutionX Customer PO.
Order Status Sync
With the ECI DDMS App installed, EvolutionX makes scheduled requests to ECI and automates the update of EvoX order status in line with the order's status from ECI. This process is done so EvolutionX can correctly allocate reward points (Reward points are allocated when an order is marked as completed).
Status Sync Process
The order status sync can be classified into two process, Getting ECI Order Reference For EvoX Order and Order Status Look Up From ECI
Getting ECI Order Reference For EvoX Order
During this process, EvolutionX retrieves the ECI Order Reference Number for orders placed on the EvoX webstore. The ECI Order Reference Number is then stored as the EvoX Order seller reference and used to retrieve the ECI status for the order.
EvolutionX gets all EvoX orders without seller reference (ECI Order Reference Number) and whose order status are neither cancelled nor completed. It then makes a request to ECI to retrieve the Order Reference for each order and updates the seller reference field on the order.
If the ECI Order Reference Number for an EvoX order cannot be found after 10days, EvolutionX notifies the dealer through an email and also mark the order as cancelled.
Order Status Look Up From ECI
During this process, EvolutionX looks up the ECI status for EvoX orders and updates the order status accordingly.
EvolutionX gets all EvoX orders with seller reference (ECI Order Reference Number) set and whose order status are neither cancelled nor completed. It then makes a request to ECI to lookup the order status using the reference number. It maps the retrieved ECI status to the appropriate EvoX order status and updates the order status and order timeline accordingly.
Below is a table showing the ECI Order Status - EvoX Order Status Mapping
ECI Order Status
EvoX Order Status
EvoX Status ID
** Not Found
** Not Found - Status for EvoX order not found on ECI, order placed on hold.
Order Status Sync Schedule
The order status sync process runs three times daily: