201 Residential Loan Application (007020)

This is the standard X12 007020 spec, with 17 loops and 98 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 (156 KB) Generate classes

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

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

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

ediFabric Native

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

ediFabric Native returns each 201 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 TS201. 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.

201 structure

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

ID	Name	Usage	Max use
ST	Transaction Set Header	Mandatory	1
BGN	BGN	Mandatory	1
Loop N1	N1	Mandatory	5
N1	N1	Mandatory	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
REF	REF	Optional	1
PER	PER	Optional	5
Loop LRQ	LRQ	Mandatory	99999
LRQ	LRQ	Mandatory	1
REF	REF	Mandatory	99999
YNQ	YNQ	Mandatory	99999
N1	N1	Mandatory	1
N2	N2	Optional	2
III	III	Optional	99999
DTP	DTP	Optional	1
RES	RES	Optional	99999
MCD	MCD	Optional	1
SOM	SOM	Optional	1
NTE	NTE	Optional	99999
LIN	LIN	Optional	99999
BEP	BEP	Optional	1
Loop NX1	NX1	Optional	10
NX1	NX1	Mandatory	1
NX2	NX2	Mandatory	30
REA	REA	Optional	1
PDS	PDS	Optional	10
PDE	PDE	Optional	50
QTY	QTY	Optional	99999
YNQ	YNQ	Optional	99999
Loop PEX	PEX	Mandatory	20
PEX	PEX	Mandatory	1
MSG	MSG	Optional	1
Loop AMT	AMT	Optional	99999
AMT	AMT	Mandatory	1
MSG	MSG	Optional	1
PCT	PCT	Optional	99999
Loop IN1	IN1	Mandatory	15
IN1	IN1	Mandatory	1
IN2	IN2	Mandatory	10
YNQ	YNQ	Mandatory	19
DTP	DTP	Optional	3
REF	REF	Optional	99999
AMT	AMT	Optional	99999
DMG	DMG	Optional	1
N10	N10	Optional	1
MSG	MSG	Optional	1
PER	PER	Optional	1
QTY	QTY	Optional	99999
FTH	FTH	Optional	1
PPY	PPY	Optional	20
Loop AIN	AIN	Optional	99999
AIN	AIN	Mandatory	1
YNQ	YNQ	Optional	99999
Loop PEX	PEX	Optional	20
PEX	PEX	Mandatory	1
MSG	MSG	Optional	1
Loop NX1	NX1	Optional	10
NX1	NX1	Mandatory	1
NX2	NX2	Mandatory	30
N10	N10	Optional	1
ARS	ARS	Optional	1
Loop N1	N1	Optional	20
N1	N1	Mandatory	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	1
YNQ	YNQ	Optional	1
EMS	EMS	Optional	1
QTY	QTY	Optional	99999
AMT	AMT	Optional	1
Loop REA	REA	Optional	20
REA	REA	Mandatory	1
AMT	AMT	Mandatory	6
NX1	NX1	Mandatory	1
NX2	NX2	Mandatory	30
Loop NM1	NM1	Optional	20
NM1	NM1	Mandatory	1
ACT	ACT	Optional	10
Loop CDA	CDA	Optional	100
CDA	CDA	Mandatory	1
YNQ	YNQ	Optional	99999
N1	N1	Optional	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	1
CRC	CRC	Optional	99999
Loop FAA	FAA	Optional	100
FAA	FAA	Mandatory	1
N1	N1	Optional	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	1
MSG	MSG	Optional	1
Loop LS	LS	Optional	1
LS	LS	Mandatory	1
Loop AMT	AMT	Optional	10
AMT	AMT	Mandatory	1
MSG	MSG	Optional	1
QTY	QTY	Optional	1
YNQ	YNQ	Optional	1
LE	LE	Mandatory	1
Loop LX	LX	Mandatory	99999
LX	LX	Mandatory	1
N1	N1	Optional	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	99999
DTP	DTP	Optional	1
SE	Transaction Set Trailer	Mandatory	1