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

Purchase orders (X12)

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

Table of contents

Purchase orders allow companies to exchange data about requests to purchase goods and services with upstream and downstream supply chain trade partners without giving these trade partners access to their serialization system of record. These purchase orders can be used to request specific products and quantities from their Partners and confirm that partners have the requested product and quantities on hand and intend to fulfill the request via a purchase order acknowledgment.

The Purchase Orders (POs) X12 850 message sends a request and commitment from the buyer to pay the seller for the sale of specific products or services to be delivered in the future.

These guidelines are unofficial and may not necessarily list all message formatting and element requirements. Contact your TraceLink Services representative for more information about integrating with this message.

  • Message Type: MPC_PURCHASE_ORDER (Purchase Order)
  • X12 Transaction: 850
  • Transform Names:
    • B2B_EDI_X12_850_PurchaseOrder_IB_V8
    • B2B_EDI_X12_850_PurchaseOrder_OB_V9

ClosedGuidelines
Input Element Occurs Length Description Example
ISA 1…1 - ISA interchange envelope. -
  ISA01 1…1 2/2

Qualifier for authorization control number in ISA02.

Valid values:

  • 00 - No authorization info present. TL: Read ServiceLinkId from GS segment

  • 03 - Additional data identification. TL: Read ServiceLinkId from REF segment in HL level shipment WHERE REF01 = ME.

NOAUTHORIZATION
  ISA02 1…1 10/10 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

Qualifier for security information in ISA04.

Valid values:

  • 00 - No security information present

  • 01 - Password

NOSECURITY
  ISA04 1…1 10/10 Identifies security information about the interchange sender or data. -
  ISA05 1…1 2/2

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.
GLN
  ISA06 1…1 15/15

EDI sender ID mapping to:

  • file control header and to ServiceLinkId

  • Interchange control group header

  • interchange sender identification mapping to linkIdentifier

GLN:7777776067344
  ISA07 1…1 2/2

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.
GLN
  ISA08 1…1 15/15 EDI receiver ID mapping to file control header. GLN:888888404358877
  ISA08 - - EDI receiver ID mapping to file control header. '888888404358877
  ISA09 1…1 6/6 Interchange date in 6 char YYMMDD format. 2023-10-20T14:20:00.000Z
  ISA10 1…1 4/4 Interchange time in 4 char HHMM format. -
  ISA11 1…1 1/1 Repetition separator. Delimiter that separates repeated occurrences of a data element or composite data structure. Must be different than the data element separator, component separator, and segment terminator. :
  ISA12 1…1 5/5 Interchange control version number. Valid value is “00401” 00501
  ISA13 1…1 9/9 Interchange Control Number for file control header. 0000000000619827
  ISA14 1…1 1/1

Interchange level acknowledgment requested.

Valid values:

  • 0 - No acknowledgment requested

  • 1 - Interchange level acknowledgment requested

false
  ISA15 1…1 1/1

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

Valid values:

  • I - Information

  • P - Production data

  • T - Test data

PRODUCTION
  ISA16 1…1 1/1 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…1 - GS group functional envelope. Child of ISA. Only one GS group expected per interchange. -
  GS01 1…1 2/2 GS group function code. Valid value is SH - Shipment. -
  GS02 1…1 2/15 Application Sender's Code. 2222224043588
  GS03 1…1 2/15 Application Receiver's Code. TRACELINK
  GS04 1…1 8/8 Current date stamp in 8 char X12 date format YYYYMMDD. 2023-10-20
  GS05 1…1 4/8 Current time stamp in 6 char X12 time format HHMMSS. 142000
  GS06 1…1 1/9 Group Control ID Number. 619827
  GS07 1…1 1/2 Responsible Agency Code. Valid value is X X
  GS08 1…1 1/12 X12 message version code. Valid value is 004010 005010
ST 1…* - ST transaction set envelope. Child of GS group. Only one ST transaction expected. -
  ST01 1…1 3/3 Transaction set identifier code. -
  ST02 1…1 4/9 Transaction set ID number. Counter for each ST segment beginning with 1. 1
  BEG 1…1 - Beginning segment for Purchase Order. Child of ST transaction set. -
    BEG01 1…1 2/2

Transaction purpose code.

