Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 168 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Release 5.36

Loading...

Voyage Management System

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Knowledge Base

Find answers to your questions...

Welcome to the main source of information on the Dataloy product suite.

Bills of Lading

Maintain Offhire

Offhire Panel

When you have located an offhire, 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 offhire.

The panel contains an Overview tab for maintaining an offhire and managing bunker consumption, and an Various Cost/Revenue tab for maintaning cost and revenues for an offhire.

The drawer also contains a Comments tab.

Find Laytime Calculation

Laytime Calculation List and Filters

Open the Laytime Calculations module in the Operations section.

From the list of laytime calculations using filters

  • By using the list of laytime calculations that opens from the Laytime Calculations module, you can use the quick filters to find the laytime calculation you are looking for.

Quick Filters
  • By using one of the following sorting options:

Sorting

Edit Bills of Lading

Bill of lading drawer

All fields except Vessel and Port can be edited from the drawer.

By clicking the cargo in the bottom table a modal will open where you can edit the cargo itself, and maintain relevant figures that will appear on the B/L when you print it.

Comments tab in the drawer

You can enter comments to the B/L in the system - these will not appear on the printed version. Any comments that are added can be edited or deleted by clicking the three dots to the right of the comment.

Laytime Calculations

Calculation of periods in laytime in cargo ports

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

Delete Bills of Lading

  1. Open the Bills of Lading module in the Operations section.

  2. Open the Bill of Lading drawer.

  3. Click the more iconat top right.

  4. Click Delete.

  5. Click Confirm to delete the bill of lading.

You cannot delete a bill of lading if it has status "released". You must first change the status to "not released".

Webhook Subscriptions

Subscription to receive notifications on changes to a Dataloy object

The Webhooks module can be located from the menu under Setup.

Permissions

In order to view the Webhooks module, a user must have the Security Role Webhook Subscriber.

Attachments

Select attachments in the drop-down menu

Once the attachments is clicked in the drop-down menu this modal will appear and you can drag and drop into the grey area, or simply click the grey area to browse your computer for files to add as attachments

If there are attachments they will appear in the table of the modal

Create Bills of Lading

In the top right corner in the Bills of Lading screen, click the createicon. You will then see a modal where you need to enter the required information in order to create a Bill of Lading.

Start typing in vessel name and select from the drop down. Once the appropriate vessel is selected you may select port call from the drop down. The port call drop down will show discharge ports and voyage reference for the selected vessel. Choose the correct voyage/discharge port.

Next you need to choose Consignee and Notify party from the drop-downs. These fields are retrieved from the sub-cargo level of a cargo. Please see screenshot below from the sub-cargo modal where the two fields for consignee and notify party is highlighted in red:

When the required fields are filled in, you select the corresponding sub-cargo(s) from the table, and click create in the Bills of Lading modal.

Delete Offhire
Status
Panel Fields
Create Laytime Calculation
Find Laytime Calculation
Maintain Laytime Calculation
Create Webhook Subscription
Find Webhook Subscription
Maintain Webhook Subscription
Click the three dots in the top right corner to reveal the drop-down
Modal for adding attachments
Edit sub cargo modal is opened by clicking a sub-cargo in the cargo drawer - sub-cargo tab

Create Offhire

Create Offhire Dialog

  1. Open the Offhire module in the Operations section.

  2. Click Create Offhirein the top right corner.

  3. Fill in all required fields listed below in the Create Offhire window.

  4. Click Create.

Required fields

Field

Description

Vessel

Used to filter Voyage but not stored in offhire object

Voyage

Voyage where offhire happens

Offhire Start Date

Date the offhire period starts

Offhire End Date

Date the offhire period ends

Port

Charterer of the cargoes of the selected voyage

Reason For Offhire

Type of offhire event

Timezone Offset

The timezoneOffset field is calculated from the selected Port's timezone. The field is disabled unless the port selected is At Sea.

Create Offhire Dialog

Panel Fields

Offhire Drawer Fields

The top section of the overview tab contains key information about an offhire.

Main Details and Days

The Main Details and Days sections contain fields used to update an offhire. These fields include those used to create an offhire, as well as the following:

Field

Description

Planned

Indicates whether the offhire period was planned

Offhire Days

Length of offhire period

Percentage

Percent of offhire period included in calculation

Main Details, Days and Result Impact Sections

Result Impact

