/
IMOS On-Prem - Voyage Estimate, Details View

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 - Voyage Estimate, Details View

Owned by Adaptavist ScriptRunner for Confluence Cloud

Error rendering macro 'excerpt-include' : No link could be created for 'IMOS'.

In the Details view of a Voyage Estimate, you can add more cargoes and/or ports, as well as additional information, such as Miscellaneous Vessel Expenses per day, a Default Weather Factor, and price and consumption information in the Fuel Table. You can also select an Operation Type; some fields change based on the type.

Details view shows the full itinerary with miles and canals added, the commencing and terminating dates, and the financial results. From this view, you can update details for the vessel, fuel consumption and costs, cargoes, and voyage itinerary data, and fine-tune them. Each time you make a change, the TCE (Time Charter Equivalent) and expenses are updated in the P&L Summary on the right.

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

Toolbar

  • : Return to Column View.
  • : In addition to the menu commands in Column View, you can do the following:
    • Import/Export an Estimate.
    • Reorder the Itinerary after changing the Sequence on the Port/Date tab, or alter it to create the Shortest Itinerary.
    • Apply Min CO2 Speed: Select to apply speeds that result in the minimum CO2 emissions.
  • : Open the CP Terms Details form to add Cargo.
  • : Open the Create New Voyage form. After the voyage is scheduled, a Voyage Fixture is created, and the button changes to .
  • : Access Voyage Estimate reports.
  • Locking Status: Depending on the status of the Estimate and your Module Rights, whether you can save it. Click the symbol to see a message describing any issues.
    • : The Estimate has not been fixed, and you have rights to save it.
    • : The Estimate has been fixed, but you have rights to save it.
    • : The Estimate was created by someone else, and you do not have rights to save it. (These rights include saving Estimates, Fixed Estimates, Benchmark Estimates, and Estimates created by others, with configuration flag Enable Voyage Estimate User Security enabled.)
  • 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.

General Information

This section contains general information about the vessel and voyage.

  • Inheriting values:
    • These fields inherit default values from the Vessel form:
      • Vessel DWT
      • Dly Hire: The value entered in this field will contribute to Vessel Expenses, shown in the P&L Summary. It will be multiplied by the number of Voyage Days.
      • Spd Bal/Ldn (kn): You can set these speeds to any value, unless the Restrict Speeds check box is selected for the Vessel Type, which restricts vessel speeds used to those in the Speed Consumption Table on the Vessel form.
      • Opr Type
        • Owned vessel: default is OVOV
        • Voyage Charter or Time Charter vessel: default is TCOV
      • Fuel grades
      • Ballast, laden, load, discharge, and idle fuel consumption
    • These fields inherit default values from the vessel’s most recent voyage in IMOS, if one exists:
      • Commencing and Completing dates
      • Ballast Port: Corresponds with the Commencing port in Itinerary(Port Function type C) port in the itinerary
      • Reposition Port: Corresponds with the Terminating (port function type T) port in the itinerary
      • Commencing port in Itinerary
      • Fuel Price
  • TC In Code: If the selected vessel is a Tow, this field will be locked from editing.
  • Addr: The value entered here will contribute to the Less Addr Comm field, shown in the P&L Summary. It will be multiplied by the Vessel Expenses. 
  • DWF %: IMOS multiplies extra sea days on all voyage legs in the itinerary by this Default Weather Factor, which increases voyage length and expenses related to the length of the voyage.
  • On the fuel grid:
    • To open the Bunker Planning form, right-click a line item and then click Details.
    • If you add planned liftings to the Bunker Planning form with Calculation Method FIFO, Price fields for associated fuel types highlight in yellow. To view the Weighted Average price of all fuel types and details about all Planned Liftings for the voyage, hover over a Price field.

Cargoes Grid

You can add cargoes in one of these ways:

  • Enter line items in the Cargoes grid. You can then either right-click, enter the itinerary in the CP Terms Details form, and click or enter it in the Itinerary grid below, selecting the Cargo in the line.
  • Click , complete the CP Terms Details form, and click .
  • Right-click a line in the Cargoes grid and then select one of the following:
    • Import Cargo: Enter Cargo Search Criteria, click Search, and then select Cargoes to add to the grid.
    • Create Cargo: Create a Cargo from values in Voyage Estimate.
    • Insert New
    • Duplicate Cargo
    • Duplicate Cargo (Inc. Itin): Duplicate a Cargo and include its itinerary.

