Knowledge Base
About DataloyRelease NotesAPI DocumentationJava VMS Documentation
Release 8.5
Release 8.5
  • 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
          • 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
        • Capacity Plan
        • Sub-cargo
        • 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
      • Downtimes
        • 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
      • 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
        • Commodities
      • EU ETS Compliance
      • Fuel EU
      • Attachments
      • Audit Log
      • 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
  • 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

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.

Editing a Cargo Port will give you access to a few more fields, for instance Quantity, Handling Cost, Laytime Terms and related fields. Three of the four quantity related fields, Gross Cargo Quantity, Deductions, and Net Quantity will always follow the formula Gross- Deductions = Net Quantity. Changing Gross Quantity will update Net Quantity and vice versa. Changing Deductions will update Net Quantity. The last quantity related field, Shore Quantity, is only for information and is not used in any calculations.

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.

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.

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.

Edit Cargo Port Modal
Edit Cargo Port Modal with handling cost fields disabled
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
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