2.1. FLIGHT LOW FARE SEARCH REQUEST
Low Fare Search request is used to search flights between two cities or airports that meet certain requirements (number of passengers, cabin class, time window, specific carrier and etc.).
OTA_AirLowFareSearchRQ:
*mandatory
Element | Attribute | Type | Description | Min…Max occurs |
---|---|---|---|---|
|
| For more information see Common Data Description section in Glossary. | 1..1 | |
| 0..1 | |||
MaxResponses | integer | Tunes the number of offers in response. In case of MaxResponses="1", GP Travel HUB returns only the lowest offer. Default value depends on supplier settings. | 0..1 | |
OnlyRefundable | boolean | If set to "true", GP HUB shows only Refundable offers. If "false" - both refundable and nonrefundable. Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier. | 0..1 | |
OnlyWithBaggage | boolean | If it set to "true" only offers with free baggage will be returned. If "false" all possible offers will be returned. If the attribute is not specified in request, then all possible offers will be returned. Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier. | 0..1 | |
|
| Contains information about requested flight. If you need to book several flights at once (for instance, you need two flights for round trip), then create a specific OriginDestinationInformation element for each flight. | 1..* | |
SpecificFlightInfo |
|
| Contains information about specific airline. | 0..1 |
SpecificFlightInfo/Airline* |
|
| Identifies marketing airline for requested flight. Several airlines can be submitted in request, each one goes with specific Airline element. | 1..* |
Code* | string (2-3) | Identifies a company by the IATA company code. | 1..1 | |
PreferLevel | sting ("Preferred" ,"Only" - default,"Unacceptable”) | Indicates the level of preference for an airline ("Preferred" - search preferably with specified carriers, "Only" - search only with specified carriers, "Unacceptable" - exclude carriers). | 0..1 | |
|
| Contains information about preferences for requested flight. | 0..1 | |
|
| Specify the number of passengers and types. | 1..1 |
OTA_AirLowFareSearchRQ/OriginDestinationInformation*:
Element | Attribute | Type | Description | Min…Max occurs |
---|---|---|---|---|
| RPH* | integer | The index number of requested flight. If you need to book several flights at once (for instance, you need two flights for round trip) use unique RPH value for each flight. | 1..1 |
DepartureDateTime* |
| YYYY-MM-DD or YYYY-MM-DDThh:mm:ss | Identifies departure date or date and time of requested flight. | 1..1 |
| For more information see Common Data Description section in Glossary. | 0..1 | ||
| 0..1 | |||
OriginLocation* |
|
| Identifies start point of journey. | 1..1 |
| For more information see Common Data Description section in Glossary. | 1..1 | ||
| 0..1 | |||
| 0..1 | |||
DestinationLocation* |
|
| Identifies end point of journey. | 1..1 |
| For more information see Common Data Description section in Glossary. | 1..1 | ||
| 0..1 | |||
| 0..1 | |||
ConnectionLocations |
|
| Identifies middle points of journey. | 0..1 |
ConnectionLocations/ConnectionLocation |
|
| Identifies middle point of journey. | 0..9 |
| For more information see Common Data Description section in Glossary. | 1..1 | ||
| 0..1 | |||
| 0..1 | |||
AlternateLocationInfo |
|
| Identifies list of alternate departure/destination airports. To use several alternate airports, put IATA codes in the OriginLocation (and/or DestinationLocation) separated by spaces (i.e. OriginLocation="LHR LCY"). Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier. | 0..1 |
OriginLocation | string (1-8) | Identifies start point of journey. | 0..1 | |
DestinationLocation | string (1-8) | Identifies end point of journey. | 0..1 | |
| For more information see Common Data Description section in Glossary. | 0..1 |
OTA_AirLowFareSearchRQ/TravelPreferences:
Element | Attribute | Type | Description | Min…Max occurs |
---|---|---|---|---|
| DaysBefore | integer (1-3) | Indicates days for search before the date specified in the DepartureDateTime element. | 0..1 |
DaysAfter | integer (1-3) | Indicates days for search after the date specified in the DepartureDateTime element. | 0..1 | |
OriginDestinationRPHs | string | Contains the list of space-separated OriginDestinationInformation RPHs which particular Travel preference apply to. It is used with BookingSeatPref. Do not combine with DaysBefore and DaysAfter. | 0..1 | |
FlightTypePref |
|
| Identifies flight preferences for requested flight. | 0..1 |
| For more information see Common Data Description section in Glossary. | 1..1 | ||
PreferLevel | string ("Preferred” - default, "Only", "Unacceptable") | Indicates a level of preference of the associated flight. | 0..1 | |
CabinPref |
|
| Contains cabin class preferences for requested flight. | 0..1 |
Cabin* | string ("First", "Business", "Economy", "PremiumEconomy") | Indicates cabin class for requested flight. | 1..1 | |
BookingSeatPref |
|
| Indicates passenger's seat preference. |
|
ResBookDesigCode | string (1) | Reservation Booking Designator (RBD) code (e.g. Y - Economy, D - Business). You can get this code from Flight Schedule Search Response. | 0..1 | |
PreferLevel | string ("Preferred" - default, "Only", "Unacceptable") | Indicates the level of preference of a particular seat. | 0..1 | |
FareRestrictPref |
|
| Contains info about private fares for requested flight. |
|
PreferLevel | string (“Only”, “Unacceptable”, “Preferred” - default, “Required”, “NoPreference”) | Indicates the level of preference of a particular fare. | 0..1 | |
FareRestrictPref/ PrivateFare* |
|
| Contains client’s fare code. | 1..1 |
AccountCode* | string (1-32) | Contains corporate fare code for requested flight. | 1..1 |
OTA_AirLowFareSearchRQ/TravelerInfoSummary*:
Element | Attribute | Type | Description | Min…Max occurs |
---|---|---|---|---|
| SpecificPTC_Indicator | boolean (default - “true”) | if true - it forces supplier to return fare applicable only for requested PTC. If false - supplier can return offers where some passenger types (e.g. CHD- child) is rated as another (e.g. as ADT -adult). | 0..1 |
AirTravelerAvail* |
|
| Specifies passenger numbers and types. | 1..1 |
AirTravelerAvail/ PassengerTypeQuantity* |
|
| Specifies number of passengers using Passenger Type Codes. | 1..* |
Code* | string (“ADT” , “CHD” , “INF”, “INS”) | Indicates Passenger Type Code. Possible values: “ADT” (adult), “CHD” (child), “INF” (infant), “INS” (infant with seat). | 1..1 | |
Quantity* | integer | Defines the number of passengers for an associated Code. Value must always be "1" for child and infant. | 1..1 | |
Age | integer | Indicates age of passengers used for suppliers that the fares depend on the age of the passenger. This attribute is mandatory only for Child and Infant. Age rule: 0-1 year old - infant; 2-17 years old - child; 12-more years old - adult. | 0..1 | |
|
| Specifies Tour Lead nationality. | 0..1 |
OTA_AirLowFareSearchRQ/TravelerInfoSummary/AirTraveler:
Element | Attribute | Type | Description | Min…Max occurs |
---|---|---|---|---|
| PassengerTypeCode* | sting ("ADT" - adult) | Indicates the particular passenger type. | 1..1 |
ProfileRef* |
|
| Contains information about passenger's IDs. | 1..1 |
ProfileRef/UniqueID/UniqueID |
|
| 1..1 | |
ID* | integer | Passenger's ID. | 1..1 | |
Type* | integer | Must always has the value = “1”. | 1..1 | |
Document* |
|
| Contains information about Tour Lead document only. | 1..1 |
DocType* | sting ("P") | Specifies type of Tour Lead document. Possible value - P (Passport). | 1..1 | |
DocHolderNationality* | 2 or 3-character ISO currency code | Code of the Tour Lead nationality. | 1..1 | |
| <AirTraveler PassengerTypeCode="ADT">
<ProfileRef>
<UniqueID ID="1" Type="1"/>
</ProfileRef>
<Document DocHolderNationality="US" DocType="P"/>
</AirTraveler> |
|