I 29 Add support for promotions - UnionInternationalCheminsdeFer/OSDM GitHub Wiki
I-29: Add Support for Promotions
Description
Promotions are taken into account while pricing.
Owner
- Ralf Bayer (DB)
- Andreas Schlapbach (SBB)
Business Value
For distributors or railway
who want to promote certain services or trips
the support for promotions
is a necessary tool
that supports marketing activities
unlike the current API
our solution does take promotions into account while pricing.
Business Outcomes
The measurable benefits that the business can anticipate if the epic hypothesis is proven to be correct.
Support for marketing activities by issuing promo code (promotion token).
Leading Indicators
The early measures that will help predict the business outcome hypothesis.
Requested features by parties adopting OSDM.
Nonfunctional Requirements
Nonfunctional requirements (NFRs) associated with the epic.
If the promocode is unknown/invalid to the receiving system it is ignored. Additionally a warning can be returned, but no error.
Initial Analysis
- Two or more parties agree on promocodes with a positive impact on the price (discount).
- The promocode can then be passed it to the customers.
- If the customer adds the promo code to an offer request and its valid, it must be taken into account for price calculation.
Detailed Analysis
PromoCode:
type: object
properties:
code:
type: string
example: "VALATINE30%"
issuer:
type: string
example: ""
In request:
- Add
OfferSearchCriteria.promoCodes
as an array
In response:
- Rename
CommonOfferPartAttributes.reductionsApplied
toCommonOfferPartAttributes.reductionCardsApplied
- Add
CommonOfferPartAttributes.promoCodesApplied
as an array
Out of scope
Issuing of promotions, promotion management.