Overview of Voyage P&L ConceptsConcepts
To learn more about snapshot types, columns in the P&L grid, or snapshot and period comparisons, see the VIP - P&L - Voyage article.
Store Voyage P&L snapshots
Current P&L snapshots are stored when you do one of the following:
Save the voyage with the configuration flag CFGCacheVoyPnl enabled.
To allow auditing changes to the current snapshot, enable the configuration flag CFGEnablePnlSnapshotAudit.
Run a scheduled task through a message service that takes nightly snapshots.
When the configuration flag CFGAutoPnlSnapshot is enabled, VIP will take a snapshot when the financials of the voyage change, for example, when new invoices are added or if there are interface imports of port expenses.
There can only be a single instance of a current PNL snapshot Voyage PNL snapshot in the database. The current PNL snapshot is identified as Current in the Snapshot Type field.
Create a Voyage P&L report in the Report Designer
...
To access Analytics, in the top navigation, click Analytics. The Reports workspace appears.
Select Voyage P&Las the starting table from the report list
...
. Filter to one voyage to start. You can expand the report to include more voyages as needed.
Join the Voyage Pnl dataset to it.
Select the snapshot date, snapshot type, data type (A for Actual, E for Estimated, or P for Posted if needed), the comparison basis to Actual values, the variances to include, and any additional information.
To get more granular data for the voyage P&L report, you can optionally join the following tables to the initial Voyage table:
Voyage Pnl Detail
Voyage Pnl Drilldown
...
Create a report using the Voyage PNL Summary dataset (one-to-many join from the Voyage table).
This report shows you Actual, Posted, and Estimated values in one with full line descriptions. This will show the same data you see in the Voyage Manager’s P&L grid with Operations or Accounts View views selected.
...
You can set the following parameters to make this data more useful:
Set the Is Accounts Mode filterto True to enable the aggregation of the data by ledger code. This will emulate the Accounts view in the P&L grid. The dataset will produce Operations view results by default.
Set the Force Calculation filter to True to allow force-recalculation of the report numbers to give you the most up-to-date P&L numbers for the voyage. Otherwise, the report will use either the current Voyage P&L snapshot or any snapshot uniquely identified by Snapshot Type and Snapshot Date filters. If there are multiple P&L snapshots of the same type on the same date, VIP will use the most current snapshot for that date.
Set the Include Details filter to True to see line items under each account group; otherwise, VIP will display only the account groups.
Set the Is Monthly filter to True to get data for each snapshot by the month
Use the Period Range Gmt parameter to specify a period during which Pnl values should be pro-rated. Use the Portion % column to see what portion of the voyage falls into the specified date range.
To get more granular data for the voyage P&L report, you can optionally join the following tables:
...
VIP will use all related configs when pro-rating values (non-accrual snapshots - CFGDefaultPnlCalcApplyTcHire, CFGDefaultPnlCalcAdjustForOffHire, CFGDefaultPnlCalcApplyOffHire etc). The flags that PNL snapshot was taken with (except the accruals configuration flag) are not stored with a snapshot.
Legacy P&L Summary report
...