> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnilinker.pl/llms.txt
> Use this file to discover all available pages before exploring further.
# Agreed promotions
> Record promotions you agreed with a reseller so their prices count as compliant until the promotion ends.
When you agree that a reseller may sell below your recommended retail price (RRP) for a while, record it as an agreed
promotion. While the promotion runs, the reseller's gaps inside it count as compliant instead of as gaps. When it ends,
any price still below RRP comes back into a case.
An agreed promotion belongs to one reseller in one market. It covers:
* gaps **below** RRP only. Offers above RRP are never covered;
* the products you choose: every product in a case, some product ranges, or single products;
* the days from **From** to **Until**, both included, in your organisation's time zone. A promotion can last at most
120 days;
* prices no deeper than the **Agreed depth (% below RRP)**, between 0.1% and 90%. A price deeper than that still
counts as a gap. Leave the depth empty to cover any depth.
## Record a promotion from a case
You need the **Manage cases** and **Agreed promotions** permissions.
On the **Cases** tab, select the reseller's case and click **Agreed promotion** (or press **P**). You can also
choose **Mark as agreed promotion** in the reseller record, which opens the same dialog on the reseller's case.
Under **Which products**, choose one:
* **Everything in this case**, the default;
* **Product ranges**, then click the ranges to include. This option is hidden when the case has a single range;
* **Products**, then tick products of the case. With the **Product Overview Management** permission you search
your catalog instead.
**From** and **Until** start as today and 13 days later (14 days in all). **Agreed depth (% below RRP)** starts at
10\. Add a **Note for the record (optional)** of up to 1,000 characters.
**What happens** is worked out from the current figures, for example:
* "12 gaps on 8 products stop counting until 30 Sep."
* "Compliance moves from 84.2% to 87.9%."
* "2 gaps deeper than 10% keep counting."
* "On 1 Oct any product still below RRP comes back into this case, marked as a promotion that did not end."
Click **Save agreed promotion**. The case logs "Agreed promotion until …", and the dashboard is recalculated.
## Record promotions from All gaps
You can also mark gaps directly, without a case. You need the **View Price Violations**, **Cases** and **Agreed
promotions** permissions.
1. On the **All gaps** tab, select the gaps below RRP. Gaps above RRP cannot be covered.
2. Click **Mark as agreed promotion** in the bulk bar.
3. Set **From**, **Until**, the depth and an optional note. The dialog records one promotion per reseller and market
covering the selected gaps, and names the resellers.
4. Click **Save agreed promotion**.
An undo bar stays up for 8 seconds: click **Undo** to cancel the promotions you just created.
Apart from that undo, you cannot change or cancel an agreed promotion from the dashboard, and there is no list of
promotions to review. The **Agreed promotion** queue on the **Cases** tab lists cases whose open gaps are all
covered, not the promotions themselves. Check the window and depth before you save.
## What a promotion changes
While a promotion runs, a gap it covers:
* counts as **compliant**. Compliance reads "N of M comparable offers are compliant (within ±5% or in an agreed
promotion)";
* leaves the gap counts: the **All gaps** badge, **New**, **Deeper**, **Critical**, the depth bands, and the **Where to
act** cards. It keeps its band, so you still see how deep it is;
* is hidden from **All gaps**, unless you tick **Include gaps covered by an agreed promotion** in the filters. Its
**Case** column then reads **Agreed promotion · until** the last day;
* shows as **In agreed promotions** in the price map's stats and "In an agreed promotion" on its matrix cell;
* is left out of reminders and follow-ups to the reseller.
A case whose open gaps are all covered moves to the **Agreed promotion** queue and asks for no messages or follow-ups.
You can close it with the reason **Agreed promotion**.
The trend chart on the **Overview** marks the days a promotion started and ended, and lists them under **What
happened** with an **Agreed promotions** link to the **Agreed promotion** queue on the **Cases** tab. Each day's hover
card counts the offers **covered by an agreed promotion** that day.
## When a promotion ends
* Seven days before the end, the **Overview** shows an **Agreed promotion ending** card, and the weekly digest lists
it as a decision.
* After the last day, Omnilinker checks the covered products. Any still below RRP go back into the case the promotion
was agreed in, or the reseller's open case in that market, or a new case. They are marked "still below the reference
after the agreed promotion ended", and the case moves to **Needs action** with **Agreed promotion ended**.
* If every price is back within tolerance, the case only records "Agreed promotion ended".
See [Cases](/pricing-intelligence/manufacturer-dashboard/cases) for working through the case afterwards.