Valid values:

  • 00 – Original document
  • 01 – Cancel order
  • 04 – Change order
  • CO – Correction
Original
    BEG02 1…1 2/2

Purchase Order type code.

ClosedValid values:
  • BK – Blanket order (quantity firm)
  • CN – Consignment order
  • CO – Catalog order
  • DS – Drop ship order
  • KC – Contract
  • KN – Purchase order
  • LS – Lease
  • NE – New order
  • PR – Promotional order
  • RO - Rush Order
  • RR – Repair and return
  • SA – Stand alone order
  • SP – Sample order
  • ST – Standing order
NEWORDER
    BEG03 1…1 1/22 Purchase Order number. 4506733288
    BEG04 0…1 1/30 Release document number. Identifies a release against a Purchase Order. 4500003288
    BEG05 1…1 8/8 Purchase order date YYYYMMDD X12 date format. 2023-10-20
    BEG06 0…1 1/30 Contract number. Identifies a contract number associated with the purchase order. -
    BEG07 0…1 2/2 Acknowledgment type specified for purchase order. -
  CUR 0…1 - Purchase order currency. -
    CUR01 1…1 2/3 Entity identifier code identifying an organizational entity, a physical location, property or individual using the identified currency code. BY
    CUR02 1…1 3/3 ISO currency code for the country whose currency the charges are specified. USD
  REF 0…* -

Purchase order:

  • reference information

  • reference information for Mutually defined

-
    REF01 1….1 2/3

Reference identification qualifier.

ClosedValid values:
  • 72 - Schedule Reference Number
  • BC– Customer contract number
  • CT– Contract number
  • DI - Distributor Invoice Number
  • DM– Message or document number
  • OQ - Order Number
  • PO– Customer Purchase Order
  • RE– Release document number
  • VC– Supplier contract number
  • VN– Vendor Order Number
  • VR - Vendor ID Number
  • ZZ - Mutually defined
DOCUMENT
    REF02 0…1 1/50 Reference identification for the purchase order as specified by the reference identification qualifier. 009875623
    REF03 0…1 1/80 Description referenced identifier -
  PER 0…* -

Administrative Communications Contact

Sample Data: PER*OC*BRAD SHIVERLAK*TE*8636881188

-
    PER01 1….1 2/2

Contact Function Code.

  • OC - Order Contact

  • PM - Product Manager

-
    PER02 0…1 1/60 Name. BRAD SHIVERLAK
    PER03 0…1 2/2 Communication Number Qualifier. -
    PER04 0…1 1/256 Communication Number. '8636881188
    PER05 0…1 2/2 Communication Number Qualifier. -
    PER06 0…1 1/256 Communication Number. BSHIVERLAK@somecompany.com
  FOB 0…* - F.O.B. (Free On Board) related instructions. Specifies transportation instructions relating to shipment of the order. -
    FOB01 1…1 2/2 Method of payment for shipment. PP
    FOB02 0…1 1/2

Location qualifier identifying type of location.

Valid values:

  • CI - City

  • DE - Destination (Shipping)

  • OR - Origin (Shipping Point)

  • PL - Plant

CITY
    FOB03 0…1 1/80 Description of location for order shipment. RANCHO DOMINGUEZ CA
    FOB04 0…1 2/2 Transportation terms code. 01
  CSH 0…5 - Sales requirements. Specifies general conditions or requirements of the sale. -
    CSH01 0…1 1/2

Sales requirement code.

Valid values:

  • N - No back order

  • Y - Back order if out of stock

  • P2 - Ship as soon as possible

  • SC - Ship complete

-
  SAC 0…25 - Service, promotion, allowance, or charge information. -
    SAC01 1…1 1/1

Allowance or charge indicator. Identifies an allowance or charge for the purchase order.

Valid values:

  • A - Allowance

  • C - Charge

  • N - No allowance or charge

ALLOWANCE
    SAC02 0…1 2/2

Service, promotion, allowance, or charge code.

