Tracelink University

Table of contents

The Application Advice (EDI 824) transaction communicates the results of business-level validation for previously received EDI documents, indicating whether they were accepted, rejected, or required changes.

Contact your TraceLink Services representative for more information about integrating with this message.

  • Message Type: MPC_APPLICATION_ADVICE
  • X12 Format: APPLICATIONADVICE

    • Transform Names:

    • B2B_EDI_X12_824_ApplicationAdvice_IB_V1

    • B2B_EDI_X12_824_ApplicationAdvice_OB_V1

Input Element Occurs Length Description Example
ISA 1…1 - Required. ISA interchange envelope. -
  ISA01 1…1 2/2 Required. Qualifier for authorization control number in ISA02. 00
  ISA02 1…1 10/10 Required. Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. -
  ISA03 1…1 2/2 Required. Qualifier for security information in ISA04. 00
  ISA04 1…1 10/10 Required. Identifies security information about the interchange sender or data. -
  ISA05 1…1 2/2

Required. Interchange sender partner ID qualifier.

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 07
  ISA06 1…1 15/15 Required. Interchange sender identification mapping to fileSenderNumber with party type defined in ISA05. 7777776067344
  ISA07 1…1 2/2

Required. Interchange receiver partner ID qualifier.

  • 01 – Duns (Dun & Bradstreet).
  • 02 – Standard Carrier Alpha Code.
  • 03 – Federal Maritime Commission.
  • 04 – International Air Transport Association.
  • 07 – Global Location Number (GLN).
  • 08 – UCC EDI Communications ID (Comm ID).
  • 09 – X.121 (CCITT).
  • 10 – Department of Defense (DoD) Activity Address Code.
  • 11 – Drug Enforcement Administration identifier.
  • 12 – Telephone Companies.
  • 13 – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem.
  • 14 – Duns Plus Suffix.
  • 15 – Petroleum Accountants Society of Canada Company Code.
  • 16 – DINS Number With 4-Character Suffix.
  • 17 – American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit).
  • 18 – Association of American Railroads (AAR) Standard Distribution Code.
  • 19 – EDI Council of Australia (EDICA) Communications ID Number (COMM ID).
  • 20 – Health Industry Number (HIN).
  • 21 – Integrated Postsecondary Education Data System.
  • 22 – Federal Interagency Commission on Education, or FICE.
  • 23 – National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes.
  • 24 – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP.
  • 25 – 4-Digit Code of Postsecondary Institutions.
  • 26 – Statistics of Canada List of Postsecondary Institutions.
  • 27 – Carrier Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 28 – Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA).
  • 29 – Medicare Provider and Supplier Identification Number assigned by Health Care Financing Administration (HCFA).
  • 30 – U.S. Federal Tax Identification Number.
  • 31 – Jurisdiction Identification Number Plus 4 assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC).
  • 32 – U.S. Federal Employer Identification Number (FEIN).
  • 33 – National Association of Insurance Commissioners Company Code (NAIC).
  • 34 – Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA).
  • 35 – Statistics Canada Canadian College Student Information System Institution Codes
  • 36 – Statistics Canada University Student Information System Institution Codes.
  • 37 – Society of Property Information Compilers and Analysts (SPICA).
  • 38 – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions.
  • AM – Association Mexicana del Codigo de Producto (AMECOP) Communication ID.
  • NR – National Retail Merchants Association (NRMA) - Assigned.
  • SA – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System.
  • SN – Standard Address Number.
  • ZZ – Mutually Defined.
 01
  ISA08 1…1 15/15 Required. EDI receiver ID mapping to file control header and to ServiceLinkId. 888888404358877
  ISA09 1…1 6/6 Required. Interchange date in 6 char YYMMDD format. 231020
  ISA10 1…1 4/4 Required. Interchange time in 4 char HHMM format. 1420
  ISA11 1…1 1/1

Required. This value is dependent on X12 version.

  • Version 4012 and earlier, this is the interchange control standards identifier. Valid value is U.

  • Version 4020 and later, this is the repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different than the data element separator, component separator, and segment terminator."

 ^
  ISA12 1…1 5/5 Required. Interchange control version number. This could be any X12 version. 00501
  ISA13 1…1 9/9 Required. Interchange Control Number mapping to file control header. 0000000000619827
  ISA14 1…1 1/1

Required. Interchange level acknowledgment requested.

Valid values:

  • 0 - No acknowledgment requested

  • 1 - Interchange level acknowledgment requested

 0
  ISA15 1…1 1/1

Required. Indicates whether the interchange is for production, test, or information purposes.

Valid values:

  • I - Information

  • P - Production data

  • T - Test data

 P
  ISA16 1…1 1/1 Required. Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. >
GS 1…* - Required. GS group functional envelope. Child of ISA. Only one GS group expected per interchange. -
  GS01 1…1 2/2

Required. GS group function code.

Valid value is SO Shipping instruction Information

 SO
  GS02 1…1 2/15 Required. Application Sender's Code. 2222224043588
  GS03 1…1 2/15 Required. Application Receiver's Code. TRACELINK
  GS04 1…1 8/8 Required. Current date stamp in 8 char X12 date format YYYYMMDD. 20241020
  GS05 1…1 4/8 Required. Current time stamp in 6 char X12 time format HHMMSS. 142000
  GS06 1…1 1/9 Required. Group Control ID Number. 619827
  GS07 1…1 1/2

