Motor carrier load tender example:
ODF Shipper wants ODF Carrier to load a full truck from one of the ODF Shipper's location and unload it to a ODF Shipper customer's destination.

On the right side, you can see:

the structure or the purchase order (in JSON or X12), composed of several segments and loops that could be repeated.
the payload example (in JSON or X12)

The ISA, GS and ST segments are part of the X12 standard and define the sender, the receiver and the transaction traded. The description of these segments can be found in this section.

🚧
Update sender and receiver to test
If you want to use the example to post a transaction or upload a transaction, make sure you edit the sender and receiver ISA IDs (marked ODF_SUPPLIER and ODF_BUYER)

B2 Beginning Segment for Shipment Information Transaction

This is the beginning segment of the transaction. This segment contains the header information.

"beginningSegmentForShipmentInformationTransaction": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "shipmentMethodOfPaymentCode": "PP"
        }
      ]

B2**ODFS**SH1234**PP~

JSON Element	X12 Element	Value	Description
standardCarrierAlphaCode	B201	ODFS	This element contains the SCAC of the carrier.
shipmentIdentificationNumber	B202	SH1234	This is the shipment id.
shipmentMethodOfPaymentCode	B203	PP	This is the payment code of the shipment. "PP" - Prepaid "CC" - Collect "TP" - Third Party

JSON Element

X12 Element

Value

Description

standardCarrierAlphaCode

B201

ODFS

This element contains the SCAC of the carrier.

shipmentIdentificationNumber

B202

SH1234

This is the shipment id.

shipmentMethodOfPaymentCode

B203

This is the payment code of the shipment.

"PP" - Prepaid
"CC" - Collect
"TP" - Third Party

B2A Set Purpose

The B2A segment identifies the purpose of the transaction.

"setPurpose": [
        {
          "transactionSetPurposeCode": "00",
          "applicationTypeCode": "LT"
        }
      ]

B2A*00*LT~

JSON Element	X12 Element	Value	Description
transactionSetPurposeCode	B2A01	00	The purpose code identifies the purpose of the transaction. "00" - Original "01" - Cancellation "04" - Update
applicationTypeCode	B2A02	LT	The type of transaction. "LT" - Load Tender

JSON Element

X12 Element

Value

Description

transactionSetPurposeCode

B2A01

The purpose code identifies the purpose of the transaction.

"00" - Original
"01" - Cancellation
"04" - Update

applicationTypeCode

B2A02

The type of transaction.

"LT" - Load Tender

L11 Business Instructions and Reference Number

This segment contains relevant reference numbers to the transaction. This is commonly used for custom key-value pairs.

"businessInstructionsAndReferenceNumber": [
        {
          "referenceIdentification": "ODFS11112",
          "referenceIdentificationQualifier": "BM"
        },
        {
          "referenceIdentification": "PO1234321",
          "referenceIdentificationQualifier": "CO"
        }
      ]

L11*ODFS11112*BM~
L11*PO1234321*CO~

JSON Element	X12 Element	Value	Description
referenceIdentification	L1101	ODFS11112	The reference number
referenceIdentificationQualifier	L1102	BM	The qualifier of the reference number describing the number in L1101

S5 Loop

This loop contains stop details of the transaction. Each stop is identified by a child element of stopOffDetails.

"S5_loop": [
        {
          "stopOffDetails": [
            {
              "stopSequenceNumber": "1",
              "stopReasonCode": "LD"
            }
          ],
          "dateTime": [
            {
              "dateQualifier": "10",
              "date": "20200901",
              "timeQualifier": "4",
              "time": "1800",
              "timeCode": "ET"
            }
          ],
          "N1_loop": [
            {
              "partyIdentification": [
                {
                  "entityIdentifierCode": "SF",
                  "name": "ODF PICK UP LOCATION"
                }
              ],
              "partyLocation": [
                {
                  "addressInformation": "123 MAIN ROAD"
                }
              ],
              "geographicLocation": [
                {
                  "cityName": "SEATTLE",
                  "stateOrProvinceCode": "WA",
                  "postalCode": "98101"
                }
              ],
              "contact": [
                {
                  "contactFunctionCode": "IC",
                  "name": "JOHN",
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "415-123-4567"
                }
              ]
            }
          ]
        },
        {
          "stopOffDetails": [
            {
              "stopSequenceNumber": "2",
              "stopReasonCode": "UL"
            }
          ],
          "dateTime": [
            {
              "dateQualifier": "68",
              "date": "20201902",
              "timeQualifier": "5",
              "time": "1100",
              "timeCode": "ET"
            }
          ],
          "N1_loop": [
            {
              "partyIdentification": [
                {
                  "entityIdentifierCode": "ST",
                  "name": "ODF SHIPPER FINAL CUSTOMER"
                }
              ],
              "partyLocation": [
                {
                  "addressInformation": "120 MARKET STREET"
                }
              ],
              "geographicLocation": [
                {
                  "cityName": "SAN JOSE",
                  "stateOrProvinceCode": "CA",
                  "postalCode": "94209",
                  "countryCode": "USA"
                }
              ],
              "contact": [
                {
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "803-739-2009"
                }
              ]
            }
          ]
        }
      ]