In this section, there are two checkbox that indicate whether the offhire should be deducted from the charterer, owner or opex. The Deduct from hire receivable (charterer) checkbox is only active if the offhire's voyage is a Time Charter. These field will also activate the corresponding bunker consumption table for editing.

Bunker Consumption Tables

Two tables show information about bunker consumption for the charterer and the owner/opex. Each table contains 4 rows with information about the quantity and bunker price for each bunker type (FO, LS FO, LS MGO, MGO).

Bunker Consumption Tables

If the offhire period in on a time-charter-in voyage, the second table will show the owner's bunker consumption. Otherwise it will show the opex's bunker consumption.

Adding/Editing quantity and bunker price

  1. Click on a bunker type row.

  2. Change the fields in the Edit Bunker Consumption window.

  3. Click Confirm.

Add/Edit Bunker Type Price and Quantity

Comments

The Overview tab also contains a comments section.

Delete Business Partners

  • Delete a Business Partner

    • and click in the list the business partner to delete. On the menu open the three dots and find the button "Delete". This will soft delete the business partner. It can be found again by

  • Permanently Delete a Business Partner

    • Find the deleted business partner to permanently delete. Use the icon on the top menu illustrated with the three dots. Find and click "Permanently Delete". This will permanently delete the business partner.

Register Arrivals

To register an arrival in a Port, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Arrival". A dialog will open and allow you to enter the arrival details.

Find
filtering on deleted items in the list.

Create from a port call

A bunker order can efficiently be added directly from "Booking And Operations" module (in your java client VMS) when having a port call in focus. Either based on the bunker estimates registered, or straight as a bunker order requirement.

Select the port call where you are bunkering and click the "Create new Bunker Order" button from the menu.

A dialog will show a bunker order with the details filled out from the estimates, if there are no estimates please fill in all the details of the bunker order such as Bunker Type, Min/Max quantity, assumed bunker price and supplier.

If you add estimates for several bunker types, all types will be defaulted when you create a bunker order.

NOTE: Defaults will not be set for port calls that already have bunker order tied to it.

Business Partners

Find AIS and Weather Reports

  1. Open the Vessels module in the Master Data section.

  2. Open the vessel drawer

Vessel "AIS Data and Weather Report" data can be accessed in the top tab menu.

For the tab to be enabled an AIS position has to be available.

Find Voyages

Depending on your access permissions the list of voyages might not be visible.

The "Voyages" module can be located from the menu under "Core".

From the list of voyages using filters

Having the list of voyages open in the Voyages module you can use filters to find the voyage you are looking for. You can also click My Voyages to find the voyages where the logged in user is set as responsible operator.

Delete Voyages

Voyages of status "Estimate" and "Unallocated" can be deleted. Otherwise you must change the status before you can delete.

  1. Go to PlanningMaster Fleet Plan.

  2. Click to open the voyage you want to delete.

  3. At the upper right corner of the panel, click Delete.

  4. Click Confirm to delete the voyage.

Service Orders

Register Departures

To register a departure in a Port, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Departure". A dialog will open and allow you to enter the departure details.

Register In Port Reports

To register a In Port Report, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register In Port Report". A dialog will open and allow you to enter the details.

Find Vessel Speed and Consumption Data

  1. Open the Vessels module in the Master Data section.

  2. Open the vessel drawer

Vessel "Speed and Consumption" data can be accessed in the top tab menu. Details can be maintained directly in the fields or from the table actions.

Vessel

Voyage Functions

The VMS provides powerful voyage tools for risk assessment and estimations on cargo capacity on port calls.

These tools are available from one of the following modules:

  • PlanningMaster Fleet Plan

  • PlanningScenario Fleet Plans.

  1. Click on a voyage in the list or board to open it in the drawer.

  2. At the top right, click on Functions.

Find Deleted Business Partners

From the list of business partners you can access any previously deleted entities using the using the "deleted items" toggle switch indicated below.

Schedule

The "Schedule" section in the Voyage drawer shows a timeline of port calls on a voyage. You can create, rearrange, delete and edit port calls directly from this screen.

Managing port calls

When hovering the mouse over a port call in the schedule, a toolbar in the upper right will appear.

To insert a port call before or after the port call you are editing, click the Create Newbutton and select Before or After. A window to create a new port call then opens.

To edit a port call, click the Editbutton.

