Hotel Location by Hotel Property ID
common:VendorLocation
A Hotel Search or Hotel Supper Shopper request can be modified to request one or more specific properties by Property ID (Hotel Code). Vendor Location searches are not limited to properties in a specific locale.
Either a VendorLocation value or an alternate HotelSearchLocation value is required in the search request.
Note that in some In some transactions, Hotel Property IDs are alternately requested using HotelProperty @HotelCode.
Implementation by Provider
See Implemented Transactions for provider functionality specific to each transaction.
Provider |
Implementation |
---|---|
Galileo (1G) | VendorLocation is supported for Galileo. |
Apollo (1V) | VendorLocation is supported for Apollo. |
Worldspan (1P) |
VendorLocation is supported for Worldspan. |
Request
The following attributes are required if the VendorLocation element is sent in request.
Element/Attribute | Description |
---|---|
VendorLocation |
Provides hotel Property ID information. Galileo (1G) and Apollo (1V)
Galileo and Apollo can process a maximum of:
|
@ProviderCode | The provider for the vendor request: "1G", "1V", "1P". |
@VendorCode |
The chain code for the hotel chain that owns the requested property.
|
@VendorLocationID |
The property code for the hotel chain that owns the requested property. |
The VendorCode and VendorLocationID must correspond to the codes used by the specified provider. Because different providers use different numbering systems to identify hotel properties, the ProviderCode attribute indicates the provider associated with the property number.
Response
The response returns availability data only for the requested Property IDs, even if additional modifiers were included in the request. If multiple HotelSearchLocation modifiers are sent in the request they are prioritized in this order: VendorLocation, and HotelLocation.
Error and Warning Messages
A warning is also returned: The @Location attribute is ignored, because VendorLocationID is applied.
The returned data includes ProviderCode, VendorCode, VendorLocationID, and Key.
Schema
The VendorLocation element in Common.xsd is used to specify Properties IDs.
Note that VendorLocation is also used other types of travel segments. Information in this topic pertains only to VendorLocation usage for Hotel segments.
See the following transactions for Hotel Property ID (VendorLocation):
- Synchronous Hotel Search:
- Hotel Super Shopper:
Implemented Transactions and XPaths
HotelSearchAvailabilityReq/HotelSearchLocation/VendorLocation
HotelSearchAvailabilityRsp/HotelSearchResult/HotelProperty @VendorLocation
In addition to the minimum requirements for a Hotel Search for properties, Property ID information can be included by adding VendorLocation.
The response returns standard Hotel Search data. However, only the specified properties are returned.