Fulfillment API

StatusChangeResponse

object

Details of a status change.

submittedByUserNamestring

The Central Dispatch username of the person who submitted the status change.

Example:d71b5750-e89b-12d3-a456-426614174000

dispatchStatusChangeIdstring(uuid)

The ID of the dispatch status change.

Example:157a16f0-503d-4256-ba60-a4876e8eb9bb

dateUtcstring(date-time)

The date and time of the status change, in UTC/ISO 8601 format.

Example:2024-10-31T00:00:00Z

statusstring

The status of the dispatch.

Example:PENDING_PICKUP

cancellationReasonIdstring

The ID of the cancellation reason.

Example:cac10000-e89b-12d3-a456-426614174000

notesstring

Additional notes regarding the status change. Deprecated: Use estimatedDateChangeNotes instead.

Example:Weather delay.

estimatedDateChangeNotesstring

Additional notes regarding the estimated date change.

Example:Weather delay.

submittedPartystring

The party that submitted the status change e.g. SHIPPER or CARRIER.

Example:SHIPPER

submittedBystring(uuid)

The Central Dispatch user ID of the user who submitted the status change.

Example:3ca6e1c2-98fb-4b4e-bfd8-ffaec58fb347

Example

StopRequest

object

Details of a stop.

stopNumberinteger(int32)

The sequential number of the stop along the route e.g. 1 is the pick up stop and 2 is the delivery stop.

Example:1

stopTypestring

The facility type of the stop. This list is not exhaustive and additional values may be added at any time.

Allowed values:OTHERAIRPORT_RENTAL_CENTERAUCTIONAUCTION_SATELLITE_LOTCOMMERCIAL_BUSINESSCORPORATE_OFFICE_PLANTCROSS_DOCK_OR_SATELLITE_STAGING_LOTDEALERIMPOUNDMARSHALLING_YARDMILITARY_BASEMOBILE_AUCTIONPORTRAIL_YARDRECON_FACILITYRENTAL_CAR_RETAIL_SITEREPORESIDENCESERVICE_CENTERTERMINAL

Example:DEALER

namestring

The name of the stop.

Example:ABC Cars lot

addressobject

Details of an address.

Show Child Parameters
contactobject

Details of a contact.

Show Child Parameters
externalLocationIdstring

A location identifier managed by the user.

Example:Loc123

isTWICboolean

Indicates whether the stop requires driver to have a Transportation Worker Identification Credential (TWIC). A TWIC is a credential required by the Maritime Transportation Security Act for carriers to access some locations. If you are not sure if a TWIC is needed, please contact the location.

Default:false

Example:true

siteIdstring

The ID of the site.

Example:ABC

latitudestring

The latitude of the location.

Example:33.81228788622535

longitudestring

The longitude of the location.

Example:-117.91836265987132

buyerNumberstring

The buyer reference number.

Example:12345

Example

StopResponse

object

Details of a stop.

shipmentDescriptionIdstring(uuid)

The ID of the shipment description.

Example:519e0000-e89b-12d3-a456-426614174000

hrefstring

The URL used to query the current collection of the resource.

Example:https://fulfillment-api.centraldispatch.com/api/fulfillments/id/d159acc0-e89b-12d3-a456-426614174000

stopIdstring(uuid)

The system assigned UUID of the stop.

Example:9b6e0fad-8722-4da1-907c-f9522c04ef12

sequenceIdinteger(int32)

The sequential number of the stop along the route e.g. 1 is the pick up stop and 2 is the delivery stop.

Example:1

stopTypestring

The facility type of the stop. This list is not exhaustive and additional values may be added at any time.

Allowed values:OTHERAIRPORT_RENTAL_CENTERAUCTIONAUCTION_SATELLITE_LOTCOMMERCIAL_BUSINESSCORPORATE_OFFICE_PLANTCROSS_DOCK_OR_SATELLITE_STAGING_LOTDEALERIMPOUNDMARSHALLING_YARDMILITARY_BASEMOBILE_AUCTIONPORTRAIL_YARDRECON_FACILITYRENTAL_CAR_RETAIL_SITEREPORESIDENCESERVICE_CENTERTERMINAL

Example:DEALER

stopTypeDescriptionstring

The name of the stop.

Example:Dealership in the heart of the city.

locationNamestring

The name of the stop.

Example:ABC Cars lot

externalLocationIdstring

A location identifier managed by the user.

Example:Loc123

addressstring

The street address.

Example:345 W Elm St.

address2string

Additional street address line.

Example:2nd Floor

citystring

The city.

Example:Anaheim

statestring

The state.

Example:CA

zipCodestring

The ZIP code. Must be a valid United States ZIP code or Canadian postal code.

Example:92802

countrystring

The country code. US or CA.

Example:US

phonestring

The primary phone number of the contact.

Example:949-555-0101

phone2string

An additional phone number of the contact.

Example:949-555-2434

phone3string

An additional phone number of the contact.

Example:949-555-3545

siteIdstring

The ID of the site.

Example:ABC

contactNamestring

The name of the contact.

Example:Mickey Smith

contactPhonestring

The primary phone number of the contact.

Example:949-555-0101

contactCellPhonestring

The cell phone number of the contact.

Example:949-555-1212

contactEmailstring

The email address of the contact. Must be a valid email address format.

Example:mickey@snoogle.com

isTWICboolean

Indicates whether the stop requires driver to have a Transportation Worker Identification Credential (TWIC). A TWIC is a credential required by the Maritime Transportation Security Act for carriers to access some locations. If you are not sure if a TWIC is needed, please contact the location.

Example:true

latitudenumber(double)

The latitude of the location.

Example:33.81228788622535

longitudenumber(double)

The longitude of the location.

Example:-117.91836265987132

buyerNumberstring

The buyer reference number.

Example:12345

Example

UpdateDispatchDatesRequest

object

Details of dispatch vehicle date item.

dispatchIdstring(uuid)

The ID of the dispatch.

Example:d159acc0-e89b-12d3-a456-426614174000

dispatchVehiclesarray[object]

Details of dispatch vehicle dates.

Show Child Parameters
Example

UpdateDispatchDatesVehicleDateChangeRequest

object

Details of vehicle dates.

dateTypestring

The type of date. This list is not exhaustive and additional values may be added at any time.

Allowed values:ESTIMATED_PICKUPACTUAL_PICKUPESTIMATED_DROPOFFACTUAL_DROPOFFSHIPPER_REQUESTED_PICKUPSHIPPER_REQUESTED_DROPOFFCARRIER_ESTIMATED_PICKUPCARRIER_ESTIMATED_DROPOFF

Example:ESTIMATED_PICKUP

dateValuestring(date-time)

The date, in UTC/ISO 8601 format.

dateChangeReasonIdstring(uuid)

The ID of the date change reason. This value can be retrieved using the ‘Get Date Change Reasons’ endpoint. Required for carrier.

notesstring

Additional information.

Example:Shipper needs more time to prepare the vehicle.

Example