Knowledge Base
About DataloyRelease NotesAPI DocumentationJava VMS Documentation
Release 8.6
Release 8.6
  • Knowledge Base
  • Voyage Management System
    • VMS: Step-By-Step Guides
      • Vessels
        • Create Vessels
        • Copy Vessel
        • Find Vessels
        • Voyages & Port Calls
        • Main Vessel Description
        • Speed & Consumption
        • Load & Discharge Rates
          • Manage Load And Discharge Rates
        • Internal Data
        • AIS & Weather Reports
        • AIS-subscription
        • View Vessel Route from Previous Port to Next Port
      • Voyages
        • Canal Allowances
        • Create New Voyages
          • Create Voyage Charterer
          • Create Time Charter Out
          • Create Voyage From Template
          • Create Voyage Without Cargo
        • Find Voyages
        • Maintain Voyages
          • Overview
            • Vessel
            • Cargo
            • TC
            • Schedule
            • Profit/Loss Summary
              • Analysis
            • Speed & Consumption
          • Cargo
          • Bunkers
          • Various Cost/Revenue
            • Create, Edit & Delete Various Cost/Revenue
            • Search and Filter Variouses
            • Various Rule: "Fixed Quantity"
          • Organisational Data
          • Invoices
          • Downtimes
          • Related
          • Voyage Functionalities
            • Converting Voyage to Template
            • Change Voyage Status
            • Swap Vessel
            • Configure Voyage as a “Last TC Voyage”
            • Change Voyage Reference Number/Voyage Number and Voyage Starting Year
            • Voyage Comparison
        • TC Voyages
        • Create Laytime Calculations
        • Delete Voyages
        • Voyage Map
        • Voyage Schedule
        • Voyage Edit Schedule
        • Voyage Alternative Routes
        • Voyage Functions
          • Sensitivity Analysis
          • Intake Calculation
        • Long Time Charter (TC) Voyage
        • Voyage Bunkers
        • Voyage full-screen
          • Data grid
            • Port Calls Grid
            • Cargoes Grid
            • Cargo Ports Grid
            • Various Grid
      • Cargoes
        • Create New Cargoes
          • Create Cargo
          • Create Cargo From CoA Template
          • Create Cargo on TC Voyages
          • Create Cargo by Importing from Excel
          • Create Cargo From Existing Cargo
        • Find Cargoes
        • Maintain Cargoes
          • Cargo Drawer
            • Main Details
            • Sub-cargoes
            • Various Cost/Revenue
            • Commissions
            • Freight Rate Tiers
            • Payment Terms
            • Comments
          • Cargo Drawer Actions
            • Allocate Cargo
            • Change Cargo Status
            • Delete Cargo
            • Relet Cargo
            • Convert Cargo to Relet/Non-Relet
            • Transship and Preship Cargo
            • Transfer Cargo
            • Connect Cargo to CoA
            • Remove CoA from Cargo
        • Template Cargoes
        • Sub-cargoes
        • Capacity Plan
        • View Cargo History
      • Port Calls
        • Find Port Calls
        • Maintain Port Calls
          • Days Extra In Port
          • Speed Order
        • Port Call Drawer
          • Overview (And Bunkers)
            • Use Port Cost from Service Orders
              • Automating the Use (Port) Cost from Service order
            • Use Handling Cost from Service Orders
          • Service Orders
          • Bunker Orders
          • Vessel Reports
          • Port Log
            • Stoppages
        • Register Reports
          • Register Noon Reports
          • Register Arrivals
          • Register Berths
          • Register Unberths
          • Register In Port Reports
          • Register Departures
        • Custom Port Calls: 'At Sea'
      • Port Costs
        • Find Port Costs
        • Maintain Port Costs
        • View Service Orders of Port Costs
      • Contracts of Affreightment
        • Find a CoA
        • Create a CoA
        • Maintain a CoA
        • Contract of Affreightment Lines
          • Find CoA Lines
          • Create CoA Lines
          • Maintain CoA Lines
            • Template Cargoes
              • Find Template Cargoes
              • Create Template Cargoes
              • Maintain Template Cargoes
      • Time Charter Contracts
        • Create Time Charter Contracts
        • Maintain Time Charter Contracts
          • Duration and Rates
            • Create Duration and Rates
          • Notices
          • Comissions
          • Payment Terms
          • View Speed & Consumption
          • View Voyages
        • Print Statement of Account
      • Broker Commissions
        • Create Commissions
        • Find Broker Commission
        • Maintain Broker Commission
      • Bunker Orders
        • Create Bunker Orders
          • Create from a port call
          • Create bunker order from scratch
        • Maintain Bunker Orders
        • Stem Bunker Orders
        • Register Delivery Against a Bunker Order
        • Cancel Bunker Order
        • Delete Bunker Order
      • Service Orders
        • Create a Service Order
        • Maintain Service Orders
        • Handling Cost Allocation
        • Delete Service Order
      • Laytime Calculations
        • Create Laytime Calculation
        • Find Laytime Calculation
        • Delete Laytime Calculation
        • Maintain Laytime Calculation
          • Status
          • Drawer Fields
          • Manage Cargo Ports
            • Cargo Port Fields
            • Statement Of Facts
              • Event
            • Timesheet
      • Bills of Lading
        • Create Bills of Lading
        • Attachments
        • Edit Bills of Lading
        • Delete Bills of Lading
        • Print Bills of Lading
        • Print Sea Waybills
      • Downtime
        • Create Downtime
        • Find Downtime
        • Maintain Downtime
          • Status
          • Overview
          • Various Cost/Revenue
          • Delete Downtime
      • Vessel Reports
        • Find Vessel Reports
        • Create Vessel Reports
      • Voyage Analysis Dashboard
        • Log In
        • Viewing and Managing Deviated Voyages
          • Viewing and Managing Deviated Voyages
          • Viewing Post Voyage Analysis Detail
          • No Freight Received
      • Invoices
        • Invoices List
        • Pending Invoices
        • Assembling Invoices
        • Invoice Drawer
        • Printing Invoices
        • Reversing an Invoice
      • Bunker Transactions
      • Accruals
        • Accruals
          • Batch Post Accruals
          • Generate Accruals
          • Find Accruals
          • Maintain Accruals
        • Bunker Stock Adjustments List
          • Batch Post Bunker Stock Adjustments
          • Bunker Stock Adjustment Drawer
        • Actuals list
        • Time Correction list
      • Status Transitions
      • Webhook Subscriptions
        • Create Webhook Subscription
        • Find Webhook Subscription
        • Maintain Webhook Subscription
          • Overview
          • Notification
      • Setup
        • Users
          • Create Users
            • Create a Vessel Master user
          • Maintain Users
            • Change User Passwords
          • Find Users
          • Disable Users
          • Multi-Factor Authentication (MFA)
            • Guardian Multi-Factor Authentication (MFA)
        • Security Roles
          • Find Security Roles
          • Create Security Role
          • Maintain Security Roles
        • Security Groups
          • Security Group Aliases
          • Find Security Groups
          • Create Security Group
          • Maintain Security Groups
        • System Settings
          • General
          • Invoicing Preferences
        • Data Control
        • Widgets
        • API Requests
      • Master Data
        • Accounts
          • Account Mapping
        • Banks
        • Bunker Categories
        • Bunker Types
        • Business Partners
          • Manage Business Partners
        • Commodities
        • Companies
          • Manage Companies
        • Events
        • Ice Class
        • Individuals
        • Port
        • Restricted Areas
          • New Restricted Area: Mediterranean Sea (MEDECA)
          • Additional Fields: Start and End Dates
        • Routes
          • Manage Routes
        • Taxes
        • Various Costs and Revenues
        • Vessel Types
      • EU ETS Compliance
      • Fuel EU
      • Attachments
      • Audit Log
      • Bulk Update
      • Comments
      • Notifications
      • Field Validations
      • Sorting and Filtering Lists
      • Customising List Columns
      • Export to Excel Sheet
      • Widgets
    • Oracle Database Compatibility
  • Fleet Allocation & Scheduling
    • FAS: Step-By-Step Guides
      • Capacity Plan
      • Fleet Plans
        • Open Positions Board
        • Scheduler Board
        • Cargo Management Board
          • Cargo Actions
        • FAS Voyages List
        • FAS Cargoes List
        • Voyage Actions
      • Scenarios
        • Find Scenario
        • Create Scenario
        • Maintain Scenario
        • Copy Scenario
      • Budgets
        • Create Budget Scenario
        • Template Voyages
          • Create Template Voyages
          • Find Template Voyages
          • Maintain Template Voyages
        • Budgeted Voyages
          • Find Budgeted Voyages
          • Bulk Updating Budgeted Voyages
    • Create Voyages (JVMS)
      • Create Commitment
      • Create Commitment from CoA
      • Create Commitment from Voyage Estimate
  • Dataloy Distance Table (DDT)
    • About Dataloy Distances
    • Routing and routing options
    • Custom Point using Latitude and Longitude
    • High-Risk Area (HRA) / Piracy Routing
    • Distances API
    • Distances Change Log
  • Dataloy Systems AS
    • Privacy Policy
    • GDPR Statement
    • Release Notes
