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

Pick-up and Delivery Routing

    • Introduction
    • Getting started: Hello world
    • User guide
      • Terms
      • Planning AI concepts
      • 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 stops and optional stops
      • Job requirements and tags
        • Job required drivers
        • Job pooling
        • Prohibit job combinations
        • Maximum time burden
        • Driver capacity
        • Tags
    • Changelog
    • Upgrading to the latest versions
    • Feature requests

Terms

This section lists frequently used terms and their meanings:

Constraints

The hard, medium, and soft rules that must be taken into account when creating a pick-up and delivery schedule.

Datasets

Timefold accepts input datasets that include information about the drivers and the jobs to be scheduled and optimized. Input datasets are created using our predefined model schema which follows the OpenAPI specification. Timefold returns output datasets that contain the optimized solution.

See the API spec for more information.

Driver

A person who can be assigned jobs. They work shifts which have start and end times.

Job

A job is a series of stops that typically include a pick-up location, a delivery location, and can include other locations between the pick-up and delivery.

Planning window

The time period that will have jobs scheduled during a planning session.

Shift

A work period with start and end times when a driver is available for jobs.

Stop

A destination within a job. Jobs have multiple stops.

Next

  • See the full API spec or try the online API.

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