Book operation makes a reservation of chosen solution for one or more passengers and returns PNR locator with passengers, itinerary information and Ticket Time Limits in in XML.
Use cases
The following list of cases supported by the Shopping API and provides their required inputs as well as a list of common inputs used with that case:
Standard booking flow
— reservation of— reservation of chosen solution from search results. Includes passengers and itinerary information.
3D agreement boooking flow — reservation of chosen solution from search results (сonsidering corporate discount).
Includes AgentIncludes Agent/Corporate
client and itinerary informationclient and itinerary information. 3D agreement booking flow is available only for S7 Corporate program. Applying 3D agreement booking flow for S7 Profi program is not allowed.
S7 Profi boooking flow - reservation of chosen solution from search results.
Includes S7Includes S7 Profi client
code and itinerary informationcode and itinerary information.
Table of contents
| Table of Contents |
|---|
Request (OrderCreateRQ)
Required inputs
# | Name | Format/Reference | xPath |
|---|---|---|---|
1 | Block of access parameters | Use credentials that you received from our technical support. Check out Quick Start | S7 Agent API for how to get it and References for more details | /Envelope/Body/OrderCreateRQ/Party/Sender/AgentUserSender |
2 | Passenger information | This element contains information about passengers: name, surname, date of birth, contacts, passport data, etc.
| /Envelope/Body/OrderCreateRQ/Query/Passengers/Passenger |
3 | Passengers and flight segments references | Includes reference elements connecting passengers with the appropriate flights | /Envelope/Body/OrderCreateRQ/Query/OrderItems/ShoppingResponse |
4 | Itinerary information | Solution from Search method RS
|
|
| /Envelope/Body/OrderCreateRQ/Query/OrderItems/OfferItem/DetailedFlightItem |
Optional parameters
#Name | Format/Reference | xPath | |
|---|---|---|---|
| 1 | Seats information | Contains the list of seats with a price | /Envelope/Body/OrderCreateRQ/Query/OrderItems/DataLists/SeatList/Seats |
| 2 | Ticketing Time Limit | Booking cancelation datetime in case of tickets are not issued. By default calculated by S7 rules. | /Envelope/Body/OrderCreateRQ/Query/OrderItems/DataLists/ServiceList/Service[ServiceID][Name]TimeLimits/TicketingTimeLimits |
| 3 | 3D agreement credentials |
Available only for scenario with 3D Agreement. |
Use credentials that you received from our technical support. Check out Quick Start for how to get those IDs | /Envelope/Body/OrderCreateRQ/Query/OrderItems/DataLists/InstructionsList/Instruction[@ListKey="CC"]/SpecialBookingInstruction |
| 4 | S7 Profi credentials |
Available only for S7 Profi |
program scenario. |
Use credentials that you received from our technical support. Check out Quick Start for how to get those IDs | /Envelope/Body/OrderCreateRQ/Query/OrderItems/DataLists/InstructionsList/Instruction[@ListKey="CC"]/SpecialBookingInstruction |
Response (OrderViewRS)
Name | Format/Reference | xPath | |
|---|---|---|---|
| 1 | Passengers information | This element contains information about passengers: name, surname, date of birth, contacts, passport data, etc. | /Envelope/Body/OrderViewRS/Response/Passengers/Passenger |
| 2 | Booking reservation number | PNR | /Envelope/Body/OrderViewRS/Response/Order/BookingReferences |
| 3 | Ticketing Time Limit | TTL | /Envelope/Body/OrderViewRS/Response/Order/TimeLimits/PaymentTimeLimit |
| 4 | Itinerary information | Itinerary information | /Envelope/Body/OrderViewRS/Response/Order/OrderItems |
Samples
2ADT+1CHD+1INF+Domestic+RT+DIRECT | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
OW+1xADT+Direct+S7 flight | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
3D agreement | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
S7 Profi | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
OW+1xADT+Direct+S7 flight+FQTV | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
Subsidised fare+OW+1xSRC+Direct | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
Subsidised fare+RT+1xYTR+1CHD+1INF+Transfer | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
1ADT+1INF with a seat+Domestic+OW+DIRECT | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МВД 1ADT+1CHD+1INF+Domestic+OW+DIRECT+Public fares | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МВД 1ADT+1CHD+1INF+Domestic+OW+DIRECT+YFLOW with 10% discount | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МВД 1ADT+1CHD+1INF+Domestic+OW+DIRECT+MM02 fare | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МО 1ADT+1CHD+1INF+Domestic+OW+DIRECT | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
ВПД МВД 1ADT+1CHD+1INF+Domestic+OW+DIRECT+M fare | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|
1CHD+Domestic+OW+DIRECT | v0.52 | book operation
| Include Page | ||||
|---|---|---|---|---|
|