840 Request for Quotation (005020)

This is the standard X12 005020 spec, with 22 loops and 161 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 (200 KB) Generate classes

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

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

Use the 840 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 840 files into TS840 objects. See ediFabric .NET.

ediFabric Native

Map version 005020 to the Native model with set_map, then parse 840 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 840 classes in Python, Java, Node.js, Go, Rust or C

ediFabric Native returns each 840 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 TS840. 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.

840 structure

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

ID	Name	Usage	Max use
ST	Transaction Set Header	Optional	1
BQT	Beginning Segment for Request for Quotation	Mandatory	1
CUR	Currency	Optional	1
INC	Installment Information	Optional	1
REF	Reference Information	Optional	>1
PER	Administrative Communications Contact	Optional	3
TAX	Tax Reference	Optional	3
FOB	F.O.B. Related Instructions	Optional	>1
CTP	Pricing Information	Optional	>1
PAM	Period Amount	Optional	10
CSH	Sales Requirements	Optional	25
SAC	Service, Promotion, Allowance, or Charge Information	Optional	25
ITD	Terms of Sale/Deferred Terms of Sale	Optional	5
DIS	Discount Detail	Optional	20
DTM	Date/Time Reference	Optional	10
LIN	Item Identification	Optional	5
PID	Product/Item Description	Optional	200
MEA	Measurements	Optional	40
PWK	Paperwork	Optional	25
PKG	Marking, Packaging, Loading	Optional	200
TD1	Carrier Details (Quantity and Weight)	Optional	2
TD5	Carrier Details (Routing Sequence/Transit Time)	Optional	12
TD3	Carrier Details (Equipment)	Optional	12
TD4	Carrier Details (Special Handling, or Hazardous Materials, or Both)	Optional	5
MAN	Marks and Numbers Information	Optional	10
RRA	Required Response	Optional	100
CTB	Restrictions/Conditions	Optional	>1
Loop LDT	Lead Time	Optional	>1
LDT	Lead Time	Mandatory	1
QTY	Quantity Information	Optional	>1
MTX	Text	Optional	>1
Loop N9	Extended Reference Information	Optional	1000
N9	Extended Reference Information	Mandatory	1
DTM	Date/Time Reference	Optional	>1
MTX	Text	Optional	>1
PWK	Paperwork	Optional	>1
EFI	Electronic Format Identification	Optional	>1
Loop N1	Party Identification	Optional	10000
N1	Party Identification	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Party Location	Optional	2
N4	Geographic Location	Optional	>1
REF	Reference Information	Optional	12
PER	Administrative Communications Contact	Optional	>1
SI	Service Characteristic Identification	Optional	>1
FOB	F.O.B. Related Instructions	Optional	1
TD1	Carrier Details (Quantity and Weight)	Optional	2
TD5	Carrier Details (Routing Sequence/Transit Time)	Optional	12
TD3	Carrier Details (Equipment)	Optional	12
TD4	Carrier Details (Special Handling, or Hazardous Materials, or Both)	Optional	5
PKG	Marking, Packaging, Loading	Optional	200
RRA	Required Response	Optional	25
Loop SPI	Specification Identifier	Optional	1
SPI	Specification Identifier	Mandatory	1
REF	Reference Information	Optional	5
DTM	Date/Time Reference	Optional	5
MTX	Text	Optional	>1
Loop N1	Party Identification	Optional	20
N1	Party Identification	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Party Location	Optional	2
N4	Geographic Location	Optional	1
REF	Reference Information	Optional	20
G61	Contact	Optional	1
MTX	Text	Optional	>1
Loop CB1	Contract and Cost Accounting Standards Data	Optional	>1
CB1	Contract and Cost Accounting Standards Data	Mandatory	1
REF	Reference Information	Optional	20
DTM	Date/Time Reference	Optional	5
LDT	Lead Time	Optional	1
MTX	Text	Optional	>1
Loop PCT	Percent Amounts	Optional	>1
PCT	Percent Amounts	Mandatory	1
AMT	Monetary Amount Information	Optional	>1
Loop ADV	Advertising Demographic Information	Optional	>1
ADV	Advertising Demographic Information	Mandatory	1
DTM	Date/Time Reference	Optional	>1
MTX	Text	Optional	>1
Loop LM	Code Source Information	Optional	>1
LM	Code Source Information	Mandatory	1
LQ	Industry Code Identification	Mandatory	>1
Loop PO1	Baseline Item Data	Mandatory	100000
PO1	Baseline Item Data	Mandatory	1
LIN	Item Identification	Optional	>1
G53	Maintenance Type	Optional	1
CUR	Currency	Optional	1
CN1	Contract Information	Optional	1
PO3	Additional Item Detail	Optional	25
CTP	Pricing Information	Optional	>1
PAM	Period Amount	Optional	10
CTB	Restrictions/Conditions	Optional	>1
MEA	Measurements	Optional	40
Loop PID	Product/Item Description	Optional	1000
PID	Product/Item Description	Mandatory	1
MEA	Measurements	Optional	10
PWK	Paperwork	Optional	25
PKG	Marking, Packaging, Loading	Optional	200
PO4	Item Physical Details	Optional	>1
REF	Reference Information	Optional	>1
PER	Administrative Communications Contact	Optional	3
SAC	Service, Promotion, Allowance, or Charge Information	Optional	25
IT8	Conditions of Sale	Optional	25
CSH	Sales Requirements	Optional	>1
ITD	Terms of Sale/Deferred Terms of Sale	Optional	2
DIS	Discount Detail	Optional	20
INC	Installment Information	Optional	1
TAX	Tax Reference	Optional	3
FOB	F.O.B. Related Instructions	Optional	>1
SDQ	Destination Quantity	Optional	50
DTM	Date/Time Reference	Optional	10
FST	Forecast Schedule	Optional	>1
TD1	Carrier Details (Quantity and Weight)	Optional	1
TD5	Carrier Details (Routing Sequence/Transit Time)	Optional	12
TD3	Carrier Details (Equipment)	Optional	12
TD4	Carrier Details (Special Handling, or Hazardous Materials, or Both)	Optional	5
MAN	Marks and Numbers Information	Optional	10
RRA	Required Response	Optional	25
MTX	Text	Optional	>1
SPI	Specification Identifier	Optional	>1
Loop LM	Code Source Information	Optional	>1
LM	Code Source Information	Mandatory	1
LQ	Industry Code Identification	Mandatory	>1
Loop QTY	Quantity Information	Optional	>1
QTY	Quantity Information	Mandatory	1
SI	Service Characteristic Identification	Optional	>1
Loop SCH	Line Item Schedule	Optional	104
SCH	Line Item Schedule	Mandatory	1
TD1	Carrier Details (Quantity and Weight)	Optional	2
TD5	Carrier Details (Routing Sequence/Transit Time)	Optional	12
TD3	Carrier Details (Equipment)	Optional	12
TD4	Carrier Details (Special Handling, or Hazardous Materials, or Both)	Optional	5
REF	Reference Information	Optional	>1
Loop LDT	Lead Time	Optional	>1
LDT	Lead Time	Mandatory	1
QTY	Quantity Information	Optional	>1
MTX	Text	Optional	>1
Loop LM	Code Source Information	Optional	1
LM	Code Source Information	Mandatory	1
LQ	Industry Code Identification	Mandatory	1
Loop SLN	Subline Item Detail	Optional	1000
SLN	Subline Item Detail	Mandatory	1
MTX	Text	Optional	>1
PID	Product/Item Description	Optional	1000
ADV	Advertising Demographic Information	Optional	>1
Loop QTY	Quantity Information	Optional	>1
QTY	Quantity Information	Mandatory	1
SI	Service Characteristic Identification	Optional	>1
Loop N9	Extended Reference Information	Optional	1000
N9	Extended Reference Information	Mandatory	1
DTM	Date/Time Reference	Optional	>1
MTX	Text	Optional	>1
PWK	Paperwork	Optional	>1
EFI	Electronic Format Identification	Optional	>1
Loop N1	Party Identification	Optional	>1
N1	Party Identification	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Party Location	Optional	2
N4	Geographic Location	Optional	1
QTY	Quantity Information	Optional	>1
REF	Reference Information	Optional	12
PER	Administrative Communications Contact	Optional	3
SI	Service Characteristic Identification	Optional	>1
DTM	Date/Time Reference	Optional	1
FOB	F.O.B. Related Instructions	Optional	1
SCH	Line Item Schedule	Optional	200
TD1	Carrier Details (Quantity and Weight)	Optional	2
TD5	Carrier Details (Routing Sequence/Transit Time)	Optional	12
TD3	Carrier Details (Equipment)	Optional	12
TD4	Carrier Details (Special Handling, or Hazardous Materials, or Both)	Optional	5
PKG	Marking, Packaging, Loading	Optional	200
RRA	Required Response	Optional	25
CTP	Pricing Information	Optional	1
PAM	Period Amount	Optional	10
Loop LDT	Lead Time	Optional	>1
LDT	Lead Time	Mandatory	1
MAN	Marks and Numbers Information	Optional	10
QTY	Quantity Information	Optional	5
MTX	Text	Optional	>1
Loop PCT	Percent Amounts	Optional	>1
PCT	Percent Amounts	Mandatory	1
AMT	Monetary Amount Information	Optional	>1
CTT	Transaction Totals	Optional	1
SE	Transaction Set Trailer	Optional	1