Required. Responsible Agency Code.

Valid values:

  • T - Transportation Data Coordinating Committee (TDCC)

  • X - Accredited Standards Committee X12

 X
  GS08 1…1 1/12 Required. X12 message version code. This could be any X12 version. 005010
ST 1…* - Required. ST transaction set envelope. Child of GS group. Only one ST transaction expected. -
  ST01 1…1 3/3 Required. Transaction set identifier code. 824
  ST02 1…1 4/9 Required. Transaction set ID number. Counter for each ST segment beginning with 1. 0001
  BGN 1…1 - Required. BGN Beginning Segment. -
    BGN01 1…1 2/2 Required. Transaction Set Purpose Code identifying purpose of transaction set. Valid value is 11 - RESPONSE 11
    BGN02 1…1 1/50 Required. Transaction unique reference identifier defined for a particular transaction set. The sender's internal number used to identify this transaction set within the sender's application system. 8475
    BGN03 1…1 8/8 Required. Date the original transaction was generated in the sender's business application system, in X12 date format YYYYMMDD. This date is analogous to the date on the paper document, the date it was created. 20160129
    BGN04 0…1 4/8 Transaction time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD 223344
  N1 Loop 0…* - Required. N1 segment loop at header for party address and reference information. -
    N1 1…1 - Required. Party identification. -
      N101 1…1 2/3

Required. Entity qualifier for the Sender or Receiver party identifier and address information.

  • AO – Account of party
  • BK - Bank
  • BG - Purchasing group, buying group
  • BS – Billto and Shipto combined
  • BT – Billto party
  • BY – Customer, Buyer, sold to party
  • CA – Carrier (transport operator)
  • CI – Consignor
  • CN – Consignee
  • CL – Container location
  • CQ - Corportate office
  • C9 – Contract holder or contractor
  • DA – Delivery address / party
  • DB - Distributor branch location
  • DS - Distributor party or location
  • DT – Destination terminal
  • D1 – Truck driver (no EDI qualifier, contextbased)
  • EX - Exporter
  • FR - Message sender
  • HA - Owner of goods
  • FW - Freight forwarder
  • L8 - Head office location
  • MA - Final customer
  • MF - Manufacturer
  • NP - Notify party
  • N1 - First notify party
  • N2 - Second notify party
  • N3 - Third notify party
  • OB - Ordered by party
  • OE - Booking office
  • OT - Origin inland terminal
  • PE - Party that will receive invoice, the payee
  • PO - Party to receive invoice for goods or services
  • PR - Person or organization that pays the invoice
  • PW - Pickup location
  • QA - Retail or institutional pharmacy dispenser. Also used for contracted third party pharmacy supporting a 304b covered entitty.
  • RO - Origin intermodal ramp
  • R1 - The party that receives the document containing weight information fromn the scale.
  • RD - Destination intermodal ramp
  • RL - Reporting party/location / WMS provider (Danone)
  • SF - Shipfrom location
  • SI - Business party that issues the shipping instruction
  • SN - Store number with location info for store
  • SH - Shipper
  • ST - Shipto location
  • SU - Supplier
  • TO - Message receiver
  • VN - Vendor (alt. seller)
  • VI - Contact person information
  • WH - Warehouse
  • YE - Third party business or location information. Also used to identify third party logistics service provider.
  • 2P - Public health service facility: 304B entity that tales ownership of a product in the original sale.
  • 13 - Contracted third party service provider. Also used for third-party contracted pharmacy supporting a 340B covered entity.
  • 41 - Partner or business entity group initiates the transaction
 SU
      N102 0…1 1/60 Name Note: Either N102 or N104 is required. Pharma customer
      N103 0…1 1/2

Identifier code qualifier.

Valid values:

  • 1 - DUNS

  • 2 - SCAC

  • 9 - DUNS+4

  • 11 - Drug Enforcement Agency registration number

  • 21 - Health Industry Number

  • 91 - Company identifier

  • 92 - Company location identifier

  • UL - Global Location Number

  • PI - US_340B_ID

  • PP - Pharmacy_Processor_Number

 UL
      N104 0…1 2/80 Party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655
    N2 0…2 - N2: Additional names: Child of Party N1 segment., we do support one iteration of N2. -
      N201 1…1 1/60 Required. Additional name 2. Pharma name2
      N202 0…1 1/60 Additional name 2. Pharma name2
    N3 0…2 - N3: Address: Child of Party N1 segment. -
      N301 1…1 1/55 Required. Street address 1. 555 Neelan Road
      N302 0…1 1/55 Street address 2. Suite 123
    N4 0…1 - N4: Geographic Location. Child of Party N1 segment. -
      N401 0…1 2/30 City name. Sacramento
      N402 0…1 2/2 State or province code. Code (Standard state/province) as defined by appropriate government agency. CA
      N403 0…1 3/15 Postal code. Code defining international postal zone code excluding punctuation and blanks. 95833
      N404 0…1 2/3 Country code. US
      N405 0…1 1/2 Type of location. CA
      N406 0…1 1/30 Specific location. 95833
      N407 0…1 1/3 Country subdivision. US
    REF 0…12 - Reference segment for mapping to the transaction references. -
      REF01 1…1 2/3

