# Tiered Demurrage/Despatch Rate

Demurrage rate tiers and despatch rate tiers allow you to define different charges based on cargo duration. Instead of applying flat rates, you can create multiple tiers where:

* **Demurrage tiers** specify charges when cargo exceeds laytime
* **Despatch tiers** specify credits when cargo clears before laytime expires

This creates aligned financial incentives: **charterers are penalized for delays and rewarded for faster operations**.

#### How tiered rates are applied

Tiered rates follow the same aggregation rules as static rates. How the tiers are applied depends on whether the laytime calculation is reversible or non-reversible:

* If the laytime calculation is **reversible**, the tiered rates are applied to the **total laytime used across all cargo ports**
* If the laytime calculation is **non-reversible**, the tiered rates are applied **separately for each cargo port**

<details>

<summary><strong>Examples of Tiered Demurrage and Despatch Calculations</strong></summary>

### Tiered demurrage rates

#### Scenario

<table><thead><tr><th valign="top">Parameter</th><th valign="top">Value</th></tr></thead><tbody><tr><td valign="top">Laytime allowed</td><td valign="top">3 days</td></tr><tr><td valign="top">Time used</td><td valign="top">7 days</td></tr><tr><td valign="top">Time lost</td><td valign="top">4 days</td></tr></tbody></table>

#### Demurrage rate tiers

<table><thead><tr><th valign="top">From (Days)</th><th valign="top">Up to (Days)</th><th valign="top">Rate</th></tr></thead><tbody><tr><td valign="top">0</td><td valign="top">2</td><td valign="top">$8,000 per day</td></tr><tr><td valign="top">2</td><td valign="top">4</td><td valign="top">$12,000 per day</td></tr><tr><td valign="top">4</td><td valign="top">∞</td><td valign="top">$16,000 per day</td></tr></tbody></table>

#### Calculation

<table><thead><tr><th valign="top">Tier range</th><th valign="top">Days applied</th><th valign="top">Rate</th><th valign="top">Amount</th></tr></thead><tbody><tr><td valign="top">0-2</td><td valign="top">2 days</td><td valign="top">$8,000</td><td valign="top">$16,000</td></tr><tr><td valign="top">2-4</td><td valign="top">2 days</td><td valign="top">$12,000</td><td valign="top">$24,000</td></tr><tr><td valign="top">4+</td><td valign="top">0 days</td><td valign="top">$16,000</td><td valign="top">$0</td></tr></tbody></table>

**Total demurrage**: $40,000<br>

***

### Tiered despatch rates

#### Scenario

<table><thead><tr><th valign="top">Parameter</th><th valign="top">Value</th></tr></thead><tbody><tr><td valign="top">Laytime allowed</td><td valign="top">3 days</td></tr><tr><td valign="top">Time used</td><td valign="top">2 days</td></tr><tr><td valign="top">Time saved</td><td valign="top">1 day</td></tr></tbody></table>

#### Despatch rate tiers

<table><thead><tr><th valign="top">From (Days)</th><th valign="top">Up to (Days)</th><th valign="top">Rate</th></tr></thead><tbody><tr><td valign="top">0</td><td valign="top">2</td><td valign="top">$4,000 per day</td></tr><tr><td valign="top">2</td><td valign="top">∞</td><td valign="top">$6,000 per day</td></tr></tbody></table>

#### Calculation

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Tier</p><p>Tier</p></td><td valign="top"><p>Days applied</p><p>Days applied</p></td><td valign="top"><p>Rate</p><p>Rate</p></td><td valign="top"><p>Amount</p><p>Amount</p></td></tr><tr><td valign="top">0-2</td><td valign="top">1 day</td><td valign="top">$4,000</td><td valign="top">$4,000</td></tr><tr><td valign="top">2+</td><td valign="top">0 days</td><td valign="top">$6,000</td><td valign="top">$0</td></tr></tbody></table>

**Total despatch credit:** $4,000

</details>

### Set Tiered Rates