To delete a port call, click the Deletebutton.

To change the order of port calls, click and drag the Movebutton to move the port call into place.

Locking voyage start date and ballast port

In the voyage drawer at the schedule section you will find a checkbox for locking the update of voyage start date and ballast port. This checkbox is not visible while the voyage has status Estimate or Unallocated.

Maintain Voyages

The details of a voyage can be edited in the CoreVoyages module.

When you have , click it and the details will show in a drawer or panel on the right hand side. Field values can be edited directly.

Change of vessel and ballast port

Vessel and ballast port can only be changed when the voyage status is "estimate" or "unallocated".

Sections

Sections are used to show the most important information about a sub-item of the voyage. Some sections have an Openbutton to open the section's item in a new drawer.

Voyages on a time charter will have a "TC contract" section, while all other voyages will have a "Performance Cargo" section instead.

Create Vessels

  1. Open the Vessels module in the Master Data section.

  2. Click Create Vesselin the top right corner.

  3. Fill in all required fields listed below in the Create Vessel window.

  4. Click Create.

Required fields:

  • Vessel Name

  • Vessel Type

Port Calls

View Vessel Reports on Port Calls

With below it is possible to keep track of incoming vessel reports. Note: if you want to keep track of incoming reports from multiple vessels or a fleet then check out this page

To view Vessel Reports, open the drawer for the given Port Call by clicking it in the list. Then click the tab "Vessel Reports" at the top of the drawer and a list with registered reports will be displayed.

To view a given report, click the wanted report in the list and a new drawer will open with further details.

Note: if you want to keep track of incoming reports from multiple vessels or a fleet then check out

Register Noon Reports

To register a Noon Report, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Noon Report". A dialog will open and allow you to enter the details.

Stem Bunker Orders

When a bunker order requirement is stemmed you should update the system with the agreed supplier, prices and quantities and status.

Register the information and click the "action button" with three dots on it, and a menu of actions shows. Click the "Stem" button and the status is transitioned to "Stemmed" if all the requirements are fulfilled.

REQUIRED DETAILS

The required details for this status are:

  1. Supplier

  2. A bunker order line with "Bunker type", "Min Quantity" and "Unit Price"

Maintain Users

When you have located a user, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.

  • By clicking the secondary actions icon additional actions may be possible.

    • Edit User Name

Speed Order

It is possible to change the instructed speed for each port call. This is a choice limited to the vessels speed and consumption combinations only depending on the leg being in ballast or laden.

  • The dropdown shows both the speed and consumption

  • Each speed will only affect the port call (leg) in question.

To add a speed for a vessel see the .

Delete Service Order

Go to the OperationsService Orders module and open a service order in the drawer.

  1. Click the more iconat top right.

  2. Click Delete.

  3. Click Confirm to delete the order.

Find Business Partners
Find Deleted Business Partners
Create Business Partners
Maintain Business Partners
Add Contact Persons
Add Bank Accounts
Delete Business Partners
Create Service Order
Maintain Service Order
Delete Service Order
Find Vessels
Create Vessels
Find Vessel Speed and Consumption Data
Find Vessel Internal Data
Find AIS and Weather Reports
AIS-subscription
View Vessel Route from Previous Port to Next Port
vessel documentation
Find Port Calls
Maintain Port Calls
Register Arrivals
Register Departures
Register Noon Reports
Register In Port Reports
View Vessel Reports on Port Calls
View Bunker Orders on Port Calls
located the voyage
this page
Noon Report
Disable User
Secondary actions
Sensitivity Analysis
Intake Calculation

Bunker Orders

The Bunker Management module allows you to register and follow a bunker order's workflow from requirement to a paid invoice. The module also enables bunker management systems and agents to make full two-way integrations. Currently two Bunker Procurement Systems (BPS) have made integrations, and have been successfully tested: Clearlynx and World Fuel Service's BunkerLine.

Bunker estimates can still be maintained in "Booking and Operations", allowing you to create detailed voyage estimates. These estimates will later be used as default values when creating the bunker requirement or order.

Advantages:

  • Enter two products (bunker requirements/order lines) on the same port, without the need to add two bunker port calls.

  • Run reports and statistics based on all the bunker orders, per port, per supplier, status, etc.

  • Get a list of future bunker requirements across the fleet.

  • Quickly search and filter on all of the bunker orders by vessel, supplier, port, etc.

  • Support for integration with bunker procurement systems, such as ClearLynx and World Fuel Services.

