Zum Inhalt
HALOWERK

Laufwerk

tours / cost readiness

Declared route labor and fixed-cost allowance. Ceiling elapsed seconds times declared hourly cents plus fixed cents per active route. Modeled arithmetic only; no payroll or tax rules. Uses the paid-qualified existing VRP planner unchanged, then checks this business rule against the actual proposed route. A rule violation yields dispatch_ready=false, never an assertion that the extra constraint was optimized. Inputs are caller declared, not independently certified.20jobs/4vehicles/21points,.

POST https://lauf.halowerk.com/v1/tours/cost-readiness

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
durations_sarrayJa
matrix_sourcestringJa
vehiclesarrayJa
jobsarrayJa
max_cost_centsnumberJa
currencySiehe SchemaJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "durations_s",
    "matrix_source",
    "vehicles",
    "jobs",
    "max_cost_cents",
    "currency"
  ],
  "additionalProperties": false,
  "properties": {
    "durations_s": {
      "type": "array",
      "minItems": 2,
      "maxItems": 21,
      "items": {
        "type": "array",
        "minItems": 2,
        "maxItems": 21,
        "items": {
          "anyOf": [
            {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "matrix_source": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "vehicles": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "object",
        "required": [
          "id",
          "capacity",
          "shift",
          "cost_cents_per_hour",
          "fixed_cost_cents"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "capacity": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000
          },
          "shift": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            }
          },
          "cost_cents_per_hour": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000
          },
          "fixed_cost_cents": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000
          }
        }
      }
    },
    "jobs": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "object",
        "required": [
          "id",
          "point",
          "demand",
          "service_s",
          "window"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "point": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "demand": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000
          },
          "service_s": {
            "type": "number",
            "minimum": 0,
            "maximum": 604800
          },
          "window": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            }
          }
        }
      }
    },
    "max_cost_cents": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000
    },
    "currency": {
      "enum": [
        "EUR",
        "USD",
        "GBP"
      ]
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "durations_s": [
    [
      0,
      300,
      480,
      360
    ],
    [
      300,
      0,
      240,
      180
    ],
    [
      480,
      240,
      0,
      300
    ],
    [
      360,
      180,
      300,
      0
    ]
  ],
  "matrix_source": "Illustrative declared delivery times, seconds; not a live road measurement",
  "vehicles": [
    {
      "id": "van-1",
      "capacity": 3,
      "shift": [
        0,
        7200
      ],
      "cost_cents_per_hour": 1000,
      "fixed_cost_cents": 100
    },
    {
      "id": "van-2",
      "capacity": 2,
      "shift": [
        0,
        7200
      ],
      "cost_cents_per_hour": 1000,
      "fixed_cost_cents": 100
    }
  ],
  "jobs": [
    {
      "id": "stop-A",
      "point": 1,
      "demand": 2,
      "service_s": 120,
      "window": [
        0,
        1800
      ]
    },
    {
      "id": "stop-B",
      "point": 2,
      "demand": 2,
      "service_s": 180,
      "window": [
        600,
        3000
      ]
    },
    {
      "id": "stop-C",
      "point": 3,
      "demand": 1,
      "service_s": 60,
      "window": [
        0,
        3600
      ]
    }
  ],
  "max_cost_cents": 5000,
  "currency": "EUR"
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →