Promotion Domain¶

Manage promotions coupons and vouchers.

At a Glance¶

	Count
Business Objects	4
Capabilities	3
Processes	4
Events	11
APIs	2
Validation Rules	6

Object Relationships¶

erDiagram
    COUPON }o--|| PROMOTION : "belongs-to"
    PROMOTION }o..o{ COUPON : "uses"
    PROMOTION }o..o{ VOUCHER : "uses"
    SPONSORED_OFFER }o..o{ PROMOTION : "applies-to"

Business Objects¶

Object	Classification	Description
⬡ Coupon `coupon`	`aggregate-root`	Promotion-related entitlement or code validated and redeemed during selling or checkout.
⬡ Promotion `promotion`	`aggregate-root`	Promotional rule or offer evaluated during basket, checkout, pricing, or selling interacti…
⬡ Sponsored Offer `sponsored-offer`	`aggregate-root`	Governed retail-media offer with approved audience, placement, timing, and closed-loop att…
⬡ Voucher `voucher`	`aggregate-root`	Value or benefit instrument issued, validated, redeemed, or cancelled.

Capabilities¶

Capability	Archetype	Outcome
Retail Media Management `retail-media-management`	`intelligence`	Sponsored offers can be activated, served, and attributed using consent-aware fi…
Voucher Management `voucher-management`	`management`	Gift vouchers and store credits can be issued, validated, redeemed and cancelled…
Promotions `promotions`	`operational`	Promotions and coupons can be evaluated and applied to a basket or order to deli…

Events¶

Created (1):
VoucherIssued

Transitioned (6):
PromotionApplied CouponRedeemed VoucherRedeemed VoucherCancelled SponsoredOfferActivated SponsoredOfferAttributed

Updated (1):
SponsoredOfferExposed

Calculated (3):
PromotionEvaluated CouponValidated VoucherValidated

Processes¶

Checkout checkout — A confirmed order is created with payment authorised, promotions applied and loy
Voucher Redemption voucher-redemption — A customer can redeem a gift voucher or store credit as full or partial payment
Promotional Campaign Launch promotional-campaign-launch — A promotional campaign is activated across targeted customer segments and channe
Retail Media Attribution retail-media-attribution — A sponsored offer is activated for eligible audiences and has its approved close

APIs¶

Endpoint	Method	Service	Capability
`/promotions/evaluate`	POST	`evaluate-promotions`	`promotions`
`/vouchers/{code}/validate`	POST	`validate-voucher`	`voucher-management`

Applications¶

Promotion Engine promotion-engine (system of intelligence)
Retail Media Platform retail-media-platform (system of intelligence)

Validation Rules¶

Rule	Type	Applies To	Severity
`checkout-requires-active-basket`	`pre-condition`	`checkout`	`invariant`
`checkout-requires-active-product`	`pre-condition`	`checkout`	`invariant`
`voucher-redemption-requires-valid-voucher`	`pre-condition`	`voucher-redemption`	`invariant`
`retail-media-requires-consent-aware-audience`	`pre-condition`	`retail-media-attribution`	`invariant`
`checkout-creates-order`	`post-condition`	`checkout`	`invariant`
`checkout-clears-basket`	`post-condition`	`checkout`	`invariant`

Semantic Constraints¶

Constraint	Type	Rule
`promotion-in-promotion-domain`	`domain-containment`	The Promotion Business Object is owned by the Promotion domain.

← Back to Domain Catalog