ClosedValid values:
  • A010 – Absolute minimum charge
  • A150 – Adjustment for maximum charge billing
  • A170 – Adjustments to credits or charges
  • A172 – Administrative credits or charges
  • A250 – Advances on credits or charges
  • A260 – Advertising Allowance
  • A210 – Advance fee
  • A380 – Advance on allowance
  • A320 – Air transport charge
  • A400 – Allowance Non-performance
  • A480 – Assembly credit or charge
  • A520 – Base charge
  • A600 – Bill of lading charge
  • A880 – Cancelation charge
  • A960 – Carrier charge
  • A930 – Carrier credit allowance
  • A940 – Carrier debit allowance
  • A980 – Cartage credit or charge
  • C040 – Delivery credit or charge
  • C030 – Delivery surcharge
  • C110 – Deposit
  • C150 – Destination charge
  • C310 – Discount
  • C340 – Distribution service
  • C350 – Distributor discount/allowance
  • C370 – Diversion charge
  • C400 – Documentation charge
  • C760 – Excess weight charge
  • D040 – Finance charge
  • D070 – Flat rate
  • F800 – Promotional Allowance
  • F810 – Promotional Discount
  • H000 – Special Allowance
  • I410 – Unsaleable minimum charge allowance
ADJUSTMENT
    SAC05 0…1 1/15 Amount of allowance or charge. 247.00
    SAC06 0…1 1/1

Allowance or charge percentage qualifer.

ClosedValid values:
  • 0 – Gross amount.
  • 1 – Item list cost.
  • 2 – Item net cost.
  • 3 – Discount/gross.
  • 4 – Discount/net.
  • 5 – Base price per unit.
  • 6 – Base price amount.
  • 7 – Base price amount less previous discount.
  • 8 – Net monthly on all invoices past due.
  • 9 – Late payment charge base amount.
  • B – Item total amount.
  • C – Item unit price.
  • D – Order total amount.
BASEPRICE
    SAC07 0…1 1/6

Percentage of allowance or charge in decimal format.

source has a ANSI decimal presentation.

1.25
    SAC12 0…1 2/2

Allowance or Charge Method of Handling Code.

ClosedValid values:
  • 01 – Bill back.
  • 02 – Off invoice.
  • 04 – Credit customer account.
  • 05 – Charge to be paid by vendor.
  • 06 – Charge to be paid by customer.
  • 07 – Optional.
  • 08 – Off gross quantity invoiced.
  • 09 – Allowance to be issued by vendor.
  • 10 – Allowance to be issued by reseller.
  • 11 – Charge denied by vendor.
  • 12 – Cancel allowance.
  • 15 – Information only.
  • 18 – Non-payable tax.
  • 25 – Cash in advance.
  • CA – Calculate and add to invoice.
  • CC – Collect.
  • PP – Prepaid.
OFFINVOICE
  ITD 0…* - Terms of sale or deferred terms of sale. -
    ITD01 0…1 2/2

Terms of sale type code. Identifies type of payment code.

ClosedValid values:
  • 01 – Basic terms of sale
  • 02 – End of month
  • 03 – Fixed date for payment
  • 04 – Deferred or installment
  • 05 – Discount not applicable
  • 06 – Missed terms
  • 07 – Extended terms
  • 09 - Proximo
  • 13 – Seller to advise buyer
  • 14 – Previously agreed terms
  • 15 – Special proximo
BASIC
    ITD02 0…1 1/2

Terms of sale basis code. Identifies beginning of the terms of payment code.

Valid values:

  • 1 – Ship date
  • 2 – Delivery date
  • 3 – Invoice date
  • 5 – Invoice receipt date
  • 7 – Effective date
  • 09 – Purchase order date
INVOICEDATE
    ITD03 0…1 1/6 Percentage of discount available to the purchaser if an invoice is paid on or before the terms of payment discount due date. 1.25
    ITD04 0…1 8/8 Discount due date in X12 date format YYYYMMDD. -
    ITD05 0…1 1/3 Number of days payment is due within discount period to qualify for the discount. 30
    ITD06 0…1 8/8 Terms net due date. Date when the invoice total amount is due in X12 date format YYYYMMDD. 2023-11-25
    ITD07 0…1 1/3 Number of days total invoice payment is due where no discount is applicable. 30
    ITD08 0…1 1/10 Total amount of terms of sale discount. -
    ITD09 0…1 8/8 Deferred due date for terms of sale. Refers to deferred payment or percent of invoice payable in X12 date format YYYYMMDD. 2023-12-15
    ITD10 0…1 1/10 Deferred amount due for payment. 55.25
    ITD11 0…1 1/5 Percent of invoice payable. The amount of the invoice payable expressed as a percentage. 100.00
    ITD12 0…1 0/80 Description. description
    ITD13 0…1 1/2 day of the month , this value can be min 1 and max can be maximum day in a month, expected to get this validated at front end or back end. 21
  DTM 0…10 - Shipping date. Child of HL shipment. -
    DTM01 1…1 3/3

