This article builds on the steps outlined in the Connecting Your Auto Integration guide and focuses on adding ATD API credentials to your X-Cart Automotive store and completing the basic setup.
ATD account and credentials
Open a Dealer Account with ATD (American Tire Distributors, Inc.) and complete ATD’s onboarding steps.
Contact ATD at https://www.atd.com/contactus to request that your ATD account be connected to the X-Cart master account.
ATD will provide you with one or more Location numbers. Contact the X-Cart support team at support@x-cart.com 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.
Connect X-Cart to ATD
To start selling products with ATD, you first need to connect your X-Cart store to your ATD account. Simply add your ATD credentials in the ATD integration connection settings (Catalog › Catalog Import › Settings › ATD) to complete the setup. The settings you need are located in the Connection section.
 |
|
Your ATD credentials need to be entered into the appropriate fields:
ATD Auth token;
Location number.
Optional: Enable the Test Mode
toggle to explore how the ATD integration works without processing real orders or spending money.
Click Save Changes.
Configure shipping for ATD
After connecting to ATD, you need to configure shipping for ATD orders.
X-Cart 5.6.x:
The auto integration settings page for ATD (Catalog › Catalog Import › Settings › ATD) no longer includes the Shipping Settings section that was available in X-Cart 5.5.1.x. All shipping-related settings are managed through shipping profiles. See Shipping profiles in X-Cart 5.6.x for more information.
You can create a shipping profile for products sold through ATD and define the rules that should be used for shipping calculation. The integration can retrieve shipping rates from ATD via API, or you can choose to use flat shipping rates instead. The settings allow you to specify which type of rates should be displayed to customers at checkout. If necessary, you can also configure a handling fee to be added on top of the shipping rates.
 |
|
X-Cart 5.5.1.x:
Shipping settings can be found under Catalog › Catalog Import › Settings › ATD in the Shipping Settings section.
 |
|
The ATD integration supports two different approaches to shipping rate calculation:
retrieving real-time shipping rates from the supplier via API
using configured flat shipping rates
"Shipping rates from supplier" setting (5.5.1.x)
The Shipping rates from supplier setting determines whether shipping rates received from the warehouse distributor via API are displayed to customers at checkout.
Important: Disabling this setting does not stop the store from requesting shipping rates from the supplier. It only controls whether the received rates are shown to customers.
The integration always sends a request to ATD for shipping rates as part of the shipment creation process. However, whether rates are actually returned depends on several factors, including:
the terms of your agreement with ATD (not all account types provide rates via API)
the availability of the supplier’s API
possible technical issues affecting the response
"Default shipping method" setting (5.5.1.x)
Select which shipping method will be offered by default for ATD orders.
Flat shipping rates configuration (5.5.1.x)
Under Catalog › Catalog Import › Settings › ATD, scroll down to the Shipping Settings section. In this section, click the Manage link near the Flat shipping rates setting.
On the next page, choose to configure a new shipping rate for ATD or select an existing one.
Enter the required details.
In the Apply to Stock selector, choose
ATD.Save the changes.
 |
|
How shipping rates affect checkout
Shipping rates in X-Cart are tied to shipment creation.
A shipment is created only after the store successfully receives a response from the supplier.
If the shipment cannot be created (for example, due to missing or failed API response), no shipping rates will be available at checkout.
In this case, no rates will be displayed at all—neither supplier rates nor flat rates.
This behavior ensures that shipping options shown to customers always reflect actual fulfillment capabilities confirmed by the supplier.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles