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 - Demurrage Time Bar Task Generation

Owned by Adaptavist ScriptRunner for Confluence Cloud
Last updated: Jan 17, 2024 by Melanie Whitelock
4 min read

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

Requires the Claims module, and configuration flag CFGEnableDemTBTasks must be enabled.

Demurrage Time Bar Tasks are automatically generated for the following voyage types:

COAS or SPOT Voyages

Trigger: Load or Discharge Completes for Each Cargo at Each Port

Load or discharge completes when an HF activity is entered or, if not, a PE activity is entered on the Port Activities form.

  • If the Counterparty is the same and there are multiple loads/discharges for it at the same port for the same Cargo, only one task is generated per Counterparty/Cargo combination.
  • If a VC In is marked as a CoLoad, one AR task is generated per VC In/Counterparty combination.
Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
LAllSupplierAR-
DAllReceiverAR-
 When configuration flag CFGUseCargoCounterpartyInTimeBarTask is enabled...

One Demurrage Time Bar Task is generated per cargo per port, except:

  • If the vessel is a tanker: One task is generated per counterparty with no separation per port or cargo.
  • If the vessel is not a tanker and the Cargo is Reversible all ports: One task is generated per cargo.
Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
LNontankerOwner from purchase (VC In) contractAP-
DNontankerOwner from purchase (VC In) contractAP-
-NontankerOwner from purchase (VC In Reversible all ports) contractAP-
-TankerOwner from purchase (VC In) contractAP-

Trigger: The Voyage Completes

The voyage completes when an HF activity is entered or, if not, a PE activity is entered on the Port Activities form, and it's the last discharge operation in the voyage.

All relevant AR tasks update with AP Claim Received selected.

Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
-AllOwnerAP-
 When configuration flag CFGUseCargoCounterpartyInTimeBarTask is enabled...

No tasks are generated.

OVOV, RELT, TCOV, or VCOV Voyages

Trigger: Load or Discharge Completes for Each Cargo at Each Port

Load or discharge completes when an HF activity is entered or, if not, a PE activity is entered on the Port Activities form.

The AP Claim Received check box is not applicable because no AP tasks are generated.

Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
LAllSupplierARDemurrage Analyst on the Vessel form
LBulkerChartererARDemurrage Analyst on the Vessel form
DAllReceiverARDemurrage Analyst on the Vessel form
DBulkerChartererARDemurrage Analyst on the Vessel form
 When configuration flag CFGUseCargoCounterpartyInTimeBarTask is enabled...

One Demurrage Time Bar Task is generated per cargo per port, except:

  • If the vessel is a tanker: One task is generated per counterparty with no separation per port or cargo.
  • If the vessel not a tanker and the Cargo is Reversible all ports: One task is generated per cargo.
Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
LNontankerCharterer from sale (Cargo) contractARDemurrage Analyst on the Vessel form
DNontankerCharterer from sale (Cargo) contractARDemurrage Analyst on the Vessel form
-NontankerCharterer from sale (Cargo Reversible all ports) contractARDemurrage Analyst on the Vessel form
-TankerCharterer from sale (Cargo) contractARDemurrage Analyst on the Vessel form

FOB Voyages

Trigger: An FOB Cargo Is Created and Saved

On the FOB Cargo:

  • If No Rebill is selected, the AR tasks are not generated.
  • Laycan From is used to calculate Time Bar and Target Dates.

If the counterparty is not internal, it is possible to buy/sell the product supplied/received to another party that you may rebill.

Port FunctionVessel TypeCounterparty

Tasks Generated

Analyst
LAllReceiverAPDemurrage Analyst on the Vessel form
LAllSupplierARDemurrage Analyst on the Vessel form
DAllSupplierAPDemurrage Analyst on the Vessel form
DAllReceiverARDemurrage Analyst on the Vessel form

Outcharter Voyages

The Demurrage Time Bar Task logic considers an OVOV or TCOV voyage to be Outcharter if the counterparty on any voyage cargo is an external company.

A cargo counterparty is considered an internal company if the Internal Address check box (not the Internal check box) is selected on the counterparty's Address Book record. If the Internal Address check box is not enabled in the Address Book, the voyages are never Outcharter and the below logic does not apply.

Voyage Type: COAS or SPOT Outcharter

Trigger: The Last Load or Discharge of the Voyage Completes

The last load or discharge of the voyage with a cargo handling line completes when an HF activity is entered or, if not, a PE activity is entered on the Port Activities form.

Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
LAllOwnerAP-
DAllOwnerAP-
-AllChartererAR-

Voyage Type: OVOV, RELT, TCOV, or VCOV Outcharter

Trigger: The Last Load or Discharge of the Voyage Completes

The last load or discharge of the voyage with a cargo handling line completes when an HF activity is entered or, if not, a PE activity is entered on the Port Activities form.

The AP Claim Received check box is not applicable because no AP tasks are generated.

Port FunctionVessel TypeCounterpartyTasks GeneratedAnalyst
-AllChartererARDemurrage Analyst on the Vessel form
 Related Configuration Flags
Name/FlagDescription
Use Cargo Counterparty in Time Bar Task
CFGUseCargoCounterpartyInTimeBarTask

When enabled, the Charterer for Cargo contracts or Owner for VC In contracts will be used as the counterparty in Demurrage Time Bar Tasks instead of the Supplier or Receiver.

Enable Demurrage TB Tasks
CFGEnableDemTBTasks

Note: This option can also be hardcoded.

Enables Demurrage Time Bar Tasks and the Demurrage Time Bar Task List, which also adds two fields to this form: Default Warning Days and Default Alert Days.

Disable Internal Demurrage TB Tasks
CFGDisableInternalDemTBTasks		When enabled, Demurrage Time Bar Tasks are not generated for counterparties with Internal selected on their Address Book entries.
Always Add Per Voyage Receivable Time Bar Task
CFGAlwaysAddPerVoyageReceivableTimeBarTask		When enabled, a single AR Demurrage Time Bar Task will be generated in OVOV, RELT, TCOV, or VCOV voyages for the Charterer for Cargo contracts. It will be generated regardless of whether a voyage is Outcharter or not.
Add Book Internal Address Text
CFGAddBookInternalAddressText		When a value is specified, a new check box is displayed in the Address Book with the label being the value of the configuration flag (e.g. Internal Address). When the value is empty, the check box is not shown.
Demurrage Timebar Tasks Completed Status List
CFGDemTimebarTasksCompletedStatusList

Defines the comma-separated list of Demurrage Time Bar Task Statuses that are considered Completed.

Possible values are:

  • W: New
  • N: No Demurrage
  • R: Under Review
  • P: In Progress
  • S: Settled
  • C: Cancelled
  • D: Dispute
  • E: Claim Received
  • T: Claim Sent
  • I: Internal
  • B: Time Bar
Enable Cargo Itinerary Supplier Receiver
CFGEnableCargoItinSupplierReceiver		On the Cargo/VC In Itinerary/Options tab and Cargo/VC In Booking form, adds a Supplier/Rcvr column where you can specify the supplier or receiver for each cargo handling. This information can be used to create supplier and receiver Laytime Calculations.
Use Cargo Time Bar Basis for Demurrage Time Bar Tasks
CFGUseCargoTimebarBasisForDemTBTasks

When enabled, Time Bar Date and Target Date on the auto-generated Demurrage Time Bar Tasks will update using the Cargo's time bar settings (based on the Task's Cargo and Counterparty) when:

  • Relevant basis dates on the voyage are updated (such as BL/Disch Date or completion of discharge).
  • The underlying FOB Cargo is saved.

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