Freight revenue is calculated in one of these ways, depending on the setting of Bill By in CP Terms/Details:

  • If Bill By is set to CP Qty, the freight will always be calculated basis the BL Qty.
  • If Bill By is set to Bill Qty, there are two potential calculations:
    • If an itinerary is not defined for the cargo, or if L/D Qty is blank in the itinerary for the cargo, freight will always be calculated basis the CP Qty.
    • If an itinerary is defined for the cargo, and L/D Qty is populated in the itinerary for the cargo, freight will always be calculated basis the BL Qty (L/D Qty).

Complete the remaining fields. 

  • For Opt % and Opt Type, see Cargo Tolerance Option Types.
  • For T (Freight Type) = W (World Scale), see World Scale Rates.
  • For Operation Type RELT and SPOT, the first column T = contract type:
    • S = Sale (Cargo)
    • P = Purchase (VC In)

Itinerary Grid

You can add ports and information about them. The Itinerary grid has tabs to show different views.

  • On all tabs, 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 symbol turns red , so you can plan to get more bunkers. To work with bunkers, on the menu, click Bunker Planning.
  • From port lines on most tabs, you can open the Itinerary Details form from a context menu to enter additional details about the itinerary; in Column view, it appears when you select a port.
  • To adjust ports in the Itinerary, right-click for a context menu and then click any of the following:
    • 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
  • In Progress Voyage: Select to import the itinerary from an in-progress voyage.

    • In-progress Voyage Estimates include actualized other revenues and expenses, actualized voyage off-hire data, and actualized voyage bunker consumption.

    • PDA/FDA information is included in port expense calculations.

  • 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 Distances route.
    • Enabled: Reroutes the vessel around the region.

Cargo Tab

The Cargo tab includes information about the cargo for each port.

Exp Details Tab

Configuration flag Enable Cargo Expense Details adds an Exp Details tab to the Itinerary grid.

For companies that typically manage voyages on a discharge-to-discharge basis, but for some contracts are able to charge a netback on the shipping cost, this tab shows cost allocation by leg. Because the netback is on a load-to-load basis, the leg cost allocation is used to accurately calculate the amounts to charge back to the trader.

Draft/Restrictions Tab

The port calls, as on the Cargo tab, with the Max Lift for each berth, based on the vessel, its Deadweight Table, and the API/Specific Gravity of the cargo, as well as the weight of bunkers and everything on the vessel.

  • If you have the list of Low Sulfur Community ports loaded into the IMOS database, Voyage Estimate sets low sulfur port days (LS PDays) to be equal to port days (PDays) while in one of these ports (without considering Laytime Terms).
  • Low sulfur port days (LS PDays) and low sulfur sea days (LS SDays) will be calculated for ports and routes that fall within an ECA zone.

Charterer Tab

When configuration flag Enable Voyage Estimate Charterer Itinerary is enabled, a Charterer tab appears as the default tab on to the Itinerary grid.

This tab consolidates high-value information such as vessels particulars, cargo and routing details, and bunker breakdown information.

Port/Date Tab

The Port/Date tab includes the parameters for each port call that has a function, with one line per cargo, like a cargo 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.

  • 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

Bunkers Tab

The Bunkers tab enables you to enter manual values to override the Estimate’s calculated Arrival and Departure ROB quantities.

Manually entered values appear blue. To revert to the Estimate’s calculation, clear the field.

Port/Date Group Tab

The Port/Date Group tab is a collapsed view of the Port/ Date view tab, with one line per port, like a vessel 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.

  • The L/D Qty entered on a Load port will default the same quantity to that cargo's discharge port L/D Qty if the cargo is linked to the ports.
  • To lock a Transit port (Port Function P or I) to prevent it from being changed or removed, right-click the port and click Lock Transit Port. A locked Transit port has a light blue background in the Itinerary.
  • To move a port up or down in the itinerary, right-click the port and click Move Up or Move Down.

Estimate Summary, P&L Summary, and Voyage Days

This section shows the Estimate P&L, which is driven by values entered elsewhere on the Voyage Estimate form.

