> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/partner-library/emporix-components/stock-promotion.md).

# Stock Promotion

Stock Promotion is an AI-powered, end-to-end stock clearance value stream that lets business users launch coordinated clearance campaigns across pricing, sales, and marketing.

When products are marked as overstock or a stock clearance case is created, merchandisers and commercial teams can define campaign scope, configure targeted incentives, assign clearance pricing, prepare sales quotes, and publish frontend promotion. They can do that all from this structured process instead of working with multiple spreadsheets, ad-hoc price changes, and disconnected promotional activities.

External triggers from systems such as ERP or data mining platforms can start the flow automatically, so overstock situations are caught and acted on right away. The result is faster inventory turnover for B2B manufacturers, wholesalers, and distributors.

<figure><img src="/files/O6pikDr0QMFfzoLO0Ujv" alt="Stock Promotion value stream flow" width="350"><figcaption><p>Stock Promotion value stream flow</p></figcaption></figure>

## Key features and benefits

| Feature                  | Description                                                                                                                                                      |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Campaign scoping**     | Bind SKUs or product groups, set schedule and owner, and limit the campaign to selected sites or regions. Starts manually or from connected systems such as ERP. |
| **Segment incentives**   | Optional coupons for chosen customer segments; skip when a campaign does not need targeted discounts.                                                            |
| **Clearance pricing**    | Assign overstock products to a discount group and publish a campaign price list for storefront, quotes, and sales tools.                                         |
| **Quotes and discovery** | Optionally generate draft quotes and boost products in search, categories, or recommendations.                                                                   |
| **Storefront promotion** | Attach campaign imagery, configure banners, and publish to the connected content platform.                                                                       |
| **AI-assisted setup**    | Optional agent support for plan drafting; segment-to-product mappings can be reused in later campaigns.                                                          |

## Business use cases

The following use cases are examples of typical business scenarios, your implementation may differ based on project requirements.

<table data-view="cards"><thead><tr><th align="center"></th><th align="center"></th><th align="center"></th></tr></thead><tbody><tr><td align="center"><i class="fa-industry">:industry:</i></td><td align="center"><strong>Clearing excess inventory before write-offs</strong></td><td align="center">A manufacturer receives an overstock signal from ERP. Stock Promotion launches a scoped clearance campaign with targeted segment discounts and updated price lists, moving inventory through webshop and sales channels before it expires or is written off.</td></tr><tr><td align="center"><i class="fa-globe">:globe:</i></td><td align="center"><strong>Running regional clearance without global price erosion</strong></td><td align="center">A distributor needs to clear stock in Germany only. The campaign owner sets region-specific scope and segments, creates a local clearance price list, and leaves pricing in other countries unchanged.</td></tr><tr><td align="center"><i class="fa-calendar">:calendar:</i></td><td align="center"><strong>Coordinated seasonal clearance for wholesalers</strong></td><td align="center">A technical wholesaler runs a quarterly clearance on discontinued or seasonal products. Stock Promotion boosts visibility in search and category listings, applies segment-based incentives for priority customers, and publishes promotional banners across the webshop and partner portals from one campaign.</td></tr></tbody></table>

## Process flow

Stock Promotion runs as three linked value streams. The first two prepare and approve a clearance plan; the third applies pricing, sales, and marketing changes in Commerce Engine and connected channels.

### Planning the clearance

The planning starts when overstock is detected or a clearance case is opened. This value stream creates the campaign instance, sets up dependencies, and produces the clearance plan (scope, targets, and commercial parameters) that later phases use.

<figure><img src="/files/isFVYCjGTJ3xyGrlAqPk" alt="Draft a Stock Clearance Plan value stream"><figcaption><p>Draft a Stock Clearance Plan value stream</p></figcaption></figure>

Typical steps include creating or filtering the custom instance, configuring dependencies, and generating the plan. An optional AI agent can assist with plan drafting before the campaign moves forward.

### Approving and releasing

The next step is about taking the draft plan through review. The instance is updated with the latest campaign data, the plan is sent for approval, and once its approved, the handling stream triggers the execution value stream.

<figure><img src="/files/IznFud3E9UO06a8ftMwv" alt="Handle Stock Clearance Campaign Approval value stream"><figcaption><p>Handle Stock Clearance Campaign Approval value stream</p></figcaption></figure>

Teams that do not need a formal approval step can still use the same structure; filters on individual steps allow you to adapt the flow to your governance model.

### Executing the clearace pricing, sales, and marketing

The execution runs after handling completes. It drives the operational steps: coupons and price lists, company-specific promotions, quotes, product visibility, promotional assets, and publication to the content platform.

<figure><img src="/files/w0dJTmFRFkC5qgVPnSFo" alt="Execute Stock Clearance Plan value stream"><figcaption><p>Execute Stock Clearance Plan value stream</p></figcaption></figure>

The execution stream orchestrates the main commercial actions in sequence, for example segment coupons, discounted price lists, quote preparation, listing boosts, and banner publication. Optional steps can be skipped when they are not required for a given campaign; the run continues with the remaining steps until the clearance is live.

{% hint style="info" %}
Implementations of the process are tailored to each project to reduce manual effort, accelerate processing, and keep incoming order data consistent and reliable.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/partner-library/emporix-components/stock-promotion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
