Vehicle: Promotional Codes and Coupons
RateModifiers @PromotionalCode
SupplierRate @DiscountAmount
Promotional Codes are rate modifiers that can be added to include coupons or supplier (vendor) discounts for a Vehicle Search request. If a promotional rate is selected, the Promotional Code must be included in subsequent Vehicle Rules or Vehicle Booking requests.
This topic supports the use of promotional codes for Vehicle segments only.
Implementation by Provider
See Implemented Transactions for provider functionality specific to each transaction.
Provider |
Implementation |
---|---|
Galileo (1G) | Supported by Galileo. Implementation varies by transaction. |
Apollo (1V) | Supported by Galileo. Implementation varies by transaction. |
Worldspan (1P) | Supported by Worldspan. |
Schema
Request
To make a vehicle request with a Promotional Code or Coupon:
- In RateModifiers @VendorCode, send the supplier associated with the PromotionalCode.
- In RateModifiers @PromotionalCode, send the coupon or promotional code issued by the supplier. A maximum of 19 characters are supported for supplier promotional codes.
- If applicable, send the associated Discount ID (RateModifiers @DiscountNumber). Some suppliers require an associated Discount ID.
Response
In the response, the amount of the discount is returned in SupplierRate @DiscountAmount. The amount is a flat amount and not a percentage.
However, Discount Amount is not always returned. Some suppliers return a regular base rate with a discount amount. Other suppliers return a modified base rate with the discount applied (DiscountAmount=Currency0.00).
Note: If a Promotional Coupon is used, the Promotional category is not returned response unless a Promotional rate category is requested. The category in the request is passed to the suppliers (vendors), but they are not required to send a category back in their response to Travelport. Suppliers frequently ignore the category sent, and sends the best rates that apply for the rental period and all search parameters.
Associated Transactions
Vehicle:VehicleSearchAvailabilityReq/VehicleSearchModifiers/RateModifiers @PromotionalCode
Vehicle:VehicleSearchAvailabilityRsp/Vehicle/VehicleRate/SupplierRate @DiscountAmount
Promotional codes are supported for all applicable providers for Vehicle Searches.
Vehicle:VehicleRulesLookup/VehicleSearchModifiers/RateModifiers @PromotionalCode
Vehicle:VehicleRulesRsp/Vehicle/VehicleRate/SupplierRate @DiscountAmount
Support for Promotional Codes in Vehicle Rules varies by provider. Currently, Promotional Codes are supported only for Worldspan in the Vehicle Rules request. Promotional Codes sent to Galileo (1G) and Apollo (1V) are ignored.
Currently, the associated Promotional Code is not returned in the Vehicle Rules response. Therefore, VehicleRulesRsp/Vehicle/VehicleRate @PromotionalCode is empty in all responses.
Universal:VehicleCreateReservationReq/Vehicle/VehicleRate @PromotionalCode
Universal:VehicleCreateReservationRsp/UniversalRecord/VehicleReservation/Vehicle/SupplierRate @DiscountAmount
Promotional codes are supported for all applicable providers for Vehicle Booking.