American Association of Railroads (AAR)
/
Application Advice
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from American Association of Railroads (AAR). Contact American Association of Railroads (AAR) for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
American Association of Railroads (AAR) logo

X12 824 Application Advice

X12 Release 8010
Delimiters
  • ~ Segment
  • * Element
  • > Component
  • ^ Repetition
EDI samples
  • Sample 1 (TA - Acceptance)
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/aar/application-advice/01HK5EEY4PKXKJJJ1G96QC1B64
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
detail
OTI Loop Transaction Set Accept
SE
0900
Transaction Set Trailer
Max use 1
Required
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1
Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)
00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10
ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)
00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10
ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15
ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15
ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format
ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format
ISA-11
I65
Repetition Separator
Required
String (AN)
Min 1Max 1
^
Repetition Separator
ISA-12
I11
Interchange Control Version Number Code
Required
Identifier (ID)
00801
00801 Standards Approved for Publication by ASC X12 Procedures Review Board through December 2019
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9
ISA-14
I13
Acknowledgment Requested Code
Required
Identifier (ID)
Min 1Max 1
0
No Interchange Acknowledgment Requested
1
Interchange Acknowledgment Requested (TA1)
2
Interchange Acknowledgment Requested only when Interchange is "Rejected Because Of Errors"
3
Interchange Acknowledgment Requested only when Interchange is "Rejected Because Of Errors" or "Accepted but Errors are Noted"
ISA-15
I14
Interchange Usage Indicator Code
Required
Identifier (ID)
Min 1Max 1
I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1
>
Component Element Separator

Functional Group Header

RequiredMax use 1
Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)
AG
Application Advice (824)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15
GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15
Required
Date (DT)
CCYYMMDD format
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9
GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2
T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)
008010
008010 Standards Approved for Publication by ASC X12 Procedures Review Board through December 2019

Heading

ST
0100
Heading > ST

Transaction Set Header

RequiredMax use 1
Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)
824
Application Advice
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
BGN
0200
Heading > BGN

Beginning Segment

RequiredMax use 1
Example
BGN-01
353
Transaction Set Purpose Code
Required
Identifier (ID)
Min 2Max 2
BGN-02
127
Reference Identification
Required
String (AN)
Min 1Max 80
Required
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
Heading end

Detail

OTI Loop Transaction Set Accept
RequiredMax >1
Variants (one may be used)
OTI Loop Transaction Set Reject
OTI
0100
Detail > OTI Loop Transaction Set Accept > OTI

Original Transaction Identification

RequiredMax use 1
Example
If Transaction Set Control Number (OTI-09) is present, then Group Control Number (OTI-08) is required
OTI-01
110
Application Acknowledgment Code
Required
Identifier (ID)
TA
Transaction Set Accept
OTI-02
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3
OTI-03
127
Reference Identification
Required
String (AN)
Min 1Max 80
Optional
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
OTI-08
28
Group Control Number
Optional
Numeric (N0)
Min 1Max 9
OTI-09
329
Transaction Set Control Number
Optional
Numeric (N)
Min 4Max 9
REF
0200
Detail > OTI Loop Transaction Set Accept > REF

Reference Information Interchange Train Identification

RequiredMax use >1
Usage notes
Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)
7W
Interchange Train Identification
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 80
Usage notes
REF-03
352
Description
Required
String (AN)
Min 1Max 80
Usage notes
REF
0200
Detail > OTI Loop Transaction Set Accept > REF

Reference Information Section Number

RequiredMax use 1
Usage notes
Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)
UQ
Section Number
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 80
Usage notes
DTM
0300
Detail > OTI Loop Transaction Set Accept > DTM

Date/Time Reference

RequiredMax use 1
Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
HTD
Host Departure Date
Required
Date (DT)
CCYYMMDD format
DTM
0300
Detail > OTI Loop Transaction Set Accept > DTM

Date/Time Reference Tenant Train Departure

RequiredMax use >1
Example
Variants (all may be used)
DTMDate/Time Reference
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
TTD
Tenant Train Departure
Required
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
OTI Loop Transaction Set Accept end
OTI Loop Transaction Set Reject
RequiredMax 1
Variants (one may be used)
OTI Loop Transaction Set Accept
OTI
0100
Detail > OTI Loop Transaction Set Reject > OTI

Original Transaction Identification