Create Service Order

  1. Open the Service Orders module under Operations in the menu.

  2. Click Create Service Order in the top right corner.

  3. Fill in the required fields for your order.

  4. Click in the Order Lines section to add at least one order line.

  5. Click Create when you are done adding order lines.

Maintain Port Calls

When you have located a Port Call, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can currently not be maintained directly in the fields.

At the top of the drawer you can locate an action menu with several action options:

  • Register Arrival

  • Register Departure

  • Register Noon Report

  • Register In Port Report

Find Vessel Internal Data

  1. Open the Vessels module in the Master Data section.

  2. Open the vessel drawer

Vessel "Internal Data" can be accessed in the top tab menu.

For "old" vessels that you have in the system that has minimum of one commenced voyage, the internal data should already be established. For new vessels, or vessels without commenced voyages, open the action menuin the top right and choose "Create Internal Data" as per below indicated.

Fill in the required fields

When the above 'Create Internal Data' is created, it will be possible to access the below Internal Data page.

Disable Users

  1. Find the user to disable.

  2. Open the actions menuand click Disable User. This will prevent the user account from logging in.

  3. The user can be found again by filtering on inactive users in the list.

The actions menu

Create Cargoes

Find Users

Depending on your access permissions the list of users might not be visible.

The "User Administration" module can be located from the menu under System.

  • From the list of users using filters

    • Having the list of users open in the User Administration application you can use filters to find the user you are looking for. Clicking the user in the list will open a drawer with additional information.

Create Users

  1. Open the Users module in the Setup section.

  2. Click Create New Userin the top right corner.

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

  4. Click Create.

Required fields

Vessel Users

The security role "Vessel" is designed to grant access for users onboard vessels. See .

Permissions in the Java VMS

In order to perform actions in the Java VMS a user must also belong to a Security Group.

Groups, roles and their permissions are maintained in the Manage Permissions module in the Java VMS.

Create Bunker Orders
Find Bunker Orders
Maintain Bunker Orders
Stem Bunker Orders
Register Delivery Against a Bunker Order
Cancel Bunker Order
Delete Bunker Order
Create New Cargo
Create Cargo From Template

VMS - Step by step guides

Field

Description

User Code

A short identifier used for logging in

User Name

The user's name that is displayed in the system

Password

Password used for logging in

Email

Email address for notifications

Security Roles

Restricts access to modules and the API

Create a Vessel Master user

Status

Editing Offhire Status

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

Status

Description

Draft

Offhire is being edited

Settled

Offhire is resolved

Status Selector

Create Voyages

  1. Open the Voyages module in the Core section.

  2. Click the create iconin the top right corner and select between "Voyage Charter" or "Time Charter Out"

  3. Fill in all required fields listed below in the Create Voyage window.

  4. Click Create. A default cargo will be created for a Voyage Charter, and a default TC Out will be created for Time Charter Out

Required fields:

  • Vessel

  • Load Port / Delivery Port

  • Discharge Port / Redelivery Port

By default, new voyages have Voyage Progress set to "Estimate" and Voyage Status set to "T".

Edit Daily Hire

Only applicable when the voyage does not have TCin

In order to get a complete voyage result estimation it is possible to edit the daily hire and address commission for vessels/voyages that does not have TC-in present in the system.

Create Bunker Orders

This is done in your java client of the VMS.

Change voyage status

A voyage can have the following statuses:

The fields next to the vessel can be edited if no TC-in is present

Find Port Calls

Open the Port Calls module in the Core section.

Note: Depending on your access permissions the list of port calls might be pre-filtered basis your system user security rights.

  1. As Operator of a vessel you can quickly filter the list to only show "your" port calls with the quick filter called "My Port Calls"

  2. You are also able to filter on historical port calls with the button "Show Historical Port Calls"

  3. Additional filtering is possible using the icons positioned beside the quick filters

Specialty role: Vessel User If you are a user onboard a vessel the list will be showing only port calls related to that vessel.

Create bunker order from scratch

If already situated in the "Bunker Management" application you can create a new bunker order directly there. Click the Create Bunker button in the upper right corner and fill out the vessel and port call together with the other necessary details.

If there are estimates registered in the "Booking and Operations" module these will be defaulted in the details (such as bunker type, quantities and bunker prices)

