By default, a Vehicle Search response returns all available suppliers. However, supplier codes can be added to a request to either permit (include) or prohibit (exclude) specific vendors from the response option.
Request
A standard Vehicle Search request is modified to include permitted or prohibited vendors. In addition to the minimum required search data, the PermittedVendors and ProhibitedVendors children of VehicleSearchAvailabilityReq/VehicleSearchModifiers are used to specify permitted or prohibited suppliers.
Permitted and prohibited vendors cannot be combined in a request.
Requesting Permitted Vendors
One or more instances of the PermittedVendors child is sent to include only the supplier codes of one or more permitted Vendors (suppliers) in the response.
The maximum number of permitted suppliers varies by provider.
Requesting Prohibited Vendors
One or more instances of the ProhibitedVendors child is sent to exclude the supplier codes of one or more permitted Vendors (suppliers) from the response.
The availability of prohibited suppliers varies by provider.
Response
A standard Vehicle Search request is made including a Location Type indicator. In addition to the minimum required search data, the PickupLocationType and ReturnLocationType attributes of VehicleSearchAvailabilityReq/VehicleDateLocation are used to specify the location for the corresponding PickupLocation and ReturnLocation.
Error and Warning Responses
- If none of the suppliers are available for the requested search, a message is returned.
- If the maximum number of permitted suppliers for a provider is exceeded, a warning is returned to indicate which vendors were not sent in the request: Max number of permitted vendors exceeded for this host. The following vendor(s) were not included in the request:[...].
Exceptions
Galileo (1G) and Apollo (1V)
- Galileo and Apollo support one to four permitted suppliers in a single request.
- Galileo and Apollo do not currently support prohibited suppliers in its vehicle search functionality.
Worldspan (1P)Worldspan support:
- One to 99 permitted suppliers in a single request.
- One to six prohibited suppliers in a single request.
Permitted and prohibited suppliers cannot be combined in the same request. An error is returned.
