Connecting through Seller EDI for Dropship - Purchase Order (850) Specification
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 Convictional |
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 Convictional. 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 Convictional. | ||
BEG-05 | Date | True | Convictional 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 Convictional. 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: UP, EN | ||
PO1-07 | Product ID | True | Barcode | ||
PO1-08 | Product ID Qualifier | False | Accepted Values: UP, EN, OT | ||
PO1-09 | Product ID | False | Barcode or Convictional Variant ID for the variant. | ||
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 Convictional 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*******~
PER*CN*Convictional*EM*support@convictional.com*****~
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*UP*012345678905*SKU*SAMPLE-SKU*VP*SAMPLE-SKU~
PID*F****Product Title 1****~
CTT*1*1*****~
SE*10*0001~
GE*1*1~
IEA*1*000000004~