Copy Offhire

Primary Action Copying Offhire

Go to the OperationsOffhire module and open an offhire in the drawer.

  1. Click the more iconat top right.

  2. Click Copy in the dialog to copy the offhire.

How to configure voyage as a “Last TC voyage”

In the voyage drawer at the vessel section you will find a checkbox for setting "Last Voyage for Current CP". This checkbox is disabled when there is no TC In Contract registered.

Print Sea Waybills

Click the three dots in the top right corner to reveal the drop-down

In the drop-down menu, click "Print Sea Waybill" and a new window will open with a printable version of the Bill of Lading

Find Business Partners

Depending on your access permissions the list of business partners might not be visible.

Open the Business Partners module in the Master Data section.

  • From the list of business partners using filters

    • Having the list of business partners open in the Business Partners module you can use filters to find the business partner you are looking for. Clicking the business partner in the list will open a drawer with additional information.

Panel 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.

An aggregation can be the following types:

  • Averaged

  • Reversible

  • Non-reversible

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

Create a Vessel Master user

As of version Release 5.3 it is possible to introduce crew onboard to the VMS and create an efficient, "one time entry" work process in the system.

The functionality with establishing a master role involves giving them access to only their relevant port calls. In order to establish this filter for the user we need to link their credentials to their particular vessel.

Pre requisite for below is that vessel has been created, has been created with security role "Vessel" (only this security role) and .

Step 1: Access vessel master data screen and insert vessel user in the "Master User" field as indicated below. This action will link the vessel to the user so that Crew only see their relevant port calls in the VMS

Add Contact Persons

With a business partner drawer open, locate the section for Contact Persons under the Main Details tab.

Click the "Add Contact Person" + icon and fill in the given fields to add a contact person to the business partner.

Overview

Webhook Subscription Panel Tab

In the Overview tab you can view details, as well as subscribe or unsubscribe to the selected webhook subscription.

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.

Notification

Webhook Subscription Panel Tab

In the Notification tab you can view a list with the notifications sent to the selected webhook subscription endpoint.

The list is filled with the following fields:

Field

Description

Delivery Date

Date the notification was delivered

Attempts

Amount of attempts to deliver notification

Is Failed

Notification delivery status

Object Type

Name of the subscribed Dataloy object

Object Key

Key of the subscribed Dataloy object

Error Message

Message on notification delivery failure

Register Delivery Against a Bunker Order

When delivery is taken by the vessel the "Bunkered Quantity" and "Delivery Date" must be registered in the application. Fill in the required fields and click "Register Delivery" on the action menu.

Ship Role: It is possible for the the a Ship user with the vessel security role to register this information his side and upload the bunker delivery note as an attachment in the system.

REQUIRED DETAILS

Required details for "Registering Delivery" on a bunker order are:

  1. Supplier

  2. At least one bunker order line with "Bunker Type", "Bunkered Quantity" and "Unit Price"

  3. Delivery Date

Status
Panel Fields
Manage Cargo Ports

Fields

Description

Aggregation

Type of aggregation

Demurrage Rate

Rate of demurrage

Despatch Rate

Rate of despatch

Key Information
Editable fields
Manage Cargo Ports
user for the vessel
internal data tab should be enabled
Webhook Subscrition Drawer: Overview

Find Webhook Subscription

Webhook Subscriptions List and Filters

Open the Webhooks module in the Setup section.

From the list of webhook subscriptions using filters

  • By using the list of webhook subscriptions that opens from the Webhooks module, you can use filters to find the webhook subscriptions you are looking for.

  • You can also use the quick filters Subscribed and Unsubscribed to find the webhook subscriptions to which the logged in user is either subscribed or unsubscribed.

Manage Organisational data for a voyage

Information about the tab "Organisational data"

In the Organisational data tab in the voyage drawer you can edit information about: Company, Business Unit, Pool, Responsible Charterer, Responsible Operator and Responsible Accountant.

Fields available in the Organisational data tab in Voyage drawer

To edit any field in the tab, click into the field and start typing. Then select the desired option. Field will automatically save when you click outside or use tab key to exit the field.

Company and Business Unit are mandatory fields if the voyage status is NOT Estimate or Unallocated.

Offhire

The Offhire module can be located from the menu under Operations.

Print Bills of Lading

Click the three dots in the top right corner to reveal the drop-down

Click the "Print Bill of Lading" and a new window with a printable version of the Bill of Lading will open

Voyages

Voyage drawer

To open the voyage drawer, go to the CoreVoyages module.

Summary

The top of the voyage drawer "Overview" tab has four summary cards for TCE, total days, hire costs and bunker costs.

Click See More to open detailed charts for the numbers in the summary.

Result

The "result" chart is a waterfall chart for costs and revenue on the voyage. Hover the mouse over the bars to see further details behind the calculation.

Days

The "days" chart has a timeline chart for the port calls on the voyage and a table of the total days on voyage.

The port calls timeline shows the days at sea and days in port. It also shows the names of the ports above the bars. Hover the mouse over each bar to see more information.

Add Bank Accounts

With a business partner drawer open, locate the section for Bank Accounts under the Financial tab.

Click the "Add" + icon and select a bank account to add the bank account to the business partner.

Cancel Bunker Order

When a bunkering is canceled, the bunker order needs to be either canceled or deleted.

  1. Click a bunker order in the Bunker Orders module list.

  2. When the drawer opens, open the action menuin the top right.

  3. Click the Cancel button to cancel the bunker order.

Canceling a bunker order will update and recalculate the ROB figures and bunker prices on the voyage. The voyage result will be impacted.

Statement Of Facts

List Of Events

When expanding a cargo port panel, the statement of facts section can be found. This contains a list of events that include one of the following dates:

Only the dates for the events Laytime Commenced and Laytime Completed can be edited.

Add Main Engine Speed

To add a Main Engine Speed to a vessel, navigate to the section of the Vessel drawer.

In the Main Engine table, click Add Main Engine Speed and fill in the fields.

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:

Maintain Business Partners

When you have located a business partner, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.

  • By clicking the secondary actions icon additional actions may be possible.

    • Edit Business Partner Name

    • Delete

    • Restore (if deleted)

    • Permanently Delete (if deleted)

Find Vessels

Depending on your access permissions the list of Vessels might not be visible.

Open the Vessels module in the Master Data section.

From the list in Vessels module using filters

    • Having the list of Vessels open you can use filters to find the vessel you are looking for. Clicking the vessel in the list will open a drawer with additional information.

Maintain Webhook Subscription

Webhook Subscription Panel

When you have located a webhook subscription , click 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 webhook subscription.

The panel contains two tabs for maintaining a webhook subscription and viewing the notifications:

Create Offhire
Overview
Notifications

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

Status

Description

Draft

Calculation is being edited

Awaiting approval

Calculation is sent for approval

Settled

Calculation is approved and ready for using

Status selector
Speed and Consumption
Secondary actions

Create Webhook Subscription

Create Webhook Subscription Dialog

  1. Open the Webhooks module in the Setup section.

  2. Click Create Webhook Subscriptionin the top right corner.

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

  4. Click Create.

Required fields

Field

Description

User

User to receive the notifications

Object Type

Name of the subscribed Dataloy object

Event Type

Type of event to Object

Alert Script

Subscribe to events based on the result of a DLPAlertScript.

Channel Type

Channel used to send notification

Url

Endpoint to receive the subscription

Field Conditions

A webhook subscription can only have an Object Type and an Event Type or an Alert Script. The corresponding fields are disabled to match this condition.

If the Channel Type chosen is HTTP, then the URL field must also be filled in.

Create Webhook Subscription Dialog

When choosing HTTP as Channel Type, you can also choose whether to add the Password, Access Token or Request Access Token fields.

Channel Type HTTP Options

Maintain Bunker Orders

The details of a bunker order can be edited and maintained in the Bunker Management application.

When you have located the bunker order click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.

Adding a product (bunker order line)

If you want to add a product for a given order click the "+" button above the list of products. Then a dialog will show and allow you to enter the details.

Maintaining bunker order lines details

If you want to edit the details of the bunker order line (bunker type, quantity or unit price) click the bunker order line and a dialog will show allowing you to change.

Bunker Type: If estimating bunker intake, the bunker type set will default to the grade this vessel is set up with in your vessel administration screen. If you need to change this you can do that in the below screen or when you actually place/create the order.

Cargo Port Fields

Cargo Port Related Fields

When expanding a cargo port panel, a section for editing certain fields of the cargo port can be found.

Add Bunker Type

To add a Bunker Type to a vessel, navigate to the Speed and Consumption section of the Vessel drawer.