Date/Time qualifier identifying shipment date.

Valid values:

  • 002 – Delivery requested date
  • 004 – Purchase order date
  • 010 – Requested shipment date
  • 011 – Shipped date
  • 017 – Estimated delivery date
  • 018 – Availability date
  • 036 – Expiration date
  • 061 – Cancel if not delivered by date
DELIVERYREQUESTED
    DTM02 0…1 8/8 Date in CCYYMMDD format for shipment or delivery date of sending party. 2023-11-25T12:30:00.000Z
    DTM03 0…1 4/8 Time in HHMMSS or HHMM format for shipment or delivery date of sending party. -
  TD5 0..* - Carrier Details – Routing. Child of HL shipment. -
    TD501 0…1 1/2

Routing sequence code describing relationship of a carrier to a specific shipment movement.

Valid values:

  • B - Origin carrier regardless of mode

  • O - Origin carrier, air, motor or ocean

-
    TD502 0…1 1/2

Code identifying the type of identifier in TD03.

Valid values:

  • 2 - SCAC

  • 92 - Assigned by buyer or buyer's agent

-
    TD503 1…1 2/80 Identifier code as defined by TD02. -
    TD504 0…1 1/2

Transportation method type code identifying the method or type of transport used for the shipment.

ClosedValid values:
  • A – Air
  • AE – Air Express
  • D - Ground
  • H – Customer pickup
  • M – Motor (common carrier)
  • R – Rail
  • S – Sea/Ocean
  • SRand K– Supplier truck
  • X – Intermodal (piggy-back)
TRUCK
    TD505 0…1 1/35 Routing. Free-form description of routing or requested routing for shipment or for originating carrier's identity. -
    TD506 0…1 2/2 Shipment order status code. -
    TD507 0…1 1/2 Location qualifier identifying type of location. -
    TD508 0…1 1/30 Location Identifier. -
    TD509 0…1 2/2 Transit Direction Code. -
    TD510 0…1 2/2 Transit Time Direction Qualifier. -
    TD511 0…1 1/8 Transit Time Direction Qualifier. -
    TD512 0…1 2/2 Service Level Code. ON
  TXI 0…* -

Tax Information

Sample Data: TXI^ST^20.17^6.5^CD^500^C^O^100.12^5001^1

-
    TXI01 1…1 2/2

Tax Type Code.

ClosedValid values:
  • AB – SurTax
  • BE – Harmonized Sales Tax
  • CG – Customs Duty Tax (Federal Value Added tax on goods)
  • CS – City Sales Tax
  • CT – County Sales Tax
  • FD – Federal Excise Tax
  • GS – Goods and Services Tax
  • PG – Provincial Sales Tax
  • ST – State Sales Tax
  • TX – All Taxes
  • VA – Value Added Tax
STATESALES
    TXI02 0…1 1/18 Monetary Amount. 5.43
    TXI03 0…1 1/10 Percentage as Decimal. 6.5
    TXI04 0…1 2/2 Tax Jurisdiction Code Qualifier. -
    TXI05 0…1 1/10 Tax Jurisdiction Code. -
    TXI06 0…1 1/1

Tax Exempt Code.

Valid values:

  • 1 - Yes (Tax Exempt)

  • 2 - No (Tax Exempt)

2
    TXI07 0…1 1/1 Relationship Code. -
    TXI08 0…1 1/9 Dollar Basis For Percent. -
    TXI09 0…1 1/20 Tax Identification Number. -
  N9 0..1000 - Reference Identification. -
    N901 0…1 2/3 Reference Identification Qualifier. -
    N902 0…1 1/30 Reference Identification. -
  MSG 0..1000 - Message Text. -
    MSG01 1…1 1/264 Free-Form Message Text. MSG.headerNote
  N1     0…1 -