Estimate Summary

  • A Template Estimate cannot be fixed, and fixed/scheduled Estimates cannot be marked as Template. Users without the Update template voyage estimates Security Right cannot edit Template Estimates, but can work on a copy of a Template Estimate.
  • Benchmark:
    • A Benchmark Estimate can be viewed by a user without the Benchmark right.
    • When a Benchmark Estimate is copied, the Benchmark check box is cleared.
    • From a Benchmark Estimate, you can create a Cargo, Cargo COA, or Fuel-Neutral Cargo COA with this Benchmark Calculation as the Exposure Basis: Click  and then click Fix Cargo, Fix Cargo COA, or Fix Fuel Neutral Cargo COA. This will also associate the Benchmark Estimate as the initial Estimate of the contract as a reference to the calculation. If the Benchmark Estimate is a SPOT Estimate, a VC In COA is created upon clicking Fix Cargo COA.
    • It is possible to dynamically change a Benchmark Estimate Itinerary using the Trading Profile to match a contract and use it in the exposure calculation.

P&L Summary

  • You can enter or edit miscellaneous revenues or expenses. Click their links to add more than one line item.
  • You can adjust the Profit, Freight Rate, or TCE to see the resulting changes in the P&L. 
    • Breakeven is the minimum freight rate that you need to cover your voyage expenses so that your Profit value is equal to zero.
    • TCE (USD/d) (Daily Time Charter Equivalent) = (Net Income − (Total Expenses − (Vessel Expenses + Ballast Bonus + TCI Common Voyage Expenses − Address Commission))) / Voyage Days
      Note: TCI Common Voyage Expenses do not include ILOHC or INTHC; these two expenses affect TCE.
      • For Type G (Gas Carrier) vessels, TCE/Month appears in addition to TCE (USD/d).
    • Gross TCE = Daily TCE / (1 − x), where x is the Address Commission rate of Vessel Daily Cost or Hire.
    • To lock the Profit or TCE to back-calculate the Freight Rate, select its check box.
    • To lock the TCE to a target set on the Vessel form to back-calculate Freight:
      1. Make sure the Commencing time is set.
      2. Right-click the TCE field (or TC Equiv field in Column view) and then click Apply Vessel TCE Target. The TCE value is overwritten by the target effective at voyage commencing time and appears in blue.
      3. The TCE can still be overwritten: If the TCE lock check box is cleared or the TCE value is overwritten by changing the vessel or Commencing date, it reverts to black.

Tasks & Alerts or Revisions Panel

Either the Tasks & Alerts or Revisions panel appears at the top right corner of the form. To expand  or collapse  it, click the double arrow.

To select what you want to view, click  and then click one of the following:

  • Show Tasks & Alerts: View the Tasks & Alerts panel, which displays the Tasks and Alerts that apply to the contract. The heading bar includes the icon for the most urgent Alert or Task. If none are urgent, the Task that is in progress appears.
  • Show Revisions: View the Revisions plan, which displays a chronological list of changes to the form. You can also click Revision History to view the same information in a list.



 Related Configuration Flags
Name/FlagDescription

Add editable laytime factor

CFGEnableEditableLaytimeFactor

When enabled, adds webhook support for updating laytime termsFactor via update estimate mutation. A new field named Factor value is added to the Estimate custom itinerary. This Terms factor value can be updated as a value between 1 and 2 and is available as a field to configure and update via webhooks. Setting the Terms factor does not change the Terms themselves.
Enable Voyage Estimate Saved Ballast Days
CFGEnableVoyestSavedBallastDays

Adds Saved Ballast Days/LS and Bunker Exp fields to the Voyage Estimate and calculates the impact of Saved Ballast Days on the TCE and voyage days.

Enable Benchmark Estimate
CFGEnableBenchmarkEstimate

In Voyage Estimate Details view, under Estimate Summary, a Benchmark check box appears. To mark an Estimate as a Benchmark Estimate, select the check box. Benchmark Estimates must have exactly one cargo, and they cannot be fixed.

In Cargo COA and Cargo forms, an Exposure tab appears. If a cargo is linked to a Benchmark Estimate via the Exposure tab, the market rate will be used as the TCE in the Benchmark Estimate and back-calculate the $/ton rate in the Trading Profit and Loss.

In Cargo Matching, when creating a New Program, a Create Estimate From Benchmark check box appears; if you select the check box, the Benchmark Estimate linked to the cargo will be used as the basis for the Estimate.

Sync Cargo With Initial Estimate
CFGSyncCargoWithInitialEstimate

Syncs the Cargo with the Initial Estimate.

Lock Initial Estimate
CFGLockInitialEstimate

Locks the initial Benchmark Estimate after the Cargo contract is created. When the Cargo contract is Confirmed, it can be edited, but the corresponding Initial estimate is locked. For all other statuses, the Initial estimate can be edited, but Freight Type and Frt Rate fields on the Cargo cannot. They must be updated from the Initial estimate (applies when CFGSyncCargoWithInitialEstimate is ON).

