Capacity Constraint

Define what vehicles carry and visits need, such as weight or volume, so no vehicle is overloaded.

Capacity is key in logistics: it decides whether a vehicle can carry an order and deliver it on time. A capacity constraint is a variable you define, such as weight, volume or number of boxes, that limits what each vehicle can carry and says what each visit needs. The optimization then makes sure no vehicle is given more than it can carry.

Capacity can be measured in any unit (kg, m³, pieces, pallets, liters) depending on what you ship. Common constraints are weight, volume, packs, boxes, frozen weight and chilled weight.

Required permission:

• View configuration
• Edit constraint (add, change or delete constraints)
• Edit configuration (choose which constraints a profile uses)

Key points

• Shared by the organization: the list of constraints is the same for every hub.
• Chosen per profile: each configuration profile ticks which of those constraints it uses, so each hub can use its own.
• Limits: the organization can define up to 20 constraints, and a profile can use up to 10 of them at once.
• Any dimension: a constraint can be anything you can count or measure.

How it works

A constraint is used in three places:

1. Vehicle: the minimum and maximum each vehicle can carry, for example weight 0 to 1000 kg. Set it in the vehicle table or the Edit vehicle dialog.
2. Visit: how much each visit needs, for example 50 kg. Set it in the visit details on the Visit page, or map a Number or Currency component of the task type to it in the task type’s route configuration. An empty value counts as 0.
3. Optimization: the total of the visits on each vehicle stays within that vehicle’s capacity.

The maximum is a hard rule: the optimization never goes above it. The minimum is a soft rule: the optimization tries to reach it but may go below it when there is no other way.

Example

Constraint weight, unit kg:

	Weight
Vehicle A	1000 kg
Vehicle B	500 kg
Visit 1	100 kg
Visit 2	300 kg
Visit 3	700 kg

The visits on vehicle A add up to at most 1000 kg and those on vehicle B to at most 500 kg. Visit 3 can only go on vehicle A. No vehicle is overloaded.

Adding a constraint

1. Open Planning › Routing › Configuration and go to Speed & capacity.
2. In Capacity Constraints, click the + icon. A new row appears.
3. Type the name in Constraint and the unit in Unit.
4. Tick the box at the start of the row to use the constraint in this profile.

The constraint is saved when you leave the field. The + icon only works once the last row has a name and a unit. An organization can have up to 20 constraints.

The Capacity Constraints block is item 4 in the picture.

Constraint name:

• Must be unique in your organization: “volume” is already used by another constraint.
• Is stored in lowercase, without spaces.
• Cannot be a built-in field name: name, address, coordinate, timeWindow, visitTime, tags, assignee, workingTime, multiday, speed, fixedCost (“speed” is reserved for a built-in field.).
• Good examples: weight, volume, item_count, pallet_quantity, cold_storage_volume.

Unit: any text, such as kg, m3, pcs, pallets or liters.

Managing constraints

• Use in this profile: tick or untick the box at the start of the row. A profile can use up to 10 constraints: A maximum of 10 capacity constraints can be selected. Unticked constraints are ignored by the optimization but stay available to every hub.
• Edit: change the name or unit; it is saved when you leave the field. The profile and its Dynamic Visit Time rules follow the new name. Renaming a constraint does not change values already stored on vehicles and visits under the old name, so choose names carefully before they are widely used.
• Delete: click the trash icon on the row and confirm Delete this constraint?. The constraint is removed for the whole organization, along with its use in profiles and in Dynamic Visit Time.

Without the Edit constraint permission the + and trash icons are hidden and the fields cannot be changed.

During the optimization

1. The total demand of each constraint is calculated per route.
2. No vehicle is given more than its maximum.
3. Visits that do not fit in any vehicle are dropped, with the capacity named as the reason (see Dropped Visit), unless Auto Split splits them.
4. The result shows how much of each capacity every vehicle uses.

Best practices

Use clear names: weight_kg, volume_m3 and pallet_count are easy to understand; w or constraint1 are not. Separate words with underscores and keep names short.

Start simple: begin with the constraint that matters most (usually weight or volume) and add more when you need them.

Combine related dimensions: instead of length, width and height, calculate the volume before creating the task and use one volume_m3 constraint.

Test first: try a few vehicles and visits to check that the capacities are realistic and that vehicles and visits use the same unit.

Common setups

Business	Constraints
Parcel delivery	weight (kg), volume (m3), item_count (pcs)
Food delivery	hot_food (bags), cold_food (bags), beverage (cups)
Pharmaceutical distribution	cold_chain (liters), ambient (boxes), controlled (units)
Furniture delivery	weight (kg), volume (m3), large_items (pcs)

Dynamic Visit Time

A constraint can also make the visit time longer as the load grows, for example 2 minutes per box. See Dynamic Visit Time.

Troubleshooting

The + icon is missing

• The organization already has 20 constraints. Delete unused ones first.
• You do not have the Edit constraint permission. Ask your admin.

The name is rejected

• It is already used by another constraint, or it is a built-in field name. Choose another name.

The optimization fails or drops many visits

• Vehicle capacities are too small for the visits. Check them.
• Vehicles and visits use different units (kg and grams, for example).
• Some visits have no value for the constraint.
• Try with fewer constraints ticked to find which one causes it.

A new constraint does not appear on vehicles or visits

• Make sure it is ticked in the profile you are using.
• Check that you are on the right hub.

Frequently asked questions

What if a vehicle has no value for a constraint? The vehicle is treated as having no limit for that constraint.

Can a capacity be negative? No. Capacities are zero or more.

What if a visit needs more than any vehicle can carry? The visit is dropped, unless Auto Split is on, in which case it is split across several trips or vehicles.

Can each hub use different constraints? Yes. The list is shared, but each hub’s profiles choose which constraints to use.