Skip to main content
Skip table of contents

IMOS - Itinerary/Options or Pricing Tab - Cargo COA

Home > Chartering > Itinerary/Options or Pricing Tab - Cargo COA

To define pricing for a COA:

  • If your contract is simple, use the Itinerary/Options tab to define your itinerary and pricing; do not use the Pricing tab.

  • For flexibility in creating an itinerary for complex contracts, use the Pricing tab.

Itinerary/Options Tab

  • Load Options and Discharge Options grids: Each potential load and discharge port and the terms that apply to the port.

    • When you add a Port to an Options grid, the Berth defaults to Quay.

    • When you select a Port and Berth combination in the Itinerary that matches a Load or Discharge Option line, that information automatically populates. You can change the ports and/or terms on the Cargo form; manually overwritten values appear as blue text.

  • To open the Port form, for example to update berth details, right-click a Port or Port/Area row and then click Port.

Note: The suggested workflow is to update Load/Discharge options before fixing/commencing the voyage to adjust pricing.

Pricing Tab

This tab is similar to the Cargo Pricing tab.

Pricing Grid

To adjust pricing, do any of the following:

  • Add one row for each possible combination of Load Port(s)Discharge Port(s), and Cargo. Multiple load and discharge ports can be manually entered per row; the order of the ports is relevant to picking the correct row.

  • To use Advanced Pricing to create configurable rules for pricing contracts, select the Advanced check box.

  • To enable Top-off, select a type of top-off:

    • Regular: Cargo loaded at multiple ports with varied rates, offloaded at one discharge port

    • Reverse: Cargo loaded at one port, discharged at multiple ports

    Note: The Veson IMOS Platform does not support Top-off or Reverse Top-off in connection with Interservice Cargoes.

  • To enter a VAT No. and VAT % specific to a row, right-click the row and then click VAT; otherwise, the default entered above is used.

  • In the Freight Type (Frt Type) column, select Flat RateLumpsumDaily Rate, or one of the following:

    • Index Table: Uses an Index Table to price your freight based on Index values. The index table is not an available option for the freight type if configuration flag CFGEnableGeneralUnpricedComponent is enabled.

    • Scale Table: Uses a Scale (Rate) Table, defined in the Data Center; select the table in the Table column.

    • Worldscale: Uses Worldscale; WSC% is in the Amount column; the WSC Flat rate is determined per Cargo, according to its itinerary.

  • To specify CP Quantity and CP Draft by port and vessel to calculate deadfreight, click 


  • To automatically add pricing rows based on Load/Discharge Options, click 

    . Pricing rows are populated for any unique pair of Load and Discharge options that do not already exist in the Pricing grid. If only one Cargo is selected in the Pricing grid, the same Cargo automatically populates for each new line that is generated.

For more information, see How are pricing terms selected?

Brokers Grid

The Brokers grid enables you to add information about brokers and broker commissions.

Depending on the commission AmountType defaults to:

  • %, when the Amount is 25 or less
  • Lumpsum, when the Amount is greater than 25

Extra Freight Terms Grid

You can assign Extra Freight Terms to either the contract or a specific pricing row.

  1. Do one of the following:

    • For the contract, add a row to the Extra Freight Terms grid.

    • For a pricing row, in the Xfrt column, select the check box.

  2. Add a row for each term, select a Code and then enter a Rate/Lump amount.

Rate Tables

  • Freight Surcharge: To use a Freight Surcharge Table to determine the Freight Surcharge based on quantity, select Table. To edit the table, click 


  • Bunker Surcharge: To use a table to determine the Bunker Surcharge, select one of the following:

  • Demurrage: Select one of the following:

    • Flat Rate: Enter the rates to the right.

    • Scale Table: Uses a Demurrage Rate Table to determine the demurrage rates based on the deadweight of the vessel; select the table in the Table field below. To edit the table, click 


  • Laytime Hours: Select one of the following:

    • Flat Rate: Enter the Laytime Allowed amount, unit, and terms, and TT Hours.

    • Scale Table: Uses a Laytime Hours Rate Table to determine the laytime hours based on cargo BL quantity; select the table in the Table field below. To edit the table, click 