Voyage ID by User Prefix
CFGVoyIdByUserPrefix

Automatically assigns a sequential Estimate ID number for each user prefix.

Enable Voyage Estimate TCE APS
CFGEnableVoyestTceAps

Adds an APS TCE (Arrival at Pilot Station TCE) field to the P&L Summary for OVOV and TCOV voyage types.

APS TCE uses the same calculation as the TCE field, but with the following ballast costs removed:

  • All bunker expenses incurred before arrival at the first Load Port
  • All port expenses and tolls at any port prior to the first Load Port, including Other Revenues and Expenses that are linked to those ports

To use APS TCE, CFGEnableVoyestTceDeviation must be disabled.

Enable Voyage Estimate TCE Deviation
CFGEnableVoyestTceDeviation

Enables access to Deviation TCE functionality in Voyage Estimates. (Also disables Gross TCE field.)

Voyage Estimate TCE Percent
CFGVoyestTcePercent

Displays a field on the Voyage Estimate form to show/enable entry of TCE as a ratio of TCE Vessel Daily Cost. (Also disables Gross TCE field.)

Enable Standards
CFGEnableStandards

Hides the Port Expense field on some forms, enables standards for expenses, and adds a Port Expenses Details form and a Port Expenses Details button on the Port Expenses Summary to open it. When detail-level port expenses are being used, the PortExp column in the Voyage Manager Itinerary behaves the same as the PortExp column in the Voyage Estimate itinerary:

  • For a port with no detail-level port expenses, you can edit its PortExp amount in the Voyage Manager Itinerary Cargo Tab. The voyage P&L shows this amount as estimated expenses for that port.
  • For a port with a single detail-level expense, that amount appears and can be edited in the voyage itinerary PortExp field. An estimated expense entered before creating the detail-level expense is no longer displayed in the voyage P&L.
  • For a port with multiple detail-level expenses, the itinerary PortExp field shows the sum of the detail-level expenses for that port and cannot be edited.
  • When CFGVoyageExpenseAllocation is set to Y, a Voyage Expense Allocation section will be added to the Voyage Estimate Profit & Loss Report, and optionally to the Voyage Profit & Loss Report.

An ECA Factor field also appears on COA, Cargo/VC In, and CP Terms Details forms. When ECAFactor is used in an ECA Recovery Charge Results/Fee expression and an ECA Factor value is entered on a contract, an ECA Recovery Charge Extra Freight Term is generated on that contract.

  • When a COA is created from a Voyage Estimate, ECA Factor is copied from CP Terms to the COA.
  • When a COA Lifting is created, ECA Factor is copied from the COA to the Cargo.
  • When a cargo is scheduled, ECA Factor is copied from the cargo to the backcreated Voyage Estimate.
Use Voyage Estimate Voyage Deviation
CFGUseVoyestVoyageDeviation

Adds a Deviation button to the Voyage Manager toolbar to launch a Deviation Estimate.

Use Previous Voyage Weather Factor
CFGUsePreviousVoyageWeatherFactor

When enabled, the previous voyage DWF % (WF % in the Voyage Manager) value is copied to new consecutive voyages and Voyage Estimates, and the global default value set by CFGDefaultWeatherFactor is applied only when no previous position is specified for a voyage or Voyage Estimate.

Show Cargo Per Unit Cost
CFGShowCargoPerUnitCost

Adds a Per Unit Cost field to the Voyage Estimate P&L. This value is also seen on the Voyage Profit & Loss Report (accessible from the Voyage Manager) where Per Unit Cost = total cost of expenses by quantity of cargo loaded.

Display Cost Per MMBTU
CFGDisplayCostPerMMBTU

If enabled, then for vessels of type L (LNG), the Estimate and Voyage P&L both display the cost per MMBTU (in addition to the usual TCE figure).

Voyage Estimate Show Cranes in Itinerary Grid
CFGVoyestShowCranesInItinGrid

When enabled, the Cargo tab in a Voyage Estimate/Voyage Fixture/Voyage will have a new column C, to indicate the use of Cranes in the specific port. This column will only be visible for bulk vessels, and its value can be editable from the Cargo tab in the Itinerary, the CP Terms Details form, or the Itinerary Details form of that port.

Distances Avoid Rivers
CFGDistancesAvoidRivers

When disabled, calculates distances using river routes. This is equivalent to clearing the Avoid rivers if possible check box in Veslink Distances settings.

