Table of Contents


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

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?aces_id=152826&location_id=4250

Tire Size

Format

https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?width={WIDTH}&height={HEIGHT}&rim={RIM}&location_id={LOCATION ID}

Example

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?width=205&height=55&rim=16&location_id=4250

RAW Size

Format

https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?size={RAW_SIZE}&location_id={LOCATION ID}

Example

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?size=2055516&location_id=4250

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:

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?part_numbers=000240,011969&location_id=4250

VIN

Format

https://app.tireconnect.ca/pos/{DEALER API KEY}#/!search?vin={VIN}&location_id={LOCATION ID}

Example

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?vin=4S3BNEN6XH3058857&location_id=4250


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

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?state=SD&license=12345&location_id=4250

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:

  1. DIV with this id is detected, you can extract the content of the quote from the JSON formatted quote summary.

  2. ready=1 - READY URL parameter is equal 1

URL Example

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!summary?location_id=4250&tire_id=QnJpZGdlc3RvbmV8fDExNjgzM3x8TEktT0tUfHw0MjUwfHxC&quantity=1&ready=1

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:

  1. DIV with this id is detected, you can extract the content of the quote from the JSON formatted quote summary.

  2. supplier_order_submitted=1 - READY URL parameter is equal 1

URL Examples (PIN for both 555555)

Results page:

https://devapp.tireconnect.ca/pos/05198c64d142efd851ef15e54fdd917d#/!results?size=2055516&location_id=12674&order_by=best_match&display=full&page=1

Summary page:

https://devapp.tireconnect.ca/pos/05198c64d142efd851ef15e54fdd917d#/!summary?location_id=12674&optional_services=use_default&quantities%5B0%5D=4&tire_ids%5B0%5D=VGh1bmRlcmVyfHxUSDAwOTB8fEtNfHwxMjY3NHx8Qg%3D%3D

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"
  }
}