AESDirect Developers Center

A E S Direct - True Innovation In Export Automation

Home

Log In
AESDirect
Certification Quizzes

Account Set-up & Management
Register New Account
Registration Help
Re-Activate an Account
Terms & Conditions
Privacy Policy
Privacy Act Statement
Account Administration

Vendor Account Set-up
Developers Center
Register Vendor Account

Training
User Guides
Sample Shipments
Online Training
Workshops
AES Compliance

Using AESDirect
Who to Contact
Support Center
Browser Support
Developers Center
News

AESPcLink
About AESPcLink
Getting Started
Terms & Conditions

AESDirect VPN
About AESDirect VPN
Set up AESDirect VPN

Related Sites
Government Sites
Partner Sites

X12-601 Mapping (Effective Sept 2002)
[Developers Center Home]

This document reflects the changes to the X12 format that became effective September 2002. The changes to this format are limited to the X1 - Export License Information Record. This is only a preliminary reference, for a complete guide to edits and requirements on conditional fields, you should see the technical documentation section of the U.S. Customs and Border Protection AES Website, and the X12-601 Specification on the U.S. Customs website.

File Format:

Files to be uploaded should be saved in standard ASCII text

Message Structure:

Segment		Min	Max		Notes
ST	Transaction Set Header	1	1		1
BA1	Beginning Segment for SED	1	1		2
YNQ	Yes/No Question	2	2
DTM	Date/Time	1	1
P5	Port Information	1	2
REF	Reference Numbers	0	1
M12	In-Bond Identifying Information	0	1		3
VID	Equipment	0	999

Segment		Min	Max	L O O P	Min	Max	Notes
N1	Party Information	1	1		2	5	4, 5
N2	Contact Information	0	1
N3	Address Information	1	1
N4	Party Geographic Information	1	1



Segment		Min	Max	L O O P	Min	Max	Notes
L13	Commodity Details	1	1		1	999
MAN	Marks and Numbers	0	1
X1	Export License Information	0	1
VEH	Used Vehicle Information	0	999

SE	Transaction Set Trailer	1	1

Notes:

1 - You can report as many shipments as you wish in a single file, each inside an ST - SE pair
2 - The AESTIR refers to "Action Codes" (Element 2), these are not necessary in AESDirect. Any shipment that has not previously been filed with AESDirect before is treated as an add, and any shipment that has already been filed with AESDirect database is treated as a replace (delete and add). Deletes are not possible through EDI upload and must be performed via the web interface.
3 - This record is required if you want to send the "Routed Transaction Flag" (Element 4). If this record is not sent or the "Routed Transaction Flag" is not included in the record the transaction is assumed to not be a routed transaction; this will have the same result as explicitly sending "N" in the "Routed Transaction Flag" Element.
4 - All shipments must include an USPPI and Consignee, other party information is optional.
5 - USPPI should be reported first in each shipment.

Segment Details:

Segment: ST - Transaction Set Header - 1 Required
Elem	Description	Required	Comments
1	Transaction Set Identifier Code	Yes	Always "601" (without quotes)
2	Transaction Set Control Number	Yes	Identifying Control number, unique within transaction set

Segment: BA1 - Beginning Segment for SED - 1 Required
Elem	Description	Required	Comments
1	Related Company Indicator	Yes	Y - Yes N - No
2	Not Used
3	Mode of Transport Code	Yes	A - Air AC - Air Containerized J - Motor JC - Motor Containerized R - Rail RC - Rail Containerized S - Ocean SC - Ocean Containerized SB - Ocean Barge M - Mail AU - Auto P - Pedestrian H - Passenger, Hand-Carried
4	Country of Destination	Yes	ISO Code Code Tables
5	Shipment Reference Number	Yes
6	Not Used
7	Vessel Flag	Optional	ISO Code Ocean Only Code Tables
8	State of Origin	Yes	US State Codes Code Tables
9	Not Used
10	Carrier Code	Yes	4 Character SCAC or 2/3 Character IATA Code Tables
11	Not Used
12	Conveyance Name	Yes	Vessel Name for Vessel Shipments, Carrier Name for Road, Rail, or Air
13	E-Mail Response Address	Optional	AES Response for this shipment will be sent to this e-mail address if it is provided. If no e-mail is provided, the AES response will go to the default E-Mail address for the account. Initial AESDirect responses will always go to the default e-mail address for the account.

