Web Services Requirements Overview (Wheels)

Owned by Oleksandr Samarin
Last updated: May 02, 2024
7 min read

 

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 wheel size or part number(s) and receive matching wheels 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

  1. bolt_pattern (eg 5x114.3) 

  2. diameter

Optional

  1. width (in case it’s present it should be optional in request)

  2. min_quantity - minimum qty that available in stock

 Request example

{ "bolt_pattern":"5x114.3", "diameter":20, "width":10, "min_quantity":1 }

Response structure

 List of wheels

  • 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)

 Response example

[ { "part_number":"123456", "brand":"Wheel Brand", "retail_price":250.5, "cost":200, "branches":[ { "name":"Branch 1", "id":1, "quantity":4, "type":"primary", "delivery_info":{ "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_info":{ "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_info":{ "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

  • min_quantity

 Request example

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

Response structure (identical to search by size response)

 List of wheels

  • 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)

 Response example

 

Optional Methods / Endpoints

Get List of Dealer’s Branches

 Request structure

  1. authentication credentials (whichever are applicable) 

  2. Branch ID (optional, required only if sister stores are available)

Response structure

List of Branches []

Response example

 

Submit an order

Request structure

  1. po_number

  2. items (multiple wheels can be passed)

    1. part_number

    2. brand

    3. quantity

    4. branch (if applicable)

  3. delivery type

  4. delivery instructions

Request example

Response structure

  1. order_number (order or invoice number)

  2. status

  3. items

  4. error

  5. shipping_cost (if applicable)

Response example

Get order status

Request structure

  1. order_number

Request example

Response structure

  1. order_number

  2. status

  3. error

Response example

Get delivery options

Request structure

  1. branch_id

  2. brand

  3. part_number

  4. quantity

Request example

Response structure

  1. name - delivery method name

  2. id - delivery method id

  3. shipping_cost - actual shipping cost for provided tire qty from selected branch

Response example

Â