In the Bunker Types table, click Add Bunker Type and fill in the fields.

Users

Find Inactive Users

  • From the list of users using filters

    • Having the list of users open in the User Administration application you can use filters to find inactive users by toggling the Deleted Items switch.

Find Bunker Orders

Bunker orders can be located in three ways:

  • From "Booking and Operations" module

    • Find the voyage and port in "Booking and Operations" module and click the "Bunker Orders" button there. The list of all bunker orders for that port call will show.

  • From the list of bunker orders using filters

    • Having the list of bunker orders open in the Bunker Management application you can use filters to find the bunker order you are looking for.

  • From the Bunker Requirement list

    • Filter the bunker requirement list as per above to locate the bunker order. This list will show all bunker order lines across all bunker orders.

AIS-subscription

How to enable or disable AIS-subscription

You can enable or disable the subscription to AIS-positions for a vessel.

  1. Open the Vessels module in the Master Data section.

  2. Open the vessel drawer

There is an icon on the top right corner of a vessel drawer. If the icon is light grey it indicates that the vessel has no IMO-number registered. If the icon is darker grey it indicates that it is not subscribing to AIS-positions. If the icon is blue it indicates that the vessel is subscribing to AIS-positions.

Delete Bunker Order

Deleting a bunker order entirely removes the order and all its history. This option is suitable when a bunker order is cancelled, or the entire port call or voyage is cancelled.

Click the delete button from the action menu. If the bunker order is not cancelled prior to this...then the delete button will not be active in the menu.

Precautions:

  1. Any assembled bunker invoices in Accounts Payable have to be "Un-Assembled".

  2. Any posted bunker invoices in Accounts Payable have to be "Reversed"

  3. Only "Cancelled" bunker orders can be deleted.

Change User Passwords

the user to change password. Locate the password input field and fill in the new password.

When all the verifications are met, press enter or click outside of the input field to submit, the password will be changed if no notifications are displaying otherwise.

Create Users
Maintain Users
Change User Passwords
Find Users
Disable Users
Find

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:

Maintain Service Order

Changes to a service order are done from the drawer that opens after creating a service order.

To maintain an already existing service order, open the OperationsService Orders module and click the order you want to change. It will now open in the drawer.

Editing an order

Order details

You can change order date, supplier and cost details under "Order Details".

The total cost of the order lines are calculated for estimate (advanced).

Order reference

  1. Click the more iconat top right.

  2. Select Edit order reference.

  3. Make changes to the reference in the window.

  4. Click Save.

Status

You can change the status of the order at all times. There are three statuses, "Estimate", "Revised", and "Final".

  1. Click the status label at the top of the drawer next to the order reference.

  2. Select desired status.

Creating order lines

Clickin the "Order Lines" section to create a new order line.

Tip: You cannot set the revised and final cost of an order line until after it has been created. Open an already created order line from the list to set these values.

Cargoes

You are able to keep in control of all your organisations inserted cargoes using the cargo module in VMS.

Find Offhire

Offhire List and Filters

Open the Offhire module in the Operations section.

From the list of Offhires using filters

  • By using the list of offhires that opens from the Offhire module, you can use the quick filters to find the offhire you are looking for.

Quickfilters

  • By using one of the following sorting options:

Sorting options. Default is created date

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

Field Conditions

Each field narrows down the next choice, e.g. choose vessel first, then voyage, then charterer. The fields are enabled accordingly.

At least one cargo port MUST be chosen.

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.

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.

Create Business Partners

  1. Open the Business Partners module in the Master Data section.

  2. Click Create Business Partnerin the top right corner.

  3. Fill in all required fields listed below in the Create Business Partner window.

  4. Click Create.

Required fields:

  • Business Partner Type

  • Business Partner Name

  • Short Name

  • Business Partner Code

Delete Offhire

Secondary Action Deleting Offhire

Go to the OperationsOffhire module and open an offhire in the drawer.

  1. Click the more iconat top right.

  2. Click Delete.

  3. Click Confirm in the dialog to delete the offhire.

Create Cargoes
Maintain Cargoes
Find Cargoes
Cargo Port Fields
Statement Of Facts
Timesheet

Field

Description

Vessel

Used to filter Voyages

Voyage

Used to filter Charterer

Charterer

Charterer of the cargoes of the selected voyage

Cargo Ports

Cargo Ports to be included in the calculations

Create Laytime Calculation Dialog

Fields

Description

From Date

Start of not to count period

To Date

End of not to count period

Add Time Not To Count Dialog

Intake Calculation

With the Intake Calculation function you can change parameters of a voyage to get an overview of quantities available for cargo at the port calls.

The intake calculation function can be opened from one of the following modules:

  • PlanningMaster Fleet Plan

  • PlanningScenario Fleet Plans

  1. Click on a voyage in the list or board to open it in the drawer.

  2. At the top right, click on Functions.

  3. Select Voyage Intake Calculation.

Voyage Header Parameters

At the top, fields for changing the stowage and bunker properties for the entire voyage are displayed.

Parameter

Description

Stowage Factor

Cubic meters of space occupied by one metric tonne of cargo

DO ROB Voyage Start

Diesel oil at voyage start

DO LS ROB Voyage Start

Low-sulphur diesel oil at voyage start

FO ROB Voyage Start

Fuel oil at voyage start

FO LS ROB Voyage Start

Low-sulphur fuel oil at voyage start

Port Calls

A table of all the port calls on this voyage is shown in this section. To change the intake reduction properties per port call, click a row to open a window where you can make adjustments.

Parameter

Description

Zone

Sets the vessel DWT that is used in the calculation.

Water Salinity

One of Saltwater/Brackish Water/Fresh Water. Affects the water density.

Water Density

Density of the water at port. Higher value increases intake.

Draft

Intake draft reduction of the vessel. Lower value increases intake.

Safety Margin

Safety margin for the draft. Default value is 20%. Lower value increases intake.

Constant Reduction

Intake constant reduction of the vessel. Lower value increases intake.

Fresh Water Reduction

Intake fresh water reduction of the vessel. Lower value increases intake.

Loadline information

The loadline information table shows data on the voyage vessel that might affect the intake. To change these values, you need to edit the vessel in the Vessels module in master data.

Chart

A mixed chart of the calculation results is generated at the bottom. Each port call has multiple graphs to show the reductions, cargo quantity and quantity available for cargo. The charts gets updated automatically when there are changes to the voyage header, port call, or vessel parameters.

Click on the legends at the top of the chart to toggle the display of a graph. Hover the mouse over the chart to inspect the values of each calculation data point.

Sensitivity Analysis

With the Sensitivity Analysis tool you can run calculations on a chosen parameter to evaluate risk.

The sensitivity analysis can be opened from one of the following modules:

  • PlanningMaster Fleet Plan

  • PlanningScenario Fleet Plans.

  1. Click on a voyage in the list or board to open it in the drawer.

  2. At the top right, click on Functions.

  3. Select Voyage Sensitivity Analysis.

Input parameters

Select a voyage parameter which is then adjusted by the numerical variance for each calculation.

Parameter

Calculated value

Freight Rate

TCE

Bunker Price / MT (DO, LS DO, FO, LS FO)

TCE

TCE

Freight Rate

Chart

Reading the chart

The chart shows the all the calculated values for the voyage. There are 15 data points, with the current voyage displayed in the middle, with negative variance on the left side, and positive variance on the right side.

Hover the mouse over the chart to inspect the values of each calculation data point.

Downloading the chart

Press the menu iconto download the chart as an image (SVG or PNG), or a text file (CSV) that can be imported to a spreadsheet software.

Manage Bunker Prices

only applicable in voyage status Estimate, Scheduled Unallocated and Scheduled Allocated

In voyage drawer - bunker tab

Click a row to edit bunker price

Modal for editing bunker price

Edit the price for each bunker type in the modal

View Bunker Orders on Port Calls

To view bunker orders on a Port Call, open the drawer for the given Port Call by clicking it in the list. When inside the drawer click the "Bunker Orders" tab, which will display registered bunker orders in a table.

By clicking a row in the bunker order table, a new drawer view will open with additional bunker order information like in Maintain Bunker Orders.

View Vessel Route from Previous Port to Next Port

In the vessel drawer on the top right side there is a small map displaying the vessels last known position. This position is retrieved from AIS-positions for vessels which are subscribing to this feature, for vessels which are not subscribing the latest position is retrieved from the latest position report entered in the system. In addition to this you can now view the route from Dataloy Distance Table from previous port to next port displayed in the same map. The route is the green line in the map.