MSCONS Metered services consumption report message (D97A)

This is the standard EDIFACT D97A spec, with 11 loops and 31 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 (52 KB) Generate classes
The ediFabric .NET template, class TSMSCONS. It needs the common segments, composites and codes of EDIFACT D97A, one download for every transaction in the version. Download C# (1 KB) Common files (47 KB)
The intermediary model ediFabric Native loads with set_map. Native supports X12 today, and EDIFACT is coming. Download Native (1 KB)

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

ediFabric Native

Native supports X12 today, and EDIFACT is coming. When it's available, map version D97A to this Native model with set_map to parse MSCONS 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 MSCONS classes in Python, Java, Node.js, Go, Rust or C

The OpenEDI file describes each MSCONS as JSON. To work with MSCONS data as typed objects, generate classes from the OpenEDI file in your language; the root class is TSMSCONS. 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.

MSCONS structure

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

IDNameUsageMax use
UNHMessage HeaderOptional1
BGMBEGINNING OF MESSAGEMandatory1
DTMDATE/TIME/PERIODMandatory9
Loop RFFREFERENCEOptional9
RFFREFERENCEMandatory1
DTMDATE/TIME/PERIODOptional9
Loop NADNAME AND ADDRESSOptional99
NADNAME AND ADDRESSMandatory1
Loop RFFREFERENCEOptional9
RFFREFERENCEMandatory1
DTMDATE/TIME/PERIODOptional9
Loop CTACONTACT INFORMATIONOptional9
CTACONTACT INFORMATIONMandatory1
COMCOMMUNICATION CONTACTOptional9
UNSSECTION CONTROLMandatory1
Loop NADNAME AND ADDRESSMandatory99999
NADNAME AND ADDRESSMandatory1
Loop LOCPLACE/LOCATION IDENTIFICATIONMandatory99999
LOCPLACE/LOCATION IDENTIFICATIONMandatory1
DTMDATE/TIME/PERIODOptional9
Loop RFFREFERENCEOptional99
RFFREFERENCEMandatory1
DTMDATE/TIME/PERIODOptional9
Loop CCICHARACTERISTIC/CLASS IDOptional99
CCICHARACTERISTIC/CLASS IDMandatory1
DTMDATE/TIME/PERIODOptional99
Loop LINLINE ITEMOptional99999
LINLINE ITEMMandatory1
PIAADDITIONAL PRODUCT IDOptional9
IMDITEM DESCRIPTIONOptional9
PRIPRICE DETAILSOptional9
NADNAME AND ADDRESSOptional9
MOAMONETARY AMOUNTOptional9
Loop QTYQUANTITYMandatory9999
QTYQUANTITYMandatory1
DTMDATE/TIME/PERIODOptional9
Loop CCICHARACTERISTIC/CLASS IDOptional99
CCICHARACTERISTIC/CLASS IDMandatory1
MEAMEASUREMENTSOptional99
DTMDATE/TIME/PERIODOptional9
CNTCONTROL TOTALOptional99
UNTMessage TrailerOptional1