Scenarios | S7 Agent API

Best practices of using S7 Agent API:

1. Basic shopping scenario
   with operation flow: searchFlight (BrandedFares) → book (Flight) → reprice → demandTickets (ETK)
2. Extra shopping scenario (flex search)
   with operation flow: searchFlightsFlex → searchFlight (BrandedFares)
3. Ancillaries shopping scenario (pricing)
   with operation flow: searchFlight (BrandedFares) → servicePrice
4. Corporate Program with discount shopping scenario
   with operation flow: searchFlight (BrandedFares) → book (Flight) → reprice → demandTickets (ETK)
5. Corporate Program with cashback shopping scenario
   with operation flow: searchFlight (BrandedFares) → book (Flight) → reprice → demandTickets (ETK)
6. Complete booking scenario
   with operation flow: searchFlight (BrandedFares) → servicePrice → seatMap → book (Flight+ Seat + Add Remark) → reprice → demandTickets (ETK + seat EMD + baggage EMD) → changeBook (Baggage)

7. Facilitated booking scenario
   with operation flow: MSE API → reprice → agentPayment
   

   It is not public. Request our technical support for access to documentation by Kaiten or email at api.support@s7.ru

8. Invalidation scenario

   1. TKT void
      with operation flow: searchFlight (BrandedFares) → book (Flight) → reprice → demandTickets (ETK) → voidTicket (ETK)
      
   2. Booking cancelation
      with operation flow: searchFlight (BrandedFares) → book (Flight) → cancelBooking
      
   3. EMD void

Check scenarios for each API version:

• Scenarios | v0.52 | S7 Agent API
  • Corporate Program with discount scenario | Auto | v0.52
  • Basic shopping scenario | v0.52 | OW + 1xADT + Direct
  • Basic shopping scenario | v0.52 | 2ADT+1CHD+1INF+Domestic+RT+Direct
  • Invalidation shopping scenario | v0.52 | OW + 1xADT + Direct | TKT void
  • Invalidation shopping scenario | v0.52 | OW + 1xADT + Direct | Booking cancelation
  • Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD bag
  • Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD seat
  • Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD bag&seat
  • Corporate Program with cashback scenario | v0.52
  • Read reservation scenario | v0.52
  • Read TST mask scenario | v0.52
  • Read ticket scenario | v0.52 | OW + 1xADT + Direct
  • Subsidised fare booking scenario | v0.52 | 1YTR+1CHD+1INF+RT
  • Ancillaries shopping scenario | v0.52 | 2ADT+1CHD+1INF+RT+Direct+EMD meal
  • ВПД МВД scenario | v0.52 | 1ADT+1CHD+1INF+OW
  • ВПД МO scenario | v0.52 | 1ADT+1CHD+1INF+OW
  • Ancillaries post sale scenario | v0.52 | RT + 2xADT + 1CHD + 1INF + Direct + S7 flight | all ancillaries
  • Subsidised fare booking scenario | v0.52 | 1NTL+1CHR+1INF+OW (Far East federal district)
  • Ancillaries shopping scenario | v0.52 | OW + 1xADT +1xCHD + Direct + S7 flight + free seat
  • Ancillaries post sale scenario | v0.52 | OW + 1xADT + Direct + S7 flight | bag ancillaries
  • Interline shopping scenario | v0.52 | OW + 1xADT + Transfer
  • Codeshare shopping scenario | v0.52 | OW + 1xADT
  • Discount Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD bag
  • Discount ancillaries post sale scenario | v0.52 | OW + 1xADT + Direct + S7 flight | bag ancillaries
  • Discount ancillaries post sale scenario | v0.52 | OW + 1xADT + Direct + S7 flight | seat ancillaries
  • Тариф Вахта
  • Family subsidised fare booking scenario | v0.52 | 2FBB+1FBD+1FBJ+RT

• Standalone data requests:
  • searchFlights → findRules
  • searchFlights → servicePrice (OneWay)
  • searchFlights → servicePrice (RoundTrip)
• Flight solution:
  • OW flight solution:
    1. searchFlights (LowFare)
    2. searchFlights (BrandedFares for first slice)
  • RT flight solution:
    1. searchFlights (LowFare)
    2. searchFlights (BrandedFares for first slice) → searchFlights (BrandedFares for second slice)
  • MC flight solution:
    • searchFlights (LowFare)
    • searchFlights (BrandedFares for first slice) → searchFlights (BrandedFares for second slice) → searchFlights (BrandedFares for second third) → etc
• Booking:
  • Create: book (Flight)
  • View: Create → read (Flight)
  • Delete: Create → cancelBooking
• Remarks:
  • Create:
    1. book (Flight + Add Remark)
    2. book (Flight) → changeBook (Add Remark)
    3. book (Flight) → reprice → demandTickets (ETK) → changeBook (Add Remark)
  • View: Create → read (Flight + Change Remark)
  • Delete:  Create → changeBook (Delete Remark)

• Ticket:
  • Create: book (Flight) → reprice → demandTickets (ETK)
  • View: Create → retrieveTicket (ETK)
  • Delete (during 1 day from Creation): Create → voidTicket (ETK)
• Seat assignment:
  • Create:
    1. seatMap → book (Flight + Seat) → reprice → demandTickets (ETK + seat EMD
    2. book (Flight) → seatMap → changeBook (Seat) → reprice → demandTickets (ETK + seat EMD)
    3. book (Flight) → reprice → demandTickets (ETK) → seatMap → changeBook (Seat) → demandTickets (seats EMD)
  • View: Create → retrieveTicket (ETK + seat EMD)
  • Delete (during 1 day from Creation): Create → voidTicket (seats EMD)
• Extra baggage:
  • Create:
    1. book (Flight) → baggageCharges → reprice → demandTickets (ETK + baggage EMD) → changeBook (Baggage)
    2. book (Flight) → reprice → demandTickets (ETK) → baggageCharges → demandTickets (baggage EMD) → changeBook (Baggage)
  • View: Create → retrieveTicket (ETK + baggage EMD)
  • Delete (during 1 day from Creation): Create → voidTicket (baggage EMD)