IMOS On-Prem - Operations Tab - Voyage Manager

Welcome to the Veson Nautical Knowledge Base. In the Help Center, you can view the same articles and contact support as needed.

IMOS On-Prem - Operations Tab - Voyage Manager

 This is a Key Topic, with high value for all users. See the Key Information below.


The Voyage Manager Operations tab is the default tab; it is active when the Voyage Manager opens. The Operations user enters most of the voyage data on this tab.

  • When an Alert is entered for a Charterer, a Vessel, or a Port, the field is highlighted in light red.

Toolbar

  • : Copy the details of a voyage:

    • To create a new voyage, click 

       and then click Copy Voyage.

    • To create a Voyage Estimate for creating a similar voyage or to evaluate operational what-if scenarios, click 

       and then click Copy to Estimate.

  • : Open Freight Invoice or Expenses Rebill Management.

  • : View and create Freight/Relet CommissionTC In or Out Commission, or Claim Commission Payments.

  • : Open Voyage Other Revenues and ExpensesRebills for Off Hire and Port Expenses (when configuration flag CFGRebillForOffhire is enabled), Deviation Analysis, or Profit Share.

  • : Open Estimated DemurrageNew Laytime Calculation Setup, or Laytime Notes (to record notes related to the Laytime Calculation).

  • : Open Delay.

  • : Open Voyage Bunkers, open Bunker Liftings, or Add Fuel Types From Vessel that are not present in the voyage.

  • : Run Voyage Manager Reports or a Voyage XML Export.

Summary Tree

The Summary tree is at the right; it summarizes important data and forms. You can attach documents or links or double-click to open an attachment.

  • Under Laytime, for demurrage/despatch claims, letters appear that refer to the port function and sequence used in the Laytime Calculation. 
    Example: In the following image, L200 indicates a loading (L) port with sequence number 200, and M indicates multiple ports.

Summary Tree for Mirrored Voyages

The Summary tree includes links to any mirrored voyages. To open a voyage, at the bottom of the tree, next to

, click 
 to expand the list, and then double-click the voyage.

Summary Tree for Tow Voyages

With the Barging module, equipment is sorted in the Summary tree based on type; Boats appear first, followed by Barges. Additionally:

  • Equipment that stays in the voyage until completion appears at the top of the tree.

  • A green icon (

    ) appears next to equipment that is currently in the voyage.

  • A red icon (

    ) appears next to equipment that has departed the voyage.

You can see all Tasks for all voyages in the Task List.

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.

Itinerary Grid

In the Itinerary grid, enter each Port Name and Function.

  • Last TCI/TCO Voy: Select to indicate if the voyage is the last TCI/TCO voyage.

  • Drydock: Select to indicate a drydock voyage. For more information, see Recording Drydock Voyages.

  • 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.

  • Miles defaults based on the IMOS 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.

  • 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.

  • 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 
    .

  • LS Only: Select to use low-sulfur fuel only for all consumption. This will overwrite any Fuel Zone applied to the voyage.

  • Piracy/ECA Routing: Select an option:

Itinerary Context Menu

Many options are available from the Itinerary context menu. The options change based on the port function; for example, there are no port expenses at a port with function C (Commencing), so the Port Expenses form is not available at a C port. Right-click a port and then click any of the following:

  • Options to adjust the Itinerary:

    • Insert Port

    • Delete Port

    • Move Up (or type Ctrl + Up Arrow)

    • Move Down (or type Ctrl Down Arrow)

    • Move To:


      Select the Port and either Move Before or Move After.

    • If the port has associated Pilot Stations (configuration flag CFGEnablePortPilotStations must be enabled):

      • Insert Pilot Before

      • Insert Pilot After

      • Switch to Pilot

  • Options to open forms:

To enter Fixture and/or Operations Itinerary remarks, right-click an itinerary line and then click Fixture Itinerary Remarks or Operations Itinerary Remarks. Enter the remarks and then click OK.

CP Terms Tab

This tab enables you to view twice as many port call lines without having to scroll. It is enabled by configuration flag CFGExpandVoyageManagerRowsets.

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 in 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 tab and the Draft/Restrictions tab 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 the arrival/departure ROBs on 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. For Estimates created in previous IMOS versions, the value for the Estimate is retained to avoid changing the P&L. For new Estimates, 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:

    1. Open the Activity Report for the port that the vessel most recently arrived at or sailed from.

    2. In the DstToGo column, if the value is 0, enter the DToGo (Distance to Go) value from the Voyage Manager for that leg.

    3. Save and exit the Activity Reports form.

    4. Save the voyage. The ETA at the next port should be editable.

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.

  • ECA Miles: Shows the ECA distances between port calls.

  • Instr Type: Instruction type; appears if Vessel Type Fuel Warranty Table is other than None.

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

