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 - Pricing Rule

View IMOS Documentation in the Help Center.


On the Pricing Rule form, you can create, update, and delete Advanced Pricing rules and navigate between the rules in the current contract.

Rules consist of Conditions (or Groups of Conditions) and Results.

  • Each Condition consists of a Variable, an Operator, and a Value, for example, Use this Rule if X is on or before Y.
    • Groups of Conditions are evaluated together, like a part of a formula enclosed in parentheses, for example, Use this Rule if (X = Y or X = Z).
  • Each line in the Results grid consists of a Result, a Type, and a Value.

Creating Rules

To create a rule:

  1. Select the Advanced Pricing check box on the Pricing tab of the CargoVC InCargo COAVC In COA, or CP Terms Details form. The Pricing Rule form opens.
  2. Enter a Name and a Description.
  3. Under Use this rule if, add Conditions and/or Groups of Conditions. For each Condition, select the following:
    • Variable: Determines the Operators and Values available.
      • If it can be defined by a Data Center list, the Values available will come from it, and it will autocomplete. For example, for the Variable Load Port, the Port list will be the selection list for the values. Otherwise the Value field will be free text.
      • If it could refer to an item in a list, the items are numbered sequentially, and the numbers can be selected in a field next to the Variable name. For example, the second Load Port would be Load Port 2. To use any of the possible values, for example, any Load Port, leave this field blank. The field is only available when an indexable Variable is selected, that is, one that has a one-to-many relationship with a Cargo contract. For example, a Cargo contract may only have one Freight Rate, but it might have many Load Ports.
      • Other Rules in the contract appear in this list, preceded by Rule:. These can be used to efficiently have multiple Rules depend on the same set of base variables, but with variations.
      • User-Defined Fields appear in this list, preceded by UDF (Cargo).
      • Boolean variables appear in this list (those that can be True or False).
      • Variable values that come from Operations, rather than being defined on the contract, have defined backups to use until they are entered.

         Defined Backups

        Variable

        Backup

        Invoiced Qty

        Nominated Qty

        In this order:

        1. BL Qty

        2. Load Qty

        3. CP Qty

        Load BL Qty

        In this order:

        1. Load Qty

        2. CP Qty

        Load Qty

        CP Qty

        Vessel DWT

        The Vessel Type defined on the contract’s Basis Qty
        If not available, no backup

        Sail Load Port Date 1

        Laycan End (first Load Port only)

        Load BL Date 1

        Laycan End (first Load Port only)

        Start Loading 1

        Laycan Start (first Load Port only)

        End Loading 1

        Laycan End (first Load Port only)

        Vessel Type

        On a COA Cargo, the first Vessel Type on the COA, until the Cargo has its own
        If not available, no backup

    • Operator
    • Value
  4. To add, insert, or delete Conditions or Groups, do one of the following:
    • Click ... to the right of Conditions/Groups and then click Add ConditionInsert ConditionAdd GroupInsert Group, or Delete Condition.

    • Click Add Condition or Add Group under the list of Conditions.

  5. A new Condition or Group is added to the previous one; to change from and to or, click and to the left of the condition and then click or. To change back, click or and then click and.

  6. Conditions will be read in sequence. To change the sequence of Conditions or Groups, click ... to the right of Conditions/Groups and then click Move Condition Up, Move Condition DownMove Group Up, or Move Group Down.
  7. To stop processing when a rule is true, select Stop processing if true. Otherwise, the entire table will be read to find all true rules. The results from rules evaluating to true will be stored on the contract as saved values.
  8. Enter the Results.

    • Result: Determines the Types and Values available. Options are:

      ResultTypesValues
      Allowed Laytime-

      Right-click the line to open the Allowed Laytime form.

      Select a Laytime Hours Scale Table.

      If you set Allowed Laytime as Reversible, enter the Allowed Time in Days or Hours and select Laytime Terms.

      BAF
      (when configuration flag Use Symmetrical BAF is set to Y)
      Complete the BAF Type form and then click OK.Enter a number.
      Bill By-

      Select BL Qty, CP Qty, Invoice Qty, or Outturn Qty.

      Bunker Surcharge
      (when configuration flag Use Symmetrical BAF is set to N)

      Cap/Collar

      Complete the Bunker Cap/Collar Table form and then click OK.

      Scale Table

      Select a table.
      Counterparty Option ToleranceCargo Tolerance TypesEnter a number.
      Demurrage/DespatchPer Day or
      Per Hour
      Complete the Demurrage/Despatch form and then click OK.

      Extra Freight Term

      Extra Freight TermsEnter a number.
      Freight

      Flat Rate or
      Lumpsum

      Enter a number.

      Scale Table

      Complete the Scale Table form and then click OK.

      World Scale

      Complete the Worldscale form and then click OK.
      VATEnter a tax code.Enter a number.
      • To enter a custom expression instead of a number, right-click the line and then click Expression.
        Example: Result: Extra Freight Term, Type: 2L, Value: X*(Cargo.NoLoadBerths-1)
        For more examples, see Extra Freight Term Expression Examples.
      • To edit the underlying form for a result line, right-click the result and then click Edit Form Description��(for example, Edit Scale Table Values).
      • To mark a Result as Estimate Only, so that someone creating an invoice knows that this number is not final and may be negotiable, right-click the line and then click Estimate Only. A check mark appears on the menu; to clear it, click Estimate Only again. The text of the Result in the contract and throughout IMOS is dark red. If this Estimate Only value is used on the contract and is part of the Freight Invoice, the value will have to be finalized before the invoice can be saved in status Actual. Estimate Only values are still used in the Actual column of the Voyage P&L.
  9. To add or view Rules:
    • To add a Rule, right-click a Rule in the list of Rules in the navigation tree at the right, and then click Insert.
    • To add a Rule to the end of the current list of Rules, either click to create a blank rule or click to create a copy of the current Rule.
    • To view a different Rule, click  (previous) or  (next) or double-click it in the tree.
    • Rules will be read in sequence. To change the sequence, right-click a Rule in the tree and then click Move Up or Move Down.
    • To add an Otherwise row, to be read and displayed at the end of the list of rules, add a rule with Results but no Conditions.
  10. To update the contract with the Rules, click . They appear in a grid in the contract.

Updating Rules

To update Pricing Rules after they have been created, do one of the following:

  • On the Pricing tab of a contract, right-click a rule in the grid and then click Details.
  • On a Cargo Booking or VC In Booking linked to a COA, click .


 Related Configuration Flags
NameDescription
Enable Multi Grade

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.

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
Enable Cargo Option

If enabled, a new contract type, Cargo Option, is added to the Trading P&L. On the Cargo form, selecting the new Option check box adds a Status field to the form, with the options Pending, Exercised, or Expired. Options with status Pending or Executed are counted as exposure in the Trading P&L.

Note: The setting of this config flag determines whether the Cargo Is Option, Option Declaration Date, and Option Status variables are available on the Pricing Rule form:

  • N: Not available
  • Y: Available
Enable Transshipment

Enables transshipment features.

Note: The setting of this config flag determines whether the Cargo Is Transshipment variable is available on the Pricing Rule form:

  • N: Not available
  • Y: Available
Enable Cargo Booking

Enables the Cargo Booking form. Also adds a Booking No. field to nonincremental Freight Invoices; after a Counterparty is selected, you can select one booking of that Counterparty on the voyage, so that only those Cargoes are included on the invoice.

Note: The setting of this config flag determines whether the No. of Cargoes in Booking variable is available on the Pricing Rule form:

  • N: Not available
  • Y: Available

Still need help? Visit the Veson Nautical Help Center.

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