Table of Contents
Configuration
v2 - Latest API version
v1 - Deprecated API version
Usage
TireConnect Search From Access
Tire Search
ACES vehicle ID
Tire Size
RAW size
Manufacturer part number
Several part numbers
VIN
License plate and State
Quote summary for parsing
Supplier order summary for parsing
Configuration
Demo Credentials
API KEY:
88b97fa1ecb79698ecd2b59aceb655ef
LOCATION ID:
4250
Location Selection
This API method will allow you look up all the locations which are accessible with this API key.
We recommend providing the user with a menu to select their store. When store is selected, its ID should be stored and used during TireConnect invocation.
V2 - Latest API version
Request:
https://wl.tireconnect.ca/api/v2/location/list?key={DEALER API KEY}
Response format:
{
"notice":"Success",
"data":{
"locations":[
{
"id":xxxx,
"name":"STORE NAME",
"dealer_id":xxx,
"external_id":"",
"address_line_1":"dealer@dealer.com",
"address_line_2":"",
"city":"CITY",
"country":"COUNTRY",
"country_code":"xx",
"province":"STATE / PROVINCE",
"postal_code":"ZIP / POSTAL CODE",
"phone":"xxx xxx xxxx",
"latitude":xxx",
”logo”:”xxx”,
longitude":xxx
}
]
}
}
|
Example:
{
"notice":"Success",
"data":{
"locations":[
{
"id":4250,
"name":"Location #1",
"dealer_id":3758,
"external_id":null,
"address_line_1":"3903 SE 10th Pl",
"address_line_2":"",
"city":"Del City",
"country":"United States",
"country_code":"US",
"province":"Oklahoma",
"postal_code":"73115",
"phone":"416 895 8685",
"latitude":35.4553,
”logo”:”https:\/\/wl.tireconnect.ca\/uploads\/dealer\/cf19ecb54145f78585b33149e042e684a08c2865.png”,
"longitude":-97.45
}
]
}
}
|
V1 - Deprecated API version
Request:
https://wl.tireconnect.ca/api/v1/location/list?key={DEALER API KEY}
Response format:
{
"notice":"Success",
"data":{
"locations":[
{
"id":xxxx,
"name":"STORE NAME",
"dealer_id":xxx,
"external_id":"",
"address_line_1":"dealer@dealer.com",
"address_line_2":"",
"city":"CITY",
"country":"COUNTRY",
"country_code":"xx",
"province":"STATE / PROVINCE",
"postal_code":"ZIP / POSTAL CODE",
"phone":"xxx xxx xxxx",
"latitude": xxx"longitude":xxx
}
]
}
}
|
Example:
{
"notice":"Success",
"data":{
"locations":[
{
"id":4250,
"name":"Location #1",
"dealer_id":3758,
"external_id":null,
"address_line_1":"3903 SE 10th Pl",
"address_line_2":"",
"city":"Del City",
"country":"United States",
"country_code":"US",
"province":"Oklahoma",
"postal_code":"73115",
"phone":"416 895 8685",
"latitude":35.4553,
"longitude":-97.45
}
]
}
}
|
Usage
TireConnect Search Form Access
TC can be opened using the dealer specific URL.
URL:
https://app.tireconnect.ca/pos/{DEALER API KEY}f#/!search?location_id={LOCATION ID}
Example:
https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?location_id=4250
Tire Search
ACES Vehicle ID
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?aces_id={ACES ID}&location_id={LOCATION ID}
Example
Tire Size
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?width={WIDTH}&height={HEIGHT}&rim={RIM}&location_id={LOCATION ID}
Example
RAW Size
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?size={RAW_SIZE}&location_id={LOCATION ID}
Example
Manufacturer Part Number
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?part_numbers={PART NUMBER}&location_id={LOCATION ID}
* Note: method accept several part numbers comma separated.
Example
Single part number: https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?part_numbers=148895&location_id=4250
Several part numbers:
VIN
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?vin={VIN}&location_id={LOCATION ID}
Example
Licence Plate and State (USA only)
Format
https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?state={State}&license={LICENSE PLATE}&location_id={LOCATION ID}
Example
Quote summary for parsing
JSON quote summary is generated in hidden DIV with id “tcwlw_raw_quote” on the summary page.
Quote data extraction:
There are two conditions required for successful quote data extraction:
DIV with this id is detected, you can extract the content of the quote from the JSON formatted quote summary.
ready=1 - READY URL parameter is equal 1
URL Example
JSON Example
{
"tires": [
{
"brand": "Bridgestone",
"model": "Turanza EL42",
"part_number": "116833",
"price": 370.99,
"tax": 16.69,
"quantity": 10,
"image": "https://wl.tireconnect.ca/uploads/tires/pre_up/Bridgestone/images/bs_turanza_el42_l.jpg",
"supplier": "LI-OKT",
"speed_rating": "H",
"load_index": 91,
"size": "205/55R16 91H",
"size_w": 205,
"size_h": 55,
"size_r": 16,
"selected_quantity": 1,
"cost": 123.99
}
],
"services": [
{
"key": "installation",
"name": "Install + Balance"
}
]
}
</div>
|
Supplier order summary for parsing
JSON quote summary is generated in hidden DIV with id “tcwlw_pos_supplier_order_submitted” on results or summary page.
Quote data extraction:
There are two conditions required for successful quote data extraction:
DIV with this id is detected, you can extract the content of the quote from the JSON formatted quote summary.
supplier_order_submitted=1 - READY URL parameter is equal 1
URL Examples (PIN for both 555555)
Results page:
Summary page:
JSON Example
{
"branches_status": [
{
"branch_name": "common",
"status": "success",
"invoice": "999999999"
}
],
"order_info": {
"cost": 43,
"quantity": 1,
"total_cost": 43,
"shipping_cost": null,
"total_order": 43
},
"supplier_order_fields": {
"delivery_method": "Deliver",
"po_number": "Test PO"
},
"supplier": {
"name": "KM",
"nice_name": "K&M"
},
"tire": {
"brand": "Thunderer",
"model": "Mach II R301",
"part_number": "TH0090",
"size_h": 55,
"size_r": 16,
"size_w": 205,
"size": "205/55R16 91V",
"image": "https://dev.tireconnect.ca/uploads/tires/pre_up/Thunderer/images/th_mach_ii_r301_l.jpg",
"category": "Performance",
"season": "All Season"
}
}
|