Migration from V2

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.

​

Overview

​

Endpoint change

​

Request mapping

​

Vehicles (Resources → Vehicles)

{
  "name": "truck-1",
  "shifts": [
    {
      "from": "2026-04-01T08:00:00+02:00",
      "to": "2026-04-01T17:00:00+02:00",
      "start": { "latitude": 50.8503, "longitude": 4.3517 },
      "end": { "latitude": 50.8503, "longitude": 4.3517 }
    }
  ],
  "capacity": [100],
  "tags": ["refrigerated"]
}

• name → id
• shifts[].start/end (locations inside shift) → top-level start/end (shifts can override per-shift)
• Coordinates: {latitude, longitude} object → [longitude, latitude] array (GeoJSON order)
• tags → skills (note: V2 tags are not automatically mapped when using the V2 compat endpoint)
• New: max_distance, max_duration for vehicle range constraints

​

Jobs

{
  "name": "delivery-1",
  "location": { "latitude": 50.8798, "longitude": 4.7005 },
  "duration": 300,
  "load": [10],
  "windows": [
    {
      "from": "2026-04-01T09:00:00+02:00",
      "to": "2026-04-01T12:00:00+02:00",
      "hard": true
    }
  ]
}

• name → id
• location: {latitude, longitude} → [longitude, latitude]
• duration → service_duration
• load → demand
• windows → time_windows (no hard flag — all time windows are hard in V3)
• New: skills (required vehicle capabilities), committed_vehicle (lock job to a specific vehicle)

​

Relations

{
  "type": "SEQUENCE",
  "jobs": ["job-A", "job-B", "job-C"],
  "resource": "truck-1"
}

​

Options

{
  "solvingTime": 30
}

• solvingTime (seconds) → time_limit_ms (milliseconds)
• New: seed for reproducible results
• New: minimize — choose "time" or "distance" as primary objective
• New: matrix — supply custom distance/duration matrices (bypasses Solvice Maps)
• New: job_proximity_radius_m, job_proximity_weight — soft proximity constraint

​

Response mapping

{
  "trips": [
    {
      "resource": "truck-1",
      "visits": [
        {
          "job": "delivery-1",
          "arrival": "2026-04-01T09:30:00+02:00",
          "location": { "latitude": 50.8798, "longitude": 4.7005 }
        }
      ],
      "travelTime": 3600,
      "distance": 30000
    }
  ],
  "unserved": ["delivery-3"],
  "unservedReasons": {
    "delivery-3": ["Time window violated"]
  },
  "totalTravelTimeInSeconds": 3600,
  "totalTravelDistanceInMeters": 30000
}

• trips → routes, resource → vehicle_id
• visits → stops (job stops only, no depot entries)
• V3 stops are richer: job_id, arrival, departure, wait_time, travel_time, service_time, load_after
• V3 routes include: shift_from/shift_to, load, n_stops, start_time/end_time
• unserved (string list) → unassigned (objects with job_id and reason)
• New summary block with solve stats (elapsed_ms, iterations, vehicles_used)
• Coordinates in response are [longitude, latitude] arrays

​

V2 features not mapped via compat endpoint

• resources[].tags — V2 skill tags are not forwarded to the V3 solver
• relations[].resource — pinning a relation to a specific vehicle is ignored
• windows[].hard — soft time window flag has no V3 equivalent yet
• Per-visit serviceTime, travelTime, distance — not populated in the V2 response

​

Feature parity