Section 47: VIN Check

From Nlets Wiki
Jump to: navigation, search

VIN Check Transactions (GVQ/GVR)

This section describes the VIN Check transactions which provide Nlets users with information about a vehicle based on decoding a VIN. The VIN Check transaction leverages the National Highway Transportation Safety Administration service.

VIN Check Specifications

Entry # Char. Explanation
VIN N/A the VIN to be decoded

Top

GJXDM (DEPRECATED)

GJXDM has been deprecated. Please contact Nlets for additional assistance with GJXDM.

Top

NIEM

VIN Check NIEM Specifications

This section provides NIEM format and examples for VIN Check Transactions (GVQ/GVR).

All Nlets NIEM messages must be based on the Nlets NIEM Message Structure and include the standard Nlets XML Header as detailed in Message Structure. The NIEM header and hierarchy of the elements in this section have been omitted to avoid redundancy. The associated schemas and instances should be consulted to determine the correct XPaths of the elements.

Element Dictionary

Transaction types detailed below include: VIN Check Query (GVQ) and VIN Check Response (GVR).

Query Formats

VIN Check query (GVQ)

Inquiry Data (n:NLETSInquiryData)
This element will contain all elements specific to this transaction.

  Vehicle(nc:Vehicle)
  NIEM: A motor-driven conveyance designed to carry its operator, and optionally passengers and cargo, over

land.

    Vehicle Identification (nc:VehicleIdentification)
    NIEM: A unique combination of alphanumeric characters that identifies a specific vehicle.

      Identification ID (nc:IdentificationID)
      NIEM: A value that identifies something.

Response Formats

VIN Check response (GVR)

VIN Check Response (n2-vc:VINCheckResponse)

Vehicle Information (nc:Vehicle)

VIN(nc:VehicleIdentification)

Vehicle Type(nc:ItemCategoryText)

Make(nc:ItemMakeName)

Model(nc:ItemModelName)

Model Year(nc:ItemModelYearDate)

Doors(nc:VehicleDoorQuantity)

Seats(nc:VehicleSeatingQuantity)

Transmission Type(nc:VehicleTransmissionCategoryAbstract)

Axles(nc:VehicleAxleQuantity)

Vehicle Augmentation (n2-vc:VehicleAugmentation)

Adaptive Cruise Control(n2-vc:AdaptiveCruiseControlText)

Adaptive Headlights(n2-vc:AdaptiveHeadlightsText)

Additional Information(n2-vc:AdditionalInformationText)

Additional Restraint System(n2-vc:AdditionalRestraintSystemText)

Air Bag Location Curtain(n2-vc:AirBagLocationCurtainText)

Air Bag Location Front(n2-vc:AirBagLocationFrontText)

Air Bag Location Knee(n2-vc:AirBagLocationKneeText)

Air Bag Location Seat Cushion(n2-vc:AirBagLocationSeatCushionText)

Air Bag Location Side(n2-vc:AirBagLocationSideText)

Anti Lock Brakes(n2-vc:AntiLockBrakeText)

Artemis(n2-vc:ArtemisText)

Auto Emergency Brake(n2-vc:AutoEmergencyBrakeText)

Blind Spot Monitoring(n2-vc:BlindSpotMonitoringText)

Bus Information(n2-vc:BusInformationText)

Cash for Clunkers(n2-vc:CashForClunkersText)

Charger Level(n2-vc:ChargerLevelText)

Charger Power KW(n2-vc:ChargerPowerKWText)

Cooling Category(n2-vc:CoolingCategoryText)

Electrification Level(n2-vc:ElectrificationLevelText)

Electronic Stability Control(n2-vc:ElectronicStabilityControlText)

Entertainment System(n2-vc:EntertainmentSystemText)

EVDriveUnit(n2-vc:EVDriveUnitText)

Forward Collision Warning(n2-vc:ForwardCollisionWarningText)

Fuel Category(n2-vc:FuelCategorySecondaryText)