Auto Calc Port Expenses
CFGAutoCalcPortExpenses

On Voyage Estimates, automatically enters port expenses for ports with previously saved expenses. The estimated amount excludes rebillable and recoverable items from historical port expense invoices.

Default Auto Lift Quantity
CFGDefaultAutoLiftQuantity

On Voyage Estimates, auto-inserts the Max Lift Qty basis DWT restrictions.

Manual Max Lift Cp Quantity
CFGManualMaxLiftCpQty

When enabled, when using Auto Calculate by Max Lift in a Voyage Estimate, the CP Qty for a cargo will never be automatically set by the maximum lift calculation; only the L/D quantities will change. Users can manually change the CP Qty, if desired.

Voyage Estimate Use Min Cp Quantity for Charterer Opt
CFGVoyestUseMinCpQtyForChartererOpt

Y = If using Auto Calculate by Max Lift Qty in a Voyage Estimate, if the option type for a cargo is a charterer's option, its minimum quantity will be used as a restriction for lift quantity.

N = The CP Qty for the cargo will instead be used for the lift restriction.

Disable Max Lift Warnings
CFGDisableMaxLiftWarnings

Enables notification when your quantity loaded exceeds the vessel's maximum lift quantity.

Default Rate Unit
CFGDefaultRateUnit

Specifies default rate unit for cargo load/discharge rates (Voyage Estimate/Voyage Fixture Note).

Default Suez XP Days
CFGDefaultSuezXPDays

Sets a default amount of XP, or Extra Port days for the Suez Canal transit.

Enable Cargo Expense Details
CFGEnableCargoExpDetails

On the Voyage Estimate Details view, adds an Exp Details tab to the Itinerary grid.

Enable Cargo Handling Trade No
CFGEnableCargoHandlingTradeNo

Note: CFGEnableMultiGrade must also be enabled.

Y = If multigrade cargoes are enabled, adds a Trade No. column to the Voyage Estimate Itinerary Cargo tab, Voyage Fixture, Voyage Manager, Cargo Itinerary/Options tab, and (when config flag CFGEnableActInvDetProrationByItin is enabled) Cargo Itinerary Allocation form. Additionally, if cargo transfers are enabled, the column is added to the Transfers tab. This is a free-text field, where users can enter identifiers for a trade associated with the given cargo lifting.

R = All the functionality of the Y setting is enabled, except that the Trade No. column is read-only.

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.

Enable Port Expense Search Autocomplete
CFGEnablePortExpSearchAutocomplete

On the Port Expense Search form, enables selectable search criteria instead of free-text searching.

Multi Currency Port Expenses
CFGMultiCurrencyPortExpenses

Enables support for multicurrency estimated port expenses.

Show Rate Unit in Main Itinerary
CFGShowRateUnitInMainItin

Displays the Rate Unit (RU) column in the main Itinerary grid in the Cargo tab of Voyage Estimates, for easy view/editing alongside the L/D Rate column values.

Update Canal Expense on Vessel Change
CFGUpdateCanalExpOnVesselChange

Changing the vessel on an estimate or fixture note will update any canal costs in the itinerary with the defaults as specified in the selected vessel's routing prefs. Any canals which occur between delivery and redelivery in a TCO Estimate will not be updated, and any canals which do not appear in the routing preferences of the selected vessel will likewise be unaltered.

Voyapi No Shex Factor on Turntime
CFGVoyapiNoShexFactorOnTurntime

SHEX factor will not be applied to turntime when estimating total days in a port.

Default Port Expense to Provisional
CFGDefaultPortExpToProvisional
  • Selects the Use estimate cost in P&L check box by default for all newly created voyages.
  • Estimated port expenses in the Voyage Manager will be Provisional by default.
Enable Default Ending Rob Constants
CFGEnableDefaultEndingRobConstants
No Default Port Terms
CFGNoDefaultPortTerms

The Voyage Estimate/Voyage Fixture will not default the laytime terms at ports to SHINC - for L/D ports, having no terms will cause a validation error which will prevent the user from fixing the estimate with such errors and/or prevent the user from saving a fixture with such errors.

Voyage Estimate Show Cargo Volume
CFGVoyestShowCargoVolume

Enables the Cargo Volume field on the Port/Date Group tab. This field displays the change in cargo ROB for all cargo handling lines at both load and discharge ports.

Show Counterparty in Itinerary
CFGShowCounterpartyInItin

Enables the Charterer field on the Cargo and Port/Date tabs. This field displays the charterer for the Cargo associated with that load or discharge line.

