Skip to content
HALOWERK

Ortwerk

time window conflicts

Simulates the planned sequence from the start time: arrival = departure + travel time, service starts at max(arrival, window start), lateness = arrival after window end, departure = start + service time; flags late arrivals, waiting, service running past the window, invalid windows and the shift end. Independently of the order, every pair of stops is tested with earliest possible starts (window start or direct travel from the start): if neither order reaches the second stop before its window.

POST https://ort.halowerk.com/v1/time-window-conflicts

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
startobjectYesDeparture from the depot.
stopsarrayYesStops in planned order.
matrix_minutesarrayNoTravel times in minutes; index 0 = start, then stops in the given order.
average_speed_kmhnumberNoAverage speed for coordinate-based travel times (your assumption).
detour_factornumberNoRoad-distance factor on the great-circle distance (your assumption).
shift_endstringNoLatest end of the tour.
return_to_startbooleanNoInclude the return trip to the start in the shift-end check.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "start",
    "stops"
  ],
  "properties": {
    "start": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "time"
      ],
      "description": "Departure from the depot.",
      "properties": {
        "time": {
          "type": "string",
          "maxLength": 40,
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
          "description": "Departure time."
        },
        "lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Depot latitude."
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Depot longitude."
        }
      }
    },
    "stops": {
      "type": "array",
      "minItems": 1,
      "maxItems": 300,
      "description": "Stops in planned order.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Order or stop reference."
          },
          "window_start": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "Earliest service start."
          },
          "window_end": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "Latest service start (arrival after it is late)."
          },
          "service_minutes": {
            "type": "number",
            "minimum": 0,
            "maximum": 1440,
            "default": 0,
            "description": "Service time at the stop."
          },
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude."
          }
        }
      }
    },
    "matrix_minutes": {
      "type": "array",
      "maxItems": 301,
      "items": {
        "type": "array",
        "maxItems": 301,
        "items": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000
        }
      },
      "description": "Travel times in minutes; index 0 = start, then stops in the given order."
    },
    "average_speed_kmh": {
      "type": "number",
      "minimum": 1,
      "maximum": 200,
      "description": "Average speed for coordinate-based travel times (your assumption)."
    },
    "detour_factor": {
      "type": "number",
      "minimum": 1,
      "maximum": 3,
      "default": 1,
      "description": "Road-distance factor on the great-circle distance (your assumption)."
    },
    "shift_end": {
      "type": "string",
      "maxLength": 40,
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
      "description": "Latest end of the tour."
    },
    "return_to_start": {
      "type": "boolean",
      "default": false,
      "description": "Include the return trip to the start in the shift-end check."
    }
  }
}

Open original schema

Published input example

{
  "start": {
    "time": "2026-10-05T08:00:00Z"
  },
  "stops": [
    {
      "id": "A",
      "window_start": "2026-10-05T08:30:00Z",
      "window_end": "2026-10-05T09:00:00Z",
      "service_minutes": 15
    },
    {
      "id": "B",
      "window_start": "2026-10-05T09:00:00Z",
      "window_end": "2026-10-05T09:30:00Z",
      "service_minutes": 10
    }
  ],
  "matrix_minutes": [
    [
      0,
      20,
      40
    ],
    [
      20,
      0,
      30
    ],
    [
      40,
      30,
      0
    ]
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’