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. 3D agreement shopping scenario
    with operation flow: searchFlight (BrandedFares) → book (Flight) → reprice → demandTickets (ETK)
    1. Manual discount input
    2. Auto discount application
  5. Complete booking scenario
    with operation flow: searchFlight (BrandedFares) → servicePrice → seatMap → book (Flight+ Seat + Add Remark) → reprice → demandTickets (ETK + seat EMD + baggage EMD) → changeBook (Baggage)

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

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


  7. 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:

Additional flows

A hint for understanding the process of creating, viewing, and deleting API entities

  • 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)