210 Motor Carrier Freight Details and Invoice (003070)

This is the standard X12 003070 spec, with 12 loops and 63 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 (91 KB) Generate classes

The ediFabric .NET template, class TS210. It needs the common segments, composites and codes of X12 003070, one download for every transaction in the version. Download C# (1 KB) Common files (238 KB)

The intermediary model ediFabric Native loads with set_map. Download Native (78 KB)

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

ediFabric Native

Map version 003070 to the Native model with set_map, then parse 210 files to JSON from Python, Java, C or C#. See Convert between EDI and JSON.

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

ediFabric Native returns each 210 as JSON, with the property names of the OpenEDI schema. To work with that JSON as typed objects, generate classes from the OpenEDI file in your language and deserialize the JSON into TS210. Serialize the objects back to JSON to build EDI with ediFabric Native. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats, so validate files with ediFabric Native. Read more in Generate a class from OpenEDI.

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

For a sample file, the same data as JSON, and code to parse, validate and generate the 210, see the 210 transaction guide.

210 structure

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

ID	Name	Usage	Max use
ST	Transaction Set Header	Optional	1
B3	Beginning Segment for Carrier's Invoice	Mandatory	1
B2A	Set Purpose	Mandatory	1
C2	Bank ID	Optional	1
C3	Currency	Optional	1
ITD	Terms of Sale/Deferred Terms of Sale	Optional	1
N9	Reference Identification	Optional	300
G62	Date/Time	Optional	6
R3	Route Information - Motor	Optional	12
H3	Special Handling Instructions	Optional	6
K1	Remarks	Optional	10
Loop N1	Name	Optional	10
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	1
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
N9	Reference Identification	Optional	5
Loop N7	Equipment Details	Optional	10
N7	Equipment Details	Mandatory	1
M7	Seal Numbers	Optional	2
Loop SPO	Shipment Purchase Order Detail	Optional	999999
SPO	Shipment Purchase Order Detail	Mandatory	1
SDQ	Destination Quantity	Optional	10
Loop S5	Stop Off Details	Optional	999
S5	Stop Off Details	Mandatory	1
N9	Reference Identification	Optional	10
G62	Date/Time	Optional	10
H3	Special Handling Instructions	Optional	6
Loop SPO	Shipment Purchase Order Detail	Optional	999999
SPO	Shipment Purchase Order Detail	Mandatory	1
SDQ	Destination Quantity	Optional	10
Loop N1	Name	Optional	2
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	1
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
N9	Reference Identification	Optional	5
Loop N7	Equipment Details	Optional	10
N7	Equipment Details	Mandatory	1
M7	Seal Numbers	Optional	2
Loop LX	Assigned Number	Optional	9999
LX	Assigned Number	Mandatory	1
N9	Reference Identification	Optional	5
CSD	Consolidated Shipment Invoice Data	Optional	20
POD	Proof of Delivery	Optional	1
L5	Description, Marks and Numbers	Optional	30
H1	Hazardous Material	Optional	3
H2	Additional Hazardous Material Description	Optional	2
L0	Line Item - Quantity and Weight	Optional	10
L1	Rate and Charges	Optional	10
L4	Measurement	Optional	10
L7	Tariff Reference	Optional	10
K1	Remarks	Optional	10
Loop SPO	Shipment Purchase Order Detail	Optional	999999
SPO	Shipment Purchase Order Detail	Mandatory	1
SDQ	Destination Quantity	Optional	10
Loop N1	Name	Optional	999999
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	1
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
N9	Reference Identification	Optional	10
CSD	Consolidated Shipment Invoice Data	Optional	20
Loop CD3	Carton (Package) Detail	Optional	999999
CD3	Carton (Package) Detail	Mandatory	1
N9	Reference Identification	Optional	20
H6	Special Services	Optional	10
L9	Charge Detail	Optional	10
POD	Proof of Delivery	Optional	1
G62	Date/Time	Optional	1
Loop SPO	Shipment Purchase Order Detail	Optional	999999
SPO	Shipment Purchase Order Detail	Mandatory	1
SDQ	Destination Quantity	Optional	10
L3	Total Weight and Charges	Optional	1
SE	Transaction Set Trailer	Optional	1