INVOIC Invoice (12.1)

This is the standard IATA PADIS 12.1 spec, with 51 loops and 75 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 (69 KB) Generate classes

The ediFabric .NET template, class TSINVOIC. It needs the common segments, composites and codes of IATA PADIS 12.1, one download for every transaction in the version. Download C# (2 KB) Common files (55 KB)

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

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

ediFabric Native

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

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

INVOIC structure

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

ID	Name	Usage	Max use
UNH	UNH	Mandatory	1
BGM	BGM	Mandatory	1
DTM	DTM	Mandatory	3
PAI	PAI	Optional	1
IMD	IMD	Optional	1
FTX	FTX	Optional	10
Loop RFF	RFF	Optional	3
RFF	RFF	Mandatory	1
DTM	DTM	Optional	1
Loop NAD	NAD	Optional	3
NAD	NAD	Mandatory	1
LOC	LOC	Optional	1
FII	FII	Optional	5
Loop RFF	RFF	Optional	3
RFF	RFF	Mandatory	1
Loop DOC	DOC	Optional	1
DOC	DOC	Mandatory	1
Loop CTA	CTA	Optional	5
CTA	CTA	Mandatory	1
COM	COM	Optional	5
Loop TAX	TAX	Optional	1
TAX	TAX	Mandatory	1
Loop CUX	CUX	Optional	5
CUX	CUX	Mandatory	1
DTM	DTM	Optional	1
Loop PAT	PAT	Optional	10
PAT	PAT	Mandatory	1
DTM	DTM	Optional	5
PCD	PCD	Optional	1
Loop TDT	TDT	Optional	1
TDT	TDT	Mandatory	1
Loop LOC	LOC	Optional	1
LOC	LOC	Mandatory	1
Loop RFF	RFF	Optional	1
RFF	RFF	Mandatory	1
Loop TOD	TOD	Optional	1
TOD	TOD	Mandatory	1
Loop PAC	PAC	Optional	1
PAC	PAC	Mandatory	1
Loop PCI	PCI	Optional	1
PCI	PCI	Mandatory	1
Loop ALC	ALC	Optional	1
ALC	ALC	Mandatory	1
Loop RFF	RFF	Optional	1
RFF	RFF	Mandatory	1
Loop QTY	QTY	Optional	1
QTY	QTY	Mandatory	1
Loop PCD	PCD	Optional	1
PCD	PCD	Mandatory	1
Loop MOA	MOA	Optional	1
MOA	MOA	Mandatory	1
Loop RTE	RTE	Optional	1
RTE	RTE	Mandatory	1
Loop TAX	TAX	Optional	1
TAX	TAX	Mandatory	1
Loop RCS	RCS	Optional	1
RCS	RCS	Mandatory	1
Loop AJT	AJT	Optional	1
AJT	AJT	Mandatory	1
Loop INP	INP	Optional	1
INP	INP	Mandatory	1
Loop LIN	LIN	Optional	9999999
LIN	LIN	Mandatory	1
IMD	IMD	Optional	10
MEA	MEA	Optional	5
QTY	QTY	Optional	5
DTM	DTM	Optional	35
FTX	FTX	Optional	5
Loop MOA	MOA	Optional	5
MOA	MOA	Mandatory	1
Loop PAT	PAT	Optional	1
PAT	PAT	Mandatory	1
Loop PRI	PRI	Optional	25
PRI	PRI	Mandatory	1
Loop RFF	RFF	Optional	10
RFF	RFF	Mandatory	1
Loop PAC	PAC	Optional	1
PAC	PAC	Mandatory	1
Loop PCI	PCI	Optional	1
PCI	PCI	Mandatory	1
Loop LOC	LOC	Optional	1
LOC	LOC	Mandatory	1
Loop TAX	TAX	Optional	20
TAX	TAX	Mandatory	1
Loop NAD	NAD	Optional	1
NAD	NAD	Mandatory	1
Loop RFF	RFF	Optional	1
RFF	RFF	Mandatory	1
Loop DOC	DOC	Optional	1
DOC	DOC	Mandatory	1
Loop CTA	CTA	Optional	1
CTA	CTA	Mandatory	1
Loop ALC	ALC	Optional	15
ALC	ALC	Mandatory	1
DTM	DTM	Optional	5
Loop QTY	QTY	Optional	1
QTY	QTY	Mandatory	1
Loop PCD	PCD	Optional	1
PCD	PCD	Mandatory	1
Loop MOA	MOA	Optional	1
MOA	MOA	Mandatory	1
Loop RTE	RTE	Optional	1
RTE	RTE	Mandatory	1
Loop TAX	TAX	Optional	1
TAX	TAX	Mandatory	1
Loop TDT	TDT	Optional	10
TDT	TDT	Mandatory	1
Loop LOC	LOC	Optional	10
LOC	LOC	Mandatory	1
DTM	DTM	Optional	5
Loop TOD	TOD	Optional	1
TOD	TOD	Mandatory	1
Loop RCS	RCS	Optional	1
RCS	RCS	Mandatory	1
UNS	UNS	Mandatory	1
Loop MOA	MOA	Mandatory	10
MOA	MOA	Mandatory	1
Loop RFF	RFF	Optional	1
RFF	RFF	Mandatory	1
DTM	DTM	Optional	5
Loop TAX	TAX	Optional	10
TAX	TAX	Mandatory	1
MOA	MOA	Optional	2
Loop ALC	ALC	Optional	1
ALC	ALC	Mandatory	1
UNT	UNT	Mandatory	1