189 Application for Admission to Educational Institutions (004030)

This is the standard X12 004030 spec, with 23 loops and 83 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 (119 KB) Generate classes

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

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

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

ediFabric Native

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

ediFabric Native returns each 189 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 TS189. 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.

189 structure

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

ID	Name	Usage	Max use
ST	Transaction Set Header	Optional	1
BGN	Beginning Segment	Mandatory	1
Loop N1	Name	Mandatory	2
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	1
N3	Address Information	Optional	1
N4	Geographic Location	Optional	1
PER	Administrative Communications Contact	Optional	1
Loop REF	Reference Identification	Mandatory	15
REF	Reference Identification	Mandatory	1
DTP	Date or Time or Period	Optional	2
N4	Geographic Location	Optional	1
N1	Name	Optional	1
Loop IN1	Individual Identification	Mandatory	10
IN1	Individual Identification	Mandatory	1
IN2	Individual Name Structure Components	Mandatory	10
REF	Reference Identification	Optional	10
DMG	Demographic Information	Optional	1
IND	Additional Individual Demographic Information	Optional	1
IMM	Immunization Status Code	Optional	>1
HC	Health Condition	Optional	>1
LUI	Language Use	Optional	>1
III	Information	Optional	10
NTE	Note/Special Instruction	Optional	1
Loop N3	Address Information	Optional	5
N3	Address Information	Mandatory	1
N4	Geographic Location	Optional	1
DTP	Date or Time or Period	Optional	2
Loop COM	Communication Contact Information	Optional	10
COM	Communication Contact Information	Mandatory	1
DTP	Date or Time or Period	Optional	2
Loop N1	Name	Optional	5
N1	Name	Mandatory	1
N3	Address Information	Optional	1
N4	Geographic Location	Optional	1
Loop EMS	Employment Position	Optional	5
EMS	Employment Position	Mandatory	1
DTP	Date or Time or Period	Optional	2
QTY	Quantity	Optional	1
Loop ATV	Student Activities and Awards	Optional	>1
ATV	Student Activities and Awards	Mandatory	1
DTP	Date or Time or Period	Optional	2
Loop AMT	Monetary Amount	Optional	15
AMT	Monetary Amount	Mandatory	1
MSG	Message Text	Optional	1
Loop SSE	Entry and Exit Information	Optional	5
SSE	Entry and Exit Information	Mandatory	1
DEG	Degree Record	Optional	1
FOS	Field of Study	Optional	5
Loop RSD	Residency Information	Optional	>1
RSD	Residency Information	Mandatory	1
N4	Geographic Location	Mandatory	1
DTP	Date or Time or Period	Optional	>1
QTY	Quantity	Optional	1
REF	Reference Identification	Optional	1
Loop RQS	Request for Information	Optional	>1
RQS	Request for Information	Mandatory	1
MSG	Message Text	Optional	>1
Loop SST	Student Academic Status	Optional	10
SST	Student Academic Status	Mandatory	1
SSE	Entry and Exit Information	Optional	1
N1	Name	Optional	2
N3	Address Information	Optional	1
N4	Geographic Location	Optional	1
SUM	Academic Summary	Optional	5
Loop SES	Academic Session Header	Optional	20
SES	Academic Session Header	Mandatory	1
Loop CRS	Course Record	Optional	50
CRS	Course Record	Mandatory	1
NTE	Note/Special Instruction	Optional	1
Loop TST	Test Score Record	Optional	>1
TST	Test Score Record	Mandatory	1
Loop SBT	Subtest	Optional	>1
SBT	Subtest	Mandatory	1
SRE	Test Scores	Optional	3
NTE	Note/Special Instruction	Optional	2
Loop PCL	Previous College	Optional	25
PCL	Previous College	Mandatory	1
N3	Address Information	Optional	1
N4	Geographic Location	Optional	1
SSE	Entry and Exit Information	Optional	1
SUM	Academic Summary	Optional	1
Loop SES	Academic Session Header	Optional	1000
SES	Academic Session Header	Mandatory	1
Loop CRS	Course Record	Optional	50
CRS	Course Record	Mandatory	1
NTE	Note/Special Instruction	Optional	1
Loop DEG	Degree Record	Optional	10
DEG	Degree Record	Mandatory	1
SUM	Academic Summary	Optional	1
FOS	Field of Study	Optional	30
NTE	Note/Special Instruction	Optional	30
Loop LX	Assigned Number	Optional	1
LX	Assigned Number	Mandatory	1
MSG	Message Text	Mandatory	>1
Loop LT	Letter of Recommendation	Optional	15
LT	Letter of Recommendation	Mandatory	1
DTP	Date or Time or Period	Optional	1
QTY	Quantity	Optional	1
COM	Communication Contact Information	Optional	5
N1	Name	Optional	1
N3	Address Information	Optional	1
N4	Geographic Location	Optional	1
LTE	Letter of Recommendation Evaluation	Optional	15
MSG	Message Text	Optional	>1
SE	Transaction Set Trailer	Optional	1