ERP integration for TIMS Software, developed by Computers Unlimited. TIMS is the leading software system dedicated exclusively to the industrial gas and welding supply industry. A system that not only lets you manage your cylinder assets, TIMS provides the tools to manage every aspect of your business within one rock-solid application suite.

Prerequisite: TIMS V8 R19 is expected for this integration.

Enable the TIMS ERP Integration App from the App Store under the Erp category. Go to the EvolutionX Admin and click App Store → TIMS ERP Integration.

By clicking the button "Test Settings" you can validate if the settings you saved are correct. This should be used after every update of the settings to make sure the ERP connection is configured correct. Note that you should still activate your store with TIMS following these steps once all settings are saved.

IsBlanketPurchaseOrderSystemEnabled

IsAdvancedCylinderManagementEnabled

IsCustomerSiteTrackingEnabled

Image downloading of Invoices, Proof of Delivery tickets, and Receipts is automatically supported by the EvolutionX storefront views. This requires correct configuration and use of this feature in TIMS. If it is not working then contact Computers Unlimited (CU) to correctly configure TIMS.

⚠️ Important: The Gas PO support in TIMS requires the optional Blanket PO feature. Check that you have it enabled in TIMS before configuring this option. You can verify this in the App Store using Test feature which reports the value for IsBlanketPurchaseOrderSystemEnabled.

Go to the EvolutionX Admin and click Store Settings → General and under

Store Preferences scroll to Order Settings section. Enable the Alternative PO and and set the preferred label, for example Gasses PO.

By following the above steps a new input will be displayed in the last checkout step for a customer.

Each Shipping Rule (rules are setup within a shipping zone) a TIMS Ship Via code must be used as the "name" of the rule. This ensures that the shipping method selected by the customer will have a matching Ship Via code for the order in TIMS. Review this article for for details about how to configure shipping zones and shipping rules in EvolutionX.

Go to the EvolutionX Admin and click Store Settings → General and under

Store Preferences scroll to Live Pricing section.

Leave the rest of the inputs empty.

Live unit of measure is supported once Live Inventory and Live Pricing is enabled. All defined units of measure in TIMS are displayed on the storefront. The minimum order quantity applies only to the base unit of measure (lowest) and every additional unit of measure is allowed to sell without a minimum quantity.

Example:

Note: this is currently in pre-release. Request that it is enabled for your store.

TIMS supports pricing by volume for gas products. There are two ways to price your gas products in TIMS for display on EvolutionX. Here are the two methods and their advantages.

To use the per gas commodity pricing method in EvolutionX, check that the following have been set:

TIMS has a limit for how many lines can be added to the cart. So be sure to set your limit to 50 or less (unless tested to ensure good performance at the payment step of checkout).

The Suspended Customer Check toggle in the appstore determines if EvolutionX makes a request to TIMS to check if a customer in checkout is suspended or not. The toggle is set to TRUE by default.

Dealers are able to customise the Suspended Customer Check message for their store. The default error message is "Your account is on hold. Please contact our staff for assistance".

To change the error message, make use of the Translation module provided in the EvolutionX Admin Portal.

On the translation module, search the "Key" field with the text "customer_on_hold" and press Enter. This provides you with a filtered list showing the default message set for the error message.

Provide your custom message in the Custom Translation box provided and click "Save Changes". With this, your custom message will be shown to the customer instead of the default message.

With the TIMS App installed, EvolutionX allow dealers set custom field mappings for orders sent to TIMS using the API Order submission.

To use the custom order field mapping, click the "Setup Order Mapping" button on the TIMS App.

The custom order mapping page shows three rows, Order Header Field, Default and Custom Value.

N.B: Some Custom Value columns are Read Only, which means EvolutionX do no allow setting custom values for such fields

For TIMS order fields that EvolutionX allow custom field mappings on, you will see a "Select Attribute" dropdown on the Custom Value column

The dropdown shows all available EvolutionX order data and dealers can select the order data attribute they want as the custom value to be mapped on the TIMS order field

After selecting all the desired custom values, click the "Save Changes" button. Orders sent to TIMS after the configuration will map values to the TIMS order field using the custom value attribute instead of the EvolutionX default value. For the example, in the image provided above, EvolutionX won't map any value of the Comment line 3 to TIMS.

Dealers can change their previously configured custom mapping by selecting a new attribute they want as their custom value and click the "Save Changes" button after making updates. Orders sent after the update will use the new custom value.

To remove a previously configured custom mapping, click on the "X" icon on the custom value and click "Save Changes". Orders sent after the configuration will default back to using EvolutionX default mapping for the order mapping to TIMS

The App Store Setting "Use Multiple Guest Customers" is set as One Guest account by default. This is used if the customer is a guest (not logged in) when creating a draft order in TIMS for the calculation of fees and taxes and when creating the final order.

The two values have different behaviour but both use the TIMS Default Customer value set in the App Store.

