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...
This is done in your java client of the VMS.
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...
Find answers to your questions...
Welcome to the main source of information on the Dataloy product suite.
Create Webhook Subscription Dialog
Open the Webhooks module in the Setup section.
Click Create Webhook Subscriptionin the top right corner.
Fill in all required fields listed below in the Create New Subscription window.
Click Create.
Field
Description
User
User to receive the notifications
Object Type
Name of the subscribed Dataloy object
Event Type
Type of event to Object
Alert Script
Subscribe to events based on the result of a DLPAlertScript.
Channel Type
Channel used to send notification
Url
Endpoint to receive the subscription
Field Conditions
A webhook subscription can only have an Object Type and an Event Type or an Alert Script. The corresponding fields are disabled to match this condition.
If the Channel Type chosen is HTTP, then the URL field must also be filled in.
When choosing HTTP as Channel Type, you can also choose whether to add the Password, Access Token or Request Access Token fields.
Webhook Subscription Panel Tab
In the Overview tab you can view details, as well as subscribe or unsubscribe to the selected webhook subscription.
In the top right corner in the Bills of Lading screen, click the createicon. You will then see a modal where you need to enter the required information in order to create a Bill of Lading.
Start typing in vessel name and select from the drop down. Once the appropriate vessel is selected you may select port call from the drop down. The port call drop down will show discharge ports and voyage reference for the selected vessel. Choose the correct voyage/discharge port.
Next you need to choose Consignee and Notify party from the drop-downs. These fields are retrieved from the sub-cargo level of a cargo. Please see screenshot below from the sub-cargo modal where the two fields for consignee and notify party is highlighted in red:
When the required fields are filled in, you select the corresponding sub-cargo(s) from the table, and click create in the Bills of Lading modal.
Select attachments in the drop-down menu
Once the attachments is clicked in the drop-down menu this modal will appear and you can drag and drop into the grey area, or simply click the grey area to browse your computer for files to add as attachments
If there are attachments they will appear in the table of the modal
Webhook Subscription Panel
When you have located a webhook subscription , click it and the details will show in a panel (so called "drawer") on the right hand side. The panel will also open after creating a new webhook subscription.
The panel contains two tabs for maintaining a webhook subscription and viewing the notifications:
Open the Bills of Lading module in the Operations section.
Open the Bill of Lading drawer.
Click the more iconat top right.
Click Delete.
Click Confirm to delete the bill of lading.
You cannot delete a bill of lading if it has status "released". You must first change the status to "not released".
Webhook Subscription Panel Tab
In the Notification tab you can view a list with the notifications sent to the selected webhook subscription endpoint.
The list is filled with the following fields:
Webhook Subscriptions List and Filters
Open the Webhooks module in the Setup section.
From the list of webhook subscriptions using filters
By using the list of webhook subscriptions that opens from the Webhooks module, you can use to find the webhook subscriptions you are looking for.
You can also use the quick filters Subscribed and Unsubscribed to find the webhook subscriptions to which the logged in user is either subscribed or unsubscribed.
Subscription to receive notifications on changes to a Dataloy object
The Webhooks module can be located from the menu under Setup.
Permissions
In order to view the Webhooks module, a user must have the Security Role Webhook Subscriber.
Field
Description
Delivery Date
Date the notification was delivered
Attempts
Amount of attempts to deliver notification
Is Failed
Notification delivery status
Object Type
Name of the subscribed Dataloy object
Object Key
Key of the subscribed Dataloy object
Error Message
Message on notification delivery failure
All fields except Vessel and Port can be edited from the drawer.
By clicking the cargo in the bottom table a modal will open where you can edit the cargo itself, and maintain relevant figures that will appear on the B/L when you print it.
You can enter comments to the B/L in the system - these will not appear on the printed version. Any comments that are added can be edited or deleted by clicking the three dots to the right of the comment.
Depending on your access permissions the list of voyages might not be visible.
The "Voyages" module can be located from the menu under "Core".
From the list of voyages using filters
Having the list of voyages open in the Voyages module you can use filters to find the voyage you are looking for. You can also click My Voyages to find the voyages where the logged in user is set as responsible operator.
The details of a voyage can be edited in the CoreVoyages module.
When you have located the voyage, click it and the details will show in a drawer or panel on the right hand side. Field values can be edited directly.
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.
The "Schedule" section in the Voyage drawer shows a timeline of port calls on a voyage. You can create, rearrange, delete and edit port calls directly from this screen.
When hovering the mouse over a port call in the schedule, a toolbar in the upper right will appear.
To insert a port call before or after the port call you are editing, click the Create Newbutton and select Before or After. A window to create a new port call then opens.
To edit a port call, click the Editbutton.
To delete a port call, click the Deletebutton.
To change the order of port calls, click and drag the Movebutton to move the port call into place.
In the voyage drawer at the schedule section you will find a checkbox for locking the update of voyage start date and ballast port. This checkbox is not visible while the voyage has status Estimate or Unallocated.
Open the Voyages module in the Core section.
Click the create iconin the top right corner and select between "Voyage Charter" or "Time Charter Out"
Fill in all required fields listed below in the Create Voyage window.
Click Create. A default cargo will be created for a Voyage Charter, and a default TC Out will be created for Time Charter Out
Required fields:
Vessel
Load Port / Delivery Port
Discharge Port / Redelivery Port
By default, new voyages have Voyage Progress set to "Estimate" and Voyage Status set to "T".
In the drop-down menu, click "Print Sea Waybill" and a new window will open with a printable version of the Bill of Lading
Click the "Print Bill of Lading" and a new window with a printable version of the Bill of Lading will open
To open the voyage drawer, go to the CoreVoyages module.
The top of the voyage drawer "Overview" tab has four summary cards for TCE, total days, hire costs and bunker costs.
Click See More to open detailed charts for the numbers in the summary.
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.
The "days" chart has a timeline chart for the port calls on the voyage and a table of the total days on voyage.
The port calls timeline shows the days at sea and days in port. It also shows the names of the ports above the bars. Hover the mouse over each bar to see more information.
A voyage can have the following statuses:
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.
Information about the tab "Organisational data"
In the Organisational data tab in the voyage drawer you can edit information about: Company, Business Unit, Pool, Responsible Charterer, Responsible Operator and Responsible Accountant.
To edit any field in the tab, click into the field and start typing. Then select the desired option. Field will automatically save when you click outside or use tab key to exit the field.
Company and Business Unit are mandatory fields if the voyage status is NOT Estimate or Unallocated.
only applicable in voyage status Estimate, Scheduled Unallocated and Scheduled Allocated
Click a row to edit bunker price
Edit the price for each bunker type in the modal
Only applicable when the voyage does not have TCin
In order to get a complete voyage result estimation it is possible to edit the daily hire and address commission for vessels/voyages that does not have TC-in present in the system.
Voyages of status "Estimate" and "Unallocated" can be deleted. Otherwise you must change the status before you can delete.
Go to PlanningMaster Fleet Plan.
Click to open the voyage you want to delete.
At the upper right corner of the panel, click Delete.
Click Confirm to delete the voyage.
The VMS provides powerful voyage tools for risk assessment and estimations on cargo capacity on port calls.
These tools are available from one of the following modules:
PlanningMaster Fleet Plan
PlanningScenario Fleet Plans.
Click on a voyage in the list or board to open it in the drawer.
At the top right, click on Functions.
With the Sensitivity Analysis tool you can run calculations on a chosen parameter to evaluate risk.
The sensitivity analysis can be opened from one of the following modules:
PlanningMaster Fleet Plan
PlanningScenario Fleet Plans.
Click on a voyage in the list or board to open it in the drawer.
At the top right, click on Functions.
Select Voyage Sensitivity Analysis.
Select a voyage parameter which is then adjusted by the numerical variance for each calculation.
The chart shows the all the calculated values for the voyage. There are 15 data points, with the current voyage displayed in the middle, with negative variance on the left side, and positive variance on the right side.
Hover the mouse over the chart to inspect the values of each calculation data point.
Press the menu iconto download the chart as an image (SVG or PNG), or a text file (CSV) that can be imported to a spreadsheet software.
Parameter
Calculated value
Freight Rate
TCE
Bunker Price / MT (DO, LS DO, FO, LS FO)
TCE
TCE
Freight Rate
Depending on your access permissions the list of business partners might not be visible.
Open the Business Partners module in the Master Data section.
From the list of business partners using filters
Having the list of business partners open in the Business Partners module you can use filters to find the business partner you are looking for. Clicking the business partner in the list will open a drawer with additional information.
Open the Business Partners module in the Master Data section.
Click Create Business Partnerin the top right corner.
Fill in all required fields listed below in the Create Business Partner window.
Click Create.
Required fields:
Business Partner Type
Business Partner Name
Short Name
Business Partner Code
When you have located a business partner, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.
By clicking the secondary actions icon additional actions may be possible.
Edit Business Partner Name
Delete
Restore (if deleted)
Permanently Delete (if deleted)
With the Intake Calculation function you can change parameters of a voyage to get an overview of quantities available for cargo at the port calls.
The intake calculation function can be opened from one of the following modules:
PlanningMaster Fleet Plan
PlanningScenario Fleet Plans
Click on a voyage in the list or board to open it in the drawer.
At the top right, click on Functions.
Select Voyage Intake Calculation.
At the top, fields for changing the stowage and bunker properties for the entire voyage are displayed.
Parameter
Description
Stowage Factor
Cubic meters of space occupied by one metric tonne of cargo
DO ROB Voyage Start
Diesel oil at voyage start
DO LS ROB Voyage Start
Low-sulphur diesel oil at voyage start
FO ROB Voyage Start
Fuel oil at voyage start
FO LS ROB Voyage Start
Low-sulphur fuel oil at voyage start
A table of all the port calls on this voyage is shown in this section. To change the intake reduction properties per port call, click a row to open a window where you can make adjustments.
Parameter
Description
Zone
Sets the vessel DWT that is used in the calculation.
Water Salinity
One of Saltwater/Brackish Water/Fresh Water. Affects the water density.
Water Density
Density of the water at port. Higher value increases intake.
Draft
Intake draft reduction of the vessel. Lower value increases intake.
Safety Margin
Safety margin for the draft. Default value is 20%. Lower value increases intake.
Constant Reduction
Intake constant reduction of the vessel. Lower value increases intake.
Fresh Water Reduction
Intake fresh water reduction of the vessel. Lower value increases intake.
The loadline information table shows data on the voyage vessel that might affect the intake. To change these values, you need to edit the vessel in the Vessels module in master data.
A mixed chart of the calculation results is generated at the bottom. Each port call has multiple graphs to show the reductions, cargo quantity and quantity available for cargo. The charts gets updated automatically when there are changes to the voyage header, port call, or vessel parameters.
Click on the legends at the top of the chart to toggle the display of a graph. Hover the mouse over the chart to inspect the values of each calculation data point.
With a business partner drawer open, locate the section for Contact Persons under the Main Details tab.
Click the "Add Contact Person" + icon and fill in the given fields to add a contact person to the business partner.
From the list of business partners you can access any previously deleted entities using the using the "deleted items" toggle switch indicated below.
Delete a Business Partner
and click in the list the business partner to delete. On the menu open the three dots and find the button "Delete". This will soft delete the business partner. It can be found again by
Permanently Delete a Business Partner
Find the deleted business partner to permanently delete. Use the icon on the top menu illustrated with the three dots. Find and click "Permanently Delete". This will permanently delete the business partner.
Open the Vessels module in the Master Data section.
Click Create Vesselin the top right corner.
Fill in all required fields listed below in the Create Vessel window.
Click Create.
Required fields:
Vessel Name
Vessel Type
Depending on your access permissions the list of Vessels might not be visible.
Open the Vessels module in the Master Data section.
From the list in Vessels module using filters
Having the list of Vessels open you can use filters to find the vessel you are looking for. Clicking the vessel in the list will open a drawer with additional information.
With a business partner drawer open, locate the section for Bank Accounts under the Financial tab.
Click the "Add" + icon and select a bank account to add the bank account to the business partner.
Open the Vessels module in the Master Data section.
Open the vessel drawer
Vessel "Internal Data" can be accessed in the top tab menu.
For "old" vessels that you have in the system that has minimum of one commenced voyage, the internal data should already be established. For new vessels, or vessels without commenced voyages, open the action menuin the top right and choose "Create Internal Data" as per below indicated.
Fill in the required fields
When the above 'Create Internal Data' is created, it will be possible to access the below Internal Data page.
Open the Vessels module in the Master Data section.
Open the vessel drawer
Vessel "Speed and Consumption" data can be accessed in the top tab menu. Details can be maintained directly in the fields or from the table actions.
To add a Main Engine Speed to a vessel, navigate to the Speed and Consumption section of the Vessel drawer.
In the Main Engine table, click Add Main Engine Speed and fill in the fields.
To add a Bunker Type to a vessel, navigate to the Speed and Consumption section of the Vessel drawer.
In the Bunker Types table, click Add Bunker Type and fill in the fields.
How to enable or disable AIS-subscription
You can enable or disable the subscription to AIS-positions for a vessel.
Open the Vessels module in the Master Data section.
Open the vessel drawer
There is an icon on the top right corner of a vessel drawer. If the icon is light grey it indicates that the vessel has no IMO-number registered. If the icon is darker grey it indicates that it is not subscribing to AIS-positions. If the icon is blue it indicates that the vessel is subscribing to AIS-positions.
Open the Vessels module in the Master Data section.
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.
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.
As of version Release 5.3 it is possible to introduce crew onboard to the VMS and create an efficient, "one time entry" work process in the system.
The functionality with establishing a master role involves giving them access to only their relevant port calls. In order to establish this filter for the user we need to link their credentials to their particular vessel.
Pre requisite for below is that vessel has been created, user for the vessel has been created with security role "Vessel" (only this security role) and internal data tab should be enabled.
Step 1: Access vessel master data screen and insert vessel user in the "Master User" field as indicated below. This action will link the vessel to the user so that Crew only see their relevant port calls in the VMS
When you have located a user, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.
By clicking the secondary actions icon additional actions may be possible.
Edit User Name
Open the Users module in the Setup section.
Click Create New Userin the top right corner.
Fill in all required fields listed below in the Create New User window.
Click Create.
Vessel Users
The security role "Vessel" is designed to grant access for users onboard vessels. See .
Permissions in the Java VMS
In order to perform actions in the Java VMS a user must also belong to a Security Group.
Groups, roles and their permissions are maintained in the Manage Permissions module in the Java VMS.
Field
Description
User Code
A short identifier used for logging in
User Name
The user's name that is displayed in the system
Password
Password used for logging in
Email address for notifications
Security Roles
Restricts access to modules and the API
Find the user to change password. Locate the password input field and fill in the new password.
When all the verifications are met, press enter or click outside of the input field to submit, the password will be changed if no notifications are displaying otherwise.
Depending on your access permissions the list of users might not be visible.
The "User Administration" module can be located from the menu under System.
From the list of users using filters
Having the list of users open in the User Administration application you can use filters to find the user you are looking for. Clicking the user in the list will open a drawer with additional information.
From the list of users using filters
Having the list of users open in the User Administration application you can use filters to find inactive users by toggling the Deleted Items switch.
Find the user to disable.
Open the actions menuand click Disable User. This will prevent the user account from logging in.
The user can be found again by filtering on inactive users in the list.
Open the Port Calls module in the Core section.
Note: Depending on your access permissions the list of port calls might be pre-filtered basis your system user security rights.
As Operator of a vessel you can quickly filter the list to only show "your" port calls with the quick filter called "My Port Calls"
You are also able to filter on historical port calls with the button "Show Historical Port Calls"
Additional filtering is possible using the icons positioned beside the quick filters
Specialty role: Vessel User If you are a user onboard a vessel the list will be showing only port calls related to that vessel.
When you have located a Port Call, click it and the details will show in a panel (so called "drawer") on the right hand side. Details can currently not be maintained directly in the fields.
At the top of the drawer you can locate an action menu with several action options:
It is possible to change the instructed speed for each port call. This is a choice limited to the vessels speed and consumption combinations only depending on the leg being in ballast or laden.
The dropdown shows both the speed and consumption
Each speed will only affect the port call (leg) in question.
To add a speed for a vessel see the vessel documentation.
To register a departure in a Port, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Departure". A dialog will open and allow you to enter the departure details.
To register a Noon Report, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Noon Report". A dialog will open and allow you to enter the details.
To register a In Port Report, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register In Port Report". A dialog will open and allow you to enter the details.
With below it is possible to keep track of incoming vessel reports. Note: if you want to keep track of incoming reports from multiple vessels or a fleet then check out this page
To view Vessel Reports, open the drawer for the given Port Call by clicking it in the list. Then click the tab "Vessel Reports" at the top of the drawer and a list with registered reports will be displayed.
To view a given report, click the wanted report in the list and a new drawer will open with further details.
Note: if you want to keep track of incoming reports from multiple vessels or a fleet then check out this page
To view bunker orders on a Port Call, open the drawer for the given Port Call by clicking it in the list. When inside the drawer click the "Bunker Orders" tab, which will display registered bunker orders in a table.
By clicking a row in the bunker order table, a new drawer view will open with additional bunker order information like in Maintain Bunker Orders.
Open the Port Services Orders module under Operations in the menu.
Click Create Port Services Order in the top right corner.
Fill in the required fields for your order.
Click in the Order Lines section to add at least one order line.
Click Create when you are done adding order lines.
Go to the OperationsPort Services Orders module and open a port services order in the drawer.
Click the more iconat top right.
Click Delete.
Click Confirm to delete the order.
The Bunker Management module allows you to register and follow a bunker order's workflow from requirement to a paid invoice. The module also enables bunker management systems and agents to make full two-way integrations. Currently two Bunker Procurement Systems (BPS) have made integrations, and have been successfully tested: Clearlynx and World Fuel Service's BunkerLine.
Bunker estimates can still be maintained in "Booking and Operations", allowing you to create detailed voyage estimates. These estimates will later be used as default values when creating the bunker requirement or order.
Advantages:
Enter two products (bunker requirements/order lines) on the same port, without the need to add two bunker port calls.
Run reports and statistics based on all the bunker orders, per port, per supplier, status, etc.
Get a list of future bunker requirements across the fleet.
Quickly search and filter on all of the bunker orders by vessel, supplier, port, etc.
Support for integration with bunker procurement systems, such as ClearLynx and World Fuel Services.
Changes to a port services order are done from the drawer that opens after creating a port services order.
To maintain an already existing port services order, open the OperationsPort Services Orders module and click the order you want to change. It will now open in the drawer.
You can change order date, supplier and cost details under "Order Details".
The total port cost of the order lines are calculated for estimate (advanced), revised, and final.
Click the more iconat top right.
Select Edit order reference.
Make changes to the reference in the window.
Click Save.
You can change the status of the order at all times. There are three statuses, "estimate", "revised", and "final".
Click the more iconat top right.
Select Set status to <status>.
Tip: You cannot set the revised and final cost of an order line until after it has been created. Open an already created order line from the list to set these values.
To register an arrival in a Port, open the drawer for the given Port Call by clicking it in the list. Then click the icon at the top of the drawer and select "Register Arrival". A dialog will open and allow you to enter the arrival details.
Clickin the "Order Lines" section to create a new order line.
A bunker order can efficiently be added directly from "Booking And Operations" module (in your java client VMS) when having a port call in focus. Either based on the bunker estimates registered, or straight as a bunker order requirement.
Select the port call where you are bunkering and click the "Create new Bunker Order" button from the menu.
A dialog will show a bunker order with the details filled out from the estimates, if there are no estimates please fill in all the details of the bunker order such as Bunker Type, Min/Max quantity, assumed bunker price and supplier.
If you add estimates for several bunker types, all types will be defaulted when you create a bunker order.
NOTE: Defaults will not be set for port calls that already have bunker order tied to it.
If already situated in the "Bunker Management" application you can create a new bunker order directly there. Click the Create Bunker button in the upper right corner and fill out the vessel and port call together with the other necessary details.
If there are estimates registered in the "Booking and Operations" module these will be defaulted in the details (such as bunker type, quantities and bunker prices)
Bunker orders can be located in three ways:
From "Booking and Operations" module
Find the voyage and port in "Booking and Operations" module and click the "Bunker Orders" button there. The list of all bunker orders for that port call will show.
From the list of bunker orders using filters
Having the list of bunker orders open in the Bunker Management application you can use filters to find the bunker order you are looking for.
From the Bunker Requirement list
Filter the bunker requirement list as per above to locate the bunker order. This list will show all bunker order lines across all bunker orders.
The details of a bunker order can be edited and maintained in the Bunker Management application.
When you have located the bunker order click it and the details will show in a panel (so called "drawer") on the right hand side. Details can be maintained directly in the fields.
If you want to add a product for a given order click the "+" button above the list of products. Then a dialog will show and allow you to enter the details.
If you want to edit the details of the bunker order line (bunker type, quantity or unit price) click the bunker order line and a dialog will show allowing you to change.
Bunker Type: If estimating bunker intake, the bunker type set will default to the grade this vessel is set up with in your vessel administration screen. If you need to change this you can do that in the below screen or when you actually place/create the order.
When a bunker order requirement is stemmed you should update the system with the agreed supplier, prices and quantities and status.
Register the information and click the "action button" with three dots on it, and a menu of actions shows. Click the "Stem" button and the status is transitioned to "Stemmed" if all the requirements are fulfilled.
REQUIRED DETAILS
The required details for this status are:
Supplier
A bunker order line with "Bunker type", "Min Quantity" and "Unit Price"
When a bunkering is canceled, the bunker order needs to be either canceled or deleted.
Click a bunker order in the Bunker Orders module list.
When the drawer opens, open the action menuin the top right.
Click the Cancel button to cancel the bunker order.
Canceling a bunker order will update and recalculate the ROB figures and bunker prices on the voyage. The voyage result will be impacted.
When delivery is taken by the vessel the "Bunkered Quantity" and "Delivery Date" must be registered in the application. Fill in the required fields and click "Register Delivery" on the action menu.
Ship Role: It is possible for the the a Ship user with the vessel security role to register this information his side and upload the bunker delivery note as an attachment in the system.
REQUIRED DETAILS
Required details for "Registering Delivery" on a bunker order are:
Supplier
At least one bunker order line with "Bunker Type", "Bunkered Quantity" and "Unit Price"
Delivery Date
Deleting a bunker order entirely removes the order and all its history. This option is suitable when a bunker order is cancelled, or the entire port call or voyage is cancelled.
Click the delete button from the action menu. If the bunker order is not cancelled prior to this...then the delete button will not be active in the menu.
Precautions:
Any assembled bunker invoices in Accounts Payable have to be "Un-Assembled".
Any posted bunker invoices in Accounts Payable have to be "Reversed"
Only "Cancelled" bunker orders can be deleted.
Open the Cargoes module in the Core section.
In the top right corner, click Create.
Select Create New Cargo.
Fill in the required fields and any additional information about the new cargo.
Click Create.
Required fields:
Load Port
Discharge Port
Charterer
Commodity
You are able to keep in control of all your organisations inserted cargoes using the cargo module in VMS.
Once you have located and opened a cargo booking from the cargo list, you can edit the details of this booking directly in the drawer.
Laycan dates are automatically checked and indicated in red if either date is not filled in. The validation is separate for laydays and target laydays fields.
The webVMS contains all cargoes created in your system. To access this list you should navigate in the menu to the "Cargoes" link. This will open up your list of cargos.
There are several sorting and filtering options available for you to narrow down what you include in the list view. The sorting functionality is located in the top right corner of the list table. See below screenshot
To efficiently create a cargo you can use a CoA Template or a Budget Template.
CoA Templates are the template cargoes that are maintained in the CoA module.
Budget Templates are cargoes that come from the budget.
Open the Cargoes module in the Core section.
In the top right corner, click Create .
Select Create Cargo From CoA Template or Create Cargo From Budget Template.
Select the cargo template you wish to use from the list.
Click Create.
Click a cargo in the Cargoes module list.
When the drawer opens, open the action menuin the top right.
Click the Allocate Cargo button to open a dialog for allocation.
In the dialog, select Vessel and Voyage you want to allocate the cargo to. A preview of the voyage schedule will then show the cargo ports to the left and voyage port calls to the right, as in the screen capture below. The allocation will be done using the existing port calls on the voyage if they match the cargo ports. If no port calls and cargo ports match, additional port calls will be created on the voyage. These new port calls are denoted with "Adds New Port Call".
Click Allocate to allocate the cargo and create any new necessary port calls on the voyage.
Click a cargo in the Cargoes module list.
When the drawer opens, find the "Commissions" tab and open it.
Click the icon to open a dialog to enter values, where "Broker" is mandatory.
To edit the details after creation, click the line in the table and the same dialog will open.
When deleting a cargo you will be presented different options based on the cargo you are deleting
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:
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.
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
The same confirmation message will always be shown for unallocated cargoes.
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 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.
When ticking the checkbox the port calls marked in red will also be deleted from the schedule.
Template cargoes are currently handled in Contract of Affreightment Line module.
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".
Open the Cargoes module in the Core section.
Click a cargo in the list to open it in a drawer.
At the top right in the drawer, click Moreand select Relet.
Fill in the "Owner" field and click Confirm.
A copy holding most of the same data of the cargo to be relet will be created in the system .
Find the cargo that was relet.
Find the relet listed under "Relets and Transhipments" in the cargo drawer and click to open it.
At the top right in the drawer, click Moreand select Delete.
A transshipment is the shipment of cargo to an intermediate destination, then by a different vessel to another destination. It is a type of relet created from a cargo booking from a particular discharge port at the end of an original booking.
A preshipment is another type of relet created from a cargo booking. It is the shipment of cargo from a location to that cargo's load port in an existing cargo booking. This includes the transfer to the vessel transporting from the load port.
Transshipments and preshipments are listed at the bottom of the cargo drawer under "Relets and Transshipments".
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 cargo drawer, click Moreand select Transship or Preship.
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.
A cargo transfer is a type of transshipment where a cargo transported on two voyages. The cargo is transported on the first voyage to one port and then further transported on a second voyage to its final port.
You start with a cargo with a load and discharge port which represents the first part of the cargoes journey (on the first voyage). From a system perspective, the action "transfer" creates a new cargo for the second part of the journey (on the second voyage). The two cargoes are synchronised such that e.g. the cargo quantity on the two is always the same.
Transfer cargoes are listed at the bottom of the cargo drawer under "Relets and Transshipments".
Open a cargo drawer.
At the top right in the cargo drawer, click Moreand select Transfer.
Fill in the form fields:
Owner of the vessel to transship the cargo.
Final discharge port of the transfer.
Second vessel to transport the cargo.
Second voyage to transport the cargo.
Click Transfer.
The discharge port of the original cargo will be the load port of the transfer cargo.
Creation of commissions are currently handled in the Cargoes module.
Depending on your access permissions the list of broker commissions might not be visible.
The "Broker Commissions" module can be located from the menu under "Chartering".
From the list of broker commissions using filters
Having the list of broker commissions open in the Broker Commissions module you can use filters to find the broker commission you are looking for. Clicking the broker commission in the list will open a drawer with additional information.
The capacity plan gives you a monthly overview if your fleet is over or under booked with cargoes. For each months and each trade, we compare the available cargoes to the capacity in your fleet which is serving that trade.
To open the Capacity Plan, go to Chartering > Cargoes and select Capacity Plan in the top bar.
You can navigate between the current month and future months at the top of the dashboard. You also filter to restrict the view to a particular set of trades.
The are three summary cards at the top displaying information on all trades selected in the filter :
Free capacity: Total deadweight - total weight
Deadweight: Total deadweight of vessels loading in the selected month
Weight: Total weight of cargoes with laydays commencement in the selected month.
For free capacity and weight, we distinguish between total values and fixed values. The latter takes only cargoes into account which have status "Clean Fix".
Category
Status
Not Fixed
Indication
Firm Offer
Working
On Subject
Fixed
Clean Fix
Summary
Description
Values
Free Capacity
Remaining deadweight tonnage summing all vessels and cargoes
Total: Deadweight - total weight
Fixed: Deadweight - fixed weight
Deadweight
Deadweight of vessels
Total: Sum of deadweight of vessels
Weight
Weight of cargoes
Total: Sum of weight of cargoes of any status
Fixed: Sum of weight of cargoes of fixed status
An expandable panel is shown for each trade, with totals for that trade. There are two lists inside the panel, one for cargoes by charterer and one for vessels.
In each trade panel there is a list of total cargo weight and volume grouped by charterer. Only cargoes where laydays commencement lies in the selected month are counted.
All "fixed" charterer cargo totals are listed first, while "not fixed" entries are indicated in grey.
Column
Description
Charterer
Name of the charterer
Weight (MT)
Total cargo weight in metric tons
Volume (M³)
Total cargo volume in cubic meters
In each trade panel there is a list of vessels. For each voyage in the master fleetplan, the vessel that voyage is allocated to is listed if the following two criteria are met:
The voyage is marked with this trade or its performance cargo belongs to the trade.
The voyage has arrival date in the first load port within the selected month.
Column
Description
Vessel
Name of vessel
DWT
Deadweight of the vessel
Open Date
Arrival date in the first load port
Open Port
First load port
Previous Trade
Trade of the previous voyage on the vessel
To create a new contract, navigate to the Contract of Affreightment module under Chartering from the menu and click the Create Contract of Affreightment button in the top right corner.
When creating new contract there are some details that are mandatory.
Mandatory details:
Charterer
CoA Number
Commencement Date
Expiry Date
Commodity
Currency
Business Unit
Company
Charterer Responsible
Freight Rate
Load Port
Discharge Port
When you have located a Broker Commission, click it and the details will show in a drawer on the right hand side. Details can currently not be maintained directly in the fields.
Commission Contributors
To add contributors, click the icon to open a dialog to enter values.
To edit the details after creation, click the line in the table and the same dialog will open. The same dialog offers the option to delete the selected contributor.
The total commission contributors must equal 100% to be able to save