Required. Reference identifier qualifier. Code identifies the type of ID number sent in REF02.

  • 9X - Account type/category

  • TD - Reason for change recorded for order

  • CT - Contract number

  • CE - Class of contract code

  • C8 - Corrected contract number

  • ZZ - Mutually defined transaction identifier

  • DH - US Drug Enforcement agency identifier

  • DP - Department identifier

  • DI - Distributor Invoice Number

  • 19 - Division identifier

  • 1W - Group purchasing organization member identifier

  • HI - US Health Industry Number

  • IA - Internal vendor Number

  • L1 - Letters or notes

  • LI - Line item number

  • LU - GS1-US Global Location Number (GLN)

  • LT - Lot or batch number

  • MR - Merchandise type code

  • 2U - Payer Identification number for 340B programs

  • P1 - Previous contract number

  • P2 - Previous DEA identifier

  • P3 - Previous HIN identifier

  • P7 - Product line number

  • PD - Promotion deal number

  • KK - Proof Of Delivery

  • RX - Resubmit Number

  • X8 - Secondary class identiifer

  • SE - Serial Number

  • ST - store number

  • 8X - Transaction Category

  • VR - Internal vendor identifier

  • IT - Internal customer number

  • 8V - Credit reference number, is a Credit memo number issued on return of original invoice number

  • SB - Sales Region Number

  • RY - Rebate reference number

  • IX - Item number

  • PE - Plant number

  • 87 - Functional category

  • KL - Contract reference number

  • 6L - Agent contract number

  • BP - Adjustment control number

  • FN - Freight forwarder reference identifier

  • OC - Ocean container number

  • BN - Booking number

  • EQ - Equipment number

  • P8 - Pickup reference number

  • 1J - Facility ID Number

  • 4F - Carrier-assigned Shipper Number

  • Sales department number

  • 14 - Master account number

  • GT - Goods and service tax registration number

  • SI - Shipper's Identifying Number for Shipment

  • AW - Air way bill Number

  • 2I - Tracking Number

  • RA - Repetitive Shipment Number

  • RZ - Returned goods authorization Number

  • QY - Express Service Code

  • E7 - Service Bulletin Number

  • 6O - Cross Reference number

  • 3Y - Receiver Assigned Drop Zone

  • RU - Route Number

  • OT - Sales Allowance Number

  • 9F - Referral Number

  • JH - Other tag number

  • 11 - Account Number

  • CR - Customer reference Number

  • ACT - Accounting Code

  • ADI - Processor Identification Number

  • ADT - Full Denial Reason Identifier

  • OD - Original Return Request Reference Number

  • 4N - Special Payment Reference Number

  • AHC - Air Handling Code

  • ACC - Status

  • ACD - Class Code

  • DQ - Delivery Quote Number

  • EVI - Event Identification

  • PRT - Product Type

  • PHC - Process Handling Code

  • XX2 - Service Area Code

  • NB - Letter of credit Number

  • EP - Export License or permit number

  • VX - VAT Registration identifier

  • SCA - Standard Carrier Alpha Code (SCAC)

  • Q8 - Company/place registration number

  • 6A - Consignee reference

  • ABS - Vessel Name

  • SZ - Specification Revision

  • QN - Stop Sequence Number

  • 9V - Payment Category

  • CC - Collect Loads or Contract Co-op Number

  • 7W - Interchange Train Identification

  • HR - Horsepower

  • AF - Airlines Flight Identification Number

  • 33 - Lender Case Number

  • AO - Appointment Number

  • AAO - Carrier Assigned Code

  • MTI - Master Tracking Number

  • HB - House bill of lading number

  • RZ - Return goods authorization

  • E7 - Service bulletin number

  • AAL - Booking agent reference

  • BS - Split booking reference number

  • ZH - Carrier assigned reference / booking number

  • ED - Customs export declaration reference Number

  • LO - Load planning reference number

  • TS - Tariff reference number

  • DJ - Delivery ticket number as reference from shippers / carrier / consignees system

  • HS - Harmonized code system (Canada)

  • RF - Export reference number (not a licence number)

  • CQ - Customs house broker license number

  • TG - Transportation control number

  • VA - Vessel agent number

  • CEC - Enterprise Code for Consignee (custom manifest usage)

  • FI - File Identifier

  • NEC - Enterprise Code for Notify Party (custom manifest usage)

  • SEC - Enterprise Code for Shipper (custom manifest usage)

 RF
      REF02 0…1 1/80 Reference identifier value. 123456
      REF03 0…1 1/45 Description defined by qualifier code in REF02. -
    PER 0…3 - PER segment explains about contact information for party business or location. -
      PER01 1…1 2/2

Required. Contact type.

Valid values:

  • IC - Information contact

  • FC - Forwarder contact

  • RP - Responsible contact

 IC
      PER02 0…1 1/60 Contact name. Grame Smith
      PER03 0…1 2/2 Communication qualifier Note: If PER03 or PER04 present other one is required. We do support either TE or EM as PER03 qualifiers. TE
      PER04 0…1 1/2048 Contact phone number. '897654
      PER05 0…1 2/2

Communication qualifier

Note: If PER05 or PER06 present other one is required. We do support either TE or EM as PER05 qualifiers.

 EM
      PER06 0…1 1/2048 Contact email address. gsmith@gmail.com
  OTI Loop 1…* - Required. Line item loop start for Shipping instruction, referring a line number in a transaction set. -
    OTI 1…1 - Required. Original transaction identification. -
      OTI01 1…1 1/2

Required. Application acknowledgment code. Identifies processing status of the original transaction in the system that sent the 824.

  • BA – Batch Accept
  • BC –Batch Accept with Data Content Change
  • BE – Batch Accept with Error
  • BP – Batch Partial Accept/Reject
  • BR – Batch Reject
  • GA – Functional Group Accept
  • GC – Functional Group Accept with Data Content Change
  • GE – Functional Group Accept with Error
  • GH – Functional Group on Hold, All transaction sets within a specific functional group are on hold pending further investigation to either accept or reject the functional group
  • GP – Functional Group Partial Accept/Reject
  • GR – Functional Group Reject
  • IA – Item Accept
  • IC – Item Accept with Data Content Change
  • IE - Item Accept with Error
  • IP - Item Partial Accept/Reject

  • IR - Item Reject

  • TA - Transaction Set Accept

  • TC - Transaction Set Accept with Data Content Change

  • TE - Transaction Set Accept with Error

  • TH - Transaction Set on Hold, Transaction set on hold pending further investigation to either accept or reject the transaction set

  • TP - Transaction Set Partial Accept/Reject

  • TR - Transaction Set Reject

 TA
      OTI02 1…1 2/3

Required. Original transaction reference number qualifier.

  • 10 - Consolidated Shipment Number

  • 14 - Master account

  • 1X - Credit debit adjustment identifier type

  • 2I - Tracking number

  • 72 - Schedule reference identifier

  • 92 - Document change Tracking number

  • A3 - Assignment

  • AG - Agent's sipment identifier

  • AM - Chargeback adjustment memo

  • BAF - Receipt number

  • BC - Customer contract number

  • BL - Government Bill of Lading

  • BM - Bill of lading

  • BT - Batch

  • CB - Combined Shipment

  • CD - Credit advice

  • CG - Conginee order number

  • CK - Check number

  • CM - Credit memo

  • CN - Carrier reference

  • CO - Customer order number, Identifies the number assigned by the customer to their order.

  • CR - Customer reference identifier

  • CT - Contract number

  • D1 - US Drug Enforcement Agency (DEA) order number

  • DD - Document number

  • DEA - DEA certificate identifier

  • DH - DEA identifier number

  • DI - Distributor invoice number

  • DL - Debit memo

  • DO - Delivery

  • EM - Electronic payment

  • GK - Third party reference identifier

  • IB - Customs regulatory document identifier for shipments transiting under bond

  • IK - Invoice party reference identifier

  • IN - Consignee's Invoice Number

  • IV - Seller's invoice

  • K9 - Customer inquiry number

  • MA - Ship notice or manifest number for shipment

  • MB - Master bill of lading

  • OI - Original invoice

  • OQ - Order number

  • P2 - Previous DEA identifier number

  • PK - Packing list number

  • PO - Purchase order number

  • PP - Purchase order revision number

  • PR - Price quote number

  • PT - Purchase Option Agreement

  • Q1 - Supplier quotation number

  • QD - DEA replacement identifier number

  • QP - Original purchase order number

  • RE - Release document number

  • RZ - Return authorization transaction identifier type

  • SI - Shipment number

  • SN - Seal number

  • SO - Shipper's Order (Invoice Number)

  • TB - Trucker's Bill of Lading

  • TN - Transaction reference number

  • VAT - VAT Number

  • VC - Supplier contract number

  • VN - Supplier order number

  • VR - Vendor identifier number

  • WH - Master Reference (Link) Number

  • WO - Work order (production order) number

 TN
      OTI03 1…1 1/50 Required. Reference Identification defined for a particular Transaction Set. Identifies the transaction within the business application, such as the document number. If reporting errors on an 856, this should reference the ASN ship notification document number. 0001
      OTI04 0…1 2/15 Application Sender's Code. Identifies the sender (GS02 sender) of the original transaction that the 824 is reporting on. R23432
      OTI05 0…1 2/15 Application Sender's Code. Identifies the receiver (GS03 receiver) of the original transaction that the 824 is reporting on. AA2343
      OTI06 0…1 8/8 Transaction date in YYYYMMDD format from the GS04 date field in the original transaction that the 824 is reporting on. 20160129
      OTI07 0…1 4/8 Transaction time in 24 hour HHMM or HHMMSS or HHMMSSD or HHMMSSDD time format from the GS05 time field in the original transaction that the 824 is reporting on. 223344
      OTI08 0…1 1/9 Group Control Number from the GS06 field of the original 856 ASN (or other) transaction that the 824 is reporting on. -
      OTI09 0…1 4/9 Transaction Set Control Number from the ST02 field of the original 856 ASN (or other) transaction that the 824 is reporting on. -
      OTI10 0…1 3/3 X12 transaction set code from the ST01 field of the original 856 ASN (or other) transaction that the 824 is reporting on. Valid values can be any X12 transaction set code. -
    REF 0…* - Reference segment for mapping to the transaction identifiers. List of documents and transactions referencing at the item level of the message, that are relate to original transaction. -
      REF01 1…1 2/3

Required. Reference identifier qualifier. Code identifies the type of ID number sent in REF02.

  • 10 - Consolidated Shipment Number

  • 14 - Master account

  • 1X - Credit debit adjustment identifier type

  • 2I - Tracking number

  • 72 - Schedule reference identifier

  • 92 - Document change Tracking number

  • A3 - Assignment

  • AG - Agent's sipment identifier

  • AM - Chargeback adjustment memo

  • BAF - Receipt number

  • BC - Customer contract number

  • BL - Government Bill of Lading

  • BM - Bill of lading

  • BT - Batch

  • CB - Combined Shipment

  • CD - Credit advice

  • CG - Conginee order number

  • CK - Check number

  • CM - Credit memo

  • CN - Carrier reference

  • CO - Customer order number, Identifies the number assigned by the customer to their order.

  • CR - Customer reference identifier

  • CT - Contract number

  • D1 - US Drug Enforcement Agency (DEA) order number

  • DD - Document number

  • DEA - DEA certificate identifier

  • DH - DEA identifier number

  • DI - Distributor invoice number

  • DL - Debit memo

  • DO - Delivery

  • EM - Electronic payment

  • GK - Third party reference identifier

  • IB - Customs regulatory document identifier for shipments transiting under bond

  • IK - Invoice party reference identifier

  • IN - Consignee's Invoice Number

  • IV - Seller's invoice

  • K9 - Customer inquiry number

  • MA - Ship notice or manifest number for shipment

  • MB - Master bill of lading

  • OI - Original invoice

  • OQ - Order number

  • P2 - Previous DEA identifier number

  • PK - Packing list number

  • PO - Purchase order number

  • PP - Purchase order revision number

  • PR - Price quote number

  • PT - Purchase Option Agreement

  • Q1 - Supplier quotation number

  • QD - DEA replacement identifier number

  • QP - Original purchase order number

  • RE - Release document number

  • RZ - Return authorization transaction identifier type

  • SI - Shipment number

  • SN - Seal number

  • SO - Shipper's Order (Invoice Number)

  • TB - Trucker's Bill of Lading

  • TN - Transaction reference number

  • VAT - VAT Number

  • VC - Supplier contract number

  • VN - Supplier order number

  • VR - Vendor identifier number

  • WH - Master Reference (Link) Number

  • WO - Work order (production order) number

 BM
      REF02 0…1 1/80 Reference identifier value: 123456
    DTM 0...* - Dates that will help transactionset to uniquely identify origin transaction / reference transaction set that this Application advice (824) is generating -
      DTM01 1…1 3/3

Required. Date type related to shipment events at port, in date format YYYYMMDD and time format (IDoc/ X12) HHMMSS.

  • 002 – Delivery requested by date
  • 003 – Invoice date
  • 004 – Purchase order date
  • 006 – Date sold
  • 007 – Effective date
  • 008 – Purchase order received date
  • 009 – Processing date
  • 010 – Shipment requested by date
  • 011 – Date shipped
  • 015 – Promotion start date
  • 016 – Promotion end date
  • 017 – Estimated delivery date
  • 018 – Product availability date
  • 020 – Check date
  • 023 – Promotion order start date
  • 024 – Promotion order end date
  • 025 – Promotion ship start date
  • 026 – Promotion ship end date
  • 035 – Date of delivery document, ASN
  • 036 – Expiration date
  • 037 – Not before shipment date
  • 038 – Not later shipment date
  • 040 – Status (After and Including)
  • 041 – Status (Prior and Including)
  • 050 – Date goods receipt posted (received into available inventory)
  • 061 – Cancel by date
  • 067 – Current scheduled delivery date
  • 068 – Scheduled shipment date
  • 069 - date of promised delivery
  • 070 – Delivery schedule date
  • 074 – Requested delivery date.
  • 079 – Promised for shipment date
  • 090 – Report start date
  • 091 – Report end date
  • 094 – Manufacturing date
  • 097 – Created on date
  • 097 – Transactional date
  • 102 – Date goods issue posted
  • 133 – Account receivable date
  • 146 - Closing date
  • 166 – Message date
  • 168 – Release date
  • 184 – Inventory Update date
  • 188 – Credit advice date
  • 189 – Debit advise date
  • 196 – Date Start
  • 197 – End date
  • 208 – Lot expiration date
  • 311 - Latest receiving / cutoff date
  • 324 – Returned date
  • 372 – Actual arrival date
  • 472 – Date services rendered
  • 512 – Warranty date
  • 514 – Transfer date
  • AAG – Due date
  • 814 – Payment due date
  • 922 – Date of original receipt
  • 938 – Order date
  • 964 – Billing date
  • 999 – Document date
 999
      DTM02 0…1 8/8 Date defined by referenced date type in date format YYYY-MM-DD. Transform will pass thru whatever it finds. 20241215
      DTM03 0…1 4/8 Time expressed in 24-hour clock time as follows. -
      DTM04 0…1 2/2 Time zone for referenced dates. ES
      DTM05 0…1 2/3

Describes the date format, time format, or date and time period format type.

  • D6 - YYMMDD

  • D8 - CCYYMMDD

  • DD - DAYOFMONTH

  • DT - CCYYMMDDHHMM

  • MD - MMDD

  • T - MMDDYY

  • TM - HHMM

  • TQ - MMYY

  • TS - HHMMSS

  • TT - MMDDYY

  • YM - YYMM

 DT
    AMT 0…* - Monetary amount. Original transaction amount for which 824 is being generated Notes: which will be used to uniquely identify original transaction in sender system. -
      AMT01 1…1 1/3

