rotation_restrictedITEM 31
this side upwould only fit lying down, and the item may not be laid down
Each rule is a request field, enforced during the search by every engine and recomputed afterwards by a validator that shares no code with it.
inner_dimensions + clearance · made_to_measure · deformable_boundary · pallet_overhang_limitEvery placement stays inside the usable volume, on exact integers. A container can also be a cut-to-measure box, a mailer or an overhung pallet.
inner_dimensions + clearance · made_to_measure · deformable_boundary · pallet_overhang_limitEvery placement stays inside the usable volume, on exact integers. A container can also be a cut-to-measure box, a mailer or an overhung pallet.
shape_type · hull_vertices · compression_ratioTwo opt-in shapes beyond the rigid cuboid: a convex hull decided by exact integer geometry, and a compressible item that yields under load.
exact fixed-point ticksLengths and weights accept fractional, decimal or unit-suffixed input and are carried as exact ticks, with no floating point before the score.
allowed_rotations · keep_uprightOrientation is restricted per axis, not as a single on/off switch, and 'this side up' is expressible on the item that needs it.
obstacles + additional_boxesReserved volumes are geometry: unions of exact boxes approximate a wheel arch, a post or a roof shelf, and placements route around them.
minimum_support_ratio · ground_contact_ruleThe supporting footprint is computed as exact contact area against the floor or the items below, including loads bridged across two neighbours.
max_top_load · cumulativeLoad is propagated through the contact graph, so a bearing limit is checked against the whole stack above an item rather than its direct neighbour.
stackable · max_stacked_items · nesting_height · max_stack_density · stacking_groupStackability, stack counts, nesting height, density limits and stacking groups shape a legal column, checked at every level, not only the floor.
weight · max_payload · tare_weightItem weight, container tare and payload capacity are exact, and a candidate that would overload the container is refused during the search.
centre of mass · support polygon · axlesThe aggregate centre of mass, the support polygon and exact gross two-axle reactions are enforced through the same constraint layer as geometry.
incompatible_tags · group · policyItems can be required to stay together or apart, and versioned eligibility rules travel in the request with the context they select on.
stop_index · access_directionsA reachable unloading sequence: nothing due later is buried under an earlier item, or parked between it and a door the container declares.
recompute from the resultA validator that shares no code with the solver recomputes the objective and every affected rule from the placements each runtime returned.
lexicographic exact integersSeven selectable rankings, from fewest containers to most volume packed. Six rank the units left over first; one ranks the volume left over first.
WHEN IT SAYS NO
Every unpacked item comes back with a reason code, the details behind it, and how strongly that reason is backed. This is what support, a warehouse operator or a retry policy actually needs.
rotation_restrictedwould only fit lying down, and the item may not be laid down
no_feasible_placementevery candidate position left the footprint below the required support ratio
group_cannot_fit_togetherthe group travels whole or not at all, so neither unit was placed