arrow-left

Only this pageAll pages
gitbookPowered by GitBook
triangle-exclamation
Couldn't generate the PDF for 409 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Release 8.21

Loading...

Voyage Management System

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Knowledge Base

Find answers to your questions...

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

VMS: Step-By-Step Guides

Vessels

Create Vesselschevron-right
Copy Vesselchevron-right
Find Vesselschevron-right
Voyages & Port Callschevron-right
Speed & Consumptionchevron-right
Load & Discharge Rateschevron-right
Internal Datachevron-right
AIS & Weather Reportschevron-right
AIS-subscriptionchevron-right
View Vessel Route from Previous Port to Next Portchevron-right

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.

Trades

Find Port Costs

hashtag
Using Filters

You can use the quick filters to find the port cost you are looking for.

The following filters are available in Port Cost History List:

  • Vessel name

  • Deadweight (DWT)

  • Reason for call

  • Currency

  • Commodity

  • Counterpart

Voyage Secondary Actions

Load & Discharge Rates

The Load and Discharge rates section is an an overview of the load and discharge rates applicable for ports and terminals. It must not be mixed with the vessels' max load and discharge rates.

  1. Open the Vessels module.

  2. Open the vessel drawer

Vessel "Load & Discharge Rates" data can be accessed in the top tab menu. Details can be maintained directly from the table actions.

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

  3. If the vessel has an IMO-number, click on the icon in the top right.

circle-info

A light grey icon indicates that the vessel has no IMO-number registered. A dark grey icon indicates that it is not subscribing to AIS-positions. A blue icon indicates that the vessel is subscribing to AIS-positions.

Create New Trades

  1. Open the Trades module in the Core menu in the upper left corner

  2. Click Create Trade in the top right corner.

  3. Fill in the required fields Trade Description, Trade Code, and select the Route(s) that the Trade is part of. The Trade Code has to be a unique code that no other Trade has.

  4. Click Create when every field is filled

Trade Details

In the Trade Details tab there are two sections. Details and Patterns.

hashtag
Details

In the details section you can see and edit the Trade's description, code, and which Routes the Trade is in. All of these fields are required, and cannot be empty. The Code field also has to be unique code that is not used by any other Trade.

hashtag
Patterns

The Patterns list contains all the Patterns for selected Trade. You can create a new pattern by clicking the in the top right corner of the list. Clicking this will open the Create Pattern modal, as seen below. Both fields in the modal are required for being able to create a Pattern. The Code field also needs a unique code, that has not been used by any other pattern in your system.

Vessel

This page reveals the essential information of the Vessel section in the Voyage Overview tab.

(Figure 1) Vessel section in Voyage Overview

hashtag
Speed & Consumption per Bunker

Speed Ballast: Displays the speed for ballast port calls when all port calls have the same speed. If port calls have different speeds, this field will be disabled and the text will read "Multiple". Changing this value will update the speed for all ballast port calls.

Speed Laden: Displays the speed for laden port calls when all port calls have the same speed. If port calls have different speeds, this field will be disabled and the text will read "Multiple". Changing this value will update the speed for all laden port calls.

The drop-down menu will contain all vessel options for the selected passage, as well as the option to 'Add New Speed'. This new speed will not impact the vessel setup and will only apply to all Ballast/Laden port calls on the chosen voyage. This also applies to the Main Engine Port Idle and Main Engine Port Working fields. For more details, please consult the documentation.

hashtag
Vessel

Changing vessel in this section will change the voyage's and the connected cargoes' company and business unit to the selected vessel's.

TC

This section is visible on TC voyages.

This small section gives you the most important details of the TC Out contract, as well as the option to change them. Click the icon to open the full TC contract drawer.

Long Time Charter Schedule

Long TC Voyages, Schedule, and the functionality.

To recognize Long TC Voyages in the system, look for two key indicators: the Voyage Type labeled as (TC) and information in the schedule section. An example of a Long TC Voyage is shown in the screenshot below:

Long TC Voyage Schedule
  1. The blue rectangle represents Port Calls that occurred before the current Voyage.

  2. "See All Port" is a link that, when clicked, opens a new browser tab displaying all Port Calls associated with the selected Voyage.

  3. "Show More" is a link that allows you to add up to 5 additional Port Calls per click on the current Voyage's schedule. These added Port Calls will remain visible throughout the system unless the voyage is reopened.

Maintain Port Costs

You can choose to use either the Actual Port Cost or Preliminary Port Cost of previous port calls to update the port cost of the selected port call.

To make use of a Preliminary Port Cost of a port call on the system, click the button to the right of the Preliminary column. To make use of an Actual Port Cost of a port call on the system , click the button to the right of the Actual column. Clicking this button will also update the currency of the port cost of the selected port call to the currency shown on the row.

Clicking any of the "Use" button will update the port call's port cost, which will be accumulated on the voyage's overall port costs.

View Service Orders of Port Costs

If one or multiple Service Orders are present on a Port Cost the rightmost corner of the row will show an expandable arrow

By clicking the arrow , all the linked Service Orders will be shown.

An expandable arrow on the rightmost side of the Service Order row is also available, and clicking this will show the Service Order Lines for the selected order.

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.

Consumption Details

This section provides the option to customize additional voyage consumption values.

Figure 1 shows the additional parameters related to consumption. Initially, these values are taken from the vessel but can be modified for each voyage.

Figure 1. Consumption Details

Values from this section will influence the voyage's consumption calculations but will not affect the vessel’s speed and consumption.

Create Vessels

  1. Open the Vessels module in the Core menu in the top left corner.

  2. Click Create Vessel in the top right corner.

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

Copy Vessel

To copy any vessel, open the Vessel drawer and click the More button in the top right to bring up the menu.

Clicking Copy Vessel will open a Copy Vessel modal where you are prompted to enter a new name for the new copy.

When you click Create, the data from the original Vessel will be copied over to the new Vessel, with a few exceptions.

Manage Load And Discharge Rates

To manage load and discharge rates on a vessel for selected ports and terminals, navigate to the section of the Vessel drawer. Use the table in the tab to edit, delete or add a new rate.

hashtag
Actions

Internal Data

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

  2. Open the Vessel drawer

Miscellaneous:

Here, you can set fields like

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

Vessel Name History

Whenever the name of a vessel is changed, the previous name is saved to the vessel name history.

To view the history, click the More () button in the top right of the vessel drawer, and select Vessel Name History. This will bring up a small modal, listing all the names the vessel has been sailing under.

hashtag
Ex-names and voyages

Find Trades

The Trades module contains a list over all Trades in your system. Here you can search for, filter and sort all your trades.

hashtag
Sorting and filtering

There are several options available for you to narrow down what you see in the list view, as well as the ability to toggle which columns are displayed (with the setup).

For sorting, look for the arrow to the right of the column headers or the blue

Maintain Trades

To maintain the trade click the trade in the list. The selected trade will be opened in a trade drawer where you can view all the voyages from a trade and the port calls and bunkers from these voyages, and edit the trade details.

Voyages

hashtag
Voyage drawer

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

hashtag

Create New Voyages

Layout:

The Voyages module contains of a large list of different types of voyages; unallocated, estimate, allocated, nominated, etc. In this list, you can filter the voyages based on several key endpoints to effectively view the required information on your screen. There is a sort icon to the far right, with different options for sorting the list as well. You can read more here: .

Below you can click to read how to create different types of voyages:

Create Time Charter Out

hashtag
Steps:

  1. Open the Voyages module from the menu on the left.

Schedule - Edit Schedule

The "Schedule" section in the Voyage drawer comprises three sub-sections: Schedule, Edit Schedule, and Routing. This part focuses on the 'Edit Schedule' tab.

hashtag
Managing Port Calls

hashtag
Edit Schedule

Schedule - Routing

The "Schedule" section in the Voyage drawer comprises three sub-sections: Schedule, Edit Schedule, and Routing. This part focuses on the 'Routing' tab.

The routing tab is inactive by default. This feature provides alternative routes that can be used for each leg, estimating the adjusted TCE based on new distance, fuel consumption, sea margin, and more.

circle-info

The alternative routes may be created manually or must be coming from a third party, such as weather-based routes, etc.

For further details, please contact our sales team.

A voyage going from Bergen to Hamburg through Newcastle is displayed in Figure 1

Profit/Loss Summary

The summary section displays all cost/revenue items, including fuel consumption and price, related to either cargo, voyage, or port call. This breakdown displays different figures for Voyage Charter and Time Charter estimates.

circle-info

As you start to invoice various items on the voyage, the exchange rates used for calculating profit loss values will be an average of the rate used in each invoice, should those currencies differ from the voyage currency. As such, the numbers on display in the Profit/Loss summary may change slightly throughout the voyage, but should be exact once the final invoice has been issued.

When the voyage drawer is open, selecting Open Full Screenexpands the panel and shows an additional section/panel summarizing the profit/loss for this voyage.​

EU ETS Cost

hashtag
How EU ETS Cost Is Calculated

When your system’s differs from the voyage currency, the EU ETS Cost is computed in two phases but applied in one formula:

  1. Base cost in default currency

Risk

This section provides the option to customize risk related values

In the risk section, located under the Profit & Loss section, you can change which TC market index the voyage should follow, what percentage of the index value it should use, and the market value of the vessel in the same currency as the voyage.

Canal Allowances

Certain voyage routes require specific canal allowances to be used. These allowances can either be applied to the entire voyage or to individual legs.

hashtag
Voyage Allowances

Canal allowance settings for the entire voyage is shown in the top right corner of the map in voyage drawer. Changing these allowances affects all sea passages on the voyage. For example, consider the following voyage going from New York > Los Angeles > New York:

The voyage is currently allowed through the Panama Canal, and the route and schedule reflects this. If Panama Canal is deselected in the allowance settings, all instances of the canal are removed from the voyage:

Various Cost/Revenue

The feature allows you to manage cost and revenue entries associated with a voyage, including those linked to and These entries can be accessed and modified from the Various Cost/Revenue tab in the voyage drawer.

You can also use the Various Grid in the full-screen view of the voyage drawer to get an overview over all connected variouses. Here, you can:

  • View all Various Cost/Revenue entries related to the voyage.

Voyage Functions

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

These tools are available from Voyages or Planning -> Fleet Plans

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

Downtimes

From the "Downtimes" tab in the voyage drawer, you can view the downtimes for the voyage. Click on an item in the list to go to the the corresponding drawer and view more information about the specific item.

Clicking the -icon on the table will bring up a modal to create a downtime.

More details about creating a downtime:

Deviation Calculation

This page provides a detailed explanation of a Voyage Function - Deviation calculation.

The deviation calculation function offers a comprehensive analysis of the difference between the current voyage and the same voyage as if it were direct — from the ballast port to the last port call.

This function is particularly useful when freight rates are low, voyages must adhere to strict schedules, or deviations are required for compliance. It helps determine whether an additional detour can generate enough extra revenue to offset the added distance, time, emissions, and fuel costs.

Figure 1 shows the Deviation Calculation window, comparing the current voyage results (in the Loaded column) with a hypothetical direct voyage (in the Direct column). The Variance column highlights the differences between the two. By clicking Open Direct Voyage, users can review the direct route’s details (Figure 2). In this example, the detour with cargo generates higher revenue, making it a more favourable option.

Create New Cargoes

Layout:

The Cargoes module is divided into the Allocated cargoes and the Unallocated cargoes. In each tab, you can filter the cargoes based on several key endpoints to effectively view the required information on your screen. There is a sort icon to the far right, with different options for sorting the list as well. You can read more here: .

Below you can click to read how to create different types of cargoes:

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.

Converting Voyage to TC Out

A voyage can be converted to a TC Out voyage if the following conditions are met.

  • The voyage is not Closed

  • The voyage is not already a TC voyage

Cargoes

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

circle-info

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

Sorting and Filtering Lists
Create Voyage Chartererchevron-right
Create Time Charter Outchevron-right
Create Voyage From Template (CoA)chevron-right
Sorting and Filtering Lists
Create Cargochevron-right
Create Cargo From CoA Templatechevron-right
Create Cargo on TC Voyageschevron-right
Create Cargo by Importing from Excelchevron-right
Create Cargo From Existing Cargochevron-right
Create New Cargoeschevron-right
Maintain Cargoeschevron-right
Find Cargoeschevron-right

Cargo Drawer Actions

Navigate to these pages to read more about the various Cargo Drawer actions:

Allocate Cargochevron-rightDelete Cargochevron-rightView Cargo Historychevron-rightRelet Cargochevron-rightRelet Internallychevron-rightConvert Cargo to Relet/Non-Reletchevron-rightTransship and Preship Cargochevron-rightTransfer Cargochevron-rightConnect Cargo to CoAchevron-rightRemove CoA from Cargochevron-right

Required fields:

  • Vessel Name

  • Vessel Type

  • Vessel Code*

*The Vessel Code field is only visible and required if you have ticked off the "Set vessel code" checkbox. If the checkbox is not ticked off, a Vessel Code will automatically be generated for you.

hashtag
Voyages & Port Calls

Voyages and Port Calls will not be copied to the new Vessel.

hashtag
Main Vessel Description

IMO Number will not be copied to the new Vessel.

hashtag
Internal Data

The internal data of the copied vessel will be given default values for some fields like company, business unit, vessel code and vessel class.

The vessel code will be set to the unique key value for the Vessel, used by the API.

Pool and Pool Earning Points will not be copied to the new Vessel.

Secondary Action Menu with Copy Vessel
Copy Vessel Modal
hashtag
Create

In the table, click Add icon and fill in the fields

hashtag
Edit

Click on a row to edit and use the modal to make changes.

hashtag
Delete

Use the checkboxes to select the rows to delete. Click Delete iconand confirm.

Create and Edit Modal

Load and Discharge Rate
Load and Discharge Rates Table
and Business Unit, Bank Account Receivable, Master Account, Classification Society, specify the
(if classification society is selected), and Pool, as well as the Pool Earning Points. In this table, you can create, edit, and delete a Pool Earning Point:

Create/edit modal for Pool Earning Point.

Vessel Internal Data tab
Company
Ice Class

Changing the vessel name will also update voyages with status
Nominated
or
Operational
. In the event the vessel has changed names after the voyage was set to
Operationally Closed
(or any later statuses), a small notice with the ex-name will be displayed in the vessel section when viewing those voyages later.
Bergen Corvus, ex-Bergen Platypus, as seen in the voyage drawer.

hashtag
Using ex-names for filtering and searching

It is possible to filter and search for a vessel by her ex-name in most of the modules of the system. Search results will return the vessel's current name, even if you searched using an ex-name.

Searching for a vessel in a selector using an ex-name.
This vessel was sailing under the name Bergen Platypus until 04.12.2025
icon above and to the right of the list. For filtering, you can use the quick filters provided above the Trades list. Which include filtering on the year, which trades and/or routes, and disabled trades.

hashtag
Trade Quick Filter

The Trade quick filter consists of two filters. The top filter filters on specific trades and the bottom one filters trades based on the selected route(s), see the first tab below. The available options in the top filter will change based on the selected route(s). Such that the top filter will only show trades that are part of the selected route, see the second tab below.

The trade options are based on the selected route
sorting and filtering
customised columns
Summary

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

Note, If the status of the Voyage is closed, it is not possible to make any updates or changes to that particular Voyage.

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

hashtag
Organisational Data

Here you may add organisational data to your voyage.

Note, The Company and Business Unit fields depend on each other. If one of the details is set, you may see linked items that correlate to the former attribute when selecting the second field. Moreover, if you proceed with an element not linked to the former attribute, the first field will be cleared.

* For example, there is Company A, which has a link to Business Unit A. When creating Voyage's organisational data, after selecting Company A and expanding the Business Unit, you will get a list of options. The list will contain all the Business Units, but Business Unit A will be marked as linked to the selected Company. Next, if linked Business Unit A is chosen, you will end up with Company A and Business unit A. Otherwise, if the selected Business Unit is not linked to the preferred Company, the Company field will get cleared, and you may observe a list of Companies related to the selected Business Unit.

