IMOS - Voyage Manager
Home > Operations > Voyage Manager
🔑 This is a Key Topic, with high value for all users.
In the Voyage Manager, you can view all voyage information in context and in a centralized workspace. In addition to global panels, workspace panels display the voyage P&L, Summary (overview with links to relevant information), Invoices, Forms (voyage reports submitted by vessels), Voyage Instructions, Contacts, Notes, and Properties. You can also switch between a detailed and map view of the itinerary.
To view an existing voyage, do one of the following:
On the Voyage List, click its row or Voyage No. link.
On the Vessel Schedule or Port Schedule, click its bar.
A new voyage can either be created from scratch or contain the data entered by the Chartering user into an Estimate, Voyage Fixture, Cargo, VC In, Time Charter In, or Time Charter Out.
The Voyages card panel on the left is collapsed by default. To expand it, click >>; to close it, click X.
As with any other details view, you can navigate to a different record by clicking its card or return to the list by clicking its Name.
To share a voyage, copy its URL and then share it with any signed-in users in your organization.
Details about the voyage are in the center:
Voyage information appears in sections for general information, Itinerary, and Cargoes.
You can access additional tools, forms, and information on the toolbar and right panel.
To view the voyage on the map, click at the top right. To return to the grid view of the Voyage Manager, click .
When an Alert is entered for a Charterer, a Vessel, or a Port, the field is highlighted in light red.
Toolbar
Use tools on the toolbar to create, find, save, or delete records.
Navigate to the previous < or next > voyage.
Estimate: Open the Estimate.
Freight: Open Freight Invoice or Expenses Rebill Management.
Commission: View and create Freight/Relet Commission, TC In or Out Commission, or Claim Commission Payments.
Other Rev/Exp: Open Voyage Other Revenues and Expenses, Rebills for Off Hire and Port Expenses (when configuration flag CFGRebillForOffhire is enabled), Deviation Analysis, or Profit Share.
Laytime: Open Estimated Demurrage, New Laytime Calculation Setup, or Laytime Notes (to record notes related to the Laytime Calculation).
Delays: Open Delay.
Bunkers: Open Voyage Bunkers, open Bunker Liftings, or Add Fuel Types From Vessel that are not present in the voyage.
Reports: Run Voyage Reports or a Voyage XML Export.
Validation symbol: If information is not complete and correct, click the symbol to see a message describing any issues.
- : All information is complete.
- : Some information is missing.
- : The form contains one or more errors.
Tow Voyages
With the Barging module, there are additional options on the toolbar for managing Tow voyages:
Overlap: Access the Tow and allocate overlap costs. This button appears when a tow is participating in overlapping voyages.
Equipment: Access the Activity Log to manage the equipment involved in the voyage.
Workspace Panels
To access additional information in workspace panels on the right, click buttons for any of the following:
Most of these panels can be expanded; in that case, the Voyage Manager is collapsed:
You can also access the Documents panel from the Voyages workspace.
Tutorial: Accessing Voyage Panels and Map View
Note: This tutorial is a GIF, which plays on a loop and does not include any audio narration. To restart the tutorial, refresh this page. To expand the tutorial, click it.
General Information
General information is at the top of the Voyage Manager; different fields can appear, depending on the Operation Type and your configuration.
The required fields, Vessel and Voyage Number, are pulled in from the Time Charter Out, Voyage Fixture, or Create New Voyage form. With configuration flag CFGAllowOpsVoyageRenumbering enabled and the Edit Voyage Number Module Right, you can specify a new Voyage Number.
Once a voyage is created, you cannot change the nominated Vessel. If you need a different vessel, a new voyage must be scheduled.
Consecutive Voyage: Select to synchronize the Voyage Completing date/time and end bunker lots of the previous voyage with the Voyage Commencing date/time and opening bunker lots of the current voyage.
LS Only: Select to use low-sulfur fuel only for all consumption. This will overwrite any Fuel Zone applied to the voyage.
Drydock: Select to indicate a drydock voyage. For more information, see Recording Drydock Voyages.
Last TCI/TCO Voy: Select to indicate if the voyage is the last TCI/TCO voyage.
User Group and User fields can be configured to display a different field label, using configuration flags CFGUserGroupPrompt and CFGUserPrompt.
Piracy/ECA Routing: Select an option:
Default: Uses the vessel's default routing preferences specified on the Routes tab in the Vessel form.
Disabled: Uses the most direct route.
Enabled: Reroutes around all piracy zones.
Click any of the following to update additional information:
VESSEL NAME: Open Vessel details.
FIXTURE NO.: Open the Voyage Fixture.
Itinerary Grid
In the Itinerary grid, enter each Port Name and Function.
Function: Some Port Functions drive default behavior at the port. For example, L and D require cargo handling; Y and Z require delivery and redelivery.
If bunkers have been received at a port, or if actual Port Expenses have been entered, that port cannot be changed to functions C, P, or T. These functions have no port time, so no bunkers can be received, and no port expenses can be incurred.
When Port itinerary is created, by default, row colors alternate between white and grey colors for clearer depiction. The color will change when certain port functions are assigned:
'‘I'’ - Canal Transit : Row color changes to light blue
‘M' - multi-purpose : Row color changes to orange
Manually assigning 'P' function to a specific port or point : Row color changes to light blue
Miles defaults based on the Veson IMOS Platform Distances table and is calculated in the following way:
When the preceding sea leg is completed and the observed distances are reported in the Activity Reports, the value is the sum of the reported observed distances. It is shown in black to indicate it as the actual distance.
If the preceding sea leg is not yet completed, or if any observed distance was not reported in the preceding sea leg, the value will remain as the estimated value. It is shown in grey to indicate it as an estimated distance.
Editing Miles adjusts bunker consumption and port arrival and departure.
By default, the Miles (nm) value is back-calculated by the system. However, it can manually be changed before Activity Reports are submitted.
Speed defaults basis the Vessel form. Editing this field adjusts bunker consumption and port arrival and departure.
WF% (Weather Factor) and XS (Extra Sea Days, with a day value), and P Days (Port Days) can also be adjusted to manipulate the Itinerary.
St (Status) for each port changes, based on Port Activities:
.. = Not arrived
AR = Arrived
SA = Sailed
TE = Terminated; sailed from the last port in the voyage
A Transit port (Port Function P or I) can be locked to prevent it from being changed or removed: Right-click the port and then click Lock Transit Port. A locked Transit port has a light blue background in the Itinerary.
A Transit port cannot locked by default. To remind users to lock a Transit port, you can create an acknowledgeable Alert at the Voyage level.
Actual arrival and departure times are black; estimated times are blue.
Upcoming ports with insufficient bunkers are red.
If the bunkers ROB falls under the safety margin (specified per fuel type for the Vessel), the text in the port line turns red, and the Voyage Validation icon turns red , so you can plan to get more bunkers. To work with bunkers, click Bunkers.
To choose a perspective, click a tab:
CP Terms (with configuration flag CFGExpandVoyageManagerRowsets enabled)
Consumption (with configuration flag CFGVoyageFormat set to 1)
Properties (when User-Defined Fields applicable to the voyage are set up)
Itinerary Line Item Menu
Depending on the Itinerary perspective and Port Function, you can access the following forms from a port line item. Right-click and then click:
Activity Log - Barging: To manage equipment (or Activity Log without the Barging module).
Lightering Information: To edit the Lightering Job form (requires the Lightering module).
To enter Fixture and/or Operations Itinerary remarks, click Fixture Itinerary Remarks or Operations Itinerary Remarks, enter the remarks, and then click OK.
You can also take the following actions on Itinerary line items using the line item menu:
Insert Port
Delete Port
Lock Transit Port (Port Function P or I): Prevent the port from being changed or removed.
Routing: Select a route from different options.
Move Up
Move Down
If the port has associated Pilot Stations (configuration flag CFGEnablePortPilotStations must be enabled):
Insert Pilot Before
Insert Pilot After
Switch to Pilot
CP Terms Tab
Note: Configuration flag CFGExpandVoyageManagerRowsets must be enabled.
This tab enables you to view twice as many port call lines without having to scroll.
BL Info Tab
The BL Info tab is a view of Cargo Handling, with Bill of Lading information and actual Ship quantities.
You do not have to open the Cargo Handling form; you can update this information here.
Notes:
When operating a RELT voyage, only cargo handling lines for Sale (Cargo) contracts are permitted to be entered on the BL Info tab. If cargo handling lines for linked Purchase (VC In) contracts are present, contact Veson Nautical Support via the Help Center for troubleshooting assistance.
The decimal places set for BL/Disch. Qty are hard-coded and cannot be changed.
Cargo and Draft/Restrictions Tabs
The Cargo and Draft/Restrictions tabs are the same as on the Voyage Fixture. If something changes, you do not have to go back to the Voyage Fixture; you can make any adjustments here.
Bunkers Tab
The Bunkers tab displays the Arrival and Departure date and time for each port, with the amounts for each bunker type on arrival, received, and on departure.
On the Voyage Manager Itinerary, you can update arrival/departure ROBs on the Bunkers tab for upcoming ports to effectively plan and manage your voyages. Once edited, values appear blue to indicate a manual override. Actualized ROBs and commencing ports are not editable.
Port/Date Tab
The Port/Date tab is the default tab.
If two loading ports with the same cargo name are entered on the Cargo or CP Terms tab, they will appear as one loading port on the Port/Date tab.
For LNG Carriers, this tab includes an additional Fuel Cons Mode column. The Fuel Consumption Mode can be specified separately for each voyage leg. These defaults can be overridden on any leg:
Automatic
Dual Fuel
IFO Only
LNG Only
Arrival: If you cannot edit the ETA for a port in the Arrival column, follow these steps:
Open the Activity Report for the port that the vessel most recently arrived at or sailed from.
In the DstToGo column, if the value is 0, enter the DToGo (Distance to Go) value from the voyage for that leg.
Save and exit the Activity Reports form.
Save the voyage. The ETA at the next port should be editable.
At the bottom of the grid, Avg Speed = Total Miles / Total Sea Days / 24 Hours per Day
The ID No, or port sequence number, cannot be altered in an existing line item of the itinerary (e.g., you cannot change a port's ID No from 300 to 123 or 301). However, you can delete and re-add the port into the itinerary; this will change the ID No to the next available value, in increments of 100.
Consumption Tab
Setting the value of configuration flag CFGVoyageFormat to 1 enables the Consumption tab and adds Anchor In, All Fast, Alongside, and Anchor Out columns to the Port/Date tab.
B/L: Indicates if the vessel is Ballast or Laden during a port call. If Auto is selected, then the system determines ballast or laden status based on any cargo quantities entered on the itinerary.
CO2 (MT): Calculates CO2 emitted. If a fuel's CO2 Factor is ≤ 1.0000 or empty, the CO2 (MT) column will not calculate and will appear light red.
CO2 emissions are calculated by multiplying bunkers consumed by their associated CO2 Factors for the designated voyage leg. If multiple grades of bunkers are consumed, your CO2 emissions will show the joint value of all CO2 emissions for the associated voyage leg.
ECA Miles: Shows the ECA distances between port calls.
Instr Type: Instruction type; appears if Vessel Type Fuel Warranty Table is other than None.
At the bottom of the grid, Avg Speed = Total Miles / Total Sea Days / 24 Hours per Day
Properties Tab
On the Properties tab, when User-Defined Fields are set up in the Data Center, they can be selected here and values entered for them.
Cargoes Grid
The Cargoes grid displays any cargoes from the Voyage Fixture. You can add a row to add cargo; if you have multiple cargoes for one port or one cargo loading or discharging at multiple ports or berths, enter each on a separate row.
For Opt % and Opt Type, see Cargo Tolerance Option Types.
For T (Freight Type) = W (World Scale), see World Scale Rates.
Many options are available from the Cargoes line item menu. On a line item, right-click and then click any of the following:
CP Terms Details: Open CP Terms Details, which describes the charter party terms for the cargo. To view the Cargo form, on the CP Terms Details form, click View.
CP Quantity Details: Open the CP Quantity Details, with quantity and billing details.
Options to adjust the Cargo:
Import Cargo: Set search criteria and select one or more Cargoes.
View Cargo: Open the Cargo form.
Swap Cargo: Search for a different cargo and either change the itinerary or select the check box to keep the current load and discharge information. For a non-relet voyage, the swapped out cargo is marked as unfixed.
Swap Sale Cargo: For RELT voyages, when VC Ins are enabled, search for a different cargo and either change the itinerary or select the check box to keep the current load and discharge information. After a new Sale Cargo is selected, the voyage is repriced, and the operational data is bound to the new Cargo.
Insert New
Duplicate Cargo
Remove Cargo
Cargo Loss: Open the Cargo Loss form to enter information about cargo losses.
Barging
The following differences are related to Tow voyages and the Barging module:
In the Cargoes grid, the Frt Rate column is highlighted in light pink for cargoes of Freight Type E.
A tooltip displays the contract rate/day for the cargo, based on the equipment participation in the voyage as of:Current system date
Voyage Completing date for voyages in the past
Voyage Commencing date for voyages in the future
Managing a Voyage
Step Number | Step | Key Information: About Voyage Status |
---|---|---|
1 |
| |
2 | To save the voyage, click . | By default, the voyage Status is Scheduled. |
3 | When the voyage begins, change the voyage Status from Scheduled to Commenced. | When the voyage Status is changed from Scheduled to Commenced, the Status for the first port changes to Sailed. |
4 | As you continue through each port, right-click the port line and click Port Activities to enter Port Activities for the voyage. The Itinerary updates with any changes. | |
5 | When you are traveling between ports, right-click the port line and click Activity Reports to track information in the Activity Reports. | |
6 | To enter Port Advances or Expenses, right-click the port line and click Port Expenses. As you enter financial information, it appears on the P&L tab. | |
7 | To enter Voyage Other Revenues and Expenses not associated with a port or with freight, click Other Rev/Exp and then click Other revenues and expenses. | |
8 | When the Start Sea Passage Port Activity is entered for the last port, the port Status changes to TE (Terminated). | The voyage Status also changes to Completed. Port, bunker, cargo, and financial data can still be modified. |
9 | After all voyage transactions are completed, change the Status to Closed. | After the voyage Status is changed to Closed, the voyage cannot be modified. |
For industry-specific voyage management workflows, see Barging, LNG, and Pooling module documentation.