Upgrading API from v3 to v4

Transport

Status

Add the sent_to_trucker status category. When a transport is assigned to a trucker but not sent, the status is assigned.

Invoicing address

delivery.invoicing_address is moved to transport.invoicing_address.

Before (v3)

{
    "deliveries": [{
         "invoicing_address": {...}
    }]
}

After (v4)

{
    "invoicing_address": {...},
    "deliveries": [{...}]
}

Sites

Asked time slots

The following fields are now removed:

arrival_date 
arrival_time_min 
arrival_time_max 
date_exact

They are replaced by the slots field, which represents the time slots asked by the shipper.

Two new fields are added: real_start and real_end, which are the actual times at which the trucker arrived on site and left the site.

Before (v3)

{
    "uid": "aaaa-aaaa-aaaa-aaaa",
    "arrival_date": "2021-03-02",
    "arrival_time_min": "08:00",
    "arrival_time_max": "09:00",
    "date_exact": true
}

After (v4)

{
    "uid": "aaaa-aaaa-aaaa-aaaa",
    "slots": [
        {
            "start": "2021-03-02T00:08:00Z", 
            "end": "2021-03-02T00:09:00Z"
        }
    ],
    "real_start": "2021-03-02T00:08:04Z", 
    "real_end": "2021-03-02T00:08:26Z", 
}

Transport statuses

The field holder_exchanges is removed in v4. It is replaced by the dedicated /api/v4/supports-exchanges/ and /api/v4/support-types/ APIs.

Transport messages (uploaded documents)

The field delivery is removed in v4.

Delivery loads

Update type of volume, weight, tare_weight and linear_meters that are now float instead of string.

Before (v3)

{
    "volume": "2.3",
    "weight": "230",
    "tare_weight": "1400",
    "linear_meters": "3.5"
}

After (v4)

{
    "volume": 2.3,
    "weight": 230,
    "tare_weight": 1400,
    "linear_meters": 3.5
}

Companies

Country

The country field is now mandatory on companies.

Truckers

The param chartered in the truckers filter (URL parameter) is renamed to rental.

GET https://api.dashdoc.eu/api/v4/truckers/?rental=true