Customer Vehicles library

The Customer Vehicles library is an implementation of the vehicles domain within the Jifeline Customer API. With this library, after setting the config in the @jifeline/core auth module, the vehicle can be defined for which products can be requested.

Usage of the library

Import the customerVehicles library to make use of the different features.

import { auth, i18n, Locale } from '@jifeline/core';
import { customerVehicles } from '@jifeline/customer-vehicles';

// Configure the core lib and authenticate by login in with connector / pin or username & password.
auth.configure(config);
auth.loginPin().subscribe();
auth.loginUsername().subscribe();

// After authentication - use the customer vehicles library. Eg;
customerVehicles
  .makes
  .getAllVehicleMakes()
  .subscribe(vehicleMakes => console.log(vehicleMakes));

Features

The Customer Vehicles library provides the following features:

• define vehicle
• vehicle definition
• vehicle history
• vehicle makes
• vehicle model groups
• vehicle models
• vehicle model variants
• vehicle names
• vin

Define vehicle

The define vehicle feature can be used to define a vehicle definition. A vehicle definition is a specification of a vehicle based on make, model group, model, and a model variant.

The following functions are supported:

• define vehicle type
• get base vehicle element from type
• is vehicle defined
• get vehicle to define
• get definition of vehicle
• clear defined vehicle element
• get next vehicle element type to define
• is type defined

Vehicle Definition

The vehicle definition feature can be used to resolve a vehicle definition based on a VIN, or a vehicle element ID, which can be the model ID or model variant ID.

The following functions are supported:

• get vehicle definition by element id
• get vehicle definition by vin

Vehicle History

The vehicle history feature can be used to get the history of when tickets are created for a given vehicle.

The following functions are supported:

• get vehicle history
• get all vehicle history

Vehicle makes

The vehicle makes feature can provide a list of all vehicle makes.

The following functions are supported:

• get all vehicle makes

Vehicle model groups

The vehicle model groups feature can provide a list of all vehicle model groups of a given vehicle make.

The following functions are supported:

• get all vehicle model groups

Vehicle models

The vehicle models feature can provide a list of all vehicle models of a given vehicle model group. It can also get the definition of a vehicle model based on the vehicle model ID.

The following functions are supported:

• get all vehicle models
• get vehicle model

Vehicle model variants

The vehicle model variants feature can provide a list of all vehicle model variants of a given vehicle model. It can also get the definition of a vehicle model variant based on the vehicle model variant ID.

The following functions are supported:

• get all vehicle model variants
• get vehicle model variant

Vehicle names

The vehicle names feature can create names for a Vehicle, vehicle definition, or the name of a vehicle element. It can also create labels for the manufactured dates of a vehicle.

The following functions are supported:

• get name of vehicle
• get vehicle name by vehicle definition
• get vehicle name by element id
• get manufactured label by vehicle element
• get manufactured label

VIN

The VIN feature can validate a given VIN. In order to be valid, it must comply to the following rules:

• Required
• Minimum characters required
• Maximum characters exceeded
• O character is not allowed
• I character is not allowed
• Q character is not allowed
• Last characters should be numeric
• VIN should be alphanumeric
• VIN is not supported

The following functions are supported:

• validate vin