NIEM Examples -Snowmobile Registration Transactions (SQ/SR)
NIEM
Snowmobile Registration NIEM Specifications
This section describes the format and provides examples for Snowmobile Registration queries and responses (SQ/SR).
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.
Nlets now provides a standardized response format for this message type. The standardized format for this message is anticipated to be supported on the Nlets production system by July of 2016. Please contact Kate Silhol at ksilhol@nlets.org for additional information regarding implementation.
Element Dictionary
Transaction types detailed below include: Query by Plate (SQ), Query by VIN (SQ), Query by Owner Name (SQ) and Snowmobile Response (SR).
Query Formats
Query by Plate (SQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vehicle
A motor-driven conveyance designed to carry its operator, and optionally passengers and cargo, over land.
nc:ConveyanceRegistrationPlateIdentification
An identification on a metal plate fixed to a conveyance.
nc:IdentificationID
A value that identifies something.
This element will contain the license plate number to be queried.
Query by VIN (SQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vehicle
A motor-driven conveyance designed to carry its operator, and optionally passengers and cargo, over land.
nc:VehicleIdentification
A unique combination of alphanumeric characters that identifies a specific vehicle.
nc:IdentificationID
A value that identifies something.
This element will contain the VIN to be queried.
Query by Owner Name (SQ)
n2:NLETSInquiryData
This element will contain all elements specific to this transaction.
nc:Vehicle
A motor-driven conveyance designed to carry its operator, and optionally passengers and cargo, over land.
nc:ItemOwner
An entity which owns a property item.
This element encapsulates the information about the snowmobile owner.
nc:EntityPerson
A person capable of bearing legal rights and responsibilities.
nc:PersonBirthDate
A date a person was born.
nc:Date
A full date.
This element contains the DOB for the person being queried on. This data in this element must be in xsd:date
format, that is: yyyy-mm-dd.
nc:PersonName
A combination of names and/or titles by which a person is known.
nc:PersonGivenName
A first name of a person.
This optional element containing a person's first name may be sent via XML if available but will only be
forwarded onto states receiving XML.
nc:PersonMiddleName
A middle name of a person.
This optional element containing a person's middle name may be sent via XML if available but will only be
forwarded onto states receiving XML.
nc:PersonSurName
A last name or family name of a person.
This optional element containing a person's last name may be sent via XML if available but will only be
forwarded onto states receiving XML.
nc:PersonFullName
A complete name of a person.
This required element must contain the full name of the person in the format LAST,FIRST MIDDLE. The data
from this element is the only name data that will be passed onto states receiving text.
Response Formats
Snowmobile Registration Response (SR)
n2:NLETSResponseData
n2:ResponseText
This element will contain the free text response. Nlets recommends the use of a CDATA section
to ensure that the response does not contain any characters illegal in XML.
Snowmobile Registration Standardized Response (SR)
n2:NLETSResponseData
n2-sr:SnowmobileRegistration
This element contains the record of the snowmobile registration.
n2-sr:Snowmobile
This element contains the details of the snowmobile.
This element should contain the attribute structures:id in order to link it to other data structures.
nc:ItemSerialIdentification
An identification inscribed on or attached to a part, collection of parts, or complete unit by the manufacturer.
nc:IdentificationID
A value that identifies something.
nc:ConveyanceColorPrimaryText
A single, upper-most, front-most, or majority color of a conveyance.
nc:ConveyanceColorSecondaryText
A lower-most or rear-most color of a two-tone conveyance or a lesser color of a multi-colored conveyance.
nc:ItemMakeName
A name of the manufacturer that produced an item.
nc:ItemModelName
A name of a specific design or kind of item made by a manufacturer.
nc:ItemModelYearDate
A year in which an item was manufactured or produced.
nc:ItemStyleText
 A style of a property item.
nc:VehicleIdentification
A unique identification for a specific vehicle.
nc:IdentificationID
A value that identifies something.
nc:VehicleSeatingQuantity
A total number of seats available in a vehicle.
 n2-sr:VehicleAugmentation
Additional information about the vehicle.
j:ConveyanceRegistration
A registration of a conveyance with an authority.
j:RegistrationIdentification
An identification of a registration certificate or document.
nc:IdentificationID
An identifier.
j:RegistrationEffectiveDate
A date the current registration takes effect. Actual value should go in the subelement nc:Date.
j:RegistrationExpirationDate
A date the current registration is no longer in effect. Actual value should go in the subelement nc:Date.
j:RegistrationFee
An amount of money required to register a property item.
nc:ObligationTotalAmount
A total amount of money to be charged or paid to meet a financial obligation. The dollar
amount should go in the subelement nc:Amount.
j:RegistrationHolder
An entity to whom a registration is issued.
nc:EntityPerson
A person capable of bearing legal rights and responsibilities.
It should contain the attribute structures:id in order to link it to other data structures.
nc:PersonBirthDate
A date a person was born.
nc:Date
A full date.
This data in this element must be in xsd:date format, that is: yyyy-mm-dd.
nc:PersonName
A combination of names and/or titles by which a person is known.
nc:PersonFullName
A complete name of a person.
nc:PersonSexText
A gender or sex of a person.
j:ConveyanceRegistrationDecal
A sticker attached to a permanent registration plate on a conveyance when it is renewed for the current year.
nc:DecalID
An identifier assigned to a decal in a given year.
nc:DecalColorText
A color of a decal.
j:ConveyanceRegistrationPlateIdentification
An identification on a metal plate fixed to a conveyance.
nc:IdentificationID
An identifier.
nc:IdentificationJurisdiction
An area, region, or unit where a unique identification is issued.
nc:LocationStateName
A name of a state, commonwealth, province, or other such
geopolitical subdivision of a country.
j:RegistrationStatus
A status of a registration. Actual value should go in the subelement nc:StatusDescriptionText.
j:EngineHorsepowerQuantity
A measure count of the horsepower of a conveyance engine. Actual value should go in the subelement nc:QuantityType.
n2-sr:SnowmobileTreadTypeText
The type of tread on the snowmobile's tires.
nc:ContactInformationAssociation
An association between contact information and an entity.
nc:ContactEntity
An entity that may be contacted by using the given contact information.
This element should contain an attribute structures:ref linking to the j:RegistrationHolder/nc:EntityPerson element.
nc:ContactInformation
A set of details about how to contact a person or an organization.
nc:ContactMailingAddress
A postal address by which a person or organization may be contacted.
nc:AddressFullText
A complete address.
nc:ItemInsuranceAssociation
An association between an item and its insurance.
nc:Insurance
A coverage by a contract whereby one party agrees to indemnify or guarantee another against loss by a specified contingent event or peril.
nc:InsurancePolicyIdentification
An identification assigned to an insurance policy by an insurance carrier.
nc:IdentificationID
An identifier.
nc:InsuranceCarrierName
A name of a company which underwrites an insurance policy.
nc:Item
An article or thing.
This element should contain an attribute structures:ref that links to the Snowmobile.
j:ItemTitleAssociation
An association between a property item and its title.
j:Title
A deed or other official document showing the legal ownership of a property item.
j:TitleIdentification
An identification of a certificate of title to a property item.
nc:IdentificationID
An identifier.
j:TitleIssueDate
A date on which a jurisdictional titling authority issued a title to the owner of a property item. Actual value should go in
the subelement nc:Date.
j:TitleStatus
A status of a property title. Actual value should go in the subelement nc:StatusDescriptionText.
nc:Item
An article or thing.
This element should contain an attribute structures:ref that links to the Snowmobile.
Snowmobile Registration NIEM Examples
Example 1: Snowmobile Registration query by plate.
<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>SQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS43</nh2:OriginatingORIID>
<nh2:DestinationORIID>CT</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[NLTEST0001]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="SQ">
<nc:Vehicle>
<nc:ConveyanceRegistrationPlateIdentification>
<nc:IdentificationID>123ABC</nc:IdentificationID>
</nc:ConveyanceRegistrationPlateIdentification>
</nc:Vehicle>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 2: Snowmobile Registration query by VIN.
<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>SQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS20</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZ</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>
<![CDATA[NLETSTEST1]]>
</nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="SQ">
<nc:Vehicle>
<nc:ItemOwner />
<nc:ConveyanceRegistrationPlateIdentification />
<nc:VehicleIdentification>
<nc:IdentificationID>1A1AA1AAAA111111</nc:IdentificationID>
</nc:VehicleIdentification>
</nc:Vehicle>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 3: Snowmobile Registration query by owner name.
<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>SQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS43</nh2:OriginatingORIID>
<nh2:DestinationORIID>VT</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[NL0000TEST]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="SQ">
<nc:Vehicle>
<nc:ItemOwner>
<nc:EntityPerson>
<nc:PersonName>
<nc:PersonFullName>JOHN,SMITH</nc:PersonFullName>
</nc:PersonName>
<nc:PersonBirthDate>
<nc:Date>1950-01-01</nc:Date>
</nc:PersonBirthDate>
</nc:EntityPerson>
</nc:ItemOwner>
</nc:Vehicle>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 4: Snowmobile Registration response (freeform).
<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>SR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZDNR0000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS20</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>
<![CDATA[NLETSTEST1]]>
</nh2:DocumentControlFieldText>
<nh2:MessageReceiveDate>11/26/2019</nh2:MessageReceiveDate>
<nh2:MessageReceiveTime>23:08</nh2:MessageReceiveTime>
<nh2:MessageSendDate>11/26/2019</nh2:MessageSendDate>
<nh2:MessageSendTime>23:08</nh2:MessageSendTime>
<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
<nh2:SendMessageNumeric>00077</nh2:SendMessageNumeric>
</n2:NLETSMessageHeader>
<n2:NLETSResponseData n2:key="SR">
<n2:ResponseText>
LIC/123ABC
ARIZONA DNR 10-27-2011 4.11.47
-ATV REGISTRATION- -DESCRIPTION-
Registration No AA1111AA Make Name HONDA
Received Date // Model Year 1990
Status EXPIRED Serial Number AA1AA1111AA111111
LE Status Wheels 0
-DECALS- Weight 0
Public Decal 111111 Exp Yr 1995 Engine Disp(CC) 70
Private Decal Purchase Date 01/01/1900
Agricultural Decal County Kept MARICOPA
Municipal Decal Exp Yr Serial No Verified
-OWNER-
DOB 01/01/1950
Name SMITH, JOHN
Street 1234 ANY STREET
City PHOENIX
State AZ
Zip 85000
County MARICOPA
</n2:ResponseText>
</n2:NLETSResponseData>
</n2:NLETS>
Example 5: Snowmobile Registration response (standardized).
<n2:NLETS xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0" n2:version="4.00" xmlns:nc="http://release.niem.gov/niem/niem-core/3.0/" xmlns:n2="http://www.nlets.org/niem/1.0" xmlns:s="http://release.niem.gov/niem/structures/3.0/" xmlns:j="http://release.niem.gov/niem/domains/jxdm/5.1/">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>SR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS43</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS45</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[NLTEST0001]]></nh2:DocumentControlFieldText>
<nh2:MessageReceiveDate>12/01/2019</nh2:MessageReceiveDate>
<nh2:MessageReceiveTime>14:36</nh2:MessageReceiveTime>
<nh2:MessageSendDate>12/01/2019</nh2:MessageSendDate>
<nh2:MessageSendTime>14:36</nh2:MessageSendTime>
<nh2:ReceiveMessageNumeric>00000</nh2:ReceiveMessageNumeric>
<nh2:SendMessageNumeric>00230</nh2:SendMessageNumeric>
</n2:NLETSMessageHeader>
<n2:NLETSResponseData n2:key="SR">
<n2-sr:SnowmobileRegistration xmlns:n2-sr="http://www.nlets.org/niem/nlets-snowmobile-registration/1.0">
<n2:AdditionalInformation>
<n2:StateElement>
<n2:ElementFieldName>Field Text</n2:ElementFieldName>
<n2:ElementFieldValue>Value Text</n2:ElementFieldValue>
</n2:StateElement>
</n2:AdditionalInformation>
<n2-sr:Snowmobile s:id="ID_1">
<nc:ItemSerialIdentification>
<nc:IdentificationID>99999</nc:IdentificationID>
</nc:ItemSerialIdentification>
<nc:ConveyanceColorPrimaryText>Blue</nc:ConveyanceColorPrimaryText>
<nc:ConveyanceColorSecondaryText>Black</nc:ConveyanceColorSecondaryText>
<nc:ItemMakeName>Honda</nc:ItemMakeName>
<nc:ItemModelName>Trek</nc:ItemModelName>
<nc:ItemModelYearDate>2012</nc:ItemModelYearDate>
<nc:ItemStyleText>2012</nc:ItemStyleText>
<nc:VehicleIdentification>
<nc:IdentificationID>ABCDEF99999</nc:IdentificationID>
</nc:VehicleIdentification>
<nc:VehicleSeatingQuantity>2</nc:VehicleSeatingQuantity>
<n2-sr:VehicleAugmentation>
<j:ConveyanceRegistration>
<j:RegistrationIdentification>
<nc:IdentificationID>99999</nc:IdentificationID>
</j:RegistrationIdentification>
<j:RegistrationEffectiveDate>
<nc:Date>2015-01-01</nc:Date>
</j:RegistrationEffectiveDate>
<j:RegistrationExpirationDate>
<nc:Date>2015-12-31</nc:Date>
</j:RegistrationExpirationDate>
<j:RegistrationFee>
<nc:ObligationTotalAmount>
<nc:Amount>100</nc:Amount>
</nc:ObligationTotalAmount>
</j:RegistrationFee>
<j:RegistrationHolder>
<nc:EntityPerson s:id="ID_2">
<nc:PersonBirthDate>
<nc:Date>1950-01-01</nc:Date>
</nc:PersonBirthDate>
<nc:PersonName>
<nc:PersonFullName>DOE,JOHN</nc:PersonFullName>
</nc:PersonName>
<nc:PersonSexText>Male</nc:PersonSexText>
</nc:EntityPerson>
</j:RegistrationHolder>
<j:ConveyanceRegistrationDecal>
<nc:DecalID>1</nc:DecalID>
<nc:DecalColorText>WHITE</nc:DecalColorText></j:ConveyanceRegistrationDecal>
<j:ConveyanceRegistrationPlateIdentification>
<nc:IdentificationID>ABC123</nc:IdentificationID>
<nc:IdentificationJurisdiction>
<nc:LocationStateName>AZ</nc:LocationStateName>
</nc:IdentificationJurisdiction>
</j:ConveyanceRegistrationPlateIdentification>
<j:ConveyanceRegistrationStatus>
<nc:StatusDescriptionText>VALID</nc:StatusDescriptionText>
</j:ConveyanceRegistrationStatus>
</j:ConveyanceRegistration>
<j:EngineHorsepowerQuantity>200</j:EngineHorsepowerQuantity>
<n2-sr:SnowmobileTreadTypeText>TREAD TYPE</n2-sr:SnowmobileTreadTypeText>
</n2-sr:VehicleAugmentation>
</n2-sr:Snowmobile>
<nc:ContactInformationAssociation>
<nc:ContactEntity>
<nc:EntityPerson s:ref="ID_2"/>
</nc:ContactEntity>
<nc:ContactInformation>
<nc:ContactMailingAddress>
<nc:AddressFullText>123 S. Main Street, Omaha, NE 12345</nc:AddressFullText>
</nc:ContactMailingAddress>
</nc:ContactInformation>
</nc:ContactInformationAssociation>
<nc:ItemInsuranceAssociation>
<nc:Insurance>
<nc:InsurancePolicyIdentification>
<nc:IdentificationID>12345</nc:IdentificationID>
</nc:InsurancePolicyIdentification>
<nc:InsuranceCarrierName>Geico</nc:InsuranceCarrierName>
</nc:Insurance>
<nc:Item s:ref="ID_1"/>
</nc:ItemInsuranceAssociation>
<j:ItemTitleAssociation>
<j:Title>
<j:TitleIdentification>
<nc:IdentificationID>99999</nc:IdentificationID>
</j:TitleIdentification>
<j:TitleIssueDate>
<nc:Date>2015-01-01</nc:Date>
</j:TitleIssueDate>
<j:TitleStatus>
<n2-sr:StatusText>STATUS</n2-sr:StatusText>
</j:TitleStatus>
</j:Title>
<nc:Item s:ref="ID_1"/>
</j:ItemTitleAssociation>
</n2-sr:SnowmobileRegistration>
</n2:NLETSResponseData>
</n2:NLETS>