A Hotel Search request can be modified to include Negotiated Rates or Corporate Discount IDs, which are determined by a contract or agreement between the supplier and an organization.
Providers use data tables to store the rates.
- Galileo (1G) and Apollo (1V) support Negotiated Rate Codes using Multi-Level Rate Access Codes.
- Wordspan (1P) supports both Negotiated Rate Codes and Corporate Discount IDs using the Hotel RAST table.
Rates in these tables are specific, confidential information that has been loaded by the hotel supplier on behalf of their customer. For example:
ABC Tours, as a consumer of the Travelport Universal API™, can display specifically negotiated Corporate Discount or Negotiated Rates that their client, XYZ Widgets Company, has contractually agreed upon with a specific hotel chain or property. The XYZ Widget Company rate access code is passed via the Multi-Level Rate Access Code or Hotel RAST table. These rate access codes are usually for a specific contractual client, term, or length and are provided by the property or hotel supplier to the provider on behalf of the Travel Management Company (TMC.)
Request
Negotiated Rates, Travelport Exclusive Rates, and Corporate Discounts are requested by adding one or more HotelSearchModifiers/CorporateDiscountID elements to a Hotel Search.
- For Negotiated Rates, the NegotiatedRateCode attribute must be set to 'true'.
-
For Travelport Exclusive Rates, use CorporateDiscountID @NegotiatedRateCode="4TM".
Note: Travelport Exclusive Rates can be returned in conjunction with any additional rate access codes included in the request. To ensure that all rate access codes in the request are processed and sent to the hotel provider, set HotelDetailsModifiers @ProcessAllNegoRatesInd="true".
- For Corporate Discount IDs, the NegotiatedRateCode attribute must be blank.
Universal API supports the maximum of Corporate Discount ID/Negotiated Rate Codes allowed by the provider in the request. However, the number of permitted Rate Codes/Corporate Discount IDs can vary by provider and supplier.
Response
The response returns a basic Hotel Search response; however, all of the available room/rates correspond to the requested Rate Codes or Discount IDs. All Rate Codes/Discount IDs in a single request have the same priority in the response.
Errors and Warnings
- If NegotiatedRateCode is set to 'false', an error is returned.
- If more than the provider allowed Negotiated Rates/Discount IDs are sent, only the allowed number are processed by Universal API, and a warning is returned.
- If a specific Negotiated Rate Code or Corporate Discount ID cannot be processed, a warning is returned.
Exceptions
Galileo (1G)
- Galileo accepts a maximum of four Negotiated Rates/Corporate Discount IDs in a single request.
-
If no hotel options meet the request parameters, the response may be relaxed to include other hotels. In this instance, any hotel responses that include a Negotiated Rate Code/Discount ID are using the Negotiated Rate/Discount ID parameter.
Apollo (1V)
- Apollo accepts a maximum of four Negotiated Rates/Corporate Discount IDs in a single request.
-
If no hotel options meet the request parameters, the response may be relaxed to include other hotels. In this instance, any hotel responses that include a Negotiated Rate Code/Discount IDs are using the Negotiated Rate/Discount ID parameter.
Worldspan (1P)
- Worldspan supports both Negotiated Rates and Corporate Discount IDs. Corporate IDs and Negotiated Rates can be combined in the same request. The maximum allowed in the availability request is eight (Corporate Rate Code with Negotiated Rate="true") plus the ability to have one negotiated rate code (Corporate Rate Code with Negotiated Rate not entered).
