1 Main settings
2 Tire Search
- 2.1 Suppliers connected to location
3 Supplier Ordering
- 3.1 Authorization
- 3.2 Tire Stock
- 3.3 Supplier fields
  - 3.3.1 Single tire
  - 3.3.2 Multi-tire
- 3.4 preOrderingInfo
  - 3.4.1 Single tire order
  - 3.4.2 Multi-tire order
- 3.5 Order create method
- 3.6 Order Status

Main settings

Here is the API key which allows you to test ordering

05198c64d142efd851ef15e54fdd917d

It provides you access to the following location ID:

12674

Also you will need a PIN code to authorize. PIN code is different for every location.

For location mentioned above you can use this one:

416905

*Please note, this pin code needs to be entered by the user, it can not be hardcoded.

Tire Search

Swagger Documentation

You can make any kind of search, for example using search By Size method

Please make sure you are using sandbox environment base URL:

https://devdemo.tireconnect.ca

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/tire/search/v1/by/size' \
--header 'key: 05198c64d142efd851ef15e54fdd917d' \
--header 'Content-Type: application/json' \
--data '{
  "location_id": 12674,
  "size": {
    "front": {
      "size_part_1": "205",
      "size_part_2": "55",
      "size_part_3": "16"
    }
  }
}'

Suppliers connected to location

Swagger Documentation

He highly recommend to use this method to get common information about specific supplier in ordering array. Please see description below response example.

Request example

curl --location 'https://devdemo.tireconnect.ca/api/location/v1/tire/supplier-connection/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'key: 05198c64d142efd851ef15e54fdd917d' \
--data '{
  "location_id": 12674
}'

Response example

{
    "success": true,
    "data": {
        "items": [
            {
                "supplier_id": "AF",
                "supplier_connection_id": "usautoforce",
                "supplier_connection_name": "U.S. AutoForce",
                "is_internal": false,
                "ordering": {
                    "enabled": true,
                    "max_items_per_order": 25,
                    "branch_required": true,
                    "multiple_branch": false
                },
                "availability": null
            },
            {
                "supplier_id": "TH",
                "supplier_connection_id": "tirehub",
                "supplier_connection_name": "TireHub",
                "is_internal": false,
                "ordering": {
                    "enabled": true,
                    "max_items_per_order": 10,
                    "branch_required": true,
                    "multiple_branch": false
                },
                "availability": null
            },
            {
                "supplier_id": "LI-TEST",
                "supplier_connection_id": "discountgroup",
                "supplier_connection_name": "Discount Group",
                "is_internal": false,
                "ordering": null,
                "availability": null
            },
            {
                "supplier_id": "FMT",
                "supplier_connection_id": "fairmonttire",
                "supplier_connection_name": "Fairmont Tire",
                "is_internal": false,
                "ordering": {
                    "enabled": true,
                    "max_items_per_order": 25,
                    "branch_required": true,
                    "multiple_branch": true
                },
                "availability": null
            },
            {
                "supplier_id": "TR",
                "supplier_connection_id": "trwholesale",
                "supplier_connection_name": "TR Wholesale",
                "is_internal": false,
                "ordering": {
                    "enabled": true,
                    "max_items_per_order": 12,
                    "branch_required": false,
                    "multiple_branch": false
                },
                "availability": null
            },
        ]
    },
    "meta": {
        "total": 5
    }
}

*Please note that stock method filters accept supplier_connection_id param value.

Useful response parameters

supplier_id ^string	Global supplier ID. Can be used to map supplier across different systems
supplier_connection_id ^string	Connection ID. Used in stock method
supplier_connection_name ^string	Connection nice name. Can be used to show to a customer as a connection label
ordering ^object	Set of settings specific to ordering flow. In case supplier don’t support ordering will be null
enabled ^boolean	Settings that shows if ordering enabled for specific connection
max_items_per_order ^int	Max items that can be ordered in one order
branch_required ^int	Specifies if branch should be passed in order or no
multiple_branch ^int	Specifies if tires from different branches can be passed in one order

Supplier Ordering

