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. branches[] (branch ids) - several IDs can be transferred

  2. min_quantity

...

  • 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.primary - mark of primary branch for customer. Can be just true/false in case it’s only primary & other. In case there is an option for customer to have primary, alternative 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
languagejson
[
   {
      "part_number":"000094",
      "brand":"Bridgestone",
      "retail_price":25.5,
      "cost":20,
      "fet":18.4,
      "delivery_optionsbranches":{[
          "shipping_cost":89.41,{
            "delivery_datename":"2024–12–01T15:00:0-03:00Branch 1",
            "cutoffid":"2024–12–01T10:00:00-03:00"
1,
     },       "Branchesquantity":[4,
             {"type": "primary",
            "namedelivery_options":"Branch 1",{
                "idshipping_cost":189.41,
            "quantity":4,             "primary": true, //in case it's only primary & other"delivery_date":"2024–12–01T15:00:0-03:00",
                "typecutoff": "primary", //in case 3 options available"2024–12–01T10:00:00-03:00"
            }
    "delivery_options":{     },
         {
 "shipping_cost":89.41,
                "delivery_date"name":"2024–12–01T15:00:0-03:00",
   Branch 2",
            "cutoffid":"2024–12–01T10:00:00-03:00"2,
            }"quantity":4,
         },   "type": "alternative",
     {       "delivery_options":{
     "name":"Branch 2",
            "idshipping_cost":289.41,

           "quantity":4,     "delivery_date":"2024–12–01T15:00:0-03:00",
       "primary": false, //in case it's only primary & other
 "cutoff":"2024–12–01T10:00:00-03:00"
           "type": "alternative", //in case 3 options available },
            {
     "delivery_options":{       "name":"Branch 3",
            "shipping_costid":89.41,
   3,
            "delivery_datequantity":"2024–12–01T15:00:0-03:00",
  4,
             "cutofftype":"2024–12–01T10:00:00-03:00" "other",
            },"delivery_options":{
                "shipping_cost":89.41,
   {             "namedelivery_date":"Branch 32024–12–01T15:00:0-03:00",
            "id":3,    "cutoff":"2024–12–01T10:00:00-03:00"
            }
 "quantity":4,        }
    "primary": false, //in]
case it's only primary & other
            "type": "other", //in case 3 options available}
]

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

Code Block
languagejson
{
   "part_numbers":[
      "000094"
   ],
   "delivery_optionsbranches":{[
      1,
      2,
    "shipping_cost":89.41,  3
         ],
    "deliverymin_datequantity":"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

Code Block
languagejson
{
   "part_numbers":[
      "000094"
   ],
   "branches":[
      1,
      2,
      3
   ],
   "min_quantity":1
}

Response structure (identical to search by size response)

 List of tires

...

brand

...

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.primary - mark of primary branch for customer. Can be just true/false in case it’s only primary & other. 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

 Response example

...

languagejson

...

  • , 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
languagejson
[
   {
         "shipping_cost":89.41,
         "delivery_date":"2024–12–01T15:00:0-03:00",
  "part_number":"000094",
      "cutoffbrand":"2024–12–01T10:00:00-03:00"Bridgestone",
      }"retail_price":25.5,
      "branchescost":[20,
      "fet":18.4,
  {    "branches":[
        "name":"Branch 1", {
            "idname":"Branch 1",
            "quantityid":41,
            "primaryquantity": true, //in case it's only primary & other
   4,
             "type": "primary",
//in case 3 options available             "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", {
            "idname":"Branch 2",
            "quantityid":42,
            "primaryquantity": false4,
//in case it's only primary & other             "type": "alternative",
//in case 3 options available
            "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":33",
            "quantityid":43,
            "primaryquantity": false, //in case it's only primary & other4,
                "type": "other",
//in case 3 options available             "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

...

  1. authentication credentials (whichever are applicable) 

  2. Branch ID (optional, required only if sister stores are available)branches.primary (optional) mark of primary branch for customer. Can be just true/false in case it’s only primary & other.

  3. 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 branches []

...

Code Block
languagejson
{
   "branches":[
      {
         "name":"Branch 1",
         "id":1,
         "primary": true, //in case it's only primary & other "id":1,
         "type": "primary",
//in case 3 options available
      },
      {
         "name":"Branch 2",
         "id":2,
         "primary": false, //in case it's only primary & other:2,
          "type": "alternative", //in case 3 options available
      },
      {
         "name":"Branch 3",
         "id":3,
         "primary": false, //in case it's only primary & other
         "type": "other", //in case 3 options available
      }
   ]
}

Submit an order

Request structure

...