Before you can start using ATD with your X-Cart store, you need to connect your X-Cart store to your ATD account. You will also need to configure your ATD integration general settings.
For details, see:
Getting Your ATD API Credentials
Before you can start selling products with ATD at your X-Cart store, you must register an account with ATD and complete ATD’s onboarding steps. You must also request that ATD connect your account to the X-Cart master account.
ATD will provide you with one or more Location numbers. Contact the X-Cart support team with your default Location number so we can provide you with an Auth token.
The Location number and Auth token will serve as your credentials for access to the ATD API.
Saving Your ATD API Credentials in Your Integration Settings
After obtaining the API credentials for the integration, you need to save them in your X-Cart store:
Log in to your X-Cart store's Admin area and go to the ATD integration settings page. All auto integrations pages can be found under the Catalog > Catalog Import menu.
Make sure you are looking at the Settings > ATD page tab.
Copy and paste your ATD API credentials into the appropriate fields on the page.
The credentials you require are an Auth token and a Location number.
Set the mode in which you want to run the integration (Test/Live).
Click the Save Changes button at the bottom of the screen to save the API credentials.
After you click the Save Changes button, the API credentials will be saved in your X-Cart ATD integration settings.
Provided that the API credentials are valid, your X-Cart store should now be able to connect to ATD.
Configuring the Import Options
Before you start importing catalog data from ATD, you must configure the most general options that affect the import process. It can be done in the Import Options section of the ATD integration Settings page.
To configure the import options:
Use the Import mode setting to specify the mode that you would like to use for importing catalog data from ATD.
One of the following options can be selected:
Add new products and update existing ones [default option];
Add new products only;
Update existing products only.
Use the Update existing products by setting to specify how you want to match products already in your catalog with those being imported from ATD. Technically, two products will be considered the same if they have the same identifier:
Manufacturer Part Number [default option];
Product SKU.
If you have specified in the Import mode field that you want products to be updated during an import, use the Update section to specify the types of product data that need to be updated. Select one or more of the following options:
Product name;
Descriptions;
Attributes;
Fitments;
Images;
Dimensions;
Weight;
Prices;
Stock.
It is required that at least one option be selected in this section; otherwise, the updating of catalog data during an import will not be done.
Important: As you may prefer to import certain types of data from a catalog provider other than ATD, be sure to also review your store's import options configuration for that catalog provider integration. This step is crucial to avoid conflicts between the two integrations. We strongly advise against enabling the same import options in both ATD integration settings and your other catalog provider integration settings simultaneously. For instance, having the option "Product name" enabled for both integrations will result in overwriting the product names already present in the store during each new import with data from the source used most recently.
Use the New product status drop-down box to specify whether products newly imported from ATD should be automatically assigned the status "Available for sale". Select one of the following options:
Active: The "Available for sale" property of newly imported products will be set to "On".
Inactive: The "Available for sale" property of newly imported products will be set to "Off".
Note that the selected option will apply to newly imported products only and will NOT affect any products imported earlier.
Click the Save Changes button at the bottom of the screen.
Adjusting Concurrent MPN Settings
If your store uses more than one stock and price sources for products, you can adjust the priority of those sources. To start, click the "Supplier Priority - Manage" link in the Concurrent MPN Settings section.
For more info on this, see Configuring Stock & Price Priority Settings.
Setting up the Currency & Price Conversion
Another important task that needs to be completed before you start importing catalog data from ATD is adjusting currency and price conversion settings in the Currency & Price Conversion section.
As a catalog data provider, ATD provides prices for products in USD. The settings in the Currency & Price Conversion section allow you to specify a conversion rate that should be applied if the currency used by the store is different from the currency in which prices are imported.
First of all, in this section, you can see what currency is set as your store's default currency.
This information is provided for your convenience; the default currency cannot be edited here. Should you require to change your store's default currency, you will need to do that via your store's Localization settings. You can access your store's Localization settings using the 'Manage' link.
The Currency to import setting sets the currency in which prices will be imported from ATD.
If your store's default currency is USD, the Currency to import option is not adjustable. Only prices set in USD will be imported.
If your store's default currency is a currency other than USD (for example, Canadian Dollar (CAD)), the Currency to import setting is provided as a drop-down selector.
Currently, X-Cart's ATD integration supports the import of prices only in the US Dollar (USD); hence, the selector will have only one option: US Dollar (USD).
For configurations involving the import of prices in a currency other than the store's default currency (for example, when the Default currency is Canadian Dollar (CAD) and the Currency to import is set to "US Dollar (USD)"), a Conversion rate field is provided. It allows you to set the conversion rate.
Following are some examples that demonstrate what happens with different Currency & Price Conversion configurations.
Example 1
We are doing an import with the following currency & price conversion settings:
Default currency = Canadian Dollar (CAD)
Currency to import = US Dollar (USD) [Only prices in US Dollars are imported]
Conversion rate = 1.34 [Store prices will be shown in CAD as calculated using the set conversion rate]
Products in the ATD catalog that have a price specified in US Dollars (USD) are imported into our X-Cart store with prices calculated as Provider's price in USD + Price conversion rate + Price adjustment value
The price adjustment value in this formula is a discount or markup specified in the brand settings (the fields "Price to Import" and "Price Adjustment").
Example 2
We are doing an import with the following currency & price conversion settings:
Default currency = US Dollar (USD)
Currency to import = US Dollar (USD) [Only prices US Dollars are imported]
Products are imported from the ATD catalog with their original prices set in USD.
After making any changes to the settings in the "Currency & Price Conversion" section, be sure to save your changes using the Save Changes button at the bottom of the screen.
Configuring the Shipping Settings
In the Shipping Settings section of the page, you set the Default shipping method (the option that should be used by default for shipping orders from ATD to customers.)
Related pages: