All pages
Powered by GitBook
2 of 11

Laytime Calculations

Calculation of periods in laytime in cargo ports

The Laytime Calculations module can be located from the menu under Operations.

Create Laytime CalculationFind Laytime CalculationMaintain Laytime CalculationDelete Laytime Calculation

Create Laytime Calculation

Create Laytime Calculation Dialog

  1. Open the Laytime Calculation module in the Operations section.

  2. Click Create Laytime Calculationin the top right corner.

  3. Fill in all required fields listed below in the Create New Laytime Calculation window.

  4. Click Create.

Required fields

Vessel *

Used to filter Vessels

Voyage - Counterpart

Combines the voyage reference and cargo counterpart

Responsible Charterer

Responsible charterer, default to the current user

Cargo Ports

Cargo Ports to be included in the calculations

* Only available when not creating a laytime calculation from the voyage drawer.

Field Conditions

Each field narrows down the next choice. Once a Vessel has been selected, the Voyage - Counterpart field will be enabled. With both Vessel and Voyage - Counterpart selected, the related cargo ports will appear underneath.

At least one cargo port MUST be chosen.

Vessel, voyage and counterpart selected. Cargo ports available for selection.

Find Laytime Calculation

Laytime Calculation List and Filters

Open the Laytime Calculations module in the Operations section.

There are several sorting and filtering options available for you to narrow down what you include in the list view.

Delete Laytime Calculation

From version 6.39 users with the Laytime Contributor role have the option to delete Laytime Calculations. Deleting a Laytime Calcluation will run the Voyage business logic and re calculate things that have been changed by the Laytime Calculation. • Please notice that Fixed demurrage and Fixed Dispatch that were added in the laytime to all connected ports would NOT be deleted from the ports after the laytime was removed! To delete a Laytime Calculation you must first access the laytime calculation drawer, you can go about this in 2 ways: 1. Open the Voyage drawer that the Laytime Calculation is connected to -> Click on the Related tab -> Pick the Laytime Calculation you desire to delete from the Laytime Calculations list. 2. In the main VMS menu click on Operations -> Laytime Calculations -> Either use the quick filters to find the relevant Laytime Calculation or pick it out from the list. Once you are in the Laytime Calculation drawer you will see a new button was added:

Laytime Calculation deletion button

When clicking on the button you will be prompt to confirm/cancel the deletion, if there are any ports connected to the Laytime Calculation a notice will appear about it in the deletion modal:

Confirm/Decline Laytime Calculation deletion modal

Once you confirm all Laytime Events will be removed and only the events connected to Port Calls / Cargo Ports will remain and the Business Logic for Voyage would be run to re-calculate changed to the Voyage.

Maintain Laytime Calculation

Laytime Calculation Panel

When you have located a laytime calculation, click on it and the details will show in a panel (so called "drawer") on the right hand side. The panel will also open after creating a new laytime calculation.

The panel contains an Overview tab for maintaining a laytime calculation and managing the cargo ports.

Laytime Statement can be printed from the PDF icon top-right in the Laytime Drawer.

StatusDrawer FieldsManage Cargo Ports

Status

Editing Laytime Calculation Status

In the header of a selected laytime calculation panel, the current status can be viewed. Clicking on it will activate a dropdown menu and a new status can be selected. A laytime calculation can have one of the following statuses:

Status

Description

Draft

Calculation is being edited

Awaiting approval

Calculation is sent for approval

Settled

Calculation is approved and ready for using

Status selector

Drawer Fields

Laytime Calculation Drawer Fields

The top section of the overview tab contains key information about a laytime.

The next section contains the following fields that can be edited.

Fields

Description

Aggregation

Type of aggregation

Demurrage Rate

Rate of demurrage

Despatch Rate

Rate of despatch

Currency

The currency of the laytime calculation

Fixed Demurrage

Fixed demurrage for the laytime calculation

Fixed Despatch

Fixed despatch for the laytime calculation

Responsible Charterer

The responsible charterer for the laytime calculation

An aggregation can be the following types:

  • Averaged

  • Reversible

  • Non-reversible

A laytime calculation panel also contains a section for managing cargo ports:

Manage Cargo Ports

Manage Cargo Ports

Cargo Ports Panel List

Cargo ports in the panel list are sorted ascending by the cargo port's port call sequence .

Adding a cargo port:

  1. In the cargo ports section, click the create iconin the right corner.

  2. Selected cargo port(s).

  3. Click Create. The new cargo port will appear as a new panel in the panels list

