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

Release 6.2

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.

VMS - Step by step guides

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

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.

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.

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.

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

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

Create Bunker Orders

This is done in your java client of the VMS.

Maintain Contract of Affreightment Lines

When you have located a Contract of Affreightment Line, click it and the details will show in a drawer on the right hand side. Details can be maintained directly in the fields.

  • By clicking the secondary actions icon (3 dots icon) additional actions may be possible.

    • Delete

Maintain Contracts of Affreightment

When you have located a Contract of Affreightment, click it and the details will show in a drawer on the right hand side. Details can be maintained directly in the fields.

  • By clicking the secondary actions icon (icon = 3 dots) additional actions may be possible.

    • Edit Contract Number

    • Delete

Fields available in the Organisational data tab in Voyage drawer

Change Voyage Reference or Voyage Number

From the voyage drawer actions it is possible to change voyage reference or voyage number, depending on the voyage status.

When voyage status is Estimate, Unallocated or Allocated, it is possible to change Voyage Reference

When voyage status is Nominated, Operational, Operationally Closed, Invoiced or Closed, it is possible to change the voyage number.

Create Cargoes

Sub-cargoes

In the Sub-cargoes tab you may enter sub-cargoes

The table headers for the sub cargoes

By clicking the blue plus icon in the top right corner you can create sub-cargoes.

Once clicked the below modal will appear

Create Sub-Cargo

Once the required fields are filled in the create button will be activated and you may create the sub-cargo.

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.

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.

Vessel Section

Speed Laden: Showing the speed for laden port calls if all port calls have the same speed. If port calls has different speeds this field will be disabled and the text will be: Multiple. Changing this value will update speed for all laden port calls.

Speed Ballast: Showing the speed for ballast port calls if all port calls have the same speed. If port calls has different speeds this field will be disabled and the text will be: Multiple. Changing this value will update speed for all ballast port calls.

Performance Cargo Section

Days Extra In Port: Showing the average days extra in port for load and discharge port. Only enabled when days extra in port is the same for all port calls within a reason for call. When updating all port calls within a reason for call will be updated. Days extra in port can also be updated when editing a port call.

Analysis

When in a voyage drawer the analysis tab is available in the tab section. In this tab you will be presented with a graph to give you a visual view of the development of key values in the selected voyage.

The graph that is displayed represents the total days for the columns, and the TCE for the line. These values can be changed in the dropdown fields on the top left. The timeline shown will be from the preliminary snapshot is taken to the current date. If the voyage is closed, the last value will be the last time the voyage was changed instead of todays date.

Create New Cargo

  1. Open the Cargoes module in the Core section.

  2. In the top right corner, click Create.

  3. Select Create New Cargo.

  4. Fill in the required fields and any additional information about the new cargo.

  5. Click Create.

Required fields:

  • Load Port

  • Discharge Port

  • Charterer

  • Commodity

Transship and Preship Cargoes

A transshipment is the shipment of cargo to an intermediate destination, then by a different vessel to another destination. It is a type of created from a cargo booking from a particular discharge port at the end of an original booking.

A preshipment is another type of relet created from a cargo booking. It is the shipment of cargo from a location to that cargo's load port in an existing cargo booking. This includes the transfer to the vessel transporting from the load port.

Transshipments and preshipments are listed at the bottom of the cargo drawer under "Relets and Transshipments".

Transship or Preship a Cargo

  1. Open the Cargoes module in the Core section.

  2. Click a cargo in the list to open it in a drawer.

  3. At the top right in the cargo drawer, click Moreand select Transship or Preship.

  4. Fill in the fields listed below.

  5. Click Confirm to relet the cargo.

Transshipment

Preshipment

Find Cargoes

The webVMS contains all cargoes created in your system. To access this list you should navigate in the menu to the "Cargoes" link. This will open up your list of cargos.

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

Create Cargo From Template

To efficiently create a cargo you can use a or a Budget Template.

CoA Templates are the template cargoes that are maintained in the CoA module.

Budget Templates are cargoes that come from the budget.

  1. Open the Cargoes module in the Core section.

  2. In the top right corner, click Create .

  3. Select Create Cargo From CoA Template or Create Cargo From Budget Template.

  4. Select the cargo template you wish to use from the list.

  5. Click Create.

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 .

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.

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.

Manage Bunker Prices

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

Bunker prices can be changed from the Overview /Bunker tabs.

Click a row to edit bunker price

Edit the price for each bunker type in the modal

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)

Find Contract of Affreightment Lines

Depending on your access permissions the table of Contract of Affreightment Lines might not be visible.

The list of Contract of Affreightment Lines can be located from the .

  • From the table in Contract of Affreightment drawer

    • Having the drawer for Contracts of Affreightment open you can locate the table listing the Contract of Affreightment Lines. Clicking a line in the table will open a drawer with additional information.

Contract of Affreightment Lines

Find Template Cargo

Depending on your access permissions the table of Template Cargoes might not be visible.

The list of Template Cargoes can be located from the .

  • From the table in Contract of Affreightment Line drawer

    • Having the drawer for Contracts of Affreightment Line open you can locate the table listing the Template Cargoes. Clicking a line in the table will open a drawer with additional information.

Template Cargoes

DOCUMENTATION COMING SOON

Create New Cargo
Create Cargo From Template
sorting and filtering
vessel documentation
Contract of Affreightment drawer
Contract of Affreightment Line drawer

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.

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.

Find Contract of Affreightment Lines
Create Contract of Affreightment Lines
Maintain Contract of Affreightment Lines
Template Cargoes
Create Template Cargo
Maintain Template Cargo
Find Template Cargo

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

Field

Description

Owner

Owner of the vessel to transship the cargo.

From Port

A discharge port in the cargo booking.

To Port

The final destination.

Field

Description

Owner

Owner of the vessel to preship the cargo.

From Port

The originating port.

To Port

A load port in the cargo booking.

relet
located the voyage
CoA Template
In voyage drawer - Overview tab - Vessel section
In voyage drawer - bunker tab
Modal for editing bunker price

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 Port Calls

When you have located a Port Call from the Port Call list, click it and the details will show in a panel (so called "drawer") on the right hand side.

Register Reports

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

  • Register Noon Report

  • Register Arrival

  • Register In Port Report

  • Register Departure

Port Call Tabs

In the Port Call drawer, you can look through the different tabs below to display all the relevant information:

Tabs In The Port Call Drawer

More detailed information in each of the tabs you can find under in the Port Calls section. Ex. "View Service Orders on Port Calls" for more information about Service Orders in each Port Call.

View Service Orders on Port Calls

To view service 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 "Service Orders" tab, which will display registered service orders in a table.

Service Orders Table

Service Orders tab is not visible for user with Vessel permission.

By clicking a row in the service orders table, a new drawer view will open with additional service order information, like in Maintain Service Order.

Create Service Order

  1. Click Create Service Order in the top right corner of the table.

  2. Fill in the required fields for your order.

  3. Click in the Order Lines section to add an order line.

  4. Click Create when you are done.

Also see Create Service Order.

Contracts of Affreightment

Port Calls

View Port Log on Port Calls

The Port Log allows you to record all events during a port call. The events are specific to a cargo and gives important information in a Laytime Statement about what has occurred and when.

To access the Port Log go to the CorePort Calls module and click a port call to open the drawer to find the "Port Log" tab at the top.

Event Table

The event table lists all applicable events for the port call. Events are either on Cargo Port or Port Call (PC) level. The columns in the table are event names, port call event dates and cargo event dates (one per cargo registered on that port call). The column header for cargo shows charterer name, cargo reference number and quantity.

Registering Event Dates

To register a date for an event, click on a cell in the table and press Save in the appearing window. Dates can be cleared by opening the event date window again and pressing backspace to delete the date in the input field.

Create Contract of Affreightment Lines

To create a new Contract of Affreightment Line, navigate to the Contract of Affreightment drawer and click the create button.

A new window will open which you need to fill in as applicable.

Mandatory details:

  • Termination Date

  • Total Quantity

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.

Update Speed and Consumption

In the Speed and Consumption section in the voyage drawer you can update the various fields for consumption for a voyage. This section can be found in the Overview-tab in the voyage drawer.

In order to expand the section to see and edit the fields, click expandon the far right of the top right summary cards.

Once the expand icon is clicked the fields will be displayed like this example:

Speed and Consumption section expanded

Note that if the field for Speed Laden or Speed Ballast is changed in the vessel section it will also affect the corresponding field in this section as well, and vice versa.

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.

Maintain Cargoes

To maintain the cargo click the cargo in the list. The selected cargo will be opened in a cargo drawer where you can edit fields, copy cargo, create a pdf from the booking and so forth. Click the cargo drawer page here to see more details.

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.

Deleting Cargo

When deleting a cargo you will be presented different options based on the cargo you are deleting

📖 Some background

Cargoes are loaded and discharged in cargo ports and these cargo ports are linked to the port calls you find in the voyages schedule.

One port call can be linked to:

  • no cargo port - for port calls to Bunkering, Canal Passages etc.

  • one cargo port - when loading/discharging one cargo

  • more than one cargo port - when loading/discharging more than one cargo

When deleting a cargo the link between the cargo ports and port calls will define what options you will see in the delete cargo window.

📋 The options

1️⃣ When deleting a cargo which has cargo ports linked to a port calls which are linked to some other cargos cargo ports you will get a simple confirmation message before cargo is deleted as per below

The same confirmation message will always be shown for unallocated cargoes.

2️⃣ When deleting a cargo which has cargo ports linked to port calls which are not linked to any other cargoes cargo port you will get option to also delete the linked port calls. This makes it easier to keep your schedule clean and correct.

The Timeline shows the voyages schedule on the right side and the cargo ports of the cargo you are about to delete on the left side.

When ticking the checkbox the port calls marked in red will also be deleted from the schedule.

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.

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.

Create Commissions

  • Click a cargo in the Cargoes module list.

  • When the drawer opens, find the "Commissions" tab and open it.

  • Click the icon to open a dialog to enter values, where "Broker" is mandatory.

To edit the details after creation, click the line in the table and the same dialog will open.

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.

Maintain Bunker Orders

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

When you have 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.

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.

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

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

Find Contracts of Affreightment
Create Contracts of Affreightment
Maintain Contracts of Affreightment
Contract of Affreightment Lines
Find Contract of Affreightment Lines
Create Contract of Affreightment Lines
Maintain Contract of Affreightment Lines
Template Cargoes
Find Template Cargo
Create Template Cargo
Maintain Template Cargo
Find Port Calls
Maintain Port Calls
Register Noon Reports
Register Arrivals
Register In Port Reports
Register Departures
View Overview on Port Calls
View Service Orders on Port Calls
View Bunker Orders on Port Calls
View Vessel Reports on Port Calls
View Port Log on Port Calls
Status
Panel Fields
Manage Cargo Ports

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

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

located the bunker order
Commissions in Cargo drawer
Create Commission dialog in Cargo drawer
Click the three dots in the top right corner to reveal the drop-down
Modal for adding attachments

Panel Fields

Laytime Calculation Drawer Fields

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

Key information

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

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

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:

Manage Cargo Ports
Cargo Port Fields
Statement Of Facts
Timesheet

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.

View Overview on Port Calls

Overview

This tab contains all the main details for each of the port calls. Here we have the tile boxes displaying a vessel's number of days "at sea", as well as the "average speed/consumption", days "in port" and the "port cost". There are also sections for Sea Passage and Port, as well as sections for Comment and the Bunkers table. We also have a new Map component displaying a port call. By zooming out you will get the whole voyage that is linked to the port call: ‌

Overview Tab In Port Call Drawer

The Sea Passage- and the Port sections contains these fields:

Sea Passage

Port

Speed Order

Arrival (editable)

Actual Speed

Agent

Estimated Distance

Berthed (editable)

Actual Distance Sailed (editable)

Departure (editable)

Percent Extra At Sea

Waiting

Days Extra At Sea

Extra

Loading

​

Total

Port Cost

​

Currency

​

Master (editable)

Port Captain (editable)

Look here for some more information about Speed Order.‌

Arrival-, Berthed- and Departure dates are validated with comparisons to the Voyage Start- and Previous Portcall Departure dates, for correct date range. If the date you are trying to add is out of range, a warning prompt will show up, and you can choose different dates.‌

The Comment section is useful if you want to add in more additional information about a vessel or a voyage.‌

