Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
    • Pick-up and Delivery Routing
  • Platform
Try models
  • Pick-up and Delivery Routing
  • Changelog

Pick-up and Delivery Routing

    • Introduction
    • Getting started: Hello world
    • User guide
      • Terms
      • Planning AI concepts
      • Constraints
      • Demo datasets
      • Validation
      • Routing with Timefold’s maps service
      • Metrics and optimization goals
    • Driver resource constraints
      • Lunch breaks and personal appointments
      • Route optimization
      • Shift hours and overtime
    • Job service constraints
      • Time windows and opening hours
      • Skills
      • Movable stops and multi-day schedules
      • Dependencies between stops
      • Priority jobs and optional jobs
      • Job requirements and tags
        • Job required drivers
        • Job pooling
        • Prohibit job combinations
        • Maximum time burden
        • Driver capacity
        • Tags
    • Real-time planning in pick-up and delivery routing
    • Changelog
    • Upgrading to the latest versions
    • Feature requests

Changelog

0.58.0

Maximum time burden on the job level

It is now possible to define maximum time burdens on the job level. Before, it was only possible to define maximum time burdens in the configuration for the entire set of jobs. With this change, there is more flexibility to define different maximum time burdens for different jobs and still use the global definition as a default value. More details can be found in the Maximum time burden section.

Handling input itineraries in the Pick-up and Delivery Routing model

The Pick-up and Delivery Routing model now supports input itineraries, allowing users to define pre-planned routes for drivers. The pre-planned routes will be used as a starting point for optimization. There is a new section in the user guide that explains how to use input itineraries for real-time planning scenarios.

Extending the options for defining shift hours, including overtime hours

The options for defining shift hours have been extended to include overtime hours and other options. These added options are:

  • A soft end time of a shift, which now allows defining a preferred end time for a shift and a maximum end time.

  • A hard maximum departure time from the last stop of a shift.

  • A preferred maximum departure time from the last stop of a shift.

More details on how these definitions can be used, can be found in the Shift hours and overtime section.

0.57.0

Custom job priorities

New "opt-1" to "opt-10" built-in optional job priorities have been added to the "1" to "10" built-in mandatory job priorities, making it possible to define the priority of optional jobs. In addition, it is now possible to define a custom priority and its weight.

This gives the user finer control over the penalty of leaving a job unassigned.

Please see Priority jobs section for additional details.

Improved quality of solution

A new custom move has been added to the model that allows already assigned jobs to be replaced, leading to solutions with better score.

For instance, a low priority job that is assigned early in the solving process can now be replaced by a high priority job.

0.56.0

Hello World: Pick-up and Delivery Routing model public preview release

The public preview release of the Pick-up and Delivery Routing model is now available for all users to explore.

The Pick-up and Delivery Routing model assigns pick-ups and deliveries to drivers so that multiple pick-ups and deliveries can be made on the same trip while minimizing driving time and customer wait times.

The initial release includes the following constraints:

  • Lunch breaks and personal appointments

  • Route optimization

  • Shift hours and overtime

  • Time windows and opening hours

  • Skills

  • Movable stops and multi-day schedules

  • Dependencies between stops

  • Priority jobs and optional jobs

  • Job requirements and tags

As we continue to iterate, we will update the changelog with new features, improvements, and enhancements to the model.

Subscribe to the changelog.

  • © 2025 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default