Powered by GitBook
On this page
  • Main Cargo Details
  • Additional Field Explanations:
  • Overview of Fields:
  • Stowage
  • Cargo Port Timeline
  • Create Cargo Port modal
  • Edit Cargo Port modal
  • Bunker Adjustments
  • Overview of BA Fields:
  • Miscellaneous
  • Relets and Transshipments

Was this helpful?

Export as PDF
  1. Voyage Management System
  2. VMS: Step-By-Step Guides
  3. Cargoes
  4. Maintain Cargoes
  5. Cargo Drawer

Main Details

PreviousCargo DrawerNextSub-cargoes

Last updated 3 months ago

Was this helpful?

KPIs

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.

Main Cargo Details

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

Additional Field Explanations:

Field name
Disabled when

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

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.

Overlift Quantity

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.

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

Overview of Fields:

Field name
Disabled when

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.

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

Stowage

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

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

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.

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.

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

  • 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

Where to find Create Cargo Port:

You can find this modal from these views:

Edit Cargo Port modal

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

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.

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

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.

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

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:

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:

Overview of BA Fields:

Fields
Description

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'

Agreed Consumption

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

Price

The price, Mandatory(*)

Miscellaneous

On the right side, below the Bunker Adjustment section, you can enter external reference, Trade, Cargo Text, Comment, Company, Business Unit and Cargo Operator:

Relets and Transshipments

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

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:

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

If the Port Call for this Cargo Port has '' checked off, the handling cost related fields will be disabled.

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.

Use Handling Cost from Service Order
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
KPI Tiles in Cargo Main Details tab
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
Bunker Adjustments Section
Create/Edit Modal For Bunker Adjustments
Bunker Adjustment in Cargo KPI Tiles
Miscellaneous Section
Relets and Transshipments Section