Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

      Note

      It is not public. Request our technical support for access to documentation

    by JIRA
    1. by Kaiten or email at api.support@s7.ru


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

    Children Display
    alltrue

    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)