Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Search by size

 Request structure

 Required

  1. width 

  2. profile

  3. rim

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

Optional

  1. locations[] (locations ids) - several IDs can be transferred

  2. min_quantity

 Request example with width, height & rim

Code Block
{
   "width": 205,
   "profile": 55,
   "rim": 16,
   "locations":[
      1,
      2
   ],
   "min_quantity":1
}

Request example with size

Code Block
{
   "size":"2055516",
   "locations":[
      1,
      2
   ],
   "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 1

    • location 2

  • cost

  • retail_price (if applicable)

  • fet (The Federal Excise Tax (if applicable))

Optional

  • shipping_cost - estimated shipping cost

  • delivery_date - estimated delivery date

  • cutoff - delivery cutoff time

 Response example

Code Block
languagejson
[
   {
      "part_number": "000094",
      "brand": "Bridgestone",
      "retail_price": 25.5,
      "cost": 20,
      "fet": 18.4,
      "locationsdelivery_options":{
[         "shipping_cost":89.41,
     {       "delivery_date":"2024–01–01T10:12:29-03:00",
         "namecutoff": "Location 1","11:00"
      },
      "locations":[
   “id”: 1,     {
            "quantityname":"Location 41",
              }"id":1,
            "quantity":4
 {         },
       "name": "Location 2",{
                “id”:"name":"Location 2",

               "quantityid": 42,
            "quantity":4
 }        }
      ]
   }
]

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

 Request example

Code Block
{
   "part_numbers":[
 [     "000094"
   ],
   "locations":[
      [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 1

    • location 2

  • cost

  • retail_price (if applicable)

  • fet (The Federal Excise Tax (if applicable))

Optional

  • shipping_cost - estimated shipping cost

  • delivery_date - estimated delivery date

  • cutoff - delivery cutoff time

 Response example

Code Block
languagejson
[
   {
      "part_number": "000094",
      "brand": "Bridgestone",
      "retail_price": 25.5,
      "cost": 20,
      "fet": 18.4,
      "locationsdelivery_options":{
[         "shipping_cost":89.41,
     {    "delivery_date":"2024–01–01T10:12:29-03:00",
            "name": "Location 1","cutoff":"11:00"
      },
      "locations":[
   “id”: 1,     {
            "quantityname":"Location 41",
              }"id":1,
            "quantity":4
 {        },
        "name": "Location 2", {
                 “id”:"name":"Location 2",
   
            "quantityid":2,
4            "quantity":4
  }       }
      ]
]   }
]

Additional Methods

Get List of Dealer’s Locations

...

Response example

Code Block
languagejson
{
   "locations":[
   [   {
         "name": "Location 1",
       “id”: 1  "id":1
      },
      {
         "name": "Location 2",
         "id":2
   2   }
   ]
}

Submit an order

Request structure

  1. po_number

  2. items (multiple tires can be passed)

    1. part_number

    2. brand

    3. quantity

    4. location (if applicable)

  3. delivery type

  4. delivery instructions

Request example

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

...

  1. order_number (order or invoice number)

  2. status

  3. items

  4. error

  5. shipping_cost (if applicable)

  6. fet (The Federal Excise Tax (if applicable))

  7. shipping_cost - actual shipping cost for provided tire qty from selected location

  8. delivery_date - estimated delivery date

  9. cutoff - delivery cutoff time

Response example

Code Block
{
   "order_number": 1236434,
   "status": "Processing",
   "items":[
 [     {
         "part_number": "000094",
         "quantity": 4,
         "price": 25.67,
         "fet": 18.04,
         "brand": "Bridgestone"
      }
   ],
   "delivery_options":{
      "shipping_cost":89.41,
      "delivery_date":"2024–01–01T10:12:29-03:00",
      "cutoff":"11: 13.57,00"
   },
   "error": null
}

Get order status

Request structure

  1. order_number

Request example

Code Block
{
  "order_number": 1236434
}

...

  1. location_id

  2. brand

  3. part_number

  4. quantity

Request example

Code Block
{
  "brand": "Bridgestone",
  "part_number": "000009",
  "location_id": 1,
  "quantity": 4
}

...

Response example

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