https://wl.tireconnect.ca/api/doc/supplier

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":12674,
    "pin_code":416905,
    "key":"05198c64d142efd851ef15e54fdd917d"
}'

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.

Tire Stock

GET /api/supplier/stock

To make order first of all you should check if it supports ordering and which fields you should send additionally when making orders.

Request example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/stock?tire_id=QnJpZGdlc3RvbmV8fDAwMzE5M3x8dGlyZWh1Ynx8MTI2NzR8fEI%3D' \
--header 'token: {{token}}' \

Request parameters

token

^header

Authorisation token

^required

tire_id

^query

Tire ID

^required

Response example

{
    "stock": [
        {
            "supplier": {
                "name": "km",
                "nice_name": "K&M",
                "dependence_quantity": false,
                "dependence_fields": [
                    "DeliveryMethod"
                ],
                "multiple_branch_ordering": false,
                "multiple_tires_ordering": true,
                "has_ordering_fields": true
            },
            "branches": [
                {
                    "branch": "Alternate",
                    "id": "Alternate",
                    "quantity": 5,
                    "name": "Alternate ",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "National",
                    "id": "National",
                    "quantity": 27,
                    "name": "National",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                }
            ],
            "tire_id": "QnJpZGdlc3RvbmV8fDAwMzE5M3x8a218fDEyNjc0fHxC",
            "price": 177,
            "quantity": 32,
            "is_in_stock": false,
            "part_number_original": "003193",
            "cost": 152,
            "ordering_type": "base"
        },
        {
            "supplier": {
                "name": "maxfinkelstein",
                "nice_name": "Max Finkelstein",
                "dependence_quantity": true,
                "dependence_fields": [],
                "multiple_branch_ordering": false,
                "multiple_tires_ordering": true,
                "has_ordering_fields": true
            },
            "branches": [
                {
                    "branch": "Local",
                    "id": "Local",
                    "quantity": 2,
                    "name": "Local - Promised Ship Date: 10/12/2023",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "Other_2023_10_12",
                    "id": "Other_2023_10_12",
                    "quantity": 6,
                    "name": "Next Day - Promised Ship Date: 10/12/2023",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                }
            ],
            "tire_id": "QnJpZGdlc3RvbmV8fDAwMzE5M3x8bWF4Zmlua2Vsc3RlaW58fDEyNjc0fHxC",
            "price": 139.13,
            "quantity": 8,
            "is_in_stock": false,
            "part_number_original": "003193",
            "cost": 139.13,
            "ordering_type": "base"
        },
        {
            "supplier": {
                "name": "tirehub",
                "nice_name": "TireHub",
                "dependence_quantity": true,
                "dependence_fields": [],
                "multiple_branch_ordering": false,
                "multiple_tires_ordering": true,
                "has_ordering_fields": true
            },
            "branches": [
                {
                    "branch": "100",
                    "id": "100",
                    "quantity": 9,
                    "name": "TLC 100 RALEIGH (10/12/2023 05:00pm)",
                    "ship_data": "a. Local customer - based on next available cut-off (Please see in B2B portal). \nb. Within 200 miles, before 2:30 PM in a local time zone on a business day - next business day.\nc. 300 miles, before 2:30 P.M  local time business day 2 business days.\ne. Everything else - 3-5 business days.\n\nFor orders made not on a business day, 1 business day is added to projected delivery. 1 day added for Freight orders on Saturdays",
                    "address": {
                        "address1": "900 AVIATION PKWY",
                        "address2": null,
                        "postal_code": "27560-9224",
                        "city": "MORRISVILLE",
                        "province": "NC",
                        "country": null
                    },
                    "contact": {
                        "name": null,
                        "first_name": null,
                        "last_name": null,
                        "email": "tlc100raleigh@tirehub.com",
                        "alt_email": null,
                        "phone": "919-674-5026",
                        "alt_phone": null
                    },
                    "estimated_delivery_date": "2023-10-12",
                    "estimated_delivery_time": "17:00:00",
                    "timezone": null,
                    "distance": 40,
                    "distance_unit": "ml"
                },
                {
                    "branch": "104",
                    "id": "104",
                    "quantity": 3,
                    "name": "TLC 104 JACKSONVILLE (10/17/2023 05:00pm)",
                    "ship_data": "a. Local customer - based on next available cut-off (Please see in B2B portal). \nb. Within 200 miles, before 2:30 PM in a local time zone on a business day - next business day.\nc. 300 miles, before 2:30 P.M  local time business day 2 business days.\ne. Everything else - 3-5 business days.\n\nFor orders made not on a business day, 1 business day is added to projected delivery. 1 day added for Freight orders on Saturdays",
                    "address": {
                        "address1": "4101 BULLS BAY HWY",
                        "address2": null,
                        "postal_code": "32219-0000",
                        "city": "JACKSONVILLE",
                        "province": "FL",
                        "country": null
                    },
                    "contact": {
                        "name": null,
                        "first_name": null,
                        "last_name": null,
                        "email": "tlc104JACKSONVILLE@tirehub.com",
                        "alt_email": null,
                        "phone": "904-693-8576",
                        "alt_phone": null
                    },
                    "estimated_delivery_date": "2023-10-17",
                    "estimated_delivery_time": "17:00:00",
                    "timezone": null,
                    "distance": 418,
                    "distance_unit": "ml"
                },
                {
                    "branch": "103",
                    "id": "103",
                    "quantity": 17,
                    "name": "TLC 103 TAMPA (10/18/2023 05:00pm)",
                    "ship_data": "a. Local customer - based on next available cut-off (Please see in B2B portal). \nb. Within 200 miles, before 2:30 PM in a local time zone on a business day - next business day.\nc. 300 miles, before 2:30 P.M  local time business day 2 business days.\ne. Everything else - 3-5 business days.\n\nFor orders made not on a business day, 1 business day is added to projected delivery. 1 day added for Freight orders on Saturdays",
                    "address": {
                        "address1": "4942 JOANNE KEARNEY BLVD",
                        "address2": null,
                        "postal_code": "33619-0000",
                        "city": "TAMPA",
                        "province": "FL",
                        "country": null
                    },
                    "contact": {
                        "name": null,
                        "first_name": null,
                        "last_name": null,
                        "email": "tlc103TAMPA@tirehub.com",
                        "alt_email": null,
                        "phone": "813-621-3103",
                        "alt_phone": null
                    },
                    "estimated_delivery_date": "2023-10-18",
                    "estimated_delivery_time": "17:00:00",
                    "timezone": null,
                    "distance": 591,
                    "distance_unit": "ml"
                }
            ],
            "tire_id": "QnJpZGdlc3RvbmV8fDAwMzE5M3x8dGlyZWh1Ynx8MTI2NzR8fEI=",
            "price": 137,
            "quantity": 29,
            "is_in_stock": false,
            "part_number_original": "003193",
            "cost": 137,
            "ordering_type": "per_branch"
        },
        {
            "supplier": {
                "name": "trwholesale",
                "nice_name": "TR Wholesale",
                "dependence_quantity": true,
                "dependence_fields": [
                    "deliveryMethod"
                ],
                "multiple_branch_ordering": false,
                "multiple_tires_ordering": true,
                "has_ordering_fields": true
            },
            "branches": [
                {
                    "branch": "SB",
                    "id": "SB",
                    "quantity": 6,
                    "name": "South Bend, IN",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "MN",
                    "id": "MN",
                    "quantity": 6,
                    "name": "Roseville, MN",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                }
            ],
            "tire_id": "QnJpZGdlc3RvbmV8fDAwMzE5M3x8dHJ3aG9sZXNhbGV8fDEyNjc0fHxC",
            "price": 128.75,
            "quantity": 68,
            "is_in_stock": false,
            "part_number_original": "003193",
            "cost": 128.75,
            "ordering_type": "base"
        }
    ]
}

