I 68 Request complements of a prebooked offer in hindsight - UnionInternationalCheminsdeFer/OSDM GitHub Wiki

I-68: Request ancillaries/reservations for a pre-booked offer in hindsight

Description

At the Swedish market we have found a need of a new endpoint to fetch possible ancillaries and reservations before patching them to a bookedOffer.

The reason for the need of a new endpoint is that the sales tool can put a booking on hold and continue working on the booking hours and maybe days after the pre-booking was done. In that stage the initial POST /offers response is no longer available for the sales tool where the list of ancillaries and reservation possibilities was returned from the beginning.

It is probably possible to rerun a new POST /offers to get a new actual list, but if the transport is sold out at this stage, no admission is offered and with that, no ancillaries/reservations are available as well.

Additional improvement (from meeting 28/10/2022)

In the discussion of the feature, we identified an additional important improvement in the possibility for adding offers into an already (pre)booked booking. From an API spec standpoint, we want to introduce this by adding the offer-related properties of the POST /bookings verb in the PATCH /booking.

Owner

  • Linus Johannson (turnit)
  • Sverker Östman (SJ)

Business Value

  • Ability of a sales tool to add reservations/ancillaries to a booking in hindsight.
  • (added 28/10/2022): Ability to add a new offer to a booking in hindsight

Business Outcomes

The measurable benefits that the business can anticipate if the epic hypothesis is proven to be correct.

To do

Leading Indicators

The early measures that will help predict the business outcome hypothesis. For more on this topic, see the Innovation Accounting advanced topic article.

To do

Nonfunctional Requirements

Nonfunctional requirements (NFRs) associated with the epic.

To do

Specification Effort

SMALL

Initial Analysis

Question ASC: Does this equal asking for reservations or ancillaries without admissions for a given O/D in hindsight?