electronic temporary registration - Florida Highway Safety and Motor

Page |1
ELECTRONIC TEMPORARY
REGISTRATION
PROGRAM SPECIFICATIONS
Modification Date:
11/01/2011 – Addition of 2 transactions for processing Charged Inquiry Disputes.
05/18/2012 - Autonomous Vehicle must be processed at DHSMV.
Electronic Temporary Registration Program Specifications
Page |2
DEPARTMENT OF HIGHWAY SAFETY AND MOTOR VEHICLES
INFORMATION SYSTEMS ADMINISTRATION
SOFTWARE SERVICES
ELECTRONIC TEMPORARY REGISTRATION SYSTEM
The Electronic Temporary Registration (ETR) System provides a technical means to record in
real-time on the DHSMV database the issuance of a temporary license plate or the temporary transfer of
a metal plate. The ability to provide this information greatly enhances law enforcement efforts. This
document represents the work effort that is needed in Software Services. The connectivity, input and
outputs will also be discussed. Any connectivity or security issues will be addressed with final approval
granted by the ISA security manager and the network manager.
The ETR interface uses Web Service technology. Web Services provides a "behind the scenes"
call from one software application to another utilizing http(s), XML and SOAP protocols (as utilized by
DHSMV). Web Services are generally platform independent.
Upon acceptance as an ETR provider, a WSDL (Web Service Definition Language)
configuration file will be provided. This file is generally used by client development environments to
automatically configure the communication layer. Accessing a web service is frequently referred to as
"consuming" a web service. The DHSMV will "publish" the Web Service for use by the ETR
provider(s).
Within the web service call, the actual data for a given transaction is passed within a very basic
pipe-delimited (label and value pairs) or XML string. This is done to allow more flexibility with
software releases that require changes to the parameters.
Electronic Temporary Registration Program Specifications
Page |3
COMMUNICATION
Without any type of protection or encryption, packets of information would be visible and open
to all. Due to the nature of the information that is being exchanged, all communication is protected by
Secure Sockets Layer (SSL) protocol. More information will be provided to each vendor if it is needed.
Reaching the Web Service
.NET (New Current Technology)
.NET Test Web
https://betaservices.flhsmv.gov/ETRService/WebServiceActionRouterService.svc
Service
.NET Test
https://betaservices.flhsmv.gov/ETRService/WebServiceActionRouterService.svc?wsdl
WSDL
.NET
Production Web https://services.flhsmv.gov/ETRService/WebServiceActionRouterService.svc
Service
.NET
https://services.flhsmv.gov/ETRService/WebServiceActionRouterService.svc?wsdl
Production
WSDL
However, as this is an automatically generated file, some minor adjustments will need to be made to
invoke the web service. In particular, the actual server address location will need to be updated per
instruction from the DHSMV web service technical support team.
The way this file is consumed by the vendor application will be different according to the language used.
Some programming languages may refer to the above link directly, while others may need the file to be
saved locally first with the necessary server adjustments already made.
Electronic Temporary Registration Program Specifications
Page |4
Web Service Actions
The web service contains several actions that may be performed. In order to offer the most flexibility
within the web service, a single method is now called that will act as a “router” of transactions. Any new
development should use this new action router.
The web service operation is named “wsActionRouter”. Other web service operations are deprecated,
and should be ignored as each is available for transition purposes only.
Each action, inquiry or update is activated through this web service method. The necessary parameters
for performing an action are:
Parameter
Type
Description
UserId
String
Password
String
Unique User id assigned by the Department to authenticate
each consumer of the web service.
Password initially assigned by the Department, but may be
changed at the web service consumer’s discretion.
ActionType
String
Identifies the type of action to be performed.
XmlData
String
Contains the necessary business data for performing the
desired action. The data parameter lists are described in
detail in subsequent pages of this document. This is an xml
string.
The result of the invocation of each action will be a String output named wsActionResponse. The
output contains an xml string with an error code if the action failed to execute due to a technical reason.
Otherwise, an xml string is returned with various data depending on the type of action and the result.
The action type consists of two characters. Detailed descriptions of each of these action types are below.
The following are valid transaction types:
Action
CS
VQ
IS
VD
LS
SC
TT
RS
DDT
DLS
Description
Customer Search
Vehicle and Customer Query
Issuance
Void
Log Search
Status Check
Temporary Transfer
Restore Temporary Transfer
Dealer Charged Inquiry Dispute
Dealer Issuance Log Search
Electronic Temporary Registration Program Specifications
Page |5
The valid error codes for the execution of the web service action are:
Error
EX-NQ000
EX-VL000
EX-VL001
EX-VL002
EX-VL003
Description
No or Null Input String
Error validating User and Password
Null or other error checking Password
Invalid format for username or password
User not properly configured
Other error codes exist for the result of the action (i.e. if there is a problem with the XML Data). The
above error codes just apply to the running of the web service method itself.
Only populated elements need to be passed to the web service. All other parameters are considered to be
null. Output parameters are returned in a single output XML string. Any parameters not returned in the
output string should be considered null.
Simple XML is all that is necessary to interface. The below is a simple example of what should be
passed. This is a non-working example. Use the information supplied to you by your DHSMV contact
for actual testing purposes.
Example of parameters sent to the wsActionRouter web service method:
UserId
Password
ActionType
XmlData
*********
*********
CS
<?xml version="1.0"?>
<DEALER_TEMP_TAG_SEARCH_INPUT>
<LAYOUT_VERSION>1.1</LAYOUT_VERSION>
<LAST_NAME>SMITH</LAST_NAME>
<FIRST_NAME>BOBBY</FIRST_NAME>
<DOB>19651203</DOB>
<LIC_NUM>1234567</LIC_NUM>
<LIC_TYPE_CD>VI</LIC_TYPE_CD>
<LIC_SFX>1</LIC_SFX>
<ACCT_NUM>12345</ACCT_NUM>
<DLR_ACTION_CD>CS</DLR_ACTION_CD>
<PIN>1234</PIN>
<BEGIN_REC_NUM>1</BEGIN_REC_NUM>
<END_REC_NUM>10</END_REC_NUM>
</DEALER_TEMP_TAG_SEARCH_INPUT>
Assigned by DHSMV
Assigned by DHSMV
Type of desired action
XML of the necessary
information to perform the
action.
Each transaction XML has an optional label at the beginning and end. In the above example, this is the
label “<DEALER_TEMP_TAG_SEARCH_INPUT>”. This label is only used for quick reference when
visually reviewing the xml during the development stage, and has not effect on the actual transaction.
The LAYOUT_VERSION field also has no direct impact. This value may change when a significant
change is made to the input or output, but is only a documentation field.
Electronic Temporary Registration Program Specifications
Page |6
Electronic Temporary Registration
Electronic Temporary Registration Program Specifications
Page |7
Electronic Temporary Registration Program Specifications
Page |8
CUSTOMER SEARCH TRANSACTION (Optional)
This transaction is sent by the Dealer to search for an existing customer on the DHSMV database
when the driver license number or FEID number of the customer is unknown. This search can be for an
individual or business.
In order to perform a customer search the Dealer must provide a valid license prefix, license
number, license suffix, pin number, and account number. When searching for an individual the Dealer
must provide the customer’s last name, first name and date of birth. When searching for a business the
Dealer must provide the company name or FEID number. If the dealer license number is successfully
validated the customer search is performed. The results of the search are returned in an output ref cursor
for individual or business along with the number of customer records found using the search criteria.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
CS
Contains XmlData for the CS action code.
Input XML for CS Action Type:
NAME
Last Name
First Name
Date of Birth
Company Name
FEID Number
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
***M(1)
M(2)
Mandatory (M)
M(1)
M(1)
M(1)
M(2)
M(2)
M
M
M
M
M (CS or QU)
M
XML TAG
LAST_NAME
FIRST_NAME
DOB
COMPANY_NAME
FEID_NUM
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
Required when searching for an individual customer.
The company name or FEID number is required when searching for a business.
Action Response for CS Action Type:
XML Root Element
Status Code
Status Message
Output Data
Number of Rows
Business Rows
Individual Rows
DEALER_TEMP_TAG_SEARCH_OUTPUT
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
NUM_OF_ROWS
See XML Below
See XML Below
Electronic Temporary Registration Program Specifications
Page |9
Individual Customer XML:
Name
XML Root Element
Customer Number
Driver License Number
Last Name
First Name
Date of Birth
Middle Name
Sex
Name Suffix
Street Address
City
State Code
Zip Code
Country Code
**County Code
XML TAG
INDIVIDUAL_ROW
CUST_NUM
DRIVER_LIC_NUM
LAST_NAME
FIRST_NAME
DOB
MIDDLE_NAME
SEX
NAME_SFX
STREET
CITY
STATE
ZIP
COUNTRY_CD
COUNTY_CD
Business Customer XML:
Name
XML Root Element
Company Name
Customer Number
FEID Number
FEID Suffix
Street address
City
State Code
Zip Code
Country Code
**County Code
XML TAG
BUSINESS_ROW
COMPANY_NAME
CUST_NUM
FEID_NUM
FEID_SUFFIX
STREET
CITY
STATE
ZIP
COUNTRY_CD
COUNTY_CD
Electronic Temporary Registration Program Specifications
P a g e | 10
VEHICLE / CUSTOMER QUERY
This transaction is sent by the Dealer to query the DHSMV database for information on a vehicle
and customer.
In order to perform a vehicle / customer inquiry the Dealer must provide a valid license prefix,
license number license suffix, pin number and account number. A valid Driver License number or
customer number and the vehicle identification number must be provided to perform the inquiry.
If a Temporary Transfer transaction is performed, the license plate number to be transferred must
also be provided. There must be at least 30 days remaining in the registration period of that license plate.
The following type of plates may not be temporarily transferred: Temporary plates, Permanent
Semitrailer plates, IRP plates (International Registration Plan), custom vehicle plates, street rod plates,
authenticated plates, and restricted plates. Horseless Carriage and Antique plates can only be
temporarily transferred to a vehicle that meets the eligibility requirements for that type of plate.
If the dealer license number is successfully validated the vehicle / customer query is performed.
If the query is successful, a system generated log number is returned along with the customer and
vehicle information. The log number must be used on the subsequent issue or temporary transfer
transaction.
If multiple vehicle records exist on the database for the identification number sent, the system
returns the vehicle information for the single vehicle that has an existing title and/or registration. If there
are multiple vehicles that have been titled or registered, an error is returned. When there are multiple
title records for a VIN, if a title number that is associated with the VIN has been included with the input
for the Vehicle/Customer Query, the system returns that vehicle’s information. Autonomous vehicles
must be processed at DHSMV
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
VQ
Contains XmlData for the VQ action code.
Electronic Temporary Registration Program Specifications
P a g e | 11
Input XML for VQ Action Type:
Mandatory (M)
NAME
Optional (O)
XML TAG
Driver License Number
M(1)
DRIVER_LIC_NUM
Customer Number
M(1)
CUST_NUM
Identification Number
M
VIN
License Number
M
LIC_NUM
License Type Code
M
LIC_TYPE_CD
License Suffix
M
LIC_SFX
Account Number
M
ACCT_NUM
Dealer Action Code
M (VQ or QU)
DLR_ACTION_CD
Pin Number
M
PIN
Title Number
O
TITLE_NUM
License Plate Number
M(1A)
LIC_PLT_NUM
***M(1) The driver license number or the customer number is required.
M(1A) Required for a Temporary Transfer.
Action Response for VQ Action Type:
Name
XML Root Element
Dealer Log Number
Customer Number
Last Name
First Name
Date of Birth
Middle Name
Sex
Name Suffix
Company Name
State Code
Country Code
Street Address
Zip Plus
City
Zip Code
Foreign Postal Code
County Code
Address Timestamp
Address Number
Address Type Code
Vehicle Type
Vehicle Number
License Plate Code
Year Make
Major Color Code
Minor Color Code
Body Code
XML TAG
DEALER_TEMP_TAG_QUERY_OUTPUT
DLR_LOG_NUM
CUST_NUM
LAST_NAME
FIRST_NAME
DOB
MIDDLE_NAME
SEX
NAME_SFX
COMPANY_NAME
STATE
COUNTRY_CD
STREET
ZIP4
CITY
ZIP
FOREIGN_POSTAL_CD
COUNTY_CD
ADDR_TIMESTAMP
ADDR_NUM
ADDR_TYPE_CD
VEH_TYPE
VEH_NUM
LIC_PLT_CD
YEAR_MAKE
MJR_COLOR_CD
MNR_COLOR_CD
BODY_CD
Electronic Temporary Registration Program Specifications
P a g e | 12
Make Code
Net Weight
Gross Vehicle Weight
Length Feet
Brake Horse Power
Cubic Centimeters
In House Make
Customer Type
FEID Number
Status Code
Status Message
Output Data
MAKE_CD
NET_WEIGHT
GROSS_VEH_WEIGHT
LENGTH_FEET
BRAKE_HORSE_POWER
CUBIC_CENTIMETERS
IN_HOUSE_MAKE
CUST_TYPE
FEID_NUM
STATUS_CD
STATUS_MSG
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 13
ISSUE ELECTRONIC TEMPORARY REGISTRATION
This transaction is sent by the Dealer to issue an ETR. The temporary license plate number to be
issued is usually generated from the DHSMV temporary license plate sequence generator. However,
when the system is down, a temporary plate number can be used from existing Dealer temporary license
plate stock.
In order to perform an IS transaction, the Dealer must submit a valid dealer log number from a
successful VQ Action Response for the vehicle identification number identified on the IS transaction. A
valid license prefix, license number, license suffix, pin number, account number, and all required
vehicle and customer input must be provided.
Customer
If the customer does not exist on the database, the IS transaction should set the customer number
= null and the address update code = ‘N’. A new customer and mailing address record will be created on
the database.
If the customer exists on the database and the mailing address needs to be updated, the IS
transaction should return the customer number and address number from the VQ Action Response and
set the address update code = ‘U’. The customer mailing address information will be updated on the
database.
If a customer exists on the database without a mailing address, the IS transaction should return
the customer number from the VQ Action Response and set the address update code = ‘X’. The mailing
address will be created on the database.
Vehicle
If the vehicle does not exist on the database, the IS transaction should set the vehicle number =
null and populate all the required vehicle input fields. The vehicle information will be validated
according to the business rules and code tables provided. If the vehicle passes all edits, the vehicle will
be created on the database.
If the vehicle exists on the database, the IS transaction should return the vehicle number from the
VQ Action Response and populate all the required vehicle input fields. The vehicle information will be
validated according to the business rules and code tables provided.
If the vehicle exists on the database and the color of the vehicle needs to be updated, the IS
transaction should return the vehicle number from the VQ Action Response, set the color update flag =
‘T’, and populate all the required vehicle input fields. The vehicle information will be validated
according to the business rules and code tables provided.
Electronic Temporary Registration Program Specifications
P a g e | 14
If the vehicle is currently titled in Florida, there are several business rules that will not allow the
issuance of an ETR to occur. They are as follows:
1. Salvage type is not null.
2. Title status is CANCELLED with a cancelled reason other than ‘Non-Delivery’ or ‘Outof- state’.
3. Title status is CERTIFICATE OF DESTRUCTION, DUPLICATE CERTIFICATE OF
DESTRUCTION, CORRECTION CERTIFICATE OF DESTRUCTION, or JUNKED.
4. EFS title status is not null.
5. Autonomous vehicles must be processed at DHSMV.
Insurance information is required for vehicle types ‘AU’, ‘BS’, ‘TR’, and ‘AM’.
Issuance
If the dealer is issuing an ETR plate generated by the DHSMV sequence number generator and
printed on demand, the IS transaction should set the control number and populate the license plate
number with null. Once the temporary license plate has been assigned, the registration is complete.
If the dealer is issuing an ETR plate from stock on hand, the IS transaction should set the control
number to null and populate the license plate number with the number of the paper plate to be issued.
The plate number entered must be assigned to the dealer issuing the temporary license plate. Once the
temporary license plate is assigned, the registration is complete.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
IS
Contains XmlData for the IS action code.
Electronic Temporary Registration Program Specifications
P a g e | 15
Input XML for IS Action Type:
NAME
Customer number
Identification Number
Control Number
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Dealer Log Number
New Vehicle Flag
Registration Use
Vehicle Type
Vehicle Number
Year Make
Major Color Code
Minor Color Code
Body Code
Make Code
In House Make Code
Net Weight
Gross Vehicle Weight
Length Feet
Brake Horse Power
Cubic Centimeters
GVW Update Flag
Color Update Flag
Address Update Code
Company Name
Last Name
First Name
Date of Birth
Middle name
Sex
Name Suffix
State Code
Country Code
Street Address
Zip Plus
City
Mandatory (M)
Optional(O)
Obsolete(X)
M(3)
M
M(1)
M
M
M
M
M (IS)
M
M
O
X
M(10)
M(9)
M(10)
M(11)
O
M(10)
M(10)
X
X
X
X
X
X
X
O
M(4), M(5), M(6),
M(7)
M(5)
M(4)
M(4)
M(4)
O
M(4)
O
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
XML TAG
CUST_NUM
VIN
CONTROL_NUM
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
DLR_LOG_NUM
NEW_VEH_FLAG
REG_USE
VEH_TYPE
VEH_NUM
YEAR_MAKE
MJR_COLOR_CD
MNR_COLOR_CD
BODY_CD
MAKE_CD
IN_HOUSE_MAKE
NET_WEIGHT
GROSS_VEH_WEIGHT
LENGTH_FEET
BRAKE_HORSE_POWER
CUBIC_CENTIMETERS
GVW_UPDATE_FLAG
COLOR_UPDATE_FLAG
ADDR_UPDATE_CD
COMPANY_NAME
LAST_NAME
FIRST_NAME
DOB
MIDDLE_NAME
SEX
NAME_SFX
STATE
COUNTRY_CD
STREET
ZIP4
CITY
Electronic Temporary Registration Program Specifications
P a g e | 16
Zip Code
Foreign Postal Code
County Code
Address Number
License Plate Number
License Plate Code
Effective Date
Insurance Company Code
Insurance Number
Insurance Type
*** M(1)
M(2)
M(3)
M(4)
M(5)
M(6)
M(7)
M(8)
M(9)
M(10)
M(11)
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
M(4), M(5), M(6),
M(7)
M(7)
M(2)
O
O
M(8)
M(8)
M(8)
ZIP
FOREIGN_POSTAL_CD
COUNTY_CD
ADDR_NUM
LIC_PLT_NUM
LIC_PLT_CD
EFF_DATE
INS_COMPANY_CODE
INS_NUMBER
INS_TYPE
Required when issuing an ETR generated by the DHSMV.
Required when issuing an ETR from stock on hand.
Required for existing customers.
Required when creating an individual customer.
Required when creating a business customer.
Required when creating an address.
Required when updating an address.
Required for vehicle types AU, AM, BS, and TR.
Required for existing vehicles.
Required when creating a vehicle.
Required when creating a vehicle with vehicle type AU, TR, MC, AM, or TO.
Action Response for IS Action Type:
Name
XML Root Element
Customer Number
License Plate Number
License Plate Code
License Plate Used Flag
Body Type Used Flag
Unit Type
Initial Exempt Flag
Vehicle Age Used Flag
Vehicle Class Code
Transaction ID
Charged Fee Amount
Expiration Date
Status Code
Status Message
Output Data
Obsolete(X)
X
X
X
X
X
XML TAG
DEALER_TEMP_TAG_ISSUE_OUTPUT
CUST_NUM
LIC_PLT_NUM
LIC_PLT_CD
LIC_PLT_USED_FLAG
BODY_TYPE_USED_FLAG
UNIT_TYPE
INITIAL_EXEMPT_FLAG
VEH_AGE_USED_FLAG
VEH_CLASS_CD
TRANS_ID
CHARGED_FEE_AMT
EXPIRATION_DATE
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 17
TEMPORARY TRANSFER of a METAL PLATE REGISTRATION
This transaction is sent by the Dealer to temporarily transfer an existing registration associated
with a metal plate. The Dealer must still process the permanent transfer of the registration in the usual
manner within 30 days of the sale.
In order to perform a TT transaction, the Dealer must submit a valid dealer log number from a
successful VQ Action Response for the vehicle identification number identified on the TT transaction. A
valid license prefix, license number, license suffix, pin number, account number, and the plate number
of the registration being transferred, and all required vehicle and customer input must also be provided.
Customer
The customer must already exist on the database as one of the owners of the registration being
transferred. If the customer’s mailing address needs updating, the TT transaction should return the
customer number and address number from the VQ Action Response and set the address update code =
‘U’. The customer mailing address information will be updated on the database.
If the customer exists on the database without a mailing address, the TT transaction should return
the customer number from the VQ Action Response and set the address update code = ‘X’. The mailing
address will be created on the database.
Vehicle
If the vehicle does not exist on the database, the TT transaction should set the vehicle number =
null and populate all the required vehicle input fields. The vehicle information will be validated
according to the business rules and code tables provided. If the vehicle passes all edits, the vehicle will
be created on the database.
If the vehicle exists on the database, the TT transaction should return the vehicle number from
the VQ Action Response and populate all the required vehicle input fields. The vehicle information will
be validated according to the business rules and code tables provided.
If the vehicle exists on the database and the color of the vehicle needs to be updated, the TT
transaction should return the vehicle number from the VQ Action Response and set the color update flag
= ‘T’ and populate all the required vehicle input fields. The vehicle information will be validated
according to the business rules and code tables provided.
If the vehicle is currently titled in Florida, there are several business rules that will not allow the
temporary transfer to occur. They are as follows:
1. Salvage type is not null.
2. Title status is CANCELLED with a cancelled reason other than ‘Non-Delivery’ or ‘Outof-state’.
3. Title status is CERTIFICATE OF DESTRUCTION, DUPLICATE CERTIFICATE OF
DESTRUCTION, CORRECTION CERTIFICATE OF DESTRUCTION, or JUNKED.
4. EFS title status is not null.
5. Autonomous vehicles must be processed at DHSMV
Electronic Temporary Registration Program Specifications
P a g e | 18
License Plate Being Transferred
The plate being temporarily transferred must be found on the DHSMV database. It must have at
least 30 days remaining in the registration period. If there are fewer than 30 days until the registration
expires, a temporary ETR plate must be issued instead.
The following type of plates may not be temporarily transferred: Temporary plates, Permanent
Semitrailer plates, IRP plates (International Registration Plan), custom vehicle plates, street rod plates,
authenticated plates, and restricted plates. Horseless Carriage and Antique plates can only be
temporarily transferred to a vehicle that meets the eligibility requirements for that type of plate.
Temporary Transfer
In addition to the fields required for the issuance of an ETR plate, the temporary transfer of a
metal plate transaction will also require the plate number of the registration being transferred.
Insurance information is not required to be submitted with the temporary transfer of a metal plate
registration.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
TT
Contains XmlData for the IS action code.
Input XML for TT Action Type:
NAME
Customer number
Identification Number
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Dealer Log Number
New Vehicle Flag
Vehicle Type
Vehicle Number
Year Make
Major Color Code
Minor Color Code
Body Code
Make Code
Color Update Flag
Mandatory (M)
Optional (O)
M
M
M
M
M
M
M (TT)
M
M
O
M(4)
M(3)
M(4)
M(5)
O
M(4)
M(4)
O
XML TAG
CUST_NUM
VIN
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
DLR_LOG_NUM
NEW_VEH_FLAG
VEH_TYPE
VEH_NUM
YEAR_MAKE
MJR_COLOR_CD
MNR_COLOR_CD
BODY_CD
MAKE_CD
COLOR_UPDATE_FLAG
Electronic Temporary Registration Program Specifications
P a g e | 19
Address Update Code
State Code
Country Code
Street Address
Zip Plus
City
Zip Code
Foreign Postal Code
County Code
Address Number
License Plate Number
License Plate Code
M(1)
M(2)
M(3)
M(4)
M(5)
M(1), M(2)
ADDR_UPDATE_CD
M(1), M(2)
STATE
M(1), M(2)
COUNTRY_CD
M(1), M(2)
STREET
M(1), M(2)
ZIP4
M(1), M(2)
CITY
M(1), M(2)
ZIP
M(1), M(2)
FOREIGN_POSTAL_CD
M(1), M(2)
COUNTY_CD
M(2)
ADDR_NUM
M
LIC_PLT_NUM
O
LIC_PLT_CD
Required when creating an address.
Required when updating an address.
Required for existing vehicles.
Required when creating a vehicle.
Required when creating a vehicle with vehicle type
AU, TR, MC, AM, or TO.
Action Response for TT Action Type:
Name
XML Root Element
Customer Number
License Plate Number
License Plate Code
Vehicle Class Code
Transaction ID
Charged Fee Amount
Expiration Date
Status Code
Status Message
Output Data
XML TAG
DEALER_TEMP_TAG_TRANSFER_OUTPUT
CUST_NUM
LIC_PLT_NUM
LIC_PLT_CD
VEH_CLASS_CD
TRANS_ID
CHARGED_FEE_AMT
EXPIRATION_DATE
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 20
VOID ELECTRONIC TEMPORARY REGISTRATION
This transaction is sent by the Dealer to void an existing ETR transaction (either an Issuance or a
Temporary Transfer). The void transaction must be processed on the same day as the original transaction
by the issuing Dealer.
In order to perform a VD transaction, the Dealer must provide a valid license prefix, license
number, license suffix, pin number, and account number. A valid transaction ID for a transaction
previously performed by the Dealer on the same day must be provided. The customer number and
identification number are required as well. If the Dealer’s License and Transaction ID are successfully
validated the void transaction will be processed. If the void is successful an ‘OK’ status will be returned
in the output.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
VD
Contains XmlData for the VD action code.
Input XML for VD Action Type:
NAME
Customer Number
Identification Number
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Transaction ID
Mandatory (M)
M
M
M
M
M
M
M (VD)
M
M
XML TAG
CUST_NUM
VIN
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
TRANS_ID
Action Response for VD Action Type:
Name
XML Root Element
Status Code
Status Message
Output Data
XML TAG
DEALER_TEMP_TAG_VOID_OUTPUT
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 21
RESTORE TEMPORARY TRANSFER REGISTRATION
This transaction is sent by the Dealer to ‘UNDO’ a temporary transfer transaction. The Restore
transaction cannot be processed on the same day as the original transaction. It must be processed by the
Dealer who processed the Temporary Transfer transaction.
The Restore transaction is similar to a Void. The only differences are that it does not cancel the
money owed for the Temporary Transfer and it must be performed on a different day than the
transaction it is reversing.
In order to perform a RS transaction, the Dealer must provide the same license prefix, license
number, license suffix, pin number and account number used for the Temporary Transfer transaction
that is being restored. A valid transaction ID for the temporary transfer transaction performed by the
Dealer on a previous day must be provided. The customer number and identification number are
required as well. If the Dealer’s License and Transaction ID are successfully validated the Restore
transaction will be processed. If the Restore is successful an ‘OK’ status will be returned in the output.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
RS
Contains XmlData for the RS action code.
Input XML for RS Action Type:
NAME
Customer Number
Identification Number
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Transaction ID
Mandatory (M)
M
M
M
M
M
M
M (RS)
M
M
XML TAG
CUST_NUM
VIN
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
TRANS_ID
Action Response for RS Action Type:
Name
XML TAG
XML Root Element
DEALER_TEMP_TAG_RESTORE_OUTPUT
Status Code
STATUS_CD
Status Message
STATUS_MESSAGE
Output Data
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 22
ISSUANCE LOG SEARCH TRANSACTION (Optional)
This transaction is sent by the Dealer to search for an existing ETR transaction by log number
and VIN number for the purpose of reprinting the temporary registration.
In order to perform an issuance log search, the Dealer must provide a valid log number and VIN
number combination from a successful transaction. If the log number and VIN number are successfully
validated, the issuance log search will be performed. The results of the search will be returned in the
output.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
LS
Contains XmlData for the LS action code.
Input XML for LS Action Type:
NAME
Identification Number
Dealer Log Number
Mandatory (M)
M
M
XML TAG
VIN
DLR_LOG_NUM
Action Response for LS Action Type:
Name
XML Root Element
Status Code
Status Message
Output Data
License Plate Number
License Plate Code
License Plate Used Flag
Body Type Used Flag
Unit Type
Initial Exempt Flag
Vehicle Age Used Flag
Vehicle Class Code
Transaction ID
Charged Fee Amount
Effective Date
Expiration Date
Customer Number
XML TAG
DEALER_ISSUE_LOG_OUTPUT
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
LIC_PLT_NUM
LIC_PLT_CD
LIC_PLT_USED_FLAG
BODY_TYPE_USED_FLAG
UNIT_TYPE
INITIAL_EXEMPT_FLAG
VEH_AGE_USED_FLAG
VEH_CLASS_CODE
TRANS_ID
CHARGED_FEE_AMT
EFF_DATE
EXPIRATION_DATE
CUSTOMER_NUMBER
Electronic Temporary Registration Program Specifications
P a g e | 23
STATUS CHECK TRANSACTION (Optional)
This transaction is sent by the Dealer to verify the status of the ETR system.
Only a valid USERID and password are required. The results of the search will be returned in the output.
Action Router
Argument
UserId
Password
ActionType
XmlData
Content
User Name for Authentication
Password for Authentication
SC
Null
Action Response for SC Action Type:
Name
XML Root Element
Status Code
Status Message
Output Data
XML TAG
DEALER_STATUS_CHECK_OUTPUT
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
Electronic Temporary Registration Program Specifications
P a g e | 24
DEALER CHARGED INQUIRY DISPUTE TRANSACTION
This transaction is sent by the dealer to dispute a charge that was made for an inquiry. When the
dispute is approved by DHSMV, the amount of the charge will be credited to the account of the service
provider against current and/or future charges.
Only the service provider who created the entry in the Dealer Issuance Log (DIL) may dispute
the charge. The transaction id of the charge being disputed must be provided along with the reason the
charge is disputed and a log number from the DIL that should have prevented the disputed entry from
being charged. The dealer associated with the proposed satisfying log number must be the same dealer
who made the query/quote that was charged in the disputed transaction. Comments also may be
submitted that further describe the dispute.
If the charge is made after 01/15/2012, the dispute transaction must be received within 7 days of
the charge. Disputes for charges made prior to 01/16/2012 must be received by 03/15/2012.
After a dispute is denied, a 2nd attempt to have the charge removed may be made as long as a
different disputed reason code is used. This 2nd attempt must be made within 7 days of the date the
dispute was denied regardless of when the charge was incurred. A charge for an inquiry may be
disputed a maximum of 2 times.
Action Router
ARGUMENT
UserId
Password
ActionType
XmlData
CONTENT
User Name for Authentication
Password for Authentication
DDT
Contains XmlData for the DDT action code.
Input XML for DDT Action Code:
NAME
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Disputed Transaction ID
Mandatory (M)
Optional(O )
M
M
M
M
M
M
M
XML TAG
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
DIS_TRANS_ID
Proposed satisfying log number
M
PRO_SAT_LOG_NUM
Disputed reason code
M
DIS_REASON_CD
Dispute Comments
O
DIS_COMMENTS
Electronic Temporary Registration Program Specifications
P a g e | 25
Action Response for DDT Action Code:
NAME
XML Root Element
XML TAG
DEALER_DISPUTE_TRANSACTION_OUTPUT
Status Code
STATUS_CD
Status Message
STATUS_MESSAGE
Output Data
OUTPUT_DATA
VALID DISPUTED REASON CODES
CODE
001
002
003
004
005
006
007
008
009
010
011
012
DESCRIPTION
A subsequent query, quote, non-voided issuance, or non-voided transfer with the same key
fields as the charged query was made within 30 days by the same service provider and dealer.
A subsequent failed attempt to issue or transfer with the same key fields as the charged query
was made within 30 days by the same service provider and dealer.
A successful issuance, transfer, or Mark Title Sold transaction with the same key fields was
processed earlier on the same day by the same service provider and dealer as the charged
query.
The charge was made for a secondary registrant on the registration that was issued or
transferred.
Multiple voids of the issuance/transfer left the query unsatisfied.
The charge was made for the lienholder on the purchased vehicle who is an individual rather
than a business.
The plate in the charged query was replaced during a subsequent issuance/transfer (by the
same service provider and dealer) AND all other key fields are the same.
The charge for the query was made before 30 days had passed.
The charge was made for a title quote.
The charge was made for a query associated with a Temporary Transfer that was
restored.
New rules applied (only available to DHSMV Cleanup program).
All key fields are null.
Electronic Temporary Registration Program Specifications
P a g e | 26
DEALER ISSUANCE LOG SEARCH BY DATE
This transaction is used to obtain data from the Dealer Issuance Log (DIL). This data can
be used to research and obtain the information needed to perform a Dealer Charged Inquiry Dispute
transaction (DDT). The output data returned will consist of all occurrences of entries in the DIL for the
date and dealer specified.
Action Router
ARGUMENT
UserId
Password
ActionType
XmlData
CONTENT
User Name for Authentication
Password for Authentication
DLS
Contains XmlData for the DDT action code.
Input XML for DLS Action Code:
License Number
License Type Code
License Suffix
Account Number
Dealer Action Code
Pin Number
Mandatory (M)
Optional(O )
M
M
M
M
M
M
LIC_NUM
LIC_TYPE_CD
LIC_SFX
ACCT_NUM
DLR_ACTION_CD
PIN
Log Date
M
LOG_DATE
NAME
XML TAG
Action Response for DLS Action Code:
NAME
XML Root Element
Status Code
Status Message
Output Data
Number of Rows
Log Rows
XML TAG
DEALER_ISSUE_LOG_OUTPUT
STATUS_CD
STATUS_MESSAGE
OUTPUT_DATA
NUM_OF_ROWS
See XML Below
Electronic Temporary Registration Program Specifications
P a g e | 27
Log Row XML:
Name
Dealer Log Number
Driver License Number
Customer Number
License Plate Number
Registration Number
Identification Number
Title Number
Vehicle Number
Converted Action Code
Transaction id
Related Log Number
Certified Service Provider Customer
Number
Agent Customer Number
License Type Code
License Number
License Suffix
Dealer Origin Code
Insert Timestamp
Timestamp
XML TAG
DLR_LOG_NUM
DRIVER_LIC_NUM
CUST_NUM
LIC_PLT_NUM
REG_NUM
VIN
TITLE_NUM
VEH_NUM
CONV_ACTION_CD
TRANS_ID
REL_LOG_NUM
CERT_SER_PROV_CUST_NUM
AGENT_CUST_NUM
LIC_TYPE_CD
LIC_NUM
LIC_SFX
DLR_ORIGIN_CD
INS_TIMESTAMP
TIMESTAMP
Electronic Temporary Registration Program Specifications
P a g e | 28
ETR Data Dictionary
Element Name
Element Description
Size
XML Tag
Account Number
Customer Number of the ETR
Vendor
Technical key used to
uniquely identify address
Last Address change date
(YYYYMMDD)
Address type indicator MMailing, R- Residential
Flag used to indicated an
address change (N, U, X or
NULL)
Agent Customer Number
VARCHAR2(10)
ACCT_NUM
NUMBER(10)
ADDR_NUM
VARCHAR2(8)
ADDR_TIMESTAMP
VARCHAR2(2)
ADDR_TYPE_CD
VARCHAR2(1)
ADDR_UPDATE_CD
NUMBER(10)
AGENT_CUST_NUM
Body style of Vehicle
Brake / Horse power for
motorcycles
Name and address
information
Certified Service Provider
Customer Number
VARCHAR2(2)
NUMBER(4)
BODY_CD
BRAKE_HORSE_POWER
VARCHAR2(250)
(Out XML of Web Service)
NUMBER(10)
CERT_SER_PROV_CUST_NUM
Fee amount charged for the
Temporary registration
City
Flag used to indicate a color
change
Company Name (Individual or
business is req.)
Audit control number printed
on tag
Response taken on a
requested action.
Country
County
Actual size of the motorcycle
engine
Technical key used to
uniquely identify the customer
NUMBER(19)
CHARGED_FEE_AMT
VARCHAR2(30)
VARCHAR2(1)
CITY
COLOR_UPDATE_FLAG
VARCHAR2(53)
COMPANY_NAME
NUMBER(10)
CONTROL_NUM
VARCHAR2 (30)
CONV_ACTION_CD
VARCHAR2(2)
NUMBER(2)
NUMBER(4)
COUNTRY_CD
COUNTY_CD
CUBIC_CENTIMETERS
NUMBER(10)
CUST_NUM
VARCHAR2(2)
VARCHAR2(8)
CUST_TYPE
DOB
VARCHAR2(3)
DLR_ACTION_CD
NUMBER(10)
DLR_LOG_NUM
VARCHAR2(3)
DLR_ORIGIN_CD
Address Number
Address Timestamp
Address Type Code
Address Update Code
Agent Customer
Number
Body Code
Brake Horse Power
Business Cursor
Certified Service
Provider Customer
Number
Charged Fee Amount
City
Color Update Flag
Company Name
Control Number
Converted Action Code
Country Code
County Code
Cubic Centimeters
Customer Number
Customer Type
Date of Birth
Dealer Action Code
Dealer Log Number
Dealer Origin Code
Customer Type Indicator (B, I)
Customer date of Birth
(YYYYMMDD)
Transaction code for the
action requested.
Technical key used to
uniquely identify the a
successful query
Code identifying application
where transaction originated
Electronic Temporary Registration Program Specifications
P a g e | 29
Dispute Comments
Disputed Reason Code
Disputed Transaction id
Driver license number
Effective Date
Expiration Date
FEID Number
FEID Suffix
First Name
Foreign Postal Code
Gross Vehicle Weight
GVW Update Flag
Identification Number
Individual Cursor
In House Make
Insert Timestamp
Insurance Company
Code
Insurance Number
Insurance Type
Last Name
Length Feet
License Number
License Plate Code
License Plate Number
License Suffix
License Type Code
Log Date
Major Color Code
Make Code
Middle name
Minor Color Code
Name Suffix
Comments from customer
Reason that the charge is
erroneous
Transaction id of disputed
charge
Driver License number of
Customer
The effective date of the
registration (YYYYMMDD)
Expiration Date (YYYYMMDD)
Federal Employer
Identification Number
Federal Employer
Identification Suffix
First Name of Customer
Foreign Postal Code
Maximum load capacity of
Vehicle
Flag use to indicate a GVW
change
Vehicle Identification Number
(VIN)
Name and address
information
In house make code
Date log entry was created
The code used to identify the
Insurance Company
(Required for AU, TR, BS,
AM)
The insurance number
(Required for AU, TR, BS,
AM)
The code used to identify the
type of insurance
(A,B,C,F,N,M,P,S)
Last Name of Customer
Length of Vessel
Number assigned to uniquely
identify the Dealer
License plate type code
License plate number
Uniquely identifies the each
location for a License number
Identifies the License Type
(VF, VI) etc.
Date of requested log entries
Major Vehicle color
Make code of Vehicle
Middle name of Customer
Minor Vehicle Color
Code representation of name
suffix 1 Sr. 2 Jr. 3 III
VARCHAR2(200)
VARCHAR2((30)
DIS_COMMENTS
DIS_REASON_CD
NUMBER(10)
DIS_TRANS_ID
VARCHAR2(13)
DRIVER_LIC_NUM
VARCHAR2(8)
EFF_DATE
VARCHAR2(8)
NUMBER(9)
EXPIRATION_DATE
FEID_NUM
NUMBER(2)
FEID_SUFFIX
VARCHAR2(16)
VARCHAR2(10)
NUMBER(6)
FIRST_NAME
FOREIGN_POSTAL_CD
GROSS_VEH_WEIGHT
VARCHAR2(1)
GVW_UPDATE_FLAG
VARCHAR2(21)
VIN
VARCHAR2(261)
(Out XML of Web Service)
VARCHAR2(8)
DATE
NUMBER(5)
IN_HOUSE_MAKE
INS_TIMESTAMP
INS_COMPANY_CODE
VARCHAR2(35)
INS_NUMBER
VARCHAR2(2)
INS_TYPE
VARCHAR2(20)
NUMBER(3)
NUMBER(10)
LAST_NAME
LENGTH_FEET
LIC_NUM
VARCHAR2(3)
VARCHAR2(10)
NUMBER(3)
LIC_PLT_CD
LIC_PLT_NUM
LIC_SFX
VARCHAR2(3)
LIC_TYPE_CD
VARCHAR2(8)
VARCHAR2(3)
VARCHAR2(5)
VARCHAR2(16)
VARCHAR2(3)
VARCHAR2(1)
LOG_DATE
MJR_COLOR_CD
MAKE_CD
MIDDLE_NAME
MNR_COLOR_CD
NAME_SFX
Electronic Temporary Registration Program Specifications
P a g e | 30
Net Weight
New Vehicle Flag
Number of Rows
Output Data
Physical Location
Pin Number
Postal Code
Proposed Satisfying
Log Number
Registration Number
Registration Use
Related Log Number
Sequence number
Sex
State Code
Status Code
Status Message
Street address
Timestamp
Title Number
Transaction ID
Vehicle Number
Vehicle Type
Year Make
Zip Code
Zip Plus
Empty weight of Vehicle
Flag used to indicated if that
the vehicle did not exist
previously(T, Null)
Number of records returned
from search
Output data for transaction
performed
Landmark Description of
address location
Secured pin number provided
by the Dealer
Zip Code – Zip plus
Suggested log number to
satisfy a disputed charge
Technical key used to
uniquely identify a registration
Registration Use
Log number used to prevent a
charge on a query
Technical key used to
uniquely identify the address
sequence
Sex of Customer (M, F or Null)
State
Status indicator for transaction
performed
Status message for
transaction performed
Address number and Street
Name ((Includes apt#)
Last change date
Title Number
Technical key used to
uniquely identify the
transaction
Technical key used to
uniquely identify the vehicle
vehicle
Year vehicle was a
manufactured
5 digit zip code
4 digit zip plus
NUMBER(6)
CHAR(1)
NET_WEIGHT
NEW_VEH_FLAG
NUMBER(10)
NUM_OF_ROWS
VARCHAR2(5000)
OUTPUT_DATA
VARCHAR2(50)
PHYSICAL_LOCATION
VARCHAR2(10)
PIN
VARCHAR2(10)
NUMBER(10)
POSTAL_CODE
PRO_SAT_LOG_NUM
NUMBER(10)
REG_NUM
VARCHAR2(2)
NUMBER(10)
REG_USE
REL_LOG_NUM
NUMBER(10)
SEQ_NUMBER
VARCHAR2(1)
VARCHAR2(2)
VARCHAR2(2)
SEX
STATE
STATUS_CD
VARCHAR2(30)
VARCHAR2(50)
STATUS_MESSAGE,
STATUS_MSG
STREET
DATE
NUMBER(10)
NUMBER(10)
TIMESTAMP
TITLE_NUM
TRANS_ID
NUMBER(10)
VEH_NUM
VARCHAR2(2)
NUMBER(4)
VEH_TYPE
YEAR_MAKE
NUMBER(5)
NUMBER(4)
ZIP
ZIP4
Electronic Temporary Registration Program Specifications
P a g e | 31
ETR ERROR MESSAGES
The following is a list of possible error messages. These messages may be expanded as the system is
developed.
• A REQUIRED DEALER KEY IS MISSING
• A REQUIRED INPUT FIELD(S) WAS NULL. VEHICLE
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
TYPE/REGISTRATION USE
A VEHICLE DETAIL IS MISSING OR INCORRECT. DEPENDING ON
VEHICLE TYPE ENTER THE CORRECT NET WEIGHT, HORSEPOWER,
CUBIC CENTIMETERS, LENGTH OR VEHICLE GROSS WEIGHT
ACCOUNT NUMBER IS NOT NUMERIC
ACCOUNT NUMBER IS NULL
ACCOUNT NUMBER IS REQUIRED
ADDRESS NUMBER MUST BE NULL ON A CREATE ADDRESS
ADDRESS NUMBER REQUIRED ON AN ADDRESS UPDATE
ADDRESS UPDATE CODE IS INVALID
AGENCY NAME IS NOT POPULATED IN AGENCY TABLE
AUTONOMOUS VEHICLE. MUST BE PROCESSED AT DHSMV.
BAD INSERT
BOTH LAST NAME AND COMPANY NAME ARE POPULATED. IS THIS A
BUSINESS OR AN INDIVIDUAL
BOTH MAKE_CODE AND IN_HOUSE_MAKE_CODE ARE POPULATED.
PLEASE CHOOSE ONE OR THE OTHER
BRAKE HORSEPOWER OR CUBIC CENTIMETERS IS REQUIRED FOR
VEHICLE TYPE
CANNOT CHANGE A DL CUSTOMER ADDRESS OUTSIDE OF USA
CANNOT ISSUE A LICENSE PLATE FOR A REBUILDABLE FLOOD
SALVAGE TYPE
CANNOT ISSUE A LICENSE PLATE FOR A REBUILDABLE SALVAGE
TYPE
CANNOT ISSUE A LICENSE PLATE FOR A THEFT SALVAGE TYPE
CHECK INPUT VEHICLE NUMBER AND MAKE SURE IT MATCHES THE
ONE RETURNED IN P_QUERY PROCEDURE
COLOR CODE NOT ALLOWED
CONTROL NUMBER IS NULL
CUSTOMER NOT FOUND
CUSTOMER NUMBER IS NULL
CUSTOMER NUMBER MUST BE PRESENT AND ADDRESS NUMBER
MUST BE NULL ON ADDRESS CHANGE CODE OF X
CUSTOMER ROLE DOES NOT ALLOW ADDRESS CHANGE
D.L. NUMBER NOT FOUND
DEALER EXPIRATION DATE ERROR
DEALER NOT FOUND
DETACHED REGISTRATION.
DISTRIBUTION HAS ALREADY BEEN DONE FOR TRANSACTION
DLN AND VIN IS NULL
DRIVER LICENSE NUMBER IS NULL
Electronic Temporary Registration Program Specifications
P a g e | 32
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
DRIVER LICENSE NUMBER XXXXXX NOT FOUND
EFFECTIVE DATE IS GREATER THAN TODAY
ERROR DETERMINING SEARCH FIELDS
ERROR ON CALL TO GET VEHICLE BY VIN
ERROR ON FETCH OF l_business_ref
ERROR ON FETCH OF l_individual_ref
EXCLUDED FILE SCAN ERROR
FUNCTION ERROR
GET ERROR ON FUNCTION
GET REGISTRATION NUMBER FAILED
GROSS VEHICLE WEIGHT IS NULL IN VEHICLE SUB TYPE TRUCK
GROSS VEHICLE WEIGHT IS REQUIRED FOR VEHICLE TYPE
GVW MUST BE GREATER THAN NET WEIGHT
HIS VOID HAS BEEN ALREADY BEEN DONE
HORSE POWER AND CUBIC CENTIMETERS ARE NULL IN VEHICLE SUB
TYPE MOTORCYCLE
HSP OR CC OUT OF RANGE
IDENTIFICATION NUMBER AND CUSTOMER NUMBER ARE REQUIRED
FIELDS
IDENTIICATION NUMBER IS NULL
INCORRECT AGENCY TYPE
INSERT ERROR ON FUNCTION
INSURANCE IS REQUIRED FOR VEHICLE TYPE
INVALID COLOR CODE
INVALID CUSOTMER TYPE
INVALID DATE FORMAT
INVALID DEALER LICENSE TYPE
INVALID MAJOR COLOR
INVALID MINOR COLOR
INVALID NET WEIGHT RANGE
INVALID NEW VEHICLE CODE
INVALID RANGE
INVALID VEHICLE TYPE
INVALID VEHICLE TYPE BODY CODE COMBINATION
INVALID VEHICLE TYPE, BODY CODE, NET WEIGHT
COMBINATION
ISSUE NOT ALLOWED FOR MULTIPLE VINS
LAST NAME, FIRST NAME AND DATE OF BIRTH REQUIRED
LENGTH FEET IS REQUIRED FOR VEHICLE TYPE
LENGTH IS NULL IN VEHICLE SUB TYPE TRAVEL TRAILER
LENGTH OUT OF RANGE
LICENSE PLATE NOT ASSIGNED TO DEALER LICENSE
LICENSE PLATE NUMBER XXXXXX HAS BEEN VOIDED.
LICENSE PLATE XXXXXX HAS ALREADY BEEN ISSUED
LOG NUMBER IS NULL
Electronic Temporary Registration Program Specifications
P a g e | 33
• MAJOR COLOR CODE IS REQUIRED FOR UPDATE
• MAKE NOT FOUND
• MUST HAVE BRAKE HORSE POWER OR CUBIC CENTIMETERS FOR
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
MOTORCYCLES.
MUST HAVE MAJOR COLOR CODE IF MINOR CODE IS ENTERED
NET WEIGHT IS GREATER THAN OR EQUAL GROSS VEHICLE WEIGHT
NET WEIGHT IS NULL IN VEHICLE SUB TYPE AUTO
NET WEIGHT IS NULL IN VEHICLE SUB TYPE BUS
NET WEIGHT IS NULL IN VEHICLE SUB TYPE TOOLS
NET WEIGHT IS NULL IN VEHICLE SUB TYPE VEHICLE
NET WEIGHT IS REQUIRED FOR VEHICLE TYPE
NO ADDRESS FOR THIS CUSTOMER
NO GROSS VEHICLE WEIGHT HAS BEEN ENTERED
NO REGISTRATION ATTACHED
NO VEHICLE NUMBER ENTERED
NOT FOUND
NOT FOUND, CURSOR IS EMPTY
NULL ENTRY
NULL INPUT
NULL VARIABLE(S)
NUMBER MUST BE NULL ON ADDRESS CHANGE CODE OF X
ONLY TWO TEMPORARY REGISTRATIONS ARE ALLOWED
ONLY VEHICLE TYPES TOOLS(TO), TRAVEL TRAILER (TT) AND VEHICLE
TRAILER (VT) CAN USE IN HOUSE MAKE
OUT OF VOID RANGE
PENDING EFS TRANSACTION
PLATE ALREADY ISSUED ERROR
QUERY ERROR ON FUNCTION
RECORD MISMATCH ERROR
REGISTRATION NOT ALLOWED ON CANCEL REASON OF
REGISTRATION NOT ALLOWED ON TITLE STATUS CODES OF
REQUIRED FIELDS ON THE INITIAL INQUIRY: DRIVER LICENSE
NUMBER OR CUSTOMER NUMBER, VEHICLE IDENTIFICATION
NUMBER, DEALER LICENSE NUMBER, DEALER LICENSE CODE,
DEALER LICENSE SUFFIX, USER ID AND A DEALER ACTION CODE OF
QU
S.P. FLAG IS TRUE. CANNOT CREATE OR UPDATE THE ADDRESS.
STATE CODE IS NULL.
STATE CODE NOT FOUND
STREET ADDRESS IS LIMITED TO 30 CHARACTERS.
THIS CUSTOMER AND VEHICLE HAVE HAD A TEMPORARY
REGISTRATION ISSUED TODAY. YOU MUST VOID XXXXX TO
CONTINUE.
THIS DEALER DID NOT ISSUE THE FIRST REGISTRATION.
THIS INSURANCE COMPANY CODE AND INSURANCE TYPE
COMBINATION IS NOT ALLOWED
Electronic Temporary Registration Program Specifications
P a g e | 34
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
THIS INSURANCE TYPE IS NOT ALLOWED
THIS V.I.N. ALREADY EXISTS
TO MANY ROWS RETURNED
TRANSACTION ID IS NULL
TRANSACTION ID, VEHICLE IDENTIFICATION NUMBER AND CUSTOMER
NUMBER ARE REQUIRED
TRANSACTION_ID IS NULL FOR IDENTIFICATION NUMBER
UPDATE ERROR ON FUNCTION
UPDATE NOT PERFORMED.
USER ID IS NULL
V.I.N. CANNOT HAVE AN I
V.I.N. CANNOT HAVE AN I OR AN O
V.I.N. CANNOT HAVE AN O
V.I.N. CANNOT HAVE SPECIAL CHAR
V.I.N. IS NULL
V.I.N. NOT FOUND
V.I.N. ON DATA BASE DOES NOT MATCH INPUT IDENTIFICATION
NUMBER
VEHICLE ALREADY EXISTS
VEHICLE COLOR IS REQUIRED FOR VEHICLE TYPE
VEHICLE IDENTIFICATION NUMBER IS A REQUIRED FIELD
VEHICLE NUMBER FIELD IS NOT POPULATED
VEHICLE NUMBER IS NULL ON A CREATE
VEHICLE TYPE NOT ELIGIBLE
VEHICLE TYPE ON DATA BASE DOES NOT MATCH INPUT VEHICLE
TYPE
VEHICLE TYPE/REG USE COMBO NOT FOUND
VIN AND CUSTOMER NUMBER ARE NULL.
VIN MODIFICATION ERROR
WRONG TRANSACTION ID, DRIVERS LICENSE NUMBER OR
IDENTIFICATION NUMBER
YEAR MAKE IS OUT OF RANGE
CANNOT TRANSFER A LICENSE PLATE TO A REBUILDABLE FLOOD
SALVAGE TYPE
CANNOT TRANSFER A LICENSE PLATE TO A REBUILDABLE SALVAGE
TYPE
CANNOT TRANSFER A LICENSE PLATE TO A THEFT SALVAGE TYPE
CANNOT TRANSFER A LICENSE PLATE TO A CERTIFICATE OF
DESTRUCTION
CANNOT TRANSFER A LICENSE PLATE TO A JUNKED TITLE
CANNOT TRANSFER A LICENSE PLATE TO THIS CANCELLED TITLE
CANNOT TRANSFER THIS LICENSE PLATE TYPE
CANNOT TRANSFER THIS LICENSE PLATE TYPE TO THIS VEHICLE
CANNOT TRANSFER A LICENSE PLATE WITH LESS THAN 30 DAYS LEFT
ON REGISTRATION
TRANSFER NOT ALLOWED. MULTIPLE VIN RECORDS.
Electronic Temporary Registration Program Specifications
P a g e | 35
• CANNOT TRANSFER A LICENSE PLATE THAT HAS A TEMPORARY
TRANSFER REGISTRATION USE
• TRANSACTION NOT ALLOWED ON TEMPORARY TRANSFER
• REGISTRATION NOT OWNED BY CUSTOMER
• RESTORE NOT ALLOWED ON SAME DAY AS TEMPORARY TRANSFER.
USE VOID.
• A DEALER CAN ONLY RESTORE A TEMPORARY TRANSFER THAT WAS
PERFORMED BY THAT DEALER
• CANNOT TRANSFER THIS LICENSE PLATE TO THIS VEHICLE
Code Tables
The code tables listed below can be found on the departments WEB site at the following link.
http://www.flhsmv.gov/etr/CodeTables.html
Vehicle Type
Vehicle Body Type
Vehicle Color
Make Type
Country
State/Territory
FL County
Insurance Company
Zip codes by County
Electronic Temporary Registration Program Specifications