Scoring System

The VRP solver uses a three-level scoring system: Hard, Medium, and Soft constraints.

Score Levels

Level	Purpose	Feasibility
Hard	Must be satisfied	hardScore = 0 required for feasible solution
Medium	Important but not mandatory	Minimized after hard constraints
Soft	Quality optimizations	Minimized for best solution

Feasible Solution

{
  "score": {
    "hardScore": 0,
    "mediumScore": -500,
    "softScore": -12450,
    "feasible": true
  }
}

Infeasible Solution

{
  "score": {
    "hardScore": -2000,
    "mediumScore": -800,
    "softScore": -15000,
    "feasible": false
  }
}

Constraint Reference

Hard Constraints

Constraint	Description
`DATE_TIME_WINDOW_CONFLICT`	Job scheduled outside hard time window
`TRIP_CAPACITY`	Vehicle capacity exceeded
`TAG_HARD`	Missing required skill/tag
`SHIFT_END_CONFLICT`	Work extends past shift end
`OVERTIME_END_CONFLICT`	Work extends past the allowed overtime window
`MAX_DRIVE_TIME`	Driving limit exceeded
`DISALLOWED_RESOURCES`	Job assigned to blacklisted resource
`SAME_TRIP`	Related jobs not on the same trip

Medium Constraints

Constraint	Description
`UNSERVED_JOBS`	Job left unassigned, penalized by `job.priority`
`RESOURCE_PERIOD_MIN_SERVICE_TIME`	Resource under a period’s minimum service time
`RESOURCE_PERIOD_MIN_DRIVE_TIME`	Resource under a period’s minimum drive time
`RESOURCE_PERIOD_MIN_WORK_TIME`	Resource under a period’s minimum work time
`RESOURCE_PERIOD_MIN_COMPLEXITY`	Resource under a period’s minimum job complexity

Soft Constraints

Constraint	Description
`TRAVEL_TIME`	Total travel time
`WAIT_TIME`	Idle time at locations
`RESOURCE_ACTIVATION`	Number of vehicles used
`RANKING_SOFT`	Resource preference score
`FAIR_WORK`	Workload balance across resources
`DATE_TIME_WINDOW_CONFLICT_SOFT`	Soft time window violated

Weight Configuration

Control optimization priorities using weights:

{
  "options": {},
  "weights": {
    "travelTimeWeight": 1,
    "waitTimeWeight": 10,
    "urgencyWeight": 100,
    "priorityWeight": 50,
    "workloadSpreadWeight": 20,
    "minimizeResourcesWeight": 3600
  }
}

Unassigned Jobs

When jobs cannot be assigned, the response includes reasons:

{
  "unserved": ["job-15"],
  "unservedReasons": {
    "job-15": ["DATE_TIME_WINDOW_CONFLICT", "TRIP_CAPACITY"]
  }
}

Platform

VRP API

Fill API

Scoring System

Scoring System

Score Levels

Constraint Reference

Hard Constraints

Medium Constraints

Soft Constraints

Weight Configuration

Unassigned Jobs

​Scoring System

​Score Levels

​Constraint Reference

​Hard Constraints

​Medium Constraints

​Soft Constraints

​Weight Configuration

​Unassigned Jobs

Scoring System

Score Levels

Constraint Reference

Hard Constraints

Medium Constraints

Soft Constraints

Weight Configuration

Unassigned Jobs