Wheels Service (iConfigurator)
- Oleksandr Samarin
Table of Contents
When Using TireConnect Turnkey Solution (widget)
URL to use
%base_url%/wheel_service
* base_url - link to website with TC widget.
Vehicle info
aces_id - in case aces id present
base_aces_id - in case aces_id not present and we have only base_aces_id
season - tire's season (optional param) with such values:
- all_tires = All tires (season_id=all)
- winter = Winter (season_id=4)
- all_season = All season (season_id=2)
- summer = Summer (season_id=3)
- all_weather = All Weather (season_id=1)
All variables except aces_id, base_aces_id & season should be array with one of array indexes:
b - both tires\wheels
f - front tire\wheel
r - rear tire\wheel
I.e. tire_width[b] - width parameter for both front and rear recommended tires
Wheel\Tire info
Preferred
tire_width[] - width parameter of recommended tire for wheel
tire_heihgt[] - height parameter of recommended tire for wheel
tire_rim[] - rim parameter of recommended tire for wheel
I.e. tire_width[b]=205
Possible
tire_size[] - recommended tire size for wheel
I.e. tire_size[b]=2055516
wheel_brand[] - Wheel manufacturer brand name
wheel_product_name[] - Wheel model/line name
wheel_image[] - A URL for product image.
wheel_part_number[] - All Standard or Staggered Front/Rear Wheel Part Number
wheel_desc[] - short description of front or rear or all wheel specs. EX(Size:20X10 BP:120.65 ET:35 Bore:72.6 LIP:0).
wheel_quantity[] - All Standard or Staggered Front/Rear Wheel Part Number Quantity
wheel_price[] - All Standard or Staggered Front/Rear Wheel Part Number Price Each or All. In case 0 or empty value provided we're using Call for pricing label. Also text values could be provided and they will be shown on summary page instead of price. You can use maximum 22 characters.
wheel_link[] - Link to wheel info(By default will be displayed with “Learn More” label) (new)
wheel_link_label[] - custom label for link to wheel (new)
URL examples
Standard Fitment
Example uses same wheels will be used for both front and rear with aces_id provided
Example uses same wheels will be used for both front and rear with base_aces_id provided
Example uses same wheels will be used for both front and rear with base_aces_id provided & tire season filtered to show only summer tires
Example using standard zero_label "Call for pricing" in case wheel_price[]=0
Example using standard zero_label "Call for pricing" in case wheel_price[]=
Example using non-standard zero_label "No price available" in case wheel_price[]=No price available
Staggered Fitment
Example uses different wheels will be used for front and rear with aces_id provided
https://www.tireconnect.ca/ecommerce-product/#!wheel_service?aces_id=13&tire_width[f]=205&tire_height[f]=55&tire_rim[f]=16&wheel_brand[f]=Momo&wheel_product_name[f]=Revenge&wheel_image[f]=https://www.momo.com/wp-content/uploads/2017/01/momo-revenge-road-wheels-c.png&wheel_part_number[f]=rv80752035a&wheel_desc[f]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[f]=2&wheel_price[f]=750&wheel_link[f]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[f]=Edit%20Wheel&tire_width[r]=215&tire_height[r]=45&tire_rim[r]=17&wheel_brand[r]=OZ%20RACING&wheel_product_name[r]=ULTRALEGGERA%20HLT%20SATIN%20BLACK&wheel_image[r]=https://www.ozracing.com/images/products/wheels/ultraleggera-hlt/matt-black/01_ultraleggera-hlt-matt-black-jpg%201000x750.jpg&wheel_part_number[r]=123456789&wheel_desc[r]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[r]=2&wheel_price[r]=500&wheel_link[r]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[r]=Edit%20Wheel
Example uses different wheels will be used for front and rear with base_aces_id provided
https://www.tireconnect.ca/ecommerce-product/#!wheel_service?base_aces_id=1&tire_width[f]=205&tire_height[f]=55&tire_rim[f]=16&wheel_brand[f]=Momo&wheel_product_name[f]=Revenge&wheel_image[f]=https://www.momo.com/wp-content/uploads/2017/01/momo-revenge-road-wheels-c.png&wheel_part_number[f]=rv80752035a&wheel_desc[f]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[f]=2&wheel_price[f]=750&wheel_link[f]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[f]=Edit%20Wheel&tire_width[r]=215&tire_height[r]=45&tire_rim[r]=17&wheel_brand[r]=OZ%20RACING&wheel_product_name[r]=ULTRALEGGERA%20HLT%20SATIN%20BLACK&wheel_image[r]=https://www.ozracing.com/images/products/wheels/ultraleggera-hlt/matt-black/01_ultraleggera-hlt-matt-black-jpg%201000x750.jpg&wheel_part_number[r]=123456789&wheel_desc[r]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[r]=2&wheel_price[r]=500&wheel_link[r]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[r]=Edit%20Wheel
Example uses different wheels will be used for front and rear with aces_id provided & tire season filtered to show only performance tires
Example using standard zero_label "Call for pricing" in case wheel_price[]=0(or wheel_price[]=)
https://www.tireconnect.ca/ecommerce-product/#!wheel_service?aces_id=13&tire_width[f]=205&tire_height[f]=55&tire_rim[f]=16&wheel_brand[f]=Momo&wheel_product_name[f]=Revenge&wheel_image[f]=https://www.momo.com/wp-content/uploads/2017/01/momo-revenge-road-wheels-c.png&wheel_part_number[f]=rv80752035a&wheel_desc[f]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[f]=2&wheel_price[f]=&wheel_link[f]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[f]=Edit%20Wheel&tire_width[r]=215&tire_height[r]=45&tire_rim[r]=17&wheel_brand[r]=OZ%20RACING&wheel_product_name[r]=ULTRALEGGERA%20HLT%20SATIN%20BLACK&wheel_image[r]=https://www.ozracing.com/images/products/wheels/ultraleggera-hlt/matt-black/01_ultraleggera-hlt-matt-black-jpg%201000x750.jpg&wheel_part_number[r]=123456789&wheel_desc[r]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[r]=2&wheel_price[r]=&wheel_link[r]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[r]=Edit%20Wheel
Example using non-standard zero_label "No price available" in case wheel_price[]=No price available
https://www.tireconnect.ca/ecommerce-product/#!wheel_service?aces_id=13&tire_width[f]=205&tire_height[f]=55&tire_rim[f]=16&wheel_brand[f]=Momo&wheel_product_name[f]=Revenge&wheel_image[f]=https://www.momo.com/wp-content/uploads/2017/01/momo-revenge-road-wheels-c.png&wheel_part_number[f]=rv80752035a&wheel_desc[f]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[f]=2&wheel_price[f]=No price available&wheel_link[f]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[f]=Edit%20Wheel&tire_width[r]=215&tire_height[r]=45&tire_rim[r]=17&wheel_brand[r]=OZ%20RACING&wheel_product_name[r]=ULTRALEGGERA%20HLT%20SATIN%20BLACK&wheel_image[r]=https://www.ozracing.com/images/products/wheels/ultraleggera-hlt/matt-black/01_ultraleggera-hlt-matt-black-jpg%201000x750.jpg&wheel_part_number[r]=123456789&wheel_desc[r]=Size%3A20X10+BP%3A120.65+ET%3A35+Bore%3A72.6+LIP%3A0&wheel_quantity[r]=2&wheel_price[r]=No price available&wheel_link[r]=https://www.tireconnect.ca/icon-media-demo/#/year%3D2017%26make%3DINFINITI%26model%3DQ70%26submodel%3D5.6%26size%3D19%20Inch%20Wheels%26brand%3DForgiato%26page%3D1%26wheel%3DVECCIO%20Orange/Black%20Center,%20Chrome%20Lip&wheel_link_label[r]=Edit%20Wheel
When Using TireConnect API
Step 1 - Parsing the URL parameters
The URL will need to be passed based on the structure described above. Elements of the wheel service extracted in order to be used in Step 2.
Step 2 - Creating and using the custom service/product for wheels
Step 2.1
Create a custom services using Services - Create method of the API. Remember service_key of newly created service.
Api.serviceCreate({
name: props.wheel_brand.b + ' ' + props.wheel_product_name.b,
description: 'Part number: ' + props.wheel_part_number.b + '\nDescription: ' + props.wheel_desc.b + '\nQuantity: ' + props.wheel_quantity.b,
tax_rate_type: 2, //product tax rate
rate: props.wheel_price.b * props.wheel_quantity.b,
is_per_tire: false
}).then(function (service_key) {
// load image with delay
if (!!props.wheel_image && !!props.wheel_image.b) {
Api.serviceUpdate(service_key, {
image: props.wheel_image.b
});
}
})
Notes:
- Api object is a JS wrapper for TireConnect API methods. In this case following methods are utilized:
- https://docs.tireconnect.ca/v2/#api-Services-PostServiceCreate
- https://docs.tireconnect.ca/v2/#api-Services-PostServiceUpdate
- In this example we are using props object previously filled by parameters from URL parsing in Step 1.
- Please note, in this example we using update method with an image asynchronously, however this is not a requirement.
Step 2.2
Provide the service key via optional custom_services[] parameter to Orders - Create method or any of Quote methods. Please be aware custom_services should be an array, so you can provide several custom service keys.