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 to CommonOfferPartAttributes.reductionCardsApplied
• Add CommonOfferPartAttributes.promoCodesApplied as an array

Out of scope

Issuing of promotions, promotion management.

Specification Effort: MIDDLE