Release Notes 2021
Several new features and enhancements are available in IMOS. For more information, see the 2021 Changelog.
December 2021
Send Voyage Instructions as PDF attachments
Feature Board suggestion
You can now email voyage instructions as PDF attachments by checking both "Veslink will automatically send an email to the vessel when Voyage Instruction forms are submitted" and "Send Voyage Instructions as PDF attachments."
Delete Attachments from Veslink Forms
In the Agent Portal, you can now delete attachments that were added to a form in Veslink Forms.
Delete Saved Forms Drafts in Veslink Onboard
You can now delete saved forms drafts in Onboard.
New Icon Shows Number of Validated Forms Pending Approval in Voyage Manager
On the Forms link in the Voyage Manager workspace side panel, an icon has been added that displays the number of forms associated with the voyage that have been validated and are pending approval.
Apply Laytime Calculation Deductions to Entire Port Call
Default behavior when CFGAggregatePortTabOnLaytime is enabled
Laytime calculation deductions can now be synced across common port calls. When CFGAggregatePortTabOnLaytime is enabled, syncing will be the default behavior for new deductions.
New Visual Link Between Laytime Cargo Handling and Port Activity Grids
The first column of the Laytime Calculation Cargo Handling grid is now populated with radio buttons that, when selected, open the corresponding Port Activities tab, providing a visual link between the two.
Capitalize and Amortize Costs Before Performing Period on Monthly Accruals Form
Default behavior when CFGDefaultPnLCalcCapAmortContractFulfillmentCosts is enabled
On the Monthly Accruals form, a new P&L Calc Option called “Capitalize and Amortize Costs Prior to Performing Period” has been added that allows capitalization and amortization of costs incurred as a result of fulfilling a contract prior to the performing period of the contract, and after the nomination date.
When selected, the costs incurred between the Nomination Date and the Start of the First Load port will be capitalized and then amortized over the performing period as defined by the Start of First Load to the end of Last Discharge on the voyage. The amortization will happen as a percentage of the performing period completed on the accrual date. Costs incurred during the performing period will not be affected by this option.
This option will be selected by default when CFGDefaultPnLCalcCapAmortContractFulfillmentCosts is enabled. It requires additional business rules to be added to account for the journals generated from this logic using the following prefixes: "CAP," "AM," "EXP," and "CM" for capitalized costs, amortized costs, costs expensed to the period and all other journals respectively.
November 2021
Cargo ID and Quantity Columns Added to Demurrage Allocation Form
The Demurrage Allocation form now includes read-only columns for Cargo ID and Quantity.
New Naming Format for Exported Files
When you export a form as a PDF, Word, or Excel file, the file name now follows the format DocumentType_VesselName_FormDate.pdf.
Add Attachments to Veslink Forms
You can now add file attachments to submitted and draft forms in the Veslink Agent Portal.
New Demurrage Allocation Details Table for Demurrage Allocation Reporting
Previously, there was no single table that contained all demurrage allocation information, which made reporting on the Demurrage Allocation form difficult. Now there is a Demurrage Allocation Details table where you can report on the form.
Sort by Column Header in Demurrage Allocation Screen
You can now sort rows by column header in the Demurrage Allocation form by selecting the column header.
Firmed Quantity for Scale Table Pricing
When you firm the first voyage of a booking, a firming quantity for that booking is now stored. The Scale Table calculation now supports "Firmed Qty" as a basis. When "Use Booking Qty on Scale Table" is enabled, the booking's firmed quantity will be used in the calculation. When it is disabled, the trade unit's firming quantity will be used in the calculation.
October 2021
New Parameters Added to Voyage P&L Summary Data Set in Report Designer
The parameters "Period Range Gmt" and field "Portion %" have been added to Voyage P&L Summary data table, so that you can report on a pro-rated voyage P&L for a specific date range.
New Dropdown Option to Avoid Winter Load Line Zones
VIP and Veslink Distances maps now have a new dropdown to enable avoiding winter load line zones.
New Reversal Reason Tag Added to Invoice Notification XML
A new tag called "reversalReason" has been added to the invoice notification XML. It shows the Reversal Reason entered by user when reversing a posted invoice.
Voyage Object Added to Invoice Details Default Rules Engine
CFGEnableInvoiceDefaultRules must be enabled
The Invoice Details Default Rules setup in Financials has been extended to include Port, Voyage, Voyage Itinerary and Voyage Cargo Handling joins so you can set defaulting rules using those joins for the Financials' invoice detail lines linked to a specific voyage and/or port.
New Configuration Flag Adds Nomination Date Value
CFGNominationDateOnFixtureAndVoyage must be enabled
When enabled, a new Nomination Date value is added to the Voyage Fixture and the Voyage Manager objects. When the vessel is nominated to a cargo, the nomination date must be populated manually. This date can be separate from the Fixture Date, the Voyage Commencement Date, or CP Date on the cargo. When the nomination date is populated on the Fixture, it will carry down to the Voyage Manager on scheduling. If the nomination is updated on the Voyage it will update the Fixture.
Additionally, a new Module Right was added, which enables you to edit the nomination date on Voyage Fixture and Voyage Manager: Operations-> Actions-> Edit Nomination Date
New Force Calc Parameter Added to Voyage P&L Summary Data Set in Report Designer
A "Force Calc" parameter has been added to Voyage P&L Summary data table in Report Designer. You can use it when you need to calculate Voyage P&L numbers from scratch instead of from a current stored P&L snapshot.
September 2021
New Configuration Flag Enables Exchange Rate Date Column in TC In Payment and TC Out Bill Details Grid
CFGInvDetailExchangeRate and CFGAddExchDatetoTCIPandTCOBForms must be enabled
When CFGAddExchDatetoTCIPandTCOBForms is enabled, a new Exchange Rate Date column will be added to the Time Charter In Payment and Time Charter Out Bill details grid, allowing you to capture a unique exchange rate date for each line item and apply a different exchange rate to each line item. The Exchange Rate Date will flow down to the Transaction Data Entry form on posting to the matching details line item.
New Configuration Flag Allocates TCO Hire Bills to Voyage Period Journals
Configuration flag CFGEnableTCOPeriodJournal must be enabled
When CFGEnableTCOPeriodJournal is enabled, TCO Hire Bills that are posted during a given period will be allocated down to the voyages in the period through journal entries generated during the Voyage Period Journal process. This will better account for a TC Out contract that has multiple voyages in a period and remove the allocation to the first voyage of the full posted amount.
When this flag is enabled, CFGDefVoyNoToTcoBill should be set to N. This functionality is not compatible with the Model B workflow.
New Configuration Flag For Manually Locking Vessel Valuations
Configuration flag CFGManuallyLockVesselValuations must be enabled
When CFGManuallyLockVesselValuations is enabled, you can manually lock your saved vessel valuations to prevent further editing. A new security permission is required to do this. A secondary permission is also available to provide a subset of admins with the ability to unlock a Valuation ID. Now, when saving the Vessel Valuation, the results will be stored in the database in addition to the input parameters. This will require a schema update to latest.
View Projected Claim and Claim Commission Invoices in the Financials Console
A new list called "Create Claim Invoices" has been added to the Financials console. It shows all projected claim and claim commission invoices, which you can then create from the “Create Claim Invoices” list.
New Columns Added to Create TC Invoices List and TC Projected Invoice Table
The following columns have been added to the TC Invoices List and corresponding Time Charter Projected Invoice table in the Report Designer: Original Inv No, Original Ops Inv Trans No, Original Inv Curr Amount, Original Inv Status, Primary Broker, Primary Broker Rate, Secondary Broker Rates and Chartering Specialist.
They show relevant data for projected Time Charter hire and commission invoices.
IMO Number Is Now Shown When You Search for a Vessel in Trade Hub
In Trade Hub, when you search for a vessel, the IMO number is now displayed in addition to the vessel type. You can also search using an IMO number in the vessel search.
View Form Status After Submission
You can now view the status of a form after submitting it through the API.
August 2021
Remittance Banks Added to Bareboat Manager Screen
Remittance Bank information can now be specified on Bareboat Contracts.
Cargo Quantity Column Added to Additional Emissions Data
This feature requires IMOS database schema version 33.6 or higher
A Cargo Qty column has been added to the Voyage Manager's Additional Emissions Data form, allowing you to record carried cargo quantities not otherwise recorded in the voyage itinerary. Values entered in the new column will contribute to the total cargo quantity displayed in the Sustainability side panel.
Cargo ID Column Added to the Freight Calculation Grid in Freight Invoice
A Cargo ID column has been added to the Freight Calculation Grid in the Freight Invoice form that pulls in the ID of the cargo that matches the line item. If there is more than one cargo that matches the line item, then the column will be left blank for that row.
New Configuration Flag Displays Load Quantity in the Voyage Estimator Column View
CFGShowLoadQuantityInEstColumn must be enabled
When CFGShowLoadQuantityInEstColumn is enabled, the estimate column view will display the total load quantity. The existing field "Quantity/Unit" has been renamed to "CP Quantity/Unit".
Freight Type "S" Now Available for COA Contracts
Shuttle Tanker is now available as a Pricing and Advanced Pricing option for COAs and their liftings.
Physical Bunkers Added to Linked Trade Grids on Contracts - Multiple Fuel Types
CFGLinkBunkerPurchase and CFGLinkBunkerPurchaseTradesByFuelType must be enabled
The functionality of CFGLinkBunkerPurchase has been expanded to include bunker purchases that are for multiple fuel types. When this flag is enabled and CFGLinkBunkerPurchaseTradesByFuelType is also enabled, user will be able to select fuel type to be linked and see a fuel type as well as the trade ID in the linked trades grid when the trade type being linked is Bunker Purchase.
Reported Vessel Speed Now Visible in Market Insights
Now, in Trade Hub Market Insights, you can view a vessel’s reported speed when selecting a vessel’s historical position.
Payment Batch Link in TDE Available in VIP
The "Payment Batch No." field in Transaction Data Entry form can now be clicked on to open available payment batches, even when the field is empty.
Customizable Voyage Estimator Itinerary Grid
CFGEnableVoyestCustomItinGrid must be enabled and IMOS database schema must be version 339 or higher
A new Custom tab is available in the VIP estimate Itinerary field. The grid in this tab includes all columns available in the "Charterer" tab as well as a few additional columns from other tabs, and is customizable.
Columns can be pinned to either the left or right side (by dragging to the side and holding for two seconds, then dropping), resized, hidden, and re-ordered. The current column state can be saved by opening the column header menu and clicking "Save View". Only one view can be saved per-user, and this view is applied to the Custom tab in all estimates for that user. Clicking "Clear View" in the column header menu will reset the view to default.
The custom tab is the default selected tab when opening an estimate if this flag is set.
July 2021
Attachments Toolbar Button Added to Claims Invoice Form
An attachments toolbar button has been added to the Claim Invoice form. Its functionality is the same as all other operations' invoice types in VIP (such as Freight, Other Revenue/Expenses etc.).
Approval Date and Approval Comments Added to Invoice Interface XML
Approval Date and Approval Comments tags have been added to the export invoice XML.
Saving Mirrored Voyages Will Generate an XML for Both
Saving mirrored voyages will generate an XML for that voyage and for the destination voyage.
Advanced Pricing Functionality Available with COA Planning Periods
CFGEnableCOAPlanningPeriod must be enabled
When CFGEnableCOAPlanningPeriod is enabled, Advanced Pricing functionality is displayed under the Cargo COA pricing tab.
New Ability to Create Intercompany TCO from TCO Estimate
CFGEnableContractMirroring must be enabled
Previously, the mirroring workflow could not be initiated from a TCO Estimate. Now, if the CFGEnableContractMirroring flag is enabled, when you fix a TCO Estimate with two internal companies, the intercompany checkbox will be automatically checked and mirrored contracts will be created.
Create Public or Private Regions in Trade Hub
You can now differentiate between public and private polygon regions in the VIP Trade Hub.
June 2021
New “Valuation ID” Field Added to Time Charter Contract
CFGEnableVesselValuation must be enabled and you must have either the Trade Hub or Trading & Risk module license
A new field has been added to the Time Charter contract called "Valuation ID". It allows for linking a saved Vessel Valuation to a Time Charter contract.
New Columns in Time Charter Invoice List
The following columns have been added to the to the Create Time Charter (TC) Invoice: LOB, Vessel Code, Vessel Name, Vessel Fleet, and Ops Coordinator.
Bareboat Payments Now Included on Time Charter Invoice List
The Time Charter Invoice List now includes bareboat payments.
New Configuration Flag for Zeroing Out P&L in Estimates Missing Data Points or Failing Internal Checks
CFGVoyestCriteriaForZeroProfit must be enabled
The configuration flag CFGVoyestCriteriaForZeroProfit has been added. When enabled, it allows you to avoid quote rates that are not based on accurate data. The flag accepts a comma-separated list of tags.
Valid values and meanings for the tags are:
BunkerError - A fuel type is used in the calculation with price zero
DWTError - The quantity of cargo on board exceeds the calculated max lift quantity for an itinerary line
DischGreaterThanLoad - The discharge quantity is greater than the loaded quantity
LDRatesMissing - Load/Discharge rates are missing
LDQtyMismatch - Load quantity does not match Discharge quantity
CPQtyMismatch - Min/Max CP quantity does not match load/discharge quantities
PortExpMissing - Port Expenses are missing in ports with functions D/F/I/L
Department Field Now Supported
The Department field is now supported on all forms and list filters for TC Payments, TC Billing, Bareboat Payments, and Equipment Payments.
COA Planning Periods Dropdowns Now Sorted in Descending Order
Previously, the dropdowns for selecting COA Planning Periods were sorted in ascending order. They are now sorted in descending order.
Additional Payment Terms
Additional basis options have been added to Payment Terms setup in Data Center.
They can now be used when calculating Due Date in Freight, TC Payment, TC Commission and Claim Invoice programs as well as in the TDE when posting those invoices.
New Ability to Connect Your Power BI Account in VIP
Now users with Dashboards permission are able to connect their own Power BI account in the "My Profile" panel.
May 2021
Lumpsum Broker Commission Type Now Available in VIP
The lumpsum broker commission type is now available in both Time Charter contract and TCO Estimates in VIP.
View “Tentative Allocation” Notes on Berth Schedule Gantt Chart
When you select “Tentatively Allocated” as a reason for blocking off a berth in the Berth Schedule workspace, any notes you enter will be displayed on the Gantt chart as well as in the hover help.
New Ability to Switch Vessels in an Estimate in Scheduling and Cargo Book Workspace
You can now change the vessel of a suggested estimate in the Scheduling and Cargo Book workspaces.
New Option to Schedule Previously Dropped Cargo in Cargo Book Workspace
You now have the option to schedule a previously dropped cargo on a suggested estimate in the Scheduling and Cargo Book workspaces.
April 2021
AdvancePayment Field Added to APR Form and APR Form XML
This feature requires updating imosmsg to the latest version and updating standard Veslink forms with the Update Forms button (in Veslink Classic > Forms & Vessels > Forms).
The tag APRAdvancePayment has been added to the xml for "Veson Offline Port Disbursement". You can now submit Advance Payments when the status is "APR" by adding a value to APRAdvancePayment, which translates to "APR Advance Payment" in the form. This field will only display in the form UI if there is a value assigned to it. When there's no value for APRAdvancePayment, the Amount Advanced is equal to the APR Total.
Actual Date Field Now Displayed on Port Disbursement Form
Requires updating the standard Veslink forms
The "Actual Date" field is now visible when opening a Veslink Port Disbursement form with an actual date value entered from submitting via the API.
New Load/Discharge Rates Table in Laytime Calculation Form
Configuration flag CFGEnableLDRateTable must be enabled
A new table named Load/Discharge Rates has been added as a right-click option on each Itinerary Line in the Laytime Calculation form. This table is enabled with the flag CFGEnableLDRateTable and calculates the Allowed Laytime and the average L/D Rate for each Itinerary line given a collection of quantity portions and individual L/D Rates.
March 2021
New Configuration Flag Allows for Rate Tables in the Data Center
Requires schema version 319
CFGEnableExtraFrtRateScaleTable must be enabled
When enabled, this configuration flag allows you to set up Scale Table type Rate Tables in the Data Center. You can then use these Rate Tables in the Advanced Pricing structure of Cargo/VC In COA and Cargo/VC In contracts under Extra Freight Terms. Additionally, Scale Table-based freight rates would then be included in both Voyage P&L calculations and related Freight Invoices.
New Configuration Flag Automatically Creates Commissions Invoice when TC Hire Invoice is Generated
CFGAutoGenerateTCComms must be enabled
When enabled, TC Commission invoices will automatically be created when the corresponding TC Hire invoice has been posted.
Laytime Calculator Form Improvements
A few improvements have been made to the standard Laytime Calculator form:
The "Laytime Expires" checkbox has been renamed as "Show Demurrage Start" to better reflect its function
The “Once On/Always On Dem" checkbox previously required that the "Laytime Expires" / "Show Demurrage Start" checkbox was enabled alongside it. That dependency has been removed: when "Once On/Always On Dem" is enabled, the DEMURRAGE START row will now be automatically inserted in the activity grid, whether or not "Show Demurrage Start" is enabled, and Always On Demurrage will be applied consistently.
When both "Once On/Always On Dem" and "Show Demurrage Start" are disabled, the automatically-inserted DEMURRAGE START row will be automatically removed from the activity grid.
New Configuration Flag Allows for Exposure Handling for Index-Linked Contracts When Using Market Value
CFGApplyMarketValueConcept, "Short Position for Cargo on an index-linked TCI" and "Keep TCTO in exposure when one contract is index-linked" must be enabled
When enabled, an index-linked Time Charter contract that is scheduled with a fixed-rate short contract will remain in exposure and the exposure will be based on the Market Value Rate defined on the voyage for that contract instead of the contract rate.
View Berth Information for Specific Port Calls
Port call berth information has been added to the v1/agent/portcalls/{companyCode}/details Veslink API endpoint, allowing you to view berth information for specific port calls. This includes a new top level Berths element in the response for each berth stay associated with the portcall, as well as a BerthSeqNo for each returned PortCargo.
New Configuration Flag for Capturing Trades With Nonconsecutive Periods and Different Quantities Per Period
CFGPaperTradePeriods must be enabled
When enabled, paper trades can be created for multiple non-consecutive periods with differing quantities in each period.
New Ability to Display/Hide Off Hire and Off Hire Reversals in Hire Statements
You can now hide or display individual off hire and off hire reversals from time charter in (TCI) and time charter out (TCO) forms.
Updated Configuration Flag Links Estimated Demurrage Per Port
When CFGEnableMultiEstDem is enabled, you can break down Estimated Demurrage by counterparty and by port.
By Counterparty:
Select the counterparty to make the Estimated Demurrage calculation per charterer rather than per voyage. With no charterer entered, the calculation represents all charterers of the voyage without a charterer-specific Estimate. CFGAllowEstLaytime must also be enabled.
By Port: Estimated Demurrage records can be linked to specific port calls within a voyage. Only ports where the selected counterparty’s cargo is handled will be available for selection. When an Estimated Demurrage record is linked to a port call, its description in the Voyage P&L will note as much, and it will be superseded as appropriate by actual demurrage entered via Laytime Calculations.
Berth Schedule Grids Now Sorted By First Columns, Not By Allocation
Berth Schedule grids are now sorted by their first columns, and their order won’t change when an allocation is made.
Compare Estimated and Actualized Berth Activity Times
When you enter estimated times in the Berth Management screen, they will remain as estimated, even after you've entered an actualized time in the Port Activities screen. Actualized times are no longer shown in the Berth Management screen.
LVOC Unit of Measurement Now MT
Changed LVOC unit from m3 to MT on Veslink forms.
New Ability to Display/Hide VC Ins in the Cargo Book
You can now display or hide VC in cargoes in the Cargo Book list in both the Scheduling and Cargo Book Workspaces by selecting or unselecting the “Include VC Ins” check box, which is now visible under Program filters.
February 2021
New Controller Filter Added to TC Schedules
A Controller filter has been added to the list of available filters in the TC Payment Schedule, TC Billing Schedule, Bareboat Payment Schedule, and Equipment Payment Schedule workspaces. To filter by controller, select an existing controller value from the dropdown list and all schedule items with a matching controller value will be shown.
New Configuration Flag Automatically Creates Commissions Invoices When Freight Is Posted
Requires configuration flags CFGAutoGenerateFreightComms and CFGAutoNumberPayables
When enabled, freight commission invoices will automatically be created when the corresponding freight invoice has been posted.
New Add To Hire Check Box for Adding Individual Delays as Hire Delays
You can now add individual delays as hire delays using the Add To Hire check box in the Off Hire tab of a Time Charter form. Additionally, the existing Add Off Hire check box was renamed Add All Off Hires to better reflect its existing functionality.
Bareboat Data Points Added to Reporting
Bareboat contracts can now be reported on in the Report Designer, via a join from the Time Charter Contract table.
New Configuration Flag Pins Port Column in Each Tab in Estimator Itinerary
Requires configuration flag CFGEnableDefaultColumnPinning
When enabled, certain grids in Estimates and Voyage Manager will have Port names pinned to always remain visible within a view.
January 2021
Remarks Text Box in Estimates Enlarged for Increased Character Limit
Requires database schema version 30.9 or higher
The Remarks box in Estimates has been resized from 256 to 512 characters to accommodate longer comments.
DWT, DWF%, and Use Scrubber Info Added to Voyage Estimate Column, Use Scrubber Check Box Added to Details View
DWT information, DWF% information, and a "Use Scrubber" check box have been added to the Voyage Estimate Column View. Additionally, a "Use Scrubber" check box has been added to the Voyage Estimate Details View.
Benchmark Estimate Workflow Added to TC Out Contracts
A Benchmark Estimate workflow has been added to the TC Out contracts behind the CFGTCOutBallastExposureCapture and CFGEnableBenchmarkEstimate configuration flags. When enabled, you will have the ability to create a Benchmark TCTO estimate and link that to a TC Out contract. The Ballast days and bunkers will be automatically captured at the contract level from the Benchmark Estimate.
New Check Box Added to TC Contract and Trade Routes Form to Define Calculated Route as a Split Route
Requires the Trading module
A new check box has been added to the Trade Routes form to define a calculated route as a "split" route. When a route with the check box selected is used to define the exposure details on a TC contract then the TC exposure will be split across the routes that are defined in the formula for the calculated route. This split will be both for the Exposure Days and the Exposure amount.
Additionally, the check box has been added to the Exposure details on the cargo form so you can de-select this on trades that you do not want to split.
This split route exposure will allow you to properly capture the exposure of vessels that do not fit into a specific class or type against the indices for the correct amounts.
New Ability to Duplicate Off Hire Line in Delay Window
Two new options have been added to the right-click menu for off hire delays in the Delays form.
Duplicate Off Hire: Creates a new off hire with the same details as the original off hire
Duplicate Off Hire to Reversal: Creates a new off hire reverse with the same details as the original off hire
New Configuration Flag Supports Prorating Lumpsum Freight Across Bookings
Requires configuration flag CFGAllocateLumpsumFreight
When enabled, cargoes that share the following properties will share their lumpsum freight, instead of each receiving the full amount:
Linked to the same booking
Scheduled on the same voyage
Have the Use Booking Qty on Scale Table check box selected
Derive lumpsum freight from the same scale table (either through Advanced Pricing or the Price Matrix)
The amount allocated to each cargo on the booking is proportional to its BL quantity.
“Save Estimate” Action/Button Added to Cargo Book Scheduling Workspace
In the Scheduling workspace, you can now right-click a Cargo Book line to save a cargo as an estimate, making it so you can automatically populate an estimate with all relevant cargo information.
Barge Visibility Added to Berth Scheduling Gantt
Now, if barges are filled out in the Bill of Lading (BL) Info tab of a voyage, they will be visible in the Berth Scheduling tool.
New Group By Vessel Option in Vessel Schedule
You can now group by vessel in the Vessel Schedule, instead of just by company.