Wholesale Web Services Requirements Overview
TireConnect supports wide range of industry standard protocols and connectivity methods.
Outlined below are general requirements which will provide TireConnect platform with the ability to inquire on behalf of a specific dealer with a tire size or part number(s) and receive matching tires with quantity and dealer’s cost.
Dealer Authentication
All industry standard methods are supported and acceptable.
Required Methods / Endpoints
Search by size
Request structure
Required
width
profile
rim
Or it can be just size param that will accept raw size.
Optional
branches[] (branch ids) - several IDs can be transferred
min_quantity
Request example with width, height & rim
{
"width":205,
"profile":55,
"rim":16,
"branches":[
1,
2,
3
],
"min_quantity":1
}
Request example with size
{
"size":"2055516",
"branches":[
1,
2,
3
],
"min_quantity":1
}
Response structure
List of tires
brand
part_number (manufacturer part number, IMPORTANT: should not contain any other characters)
quantity breakdown (if present)
branch 1
branch 2
cost
retail_price (if applicable)
fet (The Federal Excise Tax (if applicable))
Optional
delivery_options - estimated delivery date, shipping cost, etc. can be on item level or branch level
shipping_cost - estimated shipping cost
delivery_date - estimated delivery date
cutoff - delivery cutoff time
branches.type In case there is an option for customer to have primary, alternative & other it can be
branches.typefor example, with values: primary, alternative, other. Or it can be just mark of primary branch for customer. Can be just true/false in case it’s only primary & other, for exampleprimary:true/false
Response example
[
{
"part_number":"000094",
"brand":"Bridgestone",
"retail_price":25.5,
"cost":20,
"fet":18.4,
"branches":[
{
"name":"Branch 1",
"id":1,
"quantity":4,
"type": "primary",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
}
},
{
"name":"Branch 2",
"id":2,
"quantity":4,
"type": "alternative",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
},
{
"name":"Branch 3",
"id":3,
"quantity":4,
"type": "other",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
}
}
]
}
]
Search by part numbers
Request structure
Required
part_numbers[] (multiple part numbers should be supported)
Optional
branches (branches ids) - several IDs can be transferred
min_quantity
Request example
{
"part_numbers":[
"000094"
],
"branches":[
1,
2,
3
],
"min_quantity":1
}
Response structure (identical to search by size response)
List of tires
brand
part_number (manufacturer part number, IMPORTANT: should not contain any other characters)
quantity breakdown (if present)
branch 1
branch 2
cost
retail_price (if applicable)
fet (The Federal Excise Tax (if applicable))
Optional
delivery_options - estimated delivery date, shipping cost, etc. can be on item level or branch level
shipping_cost - estimated shipping cost
delivery_date - estimated delivery date
cutoff - delivery cutoff time
branches.type In case there is an option for customer to have primary, alternative & other it can be
branches.typefor example, with values: primary, alternative, other. Or it can be just mark of primary branch for customer. Can be just true/false in case it’s only primary & other, for exampleprimary:true/false
Response example
[
{
"part_number":"000094",
"brand":"Bridgestone",
"retail_price":25.5,
"cost":20,
"fet":18.4,
"branches":[
{
"name":"Branch 1",
"id":1,
"quantity":4,
"type": "primary",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
}
},
{
"name":"Branch 2",
"id":2,
"quantity":4,
"type": "alternative",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
},
{
"name":"Branch 3",
"id":3,
"quantity":4,
"type": "other",
"delivery_options":{
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
}
}
]
}
]
Additional Methods
Get List of Dealer’s Branches
Request structure
authentication credentials (whichever are applicable)
Branch ID (optional, required only if sister stores are available)
branches.type In case there is an option for customer to have primary, alternative & other it can be
branches.typefor example, with values: primary, alternative, other. Or it can be just mark of primary branch for customer. Can be just true/false in case it’s only primary & other, for exampleprimary:true/false
Response structure
List of branches []
Response example
{
"branches":[
{
"name":"Branch 1",
"id":1,
"type": "primary"
},
{
"name":"Branch 2",
"id":2,
"type": "alternative"
},
{
"name":"Branch 3",
"id":3,
"type": "other"
}
]
}
Submit an order
Request structure
po_number
items (multiple tires can be passed)
part_number
brand
quantity
branch (if applicable)
delivery type
delivery instructions
Request example
{
"po_number": "PO Number",
"items": [
{
"part_number": "000094",
"brand": "Bridgestone",
"quantity": 4,
"branch": 1
}
],
"delivery_type": 1,
"delivery_instructions": "Please deliver ASAP"
}
Response structure
order_number (order or invoice number)
status
items
error
shipping_cost (if applicable)
fet (The Federal Excise Tax (if applicable))
shipping_cost - actual shipping cost for provided tire qty from selected branch
delivery_date - estimated delivery date
cutoff - delivery cutoff time
Response example
{
"order_number":1236434,
"status":"Processing",
"items":[
{
"part_number":"000094",
"quantity":4,
"price":25.67,
"fet":18.04,
"brand":"Bridgestone"
}
],
"delivery_info":{
"shipping_cost":89.41,
"delivery_date":"2024–01–01T10:12:29-03:00"
},
"error":null
}
Get order status
Request structure
order_number
Request example
{
"order_number": 1236434
}
Response structure
order_number
status
error
Response example
{
"order_number": 1236434,
"status": "Received",
"error": null
}
Get delivery options
Request structure
branch_id
brand
part_number
quantity
Request example
{
"brand": "Bridgestone",
"part_number": "000009",
"branch_id": 1,
"quantity": 4
}
Response structure
name - delivery method name
id - delivery method id
shipping_cost - actual shipping cost for provided tire qty from selected branch
delivery_date - estimated delivery date
cutoff - delivery cutoff time
Response example
{
"delivery_options":[
{
"name":"UPS",
"id":1,
"shipping_cost":89.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
},
{
"name":"FedEx",
"id":2,
"shipping_cost":122.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
},
{
"name":"Our Truck",
"id":3,
"shipping_cost":52.41,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
},
{
"name":"PickUp",
"id":4,
"shipping_cost":0,
"delivery_date":"2024–12–01T15:00:0-03:00",
"cutoff":"2024–12–01T10:00:00-03:00"
}
]
}