Fuel Injection(n2-vc:FuelInjectionCategoryText)

GVWR(n2-vc:GrossVehicleWeightRatingText)

Lane Departure Warning(n2-vc:LaneDepartureWarningText)

Lane Keep(n2-vc:LaneKeepText)

Manufacturer Category(n2-vc:ManufacturerCategoryText)

Manufacturer ID(n2-vc:ManufacturerIdentification)

Motorcycle Chassis Category(n2-vc:MotorcycleChassisCategoryText)

Motorcycle Custom Type(n2-vc:MotorcycleCustomCategoryText)

Motorcycle Information(n2-vc:MotorcycleInformationText)

Motorcycle Suspension Type(n2-vc:MotorcycleSuspensionCategoryText)

NCIC Code(n2-vc:NCICCodeText)

Park Assist(n2-vc:ParkAssistText)

Plant City(n2-vc:PlantCityText)

Plant Country(n2-vc:PlantCountryText)

Plant Company(n2-vc:PlantCompanyText)

Plant State(n2-vc:PlantStateText)

Pretensioner(n2-vc:Pretensioner)

Rear Visibility Camera(n2-vc:RearVisibilityCameraText)

Seat Belts(n2-vc:SeatBeltsAllText)

Series 2(n2-vc:SeriesAdditionalText)

Track Width Measure(n2-vc:TrackWidthMeasure)

Trailer Body Type(n2-vc:TrailerBodyCategoryText)

Trailer Connection Type(n2-vc:TrailerConnectionCategoryText)

Traction Control(n2-vc:TractionControlText)

Trailer Information(n2-vc:TrailerInformationText)

Trailer Length(n2-vc:TrailerLengthMeasure)

Trim(n2-vc:TrimAdditionalText)

Axle Configuration(n2-vc:VehicleAxelConfigurationText)

Base Price(n2-vc:VehicleBasePriceText)

Battery Modules(n2-vc:VehicleBatteryModulesText)

Battery Packs(n2-vc:VehicleBatteryPacksText)

Bed Type(n2-vc:VehicleBedCategoryText)

Bed Length(n2-vc:VehicleBedLengthMeasure)

Body Cab Type(n2-vc:VehicleBodyCabCategoryText)

Body Class(n2-vc:VehicleBodyClassText)

Brake System Description(n2-vc:VehicleBrakeSystemDescriptionText)

Brake System(n2-vc:VehicleBrakeSystemText)

Bus Type(n2-vc:VehicleBusCategoryText)

Bus Floor Configuration(n2-vc:VehicleBusFloorConfigurationText)

Bus Length(n2-vc:VehicleBusLength)

Country(n2-vc:VehicleCountryText)

Curb Weight Measure(n2-vc:VehicleCurbWeightMeasure)

Destination Market(n2-vc:VehicleDestinationMarketText)

Drive Type(n2-vc:VehicleDriveCategoryText)

Driver Assist(n2-vc:VehicleDriverAssistText)

Engine Configuration(n2-vc:VehicleEngineConfigurationText)

Equipment Category(n2-vc:VehicleEquipmentCategoryText)

Seat Rows(n2-vc:VehicleSeatRowsText)

Series(n2-vc:VehicleSeriesText)

Steering Location(n2-vc:VehicleSteeringLocationText)

Top Speed(n2-vc:VehicleTopSpeedText)

Transmission Speeds(n2-vc:VehicleTransmissionSpeedsText)

Trim(n2-vc:VehicleTrimText)

Turbo(n2-vc:VehicleTurboText)

Valve Train Design(n2-vc:VehicleValveTrainDesignText)

Windows(n2-vc:VehicleWindowsText)

Wheel Base Type(n2-vc:WheelBaseCategoryText)

Wheel Base Short(n2-vc:WheelBaseShortMeasure)

Wheel Base Long(n2-vc:WheelBaseLongMeasure)

Wheels(n2-vc:WheelNumberText)

Wheel Size Front(n2-vc:WheelSizeFrontMeasure)

