Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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...
Oracle Database version that are compatible with Dataloy VMS
Dataloy Version
Oracle Version
Dataloy VMS all supported versions
All Oracle supported versions up to Oracle 19.
Depending on your access permissions the list of voyages might not be visible.
The "Voyages" module can be located from the menu under "Core".
There are several sorting and filtering options available for you to narrow down what you include in the list view.
Find answers to your questions...
Welcome to the main source of information on the Dataloy product suite.
A voyage can have the following statuses:
In the Speed and Consumption section in the voyage drawer you can update the various fields for consumption for a voyage. This section can be found in the Overview-tab in the voyage drawer.
When the drawer is opened you will find the section like this:
In order to expand the section to see and edit the fields, click the icon on the far right of the section.
Once the expand icon is clicked the fields will be displayed like this example:
Note that if the field for Speed Laden or Speed Ballast is changed in the vessel section it will also affect the corresponding field in this section as well, and vice versa.
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.
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".
When in a voyage drawer the analysis tab is available in the tab section. In this tab you will be presented with a graph to give you a visual view of the development of key values in the selected voyage.
The graph that is displayed represents the voyage result for the columns, and the TCE for the line. The timeline shown will be from the preliminary snapshot is taken to the current date. If the voyage is closed, the last value will be the last time the voyage was changed instead of todays date.
The details of a voyage can be edited in the CoreVoyages module.
When you have , click it and the details will show in a drawer or panel on the right hand side. Field values can be edited directly.
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.
Speed Laden: Showing the speed for laden port calls if all port calls have the same speed. If port calls has different speeds this field will be disabled and the text will be: Multiple. Changing this value will update speed for all laden port calls.
Speed Ballast: Showing the speed for ballast port calls if all port calls have the same speed. If port calls has different speeds this field will be disabled and the text will be: Multiple. Changing this value will update speed for all ballast port calls.
Days Extra In Port: Showing the average days extra in port for load and discharge port. Only enabled when days extra in port is the same for all port calls within a reason for call. When updating all port calls within a reason for call will be updated. Days extra in port can also be updated when editing a port call.
only applicable in voyage status Estimate, Scheduled Unallocated and Scheduled Allocated
Bunker prices can be changed from the Overview /Bunker tabs.
Click a row to edit bunker price
Edit the price for each bunker type in the modal
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.
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.
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.
Parameter
Calculated value
Freight Rate
TCE
Bunker Price / MT (DO, LS DO, FO, LS FO)
TCE
TCE
Freight Rate
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.
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.
When you are in the analysis tab and you select a snapshot from the analysis chart the See Audit Log will be activated, and you may click this button to see the audit logs from the previous snapshot to the selected snapshot. This button is not activated for the first (Preliminary snapshot) as this has no previous snapshot to compare with.
The audit log in the analysis section will show audit logs between the selected Snapshot and the previous snapshot.
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.
You are able to keep in control of all your organisations inserted cargoes using the cargo module in VMS.
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
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.
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.
To maintain the cargo click the cargo in the list. The selected cargo will be opened in a cargo drawer where you can edit fields, copy cargo, create a pdf from the booking and so forth. Click the cargo drawer page here to see more details.
In the Sub-cargoes tab you may enter sub-cargoes
By clicking the blue plus icon in the top right corner you can create sub-cargoes.
Once clicked the below modal will appear
Once the required fields are filled in the create button will be activated and you may create the sub-cargo.
In the various Cost/Revenue Tab there will be two tables. One table for various cost and one for various revenue.
To add a Various Cost click the blue plus icon in the top right corner. Once clicked the below modal will appear.
Once the required fields are filled in the create button will be activated and you can create the Various Cost.
To add a Various Revenue click the blue icon in the top right corner. Once clicked the below modal will appear:
Once the required fields are filled in the create button will be activated and you can create the Various Revenue.
To delete either a Various Cost or a Various Revenue select the item from the table by clicking the checkbox on the far left side.
Once one or more items are selected you can click the trashcan to delete the selected item(s).
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.
When you open the cargo drawer this is the top section of the drawer.
By clicking the various tabs you get the relevant information about the cargo. Check out the next pages for information about the different tabs.
On the left side you will see the cargo reference, status of the cargo, and if it is a spot or CoA cargo.
On the right side you have primary actions; PDF and copy. The three dots is a dropdown with secondary actions for the drawer. If you click the three dots you will be presented with the below view as a drop down:
You can allocate/unallocate of the cargo.
You can change the status of the cargo.
You can delete a cargo.
You can arrange Tranship, Preship or Transfer the cargo.
And finally you have the option to view the audit log or append attachements to the cargo.
In the Commissions tab you can create new commissions by clicking the blue plus icon in the top right corner.
Once clicked the below modal will appear:
Once the required fields are filled in the create button will be activated and you can create the new Commission, which then will appear in the table in the Commissions tab.
In the comments tab there is a list of previous comments made, and at the bottom you can add new comments.
At the top in the main details you will find the KPI-cards.
First card: Cargo quantity is the actual quantity, and booked is the booked quantity.
Second card: Freight is the total freight for the cargo, rate is the freight rate for the cargo.
Third card: Net Fio is all cargo related revenue aggregated and then deduct all aggregated cargo cost - divided by the quantity of the cargo.
Fourth card: Laycan Missed by is the number of days the ship's ETA is after the cancelling date. Arrival window missed by is the number of days the ship's ETA is after end of the Arrival Window End date.
Below the KPI-cards is the Main Cargo Details section on the left side
All fields that are enabled can be changed from this view.
Below the KPI-cards on the right side is the Cargo Port Timeline together with LayCan dates. Laytime used is the estimated laytime allowed. The date fields are validated and if the validation fails the date field that needs to be corrected is highlighted in red and there is a short message under the date field indicating what is wrong.
To add a cargo port, edit a cargo port or delete a cargo port hover one of the cargo ports in the timeline and the below view will appear:
On the left side of the tab below the Main Cargo Details is the Stowage section
On the right side, below the Cargo Port Timeline section you can enter external reference, Trade, Cargo Text and a comment:
At the bottom of this tab there will be a list of Relets and Transhipments for the cargo:
The tiered freight rates feature of the Cargoes module lets you model more advanced rate structures.
A dropdown selector at the top lets you select different pricing models your tiers should be based on.
Tiered: In tiered pricing, the per-unit freight rate are assigned to quantity-based ranges (tiers). When calculating the total freight, quantities are purchased from successive tiers, starting from the lowest.
Volume: As with tiered pricing, the freight rate is quantity-based. However, the per-unit freight rate is dependent on the range within which the total quantity falls. So under this model, you would define the quantity ranges and the per-unit freight rate for each.
Click Create to add a new tier.
In the dialog window, enter the quantity at which the tier should start at, the freight rate per unit of quantity, and a flat-fee lump sum.
When you create a new tier or edit an existing tier, the end of the range of the previous tier is automatically adjusted to align with it.
In the Payment Terms tab you can enter the payment details as per above fields.
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.
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
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.
Template cargoes are currently handled in Contract of Affreightment Line module.
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.
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.
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.
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 .
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 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.
Open the Port Calls List module in the Core section.
By using the list of port calls that opens on the Port Calls module, you can use the quick filters to find the port call you are looking for.
Depending on your access permissions, the list of port calls might be pre-filtered based on your system user security rights. Vessel operators can quickly filter the list to only show your port calls with the quick filter called "My Port Calls"
Specialty role: Vessel User: If you are a user onboard a vessel, the list will be showing only port calls related to that vessel.
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.
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.
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.
When you have located a Port Call from the Port Call list, click it and the details will show in a panel (so called "drawer") on the right hand side.
At the top of the drawer you can locate an action menu with several action options:
In the Port Call drawer, you can look through the different tabs below to display all the relevant information:
More detailed information in each of the tabs you can find under in the Port Calls section. Ex. "View Service Orders on Port Calls" for more information about Service Orders in each Port Call.
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 original cargo will receive cargo type "Has Transfer", and the new cargo will receive cargo type "Transfer."
The following fields are synchronised:
cargo quantity and measurement unit
commodity
discharge rate + terms of has transfer cargo = load rate + terms of transfer cargo
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.
When you have located a Contract of Affreightment, click it and the details will show in a drawer on the right hand side. Details can be maintained directly in the fields.
By clicking the secondary actions icon (icon = 3 dots) additional actions may be possible.
Edit Contract Number
Delete
Depending on your access permissions the table of Contract of Affreightment Lines might not be visible.
The list of Contract of Affreightment Lines can be located from the Contract of Affreightment drawer.
From the table in Contract of Affreightment drawer
Having the drawer for Contracts of Affreightment open you can locate the table listing the Contract of Affreightment Lines. Clicking a line in the table will open a drawer with additional information.
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.
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.
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.
This tab contains all the main details for each of the port calls. Here we have the tile boxes displaying a vessel's number of days "at sea", as well as the "average speed/consumption", days "in port" and the "port cost". There are also sections for Sea Passage and Port, as well as sections for Comment and the Bunkers table. We also have a new Map component displaying a port call. By zooming out you will get the whole voyage that is linked to the port call:
The Sea Passage- and the Port sections contains these fields:
Sea Passage
Port
Speed Order
Arrival (editable)
Actual Speed
Agent
Estimated Distance
Berthed (editable)
Actual Distance Sailed (editable)
Departure (editable)
Percent Extra At Sea
Waiting
Days Extra At Sea
Extra
Loading
Total
Port Cost
Currency
Master (editable)
Port Captain (editable)
Look here for some more information about Speed Order.
Arrival-, Berthed- and Departure dates are validated with comparisons to the Voyage Start- and Previous Portcall Departure dates, for correct date range. If the date you are trying to add is out of range, a warning prompt will show up, and you can choose different dates.
The Comment section is useful if you want to add in more additional information about a vessel or a voyage.
At the bottom of the Overview tab, we have the Bunkers table. It has been updated and contains now the fields "arrival", "arrival fixed", "quantity", "consumption", "departure", "departure fixed":
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.
With below it is possible to keep track of incoming vessel reports.
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 service 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 "Service Orders" tab, which will display registered service orders in a table.
Service Orders tab is not visible for user with Vessel permission.
By clicking a row in the service orders table, a new drawer view will open with additional service order information, like in Maintain Service Order.
Fill in the required fields for your order.
Click Create when you are done.
Also see Create Service Order.
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.
In the port log tab there will be an overview of stoppages registered for both cargo ports, and for the port call.
A list of all cargo ports connected to the port call will be displayed in the form of collapsible panels.
When opening a cargo port panel, a list of stoppages will be presented. The stoppages are editable if the cargo port does NOT have a laytime calculation connected.
It is possible to create new stoppages for a cargo port, by clicking the + sign in the top right corner of the cargo port panel. It is the same fields for creating and editing a stoppage.
Underneath all the cargo ports, a list of all stoppages related to the port call will be displayed. Stoppages that are related to the connected cargo ports will be marked with the commodity name as well.
The Port Log allows you to record all events during a port call. The events are specific to a cargo and gives important information in a Laytime Statement about what has occurred and when.
To access the Port Log go to the CorePort Calls module and click a port call to open the drawer to find the "Port Log" tab at the top.
The event table lists all applicable events for the port call. Events are either on Cargo Port or Port Call (PC) level. The columns in the table are event names, port call event dates and cargo event dates (one per cargo registered on that port call). The column header for cargo shows charterer name, cargo reference number and quantity.
To register a date for an event, click on a cell in the table and press Save in the appearing window. Dates can be cleared by opening the event date window again and pressing backspace to delete the date in the input field.
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
Click Create Service Order in the top right corner of the table.
Click in the Order Lines section to add an order line.
Depending on your access permissions the list of Contracts of Affreightment might not be visible.
The "Contracts of Affreightment" module can be located from the menu under Chartering.
There are several sorting and filtering options available for you to narrow down what you include in the list view.
Depending on your access permissions the table of Template Cargoes might not be visible.
The list of Template Cargoes can be located from the Contract of Affreightment Line drawer.
From the table in Contract of Affreightment Line drawer
Having the drawer for Contracts of Affreightment Line open you can locate the table listing the Template Cargoes. Clicking a line in the table will open a drawer with additional information.
When you have located a Template Cargo, click it and the details will show in a 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.
Delete
DOCUMENTATION COMING SOON
To create a new Contract of Affreightment Line, navigate to the Contract of Affreightment drawer and click the create button.
A new window will open which you need to fill in as applicable.
Mandatory details:
Termination Date
Total Quantity
Creation of commissions are currently handled in the Cargoes module.
To create a new Template Cargo, navigate to the Contract of Affreightment Line drawer and click the create button.
When creating new template cargo there are some details that are mandatory.
Mandatory details:
Commodity
Load Port
Discharge Port
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)
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
When you have located a Contract of Affreightment Line, click it and the details will show in a drawer on the right hand side. Details can be maintained directly in the fields.
By clicking the secondary actions icon (3 dots icon) additional actions may be possible.
Delete
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.
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
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.
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"
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".
There are several sorting and filtering options available for you to narrow down what you include in the list view.
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.
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 bunkering is canceled, the bunker order needs to be either canceled or.
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.
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.
Go to the OperationsService Orders module and open a service order in the drawer.
Click the more iconat top right.
Click Delete.
Click Confirm to delete the order.
Open the Service Orders module under Operations in the menu.
Click Create Service 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.
Changes to a service order are done from the drawer that opens after creating a service order.
To maintain an already existing service order, open the OperationsService 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 cost of the order lines are calculated for estimate (advanced).
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 status label at the top of the drawer next to the order reference.
Select desired 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.
Clickin the "Order Lines" section to create a new order line.
Calculation of periods in laytime in cargo ports
The Laytime Calculations module can be located from the menu under Operations.
Laytime Calculation Drawer Fields
The top section of the overview tab contains key information about a laytime.
The next section contains the following fields that can be edited.
Fields
Description
Aggregation
Type of aggregation
Demurrage Rate
Rate of demurrage
Despatch Rate
Rate of despatch
An aggregation can be the following types:
Averaged
Reversible
Non-reversible
A laytime calculation panel also contains a section for managing cargo ports:
Editing Laytime Calculation Status
In the header of a selected laytime calculation panel, the current status can be viewed. Clicking on it will activate a dropdown menu and a new status can be selected. A laytime calculation can have one of the following statuses:
Status
Description
Draft
Calculation is being edited
Awaiting approval
Calculation is sent for approval
Settled
Calculation is approved and ready for using
Create Laytime Calculation Dialog
Open the Laytime Calculation module in the Operations section.
Click Create Laytime Calculationin the top right corner.
Fill in all required fields listed below in the Create New Laytime Calculation window.
Click Create.
Field
Description
Vessel
Used to filter Voyages
Voyage
Used to filter Charterer
Charterer
Charterer of the cargoes of the selected voyage
Cargo Ports
Cargo Ports to be included in the calculations
Field Conditions
Each field narrows down the next choice, e.g. choose vessel first, then voyage, then charterer. The fields are enabled accordingly.
At least one cargo port MUST be chosen.
Cargo Port Related Fields
When expanding a cargo port panel, a section for editing certain fields of the cargo port can be found.
Time Not To Count List
The cargo port panel contains a list of all periods not to be counted.
Time to count can also be viewed in the table and are calculated after each new not to count period is added. They are not editable.
Adding a new not to count period
Click the create icon on top of the list.
Fill in all required fields listed below in the Add Time Not to Count window.
Click Create.
Editing a not to count period
Change the fields in the Edit Time Not to Count window.
Click Save.
Click the edit icon on the right side of the not to count row.
Fields
Description
From Date
Start of not to count period
To Date
End of not to count period
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
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.
Cargo Ports Panel List
Cargo ports in the panel list are sorted ascending by the cargo port's port call sequence .
Adding a cargo port:
In the cargo ports section, click the create iconin the right corner.
Selected cargo port(s).
Click Create. The new cargo port will appear as a new panel in the panels list
Cargo ports listed in create dialog are NOT already included in the laytime calculation.
Panel fields
Each panel contains a summary of the cargo port with the following fields:
Reason for call
Port
Terminal
Quantity
Commodity
Removing a cargo port:
Click Remove in the dialog that appears to confirm removal.
Cargo ports that have been removed can be re-added by clicking the create icon as mentioned above.
Laytime Calculation List and Filters
Open the Laytime Calculations module in the Operations section.
There are several options available for you to narrow down what you include in the list view.
In the panel of the cargo port to be removed, click the delete icon.
By clicking the expand icon on a panel, the following sections can be viewed and managed:
Laytime Calculation Panel
When you have located a laytime calculation, click on 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 laytime calculation.
The panel contains an Overview tab for maintaining a laytime calculation and managing the cargo ports.
List Of Events
When expanding a cargo port panel, the statement of facts section can be found. This contains a list of events that include one of the following dates:
Event
Description
Arrived
Date of arrival to cargo port
Berthed
Date of berth
Departed
Date of departure from cargo port
Laytime Commenced
Date laytime period starts
Laytime Completed
Date laytime period ends
Only the dates for the events Laytime Commenced and Laytime Completed can be edited.