Promotion Business Logic
With the Management API, it is possible to manage promotions and their business rules programmatically. This allows you to:
- Create, read, and update promotions — requirements, effects, and status — from an integration instead of only the Admin UI.
- Copy an existing promotion to other applications, converting currency to each target application's primary currency.
- Generate, list, and synchronise unique discount codes between Norce and external systems, and claim codes as they're used elsewhere.
- Read promotion usage statistics (total order amount, total discount, discount percentage, margin percentage) for reporting.
Endpoints
| Operation | Endpoint |
|---|---|
| List promotions | GET /management/1.0/api/promotion |
| Get promotion | GET /management/1.0/api/promotion/{id} |
| Create promotion | POST /management/1.0/api/promotion |
| Update promotion | PUT /management/1.0/api/promotion/{id} |
| Copy promotion to other applications | POST /management/1.0/api/promotion/{id}/copy-to-applications |
| Get promotion statistics | GET /management/1.0/api/promotion/{id}/statistics |
| List unique discount codes | GET /management/1.0/api/promotion/{id}/unique-codes |
| Add unique discount codes | POST /management/1.0/api/promotion/{id}/unique-codes |
| Update/claim unique discount codes | PUT /management/1.0/api/promotion/{id}/unique-codes |
Unique discount codes: Use PUT .../unique-codes to mark codes as claimed (with a source) when an external system has used them — for example, if a loyalty platform issues one-time codes that Norce should recognize as already spent. Use POST .../unique-codes to append newly generated codes to an existing promotion.
To create or update a promotion, see Creating promotions for the requirement/effect model the PromotionModel request body maps to.
Check out our Postman examples to get started.