Unavailability

Create an unavailability for a trailer for a given period

A trailer can be marked as unavailable for a given period of time for various reasons. These unavailabilities are marked on the planning or can be accessed by API by fetching the trailer.

POSThttps://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/

Body

remote_idstring

The ID of the unavailability in your system

Example: "tr123type1"

createdstring (date-time)

Date of creation on our server

Example: "2020-07-30T21:10:06.44551Z"

start_datestring (date-time)

Start date of the unavailability

Example: "2020-07-30T21:10:06.44551Z"

end_datestring (date-time)

End date of the unavailability

Example: "2020-07-30T21:10:06.44551Z"

unavailability_typeenum

Type of unavailability

paid_vacationday_offsick_leavetrainingvacationmaintenancerentalother

unavailability_notestring

Notes about the unavailability

Example: "I'm on vacation"

Response

Successfully created the unavailability, returns the trailer, which contains the unavailability.

Body

pknumber

Dashdoc's internal id

Example: 928

originalnumber

Ignore. Dashdoc technical data

carriernumber

Dashdoc's internal id of the carrier owning the trailer

Example: 928

license_platestring

License plate number

Example: "WE749RM"

fleet_numberstring

Your trailer fleet number

Example: "TRAILER120"

remote_idstring

The ID of the trailer in your system

Example: "tr123type1"

createdstring (date-time)

Date of creation on our server

Example: "2020-07-30T21:10:06.44551Z"

used_for_qualimat_transportsboolean

True if the trailer can be used for Qualimat transport (only used for visual help and warnings)

tagsarray of Tag (object)

List of tags applied to the trailer.

technical_control_deadlinestring (date-time)

Example: "2020-12-22T15:31:39.26167Z"

countrycountry (string)

Only the 2-character codification is accepted (ISO 3166-1 alpha-2)

Example: "FR"

unavailabilityarray of Unavailability (object)

List of unavailable period

eventsarray of object

Ignore. Dashdoc technical data.

Request

const response = await fetch('https://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "pk": 928,
  "original": 0,
  "carrier": 928,
  "license_plate": "WE749RM",
  "fleet_number": "TRAILER120",
  "remote_id": "tr123type1",
  "created": "2020-07-30T21:10:06.44551Z",
  "used_for_qualimat_transports": false,
  "tags": [
    {
      "pk": 23498,
      "name": "Remorque"
    }
  ],
  "technical_control_deadline": "2020-12-22T15:31:39.26167Z",
  "country": "FR",
  "unavailability": [
    {
      "id": 928,
      "remote_id": "tr123type1",
      "created": "2020-07-30T21:10:06.44551Z",
      "start_date": "2020-07-30T21:10:06.44551Z",
      "end_date": "2020-07-30T21:10:06.44551Z",
      "unavailability_type": "paid_vacation",
      "unavailability_note": "I'm on vacation"
    }
  ],
  "events": []
}

Delete an unavailability for a trailer

DELETEhttps://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/{pk_unavailability}/

Path parameters

pk*number

The trailer's primary key

pk_unavailability*number

The unavailability's primary key

Response

Empty body

Request

const response = await fetch('https://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/{pk_unavailability}/', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Partially update an unavailability for a trailer

PATCHhttps://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/{pk_unavailability}/

Path parameters

pk*number

The trailer's primary key

pk_unavailability*number

The unavailability's primary key

Body

remote_idstring

The ID of the unavailability in your system

Example: "tr123type1"

createdstring (date-time)

Date of creation on our server

Example: "2020-07-30T21:10:06.44551Z"

start_datestring (date-time)

Start date of the unavailability

Example: "2020-07-30T21:10:06.44551Z"

end_datestring (date-time)

End date of the unavailability

Example: "2020-07-30T21:10:06.44551Z"

unavailability_typeenum

Type of unavailability

paid_vacationday_offsick_leavetrainingvacationmaintenancerentalother

unavailability_notestring

Notes about the unavailability

Example: "I'm on vacation"

Response

Successfully updated the unavailability, returns the trailer, which contains the unavailability.

Body

pknumber

Dashdoc's internal id

Example: 928

originalnumber

Ignore. Dashdoc technical data

carriernumber

Dashdoc's internal id of the carrier owning the trailer

Example: 928

license_platestring

License plate number

Example: "WE749RM"

fleet_numberstring

Your trailer fleet number

Example: "TRAILER120"

remote_idstring

The ID of the trailer in your system

Example: "tr123type1"

createdstring (date-time)

Date of creation on our server

Example: "2020-07-30T21:10:06.44551Z"

used_for_qualimat_transportsboolean

True if the trailer can be used for Qualimat transport (only used for visual help and warnings)

tagsarray of Tag (object)

List of tags applied to the trailer.

technical_control_deadlinestring (date-time)

Example: "2020-12-22T15:31:39.26167Z"

countrycountry (string)

Only the 2-character codification is accepted (ISO 3166-1 alpha-2)

Example: "FR"

unavailabilityarray of Unavailability (object)

List of unavailable period

eventsarray of object

Ignore. Dashdoc technical data.

Request

const response = await fetch('https://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/{pk_unavailability}/', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "pk": 928,
  "original": 0,
  "carrier": 928,
  "license_plate": "WE749RM",
  "fleet_number": "TRAILER120",
  "remote_id": "tr123type1",
  "created": "2020-07-30T21:10:06.44551Z",
  "used_for_qualimat_transports": false,
  "tags": [
    {
      "pk": 23498,
      "name": "Remorque"
    }
  ],
  "technical_control_deadline": "2020-12-22T15:31:39.26167Z",
  "country": "FR",
  "unavailability": [
    {
      "id": 928,
      "remote_id": "tr123type1",
      "created": "2020-07-30T21:10:06.44551Z",
      "start_date": "2020-07-30T21:10:06.44551Z",
      "end_date": "2020-07-30T21:10:06.44551Z",
      "unavailability_type": "paid_vacation",
      "unavailability_note": "I'm on vacation"
    }
  ],
  "events": []
}

PreviousTrailers NextTrack Dechets

Last updated 3 months ago

const response = await fetch('https://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/{pk_unavailability}/', { method: 'PATCH', headers: { "Content-Type": "application/json" }, body: JSON.stringify({}), }); const data = await response.json();

{ "pk": 928, "original": 0, "carrier": 928, "license_plate": "WE749RM", "fleet_number": "TRAILER120", "remote_id": "tr123type1", "created": "2020-07-30T21:10:06.44551Z", "used_for_qualimat_transports": false, "tags": [ { "pk": 23498, "name": "Remorque" } ], "technical_control_deadline": "2020-12-22T15:31:39.26167Z", "country": "FR", "unavailability": [ { "id": 928, "remote_id": "tr123type1", "created": "2020-07-30T21:10:06.44551Z", "start_date": "2020-07-30T21:10:06.44551Z", "end_date": "2020-07-30T21:10:06.44551Z", "unavailability_type": "paid_vacation", "unavailability_note": "I'm on vacation" } ], "events": [] }

const response = await fetch('https://api.dashdoc.eu/api/v4/trailers/{pk}/unavailability/', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({}), }); const data = await response.json();