N1: Name segment loop for:

  • ship to party

  • bill to party

  • buyer party

  • supplier party

  • ship from party

  • Carrier party

  • store number

-
    N101   1…1 2/3

Entity identifier code for party identifier and address information for:

Valid values:

  • ST - Ship to party

  • BT - Bill to party

  • BY - Buyer

  • SU - Supplier

  • VN - Vendor (Supplier)

  • SF - Ship from

  • CA - Carrier

  • SN - Store Number

-
    N102   0…1 1/60 Name. Wholesale Inc
    N103   0…1 1/2

Identifier code qualifier.

Valid values:

  • 1 – D-U-N-S number, Dun and Bradstreet
  • 9 – D-U-N-S + 4r, Dun and Bradstreet number plus suffix
  • 11 – Drug Enforcement Agency registration number
  • 21 – Health Industry Number
  • 91 – Assigned by seller … company identifier
  • 92 – Assigned by buyer … company site identifier
  • UL - Global Location Number
DEA
    N104   0…1 2/80

As qualified by N103:

  • Ship to party identifier

  • Bill to party identifier

  • Buyer party identifier

  • Supplier party identifier

  • Ship from party identifier

  • Ship from party identifier

3333331013655
    N3   0…1 -

N3: Address. Child of

  • Ship to N1 Name segment.

  • buyer party N1 name segment.

  • bill to N1 name segment.

  • Supplier Party N1 name segment.

  • Ship from N1 Name segment.

  • Carrier N1 Name segment.

-
      N301 1…1 1/55 Street address 1. 555 Neelan Road
      N302 0…1 1/55 Street address 2. Suite 123
    N4   0…1 -

N4: Geographic Location. Child of

  • ship to N1 name segment.

  • bill to N1 name segment.

  • buyer party N1 name segment.

  • Supplier Party N1 name segment.

  • Ship from N1 Name segment.

  • Carrier 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 (zip code for United States). 95833
      N404 0…1 2/3 Country code. US
      N405 0…1 1/2 Placeholder for future use of SGLN. -
      N406 0…1 1/30

Placeholder for future use. Origin or Destination Shipping Location ID. SGLN number.

NNI will not have sGLNs defined for any of their customers for the 2015 requirement.

-
  REF 0…* - Purchase order reference information. -
    REF01 1….1 2/3

Reference identification qualifier.

Valid values:

  • LU - GLN

  • DH - DEA

  • 0B - State License Number (Not Supported)

DOCUMENT
    REF02 0…1 1/50 Reference identification for the purchase order as specified by the reference identification qualifier. 009875623
  PO1 1…* - Baseline item data. -
    PO101 0…1 1/20 PO line item number. 000010
    PO102 0…1 1/15 Quantity of ordered product. 200
    PO103 0…1 2/2 Unit of measure for quantity. EA
    PO104 0…1 1/17 Unit price per saleable unit for ordered quantity. 21.25
    PO106 0…1 2/2 Product service ID qualifier mapping from global standards enum list. SUPPLIER
    PO107 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO108 0…1 2/2 Product service ID qualifier mapping from global standards enum list. CUSTOMER
    PO109 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO110 0…1 2/2 Product service ID qualifier mapping from global standards enum list. MANUFACTURER
    PO111 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO112 0…1 2/2 Product service ID qualifier mapping from global standards enum list. VENDOR
    PO113 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO114 0…1 2/2 Product service ID qualifier mapping from global standards enum list. GTIN14
    PO115 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO116 0…1 2/2 Product service ID qualifier mapping from global standards enum list. UPC
    PO117 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO118 0…1 2/2 Product service ID qualifier mapping from global standards enum list. US_NDC542
    PO119 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO120 0…1 2/2 Product service ID qualifier mapping from global standards enum list. CA_DIN
    PO121 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO122 0…1 2/2 Product service ID qualifier mapping from global standards enum list. US_NDC532
    PO123 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PO124 0…1 2/2 Product service ID qualifier mapping from global standards enum list. UPC
    PO125 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. 08202000230
    PID 0…* - SN1- Item Details. Child of HL level Item. -
      PID01 0…1 1/1 Item description type. Valid value is F - free from -
      PID05 0…1 1/80 Item description. product10400000701117_RegStrength_12pack
    PO4 - -

