> ## Documentation Index
> Fetch the complete documentation index at: https://docs-pos.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotions & coupons

> Create automatic promotion rules and issue redeemable coupons in the Solya POS Centrale, and evaluate them against a basket.

The Centrale gives you two complementary discounting tools: **promotions**, which
apply automatically when a basket meets their conditions, and **coupons**, which
are codes a customer redeems. Both are evaluated against the basket at checkout.

## What it is for

* Author **promotion rules** that trigger automatically (for example threshold or
  multi-buy offers).
* Issue **coupons** — one at a time or in a **batch** — and validate them.
* **Evaluate** promotions against a basket to preview the discount before it is
  applied.

## Key screens and actions

<Steps>
  <Step title="Manage promotions">
    The promotions screen lists rules with their status. Create or edit a
    promotion, then deactivate it when the offer ends.
  </Step>

  <Step title="Preview with evaluate / dry-run">
    Evaluate a promotion against a sample basket to confirm it produces the
    intended discount before going live.
  </Step>

  <Step title="Manage coupons">
    The coupons screen lists issued codes. Create a single coupon, or generate a
    batch, and deactivate codes that should no longer work.
  </Step>

  <Step title="Validate a coupon">
    Check that a code is valid and applicable — the same validation the till runs
    at redemption.
  </Step>
</Steps>

## In the API

| Capability       | Endpoints                                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Promotions       | `GET/POST /v1/promotions`, `GET/PUT /v1/promotions/{id}`, `POST /v1/promotions/{id}/deactivate`, `POST /v1/promotions/evaluate`           |
| Coupons          | `GET/POST /v1/coupons`, `POST /v1/coupons/batch`, `PUT /v1/coupons/{id}`, `POST /v1/coupons/{id}/deactivate`, `POST /v1/coupons/validate` |
| Ticket discounts | `POST /v1/discounts/ticket`, `GET /v1/discounts/{id}`                                                                                     |

See [campaigns](/en/centrale/campagnes-marketing) for sending offers to customers,
and the [API Reference](/en/developers/overview) for full details.