  

 

Tracelink University

 ## Breadcrumb

1. [Home](/)
2. [Resources](/resources/resource-center)
3. [TraceLink University](/resources/tracelink-university)
 
  

 

 

# Text message (X12)

 

 

 

 

 

 

 

 

- [Download PDF](/node/627871/pdf)
- [Share](#)
    - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/text-message-x12&title=Text message (X12)&summary=The Text message transaction enables trading partners to exchange free-form, human-readable messages directly through standard EDI channels. &source=TraceLink "LinkedIn")
    - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/text-message-x12&t=Text message (X12) "Facebook")
    - [ Mail ](mailto:?subject=Text message (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/text-message-x12 "Mail")
    - [ Twitter ](https://twitter.com/intent/tweet?text=Text message (X12) https://www.tracelink.com/resources/tracelink-university/text-message-x12&via=TraceLink "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.

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) 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

 
[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#)             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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `01` – Duns (Dun &amp; 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `01` – Duns (Dun &amp; 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. &gt;   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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif) 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.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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    

 

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```plaintext
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~
```

 

 

 

 

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use)



 

 

 

 

#### Table of contents

 

 

 

 

 

 



 

##### Related Content

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) 

#####  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](/resources/tracelink-university/forecast-plan-idoc) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) 

#####  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](/resources/tracelink-university/forecast-plan-x12) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) 

#####  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](/resources/tracelink-university/forecast-plan-response-idoc)