Versions Compared

Key

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

API provides:

  • General shopping flow: searching, booking and ticketing flight solutions
  • Service operations with bookings (read, change and cancel) and tickets (read and void)
  • Information such as flight details, ancillaries and fare pricing, raw fare rules directly from S7

Also service makes available shopping with 3D agreements Corporate Program (Agent sell S7 flights for theirs corporate clients with special discounts)

All operations use synchronous behaviour, generally stateless model and IATA NDC schema v15.2

Note

Before you can send a request to S7 Agent API, you must get an SSL certificate and configure your software


Table of contents:

Table of Contents

Page tree:

Children Display
depth6

Operation list

Legend: (tick) — available in the version, (error) — not available in the version

#Operation nameInput messageOutput messagev0.
21v0.35v0.47v0.50
52Description / Use casesSamples
1searchFlightsFlexAirShoppingRQAirShoppingRS
(error)(error)
(tick)
(tick)
Search operation finds one cheapest solution for each day of given range for the specified search criteria


Expand
titleSamples

Children Display
alltrue
pagesearchFlightsFlex operation | Samples


2
searchFlights
searchFlightsJourneyAirShoppingRQAirShoppingRS
(tick)
(tick)
(tick)(error)
Search flights request the whole trip for the specified itinerary data
and search type: low fare, smart choice or flight info search
(warning) Deprecated. Use searchFlightsJourney, searchFlightsBySlice and flightInfo operations instead


Expand
titleSamples

Children Display
alltrue
page

searchFlights

searchFlightsJourney operation | Samples


3
searchFlightsJourney
searchFlightsBySliceAirShoppingRQAirShoppingRS
(error)(error)(error)
(tick)Search flights
request the whole trip
request slice by slice for the specified itinerary data
4


Expand
searchFlightsBySlice
title
AirShoppingRQ
Samples
AirShoppingRS

Children Display

(error)

all

(error)

true

(error)(tick)Search flights request slice by slice for the specified itinerary data5

pagesearchFlightsBySlice operation | Samples


4flightInfoAirShoppingRQAirShoppingRS
(error)(error)(error)
(tick)Flight info request for a specified single flight
6


Expand
titleSamples

Children Display
alltrue
pageflightInfo operation | Samples


5findRulesFareRulesRQFareRulesRS
(tick)(tick)
(tick)
(error)

Returns the filed details of a specific fare basis code

7

6seatMapSeatAvailabilityRQSeatAvailabilityRS
(tick)(tick)(tick)
(tick)

Returns data used to construct seat map with prices

8


Expand
titleSamples

Children Display
alltrue
pageseatMap operation | Samples


7baggageChargesBaggageChargesRQBaggageChargesRS
(tick)
(tick)(tick)
(error)Returns pricing for extra baggage
(warning) Deprecated. Use servicePrice operation instead
9

8servicePriceServicePriceRQServicePriceRS(tick)
(tick)(tick)(tick)

Returns pricing of ancillary services


Expand
titleSamples

Children Display
alltrue
pageservicePrice operation | Samples

10


9bookOrderCreateRQOrderViewRS
(tick)(tick)(tick)
(tick)Creates new reservation (PNR) in PSS


Expand
titleSamples

Children Display
alltrue
pagebook operation | Samples

11


10readOrderRetrieveRQOrderViewRS
(tick)(tick)(tick)
(tick)Returns information about existing PNR by PNR number
12


Expand
titleSamples

Children Display
alltrue
pageread operation | Samples


11changeBookOrderChangeRQOrderViewRS
(tick)(tick)(tick)
(tick)

Modification of PNR by specifying which PNR items to change and what to change
(add/change/delete ancillary services, remarks or passengers information)


Expand
titleSamples

Children Display
alltrue
pageread operation | Samples


12
13
cancelBookingOrderCancelRQOrderCancelRS(tick)
(tick)(tick)(tick)
Operation of cancellation of a specified PNR, and returns confirmation of cancellation
14

13repriceItinReshopRQItinReshopRS
(tick)(tick)
(tick)
(tick)
Operation returns the actual fares (for ticketing operation) according to the specified itinerary parameters


Expand
titleSamples

Children Display
alltrue
pagereprice operation | Samples

15


14demandTicketsAirDocIssueRQAirDocDisplayRS
(tick)(tick)(tick)16
(tick)

Operation set requests an Airline to issue flight (ETK) and/or ancillary (EMD) document(s)

Expand
titleSamples

Children Display
alltrue
pagedemandTickets operation | Samples



15retrieveTicketAirDocDisplayRQAirDocDisplayRS
(tick)
(tick)
(tick)(tick)
Returns information about existing ETK/EMD by ETK/EMD number
17

16voidTicketAirDocVoidRQAirDocVoidRS
(tick)(tick)
(tick)
(tick)
Allows to void existing ETK
18

17agentPaymentOrderCreateRQOrderViewRS
(error)(tick)
(tick)
(error)

Create booking by flight solution, proceed payment, issue ETK for all passengers and send receipts to lead passenger
(warning) Deprecated. Use orderCreate and orderChange operations instead

Note

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

JIRA 19
Expand
titleSamples

Children Display
alltrue
pageagentPayment operation | Samples




18orderCreateorderCreateRQOrderViewRS
(error)(error)(error)
(tick)

Create booking by flight solution, proceed payment, issue ETK for all passengers and send receipts to lead passenger

Note

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

JIRA

Kaiten or email at api.support@s7.ru

20



19orderChangeorderChangeRQOrderViewRS
(error)
(error)(error)
(tick)

Complete 3DS payment started with the orderCreate operation, and continue issue ETK for all passengers and send receipts to lead passenger

Note

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

JIRA