834 Benefit Enrollment and Maintenance (007020)

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

The ediFabric .NET template, class TS834. 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 (105 KB)

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

ediFabric Native

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

ediFabric Native returns each 834 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 TS834. 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.

834 structure

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

ID	Name	Usage	Max use
ST	Transaction Set Header	Mandatory	1
BGN	BGN	Mandatory	1
REF	REF	Optional	99999
DTP	DTP	Optional	99999
AMT	AMT	Optional	99999
QTY	QTY	Optional	99999
Loop N1	N1	Mandatory	99999
N1	N1	Mandatory	1
N2	N2	Optional	2
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	3
Loop ACT	ACT	Optional	10
ACT	ACT	Mandatory	1
REF	REF	Optional	5
N3	N3	Optional	1
N4	N4	Optional	1
PER	PER	Optional	5
DTP	DTP	Optional	1
AMT	AMT	Optional	1
Loop INS	INS	Optional	99999
INS	INS	Mandatory	1
REF	REF	Mandatory	99999
DTP	DTP	Optional	99999
Loop NM1	NM1	Optional	99999
NM1	NM1	Mandatory	1
PER	PER	Optional	1
N3	N3	Optional	1
N4	N4	Optional	1
DMG	DMG	Optional	1
PM	PM	Optional	1
EC	EC	Optional	99999
ICM	ICM	Optional	1
AMT	AMT	Optional	10
HLH	HLH	Optional	1
HI	HI	Optional	10
LUI	LUI	Optional	99999
Loop DSB	DSB	Optional	4
DSB	DSB	Mandatory	1
DTP	DTP	Optional	10
AD1	AD1	Optional	10
Loop HD	HD	Optional	99
HD	HD	Mandatory	1
DTP	DTP	Optional	10
AMT	AMT	Optional	99999
REF	REF	Optional	99999
IDC	IDC	Optional	99999
Loop LX	LX	Optional	30
LX	LX	Mandatory	1
NM1	NM1	Optional	1
N1	N1	Optional	3
N2	N2	Optional	1
N3	N3	Optional	2
N4	N4	Optional	2
PER	PER	Optional	2
PRV	PRV	Optional	1
DTP	DTP	Optional	6
PLA	PLA	Optional	1
Loop COB	COB	Optional	10
COB	COB	Mandatory	1
REF	REF	Optional	99999
DTP	DTP	Optional	2
Loop NM1	NM1	Optional	3
NM1	NM1	Mandatory	1
N2	N2	Optional	1
N3	N3	Optional	2
N4	N4	Optional	1
PER	PER	Optional	1
Loop LC	LC	Optional	10
LC	LC	Mandatory	1
AMT	AMT	Optional	5
DTP	DTP	Optional	2
REF	REF	Optional	99999
Loop BEN	BEN	Optional	20
BEN	BEN	Mandatory	1
NM1	NM1	Optional	1
N1	N1	Optional	1
N2	N2	Optional	1
N3	N3	Optional	1
N4	N4	Optional	1
DMG	DMG	Optional	1
Loop FSA	FSA	Optional	10
FSA	FSA	Mandatory	1
AMT	AMT	Optional	10
DTP	DTP	Optional	10
REF	REF	Optional	99999
Loop RP	RP	Optional	99999
RP	RP	Mandatory	1
DTP	DTP	Optional	99999
REF	REF	Optional	99999
INV	INV	Optional	99999
AMT	AMT	Optional	20
QTY	QTY	Optional	20
K3	K3	Optional	3
REL	REL	Optional	1
Loop NM1	NM1	Optional	99999
NM1	NM1	Mandatory	1
N2	N2	Optional	1
DMG	DMG	Optional	1
BEN	BEN	Optional	1
REF	REF	Optional	99999
Loop NX1	NX1	Optional	99999
NX1	NX1	Mandatory	1
N3	N3	Optional	1
N4	N4	Optional	1
DTP	DTP	Optional	99999
Loop FC	FC	Optional	99999
FC	FC	Mandatory	1
DTP	DTP	Optional	99999
Loop INV	INV	Optional	99999
INV	INV	Mandatory	1
DTP	DTP	Optional	99999
QTY	QTY	Optional	99999
ENT	ENT	Optional	99999
REF	REF	Optional	99999
AMT	AMT	Optional	20
K3	K3	Optional	3
Loop AIN	AIN	Optional	99999
AIN	AIN	Mandatory	1
QTY	QTY	Optional	99999
DTP	DTP	Optional	99999
Loop LS	LS	Optional	1
LS	LS	Mandatory	1
Loop LX	LX	Optional	99999
LX	LX	Mandatory	1
Loop N1	N1	Mandatory	99999
N1	N1	Mandatory	1
REF	REF	Mandatory	1
DTP	DTP	Optional	1
LE	LE	Mandatory	1
SE	Transaction Set Trailer	Mandatory	1