Skip to main content
Home
  • AI Mode
  • Supply Chain Orchestration
    fast
    Supply Chain Orchestration
    • Life Sciences Company
    • Direct Material Supplier
    • Contract Manufacturer
    • Third Party Logistics
    • Wholesale Distributor
    • Healthcare Provider
    • Retail Pharmacy
  • Network
  • Products
    fast
    Products
    • Multienterprise Information Network Tower (MINT)
    • Process Orchestration for Empowered Teams (POET)
    • Track-and-Trace
  • Resources
    fast
    Resources
    • Resource Center
    • TraceLink University
    • Partners
    • Community
    • Events
  • About
    fast
    About
    • Our Story
    • Newsroom
    • Culture and Careers
    • Leadership
    • Our Values
    • Corporate Social Responsibility
    • Contact Sales
  • Log In
    • Tracelink Classic
      TraceLink Classic app.tracelink.com
      Redirect
    • Opus Platform
      Opus Platform opus.tracelink.com
      Redirect
Log In
  • Tracelink Classic
    TraceLink Classic app.tracelink.com
    Redirect
  • Opus Platform
    Opus Platform opus.tracelink.com
    Redirect
Tracelink University

Breadcrumb

  1. Home
  2. Resources
  3. TraceLink University

Text message (X12)

  • Download PDF
  • Share
    • LinkedIn
    • Facebook
    • Mail
    • Twitter

Table of contents

The Text message transaction enables trading partners to exchange free-form, human-readable messages directly through standard EDI channels. Unlike transactional EDI messages that require structured data for system processing, the text message is designed for non-transactional communication such as instructions, clarifications, alerts, or one-time announcements that benefit from being shared within the EDI framework but do not need to trigger system actions.

The text message is exchanged asynchronously through standard EDI channels in X12 format and typically appears in EDI inboxes or line-of-business systems that support message viewing.

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

  • Message Type: MPC_TEXT_MESSAGE
  • X12 Format: TEXTMESSAGE
  • Transform Names:

    • B2B_EDI_X12_864_TextMessage_IB_V1

    • B2B_EDI_X12_864_TextMessage_OB_V1

ClosedGuidelines
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.

ClosedValid values:
  • 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.

ClosedValid values:
  • 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. 250615
  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 acknowledgement 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 TX - Text Message X12 864

TX
  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. 20250615
  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. 864
  ST02 1…1 4/9 Required. Transaction set ID number. Counter for each ST segment beginning with 1. 0001
  BMG 1…1 - Required. Text Message beginning segment. -
    BMG01 1…1 2/2

Required. Transaction set purpose code.

ClosedValid values:
  • 00 – Used when no specific purpose is needed
  • 01 – Cancel the request
  • 02 – Create a request
  • 03 – Request to be deleted
  • 04 – Request to be changed
  • 05 – Request to be replaced
  • 06 – Request to be confirmed
  • 08 – Current status of request
  • 11 – Response against any request
  • 18 – Request to be reissued
00
    BMG02 0…1 1/80 Description about the text message or purpose of text message. Purchase Order change
    BMG03 0…1 2/2

Code specifying the type of transaction document supporting the message.

 

ClosedValid values
  • 03 – A human-readable report intended to be put on paper
  • 04 – A free-form, human-readable message intended for an electronic mail system
  • 33 – Conforms to normal practice
  • 74 – HDA. Amendment.
  • 6S – HDA. A credit or debit is issued incrementally against one adjustment memo, ie, returns processed separately for scheduled or non-scheduled drugs.
  • CA - Cash
  • CG - HDA. Consolidated credit memo. The invoice is a consolidated memo and all actual billing invoices are summarized by this consolidated memo
  • CR - Credit memo
  • DO - HDA. Drop ship invoice correlates the credit or debit with a previously issued drop ship invoice.
  • DR - Debit memo
  • PP - Prepaid invoice

 

03
  DTM 0…10 - Dates relevant to location events, provision given to map to EDIFACT data. -
    DTM01 1…1 3/3

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

ClosedValid values:
  • 002 - Delivery requested by date

  • 003 - Invoice date

  • 004 - Purchase order date

  • 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)

  • 058 - Customs Clearance date

  • 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

  • 092 - Contract effective date

  • 093 - Contract expiration date

  • 094 - Manufacturing date

  • 097 - Transactional date creation

  • 102 - Date goods issue posted

  • 133 - Account receivable date

  • 139 - Estimated

  • 140 - Actual date

  • 146 - Closing date

  • 161 - Loaded on vessel 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

  • 369 - Estimated Departure Date

  • 370 - Actual Departure date

  • 371 - Estimated Arrival date

  • 372 - Actual arrival date

  • 472 - Date services rendered

  • 510 - Date packed

  • 512 - Warranty date

  • 514 - Transfer date

  • 649 - Document due date

  • 813 - Customs entry date

  • 814 - Payment due date

  • 922 - Date of original receipt

  • 938 - Order date

  • 964 - Billing date

  • 999 - Document date

  • AAG - Due date

  • VLU - Validity date

069
    DTM02 0…1 8/8 Date defined by referenced date type in date format YYYY-MM-DD. Transform will pass thru whatever it finds in IDoc date and time fields. 20241215
    DTM03 0…1 4/8 Time expressed in 24-hour clock time as follows. 161025
    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.

ClosedValid values:
  • D6 - YYMMDD

  • D8 - CCYYMMDD

  • DD - DAYOFMONTH

  • DT - CCYYMMDDHHMM

  • MD - MMDD

  • T - MMDDYY

  • TM - HHMM

  • TQ - MMYY

  • TS - HHMMSS

  • TT - MMDDYY

  • YM - YYMM

DT
    DTM06 0…1 1/35 Describes the date format, time format, or date and time period. -
  N1 0…200 - Required. N1 segment loop at header for party address and location information. -
    N101 1…1 2/3

Required. Entity qualifier for the Customer or Buyer party identifier and address information.

ClosedValid values:
  • AO – Account holder business information
  • BK - Party creating shipment booking
  • BO – Booking office
  • BS – Billto and Shipto combined
  • BT – Billto party
  • BY – Customer or Buyer
  • CA – Carrier (transport operator)
  • CI – Consignor
  • CN – Consignee
  • CL – Container pickup party
  • C9 – Contract holder (depends on context)
  • DA – Delivery address / party
  • DT – Destination terminal
  • D1 – Truck driver (no EDI qualifier, contextbased)
  • EX - Exporter
  • FR - Message sender
  • FP - Credit Card Holder Business Information
  • FW - Freight forwarder
  • MF - Manufacturer
  • NP - Notify party
  • N1 - First notify party
  • N2 - Second notify party
  • OB - Ordered by party
  • OT - Origin inland terminal
  • PR - Freight payer
  • PW - Pickup location
  • RO - Origin intermodal ramp
  • RD - Destination intermodal ramp
  • R6 - Booking requester (may be consignee / shipper as well)
  • SF - Shipfrom location
  • SH - Shipper
  • ST - Shipto location
  • SU - Supplier
  • TO - Message receiver
  • UC - Ultimate customer / end user
  • VN - Vendor (alt. seller)
  • WH - Warehouse
SU
    N102 0…1 1/60 Required. Name Pharma customer
    N103 0…1 1/2

Required. Identifier code qualifier.

Valid values:

  • 1 - DUNS

  • 2 - SCAC

  • 9 - DUNS+4

  • 11 - Drug Enforcement Agency registration number

  • 21 - Health Industry Number

  • 25 - Carrier customer code

  • 91 - Company identifier

  • 92 - Company location identifier

  • 93 - Transaction set sender

  • 94 - Transaction set receiver

  • UL - Global Location Number

  • PI - US_340B_ID

  • PP - Pharmacy_Processor_Number

