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 - Itinerary-Options or Pricing Tab - Cargo COA

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

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.


 Related Configuration Flags
Name/FlagDescription
Enable Cargo Itinerary Commercial ID
CFGEnableCargoItinCommercialID

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

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.

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


 How are pricing terms selected?

IMOS uses the best match when selecting a pricing row, based on a scoring system:

  • If a pricing row perfectly matches an itinerary (Load Port(s), Discharge Port(s), and Cargoes match), the first such row is used and all others are ignored. The scoring in this case is not relevant.
  • If a perfect match is not found, the scoring is as follows:
    • Load Port(s)/Discharge Port(s) score is calculated as:

      • If there is more than one itinerary L or D port found in the pricing row, +1

      • If the pricing row has no L or D ports specified, +1

      • If there is a single itinerary L or D port, and it matches the first pricing row L or D port, +2

      • Otherwise (i.e., ports are specified and do not match), −10 (i.e., disqualified)

    • Cargo score is calculated as:

      • If the cargo is specified and matches, +2

      • If the cargo is not specified, +1

      • Otherwise (i.e., a cargo is specified and does not match), −10 (i.e., disqualified)

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 .


 Related Configuration Flags
Name/FlagDescription
Use Symmetrical BAF
CFGUseSymmetricalBAF

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
CFGLockBunkerSurchargeOnFix

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
CFGEnableCOAPlanningPeriod

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
CFGEnforceOpsLedgerCodeCommissionableProperty

When enabled, the Commissionable 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
CFGDefaultClaimCommissionInvoiceSetting

This flag controls the default setting for broker commissions on Claims by setting the default value of M on TC In, TC OutCargoCargo COA, VC 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
CFGEnableBerthInPriceMatrix

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

Apply IC Adjustment to Xfrt
CFGApplyICAdjustmentToXfrt

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
CFGEnableShuttleFreightInvoicing

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.

Minimum Required Schema Version: 239

Still need help? Visit the Veson Nautical Help Center.

Copyright © 2017-2023 Veson Nautical LLC All Rights Reserved - Privacy Policy Terms & Conditions Licenses