Fulfillment API

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

UpdateDispatchDatesVehiclesRequest

object

Details of dispatch vehicle dates.

dispatchVehicleIdstring(uuid)

The ID of the vehicle.

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

dateChangesarray[object]

Details of vehicle dates.

Show Child Parameters
Example