Welcome to the Veson Nautical Knowledge Base. In the Help Center, you can view the same articles and contact support as needed.

IMOS - Demurrage Time Bar Task Generation

Home > Claims > Demurrage Time Bar Task Generation


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 aHF 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 aHF 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 is 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.

FOB voyage is never an Outcharter.

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 activated by the configuration flag: CFGAddBookInternalAddressText in the Address Book, the voyages are never Outcharter and the below logic does not apply.

The Voyage is not an Outcharter if the configuration flag: CFGUseCargoCounterpartyInTimeBarTask is enabled even if the internal address check box is not ticked.

Outcharter Voyage rules apply:

  • For voyages: OVOV, RELT, TCOV, or VCOV
    If the counterparty on any voyage cargo is external ("Internal Address" check box in the Address Book entry is NOT SET)
  • For voyages: SPOT or COAS
    - If the counterparty on any SALE cargo is external

For SPOT or COAS, if there is any SALE cargo with the "CoL" checkbox in the Voyage cargo grid - the voyage is not an Outcharter.

The Outcharter information is available in the Demurrage Time Bar Task List under the Outcharter column.

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 aHF 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 aHF 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

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.
Demurrage Timebar Tasks Completed Status List
CFGDemTimebarTasksCompletedStatusList
Defines the comma-separated list of demurrage time bar tasks' statuses (one-character letters) that are considered "Completed ". Possible values are: "New" (W) "No Demurrage" (N) "Under Review" (R) "In Progress" (P) "Settled" (S) "Cancelled" (C) "Dispute" (D) "Claim Received" (E) "Claim Sent" (T) "Internal" (I) "Time Bar" (B)
Enable Cargo Itinerary Supplier Receiver
CFGEnableCargoItinSupplierReceiver
When enabled, you can specify the supplier or receiver for each cargo handling in a Cargo or VC In contract.
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:

WNew

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-2023 Veson Nautical LLC All Rights Reserved - Privacy Policy Terms & Conditions Licenses