American Tire Distributors as a Source

In this guide, you'll learn how to set up American Tire Distributors (ATD) as a source in Flxpoint — create the source, connect via your ATD API credentials, and configure inventory, dropship orders, and shipments. Integrating ATD as a source gives you access to a vast inventory of tires and helps you streamline your e-commerce operations.

Add Source and Establish Connection

American Tire Distributors as a Source — setup walkthrough
Before you begin — test in Sandbox mode: When setting up the integration between American Tire Distributors (ATD) and Flxpoint, it's crucial to start by testing in the Sandbox environment. ATD requires that you perform a successful order test in this environment before allowing live orders to be placed in the Production environment. After placing a test order, contact ATD for confirmation before switching to Production mode, ensuring your live setup is fully optimized and error-free.
🧭 Phase 1: Launch the Source Wizard +
Log in and open Sources
Log in to Flxpoint and navigate to the Sources section. Click + Add Source and select American Tire Distributors (ATD) from the list. This opens the Source Wizard.
Step 1 — Create Source
Enter a clear name (e.g., ATD). Then choose the Source Type that best fits how this Source will be used.

Choose the right Source Type

For most ATD setups we recommend Vendor Warehouse. Use the other options only if they better match how you store and ship inventory.

  • Vendor Warehouse (Recommended): You send Fulfillment Requests to ATD so they ship directly to your customers (dropship).
  • Internal Warehouse: You stock items and ship from your own facility.
  • External Warehouse: A 3PL or external partner ships your owned inventory.
  • Product Data Source: Content-only source to enrich product details (no fulfillment).
For ATD: select Vendor Warehouse. This enables sending Fulfillment Requests to ATD and using their inventory for routing.
After selecting the Source Type, click Save & Next.
Step 2 — Order Fulfillment
Decide if this source is eligible to fulfill orders. Choose Yes (Recommended) so you can route orders to ATD, then click Confirm.
Step 3 — Order Fulfillment Settings
Use Defaults or No, Customize to set auto-processing, stock commitment, and backorder handling, then click Save & Next.
🚚 Phase 2: Shipping Methods & Source Location +
Goal

Finish the Source Wizard by adding at least one Shipping Method and confirming your Ship From location.

Step 1 — Shipping Methods
Add at least one shipping method. Method names drive routing — the routing engine matches the shipping method on the order to the methods you configure here.
Step 2 — Source Location (Ship From)
Enter the Ship From address (Address, City, State/Code, Postal Code, Country/Code). This address is used for routing logic, rate shopping (if enabled), and reporting.
Finish the Wizard
Review Steps 1–2, then click Save and Complete.
🔑 Phase 3: Create Your ATD Connection +
Goal

Flxpoint securely authenticates with ATD using your API credentials. One connection covers inventory, dropship orders, and shipments.

Step 1 — Enter API Credentials
Inside your ATD source, open Integrations → Get Inventory [Primary] and click Start Creating Integrations. Choose American Tire Distributors (ATD), then input the API key, secret, and any other required information provided by ATD.
Step 2 — Configure Products and Inventory
Map ATD's product categories and set up inventory synchronization. See the Operations sections below for mapping and configuration details, including the Catalog Type setting.
Step 3 — Test in Sandbox
Place a test order in the Sandbox environment. Contact ATD to confirm the test before switching to Production.
Next Activate Production & configure operations 🚀
Once ATD confirms your test, enable the Production environment to start processing live orders. Then go to the Operations sections of this doc to set up Get Inventory (Primary) and Get Inventory (Secondary) for catalog & pricing, Send Fulfillment Requests for orders, and Get Shipments for tracking.

Product Operations

Get Inventory (Primary)

Introduction

American Tire Distributors (ATD) is a wholesale supplier of tires and related products. The Get Inventory (Primary) job imports your ATD catalog into Flxpoint — product data, variations (Size and Side Wall), pricing, quantity, weights and dimensions, images, and categories — and keeps it up to date.

