Versions Compared

Key

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

...

  • 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

...

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}

...

V1 - Deprecated API version

...

Request:

https://wl.tireconnect.ca/api/v1/location/list?key={DEALER API KEY}

...

Code Block
{  
   "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:

Code Block
{  
   "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.

...

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}

...

https://app.tireconnect.ca/pos/88b97fa1ecb79698ecd2b59aceb655ef#/!search?aces_id=268647&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}

...

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}

...

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}

...

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}

...

Quote summary for parsing

...

JSON quote summary is generated in hidden DIV with  with id “tcwlw_raw_quote” on the summary page.

...

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

JSON Example


Code Block
{
  "tires": [
    {
      "id": "TWlsZXN0YXJ8fDI0NDYwMDIxfHxjb21tdW5pdHl3aG9sZXNhbGV0aXJlfHwyMjU5Mnx8Qg==",
      "brand": "BridgestoneMilestar",
      "model": "TuranzaMS932 EL42Sport",
      "part_number": "11683324460021",
      "price": 37059.9996,
      "tax": 162.694,
      "quantity": 10153,
      "image": "https://wl.tireconnect.ca/uploads/tires/pre_up/1/BridgestoneMilestar/images/bsms_turanza_el42ms932_l.jpg",
      "supplier": "LI-OKTcommunitywholesaletire",
      "speed_rating": "HV",
      "load_index": 91,
      "size": "205/55R16 91H91V",
      "size_w": 205,
      "size_h": 55,
      "size_r": 16,
      "selected_quantity": 14,
      "cost": 12341.9997
    }
  ],
  "services": [
    {
      "key": "installationtire_protection_plan",
      "name": "InstallTire +Protection BalancePlan",
      }"total_price": 10,
  ] } </div>

...

  "total_tax": 0.4
    },
    {
      "key": "wheel_alignment",
      "name": "Wheel Alignment",
      "total_price": 23.98,
      "total_tax": 0.96
    },
    {
      "key": "nitrogen_fill",
      "name": "Nitrogen Fill",
      "total_price": 100,
      "total_tax": 4
    },
    {
      "key": "disposal_fee",
      "name": "Tire Recycling Fee",
      "total_price": 10,
      "total_tax": 0
    },
    {
      "key": "supply_fee",
      "name": "Shop Supply Fee",
      "total_price": 50,
      "total_tax": 0
    },
    {
      "key": "seasonal_tire_storage",
      "name": "Seasonal Tire Storage",
      "total_price": 24,
      "total_tax": 0.96
    },
    {
      "key": "valve_stem_tpms",
      "name": "Valve Stem or TPMS Part Kit",
      "total_price": 100,
      "total_tax": 4
    }
  ],
  "vehicle": {
    "year": "2020",
    "make": "Alfa Romeo",
    "model": "4C",
    "trim": "Spider",
    "car_tire_id": "163508||163509"
  }
}


Supplier order summary for parsing

...

JSON quote summary is generated in hidden DIV DIV  with id “tcwlw_pos_supplier_order_submitted” on results or summary page.

...

Code Block
{
  "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,
    "partsize_numberw": "TH0090"205,
    "size_h": 55 "205/55R16 91V",
    "size_rimage": 16"https://dev.tireconnect.ca/uploads/tires/pre_up/Thunderer/images/th_mach_ii_r301_l.jpg",
    "size_wcategory": 205"Performance",
    "sizeseason": "All "205/55R16 91V",
    "image": "https://devSeason"
  }
}

Option 2 - By listening to widget events

This method can be used both with direct embedding of the TC module on the page, as well as an iframe based integration. The difference would be that when iframe is used, a container page needs to be created. This page will actually contain the  widget and the event listener. The event listener function will need to pass the data captured in the event to the parent page.

Documentation

TC Widget Callback

Example

https://tutorials.tireconnect.ca/

...

pos_demo/pos_container.html