# Possible Errors' Explanations

When optimizing tours with Tour Planning, sometimes you can come across errors in the problem solutions. Below you can find the possible errors, reasons why they may occur, and solutions on how to fix them.

## Unassigned Jobs Errors

Error Possible Reason Solution
NO_REASON_FOUND No reason for the error was found. Insufficient information, need to check the overall problem.
SKILL_CONSTRAINT 1. There is no vehicle with the required skills for serving the job. 2. The vehicles with matching skills do not have enough capacity or time to accommodate the job. 3. There are many other vehicles with enough time and capacity, but not the matching skills. Assign more vehicles with matching skills.
TIME_WINDOW_CONSTRAINT 1. The job time window is out of the vehicle's shift time. 2. The job can not be finished within the vehicle's shift time as the duration of the job execution is too long. 1. Correct the job time window if possible, according to the vehicle's shift time. 2. Extend the vehicle's shift time according to the job's time window.
CAPACITY_CONSTRAINT The vehicles do not have enough remaining capacity to execute the job. They are either fully loaded already and have little or no remaining capacity, or the job's demand exceeds the vehicles' capacity when empty. Remember that the capacity and demand are arrays and the values at individual indexes are compared. Add more vehicles with enough capacity or increase the capacity of the vehicles if possible.
REACHABLE_CONSTRAINT 1. The location is not reachable for the vehicle(s) due to live traffic conditions (possible traffic or construction incident). 2. Location is not reachable by the vehicle type (e.g. truck). Try historic traffic data. However, the location may still not be reachable practically.
MAX_DISTANCE_CONSTRAINT The job location is too far away and the vehicle will have to exceed its max distance limit to be able to serve this job. 1. Add more vehicles with enough max distance limit. 2. If possible, increase the max distance limit of the existing vehicles so that they can serve the job, if other constraints are also satisfied.
SHIFT_TIME_CONSTRAINT The vehicle's shift time is insufficient to serve more jobs. Extend the vehicle's shift time limit if possible.

## API Errors

Error Possible Reason Solution
E613435 Locations' distribution radius is too big for profile option 'avoid'. Tour planning API does not support fleet options, if the job distribution radius (including vehicle start and end locations) is more than 190km. 1. Remove options from the fleet profile if possible. 2. Remove the far-away jobs from the problem so that the job distribution radius doesn't exceed 190km.
E613420 Vehicle's arrival time is earlier than its departure time. Correct the vehicle's arrival time to make it earlier than its departure time.
E613400 Invalid region size. Reduce region diameter to a maximum of 400000 m.
E613401 Invalid coordinate specified in request. Check the coordinates in the request and correct them if possible.
E613410 More than one job has the same id. Each job can only have a unique ID. Check the request to verify the duplicated job IDs to fix them.
E613411 Vehicle with given id does not exist. Replace the vehicle with one with a valid vehicle ID.
E613412 Job cannot be served within vehicle time window. Change the vehicle time window if possible, or change the job time window to match the vehicle time window.
E613413 Job has skill which cannot be served by vehicle. Add a vehicle with the required skill, or remove the job with the skill that is not supported by the existing vehicles.
E613414 Different dimensions for pickups and deliveries demand. Check the request to correct either pickups or deliveries dimensions.
E613415 Pickup and delivery demand are incorrect: must be equal in one dimension. Correct the pickup and delivery demand to be equal.
E613416 Job specified in relation does not exist. Either remove the specific job from the relations, or add this job into problem constraints.
E613417 Job task has incorrect time window. Correct the job time window to satisfy the overall constraints.
E613418 More than one vehicle type has the same id. Each vehicle can only have a unique ID. Check the request to verify the duplicated vehicle IDs to fix them.
E613421 Job assigned to more than one vehicle. Remove multiple assignments of the job from the relations.
E613422 One of the vehicle's break times is outside of the vehicle's shift time. Either correct the vehicles break time, or shift time the way that the break time is within the shift time.
E613423 Vehicle break used in relation must have location. Add the location to the break used in relation.
E613424 Break cannot be defined as first in relation. Change the constraints in the relation part the way that the first location is not a break.
E613425 Profile names must be unique. The profile names can not be duplicated, use the profiles with unique names.
E613426 Unknown vehicle profile names in vehicle type definitions. Make sure that the vehicle profiles are defined.
E613427 Multi job cannot be used within relation. Either remove multi job from the constraints, or do not use relations with the multi jobs.
E613428 Ensure that all time windows have start and end date. Validate that all the time windows in the problem have start and end dates, and add the missing dates.
E613429 Region radius is too big to include traffic information. Reduce region diameter to maximum of 400000 m.
E613430 Job task has overlapping time windows. Check that the time windows do not overlap for the tasks in the related job.
E613431 Both pickups and deliveries have to be set for the job with multiple tasks. Ensure that the tasks in the job are defined properly. Add missing pickups or deliveries to the multi- jobs.
E613432 Truck gross weight is outside allowed range. Make sure that the gross weight is inside allowed range <0, 100000="">.0,>
E613433 Truck weight per axle is outside allowed range. Make sure that the weight per axle is inside allowed range <0, 25000="">.0,>
E613434 Locations' distribution radius is too big for fleet profile type 'scooter'. Reduce the overall location distribution radius.
E613220 Option conflicts with the used profile option. Check the profile options.
E613210 Invalid truck height option. Check the height option specified for the truck.
E613211 Invalid truck width option. Check the width option specified for the truck.
E613212 Invalid truck length option. Check the length option specified for the truck.
E613213 Invalid max time option. Enter the valid max time option.
E613214 Invalid stagnation time option. Enter the valid stagnation time option.
E613215 Break start time should be less than or equal to its end time. Check break definition for the vehicle.
E613436 Job should have at least one pickup or delivery specified. Ensure that the job has at least one pickup or delivery.
E613437 Locations' distribution radius is too big for using 'options' in fleet profile type 'truck'. Reduce the overall location distribution radius.
E613438 Time, used within vehicle or job, cannot be before Unix epoch. Adjust time for the jobs or vehicles.
E613439 Break should have non-empty time windows. Check the break definition for the vehicle.
E613440 Invalid country code in exclude[countries]. Specify the correct country code.
E613441 Region radius is too big for profile option 'exclude'. Reduce region diameter to maximum of 400000 m.
E613600 Vehicles' shifts overlap. Make sure that vehicle's shift time is not overlapping.
E613606 Duplicate territory specified for the same vehicle. Delete or rename the territory.
E613609 Invalid 'shiftIndex' in relation. Correct relation for the vehicle so that 'shiftIndex' is a valid index of a vehicle's shift.
E613601 Relation has job with multiple places or time windows. Make sure that relations do not have jobs with multiple places or time windows.