Using this feature with Flxpoint allows you to seamlessly integrate your inventory data, ensuring that you have up-to-date product information. This integration helps streamline operations, reduces manual errors, and ensures that your inventory levels are always accurate. The sections below walk through each step of the setup and configuration process.

Note: Get Inventory (Primary) is the full product feed. After each run, products and variants live in your Global Inventory Pool and can be mapped to downstream channels.

Each run follows this workflow:

  • 1Select Connection — Choose your ATD connection (uses your ATD API credentials).
  • 2Fetch Catalog — Flxpoint retrieves the ATD product feed, including product data, variations, pricing, quantity, weights and dimensions, images, and categories.
  • 3Map Fields — Incoming data is matched to your Mapping Template.
  • 4Save to Global Inventory Pool — The pool is updated; changes flow to channels after your next push.
Step 1: Connect an Integration

Choose American Tire Distributors (ATD) and select your existing ATD connection (or create one — see How to Connect → Phase 3). Click Save and Proceed.

Step 2: Configure Settings
  • Quantity Type — ATD provides three quantity options: Localplus, Nationwide, and Onhand. Quantity will be saved as selected in your mapping template.
  • Archive / Un-Archive Inventory — When enabled, items absent from the latest feed are archived and re-activated automatically if they return. Enable in either Primary or Secondary — not both.

Click Save and Proceed.

Step 3: Define a Mapping Template

Choose a mapping template (or build your own). Confirm your quantity type and category mapping, then click Save and Complete.

Step 4: Save & Schedule

Run manually first to verify the import, then enable a schedule — daily is a good default for Primary (jobs run in UTC). The status page will show Connected, Configured, and Mapped with your template once complete.


Supported Features
  • Custom Fields: Additional tire information is saved in variant custom fields. Up to 100 custom fields, 10 summary fields.
  • Variations / Options: We use Size and Side Wall to create options.
  • Generic Pricing (& Currency).
  • Quantity: Three types of quantity option — Localplus, Nationwide, Onhand. Quantity will be saved as selected in the mapping template.
  • Weights & Dimensions (& Units): Weight is available in pounds and dimensions are available in inches.
  • Images: Available.
  • Categories: Single-level category is available in the feed.
  • Archive Support.
  • Delta Feed vs Full Feed: This is the full product feed.
Not Supported
  • Client Pricing (& Currency).
  • Multiple Warehouses: We support a single warehouse per integration. To use more than one warehouse, create a separate integration for each warehouse.
Catalog Type: Ship To Store vs Ship To Home

A Catalog Type setting lets you choose where product data is retrieved from. By default, products are retrieved from the Ship To Store (STS) catalog. You can switch this to Ship To Home (STH) to retrieve products from the Ship To Home catalog instead.

This is useful when some items (for example, oversized tires) are not eligible for Ship To Home delivery, so you can select the catalog that matches how you intend to fulfill those products.

