arrow-left

Only this pageAll pages
gitbookPowered by GitBook
triangle-exclamation
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...

VMS - Step by step guides

Knowledge Base

Find answers to your questions...

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

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.

Template Cargoes

Template cargoes are currently handled in Contract of Affreightment Line module.

Template Cargoeschevron-right

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 Contract of Affreightment drawer.

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

Change voyage status

A voyage can have the following statuses:

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

Comments

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

Cargo drawer

Top section of 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:

Secondary actions available in the cargo drawer

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.

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

Manage Bunker Prices

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

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

In voyage drawer - Overview tab - Vessel section

In voyage drawer - bunker tab

Click a row to edit bunker price

Modal for editing bunker price

Edit the price for each bunker type in the modal

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.

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.

Below the KPI-cards on the right han side is the See Audit Log button

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

A modal with the auditlogs

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 Cargo From Template

To efficiently create a cargo you can use a CoA Template 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.

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

hashtag
Relet a Cargo

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

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.

Create Cargoes

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

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.

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.

circle-info

Precautions:

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.

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.

Cargoes

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

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.

Create New Cargochevron-right
Create Cargo From Templatechevron-right
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.
Contract of Affreightment Line drawer
Create Cargoeschevron-right
Maintain Cargoeschevron-right
Find Cargoeschevron-right

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

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.

circle-info

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

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 sorting and filtering options available for you to narrow down what you include in the list view.

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.

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 sorting and filtering options available for you to narrow down what you include in the list view.

Laytime Calculations

Calculation of periods in laytime in cargo ports

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

Create Laytime Calculationchevron-rightFind Laytime Calculationchevron-rightMaintain Laytime Calculationchevron-right

Commodity

Bills of Lading

Open the Cargoes module in the Core section.
  • Click a cargo in the list to open it in a drawer.

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

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

    hashtag
    Delete a Relet

    1. Find the cargo 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.

    Click Confirm to delete the order.

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

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

  • Only "Cancelled" bunker orders can be deleted.

  • At the upper right corner of the panel, click Delete.
  • Click Confirm to delete the voyage.

  • this page
    Noon Report
    Available cargo statuses

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

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

    hashtag
    Transshipment

    hashtag
    Preshipment

    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.

    circle-info

    hashtag
    Change of vessel and ballast port

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

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

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

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

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

    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.

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

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

    Commission Contributors in Broker Commission drawer
    • To add contributors, click the icon to open a dialog to enter values.

    Add Commisson Contributor dialog in Broker Commission drawer

    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.

    circle-info

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

    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

    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.

    circle-exclamation

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

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

    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.

    Payment Terms

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

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

    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.

    circle-exclamation

    REQUIRED DETAILS

    The required details for this status are:

    1. Supplier

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

    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.

    Create Commissions

    • Click a cargo in the Cargoes module list.

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

    Commissions in Cargo drawer
    • 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.

    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.

    Maintain Service Order

    Changes to a service order are done from the drawer that opens after 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.

    hashtag
    Editing an order

    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

    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.

    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

    • Planning

    View Port Log on Port Calls

    The Port Log allows you to record all 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.

    hashtag
    Event Table

    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.

    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.

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

    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:

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

    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.

    hashtag
    Register Reports

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

    Transfer Cargoes

    A cargo transfer is a type of 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:

    Contracts of Affreightment

    Create Commissions

    Creation of commissions are currently handled in the module.

    Broker Commissions

    Contract of Affreightment Lines

    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.

    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.

    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

    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.

    Template Cargoes

    DOCUMENTATION COMING SOON

    Find Laytime Calculation

    Laytime Calculation List and Filters

    Open the Laytime Calculations module in the Operations section.

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

    Delete

    Find Contracts of Affreightmentchevron-right
    Create Contracts of Affreightmentchevron-right
    Maintain Contracts of Affreightmentchevron-right
    Contract of Affreightment Lineschevron-right
    Find Contract of Affreightment Lineschevron-right
    Create Contract of Affreightment Lineschevron-right
    Maintain Contract of Affreightment Lineschevron-right
    Template Cargoeschevron-right
    Find Template Cargochevron-right
    Create Template Cargochevron-right
    Maintain Template Cargochevron-right
    Cargoes
    Create Commissionschevron-right
    Create Commissionschevron-right
    Maintain Broker Commissionchevron-right
    Find Broker Commissionchevron-right
    Find Contract of Affreightment Lineschevron-right
    Create Contract of Affreightment Lineschevron-right
    Maintain Contract of Affreightment Lineschevron-right
    Template Cargoeschevron-right
    Statuschevron-right
    Panel Fieldschevron-right
    Manage Cargo Portschevron-right
    Create Template Cargochevron-right
    Maintain Template Cargochevron-right
    Find Template Cargochevron-right
    sorting and filtering

    Port Calls

    Find Port Callschevron-rightMaintain Port Callschevron-rightRegister Noon Reportschevron-rightRegister Arrivalschevron-rightRegister In Port Reportschevron-rightRegister Departureschevron-rightView Overview on Port Callschevron-rightView Service Orders on Port Callschevron-rightView Bunker Orders on Port Callschevron-rightView Vessel Reports on Port Callschevron-rightView Port Log on Port Callschevron-right

    Create Bunker Orders

    This is done in your java client of the VMS.

    Fill in the fields listed below.

  • Click Confirm to relet the cargo.

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

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

  • hashtag
    Required fields

    Field

    Description

    Vessel

    Used to filter Voyages

    Voyage

    Used to filter Charterer

    Charterer

    Charterer of the cargoes of the selected voyage

    circle-info

    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 Laytime Calculation Dialog
    hashtag
    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).

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

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

    hashtag
    Creating order lines

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

    circle-info

    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.

    creating

    CoA Number

  • Commencement Date

  • Expiry Date

  • Commodity

  • Currency

  • Business Unit

  • Company

  • Charterer Responsible

  • Freight Rate

  • Load Port

  • Discharge Port

  • Fields that are available on 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.

    Cargo Port collapsible panels
    The list of stoppages on a cargo port
    Scenario 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.

    hashtag

    Sensitivity Analysischevron-right
    Intake Calculationchevron-right
    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.

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

    events
    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
    circle-info

    hashtag
    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

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

    located the bunker order

    Settled

    Calculation is approved and ready for using

    Status selector

    Status

    Description

    Draft

    Calculation is being edited

    Awaiting approval

    Calculation is sent for approval

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

    circle-info

    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.

    circle-info

    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 Fieldschevron-right
    Statement Of Factschevron-right
    Timesheetchevron-right
  • Register Arrival

  • Register In Port Report

  • Register Departure

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

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

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

  • Click Create when you are done adding order lines.

  • Create Commission dialog in Cargo drawer

    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

    circle-info

    An aggregation can be the following types:

    • Averaged

    • Reversible

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

    Timesheet

    Time Not To Count List

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

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

    Adding a new not to count period

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

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

    3. Click Create.

    Editing a not to count period

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

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

    3. Click Save.

    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

    circle-info

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

    Attachments

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

    Select attachments in the drop-down menu

    Modal for adding attachments

    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

    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.

    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.

    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.

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

    Create Bills of Lading

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

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

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

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

    Voyages

    hashtag
    Voyage drawer

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

    hashtag

    Find Port Calls

    Open the Port Calls List module in the Core section.

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

    circle-info

    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.

    quick filters

    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.

    Service Orders

    Create Service Orderchevron-rightMaintain Service Orderchevron-rightDelete Service Orderchevron-right

    Non-reversible

    Type of aggregation

    Demurrage Rate

    Rate of demurrage

    Despatch Rate

    Rate of despatch

    Manage Cargo Portschevron-right

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

    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

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

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

    Column

    Description

    Charterer

    Name of the charterer

    Weight (MT)

    Total cargo weight in metric tons

    Volume (M³)

    Total cargo volume in cubic meters

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

    Column

    Description

    Vessel

    Name of vessel

    DWT

    Deadweight of the vessel

    Open Date

    Arrival date in the first load port

    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.

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

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

    Cargo Ports

    Cargo Ports to be included in the calculations

    Fields

    Description

    From Date

    Start of not to count period

    To Date

    End of not to count period

    Add Time Not To Count Dialog

    Date of berth

    Departed

    Date of departure from cargo port

    Laytime Commenced

    Date laytime period starts

    Laytime Completed

    Date laytime period ends

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

    View Overview on Port Calls

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

    Look here for some more information about .‌

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

    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

    circle-info

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

    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)

    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.

    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

    Deleting Cargo

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

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

    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

    Open Port

    First load port

    Previous Trade

    Trade of the previous voyage on the vessel

    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 sorting and filtering options available for you to narrow down what you include in the list view.

    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)

    Sea Passage

    Port

    Speed Order

    Arrival (editable)

    Actual Speed

    Agent

    Estimated Distance

    Berthed (editable)

    Speed Orderarrow-up-right
    Bunkers Table In Overview
    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.

    hashtag
    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

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

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

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

    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.

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

    circle-info

    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.

    circle-info

    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.

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

    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.

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

    Also see .

    FO ROB Voyage Start

    Fuel oil at voyage start

    FO LS ROB Voyage Start

    Low-sulphur fuel oil at voyage start

    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.

    Click Create when you are done.

    Create Service Order

    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.

    hashtag
    Input parameters

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

    hashtag
    Chart

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

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

    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.

    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.

    Create Bunker Orderschevron-right
    Find Bunker Orderschevron-right
    Maintain Bunker Orderschevron-right
    Stem Bunker Orderschevron-right
    Register Delivery Against a Bunker Orderchevron-right
    Cancel Bunker Orderchevron-right
    Delete Bunker Orderchevron-right

    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.

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

    Main Cargo Details

    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.

    Cargo Port Timeline section

    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:

    add, edit or delete a cargo port

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

    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:

    KPI-cards in Main Details

    Parameter

    Calculated value

    Freight Rate

    TCE

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

    TCE

    TCE

    Freight Rate

    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.

    circle-info

    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.

    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:

    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.

    Speed and Consumption section expanded