Tracelink University ## Breadcrumb 1. [Home](/) 2. [Resources](/resources/resource-center) 3. [TraceLink University](/resources/tracelink-university) # Purchase orders (X12) - [Download PDF](/node/627751/pdf) - [Share](#) - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/purchase-orders-x12&title=Purchase orders (X12)&summary=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. &source=TraceLink "LinkedIn") - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/purchase-orders-x12&t=Purchase orders (X12) "Facebook") - [ Mail ](mailto:?subject=Purchase orders (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/purchase-orders-x12 "Mail") - [ Twitter ](https://twitter.com/intent/tweet?text=Purchase orders (X12) https://www.tracelink.com/resources/tracelink-university/purchase-orders-x12&via=TraceLink "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. ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) 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 [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#) 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. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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. [![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 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. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid 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. [![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 ADJUSTMENT SAC05 0…1 1/15 Amount of allowance or charge. 247.00 SAC06 0…1 1/1 Allowance or charge percentage qualifer. [![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. 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. [![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. 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. [![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 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. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `A` – Air - `AE` – Air Express - `D` - Ground - `H` – Customer pickup - `M` – Motor (common carrier) - `R` – Rail - `S` – Sea/Ocean - `SR`and `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. [![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 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. [![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 - `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. [![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. 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. [![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 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 [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```xml 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 ``` ![](/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)