Enable LNG Port Fuel Consumption Mode
CFGEnableLNGPortFuelConsMode

For voyages and estimates with Vessel Type L, enables you to select how LNG will be consumed for the purposes of estimating in-port bunker consumption for LNG carriers:

  • In the Port/Date Group tab of the voyage itinerary, the Fuel Cons Mode column is renamed to Sea Mode.
  • A new column, Port Mode, is added. This column represents the fuel consumption mode while in the port.
  • Dual Fuel is not an available choice for Port Mode.
  • The Port Mode drop-down menu includes an additional option, Per Table. This indicates that the pre-existing behavior for in-port fuel consumption is to be used, where all fuel types in the In Port Consumption table on the Vessel form are to be consumed in the quantities indicated in the table.
  • Port Mode is defaulted and updated based on the value entered in Sea Mode, with these exceptions:
    • If Sea Mode is Dual Fuel, Port Mode defaults to LNG Only.
    • If a different value is entered in Port Mode, it will turn blue and no longer be updated by changes to the Sea Mode. To relink the fields, set Port Mode to Automatic.

Group by Func on Cargo Import
CFGGroupByFuncOnCargoImport

When importing a Cargo contract, new ports for cargo loads will be added to the itinerary immediately after the last existing load port. Likewise, new ports for discharging will be added after the last existing discharge port. This behavior will not apply if M ports are present in the itinerary.

Enable in Progress Estimating
CFGEnableInProgressEstimating

When enabled, Voyage Estimates can be created from an in-progress, ballast voyage. When fixing and scheduling, the in-progress Voyage Estimate will be merged back into the original voyage.

Auto Select in Progress Estimate
CFGAutoSelectInProgressEstimate

If enabled, when selecting a vessel on a Voyage Estimate, if that vessel's latest-dated scheduled or commenced voyage has no cargoes (and the Drydock check box on the voyage is not selected), the In Progress check box on the Estimate is automatically selected, and the voyage itinerary is copied to the Estimate. Also, the prohibition against editing in the Estimate any of the itinerary lines copied from the Voyage is relaxed to allow editing of itinerary lines with no operational data (arrival, etc.). Requires CFGEnableInProgressEstimating to be enabled in order to take effect.

Enable Voyage Estimate Charterer Itinerary
CFGEnableVoyestChartererItin

When enabled, the "Charterer" tab is visible and the default tab on Estimate details. This tab shows itinerary information and bunker lifting quantities and prices.

Trade Unit ID in Cargo Grid
CFGChaTradeUnitIdInCargoGrid

The CP Terms grid in the Voyage Estimate, Voyage Fixture, and Voyage Manager will have an ID column that displays the Cargo ID for the cargo linked to the CP Terms.

Trade Unit ID in Itinerary
CFGChaTradeUnitIdInItinerary

The Voyage Estimate/Voyage Fixture will show the trade unit ID of the cargo associated with the given itinerary line.

Counterparty Label

References to Charterer in the Voyage Estimate, Voyage Fixture, and Voyage Manager are now replaced with value of this flag, for example, Buyer.

Default Cargo Unit
CFGDefaultCargoUnit

On Voyage Estimates, sets the default cargo unit for the Quantity/Units field.

Default Freight Type
CFGDefaultFreightType

To globally configure the default Freight Type for Cargoes newly added to the Voyage Estimate, Voyage Fixture, and Voyage Manager. Enter the letter code for the default freight type: F = Freight Rate, L = Lumpsum, W= World Scale, D = Daily Rate, A = ATRS. Note that this configuration only affects Cargoes that are created via the Voyage Estimate, Voyage Fixture, and Voyage Manager. Cargoes that already exist and are imported into these forms are not affected, and records created directly from the Cargo form always use the default set in the flag.

Enable Alt Lift Unit
CFGEnableAltLiftUnit

Enables Unit of Measure Conversion for MT, BBL, and M3.

  • Group defaults can be overridden at an individual grade level on the Cargo Name form or on the Voyage Estimate/Voyage Fixture/Voyage.
  • With this option, several additional columns appear on forms:

If there are a value and a unit of measure for L/D Qty, a unit of measure for Alt Unit, and nonzero values for API/SG, then the Alt Qty value is automatically calculated. An L/D Qty can also be calculated from a manually entered Alt Qty: To trigger recalculation, enter the Alt Qty and then clear the L/D Qty value. This procedure can also be used to calculate the quantities based on a manually entered API/SG.