On the top right corner, click the icon.
  • Select Create Time Charter Out.

  • In the modal, you can fill in the required fields and add any additional information about the new TC voyage.

  • After you have filled in, you can click Create.

  • Create Time Charterer Out modal

    When choosing a Vessel, the Ballast Port, Owner and Currency fields will be automatically filled out with the vessels last port call, owner and default voyage currency.

    The Currency field in the create modal is used for both Hire currency, as well as Bunkers and CVE currency.

    hashtag
    Trade

    In the trade field a combination of Route, Trade and Pattern can be selected to ensure trade is set properly. When changing to a different option, the cargoes on the voyage will be updated with the same trade.

    This list displays a more detailed view of all the port calls in the schedule:
    The Port Call Edit Schedule

    With this icon , you can either expand or collapse all of the port call items in the list (the list is expanded by default). You can also open and close the collapsable items, independent of each other, to view the detailed information.

    hashtag
    Detailed Information

    The first row, in yellow highlight, you can find the Port Call's Port Cost, Currency, Days L/D, Fix checkbox and Extra (days in port).

    The next two rows, you can find the Cargo Port's Quantity, L/D Rate, Rule, Laytime Term, HC Rate, (HC) Currency, (HC) Measurement and HC Lumpsum checkbox.

    All of these fields are editable. The cargo highlighted in blue in the Cargo List section will also have its port calls highlighted correspondingly in the Edit Schedule section, meaning, you are viewing the selected cargo's information.

    Additional Hover Information:

    All of the collapsible headers are displaying the Port Call Name, Reason for Call and Total Handling Cost (HC). Next to the last mentioned, there is an icon, which you can hover on to display additional information inside a tooltip:

    Tooltip for Additional Total Handling Cost Information

    This tooltip displays, per Port Call, the Counterpart, Quantity, HC Rate and Handling Cost for each of it's Cargo Ports. Again, with the selected cargo from the Cargo List section highlighted in blue.

    . The routing tab illustrates an alternative route for each leg. As presented in the screenshot, there is a key difference between the routes:
    Figure 1. Schedule - Routing with alternative routes
    • TCE Difference: the TCE difference indicator shows the difference between the alternative route TCE and the currently selected route TCE. So, for the leg, Bergen -> Newcastle, the current TCE is -525 USD. On the other hand, selecting the alternative route will result in +27 USD, which is -497 USD of TCE total (Figure 2).

    Figure 2. Alternative route TCE Difference

    hashtag
    Detailed Comparison:

    It is also possible to compare the routes in more detail! For instance, take a look at the screenshot below:

    Figure 3. Routing - Detailed route comparison

    Clicking the top-right arrow in each container expands the detailed information.

    The apply button proceeds with the changes and saves the selected route for the current voyage.

    By selecting the TCE checkbox in estimates, you can override either TCE or Result. The system will then automatically compute the estimated freight or TC rate needed to reach this desired outcome.

    Initial Estimate: A freight rate of 130 USD results in a TCE of 537,817 USD and a result of 953,742.
    To achieve a TCE of 560,000 USD, the freight rate needs to be 135.1062 USD.
    To achieve a result of 1,080,000 USD, the freight rate needs to be set at 146.3887.

    To show the analysis section, click Analysisat the top of the panel. To show an overview bar chart, click Result Chartat the top of the panel.

    Multiply the EUA price by the quantity (EU ETS emission).
  • Conversion to voyage currency Apply the exchange rate between the default currency and the voyage currency.

  • In the figure below, the header shows USD (the voyage currency), while the price field’s end adornment shows EUR (the default currency). The EU ETS Cost is calculated according to the formula:

    Figure 1: Profit & Loss Example

    The result, 1 628.00 USD, is what appears under EU ETS Cost for that voyage.

    NOTE: In our example, the EUR to USD exchange rate on the date of calculation was 1.2.

    default currency
    \begin{array}{r@{\;}l@{\quad}r} \text{EU ETS Cost} & =\;\text{Price}\;\times\;\text{Quantity}\;\times\;\text{Exchange Rate} & (1) \\ & =\;100\,\mathrm{EUR}\times13.567\times1.2 & (2) \\ & =\;1628.00\,\mathrm{USD} & (3) \end{array}
    Remove canal allowance

    However, note that changing allowance settings will not affect sea passages that are already completed (where the End of Sea Passage date is fixed).

    hashtag
    Port Call Allowances

    Canal allowances can also be controlled for a single leg on the voyage, by going to the port call drawer:

    Canal Allowances Port Call Drawer (bottom right)

    Changing these allowances only affects the sea passage leading to this port call. For example, if Panama Canal is deselected on Los Angeles port call, it is only removed from the leg going from New York to Los Angeles. Meanwhile, the canal is still used on the way back to New York:

    hashtag
    Default Allowances

    When creating a new voyage the system applies a set of default canal allowances. These can be controlled by Administrators on the system settings page:

    System Default Canal Allowances

    Initially, the system default allowances apply to all users when creating new voyages. However, each user can override the system defaults through their user preferences page:

    Override System Defaults
    Canal Allowances Voyage Drawer

    Create new entries directly within the grid including various for Port Call and Cargo.

  • Modify existing entries by adjusting details as needed.

  • Delete entries that are no longer relevant.

  • Figure 2: Voyage Full-Screen view
    Various Cost/Revenue
    Cargoes
    Offhires.
    Figure 1. Various Cost/Revenue
    At the top right, click on
    Functions
    .

    hashtag

    Sensitivity Analysischevron-right
    Voyage Intake Calculationchevron-right
    Deviation Calculationchevron-right
    hashtag
    Prerequisites:
    • The Deviation Calculation function is available only for Estimate Voyages.

    Figure 2. Direct Voyage from the Deviation modal.
    Figure 1. Deviation Calculation modal.
    The voyage does not have any cargo
  • The voyage has both a delivery and redelivery port call

  • hashtag
    Converting a voyage

    To convert the voyage, click on the three circles in the top right of the voyage drawer, in order to open the secondary actions menu, and click on the Convert to TC Out option.

    This will bring up a conversion modal, with Owner and Duration fields pre-filled, based on the vessel and voyage. You can override the default duration by entering a new number. Unless the arrival and departure dates in the delivery and redelivery port calls are locked, the arrival date of the redelivery will be recalculated such that the voyage laden days will match the entered duration.

    Speed and Consumption
    Create Downtime
    Load & Discharge Rates Tab
    Create Trade modal
    Trade drawer
    The risk section

    Find Vessels

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

    Open the Vessels module in the Core Menu list on the top left corner.

    There are several sorting and filtering options available for you to narrow down what you include in the list view, including a "My Vessels" filter that shows all the vessels of which the logged-in user is set as one of the following:

    • Master User

    • Responsible Accountant

    • Operator

    • Claims Operator

    You can also of the Vessels list to add, reorder or hide columns. The columns Operator, Built, and Schedulable are hidden by default.

    hashtag
    Vessels List Tabs

    On top of the list, you may find three tabs: Operative, All, and Map.

    Moreover, filters found on the same line as the tabs, apply to both tables. If you switch between tabs, the filters will remain the same, facilitating navigation. The All tab has two additional filters, Archived and Disabled. The Archived filter filters all vessels that have fleet exit date set before current date when enabled. And then there is a disabled filter that shows all vessels that have been disabled.

    hashtag
    Operative

    A click on the Operative tab will load a table, that contains only operable vessels. In other words, the vessels whose fleet exit date is either not set, or set in the future, and has at least one voyage that has either Nominated status or further, but not Closed.

    hashtag
    All

    On the other hand, the All tab shows all vessels in the system that are enabled.

    Speed & Consumption

    1. Open the Vessels module in the core menu in the top left corner.

    2. Find your selected vessel.

    Access "Speed and Consumption" data in the top tab menu. This page provides tools for precise vessel consumption configuration:

    • Indicate the consumption of Boilers and Generator for Main and Auxiliary engines.

    • Overwrite the default consumption for a bunker category during Ballast or Laden passages.

    • Identify default Ballast and Laden speed and consumption.

    • Specify bunker categories used by the vessel.


    Example of vessel configuration:

    hashtag
    Ballast and Laden Passages:

    The top two cards identify Ballast and Laden speeds along with their corresponding fuel consumption for the selected vessel. These cards also allow specifying different consumption for any bunker category. This configuration will be used as default for all vessel's voyages, but may be adjusted for each voyage in the voyage module. A new passage configuration can be added by clicking the + icon. The added options will also be available in the voyage module for all vessel voyages. For example, the vessel in the screenshot from figure 1 has the following configuration:

    • Ballast

      • 8 MT/day @ 12 knots for any bunker category during, but the consumption for the bunker category LS MGO is 6 MT/day @ the same speed (selected). The figure 2 illustrates how the Ballast Passage speed and consumption is configured in the create modal.

    • Laden

    hashtag
    Boilers Per Day and Generators Per Day

    These sections specify the default parameters for extra consumption in port or at sea passages by FO and MGO. The defined consumption will be used for voyages created with this vessel but can be overridden for each voyage in the .

    hashtag
    Bunker Categories

    You can customize the default categories used by the vessel and determine the order in which the categories are utilized. Important Notice: Changes to vessel bunker categories will affect all vessel voyages. This means that unless the selected vessel categories align with the current voyage consumption data, consumption categories and emission calculations will change. Modify vessel bunker categories carefully, and keep in mind the linked voyages that will be subject to update.

    For example, for an Open Loop Vessel it is allowed to use FO, FO LS, and LS MGO in North America. If the vessel has no specific configuration, Dataloy will prioritize FO as the first pick. However, this can be changed by specifying Vessel Bunker Categories, assigning LS MGO priority 1 and FO priority 2*. In this case, Dataloy VMS will compare the allowed categories in an area and select the highest priority matching vessel bunker category – in this scenario, LS MGO. In the event that the vessel is configured without a bunker category allowed in a specific area, the first priority bunker for that area will be used

    The bunker category priorities can be changed via the 're-sequence' function, which is located in the top-right of the Bunker Categories section.

    hashtag
    Air Emissions

    Allows specifying Carbon Dioxide, Nitrogen Oxide, Particulate Matter, Sulfur Oxide, and Carbon Monoxide emission factors for bunker categories. The determined factors will be used during emission calculations for all vessel's voyages.

    Allocating Voyages to a Trade

    There are different ways to allocate a voyage to a trade.

    hashtag
    Voyage Drawer

    In the voyage drawer you have to navigate to the Organisational Data tab, and then you will find the Trade dropdown as the second field on this page.

    Organisational Data tab on the Voyage Drawer

    Every trade dropdown in the system will list up the options following this rule:

    • Single item is Trade (First and second option in the image below)

    • Two items are either

      • Trade - Pattern (Third option)

      • Route - Trade (Fourth and fifth options)

    • Three Items are Route - Trade - Pattern (Last option)

    Selecting a Trade here will display the warning below as the system will change the trade for all cargoes on the voyage to the Trade you selected.

    hashtag
    Create Voyage Charter & Create Template Voyage

    In the lower right corner of both the Create Voyage Charter and -Create Template Voyage modals there is the option to selected which Trade the voyage will be part of. The field is highlighted in the image below.

    hashtag
    Create Time Charter Out

    In the bottom right section of the Create Time Charter Out modal the Trade dropdown is located.

    Create Voyage Charterer

    Creating a voyage charter is fast and easy. The minimum amount of details required is a vessel and a port for loading and discharging.

    1. Open the Voyages module from the menu on the left.

    2. On the top right corner, click the icon.

    3. Select Create Voyage Charterer.

    4. Fill in the details manually, or choose between using a CoA Template Cargo or an existing unallocated cargo as basis for the voyage.

    5. Click the Create-button.

    After choosing a vessel, the previous Port on the Vessel will be set as Ballast Port. This can be overridden by entering another Port, if no Ballast Port is set then the first Load Port will be used.

    hashtag
    Using a CoA Template Cargo

    To create the voyage using a CoA template as a basis, click the Use CoA Template Cargo button in the top of the modal. This will bring up another window, allowing you to select a template from a list of CoA templates. More details can be found here: .

    Using a CoA template will give the voyage and cargo the same Company and Business Unit as the CoA.

    hashtag
    Using an unallocated cargo

    It is possible to create a new voyage and allocate an unallocated cargo by using the Use Unallocated Cargo button in the top of the modal. Clicking it will bring up another window with a list of unallocated cargos. Filter and search as needed, and select a cargo from the list.

    After choosing a cargo, the create voyage modal will be automatically filled in with all the details from the cargo. Only the fields that are not coming from the cargo will remain editable.

    hashtag
    Cargo intake calculations

    When entering Quantity, Volume or Stowage Factor, the modal will automatically calculate the corresponding value. Updating Quantity or Stowage Factor will update Volume, and updating Volume will update the Stowage Factor. Selecting a Commodity will default the Stowage Factor to that of the commodity.

    circle-info

    If the optional preference SF_INTAKE_CALCULATION is enabled on your company's system, the behaviour of the modal is changed slightly.

    • Stowage factor will change from being System Volume Unit / System Weight Unit, to Cubic Feet / System Weight Unit

    • Updating Volume will update Cargo Quantity

    hashtag
    Trade

    In the trade field a combination of Route, Trade and Pattern can be selected to ensure trade is set properly. The cargoes on the voyage will be updated with the same trade.

    Create Voyage From Template (CoA)

    To efficiently create a voyage, and link them with CoAs, you can create voyage based on a CoA Template Voyages. The CoA Templates Voyage are the template voyages that are maintained in the Budgets module.

    hashtag
    Steps:

    1. Open the Voyages module from the menu on the left.

    2. In the top right corner, click Create .

    3. Select Create Voyage From Template.

    4. In the modal, you can apply various filters to narrow down the selection. Clicking a CoA template voyage selects it. The new voyage will inherit the values from the template displayed in the modal, as well as the Company and Business Unit of the template.

    5. Click Create.

    circle-info

    Read more about creating & !

    Voyage full-screen

    Starting with release 8.2, the voyage drawer's default view has been updated. The previous default view has been removed, and the expanded view is now the new default (see Figure 1).

    The expanded view has been replaced with a full-screen drawer, serving as a centralized hub for voyage drawer functions and introducing additional features. This view presents data in an editable grid format (see Figure 2) with customisable columns that enhance and extend the functionality of the previous default view.

    For more details on the grid's functions and usage, go to the data grid page.

    Figure 1: New default view
    Figure 2: Full-screen drawer view

    hashtag
    Creating, editing and deleting in the grid

    Changes to the grid, such as editing fields, adding new rows, copying data, or deleting entries, are applied across the system in real time, ensuring data consistency. Updates made in the grid will automatically reflect in all related drawers and pages, and vice versa.

    hashtag
    Main differences

    The full-screen drawer is designed to make it easier to make modifications to the voyage. This was done by replacing the different collapsible sections (Figure 1) with corresponding grids (Figure 2).

    The as well as the Vessel Section remains the same with the exception of an additional collapsible section for TC Out Contract.

    hashtag
    Map

    The map has also been moved to the left side of the drawer, and when expanded will appear in the center of the drawer (see Figure 3).

    hashtag
    Alternative routing and system preferences

    A key addition to the drawer is the ability to display an Alternative Route tab, controlled by a system preference. This setting can be enabled via the. When activated, the routing tab appears next to the map, providing easy access to alternative route options (see Figure 4).

    hashtag
    : Analysis and Results Chart

    The Analysis and Results Chart retain their functionality from previous versions. However, they are now displayed in the center of the drawer when selected within the Profit & Loss Summary section.

    hashtag
    View Customisation

    The left- and rightmost sections can be collapsed by clicking the buttons inside column dividers, shown in Figure 6. Alternatively, the sections can be toggled using the keyboard shortcuts ALT/OPT + ← and ALT/OPT + →.

    Cargo

    This section is visible on Spot and CoA voyages.

    hashtag
    Cargo List

    To the left, a scrollable list of cargoes are presented as small, blue cards, showing you some select details about the cargo. This is meant to be a quick overview, to be able to differentiate between the different cargos. Clicking on a cargo will select it, and the Cargo-section to the right will update. The currently selected cargo is marked by a blue line on the left side of the card. Hovering over a cargo card will bring up the option to copy it, or open the cargo drawer. While a cargo drawer is open, you may click on any part of the card to open the cargo drawer for that cargo:

    Cargo List in Voyage Overview tab

    Clicking the button in the top right to create a new cargo on the voyage, either from an existing CoA template, or as a brand new cargo.

    circle-info

    If the voyage is of type TC, a shortened list of cargo cards will be used, titled "Last Cargoes". Only the last 3 cargoes created will be displayed. To see the full list of all cargoes on the voyage, use the

    hashtag
    Cargo Section

    The cargo section allows you to directly change some of the fields of the selected cargo (performance cargo by default) from the Voyage drawer without having to open the Cargo drawer. If you are looking for more fields however, you will need to open the up Cargo drawer (clicking the icon will open the drawer):

    Voyage Map

    The voyage map shows the voyage schedule, including alternative routing pointsthat can be added to the schedule between port calls. More routing points will be revealed as you zoom in on the map.

    hashtag
    Viewing routing points

    Click on a routing pointto show information about the point in a popup, including name, position, and GMT offset. When a routing point is clicked it will also be possible to add the routing point to the voyage route. When clicking 'Add to route', a pop-up will appear where you have to choose between which port calls the routing point shall be added.

    hashtag
    Remove existing routing points from the Voyage route

    Routing points that are on the voyage can be removed. When clicked, a button will become available 'Remove from voyage route'. When this is clicked, a confirmation box will appear. When confirmed, the routing point will be removed from the voyage.

    hashtag
    Restricted areas

    The interactive Voyage Map features several restricted areas:

    1. Emission Control Areas

    2. Open Loop Restricted Areas

    Restricted Areas are visible on the map and depicted by Blue or Red dashed lines (See Figure 1).

    The leftmost dropdown filter allows changing the settings to include the particular group of Restricted Areas in the map or not.

    hashtag
    Additional filter: "Active Areas"

    The voyage map now includes a "Active Areas" filter, allowing users to display Restricted Areas that are currently active based on their defined The filter is enabled by default and is voyage specific.

    Sensitivity Analysis

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

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

    The value of the selected Voyage is specified with a blue vertical line. The figures you find in a small box above each point reflect the X-axis values for each point.

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

    Moreover, you may find a table on the right from the Sensitivity Analysis chart. The table consists of the calculated values, placed in ascending order. The table may ease navigation among calculations.

    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 into spreadsheet software.

    Ballast Port: Latitude & Longitude for 'At Sea'

    This section explains the Ballast Latitude and Ballast Longitude fields and how they function.

    Starting in Release 8.7, ballast port that are 'At Sea' will have latitude and longitude coordinates. These coordinates will be used for routing as well as for the voyage map. If a previous port call is available, the ballast port will automatically use its coordinates. Otherwise, the coordinates will default to (0,0) until updated manually.

    Figure 1: Voyage ending At Sea
    Figure 2: The consecutive voyage with ballast port At Sea

    Figures 1 and 2 illustrate how this works for consecutive voyages when the previous voyage ends at sea.

    hashtag
    How It Works

    When a voyage has an 'At Sea' ballast port, the Ballast Latitude and Ballast Longitude fields appear in the of the voyage drawer (see Figure 3). If there is an open position port call available, its coordinates will be used by default. If no previous port call is available, both values will default to zero.

    Users can also manually enter the ballast port’s position in these fields. If the ballast port is later changed to a another port, the fields will be hidden, and the voyage will use the coordinates of the selected port.

    hashtag
    Editing the Ballast Latitude & Longitude

    After creating a voyage, the ballast latitude and longitude can be modified by opening the voyage drawer and navigating to the (see Figure 3). These fields will only be available when the ballast port is set to 'At Sea'.

    Note: Editing is only enabled if the

    hashtag
    Changing the Ballast Port

    If the ballast port is changed from 'At Sea' to a another port, the latitude and longitude fields will disappear, and the voyage will automatically update to reflect the new port’s coordinates.

    Converting Voyage to Template

    A voyage can be converted into Template Voyage, along with some other features

    hashtag
    How to Convert

    In order to convert a voyage to a template voyage, you need to open a Voyage's drawer and click the secondary actions menu in the top-right and select the "Convert to Template..." action:

    Secondary actions menu

    After selecting the action, you will get a modal which allows you to select the following actions:

    hashtag
    Options

    Create New CoA - converts this voyage into a template, and creates a new CoA (Contract of Affreightment) that will be linked its performance cargo.

    Create Unallocated Voyage - converts this voyage into a template, and creates a new non-template voyage of status 'Unallocated', that is linked to this template.

    Budget Scenario - converts this voyage into a template, and sets the scenario to be the Budget scenario that is selected. The other options are disabled when choosing this option.

    hashtag
    Requirements

    Cannot be converted into a template:

    • Template voyages

    • Unallocated voyages

    • Allocated voyages

    • Nominated voyages

    The voyage's type (SPOT, TC & CoA) does not matter in regards to whether you're allowed to convert or not. However, there are some conditions for each type:

    SPOT - both options will be available.

    TC (and has cargoes) - none of the options will be available, but you can still convert.

    CoA - both options will be available and the 'Create New CoA' option is selected by default. If deselecting this option, the template voyage will continue to use the old CoA instead of creating a new.

    Organisational Data

    Information about the "Organisational data" tab

    In the Organisational data tab in the voyage drawer you can edit the following information:

    • Company and Business Unit

    • Trade

    • Responsible Charterer

    • Responsible Operator

    • Responsible Accountant

    • Claims Operator

    • Pool

    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.

    hashtag
    Company and Business Unit

    Company and Business Unit field is mandatory if the voyage status is NOT Estimate or Unallocated. When editing company and/or business unit, you will get a warning that alerts the user that the connected cargoes will also have their companies and business units changed (Figure 1).

    When clicking the OK button, the company and/or business unit will be changed for the voyage and all the connected cargoes.

    hashtag
    Trade

    In the trade field a combination of Route, Trade and Pattern can be selected to ensure trade is set properly. When changing to a different option, the cargoes on the voyage will be updated with the same trade.

    Search and Filter Variouses

    You can search and filter the Various Cost/Revenue list to quickly find relevant entries.

    hashtag
    Filter Various Cost/Revenue

    Filters allow you to control which Various Cost/Revenue entries are displayed:

    • Voyage-Specific Filters – If the voyage includes Various Cost/Revenue linked to Cargoes or Off-hires, a filter will appear in the top-right corner of the list. Use this filter to select which types of Various Cost/Revenue should be displayed.

    • Currency Filter – You can also filter entries by currency using the Currency filter, located in the top-right corner of the list. This allows you to view only entries in a specific currency.

    You can apply multiple filters at the same time to narrow down your results.

    hashtag
    Search for Various Cost/Revenue

    To search for a specific Various Cost/Revenue entry:

    1. Use the Search Bar – Located in the top-left corner of the list (figure 1).

    2. Enter a Keyword – You can search by description or various text.

    3. View Results – The list will update automatically to show only entries that match your search.

    Filtering and searching can be used together to quickly locate specific entries within the list.

    Swap Vessel

    Swap Vessel is a functionality that allows you to change the vessel of the voyage, regardless the status of the voyage. There are two ways to change the vessel; through the Vessel field under Voyage Overview, or through the secondary action 'Swap Vessel'.

    hashtag
    Swap Vessel for Estimate or Unallocated voyages

    For voyages with status Estimate or Unallocated, you can only swap the vessel of the voyage through the Vessel field found under Voyage Overview section:

    This works as a normal dropdown menu, that views all available vessels for you to click and swap to.

    hashtag
    Swap Vessel for Allocated or above voyages

    For voyages with status Allocated or above, you can only swap the vessel of the voyage through the secondary action called 'Swap Vessel':

    Followed by clicking the action, this modal will pop up:

    In this modal, a vessel must be selected to be able to swap. By default, the vessel you are currently on is selected. Meaning, you are always able to actually click on the Swap button (for now). After the swap, you are able to see the new vessel either as the above mentioned Vessel field under Voyage Overview, or at the top of the Voyage drawer, left-most (clickable) chip:

    Create, Edit & Delete Various Cost/Revenue

    It is possible to create, edit, and delete Various Cost/Revenue entries for a voyage directly from the Various Cost/Revenue tab. Additionally, in the full-screen view of the voyage drawer, you can create Various Cost/Revenue entries for Cargo and Port Call using the vertical ellipsis menu (see Figure 1 for reference).

    Figure 1: Voyage Full-Screen Create Port Call Various Cost/Revenue

    All Various Cost/Revenue entries are also displayed in the Various Grid (accessible in full-screen view), allowing you to easily view, edit, or delete entries as needed.

    hashtag
    Create New Various Cost/Revenue

    1. Click the Create Button – Locate and click the Create button in the top-right corner of the header (Figure 2).

    2. Enter Required Information – A Create modal will appear, prompting you to fill in the necessary fields.

    3. Create the Various– Once all required details are entered, click Create to finalize and add the new Various.

    hashtag
    Edit Various Cost/Revenue

    1. Select the Various– Click anywhere on the row of the Various you wish to edit in the list.

    2. Modify Details – An Edit modal will appear (figure 4), allowing you to update the entry’s properties.

    3. Save Changes – Click Save to apply the modifications.

    hashtag
    Delete Various Cost/Revenue

    1. Select Entries for Deletion – Use the checkboxes in the leftmost column to select the relevant entries.

    2. Click the Delete Option – Once selected, a Delete button will appear in the top-right corner of the header.

    3. Confirm Deletion – Click Delete, then confirm in the popup that appears to complete the removal.

    ⚠️ Note: Deleted entries cannot be restored. Be sure to review your selection before confirming deletion.

    Delete Voyages

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

    1. Find a voyage (i.e through the Voyages page).

    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.

    Voyages can be connected to Cargoes and/or Offhires, as well as scheduled voyages if the voyage is a template.

    When attempting to delete a template voyage that has scheduled voyages either at the Nominated or later stages, an error message will show instead.

    The delete-voyage modal will look differently depending on whether it has connected entities:

    • No connections:

    • Only Offhire connection:

    • Only Cargo connection:

    • Offhires and Cargoes:

    Voyage Comparisons

    A functionality to compare voyages' values to each other to get the best overview.

    hashtag
    Finding comparisons

    A list of all voyage comparisons can be found under the Comparisons-tab in the Voyages module. The list allows you to search and filter.

    hashtag
    Finding comparisons for a specific voyage

    The Find comparison button can be found as a primary action in the Voyage drawer:

    This will open up the comparisons list, with the voyage pre-selected as a filter. Any comparison that includes the voyage, will be shown.

    hashtag
    Creating a new comparison

    Click the icon in the top right to create a new comparison. This will bring up a window, allowing you to set a name, add a comment and choose a voyage as the base of the comparison.

    Create Cargo From Existing Cargo

    To efficiently create a cargo, you can create a cargo based on an existing cargo.

    hashtag
    Steps:

    1. Open the Cargoes module from the menu on the left.

    2. In the top right corner, click Create .

    3. Select Create New Cargo From Existing Cargo.

    4. In the modal, select a cargo to create the new cargo

    5. Click Create.

    hashtag
    The modal:

    circle-info

    The modal can also be found in:

    • Voyage drawer, cargoes tab

    • Voyage drawer, cargoes list

    Change Voyage Reference Number/Voyage Number and Voyage Starting Year

    From the voyage drawer actions it is possible to change the Voyage Reference Number or Voyage Number, depending on the voyage status.

    When voyage status is Estimate, Unallocated or Allocated, it is possible to change the Voyage Reference Number. It is also possible to change the Trade Voyage Number if the voyage is connected to a trade, however this number will be automatically set when the voyage is nominated, erasing any previously set value.

    Estimate voyage

    When voyage status is Nominated, Operational, Operationally Closed, Invoiced or Closed, it is possible to change the Voyage Number. If the voyage is connected to a trade it is also possible to change the Trade Voyage Number and view the Voyage Reference Number. The Voyage Reference Number can be changed if the Voyage Variant Number for the system is set to 9, else it will only be for information. Setting the voyage status to Estimate or Allocated from Nominated will remove the Trade Voyage Number.

    Nominated voyage

    Clicking Edit Voyage Reference... or Edit Voyage Number... in the options meny opens a dialog box where the current values can be modified. In addition, the dialog box contains a field for changing the Voyage Start Year.

    Create Cargo From CoA Template

    To efficiently create a cargo, and link them with CoAs, you can create a cargo based on a CoA Template. The CoA Templates are the template cargoes that are maintained in the CoA module.

    hashtag
    Steps:

    1. Open the Cargoes module from the menu on the left.

    2. In the top right corner, click Create .

    3. Select Create New Cargo From CoA Template.

    4. In the modal, select a CoA template to create the new cargo. The fields that are pre-filled are the ones that were filled in when creating the CoA itself, which the new cargo will inherit.

    5. Click Create.

    hashtag
    The modal:

    hashtag
    Feature:

    • The modal is now draggable, making it easier to see the information "behind" the modal. Hover over the title or the top of the modal to activate it.

    • Looks and works quite similar to .

    Comments

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

    Payment Terms

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

    Convert Cargo to Relet/Non-Relet

    The convert cargo to relet function gives you the possibility to change your cargo from generating a freight revenue to instead generating a freight cost.

    hashtag
    Convert Cargo to Relet

    1. Open the Cargoes module in the Core section.

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

    3. At the top right in the drawer, click More and select Convert Cargo to Relet.

    The cargo subtype will now change to be and the cargo freight will be considered a cost in the voyage profit and loss calculation.

    hashtag
    Convert Cargo to Non-Relet

    1. Open the Cargoes module in the Core section.

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

    3. At the top right in the drawer, click More and select Convert Cargo to Non-Relet.

    The cargo subtype will now be removed and the cargo freight will be considered a revenue again in the voyage profit and loss calculation.

    Voyages & Port Calls

    The Voyages & Port Calls tab has two sections. A list of all voyages for the selected trade, and then a choice between the port calls or bunkers for a selected voyage.

    hashtag
    Voyages

    This is a list of voyages on the opened trade sorted by newest first. Clicking the icon will bring up a modal to customize which columns are visible. In the upper right corner of the list there is the option to hide/show allocated voyages for the selected trade, filter voyages based on which pattern they are part of, and show the times in GMT instead of local time. If there is an ongoing voyage in the list, it is indicated with a blue marker on the left side, as seen in the image below.

    Create Voyage Without Cargo

    There may be several reason for having a voyage without any cargo onboard the vessel. By using the Create Voyage Without Cargo option, you can for instance plan out repositioning of your vessels, or schedule dry docking.

    hashtag
    Steps:

    1. Open the Voyages module from the menu on the left.

    Overview

    The voyage drawer is also split up in different sections; , , (the Performance Cargo), , and .

    For a TC voyage, the drawer has the section instead of the Cargo section.

    Schedule

    The "Schedule" section in the Voyage drawer comprises three sub-sections: Schedule, Edit Schedule, and Routing. This part focuses on the 'Schedule' tab.

    The Voyage schedule (Figure 1) visualization may be found on the right-hand side of a voyage drawer.

    This section is highly customizable: for example, you can change the voyage start date, lock it, update the port call sequence, and edit port calls by hovering over a port call box.

    The Schedule Timeline is a fully interactive module. Each port represents a draggable block - if you reorder the blocks with not-fixed port calls (Figure 2), you will update the port call sequence on the opened voyage correspondingly:

    Next, each Port Call block is clickable, and it brings up a drawer.

    Bunkers

    This page gives an entail into the tab 'Bunkers' inside the Voyage module.

    The Bunker module is split into three parts: 1. Bunker Indices; 2. Bunker Stock Summary; 3. Bunker Stock Details.

    Yet, the Print EUA Statement button is always visible. This function generated a descriptive report of consumed per port, specifying the percentage used in calculations, and associated consumption per leg.

    1. Bunker Indices: this section helps to have a better overview of bunker indices even when the fuel types FO and LS MGO are not consumed by a vessel. By default, the section is collapsed, providing information regarding the bunker indices. Once expanded, the indices can be altered. Refer to Figure 1 for example:

    Voyage Intake Calculation

    The intake calculator provides an overview of the vessel's intake capacity and key reduction factors for the voyage, allowing you to adjust and compare different loading scenarios.

    To open the intake calculator, click on the icon in the top right of the voyage drawer, and select "Voyage Intake Calculation". This will take you to the calculator page.

    In the top of the voyage intake calculator, you will find two chips displaying the vessel and voyage reference. Clicking the vessel chip will open up the vessel drawer.

    Create Cargo

    hashtag
    Steps:

    1. Open the Cargoes module from the menu on the left.

    Create Cargo on TC Voyages

    A cargo can be created on a TC voyage either by using the Last Cargoes section in the Voyage drawer Overview tab, or by using the cargo list in the Cargo tab.

    hashtag
    Cargo Restrictions:

    Find Cargoes

    The VMS contains all cargoes created in your system. To access the Cargo lists, you can navigate in the left-side menu to the "Cargoes" module. This will display 3 different cargo lists: Allocated, Unallocated and Sub-cargoes:

    Both the lists Allocated and Unallocated shows cargoes of all statuses and types, while the Sub-cargoes list shows the sub-cargoes linked to different cargoes.

    hashtag

    Commissions

    In the Commissions tab you can create new commissions by clicking the -icon to open a dialog to enter values, where "Broker" is mandatory:

    Once clicked the below modal will appear:

    Once the required field is 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.

    TC Voyages

    A TC Voyage will not have a Cargo Section on the Overview Tab like normal Voyages, but instead have a Time Charter Contract Section displaying the Time Charter Contract. In this section you can edit the most important fields on a Time Charter directly through the Voyage Drawer or click the -icon to Open the Time Charter Contract Drawer.

    The Delivery Port and Redelivery Port fields display the port from the associated Port Call. When you enter a new port, the Port Call and TC Contract will be updated accordingly. Click the -icon to Open Port Call Drawer.

    Both Duration

    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.

    circle-info

    Learn about the cargo actions in FAS: .

    Change Cargo Status

    At the top of the drawer you can find a dropdown menu with available statuses for a cargo, which will open by clicking on the current status:

    The cargo status is a helper for you to understand where in the process you are. All statuses apart from 'Clean Fix' are the same in the sense that they do not change the functionality of the system. When you set the cargo status to 'Clean Fix', the Cargo Quantity in the Cargo drawer changes to be B/L Quantity. Meaning, when changing the Cargo Quantity on a 'Clean Fix"'cargo, it only changes the B/L Quantity, and not the Booked Quantity.

    hashtag

    Sub-cargoes

    In the Sub-cargoes tab you may enter 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:

    Once the required fields are filled in the create button will be activated and you may create the sub-cargo. The modal for editing a sub-cargo is identical.

    Customise the columns

    On the other hand, there are two Laden consumption options for this vessel:

    • 1) 12 kn @ 9 MT/day of any bunker category and 7 MT/day of LS MGO @ 12 kn.;

    • 2) 13 kn @ 10 MT/day and 8 MT/day of LS MGO @ 13 kn. (selected)

    voyage module
    (Figure 1) Vessel speed and consumption configuration
  • If a vessel is selected, updating Stowage Factor will calculate the maximum amount of cargo the vessel can carry, restricted by vessel deadweight and cubic capacity.

  • Create Cargo From CoA Template
    Create Voyage Charter Modal
    Choosing an unallocated cargo
    A cargo has been selected. Most fields have been filled in and made uneditable.
    Behaviour of the voyage modal when the optional preference SF_INTAKE_CALCULATION is enabled. A vessel with 71,500 CBM cubic capacity and deadweight of 61,000 MT is selected, and stowage factor is being changed.

    Operational voyages

  • Invoiced voyages

  • Operationally Closed voyages

  • Closed voyages

  • Convert to Template modal (for SPOT)
  • New various items will have status 'Estimated' by default.

  • Figure 2: Various Cost Create Button
    Figure 2. Create Various Cost/Revenue
    Figure 3. Edit Various Cost/Revenue
    Figure 5: Delete Various Cost/Revenue

    Fleet Plans, Cargo Management

  • Fleet Plans, Cargoes

  • Capacity Plan

  • Cargoes

  • Modal for creating a cargo from existing cargo

    Below, you will find a list of either Port Calls or Bunkers, and a button to toggle between the two different views.

    hashtag
    Port Calls

    While in Port Call view, clicking on a voyage row will list all port calls of the selected voyage, as well as the port calls from the previous and next voyage on the same vessel as the selected voyage, if they exist. The port calls from the previous and next voyage on the same vessel will be in a slightly lighter colour, such that it is possible to tell them apart. Clicking directly on the reference number of the voyage will open up the Voyage drawer.

    Clicking on port calls in the list opens the corresponding port call's drawer where you can make can changes:

    The Port Calls list will display up to 30 items, and includes a separate scrolling functionality. By hovering over each of the "headers" (such as Voyage, Port, Reason for Call, etc.), you can also see an sorting array which will make you able to sort that specific column in either an ascending (ASC) or descending (DESC) order.

    hashtag
    Bunkers

    The Bunkers view removes the list in favour of up to three collapsible sections for the voyages. Similarly to the Port Calls view, clicking on a voyage row in the voyages list will select/open up the corresponding collapsible section, and fetch the data for the previous and next voyage on the same vessel:

    The top band of the section displays 4 columns; the reference number of the voyage, Opening Balance, Consumption and Closing Balance. Each of the latter three will show amount and price for up to 4 different bunker types, depending on which bunkers are actually being used by the selected voyage's vessel.

    Expanding the collapsible section will give you a table overview of each port, with reason for call, distance, speed etc., as well as a detailed breakdown of the bunkers consumed. Only the bunkers actually used will be displayed here.

    Filtering

    The bunker section can be filtered by bunker category to get a better overview for each category.

    hashtag
    Resequence Port Calls

    Port calls can also be resequenced to a different position within the previous, current, or next voyage. To resequence a port call, click the resequence symbol in the top right corner of the port calls list. A popup modal will then show and the port call can be dragged and dropped in the desired position (see screenshot below). Note that only one port call can be moved at a time. Also, only port calls after the last Arrived, Berthed or Departed port call can be moved in the list:

    Voyages list

    On the top right corner, click the icon.

  • Select Create Voyage Without Cargo.

  • After you have filled in the required information, you can click Create.

  • Field
    Required Fields
    Note

    hashtag
    Drawer Actions

    On the left hand-side, we have the vessel name chip, which is clickable and will forward you to the linked . The number is the reference number of the voyage, and to the right we have the status. The statuses are within a dropdown menu which you can :

    If the voyage has a trade connected to it, a new chip will appear between the vessel chip and voyage number. This chip displays the trade code and will forward you to the linked Trade drawer when clicked.

    To the right hand-side, we have the button, copy button (to duplicate the selected voyage), the voyages button, print voyage button, the voyage button, the expand button, the secondary actions button and the close button. These are also called the primary actions:

    hashtag
    Secondary Actions

    In this dropdown menu, you are able to do several actions:

    Swap Vessel: you are able to swap the voyage onto another vessel. Read more .

    Edit Voyage Reference: you are able to change the voyage reference number on the given voyage. Read more: .

    Convert To Template: you are able to convert the voyage to a template. Here you have two different options to choose between (unless they are disabled).

    Print Statement of Account: you are able to print out the SoA report of the given voyage.

    Open Preliminary Voyage: Opens a new tab and brings you to the special preliminary voyage that is created when the voyage is nominated.

    Mark as Optional: you are able to mark the voyage as optional, meaning you can set the statuses 'Not declared', 'Declared' or 'Forfeited' on the performance cargo of the voyage. Read more .

    Audit Log: you are able to track every action inside, and regarding, this given voyage.

    Attachment: you are able to upload/download the voyage attachments.

    Vessel
    Cargo List
    Cargo
    Schedule
    Profit/Loss Summary
    Speed & Consumption
    Time Charter Contract

    The small ovals inside of each Port Call block are called chips and include a piece of related information: Days at Sea + Extra Days at Sea, Actual Speed, and Distance between Ports. Every oval is clickable and allows editing corresponding sea passages (Figure 3).

    Moreover, the Port Call blocks include a small hover actions toolbar that provides the following actions on the voyage schedule sequence: show Port Cost history overview, create new Port Call to the current schedule, edit the selected Port Call, or delete the Port Call.

    hashtag
    Hover Toolbar

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

    • and port costs for the selected port.

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

    • To edit a port call, click the Edit button.

    hashtag
    Edit Port Call

    To edit a port call in the schedule, click the pencil icon in the action tooltip. A popup modal then shows with editable essential port call details (Figure 5).

    circle-info

    Note that the port can only be changed if the Arrival-, Berthed-, and Departure Date are unfixed. If any of these dates are fixed, the port selector will only show available terminals on the currently selected port.

    Port Call
    Figure 1. Voyage Schedule
    Figure 2. Schedule Drag'n'Drop

    The Bunker Stock Summary contains cards associated with the respective consumed fuel type. The core idea is to provide a brief overview of consumed bunkers and derived costs (Ref. Figure 2).

    1. Bunker Details serves the same idea as Bunker Stocks Summary but provides more detailed and specific information. The table items can be filtered to show only the Consumption or Bunkering rows (ⓘ interact with the filter options in the top right of each table card).

    3.1 Opening Balance

    Each list starts with the opening balance of the stock. The opening balances displays the balance of the bunker stocks at the beginning of the voyage and are generated based on the previous fixed voyage. When creating voyage estimates the opening balances are generated based on the last fixed voyage on the vessel.

    Opening balances can be updated on voyages with status Estimate or Unallocated to be able to do quick calculations. Once a voyage is fixed, the opening balance will be recalculated based on the previous fixed voyage and will no longer be editable.

    Opening balances are also editable on voyages where the voyage start date is fixed.

    hashtag
    Edit opening balance

    To edit an opening balance on voyages where this is enabled,

    • click on the opening balance row and a modal with the editable values will appear

    • edit the values

    • click Confirm to save your changes

    hashtag
    Add opening balance

    It is possible to add additional opening balances for each bunker category on voyages that have the status Estimate or Unallocated and for voyages where the start date of the voyage is fixed.

    To add an opening balance:

    • in bunker stocks list click on the Add Opening Balance button located above the bunker stock list for a given bunker category

    • enter the values

    • click Confirm to save the opening balance

    circle-info

    Note that the button is only enabled if it is possible to add additional opening balances to the voyage.

    The new opening balance will be added after the last existing opening balance in the list.

    EU ETS
    (Fig. 1) Bunker Indices.
    hashtag
    Opening Balance section

    The Opening Balance section shows bunkers onboard the vessel at the start of the voyage. These fields can be edited if any of the following conditions are met.

    • The voyage has status Estimate or Unallocated

    • The voyage has a fixed start date

    • The voyage is the first voyage on the vessel

    hashtag
    Port Calls and intake graph

    The Port Calls grid displays information about the voyage port calls, and allows you to specify the Port Draft and Zone of the individual port calls. Changing either of these values may have an impact on the intake calculation.

    Below the grid, you will find a graph for the intake calculation, with a bar for each of the port calls in the voyage schedule. Each port call will have a small Intake-label, displaying the maximum intake. The x-axis is scaled to the maximum deadweight of the vessel, given the port zones in the schedule.

    Additional information can be displayed by hovering over a segment in the bar chart.

    circle-info

    The Bunker Reduction and Quantity numbers are defined using the reason for call of the port calls

    • Loading port calls, the departure weight is used

    • Discharge port calls, the arrival weight is used

    hashtag
    Loadline and Cubic Information

    In the bottom of the Intake Calculator, you will find a section outlining the loadline and cubic information of the vessel. This section is for reference only.

    In the top right corner, click Create .
  • Select Create New Cargo.

  • In the modal, you can fill in the required fields and add any additional information about the new cargo.

  • Click Create.

  • hashtag
    Required fields:

    • Load Port

    • Discharge Port

    • Counterpart

    hashtag
    New design:

    The new Create Cargo modal has a new design to increase the productivity while creating a cargo, is more user-friendly and has more useful features altogether. Click on the picture below to get a better view of the details:

    hashtag
    New Create Cargo Port modal:

    Similar to the design above, we now have a new Create Cargo Port modal:

    This modal has the same features as the Create Cargo modal, listed below. To create a new cargo port on a cargo, there is now a simple icon at the top of the Cargo Port Timeline section of the . However unlike the Create Cargo modal, Reason for Call is set to 'Loading' by default and is limited to only 'Loading' and 'Discharging' for cargo ports.To change the order of ports, you can use the drag and drop features inside the modal. To edit or delete an existing cargo port you can, in the Cargo Port Timeline section, look for the grey icons on each of the cargo port rows, to specifically focus on a cargo port of choice to make the changes. Read more about the features below.

    hashtag
    Features:

    • With the new multiple value component in the Create Cargo modal, you are now able to add multiple Load- and Discharge- cargo ports to the new cargo.

    • The fields are divided into 2 sections, while the 3rd section displays the Timeline component of the cargo ports that are added. In the Create Cargo Port modal, there are 2 sections, in which the 2nd one contains the Timeline.

    • It is possible to drag and drop

    circle-info

    To see the new Create Cargo and Create Cargo Port modals for allocated cargoes, click here: !

    You cannot create a cargo from CoA templates

  • You cannot create a cargo if there are no load- or discharge port calls on the voyage

    • Even when we have the delivery/redelivery port calls

    • You need to create at least one loading- and discharging port calls on the voyage schedule (unique values)

  • You can only create cargoes with cargo ports based on the port calls in the voyage schedule

    • The port selectors on the upper-left side of the modal are restricted to only display these cargo ports (also with its attached terminals)

  • hashtag
    Drawer Restrictions:

    The following actions are disabled from the secondary actions:

    • Unallocate Cargo

    • Allocoate Cargo

    • Relet

    hashtag
    Drag & Drop Restrictions:

    In the FAS board, these following actions are disabled:

    • Dragging an unallocated cargo to a TC voyage

    • Dragging an allocated cargo on a TC voyage to Commitments

    • Dragging an allocated cargo from one TC voyage to another voyage (TC or not)

    hashtag
    Creating cargo on TC Out voyages

    The counterpart field in the Create Cargo modal will be automatically filled with the Charterer from the TC out contract connected to the voyage.

    List of created cargoes inside a TC voyage
    Allocated

    This list contains of all the allocated cargoes. Meaning, cargoes created on and/or allocated/moved to voyages. Multiple cargoes can be allocated on the one and same voyage. You can hereafter open one of the items on the list, to view the

    hashtag
    Unallocated

    This list contains of all the allocated cargoes. When creating a cargo from scratch, this is where that cargo will be placed, by default. These cargoes don't belong to any voyages yet, but once you click on one of the items on the list, you can perform different , e.g. allocating the cargo.

    Click to see an overview of the different ways to create a cargo.

    hashtag
    Sub-cargoes

    This list contains of all the sub-cargoes linked to cargoes. These do not have a drawer, but when clicking on one item from the list, you can see a modal (or "dialog box") pop-up on the screen. Multiple sub-cargoes can be linked on the one and same cargo.

    You can read more about Sub-cargoes .

    hashtag
    Sorting & Filtering

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

    Cargoes module with three tabs for viewing Allocated, Unallocated and Sub-cargoes
    and
    Rate
    fields will be disabled if there exists more than one Duration on the Tc contract, or a Duration has multiple Rates.

    The Calculate Profit/Loss checkbox is only available while the Voyage still has status Estimate, and will toggle calculation of profit/loss based on bunkers.

    hashtag
    Related pages:

    • and its subpages

    Time Charter Contract Section on Voyage Overview
    Transitioning the Status to 'Loaded':

    For a cargo, you can change the status to 'Loaded' only from the status 'Clean Fix'. You are also able to change back to 'Clean Fix' from the status 'Loaded'. The same Deadfreight/Overage, Booked Quantity, etc. calculations will happen when in these two statuses. Likely, this status will be used to mark the last transition of a cargo.

    hashtag
    When Nominating a Voyage

    All cargoes on a voyage will have their status changed to 'Clean Fix' when the voyage is changed to 'Nominated' status. The only exception to this is if the cargo already has status 'Loaded'.

    Available Cargo Statuses

    Parameter

    Calculated value

    Freight Rate

    TCE

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

    TCE

    TCE

    Freight Rate

    Template Voyages
    Convert Voyage to Template
    Modal for Creating a Voyage from a CoA Template
    Profit / Loss Section
    System Settings
    Profit & Loss Summary
    Figure 3: Full-screen expanded map
    Figure 4: Alternative routing enabled
    Figure 5: Results Charts displayed
    Figure 6. Toggle Section Buttons
    Figure 7. Drawer after collapsing left column
    Cargo
    Cargo Section in Voyage Overview tab
    Cargo Section in Voyage Overview tab
    Start and End Dates.
    Figure 1 - Restricted Areas on Voyage Map.
    Figure 2 - 'Active Areas' filter not applied
    Figure 3 - 'Active Areas' filter applied
    vessel section
    vessel section
    voyage start date is fixed.
    Figure 3: At Sea Ballast Port selected
    Create Voyage From Template (CoA)
    Modal for Creating a Cargo from a CoA Template
    Cargo Management Board Actions
    Cargo Drawer
    Trade options
    Warning modal when selecting a Trade
    Create Voyage Charter modal with Trade dropdown highlighted
    Figure 1. Organisational data tab
    Figure 1. Warning when attempting to change company and business unit
    Figure 1. Various Cost/Revenue Tab Filters and Search Bar
    Vessel Field on the Voyage Overview Section
    Swap Vessel secondary action
    Swap Vessel Modal
    Vessel chip at the top, left-most
    Plain delete modal with no alerts due there not being any connected offhires or cargoes.
    Alert showing that an offhire is connected and will be deleted.
    Alert showing that an cargo is connected and will be deleted.
    Alert showing that an offhire and a cargo is connected and will be deleted.
    Comparison functionality in the Voyage drawer
    Estimate voyage
    Editable Trade Voyage field appears
    Nominated voyage
    Disabled Voyage Reference Number Field
    Enabled Voyage Reference Number Field
    Create Commission Modal
    The table headers for the sub cargoes
    Create / Edit Sub-cargo modal

    Maintain Voyages

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

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

    circle-info

    hashtag

    Relet Cargo

    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

    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 dialogue for allocation.

    Transship and Preship Cargo

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

    A preshipment is another type of relet created from a cargo booking. It is the transportation of a cargo from a location to that cargo's load port in an existing cargo booking.

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

    hashtag

    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:

    Relet Internally

    The Relet Internally option allows you to reassign a charter to another company within the same group. The internal operating company records the income, while the original owning company balances to net zero. To accomplish this, two additional cargoes will be created, resulting in the following structure: the original Spot cargo, an Internal cargo, and an Internal Relet cargo. This ensures seamless invoicing between the owning and operating companies, and the external charterer.

    circle-exclamation

    In order to use this feature, both Companies will need to have an Internal Business Partner set.

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

    Cargo drawer.
    Cargo drawer actions
    here
    here
    sorting and filtering

    Vessel

    Yes

    Ballast Port

    No

    If none is selected the selected Port will be used.

    Port

    Yes

    Create Voyage Without Cargo Modal

    To delete a port call, click the Delete button.

  • To change the order of port calls, simply hover over a port call to move it into place.

  • View
    maintain
    Figure 3. Edit Sea Passage
    Figure 4. Schedule Port Call action tooltip
    Figure 5. Edit Port Call action
    Commodity
    the ports in the Timeline component to change the order of the cargo port rows, in both of the modals.
    cargo drawer
    Cargo Management Board Actions
    New Create Cargo Modal fro Unallocated Cargoes
    New Create Cargo Port Modal For Unallocated Cargoes
    Transship
  • Preship

  • Transfer

  • drawer
    Cargo Management
    Change of vessel and ballast port

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

    circle-info

    Edit estimates permissions

    With the preference 'Share voyage' you can indicate if estimate voyages can be edited by anyone or only by the creator and administrators

    • If 'Share voyage' is set to true, estimate voyages and template voyages is editable by all users

    hashtag
    Tiles

    Tiles show the key values like TCE, Days Total, Distance Total, Bunker Consumption, EEOI, Days In Port, of the voyage.

    Conditional information:

    • TCE Excluding Offhire (only shown when there is at least one offhire day)

    • Offhire days (only shown when there is at least one offhire day)

    circle-info

    hashtag
    FAQ: Why is Excl. Offhire higher than TCE?

    TCE is calculated as: Contribution divided by Total Days of the Voyage TCE Excl. Offhire is: Contribution divided by (Total Days of the Voyage - Total Days Offhire)

    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.

    located the voyage
    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 More and select Relet to Another Owner.

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

  • Reletting a cargo will create a copy holding most of the same data of the cargo to be relet in the system. This new cargo has cargo type and thus it is has a freight cost instead of a freight revenue.

    hashtag
    Delete a Relet

    1. that was relet.

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

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

    hashtag
    Synchronisation

    Editing the cargo quantity, measurement unit, commodity or the planned BL Date of a relet cargo or its connected cargo will trigger an identical change on the other cargo to keep them synchronised on these fields.

    The allocation dialogue is a three-step process. Once you have selected a vessel, a list of all the voyages on the vessel will appear. Sort and filter the list to find the exact voyage you want, select it, and a preview of the voyage schedule will appear, with cargo ports on the left, and port calls on the right. The scheduler will attempt to link the existing port calls on the voyage with the cargo's cargo ports. If no port call exists, a new one will be created at the end of the voyage. These are denoted by a blue "NEW" chip. You can re-arrange the port calls by dragging and dropping.

    When allocating, the cargo will also have its company and business unit changed to the voyage's company and business unit. You can edit the cargo's company and/or business unit after the allocating if you want it to be different from the voyage's.

    Click Allocate to allocate the cargo. Any new necessary port calls will be created on the voyage.

    circle-info

    hashtag
    Available voyages to allocate to

    Only voyages with status Estimate, Unallocated, Allocated, Nominated and Operational that are part of the same Scenario will be available to select in the modal.

    It is not possible to allocate cargoes to budget voyages.

    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

    The To Port will be automatically added to the cargo field Final Destination.

    hashtag
    Preshipment

    The From Port will be automatically added to the cargo field Place of Origin.

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

    hashtag
    Creating an Internal Relet
    1. Set the Voyage company to the operating company.

    2. Set the Cargo company to the owning company.

    3. Click the More button in the top right of the cargo drawer, and choose the Relet Internally option.

    The final setup should look as follow

    Cargo type
    Counterpart
    Company

    hashtag
    Deleting

    Deleting cargoes in an internal relet structure behaves differently depending on which cargo is being deleted.

    • When deleting the original Spot cargo, all three cargoes are deleted permanently.

    • If deleting either of the Internal cargoes, only the Internal cargoes are deleted.

    Structure of an Internal Relet. Camflex Asia accepts a cargo from external charterer Ares, and has internally reletted the cargo to Camflex EU.

    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.

    Vessel drawer
    change yourself
    delete
    compare
    functions
    here
    Change Voyage Reference Number/Voyage Number and Voyage Starting Year
    here
    Left-Side Drawer Actions
    Left-Side Drawer Actions with Trade chip ASEA
    Right-Side Primary Actions
    Create TC Voyage
    Time Charter Contracts
    (Figure 2) Ballast Passage Speed configuration
    The ongoing voyage (overlapping) is marked by the solid deep blue bar on the left, while the selected voyage (132) is highlighted in blue
    Port Calls of the previous, selected, and next voyage
    Bunker consumption overview for the previous, selected, and next voyage
    On this voyage, only FO and LS MGO has been consumed, so the balances and consumption columns only displays information for FO and LS MGO.
    On this voyage, only FO and LS MGO has been consumed, so the breakdown also only displays information for FO and LS MGO.
    Resequence the port calls
    (Fig. 2) Appearance of the Bunkers module (Summary).
    (Fig. 3) Appearance of Bunkers module (Details)
    It is possible to set values for Port Draft and Zone in the Port Calls grid
    Hovering over each segment will give you additional information

    Voyages & Port Calls

    In the "Voyages & Port Calls" section of the vessel drawer, you will find the most important information about a vessel and its voyages.

    Vessel Details

    The "Vessel Details" section shows some key data points about the vessel such as DWT, Cubic Capacity, Draft and more. Click Expandto show more details and contact information for the vessel.

    hashtag
    Voyages

    Invoices

    In the "Invoices" tab in the voyage drawer, you can efficiently see and manage the Pending Receivable/Payable document lines, as well as the Invoices connected to the voyage. The tab is only visible to voyages that do not have status "Estimate".

    In the top right, you will find two buttons for printing the Owner and Charterer Statement. Below them, in the middle of the drawer, you will find a two or three-way toggle-button that allows you to switch between the receivable, payable and hire payable invoices (only if the vessel is on a TC In). Switching between these options will change both which pending document lines are displayed and the assembled invoices.

    hashtag
    Pending section

    Maintain Voyage Comparisons

    hashtag
    Voyage comparison overview

    The comparison page presents a table of the voyages, with values being segmented into groups. The name of the comparison is displayed at the very top, alongside a button to edit the name.

    In the top left of the comparison window, you will find two buttons; Highlight Differences and Show Only Differences. By default, Highlight Differences is turned on.

    Freight Rate Tiers

    In the Freight Rate Tiers tab, you can create, edit and delete different freight rate tiers for the cargo. It is also possible to choose between a tiered and a volume rate model.

    Tiered: In tiered pricing, the per-unit freight rates are assigned to quantity-based ranges (tiers). When calculating the total freight, quantities are purchased from successive tiers, starting from the lowest. Example: In the below example, a cargo of 8000MT would have a freight rate of 11 USD for the first 4999MT and a freight rate of USD 12 for the remaining 3001MT. The freight rate will show as a weighted average on the cargo.

    Volume: Here too, the freight rate is quantity-based. However, the per-unit freight rate is dependent on the range within which the total quantity falls. So, under this model, you would define the quantity ranges and the per-unit freight rate for each. Example: In the below example, a cargo of 8000MT would have a freight rate of 12 USD for the entire quantity.

    If a cargo has one or more tiers in this section, the

    If 'Share voyage' is set to false, estimate voyages and template voyages is editable only by the creator and administrators

    'TCE Excluding Offhire' will display the TC Equivalent using the remaining total days after excluding/subtracting the days offhire. As a result of dividing by a smaller number, it will always be a higher number than regular TCE.
    Tiles visible on default view
    Tiles visible on full screen view
    First two tiles when voyage has offhire

    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.

    Find the corresponding Internal Business Partner of the operating company and click Confirm.
  • The system will create two additional cargoes with Company and Counterpart automatically assigned.

  • Spot

    External charterer

    Owning company

    Internal

    Owning company Internal Business Partner

    Operating company

    Internal Relet

    Operating company Internal Business Partner

    Owning company

    This is a list of voyages on the opened vessel sorted by newest first. Clicking the icon will bring up a modal to customize which columns are visible. If there is an ongoing voyage in the list, it is indicated with a blue marker on the left side.
    The ongoing voyage (5) is marked by the solid deep blue bar on the left, while the selected voyage (6) is highlighted in blue.

    Below, you will find a list of either Port Calls or Bunkers, and a button to toggle between the two different views.

    hashtag
    Port Calls

    While in Port Call view, clicking on a voyage row will list all port calls of the selected voyage, as well as the port calls from the previous and next voyage, if they exist. The port calls from the previous and next voyage will be in a slightly lighter colour, such that it is possible to tell them apart. Clicking directly on the reference number of the voyage will open up the Voyage drawer.

    Clicking on port calls in the list opens the corresponding port call's drawer where you can make can changes:

    The Port Calls list will display up to 30 items, and includes a separate scrolling functionality. By hovering over each of the "headers" (such as Voyage, Port, Reason for Call, etc.), you can also see an sorting array which will make you able to sort that specific column in either an ascending (ASC) or descending (DESC) order.

    Port Calls of the previous, selected, and next voyage

    hashtag
    Bunkers

    The Bunkers view removes the list in favour of up to three collapsible sections for the voyages. Similarly to the Port Calls view, clicking on a voyage row in the voyages list will select/open up the corresponding collapsible section, and fetch the data for the previous and next voyage:

    Bunker consumption overview for the previous, selected, and next voyage.

    The top band of the section displays 4 columns; the reference number of the voyage, Opening Balance, Consumption and Closing Balance. Each of the latter three will show amount and price for up to 4 different bunker types, depending on which bunkers are actually being used by the vessel.

    On this voyage, only FO and LS MGO has been consumed, so the balances and consumption columns only displays information for FO and LS MGO.

    Expanding the collapsible section will give you a table overview of each port, with reason for call, distance, speed etc., as well as a detailed breakdown of the bunkers consumed. Only the bunkers actually used will be displayed here.

    On this voyage, only FO and LS MGO has been consumed, so the breakdown also only displays information for FO and LS MGO.

    Filtering

    The bunker section can be filtered by bunker category to get a better overview for each category.

    hashtag
    Resequence Voyages

    The resequence feature enables re-ordering the list of voyages assigned to a vessel. To utilize the feature, click the icon in the top right of the voyages list. This will bring up the Resequence Voyages modal.

    The user can now drag and drop the voyages to re-order them into the desired order. For example, the screenshot below illustrates voyage 7, which is being dragged down. It is expected that the item will have replaced voyage 6 after release:

    Swapping voyage 6 and 7.

    Any voyages that will have their sequence number changed, will have their previous old sequence number parenthesized.

    Clicking the Resequence button will update the fleetplan.

    hashtag
    Resequence Port Calls

    Port calls can also be resequenced to a different position within the previous, current, or next voyage. To resequence a port call, click the resequence symbol in the top right corner of the port calls list. A popup modal will then show and the port call can be dragged and dropped in the desired position (see screenshot below). Note that only one port call can be moved at a time. Also, only port calls after the last Arrived, Berthed or Departed port call can be moved in the list:

    Resequence the port calls

    Collasped Vessel Details section
    Expanded Vessel Details section
    This section show you a list of all document lines that have not yet been assembled. Clicking on any of them allows you to edit some of the fields. Selecting one or more document lines will allow you to assemble them into a Document:
    A document line has been selected, and the Assemble button appears

    From this view, you can also open up the linked Business Partner and/or the linked TC Out Contract (if a TC Out voyage).

    If a TC In Contract attached, you can open it from the Hire Payable view.

    hashtag
    Invoices section

    The invoice-section shows a list of all assembled invoices, or their line items. When in the toggle-button is set to Receivable or Payable, only the invoices connected to the voyage are shown. However, when set to Hire Payable, all invoices associated with the TC In contract are displayed, and an additional column for Voyage Reference is added that indicates the voyage(s) billed within each invoice.

    Clicking on an invoice will open a Document drawer, showing more details and allowing you to print them.

    In the top right corner of the section, you will find a "View Line Items" button. Clicking it will change between displaying the assembled documents and their data, and displaying each individual document line. This may be useful if you are looking for a specific item, but don't know in which document it was assembled. The line items list has filters specific to this mode. Clicking one of the document lines will open the Document it belongs to in a new drawer.

    Use the filters to quickly narrow down your selection. Depending on whether you are in Receivable, Payable or Pending Payable mode, as well as Document or Line Items view, the available filters change.

    The invoicing list of the voyage/TC In, displaying the documents.
    The invoicing list of the voyage, displaying the document lines for the invoices.

    hashtag
    Filters Overview

    Document view
    Document Lines view

    Business Partner

    Account

    Currency

    Currency

    Voyage Reference (Hire Payable Only)

    Cargo/Voyage Reference

    Invoice Status

    Port

    Business Partner

    circle-info

    Read more here: Invoices

    Changing between these will change which pending items are displayed, as well as assembled documents.
    hashtag
    Table header

    The table column header shows the voyage reference number, the vessel and a chip telling you what kind of voyage it is.

    Clicking the copy icon will create a copy of the voyage, and add it to the comparison. Clicking on the remove icon will remove the voyage from the comparison. To open up the voyage drawer of any of the voyages in the comparison, click on the blue voyage reference.

    Add new voyages to the comparison by using the big grey button in the right-most column. This will open a dropdown, allowing you to add an existing voyage in the system, or create a brand new one.

    Table header for a comparison with three different voyages, and a button to add new voyages to the comparison.

    hashtag
    Categories

    To the left, rows are grouped into the following categories: Profit/Loss, Voyage, Revenue, Voyage Cost, Bunker Cost, Hire Payable/Freight Cost and Comment.

    The Bunker Cost group will display the two primary bunkers

    hashtag
    Comparison comment

    At the bottom of the comparison screen, there is a comment section for the comparison as a whole.

    hashtag
    Tooltips

    Certain values in the comparison rows are composed of several different numbers. Depending on the type of the voyage, this may be different. Hovering over a row will display a tooltip showing each individual number.

    For Spot voyages, "Other Voyage Costs" is defined as the sum of Despatch, Handling Cost, ILOHC and Various Cost.

    hashtag
    Split fields and contextual rows

    Several rows contain split fields, each displaying different data points. An example of this is the Address and Broker commission row. In this case, the left-most cell will contain the first value (Address commission), and the right-most will contain the last (Broker commission).

    A split field displaying a 1.25% address commission (left), and a 1.25% broker commission (right).

    Contextual rows displays values that changed based on the context. In these cases, the cell includes a small label to the left, informing you of the source. An example of this is the Main Revenue row. For spot and relet voyages, the main revenue will be the freight. For a TC voyage, the main revenue will be hire.

    A contextual row, displaying a different number in the cell for each column. In the left-most column, a spot voyage showing freight. In the right-most column, a TC voyage showing hire.

    hashtag
    Editing the voyages

    You can make changes to the voyage directly from the comparison tool, by clicking into a cell and editing the value. This will cause a re-calculation of the voyage, and the changes will immediately be reflected. Cells which are not possible to edit are greyed out.

    Alternatively, you can open the full voyage drawer by clicking the voyage reference and making your changes there.

    Freight Rate
    and
    Rule
    field in the
    section will be uneditable. Rule will also be changed to Rate.

    To add another tier, click the icon in the top right of the list. This will bring up the modal to create a new tier. Enter the quantity from which this tier will be valid.

    To delete one or more tiers, click on the checkbox mark on the left side of the list. Doing so will bring up the button to delete the tiers. Clicking on the button will bring up a confirmation modal.

    Main Cargo Details

    Reason For Call

    Yes

    If Dry Dock is selected, an Offhire record will be created.

    Port Cost

    No

    Only available if Reason For Call is set to Bunkering or Extra Port.

    Days Extra In Port

    No

    Only available if Reason For Call is set to Bunkering or Extra Port.

    Offhire Start Date

    Yes (If enabled)

    • Only available if Reason For Call is set to Dry Dock.

    • Voyage Start Date will automatically be locked and set to the selected Offhire Start date.

    Offhire End Date

    Yes (If enabled)

    • Only available if Reason For Call is set to Dry Dock.

    • Must be after Offhire Start Date.

    Find the cargo
    Action menu
    A vessel has been selected, and the voyages on that vessel is displayed
    A voyage has been selected. The cargo port Trondheim will be linked to the existing Trondheim discharge port, while new port calls for Rotterdam and Bergen will be created.

    Main Vessel Description

    This tab contains the main vessel information, such a Vessel Description, Dimensions, Miscellaneous Capacities, Machinery, Contact Details, Cargo Capacity & Loadline Information

    All of the mentioned fields are optional to add into.

    hashtag
    Vessel Description

    Field
    Description/Note

    hashtag
    Dimensions

    Field
    Description/Note

    hashtag
    Miscellaneous Capacities

    Field
    Description/Note

    hashtag
    Machinery

    Field
    Description/Note

    hashtag
    Contact Details

    Field
    Description/Note

    hashtag
    Cargo Capacity

    Field
    Description/Note

    hashtag
    Loadline Information

    For each Draft, DWT and Immersion, you can add/edit for Summer, Winter, Design, Fresh, Tropical, Tropical Fresh and Unit.

    Find Voyages

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

    The "Voyages" module can be located from the left side menu.

    hashtag
    Available Columns

    Column
    Note

    hashtag
    Sorting and Filtering

    There are several options available for you to narrow down what you see in the list view, as well as the ability to toggle which columns are displayed (with the setup).

    For sorting, look for the arrow to the right of the column headers. For filtering, you can use the quick filters provided above the Voyage List, or look for the -icon, also to the right of the column headers.

    hashtag
    Search Bar

    You should also be able to search the whole list, by using the Search Bar functionality provided at the top of the list:

    In this particular list, you are able to search for a voyage's reference no., a vessel, a counterpart or charterer, a port name, a cargo reference or trade. The list will update accordingly.

    Change Voyage Status

    From the Voyage drawer it is possible to change the status of the voyage by using the status chip next to the reference no at the top of the drawer.

    hashtag
    "Forward" Status Transitions:

    hashtag
    From Estimate to Allocated

    When changing status from estimate to Allocate, no modal will show. The same also happens from Estimate to Unallocated. You can check out the different requirements and validations below.

    hashtag
    From Estimate or Allocated to Nominated

    When changing status from Estimate to Nominated, the following modal will show:

    If it's a TC voyage with missing Laycan on the TC, you will have to fill in the Laycan as well. Otherwise, you will get information at the bottom of the modal saying which cargoes does not have Laycans added, but you will be able to nominate.

    As you can see, Company and Business Unit field is required. By default, what is selected on the voyage will display here, but you are free to change it. You can also add Responsible Charterer, Responsible Operator and Responsible Accountant, but these are not required.

    The same also happens when changing from Allocated to Nominated.

    circle-info

    The nominating process will also change the booking status of all of the cargoes on the voyage to 'Clean Fix'.

    You can check out the different requirements and validations below.

    hashtag
    Other

    There are also other "forward" status transitions, like:

    • Nominated -> Operational

    • Operational -> Operationally Closed

    • Operationally Closed -> Invoiced

    • Operationally Closed -> Closed

    circle-info

    Some customers sometimes prefers other names of the mentioned statuses.

    E.g. "Operationally Closed" can be called "Sailed" or "Demurrage Checked".

    hashtag
    "Backward" Status Transitions:

    hashtag
    From Nominated to Allocated

    When changing to these statuses, no modal will show.

    hashtag
    From Allocated to Unallocated

    When changing status from Allocated to Unallocated, the following modal will show:

    You will be given the option to select a new Vessel and/or Ballast Port to change to, but not required for unallocating.

    The same also happens when changing from Nominated to Estimate.

    hashtag
    From Unallocated to Estimate

    When changing to these statuses, no modal will show.

    hashtag
    Other

    There are also other "backward" status transitions, like:

    • Operational -> Nominated

    • Operationally Closed -> Operational

    • Invoiced -> Operationally Closed

    • Closed -> Invoiced

    hashtag
    Different Requirements and Validations:

    hashtag
    Missing Fields

    Required Values Must Be Set:

    • For each cargo: charterer

    • For each cargo: commodity

    -> This can be seen for most "forward" status transitions.

    hashtag
    Update the Vessel Code

    Vessel code must be changed from its default assigned value. Open Vessel "Internal Data" to set a new code.

    -> This can be seen for most "forward" status transitions.

    hashtag
    Change of Ballast Port

    Warning

    The ballast port on this voyage does not match the open position of this vessel. Do you want to <status> the voyage with the start date locked?

    -> This can be seen for most "forward" status transitions.

    circle-exclamation

    Through the API, there are some forward- and backward transitions that are not possible to set directly, e.g. NOM -> SCU, it has to be NOM -> SCH, then NOM -> SCU.

    hashtag
    Status Transition Snapshots

    In the Voyage drawer, in the left-most P&L Summary section, you have this Analysis button:

    This is only enabled after Estimate status. In this , you can display the voyage snapshots created, above the tables:

    From version 8.15, all between 'Estimate' to 'Nominated' statuses gets a new voyage snapshot created. It will be in the format as shown in the above marked text, e.g. for transition Estimate -> Unallocated, it shows the text "Estimate/Unallocated" along with the created date and time (which is when you did the transition).

    By default, you will be displayed the latest snapshot created as selected, but when opening the dropdown menu, the snapshots are listed in an ascending order, which you are free to choose from. Selecting a snapshot will automatically display the corresponding values in the below analysis tables:

    In the above example, you can e.g. see two instances starting with "Estimate", meaning there has been a before that last instance, but we don't create snapshots for those.

    You can also have multiple instances of the same transition, which then usually occurs at different dates and/or times.

    hashtag
    Preliminary

    We still create 'Preliminary' snapshots from when a voyage is set to 'Nominated' status, which remains if the status becomes higher (e.g. 'Operational'). This will both be displayed as default selected snapshot and is in the dropdown menu. Whenever the status changes away from Nominated (or higher) status, the Preliminary instance will disappear from the dropdown (while the other snapshots created will stay), as this is strictly only for Nominated and above statuses.

    hashtag
    Daily Snapshots

    The Daily Snapshots are still in order as is and is created every day, as usual. In , you can still specify the daily "Voyage Snapshot Creation Time" in GMT. This still applies for statuses that are not 'Estimate', 'Unallocated', 'Allocated' or 'Closed'.

    hashtag
    Open Snapshot Drawer

    You can open a Voyage Snapshot drawer by clicking the icon in front of the snapshot text. The statuses are "Closed" and "Snapshot" if a transition snapshot, or "Closed" and "Preliminary" if Nominated (or higher) snapshot.

    Alternatively, in a Nominated (or higher) voyage, you can in the Overview tab click on in top-right drawer, to select "Open Preliminary Voyage' secondary action.

    hashtag
    Create a Snapshot

    You can manually create a snapshot by clicking the below button:

    You cannot create a snapshot when the voyage has status 'Estimate', 'Unallocated', 'Allocated' or 'Closed'.

    circle-info

    Read more about Status Transitions .

    Cargo

    This tab shows a list of the cargoes and fixtures on the voyage.

    hashtag
    Cargoes

    The Cargoes list shows a list of all cargoes on the voyage. The list can be filtered on Port (the list displays the first Load- and Discharge Cargo Port, but the filter works any Load- and Discharge ports on the Cargo), Charterer and Commodity by using the quick-filters in the top right.

    On the row at the bottom of the list, you can see the Total Amount of cargo quantity on this Voyage:

    Cargoes List

    Clicking the -icon will bring up a dropdown menu for choosing between creating a brand new Cargo, or a new Cargo from a CoA template.

    By clicking the icon you can edit the columns shown in the list, rearrange the columns and even enable showing of some columns that are unchecked by default.

    Clicking the icon will export the table to a spreadsheet-format, which can be opened in e.g. Excel or Numbers.

    hashtag
    Fixtures

    Adding fixtures can be done in the Cargo tab of the Voyage Drawer by selecting the Fixtures button and clicking the create icon above the list.

    The tab allows you to create, edit and delete any fixtures on the voyage.

    hashtag
    Field Choices When Creating

    • Counterpart (*)

      • Which cargoes to connect to the fixture (based on which Counterpart is chosen)

      • Disabled after connected to a fixture

    (*) - required fields

    hashtag
    Modal & List Features

    Click on each tab below to read more about the different features:

    You can see the Total Amount of all number fields, such as Cargo Quantity, Freight Rate and Freight Amount Currency, at the bottom of each table.

    See the expanded/collapsed features below.

    By clicking at the Create icon, you will be able to create a fixture containing cargoes of the same Counterpart.

    The Cargoes list at the bottom is empty by default until you have chosen a Counterpart.

    hashtag
    Fields on the Fixtures

    One fixture is equivalent to the blue area that wraps around the cargoes within it, and containing fields in the section header. Here is a list of them:

    • Counterpart

    • Fixture Reference

    • Fixture Date

    • Fixture Form

    hashtag
    Extra Features

    The fixtures list has a separate button to collapse/expand the cargo list of all the fixtures with one click as shown below:

    You can also collapse/expand each fixture by clicking on the blue header, or the arrow at the right-most.

    Create Cargo by Importing from Excel

    hashtag
    Import Button

    From this version, you can now can create cargo(es) by uploading/import straight from an Excel worksheet. In the Unallocated cargoes list, you can click on this import button:

    Unallocated cargoes list with the Import button

    hashtag
    Import Cargoes from Excel

    Then, you can follow these steps:

    1. Click on the Import button displayed above

    2. A modal (or "dialog box") will pop-up:

    All the fields are disabled until you upload/import a supported file (only .xlsx and .csv files). You can only import one file at a time, but one file can consist of many cargo rows!

    1. You can proceed by clicking the blue Upload File button.

    2. After choosing a supported file from you computer, you can view the filename to the right of the Upload File button, along with a "preview screen" below all the now-enabled fields:

    All the required fields (*) must be filled in this step. As you go along with choosing the different fields from the dropdown menus, the "preview screen" will mark with a light-blue highlight on the fields have been selected. Meaning, you could upload your own customized Excel sheet with various header- and cell values, but you can then in the modal pick-and-choose which fields you actually want on the cargo, when creating it.

    circle-info

    Tip: it might be a good idea to change/create Header values in your Excel sheet by matching them to what we display in the above modal. E.g. Counterpart, Commodity, Cargo Quantity, Load Port, etc.

    Remember that only the first row of your Excel sheet are the Header values! The rest are the cell values within their respective columns.

    1. After choosing the different values into the fields, and you are full-filling all the below, then you can go ahead and create the cargo by clicking Import

    2. You should now be able to see your newly created cargo at the top of the Unallocated cargoes list

    hashtag
    Validations before Creating

    We have two different types of validations in this modal. Either one, or both, of them will show up at the bottom of the modal, if encountering any inconsistencies while uploading:

    (1) One is yellow-colored, and shows inconsistent data types in the cells of your Excel sheet:

    This particular validation highlights the "Planned BL Date" column, and detects that two or more cells has inconsistent values within this column. E.g. one cell is read as a number value, while two cells are read as date values. In this case, the number-cell should be changed to a date value, so that the modal can read it properly as a date value. Make the change in your Excel sheet, and then re-upload the file.

    This validation can highlight multiple columns with inconsistencies in data types, and not just one at a time.

    (2) The other one is red-colored, and shows Reference or Master Data inconsistencies, i.e. data errors in your Excel sheet:

    This particular validation highlights the "Commodity" column, and detects that "Row 2" within this column has a commodity named "Bananas" that does not exist in the system. In this case, you have two options:

    a) replace "Bananas" with an existing Commodity in your Master Data, in your Excel sheet, and then re-upload the file

    b) create a new Commodity "Bananas" in your first, and then re-upload the file.

    This validation can highlight multiple columns and rows with inconsistencies in Master Data or references, and not just one column and/or row at a time.

    hashtag
    Requirements for Importing

    Before actually creating a cargo by importing from an Excel worksheet, these requirements must be full-filled:

    • A supported Excel file must be uploaded/imported (only .xlsx and .csv files)

    • All required fields (*) must be filled in with supported values

    • No data types inconsistencies

    Once all of these requirements are full-filled, the Import button will be enabled, i.e. blue-colored, and you can then go ahead and create the cargo!

    Cargo Drawer

    hashtag
    Header

    When you open the cargo drawer you see on the top left the vessel and voyage the cargo is allocated to, if it is an allocated cargo. You can click both chips to open the vessel drawer or the voyage drawer.

    Next you see the cargo reference, which is a unique identifier of the cargo. You can under the three dots.

    Then you see the cargo status and can .

    Open-loop

    Int'l NRT

    Panama Net

    Suez Net

    Vessel Type

    DWT (Summer)

    Deadweight in the summer

    Built

    Yard

    Flag

    IMO No.

    Owner

    Owner of the vessel (type Business Partner), available from v7.7

    Scrubber Fitted

    Beam

    LOA

    LPP

    Depth

    Air Draft

    Int'l GRT

    Capacity Fo

    Fresh Water

    Ballast Water

    Constant Reduction

    Main Engine

    Aux Engine

    Bow Thruster

    Stern Thruster

    Shaft Generator

    Call Signal

    Phone Number

    Deadweight in the summer

    Fax Number

    Mobile Phone

    Email

    Telex

    Cubic Capacity

    Deck Capacity

    Bale Capacity

    Gear

    Holds/Hatches

    Grabs Onboard

    CP Date

    Shows the CP date of the Performance Cargo or TC

    Status

    Commodity

    Shows the Commodity of the Performance Cargo

    Responsible Charterer

    -

    Comments

    -

    Cargo Operator

    Shows the Cargo Operator of the Performance Cargo.

    Hidden by default.

    Freight Rate

    Shows the Freight Rate of the Performance Cargo.

    Hidden by default.

    Cargo Quantity

    Shows the Cargo Quantity of the Performance Cargo.

    Hidden by default.

    Creator

    Hidden by default.

    Created Date

    Hidden by default.

    Planned BL Date

    Shows the Planned BL date of the Performance Cargo. Hidden by default.

    Cargo Reference

    Shows the Cargo Reference of the Performance Cargo. Hidden by default.

    Laycan From

    Shows the Laycan From date of the Performance Cargo. Hidden by default.

    Laycan To

    Shows the Laycan To date of the Performance Cargo. Hidden by default.

    Counterpart

    Shows the Counterpart of the Performance Cargo, or Charterer of the TC

    Vessel

    -

    Route

    Shows first and last Port Call ports

    TCE

    -

    Type

    -

    Reference Number

    The Voyage's Reference No.

    Trade

    sorting and filtering
    customised columns
    Search Bar in Voyages List

    -

  • Invoiced -> Closed

  • Analysis view
    forward transitions
    backward transition
    System Settings
    here
    Nominate Voyage Modal
    Unallocate Voyage Modal
    Analysis button to open up Analysis View
    Top of the Analysis View section, voyage snapshots marked
    Voyage Snapshot dropdown menu
    Create a Snapshot Voyage
    Will override the connected cargoes' Counterpart
  • Fixture Reference (*)

    • Is a running number (from v7.13)

    • Only editable, cannot set it

  • CP Date

    • Disabled after connected to a fixture

    • Will override the connected cargoes' CP Date

  • CP Form

  • Lumpsum

  • Fixture Currency

    • Defaulted at the Voyage Currency

    • Disabled after connected to a fixture

    • Will override the connected cargoes' CP Date

  • Selecting a Counterpart will show all cargoes connected to the Counterpart, allowing you to select the ones you want within the fixture.

    The selector is also limited to the existing Counterparts on the voyage cargoes.

    You are not able to create until you have selected a Counterpart and at least one cargo from the list at the bottom.

    Note that these features act a bit different than on the Edit Fixture Modal!

    Edit Fixture Modal

    Clicking the Edit icon will open up the Edit Fixture modal, where you can change fields and select more or de-select cargoes.

    The cargoes list at the bottom has pre-selected cargoes of the Counterpart you want to edit, by default. All cargoes connected to the Counterpart selected will show up in the list, along with the pre-selected ones. This gives you the opportunity to either add more cargoes to, or remove from, the selected fixture.

    Another feature is that you can override the Counterpart. Then this change will reflect on all the selected cargoes. The Counterpart selector is not limited this time around.

    You will also be able to edit the Fixture Reference in this modal, which is a running number by default.

    Total Quantity

    • sum of the cargoes' weight on a fixture

  • Total Freight Voyage Currency

    • sum of the cargoes' freight, plus the fixture lumpsum, on a fixture

    • the currency is for now always shown in Voyage Currency

  • Fixtures List
    Create Fixture Modal
    Expanded View
    Collapsed View

    No Master Data inconsistencies

  • No duplicate cargo references, or references to existing cargos

  • requirements
    Master Data
    Modal for importing unallocated cargoes form an Excel sheet
    Modal after choosing a supported Excel file
    Inconsistent data types validation message
    Inconsistent reference or Master Data validation error message
    You also see the Cargo Type, and Cargo Subtype if applicable, which is automatically set by the system.
    Top section of a preshipment cargo, which has cargo type spot and cargo subtype preshipment
    Cargo Type
    Meaning

    Spot

    Standard cargo, which fulfills none of the conditions below

    Contract of Affreightment (CoA)

    Cargo which is connected to a contract of Affreightment

    Cargo Subtype
    Meaning

    Relet

    Cargo with a Freight Cost

    Preshipment

    Freight Cost Cargo related to a transshipment before loading

    Transshipment

    Freight Cost Cargo related to a transshipment after discharging

    Has Transfer

    First part of a cargo that is transported on two voyages

    Transfer

    Second part of a cargo that is transported on two voyages

    If the cargo has type , you will see the Contract Name it is connected to and can click the Name to open the CoA drawer.

    hashtag
    Tabs

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

    hashtag
    Actions

    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 the cargo to move it to a voyage, change the voyage it is on or remove it from the current voyage.

    You can delete a cargo.

    You can relet a cargo to another owner.

    You can convert the cargo to relet to change the cargo to be a freight cost instead of freight revenue.

    You can add a Transhipment, Preshipment or Transfer of the cargo.

    You can also connect the cargo to a CoA and remove the CoA connection when connected.

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

    edit the cargo reference
    change the cargo status
    Top section of cargo drawer

    Main Details

    hashtag
    KPIs

    KPI Tiles in Cargo Main Details tab

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

    • First tile: Cargo quantity is the actual quantity, and booked is the booked quantity.

    • Second tile: Gross freight is the total freight for the cargo.

      • Overage is calculated for cargos with Booking status "Clean Fix" or "Loaded" when both the Overlift Quantity and Overage Rate are greater than zero.

      • Deadfreight is calculated for cargos with Booking status "Clean Fix" or "Loaded" when both the Overlift Quantity is less than zero and Deadfreight Rate is set.

    • Third tile: Commission and various costs.

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

    hashtag
    Main Cargo Details

    Below the KPI tiles is the Main Cargo Details section on the left side:

    hashtag
    Additional Field Explanations:

    Field name
    Explanation

    All fields that are enabled can be changed from this view. The following fields will be disabled under the following conditions:

    hashtag
    Overview of Fields:

    Field name
    Disabled when

    hashtag
    Stowage

    Below Main Cargo Details section, there is a section for inputting fields and checkboxes regarding the stowage values of the cargo:

    circle-info

    If the optional preference SF_INTAKE_CALCULATION is enabled on your company's system, stowage factor will change from being System Volume Unit / System Weight Unit, to Cubic Feet / System Weight Unit

    hashtag
    Cargo Port Timeline

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

    To add a cargo port, click on the -icon in the top right corner. To edit or delete a cargo port hover one of the cargo ports in the timeline and the below view will appear:

    hashtag
    Create Cargo Port modal

    It is required to specify the port and the reason for call (only restricted to Loading and Discharging from this view). Then you can choose to fill in other necessary fields, or edit them later. The right-hand side of the "timeline" illustrates the already scheduled port calls of the voyage, while the left-hand side illustrates the cargo port you want to add (only one at time).

    If you in this case would want to add another cargo port "BERGEN" with the same reason for call "Loading", then this will be linked to the port call:

    However, changing this reason for call to "Discharging" will make the timeline interpret this as a new cargo port:

    The same behaviour would have happened with another cargo port, that weren't already in the schedule. All new cargo ports from this view will also create a new matching port call in the Voyage schedule.

    hashtag
    Drag & Drop functionalities:

    • you can use the = symbol on the left-hand side to drag-and-drop the newly added cargo port, e.g. Bergen, to match it to another Bergen, with the same reason for call, within in this timeline view. Available in:

      • Create Cargo Port modal

      • Edit Cargo Port modal

    hashtag
    Where to find Create Cargo Port:

    You can find this modal from these views:

    • Cargo Drawer -> Overview tab -> -icon from Cargo Port Timeline section

    • Voyage Drawer -> Overview tab -> -icon behind the cargo ports, at the top of the Cargo section (non-TC voyage)

    • XXL Voyage drawer -> Overview tab -> -icon of the Cargo Ports table

    hashtag
    Edit Cargo Port modal

    Editing a Cargo Port will give you access to a few more fields, for instance Handling Cost, Laytime Terms, etc.:

    circle-info

    If the Vessel Type of the Vessel used for the Voyage has "Free Despatch" ticked off, any newly created Cargo Ports will have "Free Despatch" ticked off as well.

    circle-info

    In this view, you can only edit/update the cargo port you have selected from the "Cargo Port Timeline" view.

    hashtag
    Ship To Ship indicator:

    Checking the "Ship to Ship" checkbox in the Edit Cargo Port modal will mark that cargo port as being ship to ship. A chip on the cargo port timeline will appear displaying this, to quickly identify which cargo ports on the timeline are Ship to Ship:

    This chip is also visible for the connected port call, on the Voyage Schedule.

    hashtag
    Where to find Edit Cargo Port:

    You can find this modal from these views:

    • Cargo Drawer -> Overview tab -> pencil icon on hover on each cargo port on the Cargo Port Timeline section

    • Voyage Drawer -> Overview tab -> by clicking on the cargo port links at the top of the Cargo section (non-TC voyage)

    • XXL Voyage Drawer -> Overview tab -> the open icon on the left-most column of each cargo port row, within the Cargo Ports table

    hashtag
    Bunker Adjustments

    On the right side, below the Cargo Port Timeline section, you can create/edit and view a list of Bunker Adjustments on the cargo:

    You can create a new Bunker Adjustment by clicking the -icon at the top right of the section, which will bring you to the Create-modal. Or you can click on one of the rows to edit the selected Bunker Adjustment, which will open the Edit-modal. If you choose the Adjustment Type to be set to "Freight", you will only see the Adjustment Factor field below. But if you have chosen "Consumption", you will only see the Agreed Consumption field below (the invisible field is not editable and does not affect the calculation). The Freight type is chosen by default.

    For both of these options you will be able to choose the bunker types: DL (LS MGO), DO (MGO), FL (LS FO) or FO. You can also input/edit the other fields, such as: Min Price, Max Price, Adjustment Factor/Agreed Consumption and Price. The Price field is still editable even though the input of the Min-/Max Price fields calculates the average price.

    The total adjustment is calculated if the price is outside the minimum/maximum range, i.e:

    • Min range: 500, Max range: 550, Price: 600 => Positive adjustment

    • Min range: 500, Max range: 550, Price 400 => Negative adjustment

    This calculation you can see as the price value in the second KPI tile by the last field called Bunker Adjustment:

    hashtag
    Overview of BA Fields:

    Fields
    Description

    hashtag
    Miscellaneous

    On the right side, below the Bunker Adjustment section, you can enter the below fields:

    hashtag
    Additional Field Explanations:

    Field Name
    Explanations

    hashtag
    Relets and Transshipments

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

    Difference between Cargo Quantity and Minimum Quantity, negative value indicates DeadFreight and positive value indicates Overage. You can override the value by entering a new one but later changes to Cargo Quantity or Minimum Quantity will trigger recalculation.

    Overage Rate

    Percentage of Freight Rate. On allocated Cargos, the value is defaulted from the default rate of the VesselType.

    Flat Rate

    Rule is not set to "World Scale"

    Tolerance

    Tolerance Option is not set to "MOLCO" or "LCOPT"

    Broker Commission

    The Cargo has one or more Commissions connected to it

    Demurrage Rate

    One or more of the Cargo Ports have a demurrage rate

    Despatch rate

    One or more of the Cargo Ports have a despatch rate

    Performance Cargo

    The Cargo does not have a Voyage connected to it

    you could, also in this view, drag-and-drop a matching cargo port-port call pair either further up or down in this timeline to change the order. You will see a "hand" icon when hovering over these pairs of the timeline. Available in:

    • Create Cargo Port modal

    If the Port Call for this Cargo Port has 'Use Handling Cost from Service Order' checked off, the handling cost related fields will be disabled.

    Agreed Consumption, Mandatory(*), displays if Adjustment Type is set to 'Consumption'

    Price

    The price, Mandatory(*)

    Booked Quantity

    Quantity agreed in charter party (available when cargo status is before Clean Fix).

    B/L Quantity

    Sum of the quantities on all load cargo ports (available for cargo status Clean Fix and Loaded).

    Use Max Intake

    When enabled the system will automatically use the maximum cargo quantity the ship can load based on weight, volume or, if the tolerance option is MOLOO, commercial max. SeeAutomatically set cargo quantity to max intake for more info.

    Freight Rate

    Weighted average of freight rates on the discharge cargo ports.

    Deadfreight Rate

    Is set to Freight Rate value when creating a new cargo, or copying a cargo, by default. The field can be changed to a desired value after creation.

    Boooked Quantity/BL Quantity

    The Cargo has one or more SubCargos, or if there are load/discharge amount on CargoPorts that are not the first in the timeline.

    Minimum Quantity

    Tolerance Option is not set to "MOLOO" or "LOO"

    Cargo Measurement

    The Cargo has one or more SubCargos, or if there are load/discharge amount on CargoPorts that are not the first in the timeline.

    Freight Rate

    The Cargo has one or more SubCargos, or the CargoPorts have different freight rates, or the Cargo has multiple freight rate tiers.

    Rule

    The cargo has one or more freight rate tiers.

    Adjustment Type

    Adjustment types, Mandatory(*), defaulted by "Freight"

    Bunker Type

    The different fuel types, Mandatory(*)

    Min Price

    Minimum price range, Mandatory(*)

    Max Price

    Maximum price range, Mandatory(*)

    Adjustment Factor

    Adjustment Factor, Mandatory(*), displays if Adjustment Type is set to 'Freight'

    Benchmark Index

    Retrieved from "Market Indices" module, for category code = TC.

    Shown in the format: "Market Index Name, Market Index Code".

    Used to compare current business with the index.

    Index Adjustment Pct

    The Index Adjustment in % is an adjustment of the index. All numbers are valid.

    Parcel Factor Pct

    Is a manual input for Exposure calculation with respect to parcel business forward in %. Valid range is from 0 - 100.

    Main Cargo Details section of a cargo that is not marked as clean fix
    Main cargo details section of a cargo marked as clean fix
    Stowage Section
    Stowage Section
    Cargo Port Timeline section
    Add, edit or delete a cargo port
    Create Cargo Port modal
    Bergen loading port matched with the port call
    New Bergen discharging port created
    Edit Cargo Port modal
    Edit Cargo Port modal with handling cost fields disabled
    Cargo Port timeline where the Bergen cargo port is marked as being Ship to Ship
    Bunker Adjustments Section
    Create/Edit Modal For Bunker Adjustments
    Bunker Adjustment in Cargo KPI Tiles
    Miscellaneous Section
    Relets and Transshipments Section

    Overlift Quantity

    Agreed Consumption