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
      • Constraints
      • Demo datasets
      • Input 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
    • Changelog
    • Upgrading to the latest versions
    • Feature requests

Terms

This section lists frequently used terms and their meanings:

Capacity

The capacity is the total load that can be transported by a driver’s vehicle. See the driver capacity guide for more details.

Constraints

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

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.

Demand

The demand describes the current demand for the driver’s vehicle capacity. A job with a pickup stop that requires 2 units of capacity has a demand of 2. When the job’s delivery is made, the demand will be released and made available again for another job.

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.

Load

The load describes how much of the driver’s vehicle capacity is currently being used.

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. See the shift hours and overtime guide for more details.

Stop

Jobs have multiple stops, for instance, pick-up stops, service stops, and delivery stops.

Next

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

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