211 Motor Carrier Bill of Lading (004050)

This is the standard X12 004050 spec, with 6 loops and 37 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 (65 KB) Generate classes
The ediFabric .NET template, class TS211. It needs the common segments, composites and codes of X12 004050, one download for every transaction in the version. Download C# (1 KB) Common files (264 KB)
The intermediary model ediFabric Native loads with set_map. Download Native (53 KB)

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

ediFabric Native

Map version 004050 to the Native model with set_map, then parse 211 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 211 classes in Python, Java, Node.js, Go, Rust or C

ediFabric Native returns each 211 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 TS211. 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.

211 structure

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

IDNameUsageMax use
STTransaction Set HeaderOptional1
BOLBeginning Segment for the Motor Carrier Bill of LadingMandatory1
B2ASet PurposeMandatory1
MS3Interline InformationOptional12
MS2Equipment or Container Owner and TypeOptional1
L11Business Instructions and Reference NumberOptional100
G62Date/TimeOptional6
AT5Bill of Lading Handling RequirementsOptional50
K1RemarksOptional10
Loop N1Party IdentificationOptional10
N1Party IdentificationMandatory1
N2Additional Name InformationOptional1
N3Party LocationOptional2
N4Geographic LocationOptional1
G61ContactOptional3
Loop AT1Bill of Lading Line Item NumberMandatory9999
AT1Bill of Lading Line Item NumberMandatory1
L11Business Instructions and Reference NumberOptional100
AT3Bill of Lading Rates and ChargesOptional1
AT4Bill of Lading DescriptionOptional99
Loop AT2Bill of Lading Line Item DetailOptional1
AT2Bill of Lading Line Item DetailMandatory1
MANMarks and NumbersOptional999999
OIDOrder Information DetailOptional999999
L4MeasurementOptional1
Loop LXTransaction Set Line NumberOptional999999
LXTransaction Set Line NumberMandatory1
MANMarks and NumbersOptional999999
OIDOrder Information DetailOptional999999
Loop G61ContactOptional2
G61ContactMandatory1
L11Business Instructions and Reference NumberOptional5
LH6Hazardous CertificationOptional6
Loop LH1Hazardous Identification InformationMandatory25
LH1Hazardous Identification InformationMandatory1
LH2Hazardous Classification InformationOptional4
LH3Hazardous Material Shipping NameOptional10
LFHFreeform Hazardous Material InformationOptional20
LEPEPA Required DataOptional3
LH4Canadian Dangerous RequirementsOptional1
LHTTransborder Hazardous RequirementsOptional3
L11Business Instructions and Reference NumberOptional5
SETransaction Set TrailerOptional1