# Maintaining Derivatives

### Editing a Derivative

Click any row in the derivatives grid to open the detail drawer. All header fields can be edited directly in the drawer.

***

### Derivative Lines (Periods)

A Derivative Line represents a settlement period within the contract. A single derivative can have multiple lines — for example, one per month across a six-month hedging period. Each line captures the volume and the period dates for that settlement.

#### Adding a Line

1. Open the derivative drawer.
2. In the **Derivative Lines** section, click the add action on the lines grid.
3. Fill in the fields.
4. Save.

#### Derivative Line Fields

| Field                      | Description                                                               | Required |
| -------------------------- | ------------------------------------------------------------------------- | -------- |
| **Period Start**           | Start date of the settlement period                                       | Required |
| **Period End**             | End date of the settlement period                                         | Required |
| **Quantity**               | Volume covered in this period (e.g. MT of bunker, number of freight lots) | Required |
| **Measurement**            | Unit of measurement for the quantity (e.g. MT, Lots)                      | Required |
| **Fixed Rate**             | The agreed strike price for this period                                   | Required |
| **Fixed Rate Currency**    | Currency of the fixed rate. Defaults to USD                               | Required |
| **Clearing Rate**          | Clearing rate if the contract is cleared via a clearinghouse              | Optional |
| **Clearing Rate Currency** | Currency of the clearing rate                                             | Optional |

#### Editing and Deleting Lines

Edit a line by clicking its row in the grid. To remove a line, use the delete action on the row.

> Deleting a line also removes any voyage allocations attached to it.

***

### Commissions

Derivative contracts often involve broker commissions. One or more commissions can be recorded per derivative. The commission amount is calculated automatically — it is not manually entered.

#### Adding a Commission

1. Open the derivative drawer.
2. Scroll to the **Commissions** section.
3. Click **Add Commission**.
4. Fill in the fields.
5. Save.

#### Commission Fields

| Field                 | Description                                                                   | Notes     |
| --------------------- | ----------------------------------------------------------------------------- | --------- |
| **Counterpart**       | Broker or party receiving the commission                                      | Required  |
| **Rate**              | Per-unit rate. Commission = rate × total quantity across all derivative lines | Optional  |
| **Percent**           | Percentage of total value. Commission = total qty × fixed rate × percent      | Optional  |
| **Lump Sum**          | Fixed flat amount. No calculation applied                                     | Optional  |
| **Commission Amount** | Calculated and stored automatically                                           | Read-only |

All three inputs (Rate, Percent, Lump Sum) can be used in combination. The total commission is the sum of all three calculations.

#### Editing and Deleting Commissions

Edit a commission by clicking its row. Delete it using the row delete action. Commissions are linked to the derivative header, not to individual lines.

> Invoicing of commissions is out of scope for this release. Commission amounts are stored for reference only.

***

### Deleting a Derivative

Select the derivative and use the Delete action. Deleting a derivative permanently removes all its lines and voyage allocations.

> To retire a contract without losing the data, change the status rather than deleting the record.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dataloy.com/voyage-management-system/step-by-step-guides/finance/derivatives/maintaining-derivatives.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.