# Main Details

## KPIs

<figure><img src="https://1154361060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbpRXlpuknwnd2ADVp6vn%2Fuploads%2FLMGKmK4FZSwIyxIxGDa8%2Fimage.png?alt=media&#x26;token=0b50b5ea-85a6-41de-b073-4fed79ee4a30" alt=""><figcaption><p>KPI Tiles in Cargo Main Details tab</p></figcaption></figure>

At the top in the main details you will find the KPI-cards.

* **First tile**: Cargo quantity is the actual quantity, and booked is the booked quantity.
* **Second tile**: Freight is the total freight for the cargo.
* **Third tile**: Commission and various costs.
* **Fourth tile**: Net Fio is all cargo related revenue aggregated and then deduct all aggregated cargo cost - divided by the quantity of the cargo.



## Main Cargo Details

Below the KPI tiles is the Main Cargo Details section on the left side:

<figure><img src="https://1154361060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbpRXlpuknwnd2ADVp6vn%2Fuploads%2F5qK8kwmOX4fdPqhe5IQ9%2FSkjermbilde%202024-08-06%20kl.%2016.30.52.png?alt=media&#x26;token=1b663907-8270-4a26-a133-631b079027f7" alt=""><figcaption></figcaption></figure>



### **Additional Field Explanations:**

<table><thead><tr><th width="213">Field name</th><th>Disabled when</th></tr></thead><tbody><tr><td>Nominated Quantity</td><td>Quantity agreed in charter party (available when cargo status is before Clean Fix).</td></tr><tr><td>B/L Quantity</td><td>Sum of the quantities on all load cargo ports (available for cargo status Clean Fix and Loaded).</td></tr><tr><td>Freight Rate</td><td>Weighted average of freight rates on the discharge cargo ports.</td></tr><tr><td>Deadfreight Rate</td><td>Is set to Freight Rate value when creating a new cargo, or copying a cargo, by default. The field can be changed to a desired value after creation.</td></tr></tbody></table>

\
\
All fields that are enabled can be changed from this view. The following fields will be disabled under the following conditions:

### Overview of Fields:

| Field name                     | Disabled when                                                                                                                      |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| Nominated Quantity/BL Quantity | The Cargo has one or more SubCargos, or if there are load/discharge amount on CargoPorts that are not the first in the timeline.   |
| Minimum Quantity               | Tolerance Option is not set to "MOLOO" or "LOO"                                                                                    |
| Cargo Measurement              | The Cargo has one or more SubCargos, or if there are load/discharge amount on CargoPorts that are not the first in the timeline.   |
| Freight Rate                   | The Cargo has one or more SubCargos, or the CargoPorts have different freight rates, or the Cargo has multiple freight rate tiers. |
| Rule                           | The cargo has one or more freight rate tiers.                                                                                      |
| Flat Rate                      | Rule is not set to "World Scale"                                                                                                   |
| Tolerance                      | Tolerance Option is not set to "MOLCO" or "LCOPT"                                                                                  |
| Broker Commission              | The Cargo has one or more Commissions connected to it                                                                              |
| Demurrage Rate                 | One or more of the Cargo Ports have a demurrage rate                                                                               |
| Despatch rate                  | One or more of the Cargo Ports have a despatch rate                                                                                |
| Performance Cargo              | The Cargo does not have a Voyage connected to it                                                                                   |



## Stowage

Below Main Cargo Details section, there is a section for inputting fields and checkboxes regarding the stowage values of the cargo:

<figure><img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/Z6hJg7tux98QFyUhoobj/Skjermbilde%202024-08-06%20kl.%2016.32.57.png" alt=""><figcaption><p>Stowage Section</p></figcaption></figure>

{% hint style="info" %}
If the optional preference **SF\_INTAKE\_CALCULATION** is enabled on your company's system, stowage factor will change from being System Volume Unit / System Weight Unit, to Cubic Feet / System Weight Unit
{% endhint %}



## Cargo Port Timeline

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.

![Cargo Port Timeline section](https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/2uPzMMu1GyS8TqHPypgh/Skjermbilde%202023-04-21%20kl.%2015.27.43.png)

To add a cargo port, click on the <img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/gVeDZHO90gEIdaXFSMCZ/create-24px.svg" alt="" data-size="line">-icon in the top right corner. To edit a cargo port or delete a cargo port hover one of the cargo ports in the timeline and the below view will appear:

![Add, edit or delete a cargo port](https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/IdYkiDFj5wEfhkL75f5h/Skjermbilde%202023-04-21%20kl.%2015.29.04.png)

<figure><img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/auYqnwMfLvLxaV8vkyud/image.png" alt=""><figcaption><p>Create Cargo Port Modal</p></figcaption></figure>

Editing a Cargo Port will give you access to a few more fields, for instance Handling Cost, Laytime Terms and related fields.

