GuidesAPI ReferenceChangelogSupportContact Us

Motor Carrier Load Tender (204)

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

🚧

Update sender and receiver to test

If you want to use this example within your own test transaction, make sure you edit the sender (ODF_SUPPLIER) and receiver (ODF_BUYER) ISA IDs.

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~

B2 Beginning Segment for Shipment Information Transaction

This segment contains the header information.

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

B2**ODFS**SH1234**PP~
JSON ElementX12 ElementValueDescription
standardCarrierAlphaCodeB202ODFSThis element contains the transportation company identifier of the carrier.
shipmentIdentificationNumberB204SH1234This is the shipment ID.
shipmentMethodOfPaymentCodeB206PPThis is the payment code of the shipment.

PP here means "Prepaid". Other possible values include CC (Collect) and TP (Third Party)

B2A Set Purpose

The B2A segment identifies the purpose of the transaction.

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

B2A*00*LT~
JSON ElementX12 ElementValueDescription
transactionSetPurposeCodeB2A0100This identifies the purpose of the transaction.

In this case 00 means "Original". Other possible values include 01 (Cancellation) and 04 (Update).
applicationTypeCodeB2A02LTThe type of transaction.

In this case it is LT meaning "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 ElementX12 ElementValueDescription
referenceIdentificationL1101ODFS11112The reference number
referenceIdentificationQualifierL1102BMThe qualifier of the reference number describing the referenceIdentification (L1101) element.

In this example BM is "Bill of lading number".

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": "010",
              "date": "20200901",
              "timeQualifier": "004",
              "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": "005",
              "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*010*20200901*004*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 ElementX12 ElementValueDescription
stopSequenceNumberS5011The sequence of the stop.

In this example, this is the first stop.
stopReasonCodeS502LDThe reason code of the stop.

In this example LD means "Load".

G62 Date/Time

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

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

G62*10*20200901*004*1800*ET~
JSON ElementX12 ElementValueDescription
dateQualifierG620110
dateG620220200901
timeQualifierG6203004
timeG62041800
timeCodeG6205ET

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 ElementX12 ElementValueDescription
entityIdentifierCodeN101SFThis is the code that describes the address.

In this example SF means "Ship From"
nameN102ODF PICK UP LOCATIONThis is the name of the address.

N3 Party Location

The partyLocation element contains the first line of the address.

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

N3*123 MAIN ROAD~
JSON ElementX12 ElementValueDescription
addressInformationN301123 MAIN ROADAddress 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 ElementX12 ElementValueDescription
cityNameN401SEATTLEThe city name.
stateOrProvinceCodeN402WAThe state or province.
postalCodeN40398101The 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 ElementX12 ElementValueDescription
contactFunctionCodeG6101ICThe type of contact at the address.

In this case, IC means "Information Contact".
nameG6102JOHNThe contact's name.
communicationNumberQualifierG6103TEQualifier describing the communicationNumber field

In this case, TE indicates that it is a phone number.
communicationNumberG6104415-123-4567The communication number.

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 ElementX12 ElementValueDescription
weightL3012780.71The total weight
weightQualifierL302GThe type of the weight.

In this case, G means "Gross Weight".
volumeL309510.88The total volume
volumeUnitQualifierL310EThe unit of measure qualifier of the volume.

In this example E means "Cubic feet".
ladingQuantityL31119Total pieces

Motor Carrier Load Tender Structure

"interchangeControlHeader", //Interchange Control Header                
  "functionalGroupHeader", //Functional Group Header 

  "transactionSets" 
      "transactionSetHeader", //Transaction Set Header            
      "beginningSegmentForShipmentInformationTransaction", //Beginning Segment for Shipment Information Transaction
      "setPurpose", //Set Purpose
      "businessInstructionsAndReferenceNumber", //Business Instructions and Reference Number

      "S5_loop" 
          "stopOffDetails", //Stop-off Details
          "dateTime", //Date/Time
          
          "N1_loop",
              "partyIdentification", //Name
              "partyLocation", //Address Information
              "geographicLocation", //Geographic Location
              "contact", //Contact
          
      "totalWeightAndCharges", //Total Weight and Charges
      "transactionSetTrailer" //Transaction Set Trailer


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

..ST //Transaction Set Header
...B2 //Beginning Segment for Shipment Information Transaction
...B2A //Set Purpose
...L11 //Business Instructions and Reference Number
...L11 //Business Instructions and Reference Number
...S5 //Stop-off Details
....G62 //Date/Time
....N1 //Name
.....N3 //Address Information
.....N4 //Geographic Location
.....G61 //Contact 
...L3 //Total Weight and Charges
..SE //Transaction Set Trailer
.GS //Functional Group Trailer
ISA //Interchange Control Trailer