Wheel Size Rear (n2-vc:WheelSizeRearMeasure)

Engine(j:Engine)

Engine Cylinders(j:EngineCylinderQuantity)

Fuel Type(nc:ConveyanceFuelCategoryAbstract)

Engine Displacement:(j:EngineDisplacementMeasure)

Engine Horsepower(j:EngineHorsepowerQuantity)

Engine Augmentation(n2-vc:EngineAugmentation) Engine Cycles(n2-vc:EngineCyclesText)

Horsepower Up To(n2-vc:EngineHorsepowerUpToText)

Engine KW(n2-vc:EngineKWText)

Engine Manufacturer(n2-vc:EngineManufacturerText)

Engine Model(n2-vc:EngineModelText)

Other Engine Info(n2-vc:EngineOtherInformationText)

Battery (n2-vc:Battery) Battery Amps(n2-vc:BatteryAmpsText)

Battery Amps Up To(n2-vc:BatteryAmpsUpToText)

Battery Type(n2-vc:BatteryCategoryText)

Battery Information(n2-vc:BatteryInformationText)

Battery kWh(n2-vc:BatterykWhText)

Battery kWh Up To(n2-vc:BatterykWhUpToText)

Battery Volts(n2-vc:BatteryVoltsText)

Battery Volts Up To(n2-vc:BatteryVoltsUpToText)

CAFE (n2-vc:CAFE) CAFE Body Type(n2-vc:CAFEBodyTypeText)

CAFE Make(n2-vc:CAFEMakeText)

CAFE Model(n2-vc:CAFEModelText)

NCAP(n2-vc:NCAP) NCAP Body Type(n2-vc:NCAPBodyTypeText)

NCAP Make(n2-vc:NCAPMakeText)

NCAP Model(n2-vc:NCAPModelText)

NCSA(n2-vc:NCSA) NCSA Body Type(n2-vc:NCSABodyTypeText)

NCSA Make(n2-vc:NCSAMakeText)

NCSA Model(n2-vc:NCSAModelText)

Additional Response Metadata(n2-vc:ResponseMetadata)

Suggested VIN(n2-vc:SuggestedVINText)

Error Codes(n2-vc:ErrorCodesText)

Possible Values(n2-vc:PossibleValuesText)

Additional Error(n2-vc:AdditionalErrorText)


VIN Check NIEM Examples

Example 1: Query of a VIN Check transaction.

<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://niem.gov/niem/niem-core/2.0" xmlns:n2="http://www.nlets.org/niem/1.0">
	<n2:NLETSMessageHeader>
		<nh2:MessageKeyCodeText>GVQ</nh2:MessageKeyCodeText>
		<nh2:OriginatingORIID>AZNLETS45</nh2:OriginatingORIID>
		<nh2:DestinationORIID>NL</nh2:DestinationORIID>
	</n2:NLETSMessageHeader>
	<n2:NLETSInquiryData n2:key="GVQ">
		<n1:Vehicle xmlns:n1="http://release.niem.gov/niem/niem-core/4.0/">
			<n1:VehicleIdentification>
				<n1:IdentificationID>3GNEC12J48G183197</n1:IdentificationID>
			</n1:VehicleIdentification>
		</n1:Vehicle>
	</n2:NLETSInquiryData>
</n2:NLETS>

Example 2: Response to a VIN Check query.

