Actions

Sending parsed DL-ID data to CM: Difference between revisions

From Convention Master Documentation

No edit summary
No edit summary
Line 13: Line 13:
|+ V1 Data String Breakdown and Explanation
|+ V1 Data String Breakdown and Explanation
|-
|-
! Data String !! AAMVA field !! Notes/Definition
! Data String !! AAMVA field !! Field Information !! Notes/Definition
|-
|-
| V1 || N/A || Version String
| V1 || N/A || !V followed by up to 3 numbers || Version String
|-
|-
| firstname || DAC || First name of the cardholder.
| firstname || DAC || Up to 40 Chars ANSI Text || First name of the cardholder.
|-
|-
| lastname || DCS || Family Name of the Cardholder
| lastname || DCS || Up to 40 Chars ANSI Text || Family Name of the Cardholder
|-
|-
| suffix || DCU || Name Suffix (Issuer Optional)
| suffix || DCU || Up to 40 Chars ANSI Text || Name Suffix (Issuer Optional)
|-
|-
| dateofbirth || DBB || CM Expected format is CCYYMMDD, format on license may be MMDDCCYY or CCYYMMDD, Reader must convert
| dateofbirth || DBB || Up to 40 Chars ANSI Text || CM Expected format is CCYYMMDD, format on license may be MMDDCCYY or CCYYMMDD, Reader must convert
|-
|-
| address1 || DAG || Street Portion of Address
| address1 || DAG || Up to 40 Chars ANSI Text || Street Portion of Address
|-
|-
| address2 || DAH || Second Line of Address (Issuer Optional)
| address2 || DAH || Up to 40 Chars ANSI Text || Second Line of Address (Issuer Optional)
|-
|-
| city || DAI || City Portion of Cardholder Address
| city || DAI || Up to 40 Chars ANSI Text || City Portion of Cardholder Address
|-
|-
| state || DAJ || State Portion of the Cardholder Address
| state || DAJ || Up to 40 Chars ANSI Text || State Portion of the Cardholder Address
|-
|-
| postalcode || DAK || Postal Code, includes zip+4 for US
| postalcode || DAK || Up to 40 Chars ANSI Text || Postal Code, includes zip+4 for US
|-
|-
| country || DCG || Country the Card is issued in
| country || DCG || Up to 40 Chars ANSI Text || Country the Card is issued in
|-
|-
| <enter> || N/A || Send the Enter Key when done reading.
| <enter> || N/A || N/A || Send the Enter Key when done reading.
|}
|}



Revision as of 11:03, 19 September 2022

When trying to implement reading of DL/ID barcodes we realized a way to pass the information to CM in a machine parsable way that was easy to send via a web browser without add-on software was needed.

This document attempts to create a standard so either mobile applications, or hardware imagers can be programmed to send the needed DL/ID information to CM, in a way that is universal and easy to understand.

Note, any field concatenation should be done on the server side, and blank fields are allowed, and will be ignored by the server side parser.

V1 Data String

!V1!firstname!lastname!suffix!dateofbirth!address1!address2!city!state!postalcode!country<enter>

For more information about the AAMVA field, see Annex D of the AAMVA DL/ID Card Design Standard

V1 Data String Breakdown and Explanation
Data String AAMVA field Field Information Notes/Definition
V1 N/A !V followed by up to 3 numbers Version String
firstname DAC Up to 40 Chars ANSI Text First name of the cardholder.
lastname DCS Up to 40 Chars ANSI Text Family Name of the Cardholder
suffix DCU Up to 40 Chars ANSI Text Name Suffix (Issuer Optional)
dateofbirth DBB Up to 40 Chars ANSI Text CM Expected format is CCYYMMDD, format on license may be MMDDCCYY or CCYYMMDD, Reader must convert
address1 DAG Up to 40 Chars ANSI Text Street Portion of Address
address2 DAH Up to 40 Chars ANSI Text Second Line of Address (Issuer Optional)
city DAI Up to 40 Chars ANSI Text City Portion of Cardholder Address
state DAJ Up to 40 Chars ANSI Text State Portion of the Cardholder Address
postalcode DAK Up to 40 Chars ANSI Text Postal Code, includes zip+4 for US
country DCG Up to 40 Chars ANSI Text Country the Card is issued in
<enter> N/A N/A Send the Enter Key when done reading.

Reference Documents

AAMVA DL/ID Card Design Standard

Support Page to obtain product reference guide for DS6708