How brand, style, and product data is sourced: Brand and style data still comes from the standard (Ship To Store) catalog, while product data can come from the Ship To Home catalog when Catalog Type is set to Ship To Home. The product ingestion pipeline works in three levels — brands, styles, and products — and only the product-level retrieval is affected by the Catalog Type you select.
Specification differences: Product specification details can differ between the Ship To Store and Ship To Home catalogs. If you switch Catalog Type, review your variant specifications and custom-field mappings to confirm the values populate as expected.
Mapping Options
  • Match It — Directly map a source field to a Flxpoint field.
  • Set It — Set a fixed/static value for a field.
  • Transform It (Mapping Set) — Apply a transformation or mapping set to the value.
  • Smart Rules — Use conditional logic to determine the mapped value.
  • Skip It (Don't Map) — Ignore the field entirely.
Summary: Map your required identifiers, pricing, and quantity (selecting the quantity type you want — Localplus, Nationwide, or Onhand), choose your Catalog Type (Ship To Store or Ship To Home), and verify your ATD connection passes Test Connection before running.

Quick Checks
  • ATD connection is selected and the API credentials pass Test Connection.
  • Quantity Type (Localplus, Nationwide, or Onhand) is selected in the mapping template.
  • Catalog Type (Ship To Store or Ship To Home) is set to match how you intend to fulfill these products.
  • Archive / Un-Archive is enabled in either Primary or Secondary — not both.
  • Run once manually first, then enable a daily schedule once verified.
Troubleshooting
  • Catalog not importing: Open the ATD connection and click Test Connection. If it fails, re-enter your ATD API credentials and retry.
  • Unexpected or missing items: Confirm your Catalog Type is set correctly. Some items (e.g., oversized tires) are not eligible for Ship To Home, so they may not appear when the Ship To Home catalog is selected.
  • Specifications look different after switching catalogs: Product specification details can differ between Ship To Store and Ship To Home. Review your variant specification and custom-field mappings.
Operation Details
Feature Availability What to Expect
Custom Fields Supported Additional tire information saved in variant custom fields.
Variations / Options Supported Size and Side Wall are used to create options.
Quantity Supported Localplus, Nationwide, or Onhand — saved as selected in mapping.
Pricing Supported Generic Pricing (& Currency). Client Pricing is not supported.
Weights & Dimensions Supported Weight in pounds, dimensions in inches.
Images Supported Available.
Categories Supported Single-level category available in the feed.
Catalog Type Supported Ship To Store (default) or Ship To Home product retrieval.
Multiple Warehouses Not Supported Single warehouse per integration; create one integration per warehouse.
Tip: Run Get Inventory (Primary) on a daily schedule for the full feed, and pair it with Get Inventory (Secondary) on a more frequent schedule to keep quantities and pricing fresh between full feed runs.

Get Inventory (Secondary)

Introduction

The Get Inventory (Secondary) operation is designed to provide more frequent updates to your product inventory, ensuring that your stock levels and pricing are as current as possible without running the full data import process.

Run it on a more frequent schedule (e.g., hourly) alongside Get Inventory (Primary) so quantity and pricing stay fresh between full feed runs.

Note: Get Inventory (Secondary) is a lightweight refresh — only quantity and pricing are updated. It does not re-import full product data.

Set up follows the same pattern as Primary:

  • 1Connect an Integration — Select your ATD connection.
  • 2Configure Settings — Choose the Quantity Type (Localplus, Nationwide, or Onhand) and enable Archive here only if it is not already enabled in Primary.
  • 3Define a Mapping Template — Map quantity and pricing fields, then Save and Complete.
  • 4Save & Schedule — Run on a frequent schedule to keep stock and pricing current.

Supported Features
  • Generic Pricing (& Currency).
  • Quantity: Three types of quantity option — Localplus, Nationwide, Onhand. Quantity will be saved as selected in the mapping template.
  • Delta Feed vs Full Feed: Only quantity and pricing are available.
  • Archive Support.
Not Supported
  • Custom Fields (Variants Only).
  • Client Pricing (& Currency).
  • Multiple Warehouses: We support a single warehouse per integration. To use more than one warehouse, create a separate integration for each warehouse.
  • Weights & Dimensions (& Units).
Note: Use the same Quantity Type and Catalog Type configuration as your Primary integration so the secondary refresh stays consistent with the full feed.

Quick Checks
  • ATD connection passes Test Connection.
  • Quantity and pricing fields are mapped.
  • Archive is enabled in either Primary or Secondary — not both.
Troubleshooting
  • Quantities not updating: Confirm the correct Quantity Type is selected and that the secondary job is scheduled frequently.
  • Pricing out of date: Verify the pricing field is mapped in the secondary template.
  • Items disappearing unexpectedly: Check that Archive is not enabled in both Primary and Secondary at the same time.
Tip: Pair Secondary (frequent, quantity + pricing only) with Primary (daily, full feed) for the freshest data with the least overhead.

Order Operations

Send Fulfillment Requests

Introduction

Send Fulfillment Requests submits orders to ATD for fulfillment so they can ship directly to your customers (dropship). An order is created with ATD through your configured connection, and the integration tracks the response so you know it was accepted.

The sections below walk through the workflow, the supported order details, and common issues.

Note: The Item ID received during Get Inventory (Primary) is sent with each fulfillment request. If the Item ID is blank in source inventory, FR processing will fail — make sure your catalog import is complete before sending orders.

The operation works as follows:

  • 1Connect an Integration — Select your ATD connection.
  • 2Map Order Fields — Map the fulfillment request fields (see Mapping & Configuration).
  • 3Submit & Acknowledge — Flxpoint sends the Fulfillment Request Number with the order; ATD returns an order ID on successful processing (auto-acknowledgement).
Reminder: ATD requires a successful order test in the Sandbox environment before live orders are allowed in Production. Contact ATD to confirm your test before switching to Production mode.

Supported Features
  • Fulfillment Request Number: The Flxpoint FR# is sent in the order.
  • FR Item Association: The Item ID received during Get Inventory (Primary) is sent. If the Item ID is blank in source inventory, FR processing will fail.
  • Auto Acknowledgements: We receive an order ID in the response for successful order processing.
  • Shipping Selection: The shipping method is selected per the logic mentioned in the operational flow.
Not Supported
  • Customer Association.
  • Custom Fields.
  • Attachments.

Quick Checks
  • The ATD connection passes Test Connection.
  • Your Sandbox test order was confirmed by ATD before going live.
  • Item ID is present in source inventory for every line item.
Troubleshooting
  • FR processing fails: Confirm the Item ID is not blank in source inventory — a missing Item ID will cause the request to fail.
  • Live orders not accepted: Make sure you completed the Sandbox test order and that ATD confirmed it before you switched to Production.
  • No acknowledgement returned: A successful order returns an order ID. If none is returned, check the job log for the ATD response and retry.
Tip: Keep your Get Inventory (Primary) import current so every product carries a valid Item ID before orders are routed to ATD.

Get Shipments

Introduction

The Get Shipments operation allows you to retrieve shipment tracking details and updates for your orders, ensuring that accurate delivery information is always available.

It imports shipment details after orders are submitted, giving you a seamless link between order processing and shipment tracking.

Note: Get Shipments retrieves tracking for orders ATD has shipped. Partial shipments are supported, so an order can return more than one shipment over time.

The operation works as follows:

  • 1Connect an Integration — Select your ATD connection.
  • 2Map Shipment Fields — Map shipping method and SKU (see Mapping & Configuration).
  • 3Schedule — Run on a regular schedule so tracking flows back to your orders as ATD ships them.

Supported Features
  • Carrier & Methods: Only the shipping method is available in the response.
  • Shipment Item Association: SKU is available in the response.
  • Partial Shipments.
Not Supported
  • Invoice Information.
  • Custom Fields (CFs).

Quick Checks
  • The ATD connection passes Test Connection.
  • Shipping method and SKU are mapped in the template.
  • The operation has an active schedule.
Troubleshooting
  • No tracking yet: The order may not have shipped on ATD's side. Tracking appears once ATD reports a shipment.
  • Carrier missing: Only the shipping method is returned; confirm the shipping method field is mapped.
  • Partial orders: Expect more than one shipment per order when ATD ships items separately.
Tip: Schedule Get Shipments to run regularly so tracking updates reach your customers without manual checks.

Troubleshooting

Common issues and solutions for the American Tire Distributors (ATD) integration. Expand each item to learn more.

Still need help? If you're experiencing issues not covered here, contact ATD or your Flxpoint account manager.

Contact Support