<figure><img src="https://1154361060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbpRXlpuknwnd2ADVp6vn%2Fuploads%2FxJvafMIXZWn7OkSuFEhZ%2FScreenshot%202024-10-11%20at%2008.10.45.png?alt=media&#x26;token=f8279e5b-1915-4797-bae1-91d4bebff6b4" alt=""><figcaption><p>Edit Cargo Port Modal</p></figcaption></figure>

{% hint style="info" %}
If the Vessel Type of the Vessel used for the Voyage has "Free Despatch" ticked off, any newly created Cargo Ports will have "Free Despatch" ticked off as well.
{% endhint %}



<figure><img src="https://1154361060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbpRXlpuknwnd2ADVp6vn%2Fuploads%2F4PNeos1rNRjo21VxOKnB%2FScreenshot%202024-10-11%20at%2008.13.23.png?alt=media&#x26;token=e1d86f59-73b8-49a7-9e69-2c286f18ac2e" alt=""><figcaption><p>Edit Cargo Port Modal with handling cost fields disabled</p></figcaption></figure>

{% hint style="info" %}
If the Port Call for this Cargo Port has 'Use Handling Cost from Service Order' checked off, the handling cost related fields will be disabled.
{% endhint %}



## Bunker Adjustments

On the right side, below the Cargo Port Timeline section, you can create/edit and view a list of Bunker Adjustments on the cargo:

<figure><img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/lJg0F8t1jAp1fMVlttQw/Screenshot%202023-06-06%20at%2014.33.26.png" alt=""><figcaption><p>Bunker Adjustments Section</p></figcaption></figure>

You can _create_ a new Bunker Adjustment by clicking the <img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/gVeDZHO90gEIdaXFSMCZ/create-24px.svg" alt="" data-size="line">-icon at the top right of the section, which will bring you to the _Create_-modal. Or you can click on one of the rows to _edit_ the selected Bunker Adjustment, which will open the Edit-modal. If you choose the Adjustment Type to be set to "Freight", you will only see the _Adjustment Factor_ field below. But if you have chosen "Consumption", you will only see the _Agreed Consumption_ field below (the invisible field is not editable and does not affect the calculation). The Freight type is chosen by default.

For both of these options you will be able to choose the bunker types: _DL (LS MGO)_, _DO (MGO)_, _FL (LS FO)_ or _FO_. You can also input/edit the other fields, such as: _Min Price_, _Max Price_, _Adjustment Factor/Agreed Consumption_ and _Price_. The Price field is still editable even though the input of the Min-/Max Price fields calculates the average price.&#x20;

<figure><img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/49Zew2gRCfFmb99ksOCj/Screenshot%202023-06-06%20at%2014.32.43.png" alt=""><figcaption><p>Create/Edit Modal For Bunker Adjustments</p></figcaption></figure>

The _total adjustment_ is calculated if the price is outside the minimum/maximum range, i.e:

* Min range: 500, Max range: 550, Price: 600 => Positive adjustment
* Min range: 500, Max range: 550, Price 400 => Negative adjustment

This calculation you can see as the price value in the second KPI tile by the last field called _Bunker Adjustment_:

<figure><img src="https://1154361060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbpRXlpuknwnd2ADVp6vn%2Fuploads%2FDIX2rRB9B5B82OagIt9s%2Fimage%20(1).png?alt=media&#x26;token=e3aaf40b-7e47-458e-b349-c67f47e20807" alt=""><figcaption><p>Bunker Adjustment in Cargo KPI Tiles</p></figcaption></figure>

### Overview of BA Fields:

<table><thead><tr><th width="344">Fields</th><th>Description</th></tr></thead><tbody><tr><td>Adjustment Type</td><td>Adjustment types, Mandatory(*), defaulted by "Freight"</td></tr><tr><td>Bunker Type</td><td>The different fuel types, Mandatory(*)</td></tr><tr><td>Min Price</td><td>Minimum price range, Mandatory(*)</td></tr><tr><td>Max Price</td><td>Maximum price range, Mandatory(*)</td></tr><tr><td>Adjustment Factor</td><td>Adjustment Factor, Mandatory(*), displays if Adjustment Type is set to 'Freight'</td></tr><tr><td>Agreed Consumption</td><td>Agreed Consumption, Mandatory(*), displays if Adjustment Type is set to 'Consumption'</td></tr><tr><td>Price</td><td>The price, Mandatory(*)</td></tr></tbody></table>



## Miscellaneous

On the right side, below the Bunker Adjustment section, you can enter external reference, Trade, Cargo Text, Comment, Company, Business Unit and Cargo Operator:

<figure><img src="https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/Js3yvMHDPLhpFO4rnCsZ/image.png" alt=""><figcaption><p>Miscellaneous Section</p></figcaption></figure>



## Relets and Transshipments

At the bottom of this tab there is be a list of Relets and Transhipments for the cargo:

![Relets and Transshipments Section](https://content.gitbook.com/content/bpRXlpuknwnd2ADVp6vn/blobs/ZmrKJT9WJmHSI0Wi0rBE/Skjermbilde%202023-04-21%20kl.%2015.34.45.png)



