Route Planner On-demand

Configuring Compartment Profiles


Compartment Profiles help manage vehicle compartment data, such as capacity limits and shipment compatibility. They are especially useful for bulk-enabled vehicles, complex routing, or when compartment-specific logic is required in planning and dispatch.


Understanding Compartment Profiles

A Compartment Profile defines the structure and behavior of vehicle compartments during route planning.

Key attributes include:

  • Whether compartments are optional or required

  • If compartments can be swapped

  • Corridor effectiveness thresholds based on percentage fill

Once configured, these profiles can be assigned to vehicles and viewed in Map View and Dispatch for better planning visibility.


Use Compartment Profiles when:

  • Vehicles carry multiple shipment types with different compartment needs

  • You need to enforce specific capacity rules

  • You want to distinguish between bulk and non-bulk shipments

  • Compartments are part of optimization logic


Managing Compartment Profiles

Creating a Profile

  1. Go to Configuration > Compartment Profiles.

  2. Click Add A Compartment Profile.

  3. Complete the profile information:

    • Name (required): Enter a unique name for the profile.

    • Compartments Optional: Select if compartments are not mandatory for the vehicle.

    • Compartments Can Be Swapped: Select if compartment reassignment is allowed.

    • Corridor effective when % free: Enter a percentage value that defines the threshold at which a corridor becomes usable based on available space.



  4. Check I have verified this information to be correct and click Save.

Adding Compartments

After saving the profile, you can define the specific compartments it includes.


  1. From the Compartment Profiles list, click Edit next to a profile.

  2. Click Add Compartment.

  3. In the new row, enter the following details:

    • Name: Label used to identify the compartment.

    • Accessibility: Define if the compartment is always accessible or restricted.

    • Piece Capacity: Maximum number of units (e.g., packages).

    • Weight Capacity: Maximum weight the compartment can carry.

    • Volume Capacity: Maximum volume (typically in cubic meters).

    • Min Piece/Weight/Volume Capacity (optional): Define lower limits if needed for optimization behavior.



  4. Repeat Add Compartment for each additional compartment needed.

  5. Check I have verified this information to be correct and click Save.


Editing a Profile

To edit a profile:

  1. From Configuration > Compartment Profiles, double-click on a profile record from the Compartment Profiles list.

  2. Make the desired changes.

  3. Check I have verified this information to be correct and click Save.


Cloning a Profile

Starting in version 25.07, you can clone compartment profiles and their assigned compartments by right-clicking on an existing record and selecting Clone from the context menu.


Deleting a Profile

To delete a profile:

  1. From Configuration > Compartment Profiles, double-click on a profile record from the Compartment Profiles list.

  2. Select "I have verified this information to be correct" and click Delete.

If the profile is assigned to vehicles, deletion triggers a confirmation prompt:

  • Single vehicle: "Compartment profile is assigned to vehicle: [name]"

  • Multiple vehicles: Lists all affected vehicle keys.


Assigning Profiles to Vehicles

To assign a compartment profile to a vehicle:

  1. Go to Configuration > Vehicles

  2. Click Edit on a vehicle.

  3. Select a Compartment Profile from the dropdown.



  4. Check I have verified this information to be correct and click Edit Vehicle.


Viewing Profiles from the Vehicles Page

  • Compartment and vehicle profile names in View Vehicles are clickable.



  • Redirection opens the Edit window in the same tab.



Viewing Compartment Capacity and Shipments

Once compartment profiles are in use, capacity and allocation details can be visualized via the Compartment Information window. This display is available from the route or stop context menus in Map View and Dispatch.


Viewing Compartment Data

To access compartment metrics:

  • Right-click a stop or route and select Compartment Info.

  • Each compartment displays:

    • Pieces, Volume, Weight: Shows used vs total capacity (e.g., 174/250 (69.6%))

    • Shipments: Lists shipments assigned to that compartment with their quantities

    • Product Type (if applicable): Displays material classification (e.g., Gasoline, Foam, Aerosol)

    • Formatted Values: Numeric data is now shown with thousands separators for readability (e.g., 9,999.00)

  • Empty Compartments: Labeled as EMPTY when no shipment is assigned


Optimization Integration

Setup

To set up capacity for compartment usage in optimization:

  1. In Deliveries > Map View, switch to Dispatch mode.

  2. From the top header menu, go to Sequencer/Optimizer.

  3. Navigate to the Capacity tab.

  4. Enable at least one setting (e.g., Use Pieces). Set it to Yes.

Shipment attributes must match the enabled capacity type (e.g., weight-based shipments will not show properly if only "Use Volume" is active).


Bulk Compatibility

  • Bulk shipments must match bulk compartments.

  • The system:

    • Sends compartment data to the optimizer.

    • Validates routing compatibility.

    • Prevents non-bulk items from using bulk-only compartments.


Exception Management

Validation Alerts

  • Overloaded Compartments: Highlighted in red

  • Bulk Conflicts: E.g., multiple bulk items in one compartment

  • Route vs Stop Mismatches: Now unified


Commodity Code Rules

The system supports the enforcement of commodity code rules within compartments.

  • Prevents mixing incompatible.

  • Validation occurs during routing and optimization.

  • Exceptions are shown only when violations occur.


Clearing Profile Assignments via Vehicle Parser

Follow these steps to remove assigned Vehicle Profile and Compartment Profile values using the Vehicle Parser:

  1. Open your parser update file (CSV or TXT format).

  2. Ensure all required fields (e.g., Vehicle Key, Mileage, Speed Profile) are present.



  3. Locate the columns for:

    • Vehicle Profile

    • Compartment Profile



  4. To remove assignments, leave these columns blank for the corresponding vehicle.

    • To assign profiles instead, enter values like "CapacityVehicle" or "Compartment_NonBulk" in those columns.



  5. Save and upload via Configuration > View Vehicles.

  6. Review the upload and confirm updates in View Vehicles.

    • Vehicles with filled fields now display the new profiles.

    • Vehicles with blank fields now show no profile assigned.


Back to Top