This article will help you through the set up for the integration between your e-automate ERP and your EvolutionX webstore.
General Sync Overview
The table below shows what data points are connected between e-automate and EvoX and the direction that the data flows. Some data points are updated in real time, as indicated by LIVE
EA Accounts | → | EvolutionX Customers |
EA Users | → | EvolutionX Users |
EA Addresses | → | EvolutionX Addresses |
EA Customer A/R balances | LIVE | EvolutionX Storefront |
EA Invoice History | LIVE | EvolutionX Storefront |
EA Order History | LIVE | EvolutionX Storefront |
EA Customer Pricing | LIVE | EvolutionX Storefront Prices |
EA Recently Purchased Items | LIVE | EvolutionX Storefront |
E-Automate pre-bill | ← | EvolutionX Orders |
EA Checkout Tax | LIVE | EvolutionX Storefront |
EA Checkout Shipping Methods | LIVE | EvolutionX Storefront |
Paya Connect Credit Card Payments | Use EvolutionX and Net1 Portal | EvolutionX Checkout |
IProduct sync for e-info enabled products | → | EvolutionX Products |
Before proceeding with EvoX:
There are components in e-automate that you must set up first before the integration will be complete. The e-automate dealer requirements are:
ECI customers must have an active Dealer Gateway dealer account, registered with EvolutionX.
ECI customers must have an active ESN dealer account, authorized with ECi EvolutionX vendor, with required minimum ESN client service build installed, minimum version 2756.
ECI customers must have an active e-automate licence, with minimum e-automate version installed, minimum version 24.0.6.
ECI customers must install and execute the EvolutionX DBComponent against their e-automate database.
ECI customers must create a new sales code, named SupplyEvoX, within e-automate.
Contact e-automate for help with this before proceeding with the EvoX set up steps below.
Credit Card Payment and Order Processing
Credit card orders which are sent to E-Automate are added as a pre-build. The Invoice is marked as being paid by credit card, with a reference of the last four digits, but the processing is manual.
Payment Gateway Support
The only supported gateway for credit card processing on E-Automate integrated stores is:
US & Canada
Paya Connect Credit Cards by Net1
United Kingdom
Nuvei Credit Card Gateway by Net1
Payments include support from Net1 for distributors and our future roadmap integration features for capture integration and fees charged.
Order Processing Steps — Capture when shipping and invoicing.
Set the Payment Method Charge Option as "Pre Auth & Charge on Dispatch". Then use the processing steps below.
A Storefront order processed with a credit card. The card is pre-authorized with the amount of the order in the checkout. This reserves the money but doesn't send it to the distributor.
The order is sent to E-Automate as a pre-bill order and is marked as pre-paid with a payment record.
The order is shipped and the Invoice is finalised. This Invoiced amount needs to be captured from the credit card to ensure payment to the distributor.
To capture payment, return to EvolutionX and open the order. Use the capture payment button in the order and enter the value of the invoice. This will confirm the payment is captured and payment will be sent to the Distributor. Any exceptions should be referred to your finance department.
Daily reconciliations of all credit card charges is recommended to ensure the charges online match records in E-Automate.
Order Processing Steps — Capture in Checkout
Set the Payment Method Charge Option as "Pre Auth & Charge Now". Then use the processing steps below.
A Storefront order processed with a credit card. The card is charged with the amount of the order in the checkout. This finalizes the charge and sends the money to the distributor.
The order is sent to E-Automate as a pre-bill order and is marked as pre-paid with a payment record.
The order is shipped and the Invoice is finalised. This Invoiced amount may be the same or different than the amount paid at checkout.
Reconciliation of any invoice amount that differs from the amount charged at checkout will result in staff using the Net1 Connect Portal to refund or place a charge for the difference.
Daily reconciliations of all credit card charges is recommended to ensure the charges online match records in E-Automate.
Connecting E-Automate to EvolutionX
Now that e-automate is configured with the steps above, you must ensure the following is set up/configured in EvoX, as these are required for successful ERP product sync. Your EvoX Implementation Consultant can help you with this:
Step 1 - Set up the Own Catalogue
Enable the "Own Catalog" (in Admin → Catalogues → Available Catalogues) and create the Catalogue Container (in Admin → Catalogues → Catalogue Containers), Read more
Step 2 - Enable Own Supplier
In Admin → Supplier
Click on the "New Supplier"
Select "Own Supplier" and the account (1000)
Click on the "Continue" button
Fill out the Ship From Address form
Create the New Locations, with Name and Seller Reference. Read more
Step 3 - Enable Own Categories
In Admin → Categories Enable the "Own Category" vertical Read more
Add a new category, named "Unclassified"
Step 4 - Set up Live Pricing
Select Store Settings from the left side menu bar
Select General menu options under the Store Settings menu options
Select the Store Preferences tab
Select the Products tab of the available Store Preferences tabs
Scroll down to the Live Pricing section
Under Live Pricing section, apply the following settings
Select Erplivepricing from the Provider dropdown
Enter the Endpoint URL = https://econnect.ecisolutions.com/apis/v1/livepricing
Enter password = evolutionx
Enter Token = Bearer + the dealer's EvolutionX e-commerce provider account number. e.g. Bearer 4a1d74e8ac764ac0a1b5261c45780d5e
Select the Missing Item Fallback Option as EvolutionX Pricing if dealer wants their store users to purchase items not available in my ERP. Expected behavior would be for these items to be added to sales order as non-stock items.
Select the Failed Live Price Request Fallback as EvolutionX Pricing if dealer wants their store to support when the ERP live pricing endpoint is down or otherwise cannot return a valid response, then all items requested are priced using the behavior set under the failed live price request fallback option
Select Save button
Step 5 - Configure Shipping Zone store settings
Select Store Settings from the left side menu bar
Select Delivery
Click on + New Zone
From here, you can now set up your shipping rule - our help article for this is here. Alternatively, your EvoX implementation consultant can help you with this.
Step 6 - Configure the ECI e-automate app
Before proceeding with the ERP DIY Integration App, you must have an SES email address in EvolutionX.
To add SES email address, go to the Jump To search box at the top of the menu in the EvoX admin screen:
In the window that pops up, type in Email and select Email Addresses:
Select the + New Email Address button on the top right
Enter Display Name as your name
Enter Email Address
Select Amazon SES
Select Add Email Address button
Note, you should receive an email from Amazon SES, click the link in the email to verify address, and then your address will be visible for selection below.
You're now ready to configure the ERP DIY Integration App.
Log into the EvolutionX site as admin user https://us.evoadmin.io/login
Note, admin user credentials are provided by an EvolutionX team member. User credentials consist of username (email address), password and access code (store number)
Select App Store from the left side menu bar and search for 'e-auto' and click into the app:
You'll now see a list of blank fields in the app called MY CREDENTIALS.
Use the list below to complete these fields:
Authentication Type = Key & Token
Key = evolutionx
Token = Bearer + the dealer's EvolutionX e-commerce provider account number eg. Bearer 1ab2c3d1a23e4ab123ab0a1b1234a12345a6b
Note, the dealer's provider account number is collectable from the dealer's Dealer Gateway dealer profile record > Accounts tab >EvolutionX e-commerce registered service line entry.
Error notification e-mail Sender (valid SES e-mail address) = select applicable email address
Error notification e-mail Receiver = enter applicable email address
Select Save button
Credit Card Setup with Paya Connect by Net1
Install the Paya Connect Credit Card with Pre-Auth by Net1 app in the EvolutionX App Store.
With the credentials supplied by the Net1 staff, enter the required details.
Go to the Payment Methods in Store Settings, enable the Paya payment method, and set it to either Pre Auth & Charge Now or Pre Auth & Charge on Dispatch based on your chosen order process described here.
You have now fully integrated EvolutionX and ECI e-automate! 🚀