UL
    N104 0…1 2/80 Required. Buyer party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655
    N3 0…1 - N3: Address: Child of customer party N1 name 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 customer party N1 name 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 - REF segment to specify instructions for business relationship or a reference number. -
      REF01 1…1 2/3

Required. Code qualifying the Reference Identification.

ClosedValid values:
  • 14 - Master account
  • 016 - Preceding document
  • 48 - Payment transaction identifier
  • 1O - Consolidated Shipment Number
  • 2I - Tracking number
  • A3 - Assignment
  • BAF – Receipt number
  • BC – Customer contract number
  • BM – Bill of lading
  • BT – Batch
  • CD – Credit advice
  • CG – Consignee order number
  • CK – Check number
  • CM – Credit memo
  • CN – Carrier reference
  • CR - Customer reference identifier
  • CT – Contract number
  • D1 – US Drug Enforcement Agency (DEA) order number
  • DM – Document number
  • DI – Distributor invoice number
  • DL – Debit memo
  • DO – Delivery
  • EM – Electronic payment
  • GK - Third party reference identifier
  • IV – Seller's invoice
  • K9 – Customer inquiry number
  • LT – Lot number
  • MB – Master bill of lading
  • OI – Original invoice
  • OQ – Order number
  • PK – Packing list number
  • PO – Purchase order number
  • Q1 – Supplier quotation number
  • RE – Release document number
  • RZ - Return authorization transaction identifier type
  • SI – Shipment number
  • SN – Seal number
  • TB – Trucker's Bill of Lading
  • TN – Transaction reference number
  • VC – Supplier contract number
  • VN – Supplier order number
  • WO – Work order (production order) number
  • WY – Work bill number
PO
      REF02 0…1 1/80 Required. Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier. 45892345
      REF03 0…1 1/80 A free-form description to clarify the related data elements and their content. -
    PER 0…3 - Contact Information. -
      PER01 1…1 2/2

Required. Contact function code identifying major duty or responsibility of person or group named as contact.

Valid value:

  • IC - Information contact

  • FC - Forwarder contact

IC
      PER02 0…1 1/60 Required. Name of the contact person responsible for authenticating the pedigree information. John Smith
      PER03 0…1 2/2

Communication Number Qualifier identifying the contact person's telephone number or email address.

Valid values:

  • TE - Telephone number

  • EM - email address

TE
      PER04 0…1 1/2048

Communication number:

  • Telephone number of the contact person expected in this field.

  • Email address of the contact person.

+1.516.747.6849
      PER05 0…1 2/2

Communication Number Qualifier identifying the contact person's telephone number or email address.

Valid values:

  • TE - Telephone number

  • EM - email address

EM
      PER06 0…1 1/2048

Communication number:

  • Email address for the contact person expected in this field.

  • Telephone number of the contact person.

jsmith@manufac.com
  MIT 1…* - Required. Line item loop start for text message, referring a line number in a transaction set. -
    MIT01 1…1 1/80 Required. Transaction reference identifier value or message number as defined by enum in transactionReferenceType. ABCD4567321
    MIT02 0…1 1/80 Description about the text message or purpose of text message. Purchase Order change
    MIT03 0…1 1/3 Maximum number of characters per line, expected in the message text. 20
    MIT04 0…1 1/3 Maximum number of lines per page, expected in the message text. 105
    N1 0…200 - Required. N1 segment loop at line item for party address and location information. -
      N101 1…1 2/3

Required. Entity qualifier for the Customer or Buyer party identifier and address information.