At the bottom of the Overview tab, we have the Bunkers table. It has been updated and contains now the fields "arrival", "arrival fixed", "quantity", "consumption", "departure", "departure fixed":​

Bunkers Table In Overview

Cargoes

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

Create Cargoes
Maintain Cargoes
Find Cargoes

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.

Bills of Lading

Comments

In the comments tab there is a list of previous comments made, and at the bottom you can add new comments.

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

Various Cost/Revenue

In the various Cost/Revenue Tab there will be two tables. One table for various cost and one for various revenue.

To add a Various Cost click the blue plus icon in the top right corner. Once clicked the below modal will appear.

Once the required fields are filled in the create button will be activated and you can create the Various Cost.

To add a Various Revenue click the blue icon in the top right corner. Once clicked the below modal will appear:

Once the required fields are filled in the create button will be activated and you can create the Various Revenue.

To delete either a Various Cost or a Various Revenue select the item from the table by clicking the checkbox on the far left side.

Once one or more items are selected you can click the trashcan to delete the selected item(s).

Cargo drawer

When you open the cargo drawer this is the top section of the drawer.

By clicking the various tabs you get the relevant information about the cargo. Check out the next pages for information about the different tabs.

On the left side you will see the cargo reference, status of the cargo, and if it is a spot or CoA cargo.

On the right side you have primary actions; PDF and copy. The three dots is a dropdown with secondary actions for the drawer. If you click the three dots you will be presented with the below view as a drop down:

You can allocate/unallocate of the cargo.

You can delete a cargo.

You can arrange Tranship, Preship or Transfer the cargo.

And finally you have the option to view the audit log or append attachements to the cargo.

Template Cargoes

Template cargoes are currently handled in module.

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.

Change cargo status

At the top of the drawer you can find a drop down with available statuses for a cargo, which will open by clicking the current status.

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"

Laytime Calculations

Calculation of periods in laytime in cargo ports

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

Payment Terms

In the Payment Terms tab you can enter the payment details as per above fields.

Relet Cargoes

A relet can be defined as the act of sub-chartering a cargo to other owners to transport. A relet always covers the entire voyage of a relet cargo.

Relets are listed at the bottom of the cargo drawer under "Relets and Transhipments".

Relet a Cargo

  1. Open the Cargoes module in the Core section.

  2. Click a cargo in the list to open it in a drawer.

  3. At the top right in the drawer, click Moreand select Relet.

  4. Fill in the "Owner" field and click Confirm.

A copy holding most of the same data of the cargo to be relet will be created in the system .

Delete a Relet

  1. that was relet.

  2. Find the relet listed under "Relets and Transhipments" in the cargo drawer and click to open it.

  3. At the top right in the drawer, click Moreand select Delete.

View Vessel Reports on Port Calls

With below it is possible to keep track of incoming vessel reports.

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

See Audit Log

When you are in the analysis tab and you select a snapshot from the analysis chart the See Audit Log will be activated, and you may click this button to see the audit logs from the previous snapshot to the selected snapshot. This button is not activated for the first (Preliminary snapshot) as this has no previous snapshot to compare with.

The audit log in the analysis section will show audit logs between the selected Snapshot and the previous snapshot.

Change voyage status

A voyage can have the following statuses:

Contract of Affreightment Line
Template Cargoes
Create Laytime Calculation
Find Laytime Calculation
Maintain Laytime Calculation
Find the cargo
this page
Noon Report
Top section of cargo drawer
Secondary actions available in the cargo drawer
Available cargo statuses
Below the KPI-cards on the right han side is the See Audit Log button
A modal with the auditlogs

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.

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

Add Time Not To Count Dialog

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.

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 Contracts of Affreightment

To create a new contract, navigate to the Contract of Affreightment module under Chartering from the menu and click the Create Contract of Affreightment button in the top right corner.

When creating new contract there are some details that are mandatory.

Mandatory details:

  • Charterer

  • CoA Number

  • Commencement Date

  • Expiry Date

  • Commodity

  • Currency

  • Business Unit

  • Company

  • Charterer Responsible

  • Freight Rate

  • Load Port

  • Discharge Port

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

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.

Transfer Cargoes

A cargo transfer is a type of transshipment where a cargo transported on two voyages. The cargo is transported on the first voyage to one port and then further transported on a second voyage to its final port.