S5*1*LD~
G62*10*20200901*4*1800*ET~
N1*SF*ODF PICK UP LOCATION~
N3*123 MAIN ROAD~
N4*SEATTLE*WA*98101~
G61*IC*JOHN*TE*415-123-4567~
S5*2*UL~
G62*68*20201902*5*1100*ET~
N1*ST*ODF SHIPPER FINAL CUSTOMER~
N3*120 MARKET STREET~
N4*SAN JOSE*CA*94209*USA~
G61***TE*803-739-2009~

S5 Stop-off Details

This segment identifies the stop.

"stopOffDetails": [
            {
              "stopSequenceNumber": "1",
              "stopReasonCode": "LD"
            }
          ]

S5*1*LD~

JSON Element	X12 Element	Value	Description
stopSequenceNumber	S501	1	The sequence of the stop. In this example, this is the first stop.
stopReasonCode	S502	LD	The reason code of the stop.

JSON Element

X12 Element

Value

Description

stopSequenceNumber

S501

The sequence of the stop.

In this example, this is the first stop.

stopReasonCode

S502

The reason code of the stop.

G62 Date/Time

The G62 segment contains relevant date/time information for each stop.

"dateTime": [
            {
              "dateQualifier": "10",
              "date": "20200901",
              "timeQualifier": "4",
              "time": "1800",
              "timeCode": "ET"
            }
          ]

G62*10*20200901*4*1800*ET~

JSON Element	X12 Element	Value
dateQualifier	G6201	10
date	G6202	20200901
timeQualifier	G6203	4
time	G6204	1800
timeCode	G6205	ET

N1 Loop

The N1 loop contains address information for each stop.

"N1_loop": [
            {
              "partyIdentification": [
                {
                  "entityIdentifierCode": "SF",
                  "name": "ODF PICK UP LOCATION"
                }
              ],
              "partyLocation": [
                {
                  "addressInformation": "123 MAIN ROAD"
                }
              ],
              "geographicLocation": [
                {
                  "cityName": "SEATTLE",
                  "stateOrProvinceCode": "WA",
                  "postalCode": "98101"
                }
              ],
              "contact": [
                {
                  "contactFunctionCode": "IC",
                  "name": "JOHN",
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "415-123-4567"
                }
              ]
            }
          ]

N1*SF*ODF PICK UP LOCATION~
N3*123 MAIN ROAD~
N4*SEATTLE*WA*98101~
G61*IC*JOHN*TE*415-123-4567~

N1 Party Identification

The partyIdentification segment describes the address.

"partyIdentification": [
                {
                  "entityIdentifierCode": "SF",
                  "name": "ODF PICK UP LOCATION"
                }
              ]

N1*SF*ODF PICK UP LOCATION~

JSON Element	X12 Element	Value	Description
entityIdentifierCode	N101	SF	This is the code that describes the address. "SF" - Ship From
name	N102	ODF PICK UP LOCATION	This is the name of the address.

JSON Element

X12 Element

Value

Description

entityIdentifierCode

N101

This is the code that describes the address.

"SF" - Ship From

name

N102

ODF PICK UP LOCATION

This is the name of the address.

N3 Party Location

The partyLocation segment identifies the address lines of the address.

"partyLocation": [
                {
                  "addressInformation": "123 MAIN ROAD"
                }
              ]

N3*123 MAIN ROAD~

JSON Element	X12 Element	Value	Description
addressInformation	N301	123 MAIN ROAD	Address line 1.

N3 Geographic Location

The geographicLocation segment identifies the details of the address.

"geographicLocation": [
                {
                  "cityName": "SEATTLE",
                  "stateOrProvinceCode": "WA",
                  "postalCode": "98101"
                }
              ]