<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://niem.gov/niem/niem-core/2.0" xmlns:n2="http://www.nlets.org/niem/1.0">
	<n2:NLETSMessageHeader>
		<nh2:MessageKeyCodeText>GVR</nh2:MessageKeyCodeText>
		<nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
		<nh2:DestinationORIID>AZNLETS45</nh2:DestinationORIID>
		<nh2:MessageReceiveDate>11/28/2019</nh2:MessageReceiveDate>
		<nh2:MessageReceiveTime>03:45</nh2:MessageReceiveTime>
		<nh2:MessageSendDate>11/28/2019</nh2:MessageSendDate>
		<nh2:MessageSendTime>03:45</nh2:MessageSendTime>
		<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
		<nh2:SendMessageNumeric>00002</nh2:SendMessageNumeric>
	</n2:NLETSMessageHeader>
	<n2:NLETSInquiryData n2:key="GVQ">
		<n2-vc:VINCheckInquiry xmlns:n2-vc="http://www.nlets.org/niem/nlets-vin-check/1.0">
			<nc:VehicleIdentification xmlns:nc="http://release.niem.gov/niem/niem-core/4.0/">
				<nc:IdentificationID>3GNEC12J48G183197</nc:IdentificationID>
			</nc:VehicleIdentification>
		</n2-vc:VINCheckInquiry>
	</n2:NLETSInquiryData>
	<n2:NLETSResponseData n2:key="GVR">
		<n2-vc:VINCheckResponse xmlns:n2-vc="http://www.nlets.org/niem/nlets-vin-check/1.0">
			<nc:Vehicle xmlns:nc="http://release.niem.gov/niem/niem-core/4.0/">
				<nc:ItemCategoryText>MULTIPURPOSE PASSENGER VEHICLE (MPV)</nc:ItemCategoryText>
				<nc:ItemMakeName>CHEVROLET</nc:ItemMakeName>
				<nc:ItemMakeName>GENERAL MOTORS LLC</nc:ItemMakeName>
				<nc:ItemModelName>Avalanche</nc:ItemModelName>
				<nc:ItemModelYearDate>2008</nc:ItemModelYearDate>
				<nc:VehicleDoorQuantity>4</nc:VehicleDoorQuantity>
				<nc:VehicleIdentification>
					<nc:IdentificationID>3GNEC12J48G183197</nc:IdentificationID>
				</nc:VehicleIdentification>
				<nc:VehicleAugmentationPoint si:type="n2-vc:VehicleAugmentationType" xmlns:si="http://www.w3.org/2001/XMLSchema-instance">
					<j:Engine xmlns:j="http://release.niem.gov/niem/domains/jxdm/6.0/">
						<j:EngineDisplacementMeasure>
							<nc:MeasureValueText>5300.0</nc:MeasureValueText>
							<nc:MeasureValueText>323.42584370208</nc:MeasureValueText>
							<nc:MeasureValueText>5.3</nc:MeasureValueText>
						</j:EngineDisplacementMeasure>
						<j:EngineAugmentationPoint si:type="n2-vc:EngineAugmentationType">
							<n2-vc:EngineManufacturerText>GM</n2-vc:EngineManufacturerText>
							<n2-vc:EngineModelText>LY5</n2-vc:EngineModelText>
							<n2-vc:EngineOtherInformationText>Active Fuel Mgt.</n2-vc:EngineOtherInformationText>
						</j:EngineAugmentationPoint>
					</j:Engine>
					<n2-vc:FuelInjectionCategoryText>Sequential Fuel Injection (SFI)</n2-vc:FuelInjectionCategoryText>
					<n2-vc:GrossVehicleWeightRatingText>Class 2E: 6,001 - 7,000 lb (2,722 - 3,175 kg)</n2-vc:GrossVehicleWeightRatingText>
					<n2-vc:PlantCityText>Silao</n2-vc:PlantCityText>
					<n2-vc:PlantCountryText>Mexico</n2-vc:PlantCountryText>
					<n2-vc:PlantCompanyText>GMNA</n2-vc:PlantCompanyText>
					<n2-vc:VehicleBodyClassText>Pickup</n2-vc:VehicleBodyClassText>
					<n2-vc:VehicleBrakeSystemText>Hydraulic</n2-vc:VehicleBrakeSystemText>
					<n2-vc:VehicleDriveCategoryText>4x2</n2-vc:VehicleDriveCategoryText>
					<n2-vc:VehicleEngineConfigurationText>V-Shaped</n2-vc:VehicleEngineConfigurationText>
					<n2-vc:VehicleSeriesText>1/2 Ton</n2-vc:VehicleSeriesText>
					<n2-vc:VehicleTrimText>LS</n2-vc:VehicleTrimText>
				</nc:VehicleAugmentationPoint>
			</nc:Vehicle>
			<n2-vc:ResponseMetadata>
				<n2-vc:ErrorCodesText>0 - VIN decoded clean. Check Digit (9th position) is correct</n2-vc:ErrorCodesText>
				<n2-vc:AdditionalErrorText>4</n2-vc:AdditionalErrorText>
			</n2-vc:ResponseMetadata>
		</n2-vc:VINCheckResponse>
		<n2:ResponseText>VIN: 3GNEC12J48G183197