Response parameters

supplier ^object
name ^string	Supplier Name
nice_name ^string	Supplier Nice Name
dependence_quantity ^boolean	Parameter that tells you that accepted fields or it’s values can depend on tire quantity.	Some suppliers may vary accepted fields and their values based on the tire availability. So in case this param = true we highly recommend calling fields method every time user change quantity.
dependence_fields ^array	List of fields and it’s values that can be changes according to selected values	If some fields returned in this array, fields or its possible values list can be adjusted when you change the value of these fields
multiple_branch_ordering ^boolean	Shows if supplier support multiple branch ordering	true - you can send tires from different branches in one order false - you can’t send tires from different branches in one order
multiple_tires_ordering ^boolean	Shows if you can send several tires in one order	true - you can send several tires in one order false - one tire per order
has_ordering_fields ^boolean	Shows if you should send some fields in order	true - fields should be send in order false - order can be made without fields
branches ^array	Array of supplier branches
branch ^string	Branch id	Used for old implementations. Deprecated
id ^string	Branch id
quantity ^int	Available qty in branch
name ^string	Branch name
ship_data ^string	Some shipping rules provided by the supplier
address ^object	Warehouse address
contact ^object	Warehouse contact details
estimated_delivery_date ^string	Estimated delivery date provided by the supplier
estimated_delivery_time ^string	Estimated delivery time provided by the supplier
timezone ^string	Timezone
distance ^int	Distance from warehouse (provided by the supplier)
distance_unit ^string	Distance unit
tire_id ^string	Tire ID
price ^int	Tire price
quantity ^int	Tire available quantity
is_in_stock ^boolean	Inner fields, not used for direct ordering
part_number_original ^string	Supplier part number
cost ^int	Tire cost
ordering_type ^string	Show it branch should be used in requests	base - branch shouldn’t be used in requests per_branch - branch should be used in requests