You start with a cargo with a load and discharge port which represents the first part of the cargoes journey (on the first voyage). From a system perspective, the action "transfer" creates a new cargo for the second part of the journey (on the second voyage).

The original cargo will receive cargo type "Has Transfer", and the new cargo will receive cargo type "Transfer."

The following fields are synchronised:

  • cargo quantity and measurement unit

  • commodity

  • discharge rate + terms of has transfer cargo = load rate + terms of transfer cargo

Transfer cargoes are listed at the bottom of the cargo drawer under "Relets and Transshipments".

Transferring a Cargo

  1. Open a cargo drawer.

  2. At the top right in the cargo drawer, click Moreand select Transfer.

  3. Fill in the form fields:

    1. Owner of the vessel to transship the cargo.

    2. Final discharge port of the transfer.

    3. Second vessel to transport the cargo.

    4. Second voyage to transport the cargo.

  4. Click Transfer.

The discharge port of the original cargo will be the load port of the transfer cargo.

Create Template Cargo

To create a new Template Cargo, navigate to the Contract of Affreightment Line drawer and click the create button.

When creating new template cargo there are some details that are mandatory.

Mandatory details:

  • Commodity

  • Load Port

  • Discharge Port

Create Commissions

Creation of commissions are currently handled in the Cargoes module.

Broker Commissions

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 Commissions
Create Commissions
Maintain Broker Commission
Find Broker Commission

Find Port Calls

Open the Port Calls List module in the Core section.

Using Filters

By using the list of port calls that opens on the Port Calls module, you can use the quick filters to find the port call you are looking for.

Depending on your access permissions, the list of port calls might be pre-filtered based on your system user security rights. Vessel operators can quickly filter the list to only show your port calls with the quick filter called "My Port Calls"

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

Maintain Template Cargo

When you have located a Template Cargo, click it and the details will show in a 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.

    • Delete

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.

Edit Daily Hire

Only applicable when the voyage does not have TCin

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

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

Edit sub cargo modal is opened by clicking a sub-cargo in the cargo drawer - sub-cargo tab

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.

Allocate Cargo

  1. Click a cargo in the Cargoes module list.

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

  3. Click the Allocate Cargo button to open a dialog for allocation.

Action menu

In the dialog, select Vessel and Voyage you want to allocate the cargo to. A preview of the voyage schedule will then show the cargo ports to the left and voyage port calls to the right, as in the screen capture below. The allocation will be done using the existing port calls on the voyage if they match the cargo ports. If no port calls and cargo ports match, additional port calls will be created on the voyage. These new port calls are denoted with "Adds New Port Call".

Click Allocate to allocate the cargo and create any new necessary port calls on the voyage.

Allocate Cargo dialog

Available voyages prerequisites

Only voyages with status Unallocated, Allocated, Nominated and Operational. Note: It is currently not possible to allocate to budget or scenario voyages

Service Orders

Main Details

At the top in the main details you will find the KPI-cards.

First card: Cargo quantity is the actual quantity, and booked is the booked quantity.

Second card: Freight is the total freight for the cargo, rate is the freight rate for the cargo.

Third card: Net Fio is all cargo related revenue aggregated and then deduct all aggregated cargo cost - divided by the quantity of the cargo.

Fourth card: Laycan Missed by is the number of days the ship's ETA is after the cancelling date. Arrival window missed by is the number of days the ship's ETA is after end of the Arrival Window End date.

Below the KPI-cards is the Main Cargo Details section on the left side

All fields that are enabled can be changed from this view.

Below the KPI-cards on the right side is the Cargo Port Timeline together with LayCan dates. Laytime used is the estimated laytime allowed. The date fields are validated and if the validation fails the date field that needs to be corrected is highlighted in red and there is a short message under the date field indicating what is wrong.

To add a cargo port, edit a cargo port or delete a cargo port hover one of the cargo ports in the timeline and the below view will appear:

On the left side of the tab below the Main Cargo Details is the Stowage section

On the right side, below the Cargo Port Timeline section you can enter external reference, Trade, Cargo Text and a comment:

At the bottom of this tab there will be a list of Relets and Transhipments for the cargo:

Maintain Broker Commission

