U.S. Customs and Border Protection (CBP)
/
Application Advice
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from U.S. Customs and Border Protection (CBP). Contact U.S. Customs and Border Protection (CBP) for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
U.S. Customs and Border Protection (CBP) logo

X12 824 Application Advice

X12 Release 4050

This X12 Transaction Set contains the format and establishes the data contents of the Application Advice Transaction Set (824) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide the ability to report the results of an application system's data content edits of transaction sets. The results of editing transaction sets can be reported at the functional group and transaction set level, in either coded or free-form format. It is designed to accommodate the business need of reporting the acceptance, rejection or acceptance with change of any transaction set. The Application Advice should not be used in place of a transaction set designed as a specific response to another transaction set (e.g., purchase order acknowledgment sent in response to a purchase order).

Delimiters
  • ~ Segment
  • * Element
  • > Component
  • ^ Repetition
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/cbp/application-advice/01HNB4WX4W9BJGD4V7VFAWQQR9
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
ST
0100
Transaction Set Header
Max use 1
Required
BGN
0200
Beginning Segment
Max use 1
Required
N1 Loop
detail
OTI Loop
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

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code identifying the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code identifying the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I65
Repetition Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the repetition separator is a delimiter and not a data element; this field provides the delimiter used to separate repeated occurrences of a simple data element or a composite data structure; this value must be different than the data element separator, component element separator, and the segment terminator

^
Repetition Separator
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

Code specifying the version number of the interchange control segments

00405
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2001
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code indicating sender's request for an interchange acknowledgment

0
No Interchange Acknowledgment Requested
1
Interchange Acknowledgment Requested (TA1)
ISA-15
I14
Interchange Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code indicating whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

AG
Application Advice (824)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission; codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

004050
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2001

Heading

ST
0100
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) is used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
824
Application Advice
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

BGN
0200
Heading > BGN

Beginning Segment

RequiredMax use 1

To indicate the beginning of a transaction set

Example
BGN-01
353
Transaction Set Purpose Code
Required
Identifier (ID)
Min 2Max 2

Code identifying purpose of transaction set

Usage notes

01 Batch Identification

BGN-02
127
Reference Identification
Required
String (AN)
Min 1Max 50

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

  • BGN02 is the transaction set reference number.
Usage notes

TRANSMITTER ID
Identifier of the party that sent the commodity
shipment data to the Customs and Border
Protection (CBP).
Equivalent AESTIR Proprietary Element: A –
Transmitter ID.
Equivalent X12:601 Element:ISA02

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

  • BGN03 is the transaction set date.
Usage notes

TRANSMITTER DATE
This is the Filer/Transmitter’s date of
transmission.
Equivalent AESTIR Proprietary Element: A –
Transmitter Date.
Equivalent X12:601 Element: ISA09.

BGN-06
127
Reference Identification
Required
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

  • BGN06 is the transaction set reference number of a previously sent transaction affected by the current transaction.
Usage notes

APPLICATION INTENIFER
Identifies the AES output batch type:
XT = Commodity Shipment Filing Response.
XN = Commodity Shipment Warning Reminder.
Equivalent AESTIR Propriety

XN
Commodity Shipment Warning Reminder
XT
Commodity Shipment Filing Response
N1 Loop
OptionalMax >1
N1
0300
Heading > N1 Loop > N1

Party Identification

RequiredMax use 1

To identify a party by type of organization, name, and code

Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)
Min 2Max 3

Code identifying an organizational entity, a physical location, property or an individual

Usage notes

01 Block Identification

Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

USPPI NAME
Name of the US Principal Party of Interest
(USPPI) for the commodity shipment
transactions.
Equivalent AESTIR Proprietary Element: B –
USPPI Name.
Equivalent X12:601Element: N102

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

Usage notes

USPPI ID TYPE
Type of US PrincipalParty of Interest ID
reported in X12:601: N104.
1 DUNS
24 EIN
34 SSN
ZZ Foreign Entity
Equivalent AESTIR Proprietary Element: B
– USPPI ID Type.
Equivalent x12:601 Element: N103
The Census Bureau has eliminated the
acceptance of SSN on any new filings
effective December 3, 2009. Corrections
(change, replace or cancel)to SEDs filed
with SSN prior to the effective date will
continue to be accepted.

1
D-U-N-S Number, Dun & Bradstreet
24
Employer's Identification Number
34
Social Security Number
ZZ
Foreign Entity
N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
Usage notes

USPPI ID
Identifier of the US Principal Party in Interest
(USPPI) for the commodity shipments.
EquivalentAESTIR Proprietary Element: B –
USPPI DI.
Equivalent X12:601 Element:N104

REF
0700
Heading > N1 Loop > REF