1. On demurrage or despatch rate field, click the <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/1IzbPhhGqxdXxl17Sc5i/image.png" alt="" data-size="line"> icon to set the tiered rate.&#x20;

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/WAAwP1F9V8RkOzDCnDb2/image.png" alt=""><figcaption><p>Fig. 1: Demurrage Rate Tiers modal with empty tiers</p></figcaption></figure>

2. To proceed, click the <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/AjLgss8XrdFGsDsOp2zy/image.png" alt="" data-size="line"> button. then enter a value in the **Up to (Days)** field to define the upper limit of the rate.

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/4lStakr7ayc2S9TdpAKg/image.png" alt=""><figcaption><p>Figure 2.1: Add Tier modal</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/YD6UMLiOW2wlZOvw9P58/image.png" alt=""><figcaption><p>Figure 2.2: Initial tiered demurrage rates after 'Add' button is clicked</p></figcaption></figure>

3. Once a row is added, the grid becomes editable. You can directly modify the **Days** and **Rate** fields, or remove a tier by clicking <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/OoEgtlSxvgAcdsjIrCLZ/image.png" alt="" data-size="line">.&#x20;

{% hint style="info" %}
Edit fields by clicking on them. Navigation within the grid is possible using the arrow keys, and fields can be edited by typing directly
{% endhint %}

{% hint style="info" %}
The system automatically sets the row with the largest **Up to (Days)** value as the final tier and extends its **From (Days)** value to infinity. This is automatically updated whenever the largest **Up to (Days)** value changes.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/0GlD97A3GrXiCMR52ywt/image.png" alt=""><figcaption><p>Figure 3.1: Modified the rate of the last row to 35,000</p></figcaption></figure>

Repeat step 2 to add new row.

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/pZqds2g849mWo90507Hb/image.png" alt=""><figcaption><p>Figure 3.2: Grid state after adding an additional row, illustrating how the last row’s From Days value is automatically updated when a new maximum Up to (Days) value is defined</p></figcaption></figure>

{% hint style="info" %}
The Rate Tiers modal follows these rules:

* The first tier always starts at **0**, and the last tier always ends at **infinity**.
* **From Days** and **Up to Days** cannot have the same value.
* The **Up to Days** value must be greater than the corresponding **From Days** value.
* Updating **Up to Days** automatically updates the **From Days** value of the next tier.
* Changing the **From Days** value of the last tier to a value smaller than the **From Days** values of previous tiers will delete the affected previous tier(s).
* The **Rate** field is not bound by any rules and must be set individually for each tier.
  {% endhint %}

4. Click <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/M39bLj1K39OIBKWIbido/image.png" alt="" data-size="line"> to finalize the tiered rates. <br>

   <figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/yGGS9AZZHeNBRIfD6xqD/image.png" alt=""><figcaption><p>Figure 4: Demurrage/Despatch Rate fields with set tiered rates</p></figcaption></figure>

The rate fields will be shown as 'Tiered', with the icon highlighted accordingly.<br>

5. Clicking <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/NDiHVTy4CrWe07zrTTqS/image.png" alt="" data-size="line"> will open the Demurrage/Despatch Rate Tiers modal displaying the existing tiered rates. Here you can add, edit, or delete individual tiers. You may also **remove** **all** the tiered rates by clicking <img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/4JCwI4brYyTPOrF2IXVv/image.png" alt="" data-size="line"> button and confirming the action.

<figure><img src="https://content.gitbook.com/content/BOXrRRsrTBcdaVWqOIzi/blobs/kpM2om0c4NnzSMeGV9Mq/image.png" alt=""><figcaption><p>Figure 5: Existing demurrage tiered rates</p></figcaption></figure>

{% hint style="info" %}
Tiered rates operate independently. Therefore, adding tiered demurrage rates does not affect or apply to tiered despatch rates.
{% endhint %}


---

# 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/release-8.23/voyage-management-system/step-by-step-guides/operations/laytime-calculations/maintain-laytime-calculation/tiered-demurrage-despatch-rate.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.
