Actions

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

From Convention Master Documentation

No edit summary
No edit summary
Line 23: Line 23:
| suffix || DCU || Up to 40 Chars ANSI Text || Name Suffix (Issuer Optional)
| 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
| dateofbirth || DBB || 8 Characters Numbers Only || 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
| address1 || DAG || Up to 35 Chars ANSI Text || Street Portion of Address
|-
|-
| address2 || DAH || Up to 40 Chars ANSI Text || Second Line of Address (Issuer Optional)
| address2 || DAH || Up to 35 Chars ANSI Text || Second Line of Address (Issuer Optional)
|-
|-
| city || DAI || Up to 40 Chars ANSI Text || City Portion of Cardholder Address
| city || DAI || Up to 20 Chars ANSI Text || City Portion of Cardholder Address
|-
|-
| state || DAJ || Up to 40 Chars ANSI Text || State Portion of the Cardholder Address
| state || DAJ || 2 Chars ANSI Text || State Portion of the Cardholder Address
|-
|-
| postalcode || DAK || Up to 40 Chars ANSI Text || Postal Code, includes zip+4 for US
| postalcode || DAK || Up to 11 Chars ANSI Text || Postal Code, includes zip+4 for US
|-
|-
| country || DCG || Up to 40 Chars ANSI Text || Country the Card is issued in
| country || DCG || 3 Chars ANSI Text || Country the Card is issued in
|-
|-
| <enter> || N/A || N/A || Send the Enter Key when done reading.
| <enter> || N/A || N/A || Send the Enter Key when done reading.

Revision as of 12:09, 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 8 Characters Numbers Only CM Expected format is CCYYMMDD, format on license may be MMDDCCYY or CCYYMMDD, Reader must convert
address1 DAG Up to 35 Chars ANSI Text Street Portion of Address
address2 DAH Up to 35 Chars ANSI Text Second Line of Address (Issuer Optional)
city DAI Up to 20 Chars ANSI Text City Portion of Cardholder Address
state DAJ 2 Chars ANSI Text State Portion of the Cardholder Address
postalcode DAK Up to 11 Chars ANSI Text Postal Code, includes zip+4 for US
country DCG 3 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