Closed Valid values:
  • AO – Account holder business information
  • BK - Party creating shipment booking
  • BS – Billto and Shipto combined
  • BT – Billto party
  • BY – Customer or Buyer
  • CA – Carrier (transport operator)
  • CI – Consignor
  • CN – Consignee
  • CL – Container pickup party
  • C9 – Contract holder (depends on context)
  • DA – Delivery address / party
  • DT – Destination terminal
  • D1 – Truck driver (no EDI qualifier, contextbased)
  • EX - Exporter
  • FR - Message sender
  • FP - Credit Card Holder Business Information
  • FW - Freight forwarder
  • MF - Manufacturer
  • NP - Notify party
  • N1 - First notify party
  • N2 - Second notify party
  • OB - Ordered by party
  • OT - Origin inland terminal
  • PR - Freight payer
  • PW - Pickup location
  • RO - Origin intermodal ramp
  • RD - Destination intermodal ramp
  • R6 - Booking requester (may be consignee / shipper as well)
  • SF - Shipfrom location
  • SH - Shipper
  • ST - Shipto location
  • SU - Supplier
  • TO - Message receiver
  • UC - Ultimate customer / end user
  • VN - Vendor (alt. seller)
  • WH - Warehouse
SU
      N102 0…1 1/60 Required. Name Pharma customer
      N103 0…1 1/2

Required. Identifier code qualifier.

Valid values:

  • 1 - DUNS

  • 2 - SCAC

  • 9 - DUNS+4

  • 11 - Drug Enforcement Agency registration number

  • 21 - Health Industry Number

  • 25 - Carrier customer code

  • 91 - Company identifier

  • 92 - Company location identifier

  • 93 - Transaction set sender

  • 94 - Transaction set receiver

  • UL - Global Location Number

  • PI - US_340B_ID

  • PP - Pharmacy_Processor_Number

UL
      N104 0…1 2/80 Required. Buyer party identifier as qualified by N103 mapping to companyIdentifierValue. 3333331013655
      N3 0…1 - N3: Address: Child of customer party N1 name 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 customer party N1 name 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 - REF segment to specify instructions for business relationship or a reference number. -
        REF01 1…1 2/3

Required. Code qualifying the Reference Identification.

ClosedValid values:
  • 14 - Master account

  • 2I - Tracking number

  • A3 - Assignment

  • BT - Batch
  • BM - Bill of lading
  • BAF - Receipt number

  • BC - Customer contract number

  • CD - Credit advice

  • CK - Check number

  • CM - Credit memo

  • CN - Carrier reference

  • 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

PO
        REF02 0…1 1/80 Required. Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier. 45892345
        REF03 0…1 1/80 A free-form description to clarify the related data elements and their content. -
      PER 0…3 - Contact Information. -
        PER01 1…1 2/2

Required. Contact function code identifying major duty or responsibility of person or group named as contact.

Valid value:

  • IC - Information contact

  • FC - Forwarder contact

IC
        PER02 0…1 1/60 Required. Name of the contact person responsible for authenticating the pedigree information. John Smith
        PER03 0…1 2/2

Communication Number Qualifier identifying the contact person's telephone number or email address.

Valid value:

  • TE - Telephone number

  • EM - email address

TE
        PER04 0…1 1/2048

Communication number

  • Telephone number of the contact person expected in this field.

  • Email address of the contact person.

+1.516.747.6849
        PER05 0…1 2/2

Communication Number Qualifier identifying the contact person's telephone number or email address.

Valid value:

  • TE - Telephone number

  • EM - email address

EM
        PER06 0…1 1/2048

Communication number:

  • Email address for the contact person expected in this field.

  • Telephone number of the contact person.