Required. Referenced transaction amount type.

  • 1 - LINEITEMTOTAL

  • 8- TOTALDISCOUNT

  • A - ADJUSTEDCHARGEBACK

  • AD - ADJUSTMENT

  • BAP - TOTALDUE

  • CC - CHARGEBACKCLAIM

  • CE - SUMMARY

  • CH - CHANGE

  • CM - CLAIMANTREQUESTEDTOTAL

  • CQ - NETCLAIM

  • F7 - SALESTAX

  • NA - NETADJUSTMENT

  • PB - TOTAL

  • S - SUBMITTEDCHARGEBACK

  • T - TAX

  • TK - CONTRACT

  • TP - TOTALPAYMENT

  • TS - TOTALSALES

  • TT - TOTALTRANSACTION

  • Z3 - ITEMDISCREPANCYUNITCOST

 TOT
      AMT02 1…1 1/18 Required. Monetary amount. 275.36
      AMT03 0…1 1/1

Credit or debit flag code indicating whether the amount is a credit or a debit.

Valid values:

  • C - Credit

  • D - Debit

 D
    QTY 0…* - Original transaction quantity for which 824 is being generated Notes: which will be used to uniquely identify original transaction in sender system. -
      QTY01 1…1 2/2

Required. Type of quantity recorded. Most likely it will be Total.

  • 01 - Discrete quantity
  • 02 - Cumulative quantity
  • 05 - Quantity in hold status
  • 07 - Rejected quantity
  • 14 - Outstanding quantity
  • 17 – Quantity on hand for sale
  • 20 - Unusable quantity
  • 21 – Short shipped quantity
  • 32 - Quantity Sold
  • 39 - Shipped quantity
  • 41 - Number of batches
  • 45 - Order quantity
  • 57 - Minimum quantity per order
  • 63 – Quantity on order
  • 76 – Returned quantity
  • 81 – Quantity of paid shipment
  • 83 - Submitted Quantity Sold
  • 84 - Submitted Quantity Returned
  • 87 – Received quantity
  • 123 – Surplus quantity above order or agreement
  • AJ - Daily Adjustments
  • 7G - Replaced quantity
  • H8 – Quantity allocated
  • R1 - Replenishment quantity
  • QV – Delivery, Gross, Hold
  • QW - Quantity withdrawn
  • QD – Quantity delivered
  • KA – Estimate quantity
  • X2 - Gross quantity
  • NV - Net quantity
  • QH - Quantity on hold for quality
  • H3 - Released quantity
 TO
      QTY02 0…1 1/15 Required. Quantity of product. 25.00
      QTY03.1 1…1 2/2

Required. Unit of measure used for pricing.

  • 02 – Statute Mile
  • 4G – Microliter
  • AM – Ampoule
  • AV – Capsule
  • BD – Bundle
  • BG – Bag
  • BO – Bottle
  • BX – Box
  • C3 – Centiliter
  • CA – Case
  • CC – Cubic Centimeter
  • CF – Cubic Feet
  • CG – Card, Blister
  • CI – Cubic Inches
  • CL – Cylinder
  • CM – Centimeter
  • CN – Can
  • CP – Crate
  • CQ – Cartridge
  • CR – Cubic Meters
  • CT – Carton
  • DA – Day
  • DI – Dispenser
  • DK – Kilometers
  • DL – Deciliter
  • DM – Decimeter
  • DR – Drum
  • DS – Display
  • DZ – Dozen
  • EA – Each
  • FO – Fluid Ounce
  • FT – Foot
  • GA – Gallon
  • GL – Gram/liter
  • GR – Gram
  • GS – Gross
  • H4 – Hectoliter
  • HF – Hundred Feet
  • HR – Hours
  • IN – Inch
  • K6 – Kiloliters
  • KG – Kilogram
  • KT – Kit
  • LB – Pounds
  • LF – Linear Foot
  • LO – Lot (unit of procurement)
  • LT – Liter
  • LY – Linear Yard
  • MC – Microgram
  • ME – Milligram
  • ML – Milliliter
  • MM – Millimeter
  • MO – Months
  • MR – Meter
  • OZ – Ounces
  • PC – Piece
  • PF – Pallet
  • PK – Package
  • PR – Pair
  • PT – Pint
  • QT – Quart
  • RL – Roll
  • SC – Square Centimeter
  • SF – Square Foot
  • SH – Sheet
  • SI – Square Inch
  • SM – Square Meter
  • ST – Set
  • SY – Square Yard
  • T3 – Thousand Pieces
  • TB – Tube
  • TH – Thousand
  • TY – Tray
  • U2 – Tablet
  • UM – Million
  • UN – Unit
  • V2 – Pouch
  • VI – Vial
  • WK – Week
  • YD – Yard
  • YR – Years
 UN
    TED Loop 0…* - Technical error and business error details. -
      TED 0…1 - TED Technical Error Description segment. Identifies the error in the original 856 ASN being reported on. Can also identify the segment and/or data element where the error occurred in the original transaction. Child of OTI loop. -
        TED01 1…1 1/3