N4*SEATTLE*WA*98101~

JSON Element	X12 Element	Value	Description
cityName	N401	SEATTLE	city
stateOrProvinceCode	N402	WA	state
postalCode	N403	98101	postal code

G61 Contact

The contact segment provides the contact name responsible at the address.

"contact": [
                {
                  "contactFunctionCode": "IC",
                  "name": "JOHN",
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "415-123-4567"
                }
              ]
            }
          ]

G61*IC*JOHN*TE*415-123-4567~

JSON Element	X12 Element	Value	Description
contactFunctionCode	G6101	IC	The type of contact at the address.
name	G6102	JOHN	Full name
communicationNumberQualifier	G6103	TE	Qualifier describing the communicationNumber field "TE" - Telephone
communicationNumber	G6104	415-123-4567	The code related to the qualifier above.

L3 Total Weight and Charges

This segment totals all the lines in the transaction to provide a summary of the load.

"totalWeightAndCharges": [
        {
          "weight": "2780.71",
          "weightQualifier": "G",
          "volume": "510.88",
          "volumeUnitQualifier": "E",
          "ladingQuantity": "19"
        }
      ]

L3*2780.71*G*******510.88*E*19~

JSON Element	X12 Element	Value	Description
weight	L301	2780.71	The total weight
weightQualifier	L302	G	The unit of measure qualifier of the weight
volume	L309	510.88	The total volume
volumeUnitQualifier	L310	E	The unit of measure qualifier of the volume
ladingQuantity	L311	19	Total pieces

Motor Carrier Load Tender Structure

"interchangeControlHeader",             //Interchange Control Header (Optional for JSON)
  "functionalGroupHeader",               //Functional Group Header (Optional for JSON)
  "transactionSets"
      "transactionSetHeader",            //Transaction Set Header (Optional for JSON)
        
      //Header Level
      "beginningSegmentForShipmentInformationTransaction",  //Beginning Segment for Shipment Information Transaction
      "setPurpose",                               //Set Purpose
      "businessInstructionsAndReferenceNumber",   //Business Instructions and Reference Number
        
      //Detail Level
      "S5_loop"                          //S5 Loop (2 iterations)
          "stopOffDetails",              //Stop-off Details
          "dateTime",                    //Date/Time
            
          "N1_loop"                      //N1 Loop
              "partyIdentification",     //Party Identification
              "partyLocation",           //Party Location
              "geographicLocation",      //Geographic Location
              "contact"                  //Contact
      
      //Summary Level
      "totalWeightAndCharges",           //Total Weight and Charges
        
      "transactionSetTrailer"            //Transaction Set Trailer

ISA                                      //Interchange Control Header
.GS                                      //Functional Group Header

..ST                                     //Transaction Set Header

//Header Level
...B2                                    //Beginning Segment for Sipment Information Transaction
...B2A                                   //Set Purpose
...L11                                   //Business Instructions and Reference Number
  
//Detail Level
...(Hidden Loop)                         //S5 Loop (2 iterations)
......S5                                 //Stop-off Details
......G62                                //Date/Time
            
......(Hidden Loop)                      //N1 Loop
.........N1                              //Party Identification
.........N3                              //Party Location
.........N4                              //Geographic Location
.........G61                             //Contact
      
      //Summary Level
...L3                                    //Total Weight and Charges

..SE                                     //Transaction Set Trailer
.GS                                      //Functional Group Trailer
ISA                                      //Interchange Control Trailer

Motor Carrier Load Tender Example Transaction

