Purchase Order (850) Specification
If you integrated with EDI earlier, refer to these docs.
In this guide, we walkthrough our basic EDI specification for Purchase Order (850) files. You can read through the full guide here.
Segment Summary
ID | Name | Loop ID | Required by Modern Dropship |
ST | Transaction Set Header | Mandatory | |
BEG | Beginning Segment for Purchase Order | Mandatory | |
TD5 | Carrier Detail | Optional | |
N1 | Name | N1 | Mandatory |
N3 | Geographic Location | N1 | Mandatory |
N4 | Geographic Location | N1 | Mandatory |
PO1 | Baseline Item Data | PO1 | Mandatory |
PID | Product/Item Description | PO1 | Mandatory |
CTT | Transaction Totals | Mandatory | |
SE | Transaction Set Trailer | Mandatory |
Segment Specifications
ST
ID | Name | Required | Min | Max | Notes |
ST-01 | Transaction Set Identifier Code | True | 3 | 3 | Accepted Values: 850 |
ST-02 | Transaction Set Control Number | True | 4 | 9 | This number is assigned by Modern Dropship. Ex. 0001 |
BEG
ID | Name | Required | Min | Max | Notes |
BEG-01 | Transaction Set Purpose Code | True | 2 | 2 | Accepted Values: 00 |
BEG-02 | Purchase Order Type Code | True | 2 | 2 | Accepted Values: NE |
BEG-03 | Purchase Order Number | True | Number is assigned by Modern Dropship. | ||
BEG-05 | Date | True | Modern Dropship processing date. |
BEG-01
Code | Name | Notes |
00 | Original |
BEG-02
ID | Name | Notes |
NE |
TD5
ID | Name | Required | Min | Max | Notes |
TD5-05 | False | 1 | 35 | Originates from order.shippingMethods[0].title |
N1
ID | Name | Required | Min | Max | Notes |
N1-01 | Entity Identifier Code | True | 2 | 2 | Accepted Values: ST, BT |
N1-02 | Name | True | Name of the individual |
We provide two N1 loop iterations. One for the Shipping Address and has the N1-01 qualifier of ST. The other for the Billing Address and has the N1-01 qualifier of BT.
N1-01
Code | Name | Notes |
ST | Shipping to | |
BT | Billing to |
N3
ID | Name | Required | Min | Max | Notes |
N3-01 | Address One | True | Ship to or billing address. Ex. 123 Fake St | ||
N3-02 | Address Two | False | Additional address details. Ex. Unit 123 |
N4
ID | Name | Required | Min | Max | Notes |
N4-01 | City Name | True | Ex. Waterloo | ||
N4-02 | State or Province Code | True | 2 | 2 | Ex. ON |
N4-03 | Postal or Zip Code | True | Ex. 25000 | ||
N4-04 | Country Code | True | Ex. CA, US |
PO1
ID | Name | Required | Min | Max | Notes |
PO1-01 | Assigned Identification | True | Number assigned by Modern Dropship. Ex. 1, 2, 3 | ||
PO1-02 | Quantity Ordered | True | Number of items ordered. Ex. 1, 20 | ||
PO1-03 | Unit for Measurement Code | True | Accepted Values: EA | ||
PO1-04 | Unit Price | True | The price per item. | ||
PO1-05 | Unit Price Code | True | Accepted Values: PE | ||
PO1-06 | Product ID Qualifier | True | Accepted Values: VC | ||
PO1-07 | Product ID | True | Variant Code | ||
PO1-08 | Product ID Qualifier | False | |||
PO1-09 | Product ID | False | |||
PO1-10 | Product ID Qualifier | False | |||
PO1-11 | Product ID | False | |||
PO1-12 | Product ID Qualifier | False | |||
PO1-13 | Product ID | False |
PO1-03
Code | Name | Notes |
EA | Each |
PO1-05
Code | Name | Notes |
PE |
PO1-06
Code | Name | Notes |
UP | UPC code | |
EN | European Article Number | |
OT | Internal ID | This is the Modern Dropship Variant ID. |
The Product ID Qualifier and Product ID data elements are repeated through to PO1-13.
PID
ID | Name | Required | Min | Max | Notes |
PID-01 | Item Description Type | True | Accepted Values: F | ||
PID-05 | Description | True | Line item title / Product title |
PID-01
Codes | Name | Notes |
F | Free Form Text |
CTT
ID | Name | Required | Min | Max | Notes |
CTT-01 | Number of Line Items | True |
SE
ID | Name | Required | Min | Max | Notes |
SE-01 | Number of Included Segments | True | Ex. 70 | ||
SE-02 | Transaction Set Control Number | Ture | This value should align with ST-02. |
Samples
ISA*00* *00* *01*117522184 *ZZ*YOURISAID12345 *210517*1900*U*00401*000000004*1*P*>~
GS*PO*117522184*SAMPLEISAID*20210517*1900*1*X*00401~
ST*850*0001~
BEG*00*NE*4**20210517*******~
N1*ST*John Smith****~
N3*123 Fake St*Apt 1~
N4*Waterloo*ON*L6M5A9*CA**~
N1*BT*John Smith****~
N3*123 Fake St*Apt 1~
N4*Waterloo*ON*L6M5A9*CA**~
PO1*1*2*EA*64.35*PE*VC*012345678905~
PID*F****Product Title 1****~
CTT*1*1*****~
SE*10*0001~
GE*1*1~
IEA*1*000000004~