RequiredMax use 1
Example
If Transaction Set Control Number (OTI-09) is present, then Group Control Number (OTI-08) is required
OTI-01
110
Application Acknowledgment Code
Required
Identifier (ID)
TR
Transaction Set Reject
OTI-02
128
Reference Identification Qualifier
Required
Identifier (ID)
SPL
Standard Point Location Code (SPLC)
OTI-03
127
Reference Identification
Required
String (AN)
Min 1Max 80
Optional
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
OTI-08
28
Group Control Number
Optional
Numeric (N0)
Min 1Max 9
OTI-09
329
Transaction Set Control Number
Optional
Numeric (N)
Min 4Max 9
REF
0200
Detail > OTI Loop Transaction Set Reject > REF

Reference Information Interchange Train Identification

RequiredMax use >1
Usage notes
Example
Variants (all may be used)
REFReference Information Section Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)
7W
Interchange Train Identification
REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 80
Usage notes
REF-03
352
Description
Optional
String (AN)
Min 1Max 80
Usage notes
REF
0200
Detail > OTI Loop Transaction Set Reject > REF

Reference Information Section Number

RequiredMax use 1
Usage notes
Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)
UQ
Section Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 80
Usage notes
DTM
0300
Detail > OTI Loop Transaction Set Reject > DTM

Date/Time Reference

RequiredMax use 1
Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
TTD
Tenant Train Departure
Required
Date (DT)
CCYYMMDD format
DTM
0300
Detail > OTI Loop Transaction Set Reject > DTM

Date/Time Reference Tenant Train Departure

OptionalMax use >1
Example
Variants (all may be used)
DTMDate/Time Reference
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
HTD
Host Departure Date
Optional
Date (DT)
CCYYMMDD format
TED Loop
RequiredMax >1
TED
0700
Detail > OTI Loop Transaction Set Reject > TED Loop > TED

Technical Error Description

RequiredMax use 1
Example
TED-01
647
Application Error Condition Code
Required
Identifier (ID)
Min 1Max 3
TED-02
3
Free-form Message
Optional
String (AN)
Min 1Max 60
TED-03
721
Segment ID Code
Optional
Identifier (ID)
Min 2Max 3
TED-04
719
Segment Position in Transaction Set
Optional
Numeric (N0)
Min 1Max 10
TED-05
C030
Position in Segment
OptionalMax use 1
Code indicating the relative position of the simple data element or composite data structure in error within a segment, count beginning with 1 for the position immediately following the segment ID; additionally indicating the relative position of a repeating structure in error, count beginning with 1 for the position immediately following the preceding element separator; additionally indicating the relative position of a component of a composite data structure in error, count beginning with 1 for the position following the preceding element or repetition separator
C030-01
722
Element Position in Segment
Required
Numeric (N0)
Min 1Max 2
TED-06
C999
Reference in Segment
OptionalMax use 1
To hold the reference number of a data element and optionally a component data element within a composite
C999-01
725
Data Element Reference Code
Required
String (AN)
Min 1Max 4
TED-07
724
Copy of Bad Data Element
Optional
String (AN)
Min 1Max 99
TED Loop end
OTI Loop Transaction Set Reject end
SE
0900
Detail > SE

Transaction Set Trailer

RequiredMax use 1
Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10
SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
Detail end

Functional Group Trailer

RequiredMax use 1
Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6
GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Interchange Control Trailer

RequiredMax use 1
Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5
IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9
EDI Samples

Sample 1 (TA - Acceptance)

ISA*00* *00* *02*UP *02*BNSF *200718*0017*U*00705*955094144*0*P*~
GS*TR*UP*BNSF*20200718*0017*000091583*X*008010
ST*EDI 824*915830001
BGN*00*EDI 161*20200718*0017
OTI*TA*SPL*684884***20200718*0016*148756886*568860001
REF*7W*YGAT284418*YTNNSJ
REF*UQ*1
DTM*TTD*20200718
DTM*HTD*20200719
SE*8*915830001
GE*1*000091583
IEA*1*955094144

Sample 2 (TR - Rejection)

ISA*00* *00* *02*UP *02*BNSF *200718*0005*U*00705*955087261*0*P*~
GS*TR*UP*BNSF*20200718*0005*000091582*X*008010
ST*EDI 824*915820001
BGN*00*EDI 161*20200718*0005
OTI*TR*SPL*876158***20200718*0004*148756768*567680001
REF*7W*HVAWBAK117*KEDEPA
REF*UQ*1
DTM*TTD*20200717
DTM*HTD*20200717
TED*006*DUPLICATE*BTS*3*13*373*200717
TED*006*DUPLICATE*BTS*3*15*1470*1
TED*006*DUPLICATE*BTS*3*14*41*KEDEPA
SE*11*915820001
GE*1*000091582
IEA*1*955087261

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.