Item Physical Details.

DTM-Date/Time for Lot Expiry Date. Child of HL level Item.

-
      PO401 0…1 1/6 Pack. The number of inner containers, or number of eaches if there are no inner containers, per outer container. -
      PO402 0…1 1/8 Size of supplier units in pack. 5
      PO403 0…1 2/2 Unit or Basis for Measurement Code. AMPOULE
    SAC 0…25 - Service, promotion, allowance, or charge information. -
      SAC01 1…1 1/1

Allowance or charge indicator. Identifies an allowance or charge for the purchase order.

Valid values:

  • A - Allowance

  • C - Charge

  • N - No allowance or charge

ALLOWANCE
      SAC02 0…1 4/4

Service, promotion, allowance, or charge code.

ClosedValid values:
  • A010 – Absolute minimum charge
  • A150 – Adjustment for maximum charge billing
  • A170 – Adjustments to credits or charges
  • A172 – Administrative credits or charges
  • A210 – Advance fee
  • A250 – Advances on credits or charges
  • A260 – Advertising Allowance
  • A320 – Air transport charge
  • A380 – Advance on allowance
  • A400 – Allowance Non-performance
  • A480 – Assembly credit or charge
  • A520 – Base charge
  • A600 – Bill of lading charge
  • A880 – Cancelation charge
  • A930 – Carrier credit allowance
  • A940 – Carrier debit allowance
  • A960 – Carrier charge
  • A980 – Cartage credit or charge
  • C030 – Delivery surcharge
  • C040 – Delivery credit or charge
  • C110 – Deposit
  • C150 – Destination charge
  • C310 – Discount
  • C340 – Distribution service
  • C350 – Distributor discount/allowance
  • C370 – Diversion charge
  • C400 – Documentation charge
  • C760 – Excess weight charge
  • D040 – Finance charge
  • D070 – Flat rate
  • D200 – Delivery Fee (Freight Charges to Destination)
  • F800 – Promotional Allowance
  • F810 – Promotional Discount
  • H000 – Special Allowance
  • I410 – Unsaleable minimum charge allowance
ADJUSTMENT
      SAC05 0…1 1/15 Amount of allowance or charge. 247.00
      SAC06 0…1 1/1

Allowance or charge percentage qualifier.

ClosedValid values:
  • 0 – Gross amount.
  • 1 – Item list cost.
  • 2 – Item net cost.
  • 3 – Discount/gross.
  • 4 – Discount/net.
  • 5 – Base price per unit.
  • 6 – Base price amount.
  • 7 – Base price amount less previous discount.
  • 8 – Net monthly on all invoices past due.
  • 9 – Late payment charge base amount.
  • B – Item total amount.
  • C – Item unit price.
  • D – Order total amount.
BASEPRICE
      SAC07 0…1 1/6 Percentage of allowance or charge in decimal format. 1.25
      SAC12 0…1 2/2

Allowance or Charge Method of Handling Code.

Valid values:

  • 01 - Bill back

  • 02 - Off invoice

  • 04 - Credit customer account

OFFINVOICE
    IT8 0…1 - Conditions of sale. -
      IT801 0…0 1/2

Sales requirement code. Identifies requirement or agreement of sale.

Valid values:

  • N - No back order

  • Y - Back order if out of stock

-
    TD5 0..* - Carrier Details - Routing -
      TD512 0…1 2/2 Service Level Code. 1H
    MSG 0…* - Message Text. -
      MSG01 1…1 1/264 Free-Form Message Text. MSG.detailNote
    TXI 0…* -

Tax Information

Sample Data: TXI^TX^2.28

-
      TXI01 1…1 2/2

Tax Type Code.

ClosedValid values:
  • AB – SurTax
  • BE – Harmonized Sales Tax
  • CG – Customs Duty Tax (Federal Value Added tax on goods)
  • CS – City Sales Tax
  • CT – County Sales Tax
  • FD – Federal Excise Tax
  • GS – Goods and Services Tax
  • PG – Provincial Sales Tax
  • ST – State Sales Tax
  • TX – All Taxes
  • VA – Value Added Tax
