Updating a Stop ETA

Updating Stop ETA

To PATCH a shipment's specific StopStatus, you'll need to first provide the specific FreightProviderReferenceNumber with your 10-4 provided FreightHaulerProviderXID or the TenFourLicensePlate.

To PATCH a StopStatus, the following fields are required:

1. FreightProviderReferenceNumber and FreightHaulerProviderXID
2. TenFourLicensePlate

Parameter	Type	Description
FreightProviderReferenceNumber	String	The external reference number of the shipper's given shipment (BOL).
FreightHaulerProviderXID	String	10-4's external reference id between a shipper and a carrier.
TenFourLicensePlate	String	The uniquely generated 10-4 response when creating a shipment within Freight Portal.

Here is an example JSON Object:

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI"
}

{
  "TenFourLicensePlate":"T9302NB"
}

Adding the Carrier

Next, in order to assign a shipment to a specific carrier, you'll need to supply one of the following carrier identification parameters listed below:

Parameter	Type	Description
CarrierMC	String	The external reference to the carrier's MC-Number.
CarrierDOT	String	The external reference to the carrier's USDOT-Number.
CarrierSCAC	String	The external reference to the carrier's SCAC.

Here is an example of the JSON Object thus far:

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierMC":"3829182"
}

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierDOT":"110392"
}

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierSCAC":"ABCD"
}

Other Required Fields

To update a specific shipment's StopStatus information, the following additional fields are required:

Parameter	Type	Description
StopSequence	Integer	The stop sequence number that is associated with this update.

Here is an example of the JSON Object thus far:

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierSCAC":"ABCD",
  "StopSequence":1
}

Updating an ETA

A shipment's stop can have additional data points updated to deliver data-rich stop-specific data. To update the StopStatus Object with additional ETA information, simply add the optional parameters below:

Parameter	Type	Description
EstimatedDeliveryDate	DateTimeOffset	DateTime of the estimated delivery datetime.
RetainEstimatedDeliveryDate	Boolean	If a value of TRUE is provided, the shipment's ETA is persisted. If the value of FALSE is provided, the shipment's ETA is not persisted.

Here is an example JSON Object thus far:

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierSCAC":"ABCD",
  "StopSequence":1,
  "EstimatedDeliveryDate":"2015-12-22T00:00:00+00:00",
  "RetainEstimatedDeliveryDate":1
}

Completed Updated ETA JSON Object

Here you can see an example of a completely valid StopStatus ETA update with an ETA set on the origin stop:

{
  "FreightProviderReferenceNumber":"12345670",
  "FreightHaulerProviderXID":"ABD3820AI",
  "CarrierSCAC":"ABCD",
  "StopSequence":1,
  "EstimatedDeliveryDate":"2018-08-13T00:00:00+00:00",
  "RetainEstimatedDeliveryDate":1
}

Updated about 2 months ago

What’s Next

Updating an Appointment Time