How to connect to American Tire Distributors (ATD)
ATD's integration has a two-phase onboarding process. You'll start in a test environment, complete validation, and then get moved into production.
Before you start
Contact your ATD account representative and let them know you're working with Spark Shipping. Ask them to do the following on their end:
- Link your API credentials or location number to the sparkshippingmaster integration account.
- Enable the SparkShipping partnership on your account.
This is a manual step that only ATD can complete. Without it, your API calls will fail with an authentication error even if your credentials are correct. The error you'll typically see is: "SparkShipping account integration not enabled on ATD."
ATD will also provide you with a location number. Make sure you have it, along with the postal code of that location, before moving on. You do not enter an API username, password or client ID in Spark Shipping: Spark Shipping connects through its own sparkshippingmaster integration account, which ATD links to your location.
Phase 1: Test environment
ATD starts every new integration in their sandbox (test) environment. This is normal. You are not in production yet, and you won't be until you've completed their validation process.
In the test environment, you can pull catalog data, check inventory, and preview orders. This is where you'll confirm that everything is wired up correctly on both sides.
What ATD requires before production access: You need to submit 3 test orders through the sandbox environment. ATD reviews these to confirm your integration is handling their API correctly, including things like product lookups, brand/style calls, and order formatting. This requirement was communicated in ATD's SDK documentation and is standard for all new integrations.
If you try to hit the production API before completing this step, you'll get an error. ATD will not enable production access until the test orders are validated and both sides sign off.
Phase 2: Production
Once ATD has reviewed your test orders and confirmed everything looks good, they'll enable your account in the production environment. At that point, your live catalog sync, inventory checks, and order placement will all run against real data.
If you run into issues after going live, ATD's support contacts are:
- Technical issues: ATDConnect_Technical_Issues@atd-us.com
- Account updates or changes: ATDConnect_Customer_Updates@atd-us.com
- General questions: ATDConnect_General_Inquiries@atd-us.com
Setup in Spark Shipping
Open the vendor's Credentials page and enter your Location Number and Postal Code. Set Environment to testing while you are in ATD's test environment, and change it to production once ATD enables production access. Save and test the connection.
What to expect for catalog and images
ATD provides product images in three sizes: thumbnail (50x50), small (138x138), and large (250x250). Spark Shipping pulls the largest available size by default, up to 10 images per product.
Catalog sync pulls the list of brands first, then the products for each brand and product group. Depending on the size of your catalog, the initial sync can take some time. If you see zero products after the first sync, don't panic. Reach out to us and we'll check whether the API is returning data correctly for your location.
Shipping cost options
ATD charges flat shipping rates based on product weight. In the vendor's Options page you can:
- Turn on Enable Weight-Based Shipping Cost to load ATD's weight-based rate into each product's shipping cost during catalog updates. Edit the brackets in Weight-Based Shipping Cost Brackets, or click Reset to Defaults to use ATD's FedEx ship-to-home rates.
- Items heavier than the highest bracket ship LTL and get no shipping cost unless you turn on Include Freight Shipping Cost for LTL Items. Set the amount in Freight Shipping Cost (leave it blank to use the default of $200).
- Check Disable Shipping Cost Override to apply no shipping cost at all.
Common issues
"SparkShipping account integration not enabled on ATD" -- Your ATD account rep hasn't completed the linking step yet. Contact them and confirm that the SparkShipping partnership is enabled and your location is linked to the sparkshippingmaster account.
Credentials work in test but not production -- You probably haven't completed the 3 test order validation yet. ATD gates production access behind this requirement. Work through the test orders first. Once ATD confirms production access, make sure Environment is set to production in your Spark Shipping credentials.
Catalog sync shows zero products -- The API may be returning data that isn't being parsed correctly, or your location may not have products assigned to it yet. Contact us so we can check the raw API response for your account.
"Order killed (items out stock)" -- ATD rejected the order because the items were out of stock at your location. The order is not placed with ATD.