Knowledge Base
About DataloyRelease NotesAPI DocumentationJava VMS Documentation
Release 8.0
Release 8.0
  • 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
        • 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
          • Organisational Data
          • Invoices
          • 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
      • 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
        • Capacity Plan
        • Sub-cargo
        • View Cargo History
      • Port Calls
        • Find Port Calls
        • Maintain Port Calls
          • Days Extra In Port
          • Speed Order
        • Register Noon Reports
        • Register Arrivals
        • Register Berths
        • Register Unberths
        • Register In Port Reports
        • Register Departures
        • Use Cost from Service Orders
          • Automating the Use Cost from Service order
        • Port Call Bunkers and Overview
        • View Service Orders on Port Calls
        • View Bunker Orders on Port Calls
        • View Vessel Reports on Port Calls
        • View Port Log on Port Calls
          • Stoppages
      • Port Costs
        • Find Port Costs
        • Maintain Port Costs
        • View Service Orders of Port Costs
      • Contracts of Affreightment
        • Create Contracts of Affreightment
        • Maintain Contracts of Affreightment
        • Find Contracts of Affreightment
        • Contract of Affreightment Lines
          • Find Contract of Affreightment Lines
          • Create Contract of Affreightment Lines
          • Maintain Contract of Affreightment Lines
          • Template Cargoes
            • Create Template Cargo
            • Maintain Template Cargo
            • Find Template Cargo
      • 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
        • 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 Service Order
        • Maintain Service Order
        • 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
      • Offhire
        • Create Offhire
        • Find Offhire
        • Maintain Offhire
          • Delete Offhire
          • Copy Offhire
          • Status
          • Overview
          • Various Cost/Revenue
          • Comments
      • 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
      • Master Data
        • Banks
        • Bunker Categories
        • Bunker Types
        • Business Partners
          • Manage Business Partners
        • Companies
          • Manage Companies
        • Events
        • Ice Class
        • Individuals
        • Port
        • Restricted Areas
        • Taxes
        • Various Costs and Revenues
        • Vessel Types
      • EU ETS Compliance
      • Attachments
      • Audit Log
      • Comments
      • Notifications
      • 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
  • KPIs
  • Main Cargo Details
  • Additional Field Explanations:
  • Overview of Fields:
  • Stowage
  • Cargo Port Timeline
  • 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

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: Freight is the total freight for the cargo.

  • 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

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

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

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

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

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.

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 a cargo port or delete a cargo port hover one of the cargo ports in the timeline and the below view will appear:

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.

KPI Tiles in Cargo Main Details tab
Main Cargo Details section
Stowage Section
Cargo Port Timeline section
Add, edit or delete a cargo port
Create Cargo Port Modal
Bunker Adjustments Section
Create/Edit Modal For Bunker Adjustments
Bunker Adjustment in Cargo KPI Tiles
Miscellaneous Section
Relets and Transshipments Section