*Please note that stock method will return data for all suppliers that has this tire available. In case you need only one particular you can use supplier filter in this method.

Request example filtered by supplier

curl --location 'https://devdemo.tireconnect.ca/api/supplier/stock?tire_id=QnJpZGdlc3RvbmV8fDAwMzE5M3x8dGlyZWh1Ynx8MTI2NzR8fEI%3D&suppliers=communitywholesaletire' \
--header 'token: {{token}}' \

Response example filtered by supplier

{
    "stock": [
        {
            "supplier": {
                "name": "trwholesale",
                "nice_name": "TR Wholesale",
                "dependence_quantity": true,
                "dependence_fields": [
                    "deliveryMethod"
                ],
                "multiple_branch_ordering": false,
                "multiple_tires_ordering": true,
                "has_ordering_fields": true
            },
            "branches": [
                {
                    "branch": "SB",
                    "id": "SB",
                    "quantity": 6,
                    "name": "South Bend, IN",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "MN",
                    "id": "MN",
                    "quantity": 6,
                    "name": "Roseville, MN",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "DE",
                    "id": "DE",
                    "quantity": 4,
                    "name": "New Castle, DE",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "AT",
                    "id": "AT",
                    "quantity": 7,
                    "name": "Atlanta, GA",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "SL",
                    "id": "SL",
                    "quantity": 12,
                    "name": "Shreveport, LA",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "GA",
                    "id": "GA",
                    "quantity": 5,
                    "name": "Midway, GA",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "F1",
                    "id": "F1",
                    "quantity": 4,
                    "name": "Davie, FL",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "NV",
                    "id": "NV",
                    "quantity": 12,
                    "name": "McCarran, NV",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                },
                {
                    "branch": "C1",
                    "id": "C1",
                    "quantity": 12,
                    "name": "Santa Fe Springs, CA",
                    "ship_data": null,
                    "address": null,
                    "contact": null,
                    "estimated_delivery_date": null,
                    "estimated_delivery_time": null,
                    "timezone": null,
                    "distance": null,
                    "distance_unit": null
                }
            ],
            "tire_id": "QnJpZGdlc3RvbmV8fDAwMzE5M3x8dHJ3aG9sZXNhbGV8fDEyNjc0fHxC",
            "price": 128.75,
            "quantity": 68,
            "is_in_stock": false,
            "part_number_original": "003193",
            "cost": 128.75,
            "ordering_type": "base"
        }
    ]
}

