Parameters
Access.
/Envelope /Body /OrderCreateRQ /Party /Sender /AgentUserSender
# | Description | Mand | Mult | Default | Ref/Format | xPath | Example (only for S7) |
---|---|---|---|---|---|---|---|
1 | PseudoCity | PseudoCity | <PseudoCity>S7AGN8224</PseudoCity> | ||||
2 | AgentUserID | Constant | AgentUserID | <AgentUserID>test</AgentUserID> |
Replace text 'test' with the login from the authorization to the S7 Agent API service.
Corporate Program credentials.
/Envelope /Body /OrderCreateRQ /Query /OrderItems /DataLists /InstructionsList /Instruction[@ListKey="CC"] /SpecialBookingInstruction
Available only for Corporate Program with discount scenario or Corporate Program with cashback scenario.
Use credentials that you received from our technical support. Check out Quick Start for how to get those IDs
# | Description | Mand | Mult | Default | Ref/Format | xPath | Example (only for S7) |
---|---|---|---|---|---|---|---|
1 | Client ID | Code | <Code>QUW0000</Code> or <Code>QY0000</Code> | ||||
2 | Agent ID | Definition | <Definition>12251</Definition> |
Main.
/Envelope /Body /OrderCreateRQ
# | Description | Mand | Mult | Default | Ref/Format/Desc | xPath | Example |
---|---|---|---|---|---|---|---|
1 | Version | @Version | <OrderCreateRQ Version=""> | ||||
2 | Document | Document | <Document /> | ||||
3 | Passengers information |
| Query /Passengers /Passenger | <Passenger ObjectKey="SH1"> | |||
4 | Offer information | Offer | Query/OrderItems/ShoppingResponse | ||||
5 | Journey information | OriginDestination | OrderItems/OfferItem | ||||
6 | Accompanying adult booking reference | | | | Query/BookingReferences/BookingReference |
Passenger.
/Envelope /Body /OrderCreateRQ /Query /Passengers /Passenger (Multiple).
# | Description | Mand | Mult | Default | Ref/Format/Desc | xPath | Example |
---|---|---|---|---|---|---|---|
1 | Passenger ID | a-Z;1-9, but min 1 char. | @ObjectKey | <Passenger ObjectKey="SH1"> | |||
2 | Passenger Type Code |
| PTC | <PTC>ADT</PTC> | |||
3 | Passenger Birth date | YYYY-MM-DD | Age /BirthDate | <Age> | |||
4 | Passenger Surname | Name /Surname | <Name> | ||||
5 | Passenger Name | Name /Given | <Name> | ||||
6 | Passenger Title | MR, MRS, MS | Name /Title | <Name> | |||
7 | Passenger Email | Contacts /Contact /EmailContact /Address | <EmailContact> | ||||
8 | Passenger phone number | Contacts /Contact /PhoneContact /Number | <PhoneContact> | ||||
9 | Phone number country code | Contacts /Contact /PhoneContact /Number@CountryCode | <PhoneContact> | ||||
10 | Phone number area code | Contacts /Contact /PhoneContact /Number@AreaCode | <PhoneContact> | ||||
11 | Airline code - S7 always | S7 | FQTVs /TravelerFQTV_Information /AirlineID | <FQTVs> | |||
12 | Loyalty card number | FQTVs /TravelerFQTV_Information /Account /Number | <FQTVs> | ||||
13 | Program ID - loyalty program owner code (Airline code) | FQTVs /TravelerFQTV_Information /ProgramID | <FQTVs> | ||||
14 | Passenger gender |
| Gender | <Gender>Male</Gender> | |||
15 | Passenger document type - PP always | PP | PP | PassengerIDInfo /PassengerDocument /Type | <Type>PP</Type> | ||
16 | Passenger document number - any document is indicated, regardless of the fact that the type is always PP | PassengerIDInfo /PassengerDocument /ID | <ID>4510173564</ID> | ||||
17 | Passenger Birth сountry specified in the document | Сountry code | PassengerIDInfo /PassengerDocument /BirthCountry | <BirthCountry>RU</BirthCountry> | |||
18 | Date of Issue specified in the document | YYYY-MM-DD | PassengerIDInfo /PassengerDocument /DateOfIssue | <DateOfIssue>2011-10-10</DateOfIssue> | |||
19 | Date of expiration specified in the document (if not specified, you can specify the default date = current date + 1 year) | YYYY-MM-DD | PassengerIDInfo /PassengerDocument /DateOfExpiration | <DateOfExpiration>2021-10-10</DateOfExpiration> | |||
20 | Passenger country of residence specified in the document | Сountry code | PassengerIDInfo /PassengerDocument /CountryOfResidence | <CountryOfResidence>RU</CountryOfResidence> |
ShoppingResponse.
/Envelope /Body /OrderCreateRQ /Query /OrderItems /ShoppingResponse
# | Description | Mand | Mult | Default | Ref/Format/Desc | xPath | Example |
---|---|---|---|---|---|---|---|
1 | Offer owner - S7 always | S7 | S7 | Owner | <Owner>S7</Owner> | ||
2 | Constant | UNKNOWN | UNKNOWN | ResponseID | <ResponseID>UNKNOWN</ResponseID> | ||
3 | Constant | UNKNOWN | UNKNOWN | Offers /Offer /OfferID | <OfferID Owner="S7">UNKNOWN</OfferID> | ||
4 | Offer owner - S7 always | S7 | S7 | Offers /Offer /OfferID@Owner | <OfferID Owner="S7">UNKNOWN</OfferID> | ||
5 | Constant | UNKNOWN | UNKNOWN | Offers /Offer /OfferItems /OfferItem /OfferItemID | <OfferItemID Owner="S7">UNKNOWN</OfferItemID> | ||
6 | Offer owner - S7 always | S7 | S7 | Offers /Offer /OfferItems /OfferItem /OfferItemID@Owner | <OfferItemID Owner="S7">UNKNOWN</OfferItemID> | ||
7 | Passengers references | Offers /Offer /OfferItems /OfferItem /Passengers /PassengerReference | <PassengerReference>SH1 SH2</PassengerReference> | ||||
8 | Segments references | Offers /Offer /OfferItems /OfferItem /ApplicableFlight /FlightReferences | <FlightReferences>FL1 FL2</FlightReferences> |
OriginDestination.
/Envelope /Body /OrderCreateRQ /Query /OrderItems /OfferItem /OfferItemType /DetailedFlightItem /OriginDestination (Multiple).
# | Description | Mand | Mult | Default | Ref/Format/Desc | xPath | Example |
---|---|---|---|---|---|---|---|
1 | Segment ID | a-Z;1-9, but min 1 char. | Flight /SegmentKey | <SegmentKey>FL1</SegmentKey> | |||
2 | Departure IATA airport code | IATA airport code | Flight /Departure /AirportCode | <AirportCode>OVB</AirportCode> | |||
3 | Departure date (local) | YYYY-MM-DD | Flight /Departure /Date | <Date>2019-07-06</Date> | |||
4 | Departure time (local) | HH:MM | Flight /Departure /Time | <Time>06:40</Time> | |||
5 | Departure terminal name | Flight /Departure /Terminal /Name | <Name>1</Name> | ||||
6 | Arrival IATA airport code | IATA airport code | Flight /Arrival /AirportCode | <AirportCode>LED</AirportCode> | |||
7 | Arrival date (local) | YYYY-MM-DD | Flight /Arrival /Date | <Date>2019-07-06</Date> | |||
8 | Arrival time (local) | HH:MM | Flight /Arrival /Time | <Time>16:35</Time> | |||
9 | Arrival terminal name | Flight /Arrival /Terminal /Name | <Name>D</Name> | ||||
10 | Marketing carrier IATA airline code | IATA airline code | Flight /MarketingCarrier /AirlineID | <AirlineID>S7</AirlineID> | |||
11 | Marketing carrier flight number | Flight /MarketingCarrier /FlightNumber | <FlightNumber>49</FlightNumber> | ||||
12 | Operating carrier IATA airline code | IATA airline code | Flight /OperatingCarrier /AirlineID | <AirlineID>BA</AirlineID> | |||
13 | Operating carrier flight number | Flight /OperatingCarrier /FlightNumber | <FlightNumber>430</FlightNumber> | ||||
14 | The required number of seats is equal to the number of passengers | Number | Flight /ClassOfService /Code /@SeatsLeft | <Code SeatsLeft="9">S</Code> | |||
15 | Class of service code (RBD) | Letter | Flight /ClassOfService /Code | <Code SeatsLeft="2">Q</Code> |
BookingReferences.
/Envelope /Body /OrderCreateRQ /Query/BookingReferences/BookingReference
# | Description | Mand | Mult | Default | Ref/Format/Desc | xPath | Example |
---|---|---|---|---|---|---|---|
1 | Accompanying adult booking number | Type/Code | <Code>UKIJGW</Code> | ||||
2 | ID | ANY | ID | <ID>ANY</ID> | |||
3 | Airline ID | S7 | AirlineID | <AirlineID>S7</AirlineID> |