{
    "type": {
        "name": "204_MOTOR_CARRIER_LOAD_TENDER"
    },
    "stream": "test",
        "sender": {
        "isaId": "string"
    },
    "receiver": {
        "isaId": "string"
    },
    "message": {
  "transactionSets": [
    {
      "transactionSetHeader": [
        {
          "transactionSetIdentifierCode": "204",
          "transactionSetControlNumber": "001"
        }
      ],
      "beginningSegmentForShipmentInformationTransaction": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "shipmentMethodOfPaymentCode": "PP"
        }
      ],
      "setPurpose": [
        {
          "transactionSetPurposeCode": "00",
          "applicationTypeCode": "LT"
        }
      ],
      "businessInstructionsAndReferenceNumber": [
        {
          "referenceIdentification": "ODFS11112",
          "referenceIdentificationQualifier": "BM"
        },
        {
          "referenceIdentification": "PO1234321",
          "referenceIdentificationQualifier": "CO"
        }
      ],
      "S5_loop": [
        {
          "stopOffDetails": [
            {
              "stopSequenceNumber": "1",
              "stopReasonCode": "LD"
            }
          ],
          "dateTime": [
            {
              "dateQualifier": "10",
              "date": "20200901",
              "timeQualifier": "4",
              "time": "1800",
              "timeCode": "ET"
            }
          ],
          "N1_loop": [
            {
              "partyIdentification": [
                {
                  "entityIdentifierCode": "SF",
                  "name": "ODF PICK UP LOCATION"
                }
              ],
              "partyLocation": [
                {
                  "addressInformation": "123 MAIN ROAD"
                }
              ],
              "geographicLocation": [
                {
                  "cityName": "SEATTLE",
                  "stateOrProvinceCode": "WA",
                  "postalCode": "98101"
                }
              ],
              "contact": [
                {
                  "contactFunctionCode": "IC",
                  "name": "JOHN",
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "415-123-4567"
                }
              ]
            }
          ]
        },
        {
          "stopOffDetails": [
            {
              "stopSequenceNumber": "2",
              "stopReasonCode": "UL"
            }
          ],
          "dateTime": [
            {
              "dateQualifier": "68",
              "date": "20201902",
              "timeQualifier": "5",
              "time": "1100",
              "timeCode": "ET"
            }
          ],
          "N1_loop": [
            {
              "partyIdentification": [
                {
                  "entityIdentifierCode": "ST",
                  "name": "ODF SHIPPER FINAL CUSTOMER"
                }
              ],
              "partyLocation": [
                {
                  "addressInformation": "120 MARKET STREET"
                }
              ],
              "geographicLocation": [
                {
                  "cityName": "SAN JOSE",
                  "stateOrProvinceCode": "CA",
                  "postalCode": "94209",
                  "countryCode": "USA"
                }
              ],
              "contact": [
                {
                  "communicationNumberQualifier": "TE",
                  "communicationNumber": "803-739-2009"
                }
              ]
            }
          ]
        }
      ],
      "totalWeightAndCharges": [
        {
          "weight": "2780.71",
          "weightQualifier": "G",
          "volume": "510.88",
          "volumeUnitQualifier": "E",
          "ladingQuantity": "19"
        }
      ],
      "transactionSetTrailer": [
        {
          "numberOfIncludedSegments": "19",
          "transactionSetControlNumber": "001"
        }
      ]
    }
  ]
}
}

ISA*00*          *00*          *ZZ*ODF_SHIPPER    *ZZ*ODF_CARRIER    *202000831*1610*U*401*001234321*0*T*>~
GS*SM*ODF_SHIPPER*ODF_CARRIER*20200831*1610*1234321*X*004010~
ST*204*001~
B2**ODFS**SH1234**PP~
B2A*00*LT~
L11*ODFS11112*BM~
L11*PO1234321*CO~
S5*1*LD~
G62*10*20200901*4*1800*ET~
N1*SF*ODF PICK UP LOCATION~
N3*123 MAIN ROAD~
N4*SEATTLE*WA*98101~
G61*IC*JOHN*TE*415-123-4567~
S5*2*UL~
G62*68*20201902*5*1100*ET~
N1*ST*ODF SHIPPER FINAL CUSTOMER~
N3*120 MARKET STREET~
N4*SAN JOSE*CA*94209*USA~
G61***TE*803-739-2009~
L3*2780.71*G*******510.88*E*19~
SE*19*001~
GE*1*1234321~
IEA*1*001234321~

Motor Carrier Load Tender (204)

🚧
Update sender and receiver to test

B2 Beginning Segment for Shipment Information Transaction

B2A Set Purpose

L11 Business Instructions and Reference Number

S5 Loop

S5 Stop-off Details

G62 Date/Time

N1 Loop

N1 Party Identification

N3 Party Location

N3 Geographic Location

G61 Contact

L3 Total Weight and Charges

🚧Update sender and receiver to test

B2 Beginning Segment for Shipment Information Transaction

B2A Set Purpose

L11 Business Instructions and Reference Number

S5 Loop

S5 Stop-off Details

G62 Date/Time

N1 Loop

N1 Party Identification

N3 Party Location

N3 Geographic Location

G61 Contact

L3 Total Weight and Charges

🚧
Update sender and receiver to test