BodyClass: Pickup
EngineCylinders: 8
DisplacementCC: 5300.0
DisplacementCI: 323.42584370208
DisplacementL: 5.3
Doors: 4
DriveType: 4x2
EngineModel: LY5
GVWR: Class 2E: 6,001 - 7,000 lb (2,722 - 3,175 kg)
Make: CHEVROLET
Manufacturer: GENERAL MOTORS LLC
Model: Avalanche
ModelYear: 2008
PlantCity: Silao
Series: 1/2 Ton
Trim: LS
VehicleType: MULTIPURPOSE PASSENGER VEHICLE (MPV)
BrakeSystemType: Hydraulic
EngineConfiguration: V-Shaped
FuelInjectionType: Sequential Fuel Injection (SFI)
PlantCountry: Mexico
PlantCompanyName: GMNA
OtherEngineInfo: Active Fuel Mgt.
ErrorCode: 0 - VIN decoded clean. Check Digit (9th position) is correct
EngineManufacturer: GM
ManufacturerId: 984
		</n2:ResponseText>
	</n2:NLETSResponseData>
</n2:NLETS>

Top

Legacy (DEPRECATED)

VIN Check Legacy Specifications

This section provides the Legacy format and example of the VIN Check transaction.

VIN Check Specifications

Entry # Char. Explanation
VIN N/A The VIN to be decoded.
VIN Check Legacy Examples

Example 1: Query of a VIN Check transaction.

GVQ.AZNLETS20.NL.TXT
VIN/01DFG345234DF2239W

Example 2: Response on a VIN Check query.

GVR.NL0000000.
13:00 09/28/2017 00038
13:00 09/28/2017 01106
AZNLETS46.TXT
VIN: 3GNEC12J48G183197
VEHICLE DATA
VIN: 3GNEC12J48G183197
Vehicle Type: MULTIPURPOSE PASSENGER VEHICLE (MPV)
Make: CHEVROLET
Make: GENERAL MOTORS LLC
Model: Avalanche
Model Year: 2008
Doors: 4
BodyClass: Pickup
EngineCylinders: 8
DisplacementCC: 5300.0
DisplacementCI: 323.42584370208
DisplacementL: 5.3
Doors: 4
DriveType: 4x2
EngineModel: LY5
GVWR: Class 2E: 6,001 - 7,000 lb (2,722 - 3,175 kg)
Make: CHEVROLET
Manufacturer: GENERAL MOTORS LLC
Model: Avalanche
ModelYear: 2008
PlantCity: Silao
Series: 1/2 Ton
Trim: LS
VehicleType: MULTIPURPOSE PASSENGER VEHICLE (MPV)
BrakeSystemType: Hydraulic
EngineConfiguration: V-Shaped
FuelInjectionType: Sequential Fuel Injection (SFI)
PlantCountry: Mexico
PlantCompanyName: GMNA
OtherEngineInfo: Active Fuel Mgt.
ErrorCode: 0 - VIN decoded clean. Check Digit (9th position) is correct
EngineManufacturer: GM
ManufacturerId: 984

OTHER DATA ABOUT THIS VIN RESPONSE:
Error Codes: 0 - VIN decoded clean. Check Digit (9th position) is correct
Additional Error: 4

Top

Downloads

Download GVQ Schema

Download GVR Schema

Download GVR Stylesheet

Top