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

Release 5.45

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

VMS - Step by step guides

Oracle Database Compatibility Matrix

Lists witch Oracle Database version that are compatible with witch Dataloy VMS versions

Dataloy Version

Oracle Version

Dataloy VMS all supported versions

All Oracle supported versions up to Oracle 19.

Knowledge Base

Find answers to your questions...

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

Events

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.

Delete OffhireStatusPanel Fields

The drawer also contains a Comments tab.

Maintain Reasons for Stoppage

When clicking a Reason for Stoppage in the Reasons for Stoppage list, a drawer will appear.

All fields except Reason for Stoppage status can be edited.

Reasons for Stoppage drawer

Find inactive Reasons for Stoppage

From the list of Reasons for Stoppage you can access any inactive entities using the using the "Inactive" quick filter in the top right hand corner as indicated below.

Bulk Update

An option to update fields for multiple instances in a list. Each list will show different fields that need to be configured first, otherwise an empty window will be shown.

1) Click on the Bulk Update button to select an instance. A highlighted Bulk Update button with the "x" icon indicates that you are in edit mode.

2) Select which rows you want to update by clicking on the checkbox. You can select all the instances in the page by selecting the topmost checkbox.

3) Click the Update button on the right corner to view the available fields for bulk updating.

4) Update the fields. Click Confirm to save the changes.

5) Click Bulk Update button to exit edit mode.

Invoices List

List of all invoices

This list is showing all invoices with status Assembled, ready for posting, and posted.

Quick filters and sorting in the Invoices List

All-filter includes payable and receivable. This can be changed to show only receivable or only payable.

By clicking the More-filter you can set filter for Port, Account and Currency.

Filters available in the More-section

By clicking the AZ-icon you will see the sorting options available. By default the list is sorted by created date descending.

The sorting options for the Invoices List

Invoice drawer

Example of Invoice drawer

The label chip next to the Document ID is showing the current status of the invoice. If the status is Assembled, you can change the status to:

Back to Pending (dissolve the invoice), Ready for Posting or Posted. When the status is Ready for Posting or Posted you can not change the status. If the status is set to Pending the invoice will be dissolved, and the corresponding document lines can be found in the corresponding Pending list.

If you click on a document line, you will se more information for the specific document line.

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.

Edit Document Line

The fields that can be edited for a document line

Pending Payable List

List of all document lines that are payable except hire payable

Voyage Selector displayed upon landing on the page for the first time if no voyage is selected

When you enter the page you will be prompted to select voyages you would like to see in the list. Voyages can be altered later also. When clicking the field a list of selectable voyages will be shown in a list.

Voyage selector and Reset Data button

In the top left corner you will find the voyage selector. Here you can select or deselect voyages as you work with the list. The Reset Data button will fetch fresh data from the server for the document lines in the list.

Available filters for the Pending Receivable list

Maintain Events

When clicking an event in the Events list, a drawer will appear.

All fields except Event status can be edited.

Pending Hire Payable List

List of all document lines that are Hire Payable

When landing on the page if there is no contract selected you will be prompted with the above dialog where you can select the contract. On contract can be viewed, not multiple contracts at the same time.

In the top left corner you will find the Time Charter Contract selector and the reset data button. You can change the selected TC-contract. If you click the reset data button you will get fresh data from the server for the selected TC.

Find events

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

Open the Events module in the Master Data section:

Create Events

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

  2. Click Create Eventin the top right corner.

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

Invoices

Contains invoices list, pending receivable list, pending payable list and pending hire payable list

Select the tab corresponding to the view you would like to see in the invoices module.

Invoices is showing a list of invoices of various statuses

Pending receivable is showing a list of pending document lines for receivable items

Pending payable is showing a list of pending document lines for payable items, except hire payable

Pending hire payable is showing a list of pending document lines for hire payable items

Create Reason for Stoppage

  1. Open the Reasons for Stoppage module in the Master Data section.

  2. Click Create Reason for Stoppagein the top right corner.

  3. Fill in all required fields listed below in the Create Reason for Stoppage window.

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.

Pending Receivable List

List of all document lines that are receivable

When you enter the page you will be prompted to select voyages you would like to see in the list. Voyages can be altered later also. When clicking the field a list of selectable voyages will be shown in a list.

In the top left corner you will find the voyage selector. Here you can select or deselect voyages as you work with the list. The Reset Data button will fetch fresh data from the server for the document lines in the list.

By clicking the pen icon on a document line you will get a dialog where you can edit the document line.

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 to find the laytime calculation you are looking for.

Assemble

Assemble invoice lines into an invoice

Select the document lines you want and click assemble

An assemble modal will open and some of the fields will be pre-filled. Make sure all mandatory fields (marked with *) are entered and click Confirm. The assembled invoice will open in a drawer.

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

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 to find the offhire you are looking for.

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:

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.

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.

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.

Voyages

Voyage drawer

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

Summary

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

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.

When the drawer is opened you will find the section like this:

In order to expand the section to see and edit the fields, click the icon on the far right of the section.

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

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.

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.

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.

Print Sea Waybills

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

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

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.

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.

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.

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

Overview

Webhook Subscription Panel Tab

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

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.

Add Bunker Type

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

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

Offhire

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

Status
Panel Fields
Manage Cargo Ports
Create Offhire

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

Port Calls

Find Port CallsMaintain Port CallsRegister Noon ReportsRegister ArrivalsRegister In Port ReportsRegister DeparturesView Overview on Port CallsView Service Orders on Port CallsView Bunker Orders on Port CallsView Vessel Reports on Port CallsView Port Log on Port Calls

Reasons for Stoppage

Bills of Lading

Laytime Calculations

Calculation of periods in laytime in cargo ports

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

