GuidesAPI ReferenceChangelogWeb EDISupportContact Us
API Reference

Response to a Load Tender (990) - Accept or Cancel

This example is the ODF Carrier's response to the ODP Shipper's Load Tender. The response can be either to accept the load tender or to cancel it.

🚧

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.

Load Tender Example

This example only shows X12 for versions after v004030.

{
    "type": {
        "name": "990_RESPONSE_TO_A_LOAD_TENDER"
    },
    "stream": "test",
        "sender": {
        "isaId": "string"
    },
    "receiver": {
        "isaId": "string"
    },
    "message": {
  "transactionSets": [
    {
      "transactionSetHeader": [
        {
          "transactionSetIdentifierCode": "990",
          "transactionSetControlNumber": "0001"
        }
      ],
       "beginningSegmentForBookingOrPickupDelivery": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "date": "20200831",
          "reservationActionCode": "A"
        }
      ],
      "businessInstructionsAndReferenceNumber": [
        {
          "referenceIdentification": "ODFS11112",
          "referenceIdentificationQualifier": "BM"
        }
      ],
      "transactionSetTrailer": [
        {
          "numberOfIncludedSegments": "4",
          "transactionSetControlNumber": "0001"
        }
      ]
    }
  ]
}
}

{
    "type": {
        "name": "990_RESPONSE_TO_A_LOAD_TENDER"
    },
    "stream": "test",
        "sender": {
        "isaId": "string"
    },
    "receiver": {
        "isaId": "string"
    },
    "message": {
  "transactionSets": [
    {
      "transactionSetHeader": [
        {
          "transactionSetIdentifierCode": "990",
          "transactionSetControlNumber": "0001"
        }
      ],
       "beginningSegmentForBookingOrPickupDelivery": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "date": "20200831",
          "reservationActionCode": "D"
        }
      ],
      "businessInstructionsAndReferenceNumber": [
        {
          "referenceIdentification": "ODFS11112",
          "referenceIdentificationQualifier": "BM"
        }
      ],
      "transactionSetTrailer": [
        {
          "numberOfIncludedSegments": "4",
          "transactionSetControlNumber": "0001"
        }
      ]
    }
  ]
}
}

ISA*00*          *00*          *ZZ*ODF_CARRIER    *ZZ*ODF_SHIPPER    *202000831*1610*U*705*001234321*0*T*>~
GS*GF*ODF_CARRIER*ODF_SHIPPER*20200831*1610*1234321*X*007050~
ST*990*0001~
B1*ODFS*SH1234*20200831*A~
L11*ODFS11112*BM~
SE*4*0001~
GE*1*1234321~
IEA*1*001234321~

ISA*00*          *00*          *ZZ*ODF_CARRIER    *ZZ*ODF_SHIPPER    *202000831*1610*U*705*001234321*0*T*>~
GS*GF*ODF_CARRIER*ODF_SHIPPER*20200831*1610*1234321*X*007050~
ST*990*0001~
B1*ODFS*SH1234*20200831*D~
L11*ODFS11112*BM~
SE*4*0001~
GE*1*1234321~
IEA*1*001234321~

B1 Beginning Segment For Booking Or Pickup Delivery

This segment contains the header information for the transaction.

"beginningSegmentForBookingOrPickupDelivery": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "date": "20200831",
          "reservationActionCode": "A"
        }
      ]

"beginningSegmentForBookingOrPickupDelivery": [
        {
          "standardCarrierAlphaCode": "ODFS",
          "shipmentIdentificationNumber": "SH1234",
          "date": "20200831",
          "reservationActionCode": "D"
        }
      ]

B1*ODFS*SH1234*20200831*A~

B1*ODFS*SH1234*20200831*D~
JSON ElementX12 ElementValueDescription
standardCarrierAlphaCodeB101ODFCThis element is the SCAC code.
shipmentIdentificationNumberB102SH1234This element is the Shipment ID.

This reference should match this reference defined in the element B204 on the Motor Carrier Load Tender (204) transaction.
dateB10320200831This is the date of the response to the load tender.
reservationActionCodeB104A or DThis code provides the response of the carrier to the shipper about the load tender.

A - Accepted
D - Cancelled
C - Counter Proposal Made

N9/L11 Reference Identification / Business Instructions And Reference Number

The Reference Identification (N9) segment is used in version 4030 and prior. The Business Instructions And Reference Number (L11) segment is used for later versions.

Both segments provide references used to describe the load.

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

N9*BM*ODFS11112~

N9*ODFS11112*BM~
JSON ElementX12 ElementValueDescription
referenceIdentificationN902 or L1101ODFS11112Reference information for a particular transaction set.
referenceIdentificationQualifierN901 or L1102BMThis qualifier describes the type of reference given in the element referenceIdentification (N902 or L1101).

BM means "Bill of Lading Number".

Response to a 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
      "beginningSegmentForBookingOrPickupDelivery",
      "businessInstructionsAndReferenceNumber",

      //Summary Level

      "transactionSetTrailer"

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

..ST                                     //Transaction Set Header

B1*ODFS*SH1234*20200831*A~               //Beginning Segment For Booking Or Pickup Delivery
L11*ODFS11112*BM~                         //Business Instructions And Reference Number

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