Reference Information

RequiredMax use 12

To specify identifying information

Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

Usage notes

01 Batch Control Number

REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 50

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

Usage notes

BATCH CONTROL NUMBER
Filer/Transmitter’sinternal batch identification
sent in to the Customs and Borders Protection
(CBP).

N1 Loop end
Heading end

Detail

OTI Loop
RequiredMax >1
OTI
0100
Detail > OTI Loop > OTI

Original Transaction Identification

RequiredMax use 1

To identify the edited transaction set and the level at which the results of the edit are reported, and to indicate the accepted, rejected, or accepted-with-change edit result

  • The OTI loop is intended to provide a unique identification of the transaction set that is the subject of this application acknowledgment.
Example
OTI-01
110
Application Acknowledgment Code
Required
Identifier (ID)
Min 1Max 2

Code indicating the application system edit results of the business data

Usage notes

02 Response Identification

OTI-02
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

  • OTI02 contains the qualifier identifying the business transaction from the original business application, and OTI03 will contain the original business application identification.
Usage notes

OT102 and OT103 identify the Customs and
Border Protection (CBP) Proprietary record
represented in the X12 response. OT102 contains
the record ID of the Proprietary record. (A1
represents A record, B1 the B record, Y1 the Y
record, Z1 represents the Z record.) See the table
in OT103

OTI-03
127
Reference Identification
Optional
String (AN)
Min 1Max 50

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

  • OTI03 is the primary reference identification or number used to uniquely identify the original transaction set.
Usage notes

OT103 identifies which instance of the Customs
and Boarder Protection (CBP)
Proprietary record is being reported on in the
TED segment.
OT102 OT103
A1 Filers
B1 USPPI ID
SC1 Shipment Reference Number
SC2 InboundsCode + Entry Number
SC3 Transportation Reference Number
N01 Party ID or Party Name
N02 Address Line 1
N03 City
CL1 Line Number + Commodity Description
CL2 Schedule B/HTS Number
ODT DDTC Registration Number
EV1 VIN/Product Number
ES1 Internal Tracking Number (ITN) for an
accepted shipment
Y1 USPPI ID
Z1 Filer ID

OTI-04
142
Application Sender's Code
Optional
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

  • If used, OTI04 through OTI08 will contain values from the original electronic functional group generated by the sender.
Usage notes

AES SYSTEM GENERATED RECORD
INDICATOR
OT104 = “01” indicates that AES was not able to
create the Proprietary record identified in OT102
from data provided in the X12:601 inbound
transmission. Therefore a place-holder
Proprietary record was generated in order to

create syntactically correct response. A space-
holder record may be generate for the B, SC1,

CL1, Y and/or Z Proprietary records (OT102 =
“B1”, “SC1”, “CL1”, “Y1”, or “Z1”)

TED Loop
OptionalMax >1
TED
0700
Detail > OTI Loop > TED Loop > TED

Technical Error Description

RequiredMax use 1

To identify the error and, if feasible, the erroneous segment, or data element, or both

Example
TED-01
647
Application Error Condition Code
Required
Identifier (ID)
Min 1Max 3

Code indicating application error condition

Usage notes

RESPONSE CODE
Code that describes the condition or final disposition. See
AESTIR Appendix A – “CommodityFiling Response
Messages.”
Equivalent AESTIR Proprietary Element: ES1 – Response
Code.

TED-02
3
Free Form Message
Required
String (AN)
Min 1Max 60

Free-form text

  • If used, TED02 will contain a generic description of the data in error (e.g., part number, date, reference number, etc.).
Usage notes

RESPONSE MESSAGE
Format:
SEVERITY IND + blank + FINAL DISPOSITION IND +
blank + NARRATIVE TEXT
Where: Severity Indicator -is 1 byte, alphabetic in
position 1. Final Disposition Indicator -is 1 byte,
alphabetic in position 3. Narrative Text -is up to 40 bytes,
alphanumeric starting in position 5.
There is a 1 byte space between the Severity Indicator and
the Final Disposition Indicator, and a 1 byte space
between the Final Disposition Indicator and the start of the
message text. The Final Disposition Indicator is only
present when OTI02 = "ES1".
Maximum length of the Response Message - 44
bytes.
Equivalent AESTIR Proprietary Elements: ES1 -
Severity Indicator, Final Disposition Indicator,
Narrative Text. TED03 721 Segment ID Code O 1 ID 2/3

TED-03
721
Segment ID Code
Required
Identifier (ID)
Min 2Max 3

Code defining the segment ID of the data segment in error (See Appendix A - Number 77)

TED Loop end
OTI Loop end
SE
0900
Detail > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Detail end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

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.