CONEST Establishment of contract message (D03B)

This is the standard EDIFACT D03B spec, with 34 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 (106 KB) Generate classes

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

The intermediary model ediFabric Native loads with set_map. Native supports X12 today, and EDIFACT is coming. Download Native (1 KB)

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

ediFabric Native

Native supports X12 today, and EDIFACT is coming. When it's available, map version D03B to this Native model with set_map to parse CONEST files to JSON from Python, Java, C or C#. See ediFabric Native.

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 CONEST classes in Python, Java, Node.js, Go, Rust or C

The OpenEDI file describes each CONEST as JSON. To work with CONEST data as typed objects, generate classes from the OpenEDI file in your language; the root class is TSCONEST. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats. Read more in Generate a class from OpenEDI.

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

CONEST structure

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

ID	Name	Usage	Max use
UNH	Message Header	Optional	1
BGM	BEGINNING OF MESSAGE	Mandatory	1
RFF	REFERENCE	Mandatory	1
DTM	DATE/TIME/PERIOD	Mandatory	1
AUT	AUTHENTICATION RESULT	Optional	2
AGR	AGREEMENT IDENTIFICATION	Optional	2
Loop IND	INDEX DETAILS	Optional	1000
IND	INDEX DETAILS	Mandatory	1
RCS	REQUIREMENTS AND CONDITIONS	Mandatory	1
Loop GEI	PROCESSING INFORMATION	Mandatory	1
GEI	PROCESSING INFORMATION	Mandatory	1
Loop BII	STRUCTURE IDENTIFICATION	Mandatory	1
BII	STRUCTURE IDENTIFICATION	Mandatory	1
IMD	ITEM DESCRIPTION	Mandatory	9
Loop BII	STRUCTURE IDENTIFICATION	Optional	1000
BII	STRUCTURE IDENTIFICATION	Mandatory	1
RCS	REQUIREMENTS AND CONDITIONS	Mandatory	1
GEI	PROCESSING INFORMATION	Mandatory	10
NAD	NAME AND ADDRESS	Optional	1
LOC	PLACE/LOCATION IDENTIFICATION	Optional	1
APR	ADDITIONAL PRICE INFORMATION	Optional	1
ALI	ADDITIONAL INFORMATION	Optional	2
QTY	QUANTITY	Optional	5
DTM	DATE/TIME/PERIOD	Optional	10
RTE	RATE DETAILS	Optional	9
AGR	AGREEMENT IDENTIFICATION	Optional	99
Loop RFF	REFERENCE	Optional	10
RFF	REFERENCE	Mandatory	1
DTM	DATE/TIME/PERIOD	Optional	2
GEI	PROCESSING INFORMATION	Optional	5
FTX	FREE TEXT	Optional	5
Loop CUX	CURRENCIES	Optional	5
CUX	CURRENCIES	Mandatory	1
DTM	DATE/TIME/PERIOD	Optional	5
FTX	FREE TEXT	Optional	1
Loop ALC	ALLOWANCE OR CHARGE	Optional	99
ALC	ALLOWANCE OR CHARGE	Mandatory	1
RFF	REFERENCE	Optional	1
DTM	DATE/TIME/PERIOD	Optional	1
RNG	RANGE DETAILS	Optional	1
FTX	FREE TEXT	Optional	10
Loop PCD	PERCENTAGE DETAILS	Optional	20
PCD	PERCENTAGE DETAILS	Mandatory	1
RFF	REFERENCE	Optional	1
Loop RCS	REQUIREMENTS AND CONDITIONS	Optional	100
RCS	REQUIREMENTS AND CONDITIONS	Mandatory	1
BII	STRUCTURE IDENTIFICATION	Mandatory	1
FTX	FREE TEXT	Optional	9
Loop ARD	MONETARY AMOUNT FUNCTION	Mandatory	100
ARD	MONETARY AMOUNT FUNCTION	Mandatory	1
MOA	MONETARY AMOUNT	Mandatory	6
FTX	FREE TEXT	Optional	10
Loop TAX	DUTY/TAX/FEE DETAILS	Optional	5
TAX	DUTY/TAX/FEE DETAILS	Mandatory	1
MOA	MONETARY AMOUNT	Optional	1
LOC	PLACE/LOCATION IDENTIFICATION	Optional	5
Loop ALC	ALLOWANCE OR CHARGE	Optional	99
ALC	ALLOWANCE OR CHARGE	Mandatory	1
ALI	ADDITIONAL INFORMATION	Optional	5
RFF	REFERENCE	Optional	9
DTM	DATE/TIME/PERIOD	Optional	9
FTX	FREE TEXT	Optional	9
Loop QTY	QUANTITY	Optional	1
QTY	QUANTITY	Mandatory	1
RNG	RANGE DETAILS	Optional	1
Loop PCD	PERCENTAGE DETAILS	Optional	1
PCD	PERCENTAGE DETAILS	Mandatory	1
RNG	RANGE DETAILS	Optional	1
Loop MOA	MONETARY AMOUNT	Optional	1
MOA	MONETARY AMOUNT	Mandatory	1
RNG	RANGE DETAILS	Optional	1
Loop RTE	RATE DETAILS	Optional	1
RTE	RATE DETAILS	Mandatory	1
RNG	RANGE DETAILS	Optional	1
Loop TAX	DUTY/TAX/FEE DETAILS	Optional	5
TAX	DUTY/TAX/FEE DETAILS	Mandatory	1
MOA	MONETARY AMOUNT	Optional	1
Loop NAD	NAME AND ADDRESS	Optional	99
NAD	NAME AND ADDRESS	Mandatory	1
LOC	PLACE/LOCATION IDENTIFICATION	Optional	25
FII	FINANCIAL INSTITUTION INFORMATION	Optional	9
MOA	MONETARY AMOUNT	Optional	9
FTX	FREE TEXT	Optional	5
Loop RFF	REFERENCE	Optional	5
RFF	REFERENCE	Mandatory	1
DTM	DATE/TIME/PERIOD	Optional	5
Loop DOC	DOCUMENT/MESSAGE DETAILS	Optional	5
DOC	DOCUMENT/MESSAGE DETAILS	Mandatory	1
DTM	DATE/TIME/PERIOD	Optional	5
Loop CTA	CONTACT INFORMATION	Optional	5
CTA	CONTACT INFORMATION	Mandatory	1
COM	COMMUNICATION CONTACT	Optional	5
UNS	SECTION CONTROL	Mandatory	1
Loop BII	STRUCTURE IDENTIFICATION	Optional	9999
BII	STRUCTURE IDENTIFICATION	Mandatory	1
RCS	REQUIREMENTS AND CONDITIONS	Mandatory	1
GEI	PROCESSING INFORMATION	Mandatory	10
Loop RFF	REFERENCE	Optional	10
RFF	REFERENCE	Mandatory	1
DTM	DATE/TIME/PERIOD	Optional	1
Loop DIM	DIMENSIONS	Optional	100
DIM	DIMENSIONS	Mandatory	1
APR	ADDITIONAL PRICE INFORMATION	Optional	1
FTX	FREE TEXT	Optional	1
Loop LIN	LINE ITEM	Optional	100
LIN	LINE ITEM	Mandatory	1
Loop IMD	ITEM DESCRIPTION	Optional	1000
IMD	ITEM DESCRIPTION	Mandatory	1
RFF	REFERENCE	Optional	5
GEI	PROCESSING INFORMATION	Optional	5
Loop QTY	QUANTITY	Mandatory	1000
QTY	QUANTITY	Mandatory	1
GEI	PROCESSING INFORMATION	Optional	3
APR	ADDITIONAL PRICE INFORMATION	Optional	1
Loop PRI	PRICE DETAILS	Optional	3
PRI	PRICE DETAILS	Mandatory	1
GEI	PROCESSING INFORMATION	Mandatory	3
Loop ARD	MONETARY AMOUNT FUNCTION	Optional	2
ARD	MONETARY AMOUNT FUNCTION	Mandatory	1
MOA	MONETARY AMOUNT	Optional	1
Loop TAX	DUTY/TAX/FEE DETAILS	Optional	5
TAX	DUTY/TAX/FEE DETAILS	Mandatory	1
MOA	MONETARY AMOUNT	Optional	1
LOC	PLACE/LOCATION IDENTIFICATION	Optional	5
Loop RCS	REQUIREMENTS AND CONDITIONS	Optional	5
RCS	REQUIREMENTS AND CONDITIONS	Mandatory	1
BII	STRUCTURE IDENTIFICATION	Mandatory	1
GEI	PROCESSING INFORMATION	Mandatory	1
Loop ALC	ALLOWANCE OR CHARGE	Optional	2
ALC	ALLOWANCE OR CHARGE	Mandatory	1
RFF	REFERENCE	Optional	1
DTM	DATE/TIME/PERIOD	Optional	1
RNG	RANGE DETAILS	Optional	1
FTX	FREE TEXT	Optional	10
Loop PCD	PERCENTAGE DETAILS	Optional	20
PCD	PERCENTAGE DETAILS	Mandatory	1
RFF	REFERENCE	Optional	1
Loop IMD	ITEM DESCRIPTION	Optional	9
IMD	ITEM DESCRIPTION	Mandatory	1
QTY	QUANTITY	Optional	1
MOA	MONETARY AMOUNT	Optional	1
PRI	PRICE DETAILS	Optional	1
CNT	CONTROL TOTAL	Optional	10
UNT	Message Trailer	Optional	1