Supplier fields

GET /api/supplier/{supplierName}/fields

Single tire

Request example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/km/fields?tire_id=QnJpZGdlc3RvbmV8fDAwMzE5M3x8Y29tbXVuaXR5d2hvbGVzYWxldGlyZXx8MTI2NzR8fEI%3D&quantity=4' \
--header 'token: {{token}}' \

Request parameters

supplierName ^string ^path	Supplier’s name supplier.name from /api/supplier/stock method or supplier.id from api/v2/location/:location_id:/suppliers method ^required
tire_id ^string ^query	Tire ID ^required
quantity ^int ^query	Tire quantity ^{optional if}^{dependence_quantity = false}
branch ^string ^query	Tire branch ^{optional if}^{ordering_type}^{not equal to "}^per_branch^"	Some suppliers may vary accepted fields and their values based on the selected branch.

Response example

[
    {
        "tag": "input",
        "label": "PO number",
        "description": "Purchase Order Number",
        "attributes": {
            "name": "po_number",
            "required": true,
            "type": "text",
            "maxlength": 20,
            "minlength": 3
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "textarea",
        "label": "Delivery Instructions",
        "description": "Shipping and Delivery Instructions",
        "attributes": {
            "name": "deliveryInstructions",
            "required": false,
            "maxlength": 255
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "select",
        "label": "Delivery method",
        "description": "Delivery Method",
        "attributes": {
            "name": "deliveryMethod",
            "required": true
        },
        "default": "UPS",
        "hidden": false,
        "required_for_pricing": true,
        "options": [
            {
                "value": "UPS",
                "text": "UPS Ground",
                "disabled": false
            },
            {
                "value": "FE2",
                "text": "FedEx 2DAY",
                "disabled": false
            },
            {
                "value": "2DA",
                "text": "UPS 2nd Day Air",
                "disabled": false
            },
            {
                "value": "CPU",
                "text": "Customer Pick-Up",
                "disabled": false
            }
        ]
    },
    {
        "tag": "select",
        "label": "Sales person",
        "description": null,
        "attributes": {
            "name": "salesPerson",
            "required": false
        },
        "default": "",
        "hidden": false,
        "required_for_pricing": false,
        "options": [
            {
                "value": "",
                "text": "",
                "disabled": false
            },
            {
                "value": "AJ",
                "text": "AJ",
                "disabled": false
            }
        ]
    }
]

Every item of response describes a fields which required for order or can be additionally sent with the order.

NOTE: Also for “select” type of fields, options list was extended, disabled property introduced.
When disabled is true, this option is not allowed to be passed, but we recommend to show it to the user, but as an unavailable option, as soon as for another quantity amount, it could be available. If disabled is false, option is available as earlier.

Response Example

[
    {
        "tag": "input",
        "label": "PO number",
        "description": "Purchase Order Number",
        "attributes": {
            "name": "po_number",
            "required": true,
            "type": "text",
            "maxlength": 20,
            "minlength": 3
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "textarea",
        "label": "Delivery Instructions",
        "description": "Shipping and Delivery Instructions",
        "attributes": {
            "name": "deliveryInstructions",
            "required": false,
            "maxlength": 255
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "select",
        "label": "Delivery method",
        "description": "Delivery Method",
        "attributes": {
            "name": "deliveryMethod",
            "required": true
        },
        "default": "UPS",
        "hidden": false,
        "required_for_pricing": true,
        "options": [
            {
                "value": "UPS",
                "text": "UPS Ground",
                "disabled": false
            },
            {
                "value": "FE2",
                "text": "FedEx 2DAY",
                "disabled": true
            },
            {
                "value": "2DA",
                "text": "UPS 2nd Day Air",
                "disabled": true
            },
            {
                "value": "CPU",
                "text": "Customer Pick-Up",
                "disabled": false
            }
        ]
    },
    {
        "tag": "select",
        "label": "Sales person",
        "description": null,
        "attributes": {
            "name": "salesPerson",
            "required": false
        },
        "default": "",
        "hidden": false,
        "required_for_pricing": false,
        "options": [
            {
                "value": "",
                "text": "",
                "disabled": false
            },
            {
                "value": "AJ",
                "text": "AJ",
                "disabled": false
            }
        ]
    }
]

Multi-tire

Request example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/km/fields?tires=QnJpZGdlc3RvbmV8fDAwMzE5M3x8Y29tbXVuaXR5d2hvbGVzYWxldGlyZXx8MTI2NzR8fEI%3D%2CQnJpZGdlc3RvbmV8fDAwNDI4NXx8Y29tbXVuaXR5d2hvbGVzYWxldGlyZXx8MTI2NzR8fEI%3D&quantities=1%2C1' \
--header 'token: {{token}}' \

Request parameters

supplierName ^string ^path	Supplier’s name ^required
tire_ids ^string ^query	Tire IDs comma separated ^required
quantities ^int ^query	Tire quantities comma separated ^{optional if}^{dependence_quantity = false}
branches ^string ^query	Tire branches comma separated ^{optional if}^{ordering_type}^{not equal to "}^per_branch^"

Response

[
    {
        "tag": "input",
        "label": "PO number",
        "description": "Purchase Order Number",
        "attributes": {
            "name": "po_number",
            "required": true,
            "type": "text",
            "maxlength": 20,
            "minlength": 3
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "textarea",
        "label": "Delivery Instructions",
        "description": "Shipping and Delivery Instructions",
        "attributes": {
            "name": "deliveryInstructions",
            "required": false,
            "maxlength": 255
        },
        "default": null,
        "hidden": false,
        "required_for_pricing": false
    },
    {
        "tag": "select",
        "label": "Delivery method",
        "description": "Delivery Method",
        "attributes": {
            "name": "deliveryMethod",
            "required": true
        },
        "default": "UPS",
        "hidden": false,
        "required_for_pricing": true,
        "options": [
            {
                "value": "UPS",
                "text": "UPS Ground",
                "disabled": false
            },
            {
                "value": "FE2",
                "text": "FedEx 2DAY",
                "disabled": false
            },
            {
                "value": "2DA",
                "text": "UPS 2nd Day Air",
                "disabled": false
            },
            {
                "value": "CPU",
                "text": "Customer Pick-Up",
                "disabled": false
            }
        ]
    },
    {
        "tag": "select",
        "label": "Sales person",
        "description": null,
        "attributes": {
            "name": "salesPerson",
            "required": false
        },
        "default": "",
        "hidden": false,
        "required_for_pricing": false,
        "options": [
            {
                "value": "",
                "text": "",
                "disabled": false
            },
            {
                "value": "AJ",
                "text": "AJ",
                "disabled": false
            }
        ]
    }
]

preOrderingInfo

POST /api/supplier/order/preOrderingInfo

This method will show you actual tire availability and depending on requested qty/delivery method/requested date/ect

Single tire order

Request example

curl --location 'https://devdemo.tireconnect.ca/api/supplier/order/preOrderingInfo' \
--header 'token: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tires":[
        {
        "tire_id":"TGF1ZmVubnx8MTAxNjc1OXx8ZmFpcm1vbnR0aXJlfHwxMjY3NHx8Qg==",
        "quantity":1,
        "branch": "3" //please read parameters description
        }
    ],
    "supplier_fields":{
      "po_number":"TEST PO",
      "delivery_type":"2",
      "delivery_instructions":"Some instructions"
   }
}'

Request parameters

token ^header ^string	Authorisation token ^required
tire_id ^string	Tire ID ^required
quantity ^int	Tire Quantity ^required
supplier_fields ^object	Object of supplier filelds ^{optional if}^{has_ordering_fields = false}
branch ^string	Supplier branch ^{not needed if}^{ordering_type=base} ^if^{multiple_branch_ordering}⁼^true^{you should send branch for each tire}

Response example

{
    "tires": [
        {
            "tire_id": "UHJpbnh8fDM1MjEyNTA3MDN8fHRpcmVodWJ8fDEyNjc3fHxC",
            "branch": "100",
            "cost": 50.99,
            "fet": null,
            "fet_source": "tireconnect",
            "quantity": 4,
            "quantity_available": 190,
            "stock_available": [
                {
                    "branch": "100",
                    "id": "100",
                    "branch_type": "primary",
                    "quantity": 190,
                    "name": "TLC 100 RALEIGH (04\/01\/2024 03:00pm)",
                    "ship_data": "a. Local customer - based on next available cut-off (Please see in B2B portal). \nb. Within 200 miles, before 2:30 PM in a local time zone on a business day - next business day.\nc. 300 miles, before 2:30 P.M  local time business day 2 business days.\ne. Everything else - 3-5 business days.\n\nFor orders made not on a business day, 1 business day is added to projected delivery. 1 day added for Freight orders on Saturdays",
                    "address": {
                        "address1": "900 AVIATION PKWY",
                        "address2": null,
                        "postal_code": "27560-9224",
                        "city": "MORRISVILLE",
                        "province": "NC",
                        "country": null
                    },
                    "contact": {
                        "name": null,
                        "first_name": null,
                        "last_name": null,
                        "email": "tlc100raleigh@tirehub.com",
                        "alt_email": null,
                        "phone": "919-674-5026",
                        "alt_phone": null
                    },
                    "delivery_date_time": {
                        "date": "2024-04-01",
                        "time": "15:00:00",
                        "timezone": "-04:00",
                        "notes": null
                    },
                    "cutoff": {
                        "date": "2024-04-01",
                        "time": "11:00:00",
                        "timezone": "-04:00"
                    },
                    "distance": 40,
                    "distance_unit": "ml"
                }
            ]
        }
    ],
    "cost": 50.99,
    "quantity": 4,
    "quantity_available": 190,
    "stock_available": [
        {
            "branch": "100",
            "id": "100",
            "branch_type": "primary",
            "quantity": 190,
            "name": "TLC 100 RALEIGH (04\/01\/2024 03:00pm)",
            "ship_data": "a. Local customer - based on next available cut-off (Please see in B2B portal). \nb. Within 200 miles, before 2:30 PM in a local time zone on a business day - next business day.\nc. 300 miles, before 2:30 P.M  local time business day 2 business days.\ne. Everything else - 3-5 business days.\n\nFor orders made not on a business day, 1 business day is added to projected delivery. 1 day added for Freight orders on Saturdays",
            "address": {
                "address1": "900 AVIATION PKWY",
                "address2": null,
                "postal_code": "27560-9224",
                "city": "MORRISVILLE",
                "province": "NC",
                "country": null
            },
            "contact": {
                "name": null,
                "first_name": null,
                "last_name": null,
                "email": "tlc100raleigh@tirehub.com",
                "alt_email": null,
                "phone": "919-674-5026",
                "alt_phone": null
            },
            "delivery_date_time": {
                "date": "2024-04-01",
                "time": "15:00:00",
                "timezone": "-04:00",
                "notes": null
            },
            "cutoff": {
                "date": "2024-04-01",
                "time": "11:00:00",
                "timezone": "-04:00"
            },
            "distance": 40,
            "distance_unit": "ml"
        }
    ],
    "total_cost": 203.96,
    "total_fet": 0,
    "shipping_cost": null,
    "vendor_total_order": 214,
    "total_order": 203.96,
    "delivery_date_time": null
}

Response parameters

quantity ^int
tire_id ^string	Tire ID
branch ^string	Branch ID
cost ^int	Tire Cost
fet ^int	FET
quantity ^int	Selected tire quantity
quantity_available ^int	Available quantity for this tire
stock_available ^array	List of branches with quantities where this tire currently available
branch ^string	Branch ID. Deprecated
id ^string	Branch ID

Supplier Ordering Integration Guide

Main settings

Tire Search

Suppliers connected to location

Supplier Ordering

Authorization

Tire Stock

Supplier fields

Single tire

Multi-tire

preOrderingInfo

Single tire order