Note: Pricing tab data will copy over to newly created Planning Periods from older ones as long as changes made to the contract are saved.

Related Configuration Flags



Use Symmetrical BAF

Implement Symmetrical Bunker Adjustment Factor (BAF) on a Cargo Price Matrix (with options determined by configuration flag CFGLockBunkerSurchargeOnFix).

The Bunker Adjustment Factor can be allocated on a per cargo basis, and each freight adjustment can be based on a specific market, with an individual adjustment as required. Bunker exposure associated with a confirmed Cargo is derived from the Estimate Matrix tab and reflected in the Exposure report.

On the Cargo COA, VC In COA, Cargo, and VC In forms, the Bunker Surcharge field is replaced with Bunker Market.

Note: The setting of this config flag determines which result is available on the Pricing Rule form:

  • N: Bunker Surcharge

  • Y: BAF

Lock Bunker Surcharge on Fix

The Bunker Adjustment Factor can be used to adjust the Freight Rate based on the bunker price, rather than using a Bunker Market table on the Cargo form. On the Pricing tab, under Bunker Adjustment, select a Symbol and enter a Quantity, Price, and BAF. When the voyage is fixed, the price is frozen, based on the market curve, based on the Laycan From Date. The BAF is also used in exposure calculations before the voyage is fixed.

 Options for the Symmetrical Bunker Adjustment Factor (BAF) for the Price Matrix:

  • N = A Cargo with BAF has Extra Freight Term ZR for the Bunker Adjustment when the Cargo is fixed, which varies with the bunker market rate.

  • Y = A Cargo with BAF has Extra Freight Term BR, whose value is locked when the Cargo is fixed.

The Extra Freight Term for BAF is only created if a bunker surcharge exists at the time of fixing the cargo.

Enable COA Planning Period

Adds Planning Periods functionality to COAs, with Lift Size and Option % fields and a Planning Period grid. The Pricing information for a Planning Period can be specified in the Planning Period field on the Pricing tab. When linked liftings have the Use Pricing from COA check box enabled, the Pricing information will be inherited from the COA, based on which Planning Period is selected in the Cargo form. This feature should not be used with Cargo Booking (CFGEnableCargoBooking and related flags).

Enforce Operations Ledger Code Commissionable Property

When enabled, the Comm issionable setting of an Operations Ledger Code alone determines whether claim and freight adjustment line items are commissionable. When enabled, the commissionable setting cannot be overridden in invoices or per broker.

Default Claim Commission Invoice Setting

This flag controls the default setting for broker commissions on Claims by setting the default value of M on TC InTC OutCargoCargo COAVC In, and VC In COA broker grids. Possible values:

  • 0 (default): Claims are not commissionable.

  • 1: Claim commissions will be invoiced separately.

  • 2: Commissions will be deducted from the Claim Invoice.

Enable Berth in Price Matrix

If enabled, allows the Berth to be specified when determining Cargo and COA pricing.

Apply IC Adjustment to Xfrt

If enabled, for a model B mirrored freight contract (Cargo / VC In and Cargo / VC In COAs), an Extra Freight Term is adjusted by IC Adj % in the same way as the base freight, if the Extra Freight Term type is Rate or Lumpsum (not Percent).

Enable Shuttle Freight Invoicing

Enables the Shuttle Tanker Workflow and master data forms necessary for freight invoicing of time and bunkers for both the actual voyage and theoretical return legs, most commonly used by shuttle tankers.

Enable Cargo Itinerary Commercial ID

When enabled, the Cargo and VC In Itinerary/Options tab shows the Commercial ID of each parcel.

Enable Cargo Handling Trade No

Note: CFGEnableMultiGrade must also be enabled.

Y = If multigrade cargoes are enabled, adds a Trade No. column to the 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

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.