jsmith@manufac.com
    MSG 0…* - To provide a free-form format that allows the transmission of text information. -
      MSG01 1…1 1/264 Required. Free-form message text ABCD4567321
      MSG02 0…1 2/2 A field to be used for the control of the line feed of the receiving printer. SS
      MSG03 0…1 1/9 A generic number. -
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
ClosedExample
ISA*00*ISA0210100*00*ISA0410100*07*7777776067344  *01*888888404358877*250612*1332*U*00401*000619827*0*P*:~
GS*IO*2222224043588*TRACELINK*20250611*142000*619827*X*004010~
ST*864*0001~
BMG*00*Purchase Order change*03~
DTM*069*20251202*141140*ES*DT*test~
N1*SU*SU_name*UL*SU_123~
N3*Address1_SU*Address2_SU~
N4*city_SU*MP*909090*IND*CA*97533*US~
REF*SI*SI_Value*SI_desc~
PER*IC*IC_name*EM*Email@gmail.com*TE*1234548~
MIT*ABCD4567321*Purchase Order change*20*105~
N1*CA*CA_name*UL*BY_1256~
N3*Address1_CA*Address2_CA~
N4*CityCA*CA*CA_12361*IND*SB*84*US~
REF*SI*SI_Value*descPO~
PER*IC*IC_1270*EM*email@yahoo.com*TE*1234574~
MSG*ABC*AA*12~
SE*206*s207~
GE*208*209~
IEA*210*s211sssss~
Review TraceLink's API: Terms of Use

Table of contents

Related Content
Related content
Forecast plan (IDoc)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record.
View More
Related content
Forecast plan (X12)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record.
View More
Related content
Forecast plan response (IDoc)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record.
View More

Cookie Settings

When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies or similar tracking technologies. Please see below for an overview of the categories of cookies and similar technologies used on this site. You can allow or deny some of all of them, except Strictly Necessary Cookies which are required to provide the site to you. However, blocking some types of cookies may impact your experience of the site and services we are able to offer.

Please see our Cookie Policy for more details, including a list of the cookies we use. You can change your consent options at any time by following the “Cookie Settings” link in the Cookie Policy.
'Strictly Necessary' cookies let you move around the Site and use essential features like secure areas, shopping baskets and online billing. Without these cookies you would not be able to navigate between pages or use certain vital features of our Site, so we do not require your consent for their use. These cookies don't gather any information about you that could be used for marketing or remembering where you've been on the internet. For example, we use these Strictly Necessary cookies to identify you as being logged in to the Site. You can set your browser to block or alert you about these cookies, but if you do so, some parts of the Site will not work.
'Performance' cookies collect information about how you use the Site, such as which pages you visit, the time spent on the Site and if you experience any errors. We use performance cookies to provide aggregated statistics on how the Site is used and help us improve the Site including by measuring any errors that occur.
'Functional' cookies are used to provide services or to remember settings to improve your visit. We use 'Functionality' cookies to remember your settings and choices and show you when you're logged in to the Site.
‘Targeting' cookies are linked to services provided by third parties, such as 'Like' buttons and 'Share' buttons. The third party provides these services in return for recognizing that you have visited the Site. We also use 'Targeting' cookies to gather information that could be used to display content that we think may interest you.

Footer

  • Quick Links
    Get a Demo
    TraceLink Network Directory
    The Network
    OPUS Platform
    Technical Support
    Open Jobs
    API: Terms of Use
  • Products
    Multienterprise Information Network Tower
    U.S. DSCSA Compliance
    Targeted Recalls
    Process Orchestration for Empowered Teams
    Serialization
    Global Compliance
  • Resources
    Resource Center
    Events
    TraceLink University
    Partners
    Community
  • About TraceLink
    Our Story
    Newsroom
    Culture & Careers
    Leadership
    Our Values
    Corporate Social Responsibility
  • Hot Topics
    Transaction Integration
    Supply Chain Visibility
    DSCSA Compliance
    Process Orchestration
    Kazakhstan Compliance for Pharmaceuticals
    Kyrgyzstan Compliance for Pharmaceuticals
Follow Us on Social
Facebook
Linkedin
X
Legal & Trust.
© TraceLink Inc. 2009-2026 All Rights Reserved
Contact Us Today
Contact us today to begin your journey toward agentic supply chain orchestration — digitalize your end-to-end supply chain with intelligence, flexibility, and collaborative orchestration.
Contact Us
Stay Up-to-Date
Subscribe to receive industry insights and stay at the forefront of evolving trends.
Subscribe