Cargo ports listed in create dialog are NOT already included in the laytime calculation.

Panel fields

Cargo Port Panel

Each panel contains a summary of the cargo port with the following fields:

  • Reason for call

  • Port

  • Terminal

  • Quantity

  • Commodity

Removing a cargo port:

  1. In the panel of the cargo port to be removed, click the delete icon.

  2. Click Remove in the dialog that appears to confirm removal.

Cargo ports that have been removed can be re-added by clicking the create icon as mentioned above.

By clicking the expand icon on a panel, the following sections can be viewed and managed:

Cargo Port FieldsStatement Of FactsTimesheet

Cargo Port Fields

Cargo Port Related Fields

When expanding a cargo port panel, a section for displaying and editing certain fields of the cargo port can be found. The number of fields visible depends on the type of port call, aggregation and more.

Field name
Description

Cargo Quantity

Shows the total cargo quantity on the cargo port

Laydays Commence

Laycan From date of Cargo (Load Port only)

Laydays Cancelling

Laycan To date of Cargo (Load Port only)

Demurrage Rate

The rate for demurrage

Despatch Rate

The rate for despatch

Free Despatch

Checkbox for Free Despatch

Loading/Discharging Rate

Loading/discharging rate on a port, depending on type of port

Rule

The rule for the selected port

Laytime Terms

Laytime terms for the selected port

Share of Laytime Used

Percentage of laytime used

Prorate

Checkbox for Prorate

Time Used

The amount of laytime used on the selected port

Time Allowed

The amount of laytime allowed for the selected port

Demurrage

The amount of demurrage for the selected port (only if Demurrage)

Despatch

The amount of despatch for the selected port (only in non-reversible)

Time Lost

The amount of time lost in the selected port (only if Demurrage)

Deducted Time

Total amount of "Time not to count" on port (only in non-reversible)

Fields of Laytime Calculation Discharge Port

Statement Of Facts

List Of Events

When expanding a cargo port panel, the statement of facts section can be found. This section contains a list of events imported from both the cargo port and the port call port log. You can control which events are shown here by going to Master Data -> Events. Here you have a list of events (More can be added with the blue + icon), here is a small example of some of the events that can be found there:

Event

Description

Arrived

Date of arrival to cargo port

Berthed

Date of berth

Departed

Date of departure from cargo port

Laytime Commenced

Date laytime period starts

Laytime Completed

Date laytime period ends

You can find more information regarding events here: Event. Please note that only events fitting the vessel type in question will appear here. More information can be found in the provided link.

As of version 6.31 Adding new events to Statement of Facts will be possible, Users will also be able to delete events. Adding an event will add it to both the Statement of Facts list and to the list of events for the port log connected to that Port Call but deleting an event will only remove it from statement of facts.

To add an event click on the blue + icon, select the event and date (both required) and click Add.

After confirming you will see the new event added to your Statement of Facts list for this port. Your selected new event should appear with the selected date and time:

To edit or delete an event simply click on the the row that contains it, Here you can edit the date or select delete in the modal that appears and confirm - Note that this will delete it from the Statement of Facts list but NOT from the port log event list in the port call drawer while editing the date will effect both locations.

Timesheet

Time Not To Count List

The cargo port panel contains a list of all periods not to be counted.

Time to count can also be viewed in the table and are calculated after each new not to count period is added. They are not editable.

Adding a new not to count period

  1. Click the create icon on top of the list.

  2. Fill in all required fields listed below in the Add Time Not to Count window.

  3. Click Create.

Fields

Description

From Date

Start of not to count period

To Date

End of not to count period

Editing a not to count period

  1. Click the edit icon on the right side of the not to count row.

  2. Change the fields in the Edit Time Not to Count window.

  3. Click Save.

Change Views of Timesheet table

Collapsed View

This is the default view of the Timesheet table. This view shows a collapsed view of the Timesheet items, in which each item has a span of laytime commenced to laytime completed. The stoppages added (the time not to counts) will be shown in their own separate rows:

Collapsed View of Timesheet

By clicking on the Expand icon on the right side, the list will show all Timesheet items occurrences.

Detailed View

This detailed view shows all the Timesheet occurrences of the Laytime Calculation. Here, each item shows the list items day-by-day:

Detailed View of Timesheet

By clicking on the the Collapse icon on the right side, the list will go back to compress all the Timesheet items into one-line time period: