TireConnect allows you to use Dropship solution via API for two suppliers: ATD & TireHub.

Search methods

Please note that for all search methods you should additionally send postal_code parameter in request body. For example:

curl --location 'https://devdemo.tireconnect.ca/api/v2/tire/search/bySize?key=38da4e73268d601331f9160afdfbe2ab' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'width=205' \
--data-urlencode 'height=55' \
--data-urlencode 'rim=16' \
--data-urlencode 'location_id=12875' \
--data-urlencode 'postal_code=11207'

Ordering methods

For ordering you should only use methods listed under Dropship section in Ordering Documentation.

Order type:

Residential - Order will be delivered directly to customer.
Business - Order will be delivered to any business address.
Installer - Order will be delivered to installer who cooperates with the supplier. (ATD doesn’t support this type as for now so if you will use this type for ATD it will be changed to business automatically.).

Note: TireHub can change delivery type from installer to business in case tire unavailable within 50 miles.

Authorization

GET /api/location/auth

To be able to order you should authorize and get token.

Use Location Authorize method (/api/location/auth) which requires location, api key and pin code.

Request Example

curl --location --request POST 'https://devdemo.tireconnect.ca/api/location/auth' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dealer_location_id":12895,
    "pin_code":135790,
    "key":"b254926f52917154a5cf698b95419928"
}'

Request parameters

dealer_location_id
^int
^query

Dealer location

^required

pin_code
^int
^query

Pin Code

^required

key
^string
^query

API key

^required

Response Example

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJkZWFsZXJfbG9jYXRpb24iOjEyNjc0LCJleHAiOjE1NjA1MjY1ODl9.uEjbXiu1EoZ5E9IyXDz4JEVySY4C_C5mYXCC6SsGTwOCXyU3tHJU79FJkh5X2uMUlJttIQwoyC1HqljDl7_zIj-6XxvT-ismKDmdW7z7ZqrsGi6N3VACx9Rt1o3aJvBdDkSw4QfqhE8DZlLsYDH-TIGEOUP6E462Rfxn8bE149g",
  "expire": 900
}

Response Parameters

token ^string	Authorisation token
expire ^int	expire time

*Please note, token will expire in 900 seconds after it was issued. You need to get new token after that time.

Order Preview

POST /api/supplier/dropship/order/preview/

This method will provide you with the most recent information about order including delivery date & time and delivery fee.

Single Tire

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/dropship/order/preview/installer?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJkZWFsZXJfbG9jYXRpb24iOjEyODk1LCJleHAiOjE2OTY0MTc0NjV9.H-zTTpMIf7_Golaez_fNQctkuZqysulP3idywsEFrtgc3zRJktdfgKnJcUPxDp9F-QoxwYuaWQCQ5x8UL_G2CA50t_mZAW1WtickXi5A3trPSjjfyJ-pUcdxmbrIPlwD9yaGs6eXyvn7Ogji-TeGjefSLja4ZRFoGdfXU3zeIgQ' \
--header 'Content-Type: application/json' \
--data '{
  "location_id": 12895,
  "tires": [
    {
      "tire_id": "UHJpbnh8fDM0MzEyNTA3MDN8fHRpcmVodWJkcm9wc2hpcHx8MTI4OTV8fEI=",
      "quantity": 1
    }
  ],
  
  "delivery_address": {
    "address_line_1": "311 Madison Street",
    "address_line_2": "string",
    "city": "Oak Park",
    "province": "IL",
    "country": "US",
    "postal_code": "11207"
  },
  "installer_id": "123456"
}'

Multi Tire

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/dropship/order/preview/installer?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJkZWFsZXJfbG9jYXRpb24iOjEyODk1LCJleHAiOjE2OTY0MjAyNDF9.gtzjRCerVbwJEaJ0fMxkR7JEbeKxbiDbB41GVaqzfBpvRSPiNUfNR6yAk2KgL5Uc6rQRKVKs0AM0bX6NSlFSykTPelUkKws0t45lYIBMEpX4Ig91R9TJ0OJOQmOe7QhdMHjmgGBjPKNfl3cwAUWlzD9cOcqXNn68aFajh8exCDM' \
--header 'Content-Type: application/json' \
--data '{
  "location_id": 12895,
  "tires": [
    {
      "tire_id": "UHJpbnh8fDM0MzEyNTA3MDN8fHRpcmVodWJkcm9wc2hpcHx8MTI4OTV8fEI=",
      "quantity": 1
    },
    {
      "tire_id": "QnJpZGdlc3RvbmV8fDA1MzkxNnx8dGlyZWh1YmRyb3BzaGlwfHwxMjg5NXx8Qg==",
      "quantity": 1
    }
  ],

  "delivery_address": {
    "address_line_1": "311 Madison Street",
    "address_line_2": "string",
    "city": "Oak Park",
    "province": "IL",
    "country": "US",
    "postal_code": "11207"
  },
  "installer_id": "123456"
}'

Request parameters

token

^query

Authorisation token

^required

tire_id

_string

^query

Tire ID

^required

quantity

^int
^query

Tire Quantity
^required

address_line_1

_string
^query

Address Line 1
^required

address_line_2
^query

Address Line 2
^optional

city

_string
^query

City
^required

province

_string
^query

Province
^required

country

_string
^query

Country
^required

postal_code

_string
^query

ZIP/Postal Code
^required

installer_id

_string
^query

Installer ID
^required^{only for installer order}

Response example

{
    "data": {
        "items": [
            {
                "tires": [
                    {
                        "tire_id": "UHJpbnh8fDM0MzEyNTA3MDN8fHRpcmVodWJkcm9wc2hpcHx8MTI4OTV8fEI=",
                        "part_number": "PX 3431250703",
                        "brand": "Prinx",
                        "price": 69.99,
                        "retail_price": 69.99,
                        "quantity": 1,
                        "fet": null,
                        "delivery_fee": null,
                        "delivery_date_time": {
                            "date": "2023-10-12",
                            "time": "17:00:00",
                            "timezone": "-04:00"
                        }
                    }
                ],
                "order_total": {
                    "delivery_fee": 7.55,
                    "fet": 0,
                    "total_price": 77.54
                },
                "delivery_date_time": {
                    "date": "2023-10-12",
                    "time": "17:00:00",
                    "timezone": "-04:00"
                }
            }
        ]
    }
}

Ordering restrictions

In one order can’t be placed tires from different suppliers. In this case it should be several different orders:

{
    "success": false,
    "status": 400,
    "error_code": 400099,
    "message": "All tires must belong to the same supplier",
    "errors": null
}

In one order can’t be placed more than four sku:

{
    "success": false,
    "status": 400,
    "error_code": 400100,
    "message": "Max tires exceeded, 4 tires allowed.",
    "errors": null
}

Dropship Solution

Search methods

Ordering methods

Authorization

Order Preview

Single Tire

Multi Tire

Ordering restrictions