Overview

An example of end-to-end scenario based on on operation flow and user story

Operation flow

searchFlightsJourney → book (Flight) → read → reprice without PNR → reprice with PNR → demandTickets (ETK)

User story

S7 Agent wants to book round trip flight from Saint Petersburg (LED) to Norilsk (NSK) for group of travelers (1 adult under 23 years, 1 children and 1 infant on a lap). He also wants to book C fare for subsidised passenger group. He chooses transfer S7 flights.

Scenario

The general process for book a trip such as this is:

  1. Initial search for flight solutions: S7 Agent executes a searchFlightsJourney operation with itinerary criteria and subsidised passenger types count;
  2. Book a reservation: S7 Agent executes a book operation with passenger details and itinerary info of chosen solution from search results;
  3. Read the reservation: S7 Agent executes a read operation.
  4. Request for informative reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;
  5. Request for reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;
  6. Issue tickets for all passenger: S7 Agent executes a demandTickets operation with reservation reference and pricing details.

Table of contents:


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

(lightbulb) Use subsidised passenger types only for subsidised flow.


Step 1: Initial search for flight solutions

S7 Agent executes a searchFlightsJourney operation with itinerary criteria and passenger types

(lightbulb) Use PTC types: SRC/YTR for adult passenger, CHR for child, INR for infant to get subsidised fares.\;

(lightbulb) You can use onle SRC or YTR separately.

Itinerary criteria: 

  • Saint Petersburg (LED) to Norilsk (NSK)

Passenger types count:

  • 1xYTR 1xCHR 1xINR

Received solutions divided by fare family and mostly includes 4 sub solutions (Basic Economy, Flex Economy, Basic Business, Flex Business) for each itinerary solution.
Received solutions contain both subsidised and non-subsidised fares.

Step 2: Book a reservation

S7 Agent executes a book operation with passenger details and itinerary info of chosen solution from search results.

(lightbulb) Use PTC types: SRC/YTR for adult passenger, CHR for child, INR for infant;

(lightbulb) Tag Middle is mandatory for all passengers;

(lightbulb) Passenger with type SRC must be older 55 years for female and 60 years for male, passenger with type YTR must be younger 23 years;

(lightbulb) Subsidised fare is available only for Russian Federation  citizens, CountryOfResidence tag must contain value "RU";

(lightbulb) You can use onle SRC or YTR separately.


Step 3: Read the reservation.

S7 Agent executes a read operation.

Step 4: Request for informative pricing

S7 Agent executes a reprice operation with itinerary info of chosen solution

(lightbulb) Use PTC types: SRC/YTR for adult passenger, CHR for child, INR for infant


Step 5: Request for reservation pricing

S7 Agent executes a reprice operation with itinerary info of chosen solution

(lightbulb) Use PTC types: SRC/YTR for adult passenger, CHR for child, INR for infant

Step 6: Issue tickets for all passenger

S7 Agent executes a demandTickets operation with reservation reference and pricing details