Required. Application error condition code describing the error condition in the original transaction.

  • 005 – Route Error
  • 006 – Duplicate
  • 007 – Missing Data
  • 009 – Invalid Date
  • 010 – Total Out of Balance
  • 024 – Other Unlisted Reason. The reason for the application error condition cannot be described using any other code on the standard code list
  • 026 – Customer Identification Number is Invalid
  • 029 – Customer Identification Number Is Missing
  • 036 – Invalid Serial Number
  • 101 – Effective Date Too Early
  • 102 – Improper Placement of Labels
  • 104 – Item Already Exists
  • 105 – Item Marked For Delete
  • 107 – Missing or Invalid Location
  • 108 – Location Received Not On Order
  • 110 – Missing Marking Identification at Pack Level
  • 111 – Duplicate Purchase Order Number
  • 119 – Duplicate Shipment Identification Number
  • 120 – Ship-To Location Not Consistent With Purchase Order Ship-To
  • 121 – Duplicate SSCC (formerly known as Serial Shipping Container Code)
  • 122 – Invalid SSCC (formerly known as Serial Shipping Container Code) Range
  • 124 – Missing Marking Identification at Tare Level
  • 126 – Incorrect Label Format
  • 128 – Missing Labels on Shipping Container
  • 133 – Item Not Found On Purchase Order
  • 139 – Missing or Invalid Vendor Pack Quantity
  • 140 – Missing or Invalid Ship-To Location
  • 141 – Purchase Order Cancelled
  • 812 – Missing Transaction Reference or Trace Number
  • 815 – Duplicate Batch
  • 817 – Duplicate Trace Number
  • 818 – Missing Control Totals
  • 819 – Control Totals Amount Error
  • 820 – Control Totals Count Error
  • B – Missing or Invalid Physical Inventory Code
  • C – Missing or Invalid Consignee
  • DBL – Duplicate Bill of Lading Number. Carrier has reused a shippers authorization number assigned to another shipment
  • DDT – Departure Date Invalid. The move/service date precedes the authorized date
  • DRC – Duplicate Railcar Departure. The railcar reported has a conflicting previous departure on the same date.
  • DTE – Incorrect Date. The reported date is incorrect (e.g. premature date for transaction or non-existent date such as February 30).
  • DUP – Duplicate Transaction. The identical transaction has been transmitted more than once within the same input file.
  • E – Missing or Invalid Material Condition Code
  • HUG – Quantity of Handling Units Shipped Greater Than the Quantity Specified
  • HUL – Quantity of Handling Units Shipped Less Than the Quantity Specified
  • IDN – Invalid Department Number
  • IID – Invalid Identification Code
  • IMD – Invalid Railcar Type. The Equipment Description Code (DE40) reported is invalid.
  • INC – Incomplete Transaction. Optional Element(s) required by the application are missing.
  • IQT – Invalid Quantity
  • IWT – Invalid Weight
  • MA – Missing or Invalid Store Number
  • MB – Missing or Invalid Purchase Order Number
  • MBL – Multiple Bills of Lading. Multiple Bills of Lading have been transmitted for a 3 for 2 shipment (only one bill of lading is required).
  • MC – Missing or Invalid Bill of Lading Number
  • ME – Missing or Invalid Department Number
  • MF – Missing or Invalid Internal Vendor Number
  • MG – Missing or Invalid U.P.C. Code
  • MH – Missing or Invalid DUNS Number
  • MI – Missing or Invalid SCAC
  • MID – Missing Identification Code
  • MJ – Missing or Invalid Terms
  • MK – Missing or Invalid Ship Date Location
  • ML – Missing or Invalid Sell to Location
  • MM – Missing or Invalid Bill to Location
  • MN – Missing or Invalid Unit Cost
  • MQT – Missing Quantity
  • MR – Missing GTIN (Global Trade Item Number)
  • MS – Invalid GTIN (Global Trade Item Number)
  • MT – Missing GLN (Global Location Number)
  • MU – Invalid GLN (Global Location Number)
  • MWT – Missing Weight
  • N – Missing or Invalid Payer Identification
  • NAU – Not Authorized. The move/service reported by the carrier has not been authorized by the shipper.
  • NCL – No Clearance Authorization. The vessel clearance reported by the carrier has not been authorized by the shipper.
  • NCR – No Clearance Reported. The freight bill submitted by the carrier precedes the vessel clearance.
  • NIF – Invalid Status Location. The location reported with the Status Code (DE1094) does not match any move/service locations authorized by the shipper.
  • NRA – No Railcar Arrival. A subsequent shipper authorized move/service has been reported prior to reported arrival of a railcar.
  • NRS – Product is Not in the Receiver's System
  • O – Missing or Invalid Issuer Identification
  • OTH – Other
  • P – Missing or Invalid Item Quantity
  • POI – Purchase Order Number Invalid
  • Q – Missing or Invalid Item Identification
  • QTY – Quantity. The number of items on the freight bill/invoice/waybill does not equal the number of unique segments which specifically identify those items.
  • RTE – Invalid Shipper's Route Code. The shippers route code reported by the carrier is invalid.
  • S – Missing or Unauthorized Transportation Mode/Method Code
  • SCA – Invalid SCAC. The Standard Carrier Alpha Code (DE140) reported is invalid.
  • U – Missing or Unauthorized Transaction Type Code
  • UNP – Invalid Unit Price
  • W – Outside Ship Window
  • ZZZ – Mutually Defined
 024
        TED02 0…1 1/60 Free-form Message. Short description of the error for the error code used in TED01, and in conjunction with the long description listed in the NTE02. Item Status (I)nactive ITEM = 000586765 VENDOR = 67345205
        TED03 0…1 2/3 Segment ID Code. Identifies segment in original transaction that triggered an error. BTS
        TED04 0…1 0/10 Segment Position in Transaction Set. The numerical count position of this data segment from the start of the transaction set: the transaction set header is count position 1. 3
        TED05 0…1 - If TED05 present TED05.1 is Required -
          TED05.1 1...1 0/2