Segment: YNQ - Yes/No Question - 2 Required 2 YNQ Records should be sent, one each for RZ and QQ
Elem	Description	Required	Comments
1	Question Indicator	Yes	RZ - Waiver of Prior Notice QQ - Hazmat
2	Yes/No Response	Yes	Y - Yes N - No

Segment: DTM - Date/Time/Period - 1 Required
Elem	Description	Required	Comments
1	Date/Time Qualifier	Yes	274 - Requested Departure Date
2	Date	Yes	Format: YYMMDD (Report Year 2000 as 00) For shipments from Puerto Rico to the US, report arrival date in US; For all other shipments, report date of departure from US

Segment: P5 - Port Information - 1 Required, 1 Conditional You must report at least a Port of Loading, in addition you must also report a Port of Discharge for Vessel Shipments, and Shipments between the U.S. and Puerto Rico
Elem	Description	Required	Comments
1	Port Function Code	Yes	L - Port of Loading D - Port of Discharge
2	Port Code Type	Yes	D - Schedule D (U.S. Ports), Use for Port of Loading K - Schedule K (Foreign Ports), Use for Port of Discharge
3	Port Code	Yes	Code as Specified in Elem 2 Code Tables

Segment: REF - Reference Numbers - 1 Required for Ocean Shipments Only
Elem	Description	Required	Comments
1	Reference Number Qualifier	Yes	BN - Transportation Reference Number (Booking Number)
2	Reference Number	Yes	Transportation Reference Number (Booking Number for Vessel Shipments)

Segment: M12 - In-Bond Identifying Information - 1 Conditional Required for T&E and IE Moves OR if you wish to report an Entry Number OR if the shipment is a Routed Transaction
Elem	Description	Required	Comments
1	In-Bond Entry Type	Cond.	62 - T&E 63 - IE 36 - Warehouse withdrawal for IE 37 - Warehouse withdrawal for T&E 67 - IE from Foreign Trade Zone 68 - IE from Foreign Trade Zone Required if sending Inbond Information with shipment
2	Entry Number	Cond.	If in-bond, the entry in-bond entry number must be provided. If shipment is transiting to a third party country but entry is made in the US instead of using an in-bond process, the import entry number must be provided.
3	Location Identifier	Cond.	Foreign Trade Zone Include if shipment originates from a Foreign Trade Zone
4	Routed Transaction Flag	Optional	Y - Yes N - No AESDirect will assume shipment is not a routed transaction if this record or element is not sent; this will have the same effect as explicitly sending "N" AES will implement this feature Jan 1, 2001; you can send shipments with the Routed Transaction Flag before that date to enable a smooth transition.

Segment: VID - Equipment - 0 Required, report Up to 999 records
Elem	Description	Required	Comments
1	Not Used
2	Equipment Initial	Yes
3	Equipment Number	Yes
4	Seal Number	Optional

Segment: N1 - Party Information - 1 Required for each party reported
Elem	Description	Required	Comments
1	Party Type Code	Yes	EX - USPPI (U.S. Principal Party in Interest) FW - Forwarder CN - Consignee IC - Intermediate consignee
2	Party Name	Yes
3	Party ID Type Code	Cond.	1 - D-U-N-S 24 - EIN ZZ - Foreign Entity EIN, or Foreign Entity required for USPPI (EX) D-U-N-S, or Foreign Entity required for Forwarder (FW)
4	Party ID	Cond.	Party ID as indicated by ID Type Code Required for USPPI (EX) and Forwarder (FW)

Segment: N2 - Contact Information - 1 Required for USPPI and forwarder
Elem	Description	Required	Comments
1	Contact Name	Yes	Contact First SPACE Middle SPACE Last Name
2	Contact Phone	Yes

Segment: N3 - Address Information - 1 Required for Each Party Reported
Elem	Description	Required	Comments
1	Address Line 1	Yes
2	Address Line 2	No

