VIN Change

The VIN_CHANGE_EVENT is used to notify when there is a change in the Vehicle Identification Number (VIN)

Event Name: VIN_CHANGE_EVENT

Trigger Condition

Subscription to the VIN_CHANGE_EVENT is mandatory.
The event is triggered at the start of a trip if a change in the vehicle’s VIN is detected.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "VIN_CHANGE_EVENT",
"deviceId": "3f14843e-14c7-11ed-9449-43d7d49f480d",
"networkService": 0,
"commStateConnected": 0,
"messageType": "VIN_CHANGE_EVENT",
"messageIndex": "10389",
"dimentionFix": 0,
"lastKnownLon": 77.611127,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c00dcb4-7600-43c5-afbe-80c6114d8dff",
"state": null,
"inputBit1": 0,
"newVIN": "3GYFK66N23G229527",
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "3339076777",
"groupName": "Default Group",
"lastKnownTime": 1662630762000,
"jmsType": "",
"vehicleName": "3339076777",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": 17.691376,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 15047,
"beaconMacAddress": null,
"tripNumber": 33,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": "8a938091-8268-7d94-0182-6e50994400ba",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": "3GYFK66N23G229527",
"beaconType": null,
"groupId": "559d6f4c-11bf-11ed-8895-27b5feb885d3",
"vendorTypeId": 1,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": 77.611127,
"satellites": null,
"locationTime": 1662630762000,
"odometer": 9213,
"offset": 360,
"virtualTripEnd": false,
"imei_meid": "3907677739076777",
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 17.691376,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": null,
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "3f14843d-14c7-11ed-9449-2f5611afcf3f",
"lastKnownFixQuality": 0,
"userName": "3339076777",
"tripState": "IDLING",
"messageTypeId": 17,
"obdSpeed": null,
"location": {
"latitude": 17.691376,
"longitude": 77.611127
},
"commonState": 0,
"carrierId": null,
"oldVIN": "19VDE1F70FE010629"
}

Reference

Field

Description

type
String

Type of event.
Example: "VIN_CHANGE_EVENT"

messageType
String

Type of message.
Example: "VIN_CHANGE_EVENT"

id
String,UUID

Unique event ID.
Example: "1c00dcb4-7600-43c5-afbe-80c6114d8dff"

deviceId
String,UUID

Unique ID of the tracking device.
Example: "3f14843e-14c7-11ed-9449-43d7d49f480d"

deviceSerial
String

Serial number of the device.
Example: "3339076777"

imei_meid
String

IMEI or MEID of the device.
Example: "3907677739076777"

deviceTypeId
Integer

Type ID of the device.
Example: 1

vendorTypeId
Integer

ID of the Vendor Type Example: 1

userId
String,UUID

Unique ID of the user who triggered the VIN change.
Example: "8a938091-8268-7d94-0182-6e50994400ba"

userName
String

Name of the user
Example: "3339076777"

vehicleId
String,UUID

Unique identifier for the vehicle.
Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f"

vehicleName
String

Vehicle name.
Example: "3339076777"

groupId
String,UUID

Unique identifier of the the group.
Example: "559d6f4c-11bf-11ed-8895-27b5feb885d3"

groupName
String

Name of the group.
Example: "Default Group"

customerId
Integer

The unique Azuga ID of the customer.
Example: 15047

newVIN
String

Updated Vehicle Identification Number.
Example: "3GYFK66N23G229527"

oldVIN
String

Previous Vehicle Identification Number.
Example: "19VDE1F70FE010629"

deviceAssociatedVIN
String

VIN currently associated with the device.
Example: "3GYFK66N23G229527"

messageIndex
String

Message sequence number.
Example: "10389"

tripNumber
Integer

Represents a unique ID assigned to a specific trip, allowing the system to track and reference that particular journey or route.
Example: 33

tripState
String

Trip status at the time of VIN change.
Example: "IDLING"

location
Location { latitude: 34.12 longitude: -82.14 }

Current location object of the vehicle

latitude
Double

Latitude co-ordinate value in degrees Example: 34.12

longitude
Double

Longitude co-ordinate value in degrees Example: -82.34

lastKnownLat
Double

Last known latitude in degrees.
Example: 17.691376

lastKnownLon
Double

Last known longitude in degrees.
Example: 77.611127

lastKnownTime
Long

Last known time in milliseconds
Example: 1662630762000

locationTime
Long

Timestamp of location data in milliseconds.
Example: 1662630762000

odometer
Integer

Odometer reading at the time in kilometers.
Example: 9213

insideHOO
Boolean

Indicates if the vehicle was inside Hours of Operation.
Example: true

virtualTripEnd
Boolean

Indicates whether the trip ended virtually.
Example: false