Create Laytime CalculationFind Laytime CalculationMaintain Laytime Calculation

Webhook Subscriptions

Subscription to receive notifications on changes to a Dataloy object

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

Create Webhook SubscriptionFind Webhook SubscriptionMaintain Webhook Subscription

Permissions

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

Business Partners

Find Business PartnersFind Deleted Business PartnersCreate Business PartnersMaintain Business PartnersAdd Contact PersonsAdd Bank AccountsDelete Business Partners

Delete Business Partners

  • Delete a Business Partner

    • Find 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 filtering on deleted items in the list.

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

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:

OverviewNotifications

Change voyage status

A voyage can have the following statuses:

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.

Click Create.

Required fields:

  • Event Name

  • Event Code

  • Event Type

    • Cargo Port

    • Port Call

  • Sort Order

Click Create.

Required fields:

  • Reason for Stoppage Description

  • Reason for Stoppage Code

  • Reason for Stoppage Type

Click
Confirm
in the dialog to delete the offhire.

By using one of the following
options:
Sorting
filters
Quick Filters
sorting
Click Create. The new cargo port will appear as a new panel in the panels list

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

Panel fields

Cargo Port Panel

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

  • Reason for call

  • Port

  • Terminal

  • Quantity

  • Commodity

Removing a cargo port:

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

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

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

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

Cargo Port Fields
Statement Of Facts
Timesheet
By using one of the following sorting options:
Sorting options. Default is created date
filters
Quickfilters
  • 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.

    Click Delete.

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

    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.

    Status

    Description

    Draft

    Offhire is being edited

    Settled

    Offhire is resolved

    Status Selector
    filters
    Find
    Speed and Consumption
    Event drawer
    Time Charter Contract selector
    TC-selector and Reset Data button
    Available filters in the Pending Hire Payable
    The tabs in the invoices Page
    Voyage Selector displayed upon landing on the page for the first time if no voyage is selected
    Voyage selector and Reset Data button
    Available filters for the Pending Receivable list
    Example document line - right half of the line
    Click the three dots in the top right corner to reveal the drop-down
    Modal for adding attachments
    Speed and Consumption section
    Speed and Consumption section expanded
    Click the three dots in the top right corner to reveal the drop-down
    In voyage drawer - Overview tab - Vessel section
    In voyage drawer - bunker tab
    Modal for editing bunker price
    Webhook Subscrition Drawer: Overview

    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.

    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.

    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.

    Find Reasons for Stoppage

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

    Open the Reasons for Stoppage module in the Master Data section:

    The columns that are available in the list that is presented when opening the module:

    • Reason for Stoppage

    • Reason for Stoppage Code

    • Reason for Stoppage Type

    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

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

    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.

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

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

    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 voyage result for the columns, and the TCE for the line. 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.

    The graph displayed in the analysis tab

    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.

    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

    Maintain Voyages

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

    When you have located the voyage, 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.

    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

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

    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

    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.

    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.

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

    Add Main Engine Speed

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

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

    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

    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.

    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.

    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.

    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

    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

    Find inactive events

    From the list of events you can access any inactive entities using the using the "Inactive" quick filter in the top right hand corner as indicated below.

    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 to find the port call you are looking for.

    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.

    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 to find the webhook subscriptions you are looking for.

    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.

    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.

    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

    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.

    Users

    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:

    Vessel

    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.

    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

    Create Users
    Maintain Users
    Change User Passwords
    Find Users
    Disable Users
    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

    Type of offhire event

    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

    Create Offhire Dialog

    Reason For Offhire

    Endpoint to receive the subscription

    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

    Create Webhook Subscription Dialog
    Channel Type HTTP Options

    Url

    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.

    Port Call Filters

    Different Filter Options For A Port Call

    There is a new variety of filters to choose from on the Port Calls List, which makes it easier to find a specific port of interest. The standard for when you enter the list is set on "Future", which displays all of the port calls set in a future date. The Future filter itself is one out of six "Date" filter options to choose from:

    Using Sorting

    You can also use the sorting options to sort the port calls on the Port Calls List:

    Different Sort Options (Both Ascending And Descending)

    quick filters

    Rate of despatch

    An aggregation can be the following types:

    • Averaged

    • Reversible

    • Non-reversible

    Editable fields

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

    Fields

    Description

    Aggregation

    Type of aggregation

    Demurrage Rate

    Rate of demurrage

    Key Information

    Despatch Rate

    Manage Cargo Ports
    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.
    filters

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

  • At the top right, click on Functions.

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

    Delete
  • Restore (if deleted)

  • Permanently Delete (if deleted)

  • Secondary actions

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

  • At the top right, click on Functions.

  • Sensitivity Analysis
    Intake Calculation

    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.

    Register Noon Report
    Fill in the required fields

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

    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
    Disable User
    Secondary actions
    Status selector

    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:

    Event

    Description

    Arrived

    Date of arrival to cargo port

    Berthed

    Date of berth

    Departed

    Date of departure from cargo port

    Laytime Commenced

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

    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

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

    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.

    Comments

    The Overview tab also contains a comments section.

    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, user for the vessel has been created with security role "Vessel" (only this security role) and internal data tab should be enabled.

    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

    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.

    Click Create.

    Required fields

    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

    Vessel Users

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

    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.

    Date laytime period starts

    Laytime Completed

    Date laytime period ends

    Offhire Days

    Length of offhire period

    Percentage

    Percent of offhire period included in calculation

    Main Details, Days and Result Impact Sections
    Bunker Consumption Tables
    Add/Edit Bunker Type Price and Quantity

    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.

    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.

    Loadline information

    The loadline information table shows data on the voyage 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.

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

    Fresh Water Reduction

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

    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

    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.

    vessel

    Constant Reduction