Enable Multi Grade
CFGEnableMultiGrade

For vessels such as product tankers with the same kind of Cargo in several grades, enables Multigrade Cargoes: Changes the Cargo field to Cargo Group and adds a Cargo Grade column (for the Cargo Name within the Cargo Group) to the Itinerary/Options tab.

  • Each Cargo Name must be tied to a Cargo Group.
  • One Cargo Name must be created with the same name as the Cargo Group.

The Freight Invoice automatically adapts its format to display the Cargo Group, followed by the individual grades.

Note: The setting of this config flag determines which variable is available, and whether the No. of Grades variable is available, on the Pricing Rule form:

  • N: Cargo Type; No. of Grades variable not available
  • Y: Cargo Grade x; No. of Grades variable available

When the Cargo Grade variable is used in a Rule, its evaluation is done based on the order of Grades in the itinerary.

Enable Units
CFGEnableUnits

Enables the cargo units field to be editable on the Voyage Estimate and CP Terms Details forms.

Show Commission in Cargo Grid
CFGShowCommissionInCargoGrid

Shows the Comm% field in the Voyage Estimate Cargo grid, which shows the total commission for the Cargo. If there is only one broker, the value can be updated manually in this field. If there are multiple brokers, their commission should be updated in CP Terms Details.

Verify Matching Company
CFGVerifyMatchingCompany

Displays a validation error if any of a voyage's or Voyage Estimate's linked contracts or Bunker Requirements has a different Company set than the voyage company.

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 Company from Vessel
CFGDefaultCompanyFromVessel

When selecting a vessel on a contract, if no Company has been assigned on the contract, it will default to the Company specified on the vessel.

  • 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.
Enable Operations LOB
CFGEnableOpsLOB

If enabled, displays an LOB (Line of Business) field on the Address (Type W), Voyage Estimate, Voyage Fixture, Voyage Manager, and contract forms.

Enable Voyage Type Checkboxes

Adds Pool, Ice, Clean, and Coated check boxes to the Voyage Estimate and Voyage Fixture for reporting for bulk vessels. They are carried to the Voyage Manager, and their statuses flow between the forms.

Default Chartering Specialist
CFGDefaultCharteringSpecialist

When creating a new Voyage Estimate or Voyage Fixture, the current user will be assigned as the Chartering Specialist.

Default Company on Cargo Import
CFGDefaultCompanyOnCargoImport

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

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.

Enable Chart Manual Status Flags
CFGEnableChartManualStatusFlags

Adds additional status options to the Voyage Fixture and Voyage Estimate, and the manual management of these statuses. (A manually managed Status field is available on the Voyage Fixture, with a default status of On Subs. A voyage can be scheduled from a Voyage Fixture only if its status is Fixed.)

Enable Fixtimator Trade Area
CFGEnableFixtimatorTradeArea

On Voyage Estimates, sets the appearance of the Trade Area input box in the expanded Details view.

Use Estimate Last Fuel Cost
CFGUseEstimateLastFuelCost

Enables the option to default Voyage Estimate fuel costs to those of the last saved estimate.

Use Vessel Last Port
CFGUseVesselLastPort

On Voyage Estimates, defaults ballast port to the vessel open port.

Voyage Estimate Category Custom Type
CFGVoyestCategoryCustomType

Specifies a custom label for the Category selection list field of the Voyage Estimate and its reporting dataset. The values in the list can be configured on the Voyage Estimate Categories form, available from the Setup section of the Chartering module center.

Voyage Estimate Retain Bunker Prices
CFGVoyestRetainBunkerPrices

Changing vessels on a Voyage Estimate will map the bunker prices for the first vessel onto the new vessel where appropriate; fuels unavailable on the new vessel will not be available and hence not have prices, and fuels available on the new vessel that are absent from the first vessel will pull their prices from the last voyage prices (unless explicitly disabled with use of config flag CFGUseVesselLastFuelCost ), or the last Voyage Estimate (if CFGUseVesselLastFuelCost is disabled and CFGUseEstimateLastFuelCost is enabled). On the Estimate Vessel Matrix form, the Preserve Bunker Prices check box is selected by default, but you can change it.

Default Bunker Unit
CFGDefaultBunkerUnit

On Voyage Estimates, sets the default bunker unit.

Use Vessel Last Fuel Quantity
CFGUseVesselLastFuelQuantity

The initial bunker quantities in an estimate will be pulled from the last actual voyage when a vessel is selected.

