By default, a Vehicle Search returns all available rates that meet the request search parameters. Availability can be requested by one or more of the following car rate modifiers:
Request
In addition to the minimum required data for a Vehicle Search, the car type options are added as attributes of the VehicleSearchAvailabilityRequest/VehicleSearchModifiers/RateModifiers.
Show schema diagram
Most rate type requests will require the supplier's VendorCode to be included in the request in combination with the rate type modifier(s). One or more of the following attributes can be added to the request to support:
- When known, a supplier RateCode can be specified in the request.
- A supplier DiscountNumber identifies a special rate associated with a traveler's organization or supplier promotion.
- VendorCode limits the requested rate to a specific vendor. If VendorCode is not specified, any promotional code is ignored.
- PromotionalCode can be added if the customer has a specified promotional code from the supplier.
-
VendorLocationRef is used to associate the /RateModifiers with the VendorLocation/@Key of the same value.
- TourCode is issued by an airline to identify the relationship between an air booking and a vehicle booking that are purchased together as a package.
Rate Codes
If multiple vendor Rate Codes are specified, multiple vendor DiscountNumbers and LoyaltyCards are not supported when a vendor rate code for the requested provider.
Exceptions
Worldspan supports a maximum of two Rate Codes.
Corporate Discount Codes (DiscountNumber)
Universal API supports up to three Corporate Discounts per supplier and one Loyalty Card per supplier when RateModifiers/RateCode is not specified. When a rate code is specified, only one supplier is allowed; therefore, only one Corporate Discount and one Loyalty Card is allowed per transaction.
See Vehicle Search with Loyalty Program for more details about the limitations of Corporate Discount Codes when used in combination with a Loyalty Program.
Exceptions
Worldspan supports a maximum of three Corporate Discount IDs.
PermittedVendors and ProhibitedVendors are not applicable with multiple Discount Numbers.
Vendor Location Reference
The Vendor Location Reference associates of the RateModifiers (and LoyaltyCard) information to the correct Pickup and Return Locations.
Notes:
-
If VendorLocationRef is in the request, the /VendorLocation@Key is required with the same value.
- When the VendorLocationRef is present and there is no VendorLocation/@key of the same value, Universal API returns the following error: “Match VendorLocation/@Key to veh:VendorLocationRef and resend request”
-
When more than one Pickup Location is requested and the VendorLocation/@Key is not present and/or a VendorLocationRef is not present with a RateModifier or LoyaltyCard, Universal API returns the following error: “Missing VendorLocation/@Key or veh:VendorLocationRef, update and resend request.”
Tour Code
A tour code is issued by an airline to identify the relationship between an air booking and a vehicle booking that are purchased together as a package. The tour code must be shown on the ticket so that both the airline and the local BSP or ARC know what the fare is, and that the agency has authority to use it.
The code has a maximum of 13 alpha/numeric characters that show on the ticket.
Notes:
- Worldspan (1P) Only.
- <common_v50_0:ResponseMessage Code="7816" Type="Warning" ProviderCode="1G">Distance and direction search criteria is not supported with CarMatrix and has been ignored.</common_v50_0:ResponseMessage>
Response
A standard Vehicle Search response is returned in VehicleSearchAvailabilityRsp. However, rental options reflect the specified parameters of the request. Rate information in the response is returned in VehicleReservation/Vehicle/VehicleRate.
