Page History

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

depth	6

Operation list

Legend: — available in the version, — not available in the version

#	Operation name	Input message	Output message	v0.52	Description / Use cases	Samples
1

searchFlights

searchFlightsFlex

AirShoppingRQ

AirShoppingRS

Search flight solutions with use cases:

Low fare
Branded fares
Flight info

Search operation finds one cheapest solution for each day of given range for the specified search criteria

Expand

title	Samples

Children Display

all	true
page	searchFlightsFlex operation

Children DisplaypagesearchFlight operation

| Samples

2

findRules

searchFlightsJourney

FareRulesRQ

AirShoppingRQ

FareRulesRS

Get fare rules for a flight

3seatMapSeatAvailabilityRQSeatAvailabilityRS

Get seat map for a flight

4baggageChargesBaggageChargesRQBaggageChargesRS

Get extra baggage pricing for a whole requested itinerary

5servicePriceServicePriceRQServicePriceRS

Get seats and extra baggage pricing for a whole requested itinerary

6book OrderCreateRQ OrderViewRSCreate booking by flight solution

Children Display

page	book operation \| Samples

7readOrderRetrieveRQOrderViewRSRead booking by PNR8changeBookOrderChangeRQOrderViewRS

Change booking by PNR:

Add remarks
Seats assignment
Change seats assignment
Add request for extra baggage

9cancelBookingOrderCancelRQOrderCancelRSCancel booking by PNR10reprice ItinReshopRQ ItinReshopRSGet actual flight pricing by PNR

Children Display

page	reprice operation \| Samples

11demandTicketAirDocIssueRQAirDocDisplayRS

Issuing documents:

e-tickets (ETK)
seats assignment EMD
extra baggage EMD

Children Display

page	demandTicket operation \| Samples

12retrieveTicketAirDocDisplayRQAirDocDisplayRSRead ticket (ETK) by number13voidTicketAirDocVoidRQAirDocVoidRSVoid ticket (ETK) by number14agentPayment OrderCreateRQ OrderViewRS

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 or email at api.support@s7.ru

Children Display

page	agentPayment operation \| Samples

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

AirShoppingRS

Search flights request the whole trip for the specified itinerary data

Expand

title	Samples

Children Display

all	true
page	searchFlightsJourney operation \| Samples

3

searchFlightsBySlice

AirShoppingRQ

AirShoppingRS

Search flights request slice by slice for the specified itinerary data

Expand

title	Samples

Children Display

all	true
page	searchFlightsBySlice operation \| Samples

4

flightInfo

AirShoppingRQ

AirShoppingRS

Flight info request for a specified single flight

Expand

title	Samples

Children Display

all	true
page	flightInfo operation \| Samples

5

findRules

FareRulesRQ

FareRulesRS

Returns the filed details of a specific fare basis code

6

seatMap

SeatAvailabilityRQ

SeatAvailabilityRS

Returns data used to construct seat map with prices

Expand

title	Samples

Children Display

all	true
page	seatMap operation \| Samples

7

baggageCharges

BaggageChargesRQ

BaggageChargesRS

Returns pricing for extra baggage

Deprecated. Use servicePrice operation instead

8

servicePrice

ServicePriceRQ

ServicePriceRS

Returns pricing of ancillary services

Expand

title	Samples

Children Display

all	true
page	servicePrice operation \| Samples

9

book

OrderCreateRQ

OrderViewRS

Creates new reservation (PNR) in PSS

Expand

title	Samples

Children Display

all	true
page	book operation \| Samples

10

read

OrderRetrieveRQ

OrderViewRS

Returns information about existing PNR by PNR number

Expand

title	Samples

Children Display

all	true
page	read operation \| Samples

11

changeBook

OrderChangeRQ

OrderViewRS

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

Expand

title	Samples

Children Display

all	true
page	read operation \| Samples

12

cancelBooking

OrderCancelRQ

OrderCancelRS

Operation of cancellation of a specified PNR, and returns confirmation of cancellation

13

reprice

ItinReshopRQ

ItinReshopRS

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

Expand

title	Samples

Children Display

all	true

Table of contents:

Table of Contents

Page tree:

Children Display

depth	6

Operation list

#Operation nameInput messageOutput messageDescription / Use casesSamples1searchFlights AirShoppingRQ AirShoppingRS

Search flight solutions with use cases:

Low fare
Branded fares
Flight info

Children Display

page	searchFlight operation \| Samples

2findRulesFareRulesRQFareRulesRS

Get fare rules for a flight

3seatMapSeatAvailabilityRQSeatAvailabilityRS

Get seat map for a flight

4baggageChargesBaggageChargesRQBaggageChargesRS

Get extra baggage pricing for a whole requested itinerary

5servicePriceServicePriceRQServicePriceRS

Get seats and extra baggage pricing for a whole requested itinerary

6book OrderCreateRQ OrderViewRSCreate booking by flight solution

Children Display

page	book operation \| Samples

7readOrderRetrieveRQOrderViewRSRead booking by PNR8changeBookOrderChangeRQOrderViewRS

Change booking by PNR:

Add remarks
Seats assignment
Change seats assignment
Add request for extra baggage

9cancelBookingOrderCancelRQOrderCancelRSCancel booking by PNR10reprice ItinReshopRQ ItinReshopRSGet actual flight pricing by PNRchildren


page	reprice operation \| Samples

11

14

demandTicket

demandTickets

AirDocIssueRQ

AirDocDisplayRS

Issuing documents:

e-tickets (ETK)
seats assignment EMD
extra baggage EMD

Children Display

page	demandTicket operation \| Samples

12

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

Read ticket (ETK) by number13

		Returns information about existing ETK/EMD by ETK/EMD number
16	voidTicket	AirDocVoidRQ	AirDocVoidRS

Void ticket (ETK) by number

	Allows to void existing ETK
17

14

agentPayment

OrderCreateRQ

OrderViewRS

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

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

JIRA

Kaiten or email at api.support@s7.ru

18

orderCreate

orderCreateRQ

OrderViewRS

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 Kaiten or email at api.support@s7.

Children DisplaypageagentPayment operation | Samples

ru

19

orderChange

orderChangeRQ

OrderViewRS

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 Kaiten or email at api.support@s7.ru

Page tree

Versions Compared

Old Version 10

New Version Current

Key

Operation list

Operation list