See your routes optimized in 60 seconds

• lifo_mode: "soft" or "hard" — many furniture routes want hard.
• time_window_mode: "hard" or "soft" (default hard)
• enforce_geometry: keep true unless routing-only

• quality_weights: tilt solution selection toward better routing vs better loading (default routing 0.6 / loading 0.4).

• break_rules.mandatory_break_duration (sec)
• break_rules.drive_time_before_break (sec)

• solver_max_seconds, local_search_iters: runtime vs quality
• metaheuristic.enable_ga: enable genetic search
• metaheuristic.population_size, generations, elite_fraction, mutation_rate
• vrp_lns (and policies.vrp_lns): LNS tuning knobs (advanced)

• feasibility_prover_enabled: attempt a proof when planning fails
• feasibility_prover_max_seconds, feasibility_prover_max_items
• feasibility_prover_extract_core + feasibility_prover_core_seconds: extract a minimal “unsat core”
• feasibility_prover_include_witness: include assignment/witness details when possible

• Identity: truck_id, truck_type
• Start: start_location, start_time
• Crew: crew_size (1=driver, 2=driver+helper)
• Interior dims (in): dims.l, dims.w, dims.h
• Route limits: max_miles, max_duration, max_stops
• Capacity: max_cargo_weight, max_cargo_volume (if used)
• Capabilities: has_liftgate, has_dolly, has_pallet_jack
• Dock/service: dock_height_mode and loading_sides

• job_id (int)
• priority (int) — higher wins when tradeoffs exist
• exclusive_truck_ids (optional) — force assignment

• stop_id, type ("pickup" or "delivery")
• address, lat, lng
• Time windows: earliest, latest (ISO8601)
• service_time_sec — affects routing feasibility/on-time
• Equipment requirements: requires_liftgate, requires_dolly, etc.
• dock_height and loading_side constraints

• item_id (string)
• weight (lbs)
• dims in inches: { "l", "w", "h" }
• item_class (e.g., upholstery, wood, glass, mattress)

• stackable (bool)
• is_top_flat (bool) — false for rounded/tufted pieces
• fragile (bool)
• max_stack_weight and max_tier

• position_constraint: none | bottom | rear | top
• allowed_orientations: upright / rotated
• tilt_modes: e.g. upright / side (for rugs/mattresses if allowed)

• assembly_id (optional) — keeps related pieces grouped

• is_nestable: the item nests with others (chairs/stools)
• can_accept_underload: item creates a cavity (tables/bed frames)
• can_nest_with: list of allowed classes/SKU prefixes that can go inside/under
• stack_group_id (+ members) for “virtual stacks”

• constraints.bottom_layer, constraints.top_layer: force items to the bottom/top layer
• constraints.front_load, constraints.rear_load: bias placement toward the front/rear
• constraints.z_band: keep items in a vertical band (bottom/mid/top)
• mesh_url + mesh_format: optional 3D mesh reference (for higher-fidelity packing/visualization)
• Hazmat separation: hazmat.incompatible_with + hazmat.requires_separation_in

• low utilization (under ~85%)
• unplaced items (big penalty)
• center-of-gravity bias
• physics alerts

• miles relative to truck.max_miles
• lateness (total delay)

• Accurate item dimensions + weight (missing/rounded dims destroy packing quality).
• Use item_class, fragile, is_top_flat, stackable, max_stack_weight realistically.
• Use stop time windows + service_time_sec if on-time delivery matters.

• Nesting: can_accept_underload (tables/frames), is_nestable (chairs), and can_nest_with.
• LIFO: set lifo_mode="hard" when unload order must match stops (may reduce utilization but improves realism).
• Orientation/tilt: allow "side" for mattresses/rugs if permitted; glass usually cannot.

• Use haversine early; switch to google_routes for production ETAs/traffic.
• Enable GA only when chasing higher utilization and you can afford more compute.
• If voxel nesting is enabled, don’t start with very small voxel_pitch_in (accuracy ↑, cost ↑).

• Set a fixed seed so ops can compare before/after on identical inputs.

This example includes seed, nesting fields, and objective weights.

{
  "config": {
"depot_address": "DC - Nashville",
    "depot_lat": 36.1627,
    "depot_lng": -86.7816,
    "timezone": "America/New_York",
    "seed": 12345,
    "travel_matrix": {
      "provider": "google_routes",
      "traffic": true,
      "routing_preference": "TRAFFIC_AWARE",
      "fallback_to_haversine": true,
      "timeout_sec": 15.0
    },
    "lifo_mode": "hard",
    "time_window_mode": "hard",
    "enforce_geometry": true,
    "policies": {
      "fragile_separation": true,
      "aisle_priority": true,
      "strap_priority": true,
      "enable_voxel_nesting": true,
      "voxel_pitch_in": 2.0,
      "objective": {
        "weights": { "total_miles": 1.0, "trucks_used": 0.6 },
        "truck_fixed_cost_miles": 80.0
      }
    },
    "metaheuristic": {
      "enable_ga": false,
      "population_size": 18,
      "generations": 10,
      "elite_fraction": 0.25,
      "mutation_rate": 0.25
    },
    "quality_weights": { "routing": 0.5, "loading": 0.5 }
  },
  "trucks": [
    {
      "truck_id": "T-101",
      "truck_type": "dry-van-53",
      "start_location": "DC - Nashville",
      "start_time": "08:00",
      "crew_size": 2,
      "dims": { "l": 636.0, "w": 100.0, "h": 110.0 },
      "max_miles": 450.0,
      "max_duration": 39600,
      "max_stops": 20,
      "max_cargo_weight": 34000.0,
      "has_liftgate": true,
      "has_dolly": true,
      "dock_height_mode": "either",
      "loading_sides": ["rear"]
    }
  ],
  "jobs": [
    {
      "job_id": 9001,
      "priority": 3,
      "stops": [
        {
          "stop_id": "S1",
          "type": "delivery",
          "address": "123 Main St, Franklin, TN",
          "lat": 35.9251,
          "lng": -86.8689,
          "earliest": "2025-12-20T10:00:00-05:00",
          "latest": "2025-12-20T12:00:00-05:00",
          "service_time_sec": 1800,
          "requires_liftgate": true,
          "dock_height": "ground",
          "loading_side": "rear",
          "items": [
            {
              "item_id": "TABLE-72IN-001",
              "weight": 180,
              "dims": { "l": 72, "w": 42, "h": 30 },
              "item_class": "wood",
              "fragile": false,
              "stackable": false,
              "can_accept_underload": true,
              "can_nest_with": ["chairs", "stools", "boxed"],
              "allowed_orientations": ["upright"],
              "tilt_modes": ["upright"]
            },
            {
              "item_id": "CHAIR-SET-001-A",
              "weight": 28,
              "dims": { "l": 22, "w": 22, "h": 40 },
              "item_class": "chairs",
              "fragile": false,
              "is_nestable": true,
              "stack_group_id": "CHAIRS-SET-001",
              "allowed_orientations": ["upright", "rotated"]
            }
          ]
        }
      ]
    }
  ]
}