850 Purchase Order (007040)

This is the standard X12 007040 spec, with 31 loops and 207 segment positions, as OpenEDI JSON, an ediFabric C# template and an ediFabric Native model. To change it for a trading partner, customize it in the EDI Spec Builder.

Loading the spec…

The spec as an OpenAPI 3 schema with x-openedi-* extensions, for ediFabric Native, ediFabric Cloud and the EDI Spec Builder. Download OpenEDI (221 KB) Generate classes

The ediFabric .NET template, class TS850. It needs the common segments, composites and codes of X12 007040, one download for every transaction in the version. Download C# (3 KB) Common files (233 KB)

The intermediary model ediFabric Native loads with set_map. Download Native (177 KB)

Use the 850 spec in your code

ediFabric .NET

Add the C# template and its common files to your project, or reference the template NuGet package, and read 850 files into TS850 objects. See ediFabric .NET.

ediFabric Native

Map version 007040 to the Native model with set_map, then parse 850 files to JSON from Python, Java, C or C#. See Convert between EDI and JSON.

OpenEDI

Select Customize in Spec Builder to copy the spec under your own name, change it for your partner, and parse files against it in EdiNation, ediFabric Native or ediFabric Cloud. Read about OpenEDI.

Generate 850 classes in Python, Java, Node.js, Go, Rust or C

ediFabric Native returns each 850 as JSON, with the property names of the OpenEDI schema. To work with that JSON as typed objects, generate classes from the OpenEDI file in your language and deserialize the JSON into TS850. Serialize the objects back to JSON to build EDI with ediFabric Native. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats, so validate files with ediFabric Native. Read more in Generate a class from OpenEDI.

Python: datamodel-code-generator. Node.js: openapi-typescript. Java, Go, Rust and C: OpenAPI Generator.

For a sample file, the same data as JSON, and code to parse, validate and generate the 850, see the 850 transaction guide.

850 structure

Loops and segments of the standard 850, with their usage and maximum repeats.

ID	Name	Usage	Max use
ST	Transaction Set Header	Mandatory	1
BEG	BEG	Mandatory	1
CUR	CUR	Optional	1
REF	REF	Optional	99999
PER	PER	Optional	3
TAX	TAX	Optional	99999
FOB	FOB	Optional	99999
CTP	CTP	Optional	99999
PAM	PAM	Optional	10
CSH	CSH	Optional	5
TC2	TC2	Optional	99999
Loop SAC	SAC	Optional	99999
SAC	SAC	Mandatory	1
CUR	CUR	Optional	1
ITD	ITD	Optional	99999
DIS	DIS	Optional	20
INC	INC	Optional	1
DTM	DTM	Optional	10
LIN	LIN	Optional	5
SI	SI	Optional	99999
PID	PID	Optional	200
MEA	MEA	Optional	40
PWK	PWK	Optional	25
PKG	PKG	Optional	200
TD1	TD1	Optional	2
TD5	TD5	Optional	99999
TD3	TD3	Optional	12
TD4	TD4	Optional	5
MAN	MAN	Optional	10
PCT	PCT	Optional	99999
CTB	CTB	Optional	5
TXI	TXI	Optional	99999
Loop LDT	LDT	Optional	99999
LDT	LDT	Mandatory	1
QTY	QTY	Optional	99999
MTX	MTX	Optional	99999
REF	REF	Optional	99999
Loop AMT	AMT	Optional	99999
AMT	AMT	Mandatory	1
REF	REF	Optional	99999
DTM	DTM	Optional	1
PCT	PCT	Optional	99999
Loop FA1	FA1	Optional	99999
FA1	FA1	Mandatory	1
FA2	FA2	Mandatory	99999
Loop N9	N9	Optional	1000
N9	N9	Mandatory	1
DTM	DTM	Optional	99999
MTX	MTX	Optional	99999
PWK	PWK	Optional	99999
EFI	EFI	Optional	99999
Loop N1	N1	Optional	99999
N1	N1	Mandatory	1
N2	N2	Optional	2
IN2	IN2	Optional	99999
N3	N3	Optional	2
N4	N4	Optional	99999
NX2	NX2	Optional	99999
REF	REF	Optional	12
PER	PER	Optional	99999
SI	SI	Optional	99999
FOB	FOB	Optional	1
TD1	TD1	Optional	2
TD5	TD5	Optional	12
TD3	TD3	Optional	12
TD4	TD4	Optional	5
PKG	PKG	Optional	200
Loop LM	LM	Optional	99999
LM	LM	Mandatory	1
LQ	LQ	Mandatory	99999
Loop SPI	SPI	Optional	99999
SPI	SPI	Mandatory	1
REF	REF	Optional	5
DTM	DTM	Optional	5
MTX	MTX	Optional	99999
Loop N1	N1	Optional	20
N1	N1	Mandatory	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
REF	REF	Optional	20
G61	G61	Optional	1
MTX	MTX	Optional	99999
Loop CB1	CB1	Optional	99999
CB1	CB1	Mandatory	1
REF	REF	Optional	20
DTM	DTM	Optional	5
LDT	LDT	Optional	1
MTX	MTX	Optional	99999
Loop ADV	ADV	Optional	99999
ADV	ADV	Mandatory	1
DTM	DTM	Optional	99999
MTX	MTX	Optional	99999
Loop PO1	PO1	Mandatory	99999
PO1	PO1	Mandatory	1
LIN	LIN	Optional	99999
SI	SI	Optional	99999
CUR	CUR	Optional	1
CN1	CN1	Optional	1
PO3	PO3	Optional	25
PAL	PAL	Optional	1
Loop CTP	CTP	Optional	99999
CTP	CTP	Mandatory	1
CUR	CUR	Optional	1
PAM	PAM	Optional	10
MEA	MEA	Optional	40
Loop PID	PID	Optional	1000
PID	PID	Mandatory	1
MEA	MEA	Optional	10
PWK	PWK	Optional	25
PO4	PO4	Optional	99999
REF	REF	Optional	99999
PER	PER	Optional	3
Loop SAC	SAC	Optional	99999
SAC	SAC	Mandatory	1
CUR	CUR	Optional	1
CTP	CTP	Optional	1
IT8	IT8	Optional	1
CSH	CSH	Optional	99999
ITD	ITD	Optional	99999
DIS	DIS	Optional	20
INC	INC	Optional	1
TAX	TAX	Optional	99999
FOB	FOB	Optional	99999
SDQ	SDQ	Optional	99999
IT3	IT3	Optional	5
DTM	DTM	Optional	10
TC2	TC2	Optional	99999
TD1	TD1	Optional	1
TD5	TD5	Optional	12
TD3	TD3	Optional	12
TD4	TD4	Optional	5
PCT	PCT	Optional	99999
MAN	MAN	Optional	10
MTX	MTX	Optional	99999
SPI	SPI	Optional	99999
TXI	TXI	Optional	99999
CTB	CTB	Optional	99999
Loop QTY	QTY	Optional	99999
QTY	QTY	Mandatory	1
SI	SI	Optional	99999
Loop SCH	SCH	Optional	200
SCH	SCH	Mandatory	1
TD1	TD1	Optional	2
TD5	TD5	Optional	12
TD3	TD3	Optional	12
TD4	TD4	Optional	5
REF	REF	Optional	99999
Loop PKG	PKG	Optional	200
PKG	PKG	Mandatory	1
MEA	MEA	Optional	99999
Loop LS	LS	Optional	1
LS	LS	Mandatory	1
Loop LDT	LDT	Optional	99999
LDT	LDT	Mandatory	1
MAN	MAN	Optional	10
QTY	QTY	Optional	5
MTX	MTX	Optional	99999
REF	REF	Optional	3
LE	LE	Mandatory	1
Loop N9	N9	Optional	1000
N9	N9	Mandatory	1
DTM	DTM	Optional	99999
MEA	MEA	Optional	40
MTX	MTX	Optional	99999
PWK	PWK	Optional	99999
EFI	EFI	Optional	99999
Loop N1	N1	Optional	200
N1	N1	Mandatory	1
N2	N2	Optional	2
IN2	IN2	Optional	99999
N3	N3	Optional	2
N4	N4	Optional	1
QTY	QTY	Optional	99999
NX2	NX2	Optional	99999
REF	REF	Optional	12
PER	PER	Optional	3
SI	SI	Optional	99999
DTM	DTM	Optional	1
FOB	FOB	Optional	1
SCH	SCH	Optional	200
TD1	TD1	Optional	2
TD5	TD5	Optional	12
TD3	TD3	Optional	12
TD4	TD4	Optional	5
PKG	PKG	Optional	200
Loop LDT	LDT	Optional	99999
LDT	LDT	Mandatory	1
MAN	MAN	Optional	10
QTY	QTY	Optional	5
MTX	MTX	Optional	99999
REF	REF	Optional	3
Loop SLN	SLN	Optional	1000
SLN	SLN	Mandatory	1
MTX	MTX	Optional	99999
SI	SI	Optional	99999
PID	PID	Optional	1000
PO3	PO3	Optional	104
MEA	MEA	Optional	99999
TC2	TC2	Optional	99999
ADV	ADV	Optional	99999
DTM	DTM	Optional	10
CTP	CTP	Optional	25
PAM	PAM	Optional	10
PO4	PO4	Optional	1
TAX	TAX	Optional	3
Loop N9	N9	Optional	99999
N9	N9	Mandatory	1
DTM	DTM	Optional	99999
MTX	MTX	Optional	99999
Loop SAC	SAC	Optional	25
SAC	SAC	Mandatory	1
CUR	CUR	Optional	1
CTP	CTP	Optional	1
Loop QTY	QTY	Optional	99999
QTY	QTY	Mandatory	1
SI	SI	Optional	99999
Loop N1	N1	Optional	10
N1	N1	Mandatory	1
N2	N2	Optional	2
IN2	IN2	Optional	99999
N3	N3	Optional	2
N4	N4	Optional	1
NX2	NX2	Optional	99999
REF	REF	Optional	12
PER	PER	Optional	3
SI	SI	Optional	99999
Loop AMT	AMT	Optional	99999
AMT	AMT	Mandatory	1
REF	REF	Optional	99999
PCT	PCT	Optional	99999
Loop LM	LM	Optional	99999
LM	LM	Mandatory	1
LQ	LQ	Mandatory	99999
Loop CTT	CTT	Optional	1
CTT	CTT	Mandatory	1
AMT	AMT	Optional	1
SE	Transaction Set Trailer	Mandatory	1