Purchase Order (850) Specification

Nick Wehner Updated by Nick Wehner

This documentation is for users who have integrated with EDI in September 2024 or later.
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~

How did we do?

Invoice (810) Specification

Purchase Order Acknowledgements (855) Specification

Contact