Use Company Lob Trade Area Hierarchy
CFGUseCompanyLobTradeAreaHierarchy

Sets up a hierarchy between Company, LOB, and Trade Area on several forms.

Use Previous Voyage Weather Factor
CFGUsePreviousVoyageWeatherFactor

When enabled, the previous voyage DWF % (WF % in the Voyage Manager) value is copied to new consecutive voyages and Voyage Estimates, and the global default value set by CFGDefaultWeatherFactor is applied only when no previous position is specified for a voyage or Voyage Estimate.

Enable Open Estimate
CFGEnableOpenEstimate

Adds an Open Estimate check box to Voyage Estimate for reporting purposes. Open Estimate is available in the Report Designer Voyage Estimate table and as a selectable column in the Voyage Estimate List. An Open Estimates Only check box is added to the Estimate Search Criteria form, allowing retrieval of only Open Estimates in searches.

Enable Vessel Import from Estimate
CFGEnableVesselImportFromEstimate

Note: Additional licensing is required for Vessel Data Integration.

When enabled, if a user searches for a Vessel in a Voyage Estimate that does not already exist in the database, instead of asking the user to create a new Vessel, they will have the option to import from configured external vessel data sources.

Default TCI on Estimate Vessel Select
CFGDefaultTCIOnEstimateVesselSelect

When enabled, a TC In or Head Fixture will be automatically assigned when selecting a vessel in the Voyage Estimate. When disabled, users will have to manually select a TC In/Head Fixture in the Voyage Estimate.

Enable Voyage Estimate User Security
CFGEnableVoyestUserSecurity

Users can only save changes to Voyage Estimates they create. If a user attempts to save a Voyage Estimate created by another user, the action will be blocked, and they will be advised to make a copy of the active Voyage Estimate.

Voyage Estimate Zero Profit on Bunker Error
CFGVoyestZeroProfitOnBunkerError

Any fuel type that is used in the calculation with price zero will trigger a red warning. The profit and daily profit are set to zero to avoid misjudging the calculation.

Voyage Estimate Zero Profit on DWT Error
CFGVoyestZeroProfitOnDWTError

If the quantity of cargo on board exceeds the calculated max lift quantity for an itinerary line, an Estimate error will be raised indicating where the overloading has occurred, and the profit/daily profit for the Estimate will be set to zero. However, if the Estimate is fixed, it does not show zero P&L, and the Estimated P&L in the Voyage Manager is not affected.

Voyapi Error on Disch Greater Than Load
CFGVoyapiErrorOnDischGreaterThanLoad

A nominated discharge quantity greater than the loaded quantity will raise a validation error in the Voyage Estimate, Voyage Fixture, and Voyage Manager. Additionally, in the Voyage Estimate, this will clear the results of the P&L calculation.

Voyapi Warn If Missing Estimate Port Expense
CFGVoyapiWarnIfMissingEstPortExp

Displays a validation warning in the Voyage Estimate and Voyage Manager if a cargo handling port call exists without estimated port expenses.

Warn If Missing Cargo Bunkers
CFGWarnIfMissingCargoBunkers

If vessel is a tanker or gas carrier, displays a warning if applicable cargo bunker consumption types are not enabled in an estimate or voyage.

Voyapi Validate Cargo Laycan for Port
CFGVoyapiValidateCargoLaycanForPort

Adds validation warnings if, at the first port where a cargo is to be loaded, the vessel will arrive before the start or after the end of the cargo's laycan.

  • Additionally, on the Voyage List, voyage lines will be highlighted in yellow if the above condition exists.
Voyage ID Includes Date
CFGVoyIdIncludesDate

If enabled, the ending year digits are automatically included in the voyage ID.

Voyage Estimate Bunker Sensitivity
CFGVoyestBunkerSensitivity

Show fields on Voyage Estimate form and Summary report indicating the necessary freight rate increase required to maintain a constant TCE for a $1 increase (where $ is customer bunker currency) in price for the specified bunker type.

Enable Port Pilot Stations
CFGEnablePortPilotStations		Enables functionality around port pilot stations both in Master Data and through the estimate and voyage itineraries.
TCI Broker Comm on Estimate
CFGTciBrokerCommOnEstimate		When enabled, a broker commission amount and percent from the Time Charter contract will be displayed on the Voyage Estimate P&L when applicable.

Related content

Still need help? Visit the Veson Nautical Help Center.

Copyright © 2017-2025 Veson Nautical LLC All Rights Reserved - Privacy Notice | End User Terms of Use