This is a Key Topic, with high value for all users.
Walkthrough: Scheduling a Voyage
These breadcrumbs show where you are in the walkthrough. To move to a different section, click its link:
The Cargo List contains all Cargo contracts that you have the right to view.
On the main menu , under Chartering, next to Cargo, click List.
On the Trading menu , under Trades, next to Cargo, click List.
On the Chartering menu , under Cargo, next to Cargo, click List.
In the Chartering quick links, click .
By default, the following filters are applied, but you can change them:
Status is not in the list Canceled, Withdrawn
Laycan From is on or after 365 days in the past
These contracts also appear in the Cargo Schedule.
Statuses on the Cargo List
Statuses on the Cargo List relate to its association with a voyage:
Associated with Voyage?
Status on Cargo List
Row and Card Colors
Row and card colors indicate the following:
Unacknowledged revision via the Messaging Service
Update warning (based on Chartering Lists Settings)
Unacknowledged revision and update warning
To view an existing Cargo, do one of the following:
To create a new Cargo, do one of the following:
On the Cargo List, click +.
Create Cargoes from a Cargo COA.
On the main menu , under Chartering, click Cargo.
On the Trading menu , under Trades, click Cargo.
On the Chartering menu , under Cargo, click Cargo.
If you cannot see a specific Cargo Group that you have created in VIP, please ensure that you have followed the instructions from VIP - Cargo Groups and you have created a Cargo Name with a Short Name matching the Cargo Group Description and have assigned it to the Cargo Group.
You can do any of the following:
As with any other details view, you can navigate to a different record by clicking its card or return to the list by clicking its Name.
To copy a Cargo, click and then click Copy Existing.
Enter the Number of Copies, Total Period, and Start date and then click Create.
Edit line items for the copies as needed and then click OK.
To copy a Cargo to a VC In, click and then click Copy to VC In.
Click Menu ⯆ and then click one of the following:
Attachments: Attach documents or links or double-click to open an attachment. These can only be added once the Cargo has been saved with the mandatory fields.
Templates: Create templates that contain information about the types of cargo you typically carry and use them to create cargoes. Choose one of the following:
Retrieve a template: Select any template from the list of saved templates and edit, save, or delete it.
Make new cargo from a template: Select any template from the list of saved templates to automatically populate the Cargo form with its relevant details.
Convert to a new template: Make additional changes as necessary, enter a new template name, and click Save.
For a relet, if the relet information has not been entered yet, click Relet and complete the VC In form. To edit existing information, click Relet and then click Edit Relet.
If appears, there is a data lock in place: The pricing of the Cargo cannot be changed because it is linked to something else, such as a COA or a Bunker Surcharge Table. Click to see an explanation.
Share a Cargo contract: Copy its URL and then share it with any signed-in users in your organization.
The Cargo form includes the following sections:
When you save the Cargo, it appears on the Cargo Schedule according to its Laycan dates.
When an Alert is entered for a Charterer, a Vessel, or a Port, the field is highlighted in light red.
Additional information for the current workspace is available in panels on the right:
Adding a Cargo to an Estimate
To create a Voyage Estimate from a Cargo, click Estimate and then click Add Cargo to New Estimate. A Voyage Estimate is created with the Cargo and all the defaults from the .TDEFAULT Estimate. If a vessel has been nominated, the new Estimate uses this vessel.
To add the Cargo to an existing Estimate, click Estimate and then click Add Cargo to Existing Estimate. Enter Estimate Search Criteria and select the Estimate.
Creating or Opening a Voyage Fixture from a Cargo
To create a Voyage Fixture from the Cargo, click Create Fixture. All the information from the Cargo moves to the Voyage Fixture and then to the voyage.
After the Voyage Fixture is created, the button changes to Open Fixture.
Scheduling or Opening a Voyage from a Cargo
To create a voyage from the Cargo, click Schedule Voyage. All the information from the Cargo moves to the voyage.
After the voyage is created, the button changes to Open Voyage.
Note: Port expenses and base expenses set on the Cargo contract will create estimated port costs on the voyage and appear in the actual P&L.
Bulk Updating Cargoes
Note: Configuration flag CFGEnableCargoBooking must be set to N.
If you have the Bulk Update Cargo Contracts Module Right selected, under Actions in Chartering, a column of check boxes appears in the Cargo List. To bulk update Cargoes, select the contracts you want to update and then click the Bulk Update action link at the top of the list. To select multiple consecutive rows, select the first row and then press and hold Shift. Select the last row and then release Shift.
This feature cannot be disabled.
To acknowledge all highlighted revisions, on the Cargo or VC In Revisions panel, click ... and then click Acknowledge Revisions.
If a disabled Cargo Name is already selected as an available cargo type in a COA, it can be selected in a lifting. It is expected behavior that existing records (such as a Cargo contract) are not updated when their Cargo Name is disabled.
For consistency, if a Cargo Name has been defined in a COA as an available cargo type, making it a contractual term, the system still allows you to select it in a lifting. As a solution for this record, once the cargo is removed from the cargo type in the COA, you will no longer be able to create a Cargo using the disabled Cargo Name.
When the Enable Cargo Emissions Allocation flag (CFGEnableCargoEmissionsAllocation) is enabled in an IMOS environment, a new Emissions tab will become visible on the Cargo and VC In contracts. This tab is to be used to capture the contractual details that were agreed to with the counterparty on the contract for how emissions expenses will be settled over the life of the contract. Clicking on this Emissions tab on a Cargo Contract will show the following three fields:
Settlement Type - Defines how the contract is structured to settle emissions expenses.
Options are N/A (default), CASH, ALLOWANCES and HYBRID
Billing Period - Defines the period frequency that the emissions expense will be invoiced
Payment Terms - Defines the terms for how the invoices are to be paid/settled following receipt or delivery
Uses the Payment Terms as they are defined in the Data Center
Enable Cargo Status Security
When enabled, the Edit Confirmed Cargo Contracts Module Right will be used to allow editing of confirmed Cargo/VC In records by a user.
Enable Multi Grade
For vessels such as product tankers with the same kind of Cargo in several grades, enables Multigrade Cargoes: Changes the Cargo field to Cargo Group and adds a Cargo Grade column (for the Cargo Name within the Cargo Group) to the Itinerary/Options tab.
The Freight Invoice automatically adapts its format to display the Cargo Group, followed by the individual grades.
Note: The setting of this config flag determines which variable is available, and whether the No. of Grades variable is available, on the Pricing Rule form:
When the Cargo Grade variable is used in a Rule, its evaluation is done based on the order of Grades in the itinerary.
Uses the Charterer's view instead of the standard Cargo form. When enabled:
Sets the default number of days after the Laycan From for the Laycan To.
Use Company Lob Trade Area Hierarchy
Sets up a hierarchy between Company, LOB, and Trade Area on several forms.
Clear Company Lob on Copy
Clears the Company, LOB, and Department values when copying a Voyage Fixture or contract.
Show Remittance in Cargo
Adds Remittance Bank, Invoice %, Payment Terms, and Balance % fields to the CP Terms Details, Cargo COA, Cargo, VC In COA, and VC In forms. Also adds a Remittance Bank field to Time Charter Other Information. Remittance information flows between these places; for example, fixing an Estimate will transfer the remittance information.
Contract Reference URL
Converts the Contract Link field to a Hyperlink. This is used to interface with third-party systems such as Chinsay.
Schedule Max Lift
Sets the Cargo CP Quantity to the Max Lift Quantity when scheduling a single cargo voyage where discharge is after all loads in the itinerary, using Create New Voyage from a COA or a Cargo or Schedule Voyage from a Cargo. After initial scheduling, all changes to CP Quantity must be made manually; there will be no automatic updates.
Delete Fixture Upon Voyage Deletion
When a voyage is deleted, its Voyage Fixture is also deleted. If the voyage was created from a Cargo COA (with CFGPreserveGeneratedCargoes disabled), the voyage's Cargo is deleted as well.
Reset COA Lifting Upon Fixture Deletion
When a Voyage Fixture is deleted, and its Cargo is a COA lifting, or when a COA Cargo is unscheduled by removing it from a voyage, the lifting is reset as follows:
Enable Benchmark Estimate
On the Estimate Properties panel, a Benchmark check box appears. To mark an Estimate as a Benchmark Estimate, select the check box. Benchmark Estimates must have exactly one cargo, and they cannot be fixed.
On COA and Cargo/VC In forms, an Exposure tab appears. If a cargo is linked to a Benchmark Estimate via the Exposure tab, the market rate will be used as the TCE in the Benchmark Estimate and back-calculate the $/ton rate in the Trading Profit and Loss.
Enable Contract Mirroring
Enables the following types of intercompany contracts to be mirrored: Cargo COA, VC In COA, Cargo, VC In, Time Charter In, Time Charter Out, and FFA/Option/Bunker Swap Trade. When a contract of one of these types is created with internal counterparties, a mirrored contract is automatically created from the opposite perspective, so that users from both legal entities can manage the contract and include it in both their operational planning and their trading exposure and P&L.
Allow Counterparty Overwrite
Displays a warning message when the Charterer field is changed on a COA-linked Cargo form.
Default Claim Commission Invoice Setting
Enable Lift Quantity Descriptions
Enables Quantity Descriptions, which can be used to indicate the status or intent of cargo lift quantities. You can select a Quantity Description in the Description column on CP Terms Details and Cargo itineraries.
Enable Broker Rules
Also adds Add Default Brokers to the TCO Estimate toolbar to default internal brokers by applicable rules.
Cargo Import Check Actual Invoice
If enabled, then when a Cargo message is received through the interface, if there exist any corresponding Freight Invoices with status Actual, the Cargo message does not update the Cargo form and generates a return code of -2. For more information, see the IMOS Messaging Service Manual.
Enable Operations LOB
If enabled, displays an LOB (Line of Business) field on the Address (Type W), Estimate, Voyage Fixture, Voyage, and contract forms.
Copy Cargo Reference to Voyage
If enabled, when scheduling a voyage from a Cargo, the voyage's Reference field is populated with the value from the Cargo.
Hides the Port Expense field on some forms, enables standards for expenses, and adds a Port Expenses Details form and a Port Expenses Details button on the Port Expenses Summary to open it. When detail-level port expenses are being used, the PortExp column in the Voyage Itinerary behaves the same as the PortExp column in the Estimate itinerary:
An ECA Factor field also appears on COA, Cargo/VC In, and CP Terms Details forms. When ECAFactor is used in an IMOS ECA Recovery Charge Results/Fee expression and an ECA Factor value is entered on a contract, an ECA Recovery Charge Extra Freight Term is generated on that contract.
Enable Cargo Booking
Enables the Cargo Booking form.
Adds an option to Keep Booking No. when copying a Cargo or VC In.
Adds a Booking No. field to nonincremental Freight Invoices; after a Counterparty is selected, you can select one booking of that Counterparty on the voyage, so that only those Cargoes are included on the invoice.
Determines whether the No. of Cargoes in Booking variable is available on the Pricing Rule form:
Enable Voyage Manager Cargo List
Adds Cargo and Cargo Handling tabs to the Voyage Manager. The Cargo tab is similar to the Cargo List, but only includes cargoes associated with the voyage. The Cargo Handling tab is similar to the Cargo Handling form; it includes a list of all cargoes associated with the voyage, with a line for each load and discharge. Lines highlighted in yellow indicate transshipment cargoes, while lines highlighted in blue indicate interservice cargoes.
If a Cargo or VC In has at least one unacknowledged revision, its row is highlighted in the Cargo List.
Cargo Import Check Actual Invoice
If enabled, then when a Cargo message is received through the interface, if there exist any corresponding Freight Invoices with status Actual, the Cargo message does not update the Cargo in IMOS.
Enable Cargo Delivered
Enables you to save Cargoes, VC Ins, or bookings with only a load or discharge port.