  

 

Tracelink University

 ## Breadcrumb

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

 

 

# E222 purchase order (X12)

 

 

 

 

 

 

 

 

- [Download PDF](/node/627516/pdf)
- [Share](#)
    - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/e222-purchase-order-x12&title=E222 purchase order (X12)&summary=The E222 Purchase Order X12 message meets strict regulatory requirements while enabling secure, paperless ordering between authorized trading partners.&source=TraceLink "LinkedIn")
    - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/e222-purchase-order-x12&t=E222 purchase order (X12) "Facebook")
    - [ Mail ](mailto:?subject=E222 purchase order (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/e222-purchase-order-x12 "Mail")
    - [ Twitter ](https://twitter.com/intent/tweet?text=E222 purchase order (X12) https://www.tracelink.com/resources/tracelink-university/e222-purchase-order-x12&via=TraceLink "Twitter")
 
 

 

 

 

 

#### Table of contents

 

 

 

The E222 Purchase Order X12 message meets strict regulatory requirements while enabling secure, paperless ordering between authorized trading partners.

 ![](/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\_E222\_PURCHASE\_ORDER
- **X12 Format**: E222PURCHASEORDER
- **Transform Names**:
    
    
    - B2B\_EDI\_X12\_850\_E222\_PurchaseOrder\_IB\_V1
 
[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#)             Input Element  Occurs Length Description Example     850 1…1 - **Required.** HDMA X12 856 ASN message. -     ISA 1…1 - **Required.** ISA interchange envelope. -       ISA01 1…1 2/2 **Required.** 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.
 
  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.

Valid values:

- `00` - No security information present
- `01` - Password
 
  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.** EDI sender ID mapping to file control header and to ServiceLinkId (see row 23). 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.
 
 

 

  07       ISA08 1…1 15/15 **Required.** EDI receiver ID mapping to file control header. 888888404358877       ISA09 1…1 6/6 **Required.** Interchange date in 6 char YYMMDD format. 231020       ISA10 1…1 4/4 **Required.** Interchange time in 4 char HHMM format. 1420       ISA11 1…1 1/1 **Required.** 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 **Required.** Interchange control version number. Valid value is “`00401`” 00501       ISA13 1…1 9/9 **Required.** Interchange Control Number for file control header. 0000000000619827       ISA14 1…1 1/1 **Required.** Interchange level acknowledgment requested.

Valid values:

- `0` - No acknowledgment requested
- `1` - Interchange level acknowledgment requested
 
  0       ISA15 1…1 1/1 **Required.** Indicates whether the interchange is for production, test, or information purposes.

Valid values:

- `I` - Information
- `P` - Production data
- `T` - Test data
 
  P       ISA16 1…1 1/1 **Required.** Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator &gt;     GS 1…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 `PO` - Purchase Order

  SH       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. 231020       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 value is `X`.

  X       GS08 1…1 1/12 **Required.** 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 **Required.** Transaction set identifier code. 850       ST02 1…1 4/9 **Required.** Transaction set ID number. Counter for each ST segment beginning with 1. 1       MSG01 1…1 - **Required.** Custom MSG01 attribute outside X12 envelope. -       BEG 1…1 - **Required.** Beginning segment for Purchase Order. Child of ST transaction set. -         BEG01 1…1 2/2 **Required.** Transaction purpose code.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `00` – Original document, create in target.
- `01` – Cancel order.
- `02` – Create document or item from message.
- `03` – Delete document or item.
- `04` – Changes to document header.
- `05` – Replace entire document.
- `06` – Document is a confirmation.
- `07` – Duplicate transaction.
- `08` – Document or item status.
- `11` – Response message.
- `13` – Request message.
- `16` – Proposed document or item.
- `17` – Message canceled and reissued.
- `22` – Information only.
- `24` – Document is in draft state.
- `45` – Followup message.
- `CO` – Document or item has been corrected.
 
 

 

  00         BEG02 1…1 2/2 **Required.** Purchase Order type code.

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

 

  NE         BEG03 1…1 1/22 **Required.** E222 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 **Required.** Purchase order date YYYYMMDD X12 date format. 20231020         BEG06 0…1 1/30 Contract number. Identifies a contract number associated with the purchase order. 999         BEG07 0…1 2/2 Acknowledgment type specified for purchase order. AY       CUR 0…1 - Purchase order currency. -         CUR01 1…1 2/3 **Required.** Entity identifier code identifying an organizational entity, a physical location, property or individual using the identified currency code. BY         CUR02 1…1 3/3 **Required.** ISO currency code for the country whose currency the charges are specified. USD       REF 0…\* - Purchase order reference information.

Purchase order reference information for Mutually Defined.

  -         REF01 1….1 2/3 Reference identification qualifier.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `14` - Master account
- `72` - Schedule reference identifier
- `1X` - Credit debit adjustment identifier type
- `2I` - Tracking number
- `A3` - Assignment
- `AM` - Chargeback adjustment memo
- `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
- `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
- `IV` – Seller's invoice
- `K9` – Customer inquiry number
- `MB` – Master bill of lading
- `OI` – Original invoice
- `OQ` – Order number
- `P2` – Previous DEA identifier number
- `PK` – Packing list number
- `PO` – Purchase order number
- `PR` – Price quote identifier
- `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
- `TB` – Trucker's Bill of Lading
- `TN` – Transaction reference number
- `VC` – Supplier contract number
- `VN` – Supplier order number
- `VR` – Vendor identifier number
- `WO` – Work order (production order) number
 
 

 

Valid value:

- `ZZ` - Mutually defined
 
  DM         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.

- ` AJ` - Primary Contact
- `OC` - Order Contact
- `PM` - Product Manager
 
  OC         PER02 0…1 1/60 Name. BRAD SHIVERLAK         PER03 0…1 2/2 Communication Number Qualifier.

Valid values:

- `TE` - telephone number
- `EM` - email address
 
  TE         PER04 0…1 1/256 Communication Number:

- Telephone
- Email address
 
  8636881188         PER05 0…1 2/2 Communication Number Qualifier.

Valid values:

- `TE` - telephone number
- `EM` - email address
 
  EM         PER06 0…1 1/256 Communication Number:

- Telephone
- Email address
 
  8636881188       FOB 0…\* - F.O.B. (Free On Board) related instructions. Specifies transportation instructions relating to shipment of the order. -         FOB01 1…1 2/2 **Required.** 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
 
  CI         FOB03 0…1 1/80 Description of location for order shipment. RANCHO DOMINGUEZ CA         FOB04 0…1 2/2 Transportation terms code. 01       SAC 0…25 - Service, promotion, allowance, or charge information. -         SAC01 1…1 1/1 **Required.** Allowance or charge indicator. Identifies an allowance or charge for the purchase order.

Valid values:

- `A` - Allowance
- `C` - Charge
- `N` - No allowance or charge
 
  A         SAC02 0…1 2/2 Service, promotion, allowance, or charge code.

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

 

  A170         SAC05 0…1 1/15 Amount of allowance or charge.  247.00         SAC06 0…1 1/1 Allowance or charge percentage qualifier.

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

 

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

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

 

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

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

 

  01         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
 
  3         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. -         ITD06 0…1 8/8 Terms net due date. Date when the invoice total amount is due in X12 date format YYYYMMDD. 20231125         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. 20231215         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 **Required.** 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
 
  011         DTM02 0…1 8/8 Date in CCYYMMDD format for shipment or delivery date of sending party. 20231125         DTM03 0…1 4/8 Time in HHMMSS or HHMM format for shipment or delivery date of sending party. 1230       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
 
  O         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
 
  2         TD503 1…1 2/80 **Required.** Identifier code as defined by TD02. ABFS         TD504 0…1 1/2 Transportation method type code identifying the method or type of transport used for the shipment. J         TD505 0…1 1/35 Routing. Free-form description of routing or requested routing for shipment or for originating carrier's identity. -       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 **Required.** Tax Type Code.

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

 

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

Valid values:

- `CD` – Customer defined
- `MB` – Taxing Authority Code
- `SP` – State or Province
- `ST` – State Defined
- `VD` – Vendor Defined
- `VE` – Vertex
 
  CD         TXI05 0…1 1/10 Tax Jurisdiction Code.  500         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 -       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 **Required.** 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
 
  ST         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
 
  11         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 **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

- 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)
 
  LU         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. -       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.  VN         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.  IN         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.  MF         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. VC         PO113 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO114 0…1 2/2 Product service ID qualifier mapping from global standards enum list.  UK         PO115 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO116 0…1 2/2 Product service ID qualifier mapping from global standards enum list.  UP         PO117 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO118 0…1 2/2 Product service ID qualifier mapping from global standards enum list.  N4         PO119 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO120 0…1 2/2 Product service ID qualifier mapping from global standards enum list.  FV         PO121 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO122 0…1 2/2 Product service ID qualifier mapping from global standards enum list. N2         PO123 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PO124 0…1 2/2 Product service ID qualifier mapping from global standards enum list. UP         PO125 0…1 1/48 Product or service identifier. Should be the same identifiers that will be used in the invoice. -         PID 0…\* - SN1- Item Details. Child of HL level Item. -           PID01 0…1 1/1 Item description type. Valid value: ` F` - free from F           PID05 0…1 1/80 Item description. -         PO4 - - Item physical details, eaches with no innercontainers. -           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. AM         SAC 0…25 - Service, promotion, allowance, or charge information. -           SAC01 1…1 1/1 **Required.** Allowance or charge indicator. Identifies an allowance or charge for the purchase order.

Valid values:

- `A` - Allowance
- `C` - Charge
- `N` - No allowance or charge
 
  A           SAC02 0…1 4/4 Service, promotion, allowance, or charge code.

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

 

  I410           SAC05 0…1 1/15 Amount of allowance or charge. 247.0           SAC06 0…1 1/1 Allowance or charge percentage qualifier.

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

 

  6           SAC07 0…1 1/6 Percentage of allowance or charge in decimal format. 1.0           SAC12 0…1 2/2 Allowance or Charge Method of Handling Code.

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

 

  02         TXI 0…\* - Tax Information Sample Data: TXI^TX^2.28 -           TXI01 1…1 2/2 **Required.** Tax Type Code. TX           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. -           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. -       CTT 0…1 - CTT-Transaction Totals. -         CTT01 1…1 1/6 **Required.** 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
 
  1         AMT02 0…0 1/2 Monetary Amount.  600     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. 1     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](#)```xml
ISA*00*          *01*          *07*ss007PL        *01*7777776067344  *250612*1332*^*00501*000619827*0*P*>~
GS*SH*2222224043588*TRACELINK*20250611*1420*619827*X*005010~
ST*850*000000001~
BEG*00*KN*8196733288*Release_111*20230709*Contract_111~
CUR*BY*CAD~
REF*DD*ref02_1~
REF*ZZ*CGP*Company A Global Purch~
PER*OC*Name1*TE*8976051231*EM*BSHIVERLAK@somecompany.com~
FOB*PP*CI*s42*01~
SAC*A*A400***24700*6*1.25*****02~
ITD*15*3*1.25*20250610*53*20250610*54**20250610*5525*100.0*desc1*21~
ITD*02*5*1.25*20250610*50*20250610*51**20250610*5025*200.0*desc2*20~
DTM*002*20250610*185806~
TD5*O***K~
TXI*CS*5.43*6.5**500*2~
N1*ST*ST_BusName*1*3333331013655~
N3*ST_address1*ST_address2~
N4*ST_city*CA*ST_PostCd*US~
REF*DH*009875623~
REF*LU*009875624~
N1*BY*BY_BusName*9*3333331013666~
N3*BY_address1*BY_address2~
N4*BY_city*CA*BY_PoBYCd*US~
PO1*00010*200*EA*21.25**VN*Vendor_1*PI*Buyer_1*FV*Cadin_1*UA*caseupc_1*N1*ndc442_1*N2*ndc532_1*NH*nhric_1*SK*sku_1*EN*ean2551_1*UI*packageupc_1~
PID*F****Item Desc 1~
PID*F****Item Desc 2~
PO4*147*148*AM~
SAC*A*C030***24700*6*1.25*****02~
TXI*CT*5.43*6.5**500*2~
PO1*00020*300*EA*31.25**UK*gtin14_1*VC*vendorcatalog_1*UK*gtin14_2*UA*caseupc_1*N3*ndc541_1*N4*ndc542_1*N5*nhric55_1*SK*sku_1*EN*ean2551_1*UI*packageupc_1~
PID*F****Item Desc 3~
PID*F****Item Desc 4~
PO4*147*148*CG~
SAC*A*A930***24700*B*1.25*****25~
TXI*AB*1.43*10.5**500*2~
CTT*161~
AMT*1*162~
SE*45*0001~
GE*1*619827~
IEA*1*000619827~
```

 

 

 

 



 

 

 

 

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