The AESDirect VPN Responses: File Formats for AESDirect Filers
AESDirect VPN issues two EDI responses to AESDirect Filers, these are:
- The AESDirect Response: Issued in response to an EDI VPN filed upload. It will contain the results of the AESDirect validation carried out on each shipment contained in the uploaded file.
- The e-Response: Issued whenever a response is received from AES. It will contain the AES response to the filing of a single shipment.
The AESDirect Response
For each file of shipments uploaded through AESDirect EDI-VPN an initial validation of each shipment in the uploaded file will be done by AESDirect. A single file will be downloaded that will detail the results of the AESDirect validation of each of the shipments in the uploaded file. This will include a report of any validation problems found, and confirmation of any shipments that passed all AESDirect validations and accepted by AESDirect.
Delivery:
This file will be delivered to the AESDirect EDI-VPN server that uploaded the original shipment file.
Naming Convention:
The naming convention of the AESDirect Response (one per file submitted) will be:
AESvpn1975.<username>."edi.txt".<date>.<time>.resp
Where <username> is the AESDirect VPN username of the filer
Where "edi.txt" is the name of the uploaded file
Sample AESDirect Response
For the initial EDI response (this is the AESDirect EDI processing) a single response file is generated for all of the shipments in the file.
The first line is a notice that processing has started for the batch and includes the filename of the file we received (this is modified during upload).
Example:
Processing Started for BATCH: AESvpn1975.D2MR660548.kenwood09070922_000.txt.20110928.125557.D2MR
Each shipment response is then listed in the order submitted in the file
Shipment with Error Messages
If there is an error in the shipment then the errors are output in the following format.
Positions 1-17: Shipment Reference Number Positions 18-19: Space Positions 20-end: The error message.
Example:
XXXXXXXXXXXXXXXXX Error Message
XXXXXXXXXXXXXXXXX FAILED TO PROCESS SHIPMENT ERRORS FOUND
After each individual error message, the last error message listed for each shipment is "FAILED TO PROCESS SHIPMENT ERRORS FOUND"
Shipment Succesfully Processed and Submitted to AES
If the shipment was processed successfully, the message output is as follows, with the Xs replaced by the actual shipment reference number:
Example:
***** SUCCESSFULLY PROCESSED SHIPMENT REF NBR:XXXXXXXXXXXXXXXXX
***** SUBMITTED TO AES
The AESDirect e-Response
For every shipment accepted by AESDirect and sent to AES, for which an e-Response is to be delivered, an e-Response file will be downloaded (one per shipment).
Delivery:
- If the shipment was submitted by an AESDirect EDI-VPN server, the file will be delivered to the server that uploaded the shipment file.
- If the shipment was submitted through the AESDirect WWW or AESWebLink interface (and an e-Response requested), the file will be delivered to the designated e-Response server for the submitting AESDirect Account.
Naming Convention:
The naming convention of the e-Response will be:
AESvpn1975.<username>."edi.txt".<date>.<time>.<number>.<number>.aes
Where <username> is the AESDirect VPN username of the filer
Where "edi.txt" is the name of the uploaded file
File Format:
The format of the e-Response file is as follows:
1 S-record followed by 1-999 M-records
S-record Layout
1 "S"
2-12 USPPI EIN
13-29 Shipment Number (17CHARS)
30-44 ITN Confirmation Number (15CHARS)
45-80 Reserved for Future Use
M-record Layout
1 "M"
2-80 AES CBP Message (Warning/Error/Acceptance)
Sample AESDirect e-Response:
S558977655 AESVPNEDITEST1 X20031119000023
M(997) SHIPMENT ACCEPTED AS TRANSMITTED