Required. Position in Segment. Code indicating the relative position of the error data element within a segment, count beginning with 1 for position immediately after the segment ID. Also indicates:

  • 1. Relative position of a repeating structure in error, beginning with 1 for the position immediately after the preceding element separator.

  • 2. 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.

 3
          TED05.2 0...1 0/2 Component Data Element Position in Composite. 13
          TED05.3 0...1 0/4 Repeating Data Element Position. 373
        TED07 0…1 1/99 Copy of the bad data element. Data from the data element that is in error. 000586765
      NTE 0…100 - NTE Note/Special Instruction loop. Child of TED. -
        NTE01 0...1 '3/3 Note Reference Code. -
        NTE02 1...1 1/80 Required. Description. A free-form description to clarify related data elements and their content. Used as the long description for the error code in TED01, and in conjunction with the short description in TED03. Item Status (I)nactive ITEM = 000586765 VENDOR = 67345205
      RED 0…100 - To provide business data related to an item within a transaction to which a business application editing process has been applied, and an error condition has resulted. -
        RED01 1...1 1/80 Required. Represents the actual business value or Error descriptive information, being referenced or cited in connection with a validation message or application result. This value indicates which specific field or transaction content is associated with the reported condition. NA
        RED02 0...1 2/3 Identifies the nature or classification of the business data referenced due to a validation or application edit result. The value corresponds to standardized codes (e.g., PO Number, Unit Price, GTIN, Quantity). Only one code is allowed and at least one must be present when reporting referenced business data PO
        RED03 0...1 2/2 Agency Qualifier Code. 94
        RED05 0...1 1/3 Code List Qualifier Code. IBP
        RED06 0...1 1/30 Industry Code. W050
SE 1…1 - Required. ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. -
  SE01 1…1 1/10 Required. Total count of segments in ST … SE transaction set including ST and SE segments. 10
  SE02 1…1 4/9 Required. Transaction set control number. 0001
GE 1…1 - Required. GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. -
  GE01 1…1 1/6 Required. Number of transaction sets in functional group. 5
  GE02 1…1 1/9 Required. Functional group control number. 619827
IEA 1…1 - Required. ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. -
  IEA01 1…1 1/5 Required. Number of functional groups in interchange. 1
  IEA02 1…1 9/9 Required. Interchange control number. 0000000000619827 
ISA*00*          *00*          *07*7777776067344  *01*888888404358877*250612*1332*<*00501*000619827*0*P*:~
GS*IO*2222224043588*TRACELINK*20250611*142000*619827*X*00501~
ST*312*0001~
BGN*00*8475*20251202*123222~
N1*CA*business_name1*1*s333~
N2*s27*s28~
N2*s20*s38~
N3*s334*s335~
N3*s20*s38~
N4*s336*s3*s338*US*CA*95833*US~
REF*SI*123*description1~
REF*TD*123*description3~
PER*IC*Grame Smith*TE*897654*EM*gsmith@gmail.com~
PER*FC*Grame Smith*TE*897654~
N1*SU*business_name2*2*s76~
N2*s27*s28~
N2*s45*s55~
N3*s77*s78~
N4*s79*s8*s81*US*CA*95834*US~
REF*CT*123*description1~
PER*IC*Grame Smith*EM*gsmith@gmail.com*TE*897654~
PER*RP*Grame Smith*EM*gsmith@gmail.com~
N1*ST*business_name3*9*s65~
N2*s10*s28~
N3*s66*s67~
N3*s20*s38~
N4*s68*s6*s70*US*CA*95836*US~
REF*SI*123*description1~
REF*CT*123*description2~
REF*TD*123*description3~
PER*IC*Grame Smith*TE*897654*EM*gsmith@gmail.com~
OTI*TA*IB*0001*1234*1212*20251202*123222*52*SCAC*100~
REF*SI*123*description1~
REF*AG*123*description2~
REF*TD*123*description3~
DTM*133*20251202*123222*03*D8~
DTM*372*20251202*12322211*03*DT~
AMT*A*62*D~
AMT*CH*62*C~
QTY*H8*65*EA~
QTY*QV*65*EA~
TED*B*s68*s69*70*71:72:73**s74~
NTE*BFD*s76~
NTE*BFD*s76~
NTE*BFD*s76~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
TED*B*s68*s69*70*71:72:73**s74~
NTE*BFD*s76~
NTE*BFD*s76~
NTE*BFD*s76~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
OTI*BA*IB*0001*1234*1212*20251202*123222*52*SCAC*100~
REF*SI*123*description1~
REF*AG*123*description2~
REF*TD*123*description3~
DTM*133*20251202*123222*03*D8~
DTM*372*20251202*12322211*03*DT~
AMT*A*62*D~
AMT*CH*62*C~
QTY*H8*65*EA~
QTY*QV*65*EA~
TED*MA*s68*s69*70*71:72:73**s74~
NTE*BFD*s76~
NTE*BFD*s76~
NTE*BFD*s76~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
TED*MB*s68*s69*70*71:72:73**s74~
NTE*BFD*s76~
NTE*BFD*s76~
NTE*BFD*s76~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
RED*s77*PR*CX**BN*s81~
SE*82*s83s~
GE*84*85~
IEA*86*s87ssssss~
Review TraceLink's API: Terms of Use

Table of contents