IFCSUM Forwarding and consolidation summary message (D17A)

This is the standard EDIFACT D17A spec, with 80 loops and 278 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 (139 KB) Generate classes

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

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

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

ediFabric Native

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

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

IFCSUM structure

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

ID	Name	Usage	Max use
UNH	UNH	Mandatory	1
BGM	BGM	Mandatory	1
DTM	DTM	Optional	9
MOA	MOA	Optional	99
FTX	FTX	Optional	99
CNT	CNT	Optional	9
PCD	PCD	Optional	1
GDS	GDS	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop GOR	GOR	Optional	9
GOR	GOR	Mandatory	1
DTM	DTM	Optional	9
LOC	LOC	Optional	9
SEL	SEL	Optional	9
FTX	FTX	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	1
Loop NAD	NAD	Optional	9
NAD	NAD	Mandatory	1
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop TCC	TCC	Optional	9
TCC	TCC	Mandatory	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
LOC	LOC	Optional	9
Loop ICD	ICD	Optional	99
ICD	ICD	Mandatory	1
DTM	DTM	Optional	1
FTX	FTX	Optional	9
Loop TDT	TDT	Optional	9
TDT	TDT	Mandatory	1
DTM	DTM	Optional	9
Loop TSR	TSR	Optional	9
TSR	TSR	Mandatory	1
SCC	SCC	Optional	9
Loop LOC	LOC	Optional	9
LOC	LOC	Mandatory	1
DTM	DTM	Optional	9
SEL	SEL	Optional	9
FTX	FTX	Optional	9
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop DIM	DIM	Optional	9
DIM	DIM	Mandatory	1
EQN	EQN	Optional	1
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
MOA	MOA	Optional	9
PCD	PCD	Optional	1
Loop ICD	ICD	Optional	99
ICD	ICD	Mandatory	1
DTM	DTM	Optional	1
FTX	FTX	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop NAD	NAD	Optional	9
NAD	NAD	Mandatory	1
LOC	LOC	Optional	9
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	1
Loop TCC	TCC	Optional	9
TCC	TCC	Mandatory	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop EQD	EQD	Optional	9999
EQD	EQD	Mandatory	1
EQN	EQN	Optional	1
TPL	TPL	Optional	1
TMD	TMD	Optional	1
MEA	MEA	Optional	9
DIM	DIM	Optional	9
SEL	SEL	Optional	9
NAD	NAD	Optional	9
LOC	LOC	Optional	9
HAN	HAN	Optional	1
TMP	TMP	Optional	1
FTX	FTX	Optional	9
RFF	RFF	Optional	9
PCD	PCD	Optional	9
Loop EQA	EQA	Optional	99
EQA	EQA	Mandatory	1
EQN	EQN	Optional	1
Loop DGS	DGS	Optional	99
DGS	DGS	Mandatory	1
FTX	FTX	Optional	9
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop EFI	EFI	Optional	99
EFI	EFI	Mandatory	1
CED	CED	Optional	99
COM	COM	Optional	9
RFF	RFF	Optional	9
DTM	DTM	Optional	9
QTY	QTY	Optional	9
Loop CNI	CNI	Optional	9999
CNI	CNI	Mandatory	1
Loop SGP	SGP	Optional	9
SGP	SGP	Mandatory	1
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop TPL	TPL	Optional	9
TPL	TPL	Mandatory	1
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
CTA	CTA	Optional	1
COM	COM	Optional	9
DTM	DTM	Optional	9
CNT	CNT	Optional	9
TSR	TSR	Optional	9
CUX	CUX	Optional	9
PCD	PCD	Optional	9
MOA	MOA	Optional	99
FTX	FTX	Optional	99
GDS	GDS	Optional	9
Loop LOC	LOC	Optional	99
LOC	LOC	Mandatory	1
DTM	DTM	Optional	9
Loop TOD	TOD	Optional	2
TOD	TOD	Mandatory	1
LOC	LOC	Optional	9
Loop RFF	RFF	Optional	999
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop GOR	GOR	Optional	9
GOR	GOR	Mandatory	1
DTM	DTM	Optional	9
LOC	LOC	Optional	9
SEL	SEL	Optional	9
FTX	FTX	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	1
Loop CPI	CPI	Optional	9
CPI	CPI	Mandatory	1
RFF	RFF	Optional	99
CUX	CUX	Optional	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
LOC	LOC	Optional	1
FTX	FTX	Optional	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
Loop ICD	ICD	Optional	99
ICD	ICD	Mandatory	1
DTM	DTM	Optional	1
FTX	FTX	Optional	9
Loop TDT	TDT	Optional	99
TDT	TDT	Mandatory	1
DTM	DTM	Optional	9
Loop TSR	TSR	Optional	9
TSR	TSR	Mandatory	1
SCC	SCC	Optional	9
Loop LOC	LOC	Optional	99
LOC	LOC	Mandatory	1
DTM	DTM	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	1
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
MOA	MOA	Optional	9
PCD	PCD	Optional	1
Loop ICD	ICD	Optional	99
ICD	ICD	Mandatory	1
DTM	DTM	Optional	1
FTX	FTX	Optional	9
Loop NAD	NAD	Optional	99
NAD	NAD	Mandatory	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	1
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop CPI	CPI	Optional	9
CPI	CPI	Mandatory	1
RFF	RFF	Optional	99
CUX	CUX	Optional	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
Loop TSR	TSR	Optional	99
TSR	TSR	Mandatory	1
RFF	RFF	Optional	1
LOC	LOC	Optional	1
TPL	TPL	Optional	1
FTX	FTX	Optional	9
Loop EFI	EFI	Optional	99
EFI	EFI	Mandatory	1
CED	CED	Optional	99
COM	COM	Optional	9
RFF	RFF	Optional	9
DTM	DTM	Optional	9
QTY	QTY	Optional	9
Loop GID	GID	Optional	99999
GID	GID	Mandatory	1
HAN	HAN	Optional	1
TMP	TMP	Optional	1
RNG	RNG	Optional	1
TMD	TMD	Optional	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
PIA	PIA	Optional	9
GIN	GIN	Optional	99
FTX	FTX	Optional	9
Loop NAD	NAD	Optional	9
NAD	NAD	Mandatory	1
DTM	DTM	Optional	1
GDS	GDS	Optional	9
Loop MEA	MEA	Optional	99
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop DIM	DIM	Optional	99
DIM	DIM	Mandatory	1
EQN	EQN	Optional	1
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop PCI	PCI	Optional	999
PCI	PCI	Mandatory	1
RFF	RFF	Optional	1
DTM	DTM	Optional	1
GIN	GIN	Optional	9999
MEA	MEA	Optional	9
DIM	DIM	Optional	1
FTX	FTX	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	9
Loop GOR	GOR	Optional	9
GOR	GOR	Mandatory	1
DTM	DTM	Optional	9
LOC	LOC	Optional	9
SEL	SEL	Optional	9
FTX	FTX	Optional	9
Loop DOC	DOC	Optional	9
DOC	DOC	Mandatory	1
DTM	DTM	Optional	1
Loop TPL	TPL	Optional	9
TPL	TPL	Mandatory	1
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop SGP	SGP	Optional	999
SGP	SGP	Mandatory	1
SEQ	SEQ	Optional	1
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
LOC	LOC	Optional	9
Loop ICD	ICD	Optional	99
ICD	ICD	Mandatory	1
DTM	DTM	Optional	1
FTX	FTX	Optional	9
Loop DGS	DGS	Optional	99
DGS	DGS	Mandatory	1
FTX	FTX	Optional	99
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop SGP	SGP	Optional	999
SGP	SGP	Mandatory	1
Loop MEA	MEA	Optional	9
MEA	MEA	Mandatory	1
EQN	EQN	Optional	1
Loop EQD	EQD	Optional	999
EQD	EQD	Mandatory	1
EQN	EQN	Optional	1
TMD	TMD	Optional	1
MEA	MEA	Optional	9
DIM	DIM	Optional	9
SEL	SEL	Optional	99
TPL	TPL	Optional	9
HAN	HAN	Optional	1
TMP	TMP	Optional	1
FTX	FTX	Optional	9
PCD	PCD	Optional	9
Loop TCC	TCC	Optional	99
TCC	TCC	Mandatory	1
CUX	CUX	Optional	1
PRI	PRI	Optional	1
EQN	EQN	Optional	1
PCD	PCD	Optional	1
MOA	MOA	Optional	9
QTY	QTY	Optional	9
Loop NAD	NAD	Optional	9
NAD	NAD	Mandatory	1
DTM	DTM	Optional	1
Loop EQA	EQA	Optional	99
EQA	EQA	Mandatory	1
EQN	EQN	Optional	1
Loop DGS	DGS	Optional	99
DGS	DGS	Mandatory	1
FTX	FTX	Optional	9
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
UNT	UNT	Mandatory	1