Segment: N4 - Party Geographic Information - 1 Required for each party reported
Elem	Description	Required	Comments
1	City	Yes
2	State	Cond.	Required for USPPI (EX), Forwarders (FW), and U.S., Mexican, and Canadian Consignees (CN and IC) Code Tables
3	Postal Code	Cond.	Required for Forwarders (FW) and USPPI (EX)
4	Country	Yes	ISO Country Code Code Tables

Segment: L13 - Commodity Details - 1 Required per commodity
Elem	Description	Required	Comments
1	Commodity Code Qualifier	Cond.	A - Harmonized Tariff Schedule B - Schedule B Required when reporting a Commodity Code
2	Commodity Code	Cond.	Schedule B or HTS as indicated in Elem 1 Requirements depend on Export Information Code Code Tables
3	First Unit of Measure	Cond.	Census Code for First Reporting Unit Required if First Quantity is Reported Codes should always be UPPERCASE Code Tables
4	First Quantity	Cond.	Always report whole numbers Requirements depend on Export Information Code
5	Amount Qualifier	Yes	10 - U.S. Dollars (always send 10)
6	Cash Value	Yes	Cash Value in Whole US Dollars
7	Not Used
8	Second Unit of Measure	Cond.	Census Code for Second Reporting Unit Required if Second Quantity is Reported Codes should always be UPPERCASE Code Tables
9	Second Quantity	Cond.	Always report whole numbers Requirements depend on Export Information Code
10	Weight Unit Code	Yes	K - Kilograms (Always Send K)
11	Gross Weight	Yes	Gross weight in whole kilograms
12	Commodity Description	Cond.	Requirements depend on Export Information Code
13	Export Information Code	Yes	AES Codes Code Tables
14	Foreign/Domestic Indicator	Cond.	F - Foreign D - Domestic Requirements depend on Export Information Code

Segment: MAN - Marks and Numbers - 1 Optional
Elem	Description	Required	Comments
1	Not Used
2	Line of Marks and Numbers	Yes

Segment: X1 - Export License Information - 1 Conditional Required if license code is any other than C33
Elem	Description	Required	Comments
1	Not Used
2	Export License Number	Cond.	Export License Number or OTDC ITAR Exemption Number; Report type in element 3.
3	Export License Number Qualifier	Cond.	1 - Export License Number 2 - OTDC ITAR Exemption Number For backwards compatibility, if this field is blank and a number is reported in element 2, it will be assumed to be an Export License Number.
4	Not Used
5	DDTC USML Category Code	Cond.	AES Code Code Tables
6	Export License Code	Yes	AES Code Code Tables
7	DDTC Eligible Party Certification Indicator	Cond.	Y - Yes N - No
8	DDTC Registration Number	Cond.
9	Not Used
10	DDTC Quantity	Cond.	Total number of units that correspond to the DDTC measure reported (element 13)
11	Not Used
12	Not Used
13	DDTC Unit of Measure Code	Cond.	AES Code Code Tables
14	DDTC Line Number		FOR FUTURE USE
15	DDTC Significant Military Equipment Indicator	Cond.	Y - Yes N - No
16	ECCN Number	Cond.

Segment: VEH - Used Vehicle Information - Conditional, Up to 999 vehicle records may be sent per Commodity Required if item is a used vehicle
Elem	Description	Required	Comments
1	Not Used
2	Vehicle ID Number	Yes	VIN Number or Product ID Number Indicate ID Type in Vehicle ID Qualifier (Element 5). If Vehicle ID Qualifier is not sent, ID Number will be assumed to be a VIN Number
3-4	Not Used
5	Vehicle ID Qualifier	Yes	V - VIN Number P - Product ID Number If Qualifier is not sent, ID Number sent in element 2 is assumed to be a VIN Number
6-8	Not Used
9	Title Number	Cond.	Required if ID Number reported in element 2 is a VIN Number
10	Title State	Cond.	Required if ID Number reported in element 2 is a VIN Number Code Tables

Segment: SE - Transaction Set Trailer - 1 Required
Elem	Description	Required	Comments
1	Number of Segments, Including ST and SE	Yes
2	Transaction set control number	Yes

[top of page]