ALLTAXES
      TXI02 0…1 1/18 Monetary Amount. 5.43
      TXI03 0…1 1/10 Percentage as Decimal. -
      TXI04 0…1 2/2

Tax Jurisdiction Code Qualifier.

Valid values:

  • CD – Customer defined
  • MB – Taxing Authority Code
  • SP – State or Province
  • ST – State Defined
  • VD – Vendor Defined
  • VE – Vertex
-
      TXI05 0…1 1/10 Tax Jurisdiction Code. -
      TXI06 0…1 1/1

Tax Exempt Code.

Valid values:

  • 1 - Yes (Tax Exempt)

  • 2 - No (Tax Exempt)

-
      TXI07 0…1 1/1 Relationship Code. -
      TXI08 0…1 1/9 Dollar Basis For Percent. -
      TXI09 0…1 1/20 Tax Identification Number. -
    N9 0…1000 - Reference Identification. -
      N901 0…1 2/3 Reference Identification Qualifier. -
      N902 0…1 1/30 Reference Identification. -
    MSG 0…1000 - Message Text. -
      MSG01 1…1 1/264 Free-Form Message Text. MSG.detailNote
  CTT 0…1 - CTT-Transaction Totals -
    CTT01 1…1 1/6 Total number of line items in the transaction set. 15
    AMT 0…1 - Monetary Amount Information -
      AMT01 0…0 1/2

Amount Qualifier Code.

Valid values:

  • 1 - LINEITEMTOTAL

  • TT - TOTALAMOUNT

LINEITEMTOTAL
      AMT02 0…0 1/2 Monetary Amount. 600
SE 1…1 - ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. -
  SE01 1…1 1/10 Total count of segments in ST … SE transaction set including ST and SE segments. 10
  SE02 1…1 4/9 Transaction set control number. 1
GE 1…1 - GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. -
  GE01 1…1 1/6 Number of transaction sets in functional group. 5
  GE02 1…1 1/9 Functional group control number. 619827
IEA 1…1 - ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. -
  IEA01 1…1 1/5 Number of functional groups in interchange. 1
  IEA02 1…1 9/9 Interchange control number. 0000000000619827
ClosedExample
ISA*00*          *01*          *02*76067344       *01*7777776067344  *120709*1612*^*00501*000619827*0*P*>
GS*SH*2222224043588*TRACELINK*20231020*142010*619827*X*005010
ST*850*1001
BEG*00*KN*8196733288*8196001*20120709*81*AY
CUR*BY*USD
REF*BC*8196733288*Description referenced identifier
FOB*PP*CI*Description of location for order shipment, City 
CSH*P2
SAC*A*A170***24700*6*1.25*****02
ITD*01*3*1.25*20220808*30*20220925*30*10*20231215*5525*100*description*21
DTM*018*20231125*123034
TD5*O*2*ABFS*A
N1*ST*SHIP TO PARTY*92*0004000050
N3*Central 101*Local, WST-190. E
N4*Stein*GL*4AA332*CH
REF*LU*009875623*Description referenced identifier
N1*BY*Buyer, sold to party*91*0001000285
N3*7956 VICTORY*Suite 2
N4*BASEL*GL*4002*CH
N1*BT*Bill to party*11*3333331013655
N3*555 Neelan Road*Suite 123
N4*Sacramento*CA*95833*US
N1*SU*SUPPLIER/VENDOR*91*0001000286
N3*Stella Maris*Condado Ave 14
N4*San Juan*PR*00902*US
N1*SF*Ship from party*91*0001000288
N3*Stella Maris*Warehouse 14A
N4*San Juan*PR*00902*US
N1*CA*CARRIER PARTY (SP)*91*00045455656
N3*Stree 1
N4*City*TK*3454676*JP
PO1*0010*100.1*PC*21.25**PI*Customer_1*VN*Vendor_1*UK*GTIN14_1*UP*UPC_1*MF*Manufacturer_1*FV*CA_DIN_1*N1*US_NDC442_1*N2*US_NDC532_1*N3*US_NDC541_1*N4*US_NDC542_1
PID*F****product10400000701117_RegStrength_12pack
PO4*12*5*PC
SAC*C*A170***24700*6*1.25*****02
IT8*Y
CTT*500
SE*35*1001
GE*1*619827
IEA*1*000619827
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