Charter

Charter many segments

Shortcut API to create a chartered transport from one segment or a list of successive segments (from a "parent transport"). Those segments, will be chartered to a "child transport".

Child transport is created as follow:

• Shipper is the actual carrier of the parent transport

• Carrier is the chartered carrier given in the carrier parameter

• Trucker and plates are not set, but information about it can be given in the instructions parameters

• Other transport data (deliveries, segments, etc.) are duplicated

• Child transport starts at the first segment's origin and ends at the last segment's destination

post

/segments/charter/

Authorizations

Query parameters

uid__instring

Comma separated list of segment uids, or just one if only one segment is to be chartered.

Example: 1004fcf8-9136-11eb-aa8d-0242ac110006,a05b7bfa-71e8-11eb-b223-0242ac110007

remote_id__instring

Comma separated list of remote ids, or just one if only one segment is to be chartered. Can be used to identify segments using their remote_id instead of their uid.

Example: seg_1234567,seg_7654321

Body

carrierobjectrequired

Carrier to whom you wish to charter the transport. Identified either by its pk or remote_id.

instructionsstring

Operating instructions. The carrier, the shipper and the creator of the transport have access to those instructions. However, the creator is the only who has the right to edit.

pricenullable number floatDeprecated

Full price for the transport

Example: 250

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.dashdoc.eu/api/v4/segments/charter/' \
  --header 'Authentication: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"carrier":{"pk":23498,"carrier_contacts":"['abce-df123-acd4', 'dcbe-df153-dcd7']"},"price":250}'

201

400

201

{
  "child_transport": "3545c058-392d-11eb-90c5-0242ac140006"
}

Segments chartered successfully