Versions Compared

Key

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

Overview

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

Excerpt

Operation flow

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

User story

S7 Agent wants to buy one way buy round trip flight from Moscow (DME) to Novosibsrsk (OVB) for group of travelers (2 adults, 1 children and 1 infants on a lap). He chooses direct S7 flights.

Scenario

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

  1. Initial search for flight solutions: S7 Agent executes a searchFlightsJourney operation with itinerary criteria and 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. Request for informative reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;
  4. Request for reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;
  5. Issue tickets for all passenger: S7 Agent executes a demandTickets operation with reservation reference and pricing details.

Table of contents:

Table of Contents


Note

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


Step 1: Initial search for flight solutions

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

Itinerary criteria: 

  • Roud trip S7 flight from Moscow (DME) to to Novosibsrsk (OVB)

Passenger types count:

  • 2xADT 1xCHD 1xINF

Excerpt Include
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | searchFlightsJourney operation
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | searchFlightsJourney operation
nopaneltrue

Received solutions divided by fare family and mostly includes 4 sub solutions (Basic Economy, Flex Economy, Basic Business, Flex Business) for each itinerary solution.

Step 2: Book a reservation

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

<DetailedFlightItem> block consists of journey information, where each slice is described by the <OriginDestination> element.

<OriginDestination>  block takes from appropriate AirShoppingRS

Note

(lightbulb) Segments (Flight) must be devided into slices (OriginDestination):

  • one OriginDestination for One Way trip;
  • two for Round Trip and more for MultiCity;
  • for Transfer Trip all segments included in one slice have to be pass in one OriginDestination;
  • for Transfer Trip segments with stopover between have to be divided into two OriginDestination.


Code Block
languagexml
themeConfluence
titleOriginDestination information in AirShoppingRS
collapsetrue
Envelope/Body/AirShoppingRS/DataLists/FlightSegmentList

and <ClassOfService> (RBD) from

Code Block
languagexml
themeConfluence
titleRBD information in AirShoppingRS
collapsetrue
Envelope/Body/AirShoppingRS/OffersGroup/AirlineOffers/AirlineOffer/PricedOffer/OfferPrice/RequestedDate/Associations/ApplicableFlight/FlightSegmentReference/ClassOfService/Code

Excerpt Include
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | book operation
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | book operation
nopaneltrue

Step 3: Request for informative pricing

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

All information must be taken from AirShoppingRS:

  • itinerary details (airport codes and dates for origin and departure, airline code and flight number);

Note

(lightbulb) <FlightItem> block must fill in like in OrderCreateRQ. Each slice is described by the <OriginDestination> element.

  • passenger types (PTC);
  • fare details (RBD and fare code).

Excerpt Include
RT + 2ADT + 1CHD + 1INF + Transfer + S7 flight | v0.52 | reprice without PNR operation
RT + 2ADT + 1CHD + 1INF + Transfer + S7 flight | v0.52 | reprice without PNR operation
nopaneltrue

Step 4: Request for reservation pricing

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

All information must be taken from AirShoppingRS:

  • itinerary details (airport codes and dates for origin and departure, airline code and flight number);

Note

(lightbulb) <FlightItem> block must fill in like in OrderCreateRQ. Each slice is described by the <OriginDestination> element.

  • passenger types (PTC);
  • fare details (RBD and fare code).

Excerpt Include
RT + 2ADT + 1CHD + 1INF + Transfer + S7 flight | v0.52 | reprice without PNR operation
RT + 2ADT + 1CHD + 1INF + Transfer + S7 flight | v0.52 | reprice without PNR operation
nopaneltrue

Step 5: Issue tickets for all passenger

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

  • Add information about PNR from OrderViewRS
Code Block
languagexml
themeConfluence
titlePNR information in OrderViewRS
collapsetrue
Envelope/Body/OrderViewRS/Response/Order/BookingReferences/BookingReference/ID
  • Fill in the form of payment as in example <*A*TEXT>


Code Block
languagexml
themeConfluence
titleFOP
collapsetrue
<Payments>
    <Payment>
        <Type>
            <Code>MS</Code>
        </Type>
        <Other>
            <Remarks>
                <Remark>*A*TEXT</Remark>
            </Remarks>
        </Other>
    </Payment>
</Payments>

Excerpt Include
1A | 2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | demandTickets operation
1A | 2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | demandTickets operation
nopaneltrue