Troubleshoot route optimization

Resolve common PlanSmart errors and understand why an optimization can fail.

Route optimization can fail for several reasons.

The error message usually points to the cause.

Common errors

Not enough time to travel from depot

The work order cannot be reached within the available schedule.

Time window start must be before end

A work order has an invalid time window.

Not all work orders are planned

Some work orders could not be assigned.

Request size exceeded

The optimization contains too much data in one run.

Unexpected error occurred

A general error stopped the optimization.

How to resolve the most common issues

1

Check schedules and availability

Make sure employee working hours match the planning demand.

2

Check address quality

Verify that all work orders and start locations have valid coordinates.

3

Check time windows

Make sure each time window has a valid start and end.

4

Reduce the run size

Split large runs by day, team, or group if needed.

5

Retry the optimization

Start a new run after you adjust the blocking data.

If available, download debug data and attach it to your support request.

Frequently asked questions

Where do I see the error message?

In the PlanSmart results panel after the run ends.

Can I download debug data?

Yes.

Use it when support needs more detail.

What should I do if the run keeps failing?

Review the blocking data and contact support with the debug data.

Related topics

• PlanSmart (AI Routeplanner)
• Start route optimization from the planboard
• Set up PlanSmart with the setup wizard