When you have located a Broker Commission, click it and the details will show in a drawer on the right hand side. Details can currently not be maintained directly in the fields.

Commission Contributors

  • To add contributors, click the icon to open a dialog to enter values.

To edit the details after creation, click the line in the table and the same dialog will open. The same dialog offers the option to delete the selected contributor.

The total commission contributors must equal 100% to be able to save

Find Broker Commission

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

The "Broker Commissions" module can be located from the menu under "Chartering".

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

Create Service Order
Maintain Service Order
Delete Service Order
sorting and filtering
KPI-cards in Main Details
Main Cargo Details
Cargo Port Timeline section
add, edit or delete a cargo port
Stowage section
Commission Contributors in Broker Commission drawer
Add Commisson Contributor dialog in Broker Commission drawer

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.

Commissions

In the Commissions tab you can create new commissions by clicking the blue plus icon in the top right corner.

Once clicked the below modal will appear:

Once the required fields are filled in the create button will be activated and you can create the new Commission, which then will appear in the table in the Commissions tab.

Sensitivity Analysis
Intake Calculation

Capacity Plan

The capacity plan gives you a monthly overview if your fleet is over or under booked with cargoes. For each months and each trade, we compare the available cargoes to the capacity in your fleet which is serving that trade.

To open the Capacity Plan, go to Chartering > Cargoes and select Capacity Plan in the top bar.

Overview

You can navigate between the current month and future months at the top of the dashboard. You also filter to restrict the view to a particular set of trades.

The are three summary cards at the top displaying information on all trades selected in the filter :

  • Free capacity: Total deadweight - total weight

  • Deadweight: Total deadweight of vessels loading in the selected month

  • Weight: Total weight of cargoes with laydays commencement in the selected month.

For free capacity and weight, we distinguish between total values and fixed values. The latter takes only cargoes into account which have status "Clean Fix".

Trade panels

An expandable panel is shown for each trade, with totals for that trade. There are two lists inside the panel, one for cargoes by charterer and one for vessels.

Cargoes by charterer

In each trade panel there is a list of total cargo weight and volume grouped by charterer. Only cargoes where laydays commencement lies in the selected month are counted.

All "fixed" charterer cargo totals are listed first, while "not fixed" entries are indicated in grey.

Vessels

In each trade panel there is a list of vessels. For each voyage in the master fleetplan, the vessel that voyage is allocated to is listed if the following two criteria are met:

  1. The voyage is marked with this trade or its performance cargo belongs to the trade.

  2. The voyage has arrival date in the first load port within the selected month.

Stoppages

In the port log tab there will be an overview of stoppages registered for both cargo ports, and for the port call.

A list of all cargo ports connected to the port call will be displayed in the form of collapsible panels.

When opening a cargo port panel, a list of stoppages will be presented. The stoppages are editable if the cargo port does NOT have a laytime calculation connected.

It is possible to create new stoppages for a cargo port, by clicking the + sign in the top right corner of the cargo port panel. It is the same fields for creating and editing a stoppage.

Underneath all the cargo ports, a list of all stoppages related to the port call will be displayed. Stoppages that are related to the connected cargo ports will be marked with the commodity name as well.

Find Contracts of Affreightment

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

The "Contracts of Affreightment" module can be located from the menu under Chartering.

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

Category

Status

Not Fixed

Indication

Firm Offer

Working

On Subject

Fixed

Clean Fix

Summary

Description

Values

Free Capacity

Remaining deadweight tonnage summing all vessels and cargoes

Total: Deadweight - total weight

Fixed: Deadweight - fixed weight

Deadweight

Deadweight of vessels

Total: Sum of deadweight of vessels

Weight

Weight of cargoes

Total: Sum of weight of cargoes of any status

Fixed: Sum of weight of cargoes of fixed status

Column

Description

Charterer

Name of the charterer

Weight (MT)

Total cargo weight in metric tons

Volume (M³)

Total cargo volume in cubic meters

Column

Description

Vessel

Name of vessel

DWT

Deadweight of the vessel

Open Date

Arrival date in the first load port

Open Port

First load port

Previous Trade

Trade of the previous voyage on the vessel

sorting and filtering
Cargo Port collapsible panels
The list of stoppages on a cargo port
Fields that are available on a stoppage