"One Guest Customer is the default value of the "Use Multiple Guest Customers" setting. When creating the draft or final order for a user who is not logged-in the customer account will set based on combining the prefix value of the TIMS Default Customer and the suffix value of the country or state two-digit ISO code.

If you will collect taxes based on the Canadian province of the shipping address for guest orders then use the "One Guest Customer per Canadian Province" setting. When you enable it ensure your setup in EvolutionX and TIMS satisfies these requirements:

Once saved, these settings will automatically use the corresponding TIMS customer for guest orders based on their country or Canadian province.

👍 Important: This is only available after setup with CU. Contact CU to get started.

TIMS integration with Vantiv by Worldpay allows for Pre Authorization of credit cards for orders placed in the store Checkout and CC Payment of outstanding Invoices.

👍 Important: This is only available for certain TIMS versions. Talk to CU to find out, if it works for your version.

Enable Frequently purchased items for your customers. The items will be called in realtime from TIMS and matched to any items that are available in your store. If the items aren't available to purchase in the store then the items won't be shown to the customer in the list.

👍 Important: Items are the most frequently purchased items from across the account. It is not the most frequently purchased items for just that single user but for the entire TIMS account.

Limit: Most recent 1,000 items being called from TIMS, by purchase date. We then match them so the real number shown to the customer could be less than 1,000.

Enable via the customer roles

Note: Credit Card Fees / Surcharge are not supported for the TIMS integration.

Split orders are not enabled by default in TIMS. When configured it can cause orders with multiple items to split based on the location they are processed from.

In the checkout, the Customer does not see that the orders have split and the fees and taxes from all split orders are summed in the checkout.

Only whole lines, along with the full quantity, can split to a second or third order. Take this example: you sell Gas and Dry Ice but your Dry Ice must be on a separate order for processing. Any order that has both Gas and Dry Ice lines will split into two orders, where one has all the Gas lines and the other has the Dry Ice lines.

After placing the order, the customer will see that multiple orders were created in in the live order history.

In checkout, after the shipping step, a draft order is created in TIMS to calculate the taxes, line fees, and shipping fees (subject to app store settings) that apply to the order. Fees are added to the order as line items, while shipping fees and taxes are displayed with the totals in checkout.

A draft order is converted to a TIMS order after the user sees the Thank You page. If the order can't be processed then the EvolutionX order status changes to On Hold and an email is sent to the distributor based on the configuration of the app store. To reprocess an on hold order from EvolutionX to TIMS, just change the EvolutionX order status to New Order and save.

In the event that the order was created but not communicated back to EvolutionX (Order will have TIMS Status Code 0). In the reprocessing step, we don't process it again but communicate payment and perform the orders print, both actions are subject to app store settings.

TIMS Status 4 (aborted/draft order from Checkout)

TIMS Status 0 (unselected)

TIMS Status other than 0,4

Customer and address data in synced to EvolutionX directly from TIMS though our API's. TIMS is the record of truth and should be managed directly in TIMS. Adding users to accounts is managed in the EvolutionX admin. Adding users to an account is a simple process of locating the proper account and adding the users under the respected account. See our article on Accounts, Users & Roles for more information on adding users.

Note: Do not add users via the All Users Screen. Add them by first locating the account and adding the users from within the from within the account under the users screen.

In order details is possible to know the Tracking Information with the respective tracking number linked to the tracking service, the delivery and shipping dates, the status of the delivery and the weight of the package.

We provide a list of invoices for your customer. All data is retrieved from TIMS in realtime without limitations, allowing the customer to download the invoice or pay the remaining value.

In Gas product details is possible to request the collection of empty cylinders. For that the user needs to select the checkbox "Cylinder Collection Only" above "Add to cart" button and then add the item to the cart.
​

To hide this feature from the user the following CSS rule should be applied:
​

It could be possible the user create an order only with the collection of empty cylinders and in this case the user will have shipping costs associated. So to avoid this situation, could make sense create a shipping rule that if the cart value is 0, the shipping is free.

The preferred location value supported for TIMS live inventory lookup on EvolutionX addresses a problem faced by customers of TIMS who deliver orders from distribution centers rather than customer branches. This feature requires R19 of TIMS.

The solution involves delivering the "is_preferred_location" attribute in the storefront as reported by TIMS. Here is how it works:

Live Inventory Lookup: The storefront request for live inventory sends the customer account number and the list of items to TIMS. The TIMS response includes a preferred location (true or false) for each returned inventory value. If the cart/quote is a delivery, the list for the storefront has the preferred location as reported by TIMS. If the cart/quote is a will call, the list sent to the storefront has the preferred location set to the location matching the will call branch.

Custom storefront design can be commissioned to use this information. The preferred location would be added to the display of inventory on the Storefront List and Product Page. The preferred location is highlighted on the display, replacing the customer location. However, not all customers may require this, and the change can be implemented upon request.

This change primarily resolves an issue where inventory values did not represent the most likely distribution location for delivery orders that do not come from the customer's home branch.

No, Credit Card Fees / Surcharge are not supported for the TIMS integration.