Many options are available from the Cargoes context menu. Right-click a cargo and then click any of the following:

  • CP Terms Details: To open the CP Terms Details form, which describes the charter party terms for the cargo. On this form, you can click 

     to view the Cargo form.

  • CP Quantity Details: To open the CP Quantity Details form, 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 Cargo

    • Duplicate Cargo

    • Remove Cargo

  • Cargo Loss: To open the Cargo Loss form to enter information about cargo losses.

Properties/Summary/Roles

Properties of the voyage, a Summary of its data, and (with configuration flag CFGEnableVoyageRoles enabled) assigned Roles appear in the lower right corner.

  • User Group and User fields can be configured to display a different field label, using configuration flags CFGUserGroupPrompt and CFGUserPrompt.

  • Company code and LOB: The Time Charter contract might have Company Code A, and the vessel might have Company Code B. When the Time Charter Contract is fixed and scheduled with the vessel, the Voyage Manager defaults to the Vessel Code, thus will have company code B, but it can be changed. For invoices and posting, the default Company Code on the Transaction Data Entry form when posting TC items should be A, and for other voyage items it should retain the Company Code of the voyage.

  • 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.

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

 

Name/Flag

Description

Name/Flag

Description

Allow Operations Voyage Renumbering
CFGAllowOpsVoyageRenumbering

When enabled, users can specify a new Voyage Number for a voyage by modifying the corresponding field in the Voyage Manager or the Voyage Fixture, or by rescheduling the voyage via the Voyage Manager Copy toolbar button. In addition, the Edit Voyage Number Module Right appears, allowing this ability to be granted to certain users but not others.

Allow Restrict Voyage Auto Number Consecutive
CFGAllowRestrictVoyAutoNumberConsecutive

Note: CFGUseGlobalVoyageNumbering must be set to N.

If enabled, a new Voyage Auto-Numbering/Consecutive Checkboxes Module Right appears, allowing the administrator to restrict users' rights to modify the Automatically Number Voyage check box on the Create New Voyage Form, along with the Consecutive Voyage check boxes on the Create New Voyage Form and Voyage Manager.

Auto Complete Voyage
CFGAutoCompleteVoyage

Sets the Voyage Status to Completed if a Departure report has been entered for the last port call of the voyage. This applies only to voyages that do not end in a Terminating (T) port.

Cargo Handling Trade No Title
CFGCargoHandlingTradeNoTitle

Provides an override for the column title of the Trade No. column, which is enabled with CFGEnableCargoHandlingTradeNo. Leaving the setting blank causes the column title to remain Trade No.

Copy Cargo Reference to Voyage
CFGCopyCargoReferenceToVoyage

If enabled, when scheduling a voyage from a Cargo, the voyage's Reference field is populated with the value from the Cargo.

Default Company on TCI Select
CFGDefaultCompanyOnTciSelect

When selecting a TC In Fixture to be used for a Voyage/Voyage Estimate, if no Company has been selected, the Company on the selected TC In Fixture will be used.

  • If the Vessel is changed in a Voyage Estimate, the Company field will be the Company of TCI/Head Fixture or Vessel, based on the values of CFGDefaultCompanyOnTciSelect and CFGDefaultCompanyFromVessel.

  • If the Vessel is not changed, but the TCI/Head Fixture is changed, the Company field will change accordingly, also respecting the value of CFGDefaultCompanyOnTciSelect.

Default Forecast Voyage Status
CFGDefaultForecastVoyStatus

When this and Enable Forecast Voyage configuration flags are enabled, initial Voyage Status is Forecast by default instead of Scheduled.

Default Lob on Cargo Import
CFGDefaultLobOnCargoImport

When importing a cargo, specifies whether or not the LOB specified on the imported cargo should be used to default the LOB on an Voyage Estimate, Voyage Fixture, and Voyage Manager if an LOB has not yet been specified.

Default Lob on TCI Select
CFGDefaultLobOnTciSelect

When enabled, when a Time Charter In is selected, if an LOB has not yet been set in the Estimate/voyage, the system defaults to the LOB specified on the Time Charter In Contract.

Default Trade Area on Cargo Import
CFGDefaultTradeAreaOnCargoImport

Enables defaulting the Trade Area on a voyage to the one from the imported Cargo.

Default Voyage DA Desk Enabled
CFGDefaultVoyageDADeskEnabled

For every newly scheduled voyage, selects the DA-Desk check box (enabled by CFGShowDADeskCheckBox) by default.

Default Weather FactorCFGDefaultWeatherFactor