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
Go to Configuration > Compartment Profiles.
Click Add A Compartment Profile.
-
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.
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.
From the Compartment Profiles list, click Edit next to a profile.
Click Add Compartment.
-
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.
Repeat Add Compartment for each additional compartment needed.
Check I have verified this information to be correct and click Save.
Editing a Profile
To edit a profile:
From Configuration > Compartment Profiles, double-click on a profile record from the Compartment Profiles list.
Make the desired changes.
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:
From Configuration > Compartment Profiles, double-click on a profile record from the Compartment Profiles list.
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:
Go to Configuration > Vehicles
Click Edit on a vehicle.
Select a Compartment Profile from the dropdown.
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:
In Deliveries > Map View, switch to Dispatch mode.
From the top header menu, go to Sequencer/Optimizer.
Navigate to the Capacity tab.
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:
Open your parser update file (CSV or TXT format).
Ensure all required fields (e.g., Vehicle Key, Mileage, Speed Profile) are present.
-
Locate the columns for:
Vehicle Profile
Compartment Profile
-
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.
Save and upload via Configuration > View Vehicles.
-
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.