Search by size

Request structure

Required

width
profile
rim

Optional

...

Or it can be just size param that will accept raw size.

Optional

min_quantity - minimum qty that available in stock

Request example with width, height & rim

Code Block

language	json

{
   "width": 205,
   "heightprofile": 55,
   "rim": 16,
   "locationsmin_quantity": [1,21
}

Request example with size

Code Block

language	json

{
   ],"size":"2055516",
   "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)
- location branch 1
- location branch 2
cost
retail_price (if applicable)
fet (The Federal Excise Tax (if applicable))

Optional

delivery_info - 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.type for 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 example primary: true/false

Response example

Code Block

language	json

[
   {
      "part_number": "000094",
      "brand": "Bridgestone",
      "retail_price": 25.5,
      "cost": 20,
      "locationsfet":18.4,
      "branches":[
         {
            "name":"Branch 1",
            "id":1,
            "quantity":4,
            "type":"primary",
            "delivery_info":{
               "shipping_cost":89.41,
               "delivery_date":"2024–12–01T15:00:00-03:00",
               "cutoff":"2024–12–01T10:00:00-03:00"
            }
         },
         {
            "name":"Branch "Location 1",2",
            "id":2,
            "quantity":4,
            "type":"alternative",
            “id”: 1"delivery_info":{
               "shipping_cost":89.41,
               "delivery_date":"2024–12–01T15:00:00-03:00",
   "quantity": 4            "cutoff":"2024–12–01T10:00:00-03:00"
            }
         },
         {
      {      "name":"Branch 3",
            "nameid":3,
 "Location 2",
             "quantity":4,
            "type":"other",
            "delivery_info":{
              “id”: 2 "shipping_cost":89.41,
                "quantity": 4
 "delivery_date":"2024–12–01T15:00:00-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

locations (locations ids) - several IDs can be transferred
min_quantity - minimum qty that available in stock

Request example

Code Block

language	json

{
   "part_numbers": [
    "000094"
  ],
  "locations000094":
[1,2   ],
   "min_quantity": 1
}

Response structure (identical to search by size response)

...

brand
part_number (manufacturer part number, IMPORTANT: should not contain any other characters)
quantity breakdown (if present)
- location branch 1
- location branch 2
cost
retail_price (if applicable)
fet (The Federal Excise Tax (if applicable))

Optional

delivery_info - 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.type for 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 example primary: true/false

Response example

Code Block

language	json

[
   {
      "part_number": "000094",
      "brand": "Bridgestone",
      "retail_price": 25.5,
      "cost": 20,
      "locationsfet":18.4,
      "branches":[
         {
            "name":"Branch 1",
            "id":1,
            "quantity":4,
            "type":"primary",
            "delivery_info":{
               "shipping_cost":89.41,
               "delivery_date":"2024–12–01T15:00:00-03:00",
               "cutoff":"2024–12–01T10:00:00-03:00"
            }
         },
         {
            "name":"Branch "Location 1"2",
            "id":2,
            "quantity":4,
         “id”: 1, 
   "type":"alternative",
            "delivery_info":{
               "shipping_cost":89.41,
               "delivery_date":"2024–12–01T15:00:00-03:00",
               "cutoff"quantity": 4:"2024–12–01T10:00:00-03:00"
            }
         },
         {
         {   "name":"Branch 3",
            "nameid":3,
"Location 2",
            "quantity":4,
            "type":"other",
            "delivery_info":{
               “id”: 2"shipping_cost":89.41,
                "quantity": 4
 "delivery_date":"2024–12–01T15:00:00-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)
location 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.type for 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 example primary: true/false

Response structure

List of Locations branches []

Response example

Code Block

language	json

{
   "locationsbranches":[
 [     {
         "name":"Branch "Location 1"1",
         "id":1,
  “id”: 1       "type": "primary"
      },
      {
         "name":"Branch "Location 2",
  "id": 2
  }
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)
1. part_number
2. brand
3. quantity
4. location branch (if applicable)
delivery type
delivery instructions

Request example

Code Block

language	json

{
  "po_number": "PO Number",
  "items": [
    {
      "part_number": "000094",
      "brand": "Bridgestone",
      "quantity": 4,
      "locationbranch": 1
    }
  ],
  "delivery_type": 1,
  "delivery_instructions": "Please deliver ASAP"
}

...

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

Code Block

language	json

{
   "order_number": 1236434,
   "status": "Processing",
   "items":[
 [     {
         "part_number": "000094",
         "quantity": 4,
         "price": 25.67,
         "fet":18.04,
         "brand": "Bridgestone"
      }
   ],
   "delivery_info":{
      "shipping_cost": 13.5789.41,
      "delivery_date":"2024–01–01T10:12:29-03:00"
   },
   "error": null
}

Get order status

Request structure

order_number

Request example

Code Block

language	json

{
  "order_number": 1236434
}

...

Response example

Code Block

language	json

{
  "order_number": 1236434,
  "status": "Received",
  "error": null
}

...

Get delivery options

Request structure

locationbranch_id
brand
part_number
quantity

Request example

Code Block

language	json

{
  "brand": "Bridgestone",
  "part_number": "000009",
  "locationbranch_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 locationbranch
delivery_date - estimated delivery date
cutoff - delivery cutoff time

Response example

Code Block

language	json

{
   "delivery_options":[
 [     {
         "name": "UPS",
     “id”:     "id":1,
         "shipping_cost": 89.41,
         "delivery_date":"2024–12–01T15:00:00-03:00",
     "2023–01–01T10:12:29    "cutoff":"2024–12–01T10:00:00-03:00"
      },
      {
         "name": "FedEx",
        “id” "id": 2,
         "shipping_cost": 122.41,
         "delivery_date":"2024–12–01T15:00:00-03:00",
   "2022–01–02T10:12:29      "cutoff":"2024–12–01T10:00:00-03:00"
      },
      {
         "name": "Our Truck",
  “id”:        "id":3,
         "shipping_cost": 52.41,
         "delivery_date":"2024–12–01T15:00:00-03:00",
  "2022–01–03T10:12:29       "cutoff":"2024–12–01T10:00:00-03:00"
      },
      {
         "name": "PickUp",
     “id”:     "id":4,
         "shipping_cost": 0,
         "delivery_date":"2024–12–01T15: "2022–01–04T10:12:2900:00-03:00",
         "cutoff":"2024–12–01T10:00:00-03:00"
      }
   ]
}

Versions Compared

Old Version 13

New Version Current

Key

Search by size

Request structure

Request example with width, height & rim

Request example with size

Response structure

Response example

Search by part numbers

Request structure

Request example

Response structure (identical to search by size response)

Response example

Additional Methods

Get List of Dealer’s

Branches

Request structure

Response structure

Response example

Submit an order

Request structure

Request example

Response example

Get order status

Request structure

Request example

Response example

Get delivery options

Request structure

Request example

Response structure

Response example

Page Comparison

Versions Compared

Old Version 13

New Version Current

Key

Search by size

Request structure

Request example with width, height & rim

Request example with size

Response structure

Response example

Search by part numbers

Request structure

Request example

Response structure (identical to search by size response)

Response example

Additional Methods

Get List of Dealer’s

Branches

Request structure

Response structure

Response example

Submit an order

Request structure

Request example

Response example

Get order status

Request structure

Request example

Response example

Get delivery options

Request structure

Request example

Response structure

Response example