> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solvice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Parcel last-mile

> A worked V3 example: 38 parcel stops with promised two-hour slots, two vans and a cargo bike, one solve, then the plan read stop by stop, the slots that were missed and what they cost, and the one slot no vehicle could keep

> [!NOTE]
>
> **V3 is in beta.** General availability (GA) is planned for 1 December 2026.

A parcel carrier runs a suburban hub east of Antwerp and a micro-hub in the city centre. One Thursday it has 36 deliveries with two-hour slots promised to the recipients, one re-attempt of a parcel the recipient missed yesterday, and one return to collect. Eight of the slots are paid premium slots that must be kept. The rest are standard slots the carrier would rather keep, but may miss at a known cost. Two vans work from the hub. A cargo bike works from the micro-hub, only inside the centre, and only for a few hours.

This page models that day, solves it with `POST /v3/routing/solve`, and reads the plan: which vehicle does what, where the 10-minute loading at the hub shows up, why the second van stays in, which standard slots were missed and what each cost, and the one premium slot that no vehicle could keep. The response is real output for the request shown. Yours can differ in the travel figures, if the road data has changed since, and in `timings`.

[Field service day](https://docs.solvice.io/guides/vrp/v3/examples/field-service.md) walks a smaller plan and then reuses it with `evaluate` and `suggest`; this page stays with one solve and goes deeper into reading it.

## The business rules

| Rule, as the operations lead states it | V3 field |
| - | - |
| A parcel is delivered inside the slot we promised. Premium slots are a contract; standard slots we can miss, and each missed one costs us about 12 per hour of delay in goodwill credits | `time_windows[]`. A premium slot is a window with no price, so it is hard. A standard slot carries `per_late_hour: 12`, so the solver may be late and pays for it |
| Premium parcels come first when something has to give | `priority: 10` on the premium jobs. The default is `1` |
| The re-attempt is worth trying, but not worth a detour: we would rather hold it another day than spend more than about 6 on it | `drop_cost: 6` makes the job optional and prices leaving it out |
| The return pickup can happen any time after 11:00 | A job with `pickup_load` instead of `delivery_load` |
| Vans load at the hub for ten minutes before they leave and unload returns for ten minutes when they get back | `depots[].service_duration_s: 600` on the hub, with each shift's `start` and `end` naming the depot |
| Van 1 works a full day, van 2 a half day | One shift per van, with its own `from` and `to` |
| The cargo bike carries 15 parcels, rides at most 30 km, only serves the centre, and costs little per hour but nothing per kilometre | `capacity: { "parcels": 15 }`, `limits.max_distance_m: 30000`, `shifts[].serves_tags: ["centrum"]`, and `vehicles[].costs` overriding the fleet rates |
| Every parcel belongs to a zone: the centre or the suburbs | `tags: ["centrum"]` or `tags: ["suburb"]` on every job. A shift with `serves_tags` serves only tasks that carry one of its tags, and an untagged task can go to any shift, so a zone rule needs every task tagged |
| Drivers take a 30-minute lunch that starts between 12:00 and 13:30 | A `windowed` break on each van shift |
| A van that goes out costs 60 for the day, 28 per hour and 0.25 per kilometre | `objective.costs`: `per_route`, `per_route_hour`, `per_travel_km` |
| Keep neighbouring addresses on the same route, so one driver does one street | `objective.grouping`: tasks within 800 m form a group and every entry into a group from outside pays 0.5 |

Everything else the carrier might say ("van 1 usually does the north") is left out on purpose. A rule that is not a constraint of the operation should not be sent as one; see [AI agents](https://docs.solvice.io/guides/vrp/v3/ai-agents.md) for the full list of things not to assume.

Capacity is in parcels. The vans never get close to their 120, so capacity acts on the bike alone. Counting parcels rather than weight is enough here because the carrier packs by count; a fleet that mixes bulky and heavy items would declare `parcels` and `weight` as two dimensions on the same `capacity` and `delivery_load` objects.

## The data

All times are local time on 12 November 2026, written with the `+01:00` offset. Coordinates are `[longitude, latitude]`.

| Vehicle | Shift | Base | Capacity | Range | Serves |
| - | - | - | - | - | - |
| `van-1` | 07:30 to 16:00 | hub | 120 parcels | unlimited | every tag |
| `van-2` | 07:30 to 13:00 | hub | 120 parcels | unlimited | every tag |
| `cargo-bike` | 08:30 to 14:00 | micro-hub | 15 parcels | 30 km | `centrum` only |

The 38 tasks:

* 28 standard deliveries, 1 to 4 parcels each, 3 minutes at the door, in two-hour slots between 09:00 and 15:00, each slot priced at 12 per hour late.
* 8 premium deliveries with the same shape but a hard slot and `priority: 10`: Deurne 08:00 to 10:00, Borgerhout, Merksem and one centre address 09:00 to 11:00, Brasschaat and Kapellen 09:00 to 10:00, one centre address 13:00 to 15:00, and one in Kontich promised for 07:30 to 08:00.
* `p-retry-wilrijk`, the re-attempt: any time between 09:00 and 15:00, optional with `drop_cost: 6`.
* `r-return-mortsel`, the return: a `pickup_load` of one parcel, 11:00 to 15:00.

Eight centre addresses carry `tags: ["centrum"]`, the other 30 `tags: ["suburb"]`. The vans have no `serves_tags`, so the tags do not restrict them; only the bike reads them.

## The request

The complete body, as sent. Send it to `POST /v3/routing/validate/solve` first to check it without solving; the real call takes about five seconds of search plus the travel lookup.

```bash theme={null}
curl -X POST https://api.solvice.io/v3/routing/solve \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "problem": {
      "depots": [
        {"id": "hub", "location": [4.521, 51.203], "service_duration_s": 600},
        {"id": "micro-hub", "location": [4.405, 51.215]}
      ],
      "vehicles": [
        {
          "id": "van-1",
          "capacity": {"parcels": 120},
          "shifts": [
            {
              "id": "thu",
              "from": "2026-11-12T07:30:00+01:00",
              "to": "2026-11-12T16:00:00+01:00",
              "start": {"depot": "hub"},
              "end": {"depot": "hub"},
              "breaks": [
                {
                  "type": "windowed",
                  "duration_s": 1800,
                  "time_window": {"from": "2026-11-12T12:00:00+01:00", "to": "2026-11-12T13:30:00+01:00"}
                }
              ]
            }
          ]
        },
        {
          "id": "van-2",
          "capacity": {"parcels": 120},
          "shifts": [
            {
              "id": "thu",
              "from": "2026-11-12T07:30:00+01:00",
              "to": "2026-11-12T13:00:00+01:00",
              "start": {"depot": "hub"},
              "end": {"depot": "hub"},
              "breaks": [
                {
                  "type": "windowed",
                  "duration_s": 1800,
                  "time_window": {"from": "2026-11-12T12:00:00+01:00", "to": "2026-11-12T13:30:00+01:00"}
                }
              ]
            }
          ]
        },
        {
          "id": "cargo-bike",
          "capacity": {"parcels": 15},
          "limits": {"max_distance_m": 30000},
          "shifts": [
            {
              "id": "thu",
              "from": "2026-11-12T08:30:00+01:00",
              "to": "2026-11-12T14:00:00+01:00",
              "start": {"depot": "micro-hub"},
              "end": {"depot": "micro-hub"},
              "serves_tags": ["centrum"]
            }
          ],
          "costs": {"per_route": 25, "per_route_hour": 22, "per_travel_km": 0.0}
        }
      ],
      "jobs": [
        {
          "id": "p-berchem-01",
          "location": [4.4203, 51.1979],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-berchem-02",
          "location": [4.4231, 51.1962],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-berchem-03",
          "location": [4.4175, 51.199],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-borgerhout-01",
          "location": [4.436, 51.212],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-brasschaat-01",
          "location": [4.492, 51.291],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T10:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-brasschaat-02",
          "location": [4.495, 51.285],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-centrum-01",
          "location": [4.401, 51.219],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-02",
          "location": [4.409, 51.223],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-03",
          "location": [4.398, 51.212],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-04",
          "location": [4.412, 51.209],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00"}],
          "priority": 10
        },
        {
          "id": "p-centrum-05",
          "location": [4.405, 51.2165],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-06",
          "location": [4.412, 51.2195],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-07",
          "location": [4.396, 51.218],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}]
        },
        {
          "id": "p-centrum-08",
          "location": [4.4035, 51.211],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "tags": ["centrum"],
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00"}],
          "priority": 10
        },
        {
          "id": "p-deurne-01",
          "location": [4.464, 51.222],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T08:00:00+01:00", "to": "2026-11-12T10:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-deurne-02",
          "location": [4.47, 51.226],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-deurne-03",
          "location": [4.458, 51.23],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-edegem-01",
          "location": [4.444, 51.156],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-ekeren-01",
          "location": [4.417, 51.278],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-ekeren-02",
          "location": [4.423, 51.282],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-hoboken-01",
          "location": [4.35, 51.175],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-hoboken-02",
          "location": [4.347, 51.179],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-kapellen-01",
          "location": [4.431, 51.313],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T10:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-kontich-01",
          "location": [4.448, 51.132],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 3},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-kontich-02",
          "location": [4.445, 51.136],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-kontich-03",
          "location": [4.45, 51.13],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T07:30:00+01:00", "to": "2026-11-12T08:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-merksem-01",
          "location": [4.439, 51.244],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 4},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-merksem-02",
          "location": [4.444, 51.248],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00"}],
          "priority": 10,
          "tags": ["suburb"]
        },
        {
          "id": "p-mortsel-01",
          "location": [4.459, 51.17],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-mortsel-02",
          "location": [4.462, 51.174],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-schoten-01",
          "location": [4.503, 51.254],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-schoten-02",
          "location": [4.508, 51.25],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-wilrijk-01",
          "location": [4.394, 51.168],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 3},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T11:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-wilrijk-02",
          "location": [4.3885, 51.1655],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 2},
          "time_windows": [{"from": "2026-11-12T13:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-wilrijk-03",
          "location": [4.399, 51.1725],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-zwijndrecht-01",
          "location": [4.328, 51.219],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T13:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        },
        {
          "id": "p-retry-wilrijk",
          "location": [4.3925, 51.1705],
          "service_duration_s": 180,
          "delivery_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T09:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "drop_cost": 6,
          "tags": ["suburb"]
        },
        {
          "id": "r-return-mortsel",
          "location": [4.455, 51.173],
          "service_duration_s": 120,
          "pickup_load": {"parcels": 1},
          "time_windows": [{"from": "2026-11-12T11:00:00+01:00", "to": "2026-11-12T15:00:00+01:00", "per_late_hour": 12}],
          "tags": ["suburb"]
        }
      ],
      "objective": {
        "currency": "EUR",
        "costs": {"per_route": 60, "per_route_hour": 28, "per_travel_km": 0.25},
        "grouping": {"radius_m": 800, "per_entry": 0.5}
      }
    },
    "options": {"time_limit_s": 5, "seed": 7}
  }'
```

Three things to notice before reading the answer:

* **A standard slot and a premium slot are both `time_windows` entries.** The only difference is `per_late_hour` on the standard one. Omitting it makes a window hard; there is no `hard: true` flag. Sending `per_late_hour: 0` is a `400`.
* **The bike's prices replace the fleet's, field by field.** `vehicles[].costs` on `cargo-bike` sets `per_route: 25`, `per_route_hour: 22` and `per_travel_km: 0`. A field left out of a vehicle's `costs` keeps the `objective.costs` value, so list every rate you mean to change.
* **`options.seed: 7`** fixes the random stream. Repeating the call with the same body and seed on the same road data returns the same plan; change the seed to get a different, equally valid one.

## The response

The response below is the real output for that request, trimmed in three ways to keep it readable: each stop keeps its times, waits, lateness, travel and load and drops `location`, `snapped_location` and `service_s`; the top-level `search_progress` and `warnings` are left out; and `plan`, which repeats the routes in request shape, is shown whole because it is what you send back. Response times are in each shift's own offset, `+01:00`, so they read as local time.

```json theme={null}
{
  "summary": {
    "score": {
      "violation_count": 0,
      "unassigned_priority": 10,
      "cost": 497.30478,
      "currency": "EUR",
      "components": {
        "routes": 85.0,
        "stops": 0.0,
        "vehicles": 0.0,
        "time": 333.40578,
        "distance": 40.469,
        "waiting": 0.0,
        "driving": 0.0,
        "overtime": 0.0,
        "lateness": 29.43,
        "window_choice": 0.0,
        "target": 0.0,
        "tag_preference": 0.0,
        "reloads": 0.0,
        "grouping": 9.0,
        "workload_share": 0.0,
        "drop_costs": 0.0,
        "preferences": 0.0,
        "assignment": 0.0,
        "delay": 0.0
      }
    },
    "tasks": {"served": 37, "unassigned": 1, "unassigned_required": 1},
    "vehicles_used": 2,
    "shifts_used": 2,
    "distance_m": 175100,
    "time": {
      "span_s": 46654,
      "travel_s": 21198,
      "service_s": 6600,
      "depot_s": 1200,
      "wait_s": 15856,
      "break_s": 1800,
      "overtime_s": 0
    },
    "timings": {"search_ms": 5000, "total_ms": 5059},
    "search": {"termination": "time_limit", "iterations": 8503},
    "travel_estimated": false
  },
  "routes": [
    {
      "vehicle": "van-1",
      "shift": "thu",
      "distance_m": 161876,
      "time": {
        "span_s": 28952,
        "travel_s": 18279,
        "service_s": 5160,
        "depot_s": 1200,
        "wait_s": 2513,
        "break_s": 1800,
        "overtime_s": 0
      },
      "load_peak": {"parcels": 46},
      "stops": [
        {"type": "start", "depot": "hub", "arrival": "2026-11-12T07:30:00+01:00", "departure": "2026-11-12T07:40:00+01:00", "load_after": {"parcels": 46}},
        {"type": "job", "id": "p-deurne-01", "arrival": "2026-11-12T07:52:03+01:00", "service_start": "2026-11-12T08:00:00+01:00", "departure": "2026-11-12T08:03:00+01:00", "wait_s": 477, "lateness_s": 0, "travel_s": 723, "distance_m": 6086, "load_after": {"parcels": 44}},
        {"type": "job", "id": "p-kapellen-01", "arrival": "2026-11-12T08:26:04+01:00", "service_start": "2026-11-12T09:00:00+01:00", "departure": "2026-11-12T09:03:00+01:00", "wait_s": 2036, "lateness_s": 0, "travel_s": 1384, "distance_m": 12486, "load_after": {"parcels": 42}},
        {"type": "job", "id": "p-brasschaat-01", "arrival": "2026-11-12T09:15:01+01:00", "service_start": "2026-11-12T09:15:01+01:00", "departure": "2026-11-12T09:18:01+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 721, "distance_m": 6698, "load_after": {"parcels": 41}},
        {"type": "job", "id": "p-schoten-01", "arrival": "2026-11-12T09:28:03+01:00", "service_start": "2026-11-12T09:28:03+01:00", "departure": "2026-11-12T09:31:03+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 602, "distance_m": 6548, "load_after": {"parcels": 39}},
        {"type": "job", "id": "p-merksem-02", "arrival": "2026-11-12T09:43:16+01:00", "service_start": "2026-11-12T09:43:16+01:00", "departure": "2026-11-12T09:46:16+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 733, "distance_m": 5050, "load_after": {"parcels": 37}},
        {"type": "job", "id": "p-borgerhout-01", "arrival": "2026-11-12T10:00:29+01:00", "service_start": "2026-11-12T10:00:29+01:00", "departure": "2026-11-12T10:03:29+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 853, "distance_m": 5504, "load_after": {"parcels": 36}},
        {"type": "job", "id": "p-berchem-01", "arrival": "2026-11-12T10:12:47+01:00", "service_start": "2026-11-12T10:12:47+01:00", "departure": "2026-11-12T10:15:47+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 558, "distance_m": 2678, "load_after": {"parcels": 34}},
        {"type": "job", "id": "p-berchem-02", "arrival": "2026-11-12T10:18:38+01:00", "service_start": "2026-11-12T10:18:38+01:00", "departure": "2026-11-12T10:21:38+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 171, "distance_m": 539, "load_after": {"parcels": 33}},
        {"type": "job", "id": "p-kontich-02", "arrival": "2026-11-12T10:35:27+01:00", "service_start": "2026-11-12T10:35:27+01:00", "departure": "2026-11-12T10:38:27+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 829, "distance_m": 11388, "load_after": {"parcels": 31}},
        {"type": "job", "id": "p-wilrijk-01", "arrival": "2026-11-12T10:48:10+01:00", "service_start": "2026-11-12T10:48:10+01:00", "departure": "2026-11-12T10:51:10+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 583, "distance_m": 5896, "load_after": {"parcels": 28}},
        {"type": "job", "id": "p-retry-wilrijk", "arrival": "2026-11-12T10:54:13+01:00", "service_start": "2026-11-12T10:54:13+01:00", "departure": "2026-11-12T10:57:13+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 183, "distance_m": 824, "load_after": {"parcels": 27}},
        {"type": "job", "id": "p-wilrijk-03", "arrival": "2026-11-12T11:00:43+01:00", "service_start": "2026-11-12T11:00:43+01:00", "departure": "2026-11-12T11:03:43+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 210, "distance_m": 1242, "load_after": {"parcels": 26}},
        {"type": "job", "id": "p-hoboken-01", "arrival": "2026-11-12T11:12:59+01:00", "service_start": "2026-11-12T11:12:59+01:00", "departure": "2026-11-12T11:15:59+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 556, "distance_m": 4286, "load_after": {"parcels": 25}},
        {"type": "job", "id": "p-hoboken-02", "arrival": "2026-11-12T11:18:46+01:00", "service_start": "2026-11-12T11:18:46+01:00", "departure": "2026-11-12T11:21:46+01:00", "wait_s": 0, "lateness_s": 1126, "travel_s": 167, "distance_m": 870, "load_after": {"parcels": 23}},
        {"type": "job", "id": "p-zwijndrecht-01", "arrival": "2026-11-12T11:38:32+01:00", "service_start": "2026-11-12T11:38:32+01:00", "departure": "2026-11-12T11:41:32+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 1006, "distance_m": 10481, "load_after": {"parcels": 22}},
        {"type": "job", "id": "p-berchem-03", "arrival": "2026-11-12T11:54:59+01:00", "service_start": "2026-11-12T11:54:59+01:00", "departure": "2026-11-12T11:57:59+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 807, "distance_m": 8760, "load_after": {"parcels": 21}},
        {"type": "break", "arrival": "2026-11-12T12:14:30+01:00", "departure": "2026-11-12T12:44:30+01:00", "load_after": {"parcels": 21}},
        {"type": "job", "id": "p-deurne-03", "arrival": "2026-11-12T12:14:30+01:00", "service_start": "2026-11-12T12:44:30+01:00", "departure": "2026-11-12T12:47:30+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 991, "distance_m": 5882, "load_after": {"parcels": 20}},
        {"type": "job", "id": "p-merksem-01", "arrival": "2026-11-12T12:54:14+01:00", "service_start": "2026-11-12T12:54:14+01:00", "departure": "2026-11-12T12:57:14+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 404, "distance_m": 2950, "load_after": {"parcels": 16}},
        {"type": "job", "id": "p-ekeren-01", "arrival": "2026-11-12T13:06:43+01:00", "service_start": "2026-11-12T13:06:43+01:00", "departure": "2026-11-12T13:09:43+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 569, "distance_m": 4973, "load_after": {"parcels": 14}},
        {"type": "job", "id": "p-ekeren-02", "arrival": "2026-11-12T13:11:51+01:00", "service_start": "2026-11-12T13:11:51+01:00", "departure": "2026-11-12T13:14:51+01:00", "wait_s": 0, "lateness_s": 711, "travel_s": 128, "distance_m": 670, "load_after": {"parcels": 13}},
        {"type": "job", "id": "p-brasschaat-02", "arrival": "2026-11-12T13:27:34+01:00", "service_start": "2026-11-12T13:27:34+01:00", "departure": "2026-11-12T13:30:34+01:00", "wait_s": 0, "lateness_s": 1654, "travel_s": 763, "distance_m": 6332, "load_after": {"parcels": 11}},
        {"type": "job", "id": "p-schoten-02", "arrival": "2026-11-12T13:45:32+01:00", "service_start": "2026-11-12T13:45:32+01:00", "departure": "2026-11-12T13:48:32+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 898, "distance_m": 9121, "load_after": {"parcels": 10}},
        {"type": "job", "id": "p-deurne-02", "arrival": "2026-11-12T13:58:35+01:00", "service_start": "2026-11-12T13:58:35+01:00", "departure": "2026-11-12T14:01:35+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 603, "distance_m": 5466, "load_after": {"parcels": 9}},
        {"type": "job", "id": "p-mortsel-02", "arrival": "2026-11-12T14:17:50+01:00", "service_start": "2026-11-12T14:17:50+01:00", "departure": "2026-11-12T14:20:50+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 975, "distance_m": 7927, "load_after": {"parcels": 8}},
        {"type": "job", "id": "p-mortsel-01", "arrival": "2026-11-12T14:24:51+01:00", "service_start": "2026-11-12T14:24:51+01:00", "departure": "2026-11-12T14:27:51+01:00", "wait_s": 0, "lateness_s": 5091, "travel_s": 241, "distance_m": 1525, "load_after": {"parcels": 6}},
        {"type": "job", "id": "r-return-mortsel", "arrival": "2026-11-12T14:29:18+01:00", "service_start": "2026-11-12T14:29:18+01:00", "departure": "2026-11-12T14:31:18+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 87, "distance_m": 504, "load_after": {"parcels": 7}},
        {"type": "job", "id": "p-edegem-01", "arrival": "2026-11-12T14:38:19+01:00", "service_start": "2026-11-12T14:38:19+01:00", "departure": "2026-11-12T14:41:19+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 421, "distance_m": 2992, "load_after": {"parcels": 6}},
        {"type": "job", "id": "p-kontich-01", "arrival": "2026-11-12T14:49:46+01:00", "service_start": "2026-11-12T14:49:46+01:00", "departure": "2026-11-12T14:52:46+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 507, "distance_m": 3568, "load_after": {"parcels": 3}},
        {"type": "job", "id": "p-wilrijk-02", "arrival": "2026-11-12T15:04:07+01:00", "service_start": "2026-11-12T15:04:07+01:00", "departure": "2026-11-12T15:07:07+01:00", "wait_s": 0, "lateness_s": 247, "travel_s": 681, "distance_m": 6592, "load_after": {"parcels": 1}},
        {"type": "end", "depot": "hub", "arrival": "2026-11-12T15:22:32+01:00", "departure": "2026-11-12T15:32:32+01:00", "wait_s": 0, "travel_s": 925, "distance_m": 14038, "load_after": {"parcels": 1}}
      ]
    },
    {
      "vehicle": "cargo-bike",
      "shift": "thu",
      "distance_m": 13224,
      "time": {
        "span_s": 17702,
        "travel_s": 2919,
        "service_s": 1440,
        "depot_s": 0,
        "wait_s": 13343,
        "break_s": 0,
        "overtime_s": 0
      },
      "load_peak": {"parcels": 10},
      "stops": [
        {"type": "start", "depot": "micro-hub", "arrival": "2026-11-12T08:30:00+01:00", "departure": "2026-11-12T08:30:00+01:00", "load_after": {"parcels": 10}},
        {"type": "job", "id": "p-centrum-04", "arrival": "2026-11-12T08:32:48+01:00", "service_start": "2026-11-12T09:00:00+01:00", "departure": "2026-11-12T09:03:00+01:00", "wait_s": 1632, "lateness_s": 0, "travel_s": 168, "distance_m": 1132, "load_after": {"parcels": 9}},
        {"type": "job", "id": "p-centrum-07", "arrival": "2026-11-12T09:11:52+01:00", "service_start": "2026-11-12T09:11:52+01:00", "departure": "2026-11-12T09:14:52+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 532, "distance_m": 2157, "load_after": {"parcels": 8}},
        {"type": "job", "id": "p-centrum-01", "arrival": "2026-11-12T09:19:15+01:00", "service_start": "2026-11-12T09:19:15+01:00", "departure": "2026-11-12T09:22:15+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 263, "distance_m": 814, "load_after": {"parcels": 7}},
        {"type": "job", "id": "p-centrum-05", "arrival": "2026-11-12T09:25:45+01:00", "service_start": "2026-11-12T11:00:00+01:00", "departure": "2026-11-12T11:03:00+01:00", "wait_s": 5655, "lateness_s": 0, "travel_s": 210, "distance_m": 576, "load_after": {"parcels": 6}},
        {"type": "job", "id": "p-centrum-02", "arrival": "2026-11-12T11:10:14+01:00", "service_start": "2026-11-12T11:10:14+01:00", "departure": "2026-11-12T11:13:14+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 434, "distance_m": 1568, "load_after": {"parcels": 4}},
        {"type": "job", "id": "p-centrum-06", "arrival": "2026-11-12T11:19:04+01:00", "service_start": "2026-11-12T13:00:00+01:00", "departure": "2026-11-12T13:03:00+01:00", "wait_s": 6056, "lateness_s": 0, "travel_s": 350, "distance_m": 1501, "load_after": {"parcels": 2}},
        {"type": "job", "id": "p-centrum-03", "arrival": "2026-11-12T13:13:10+01:00", "service_start": "2026-11-12T13:13:10+01:00", "departure": "2026-11-12T13:16:10+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 610, "distance_m": 3679, "load_after": {"parcels": 1}},
        {"type": "job", "id": "p-centrum-08", "arrival": "2026-11-12T13:18:00+01:00", "service_start": "2026-11-12T13:18:00+01:00", "departure": "2026-11-12T13:21:00+01:00", "wait_s": 0, "lateness_s": 0, "travel_s": 110, "distance_m": 570, "load_after": {"parcels": 0}},
        {"type": "end", "depot": "micro-hub", "arrival": "2026-11-12T13:25:02+01:00", "departure": "2026-11-12T13:25:02+01:00", "wait_s": 0, "travel_s": 242, "distance_m": 1227, "load_after": {"parcels": 0}}
      ]
    }
  ],
  "plan": {
    "routes": [
      {
        "vehicle": "van-1",
        "shift": "thu",
        "stops": [
          {"type": "job", "id": "p-deurne-01"},
          {"type": "job", "id": "p-kapellen-01"},
          {"type": "job", "id": "p-brasschaat-01"},
          {"type": "job", "id": "p-schoten-01"},
          {"type": "job", "id": "p-merksem-02"},
          {"type": "job", "id": "p-borgerhout-01"},
          {"type": "job", "id": "p-berchem-01"},
          {"type": "job", "id": "p-berchem-02"},
          {"type": "job", "id": "p-kontich-02"},
          {"type": "job", "id": "p-wilrijk-01"},
          {"type": "job", "id": "p-retry-wilrijk"},
          {"type": "job", "id": "p-wilrijk-03"},
          {"type": "job", "id": "p-hoboken-01"},
          {"type": "job", "id": "p-hoboken-02"},
          {"type": "job", "id": "p-zwijndrecht-01"},
          {"type": "job", "id": "p-berchem-03"},
          {"type": "job", "id": "p-deurne-03"},
          {"type": "job", "id": "p-merksem-01"},
          {"type": "job", "id": "p-ekeren-01"},
          {"type": "job", "id": "p-ekeren-02"},
          {"type": "job", "id": "p-brasschaat-02"},
          {"type": "job", "id": "p-schoten-02"},
          {"type": "job", "id": "p-deurne-02"},
          {"type": "job", "id": "p-mortsel-02"},
          {"type": "job", "id": "p-mortsel-01"},
          {"type": "job", "id": "r-return-mortsel"},
          {"type": "job", "id": "p-edegem-01"},
          {"type": "job", "id": "p-kontich-01"},
          {"type": "job", "id": "p-wilrijk-02"}
        ]
      },
      {
        "vehicle": "cargo-bike",
        "shift": "thu",
        "stops": [
          {"type": "job", "id": "p-centrum-04"},
          {"type": "job", "id": "p-centrum-07"},
          {"type": "job", "id": "p-centrum-01"},
          {"type": "job", "id": "p-centrum-05"},
          {"type": "job", "id": "p-centrum-02"},
          {"type": "job", "id": "p-centrum-06"},
          {"type": "job", "id": "p-centrum-03"},
          {"type": "job", "id": "p-centrum-08"}
        ]
      }
    ]
  },
  "unassigned": [
    {
      "task": "p-kontich-03",
      "category": "blocked",
      "reasons": [
        {"constraint": "serves_tags", "message": "A vehicle's shift serves none of this task's tags"},
        {"constraint": "time_window", "message": "A route cannot reach this task within its time window"}
      ],
      "relaxations": [
        {
          "pointer": "/problem/jobs/25/time_windows",
          "op": "extend_time_window",
          "amount": 61,
          "unit": "s",
          "message": "Extend a time window by 61s (~1 min)."
        }
      ]
    }
  ]
}
```

### The plan in one paragraph

Two of the three vehicles go out. `van-1` does a full day from the hub: 29 stops, 162 km, back at 15:22 and unloaded by 15:32. The bike does the eight centre stops in just under five hours and 13 km, well inside its 30 km range, and spends most of that time waiting for slots to open. `van-2` has no route: once the solver had a plan that served every reachable suburb parcel with one van, opening the second van would have cost 60 for the day plus its hours, and the alternative, being late on five standard slots at 12 per hour, came to 29.43. Thirty-seven of the 38 tasks are served, 32 of them inside their slot. One premium parcel, the 07:30 to 08:00 slot in Kontich, is unassigned, and the response says by how much it misses.

That trade is the one to pause on. The carrier priced a late standard slot at 12 per hour, and the solver took it at its word: the plan is late by 2 hours 27 minutes in total across five stops, one of them by 85 minutes, because that was cheaper than a second van. If that is not what the carrier meant, the price is wrong, not the plan. Doubling `per_late_hour` or lowering `per_route` on `van-2` changes the answer; the sections below show where to read the effect.

### Summary

* **`tasks`** reads `served: 37, unassigned: 1, unassigned_required: 1`. The unassigned task has no `drop_cost`, so it counts as required. The call still returns HTTP `200`: a plan that leaves tasks out is a successful response, and the status code says nothing about it. Check these three numbers before anything else.
* **`vehicles_used: 2`, `shifts_used: 2`.** `routes[]` lists `van-1` and `cargo-bike`. A shift with no task stops gets no `routes[]` entry at all, so a client that wants a line per vehicle has to fill in `van-2` itself.
* **`time`** is summed over routes. `travel_s` 21,198 s is driving only. `depot_s` 1,200 s is the two ten-minute handling periods at the hub, which the bike's micro-hub does not have because it sets no `service_duration_s`. `wait_s` 15,856 s is time spent arrived-but-early, 13,343 s of it on the bike. `break_s` 1,800 s is van 1's lunch.
* **`search`** used the five-second budget in full (`termination: "time_limit"`) over 8,503 iterations. A plan this size is far from converged in five seconds; [Performance](https://docs.solvice.io/guides/vrp/v3/concepts/performance-guide.md#see-how-fast-the-search-converges) explains how to read `search_progress` and pick a budget.

### Van 1, stop by stop

The route starts at the hub with `arrival` and `departure` ten minutes apart: that is `depots[].service_duration_s` applied at `start`. `load_after` on the start stop is 46, the sum of the `delivery_load` of every delivery on the route, and `load_peak` is also 46: a delivery route is fullest when it leaves.

Five moments on this route are worth tracing, in local time with the seconds dropped:

| Stop | Arrives | Service starts | Leaves | What the response shows |
| - | - | - | - | - |
| `p-deurne-01` | 07:52 | 08:00 | 08:03 | A premium slot opening at 08:00. The van is eight minutes early and `wait_s` is 477. Early arrival is never a violation; it is waiting, and here it is paid through the hourly rate, not through a separate charge, because the request sets no `per_wait_hour` |
| `p-kapellen-01` | 08:26 | 09:00 | 09:03 | The van drives to the far north of its area and waits 34 minutes for the 09:00 premium slot, then works back south through Brasschaat, Schoten and Merksem, each inside its slot. The wait is cheaper than any order that reaches Kapellen and Brasschaat later and still keeps both 10:00 deadlines |
| `p-hoboken-02` | 11:18 | 11:18 | 11:21 | `lateness_s: 1126`. The slot closed at 11:00 and service started almost 19 minutes later. The stop before it, `p-hoboken-01`, has a slot that opens at 11:00, so the van arrives in Hoboken at the moment one slot closes and the next opens, and serves the two neighbours back to back rather than coming back |
| `break` | 12:14 | | 12:44 | The lunch break, taken at the first chance after its window opens at 12:00. It is listed before `p-deurne-03`, the stop it falls inside: the van reaches Deurne at 12:14, takes the break, and starts service at 12:44. A break is always listed before the stop whose service it delays |
| `p-mortsel-01` | 14:24 | 14:24 | 14:27 | `lateness_s: 5091`. An 11:00 to 13:00 slot served at 14:24, 85 minutes late, at a cost of 16.97. The van passes Mortsel at the end of the day because that is where the return pickup is, and taking both stops in one visit at 14:24 beat a separate midday detour. The slot's price made that choice available |

Between those, the pattern is geographic: north in the morning, south-west around midday, north-east after lunch, south at the end. `r-return-mortsel` is the one stop where `load_after` goes up, from 6 to 7: a `pickup_load` is collected and ridden back to the hub, where `load_after` on the `end` stop is 1, the one parcel still on board for the return to the warehouse.

Five stops carry a non-zero `lateness_s`: Hoboken, Ekeren, Brasschaat, Mortsel and Wilrijk, 8,829 s between them. Every one of them is a standard slot. A premium slot cannot be late, because its window has no price, and every premium stop on the route has `lateness_s: 0`. That is the field to assert on: a client that only reads `summary.score.violation_count` sees `0` here and learns nothing about the late stops, because priced lateness is a cost, not a violation.

### The bike

`cargo-bike` leaves the micro-hub at 08:30 with ten parcels, serves the eight `centrum` addresses, and is back at 13:25 after 13.2 km. Two things in this route are the solver's doing and worth understanding:

* **It waits more than it rides.** `wait_s` is 13,343 s over the route, in two blocks: it reaches `p-centrum-05` at 09:25 and the slot opens at 11:00, and it reaches `p-centrum-06` at 11:19 for a 13:00 slot. At 22 per hour, idling the bike is cheaper than sending `van-1` into the centre twice. The waiting shows up in the route's `time.span_s`, and so in the `time` cost component, not in `components.waiting`, which prices `per_wait_hour` only. A carrier that would rather have the rider do something else between 09:30 and 11:00 splits the shift in two, or sets `per_wait_hour` so that the idle has a price of its own.
* **It stays far under its range.** `limits.max_distance_m: 30000` is a hard cap on the route's `distance_m`, return to the micro-hub included; 13,224 m uses less than half of it. The response does not say how close a route came to a cap; compare `routes[].distance_m` with the limit yourself when you want to know a vehicle's slack.

Every stop on the bike's route is a job tagged `centrum`. The vans could have taken centre parcels too, since they have no `serves_tags`; the bike won them on price.

### The unassigned parcel

```json theme={null}
{
  "unassigned": [
    {
      "task": "p-kontich-03",
      "category": "blocked",
      "reasons": [
        { "constraint": "serves_tags", "message": "A vehicle's shift serves none of this task's tags" },
        { "constraint": "time_window", "message": "A route cannot reach this task within its time window" }
      ],
      "relaxations": [
        {
          "pointer": "/problem/jobs/25/time_windows",
          "op": "extend_time_window",
          "amount": 61,
          "unit": "s",
          "message": "Extend a time window by 61s (~1 min)."
        }
      ]
    }
  ]
}
```

Read it from the outside in:

1. **`category: "blocked"`** says a vehicle could serve this address, but not in the window as given alongside the rest of the day. More `time_limit_s` would not help; a change to the input might.
2. **`reasons[]`** lists one entry per rule that refused the task on some vehicle. `serves_tags` is the bike: the parcel is tagged `suburb` and the bike serves `centrum`. `time_window` is the vans: the slot is 07:30 to 08:00, the shifts start at 07:30 and loading at the hub takes ten minutes, so no van leaves before 07:40, and Kontich is about 21 minutes away. The slot was promised for a time before any vehicle could get there.
3. **`relaxations[]`** quantifies it: a window 61 seconds longer would let the task in. The `pointer` is a JSON Pointer into the request body, `/problem/jobs/25/time_windows`, so a client can find the field without matching on the id.

The fix is a business decision, not a solver setting: tell the recipient 08:00 to 08:30, cut the hub loading time, or start the shift earlier. What the response does not offer is to be a minute late on its own: the premium window has no `per_late_hour`, so lateness is not for sale on it, and the parcel is left out rather than delivered late. That is the behaviour the carrier asked for when it called the slot a contract.

### Score

`score.cost` is the sum of `score.components`, in the currency you labelled:

| Component | Value | Where it comes from |
| - | - | - |
| `routes` | 85.0 | 60 for `van-1` plus the bike's own `per_route: 25`. `van-2` is unused and costs nothing |
| `time` | 333.4058 | `van-1`: 28,952 s of span at 28 per hour, 225.25. `cargo-bike`: 17,702 s at its own 22 per hour, 108.16. Span runs from the `start` stop's `arrival` to the `end` stop's `departure`, waiting, breaks and depot handling included. The hourly rate is applied per second at five decimals, which is where the last cents come from |
| `distance` | 40.469 | 161.876 km at 0.25 for the van. The bike's kilometres are priced at 0 |
| `lateness` | 29.43 | 8,829 s of lateness across five standard stops, at their windows' `per_late_hour: 12` |
| `grouping` | 9.0 | 18 entries into a group of nearby addresses from outside it, at 0.5 each |
| `drop_costs` | 0.0 | The re-attempt was served, so its `drop_cost` was not paid |
| `cost` | 497.3048 | The sum |

`unassigned_priority` is 10: the priority of `p-kontich-03`, the one required task left out. On a plan that leaves several tasks out this number is what the solver minimised first, before cost, so two plans with the same unassigned count are ranked by whose priorities they dropped. The `drop_cost` on `p-retry-wilrijk` never came into play: the address sits between two other Wilrijk stops, so serving it cost less than 6.

### One KPI line

**Cost per served stop: 13.44** (497.30 over 37 stops), with 32 of 37 slots kept, 2 hours 27 minutes of lateness across the other five at a cost of 29.43, and one premium slot unserved. Track that number across days with the same `objective.costs`; it moves when the geography, the slot mix or the fleet changes, and it is comparable between plans only while the prices stay the same.

## What the solution cannot prove

The response proves what the solver was told to respect. It cannot prove what it was not told:

* **That 12 per hour is what a missed slot costs.** The plan is the cheapest one under the prices sent. Five late stops and an idle second van is the right answer at 12 per hour and the wrong one at 40. The response cannot tell you which price is true; only the business can.
* **That the slots are the ones promised.** A window is read as sent. A slot typed as 13:00 to 15:00 for a parcel promised 15:00 to 17:00 is kept perfectly and still disappoints the recipient. Nothing in the response can detect that.
* **That three minutes at the door is right.** `service_duration_s: 180` on every delivery is an average. A route planned on averages is early at some doors and late at others, and a plan with no slack in it turns small overruns into misses. The response shows `wait_s` per stop; a stretch with waits of zero everywhere has no slack, and on `van-1` that is the whole route after 09:03.
* **That the plan survives the morning.** It is a plan for 07:30. A re-attempt that turns up, a van that leaves late or a closed road all call for a re-plan from the `plan` object in this response, with the stops already done inside `locked_count`. See [Re-optimization](https://docs.solvice.io/guides/vrp/v3/reoptimization.md).
* **That the road data matches the day.** Travel times here are free-flow times from the default engine. A morning in Antwerp traffic is slower; `travel.departure_time` asks for traffic-aware times at that moment instead. See [Distance matrices](https://docs.solvice.io/guides/vrp/v3/concepts/distance-matrices.md).

What it does prove, and how to check it in code: every stop's `service_start` lies inside its window or carries `lateness_s`; every premium stop has `lateness_s: 0`; every stop on the bike's route belongs to a job tagged `centrum`; the bike's `distance_m` is under 30,000; each route's `load_peak` is within its vehicle's `capacity`; and every task is either in some route's `stops` or in `unassigned[]`. Those are the assertions worth writing into a test against this response. [Constraints](https://docs.solvice.io/guides/vrp/v3/constraints.md) ends each rule with the field that proves it held.

## Next steps

> [card] [Field service day](https://docs.solvice.io/guides/vrp/v3/examples/field-service.md)
>
> The same loop on a smaller plan, then evaluate and suggest.

> [card] [Re-optimization](https://docs.solvice.io/guides/vrp/v3/reoptimization.md)
>
> Re-plan from this response's `plan` when the morning changes.

> [card] [Handling infeasibility](https://docs.solvice.io/guides/vrp/v3/infeasibility.md)
>
> Reading categories, reasons and relaxations, and the ranked fixes.

> [card] [Objective function](https://docs.solvice.io/guides/vrp/v3/concepts/scoring-explanation.md)
>
> Every cost component and the V3 defaults.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.