Versions Compared

Old Version 1

changes.mady.by.user Yulia Komarova

Saved on

compared with

New Version 2

changes.mady.by.user Yulia Komarova

Saved on

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) → retrieveTicket

User story

S7 agent wants to buy one way flight from Moscow (DME) to Samara (KUF) for one adult  traveler. Then S7 agent wants to read ticket.

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.
  6. Read ticket: S7 Agent executes a retrieveTicket with itinerary info of ticket number.

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 count

Excerpt Include
OW + 1xADT + Direct + S7 flight| v0.52 | searchFlightsJourney operation
OW + 1xADT + Direct + S7 flight| 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
OW+1xADT+Direct+S7 flight | v0.52 | book operation
OW+1xADT+Direct+S7 flight | 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
1А | OW + 1xADT + Direct + S7 flight | v0.52 | reprice without PNR operation
1А | OW + 1xADT + Direct + 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
1А | OW + 1xADT + Direct + S7 flight | v0.52 | reprice with PNR operation
1А | OW + 1xADT + Direct + S7 flight | v0.52 | reprice with 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 | OW + 1xADT + Direct + S7 flight | v0.52 | demandTickets operation
1A | OW + 1xADT + Direct + S7 flight | v0.52 | demandTickets operation
nopaneltrue

Step 6: Read ticket

S7 Agent executes a retrieveTicket with itinerary info of ticket number.

Excerpt Include
OW + 1xADT + Direct + S7 flight | v0.52 | retrieveTicket operation
OW + 1xADT + Direct + S7 flight | v0.52 | retrieveTicket operation
nopaneltrue