IFTFCC International transport freight costs and other charges message (D12A)

This is the standard EDIFACT D12A spec, with 45 loops and 148 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 (118 KB) Generate classes

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

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

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

ediFabric Native

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

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

IFTFCC structure

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

ID	Name	Usage	Max use
UNH	UNH	Mandatory	1
BGM	BGM	Mandatory	1
CTA	CTA	Optional	1
COM	COM	Optional	9
FTX	FTX	Optional	99
DTM	DTM	Optional	9
TSR	TSR	Optional	9
DOC	DOC	Optional	9
Loop LOC	LOC	Optional	9
LOC	LOC	Mandatory	1
DTM	DTM	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop MOA	MOA	Optional	99
MOA	MOA	Mandatory	1
PCD	PCD	Optional	1
Loop TAX	TAX	Optional	9
TAX	TAX	Mandatory	1
PCD	PCD	Optional	1
MOA	MOA	Optional	2
Loop CUX	CUX	Optional	9
CUX	CUX	Mandatory	1
DTM	DTM	Optional	9
Loop TCC	TCC	Optional	999
TCC	TCC	Mandatory	1
LOC	LOC	Optional	9
DTM	DTM	Optional	9
RFF	RFF	Optional	9
FTX	FTX	Optional	9
PCD	PCD	Optional	9
QTY	QTY	Optional	9
Loop PRI	PRI	Optional	9
PRI	PRI	Mandatory	1
CUX	CUX	Optional	9
Loop MOA	MOA	Optional	9
MOA	MOA	Mandatory	1
Loop CUX	CUX	Optional	1
CUX	CUX	Mandatory	1
DTM	DTM	Optional	1
PCD	PCD	Optional	1
Loop TAX	TAX	Optional	1
TAX	TAX	Mandatory	1
PCD	PCD	Optional	1
Loop NAD	NAD	Optional	99
NAD	NAD	Mandatory	1
FII	FII	Optional	9
LOC	LOC	Optional	9
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 TOD	TOD	Optional	5
TOD	TOD	Mandatory	1
LOC	LOC	Optional	2
Loop CPI	CPI	Optional	9
CPI	CPI	Mandatory	1
CUX	CUX	Optional	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
Loop PYT	PYT	Optional	5
PYT	PYT	Mandatory	1
DTM	DTM	Optional	5
PCD	PCD	Optional	1
MOA	MOA	Optional	1
Loop TDT	TDT	Optional	99
TDT	TDT	Mandatory	1
TCC	TCC	Optional	99
DTM	DTM	Optional	9
LOC	LOC	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	1
Loop GID	GID	Optional	99
GID	GID	Mandatory	1
TCC	TCC	Optional	99
HAN	HAN	Optional	1
TMP	TMP	Optional	1
TMD	TMD	Optional	1
LOC	LOC	Optional	9
PCI	PCI	Optional	9
PIA	PIA	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 RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	1
Loop DGS	DGS	Optional	9
DGS	DGS	Mandatory	1
FTX	FTX	Optional	1
Loop EQD	EQD	Optional	999
EQD	EQD	Mandatory	1
TCC	TCC	Optional	99
EQN	EQN	Optional	1
TMD	TMD	Optional	1
MEA	MEA	Optional	9
DIM	DIM	Optional	9
SEL	SEL	Optional	99
TPL	TPL	Optional	9
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
DTM	DTM	Optional	1
Loop EQA	EQA	Optional	99
EQA	EQA	Mandatory	1
EQN	EQN	Optional	1
Loop CNI	CNI	Optional	99
CNI	CNI	Mandatory	1
TCC	TCC	Optional	99
DTM	DTM	Optional	9
TSR	TSR	Optional	9
FTX	FTX	Optional	9
MOA	MOA	Optional	9
Loop CUX	CUX	Optional	9
CUX	CUX	Mandatory	1
DTM	DTM	Optional	9
Loop LOC	LOC	Optional	9
LOC	LOC	Mandatory	1
DTM	DTM	Optional	9
Loop RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	9
Loop TOD	TOD	Optional	5
TOD	TOD	Mandatory	1
LOC	LOC	Optional	2
Loop CPI	CPI	Optional	9
CPI	CPI	Mandatory	1
CUX	CUX	Optional	1
LOC	LOC	Optional	9
MOA	MOA	Optional	9
Loop TDT	TDT	Optional	99
TDT	TDT	Mandatory	1
DTM	DTM	Optional	9
LOC	LOC	Optional	9
RFF	RFF	Optional	9
Loop NAD	NAD	Optional	99
NAD	NAD	Mandatory	1
Loop CTA	CTA	Optional	9
CTA	CTA	Mandatory	1
COM	COM	Optional	9
RFF	RFF	Optional	9
Loop GID	GID	Optional	99
GID	GID	Mandatory	1
TCC	TCC	Optional	99
HAN	HAN	Optional	1
TMP	TMP	Optional	1
TMD	TMD	Optional	1
LOC	LOC	Optional	9
PCI	PCI	Optional	9
PIA	PIA	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 RFF	RFF	Optional	9
RFF	RFF	Mandatory	1
DTM	DTM	Optional	1
Loop DGS	DGS	Optional	9
DGS	DGS	Mandatory	1
FTX	FTX	Optional	1
Loop EQD	EQD	Optional	999
EQD	EQD	Mandatory	1
TCC	TCC	Optional	99
EQN	EQN	Optional	1
TMD	TMD	Optional	1
MEA	MEA	Optional	9
DIM	DIM	Optional	9
SEL	SEL	Optional	99
TPL	TPL	Optional	9
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
DTM	DTM	Optional	1
Loop EQA	EQA	Optional	99
EQA	EQA	Mandatory	1
EQN	EQN	Optional	1
UNT	UNT	Mandatory	1