Documentation of the CarRentalAgentService

CarRentalAgentService. Method 

Checks whether weekend specials are available or not.

public WeekendSpecialAvailableResponse (
   WeekendSpecialAvailableRequest request
);

Parameters

WeekendSpecialAvailableRequest
A WeekendSpecialAvailableRequest containing the necessary reference data.

Return Value

A WeekendSpecialAvailableResponse containing the desired information.

Remarks

Due to the fact, that weekend specials are special offers with restrictions, they are not delivered by GetRates - Method. Weekend specials are available in a defined timeframe, that is mostly from thursday(or friday) till sunda(or monday). So if a customer likes to rent a car within this timeframe your booking-module should call the GetWeekendSpecials - Method to request these special offers. Because the timeframe differs from offer to offer, this method was designed to check if weekend specials are available. It should provide a possibility to verify that the user of a booking module likes to see these offers, considering that there's a restriction concerning the rental-timeframe. For instance this method is used by the websites of sunnycars in that manner.(see: www.sunnycars.de)

List Of defined call-variants

parameters IsWeekendSpecialAvailableP1 IsWeekendSpecialAvailableP2
token required required
departureDate required required
arrivalDate required required
currencyCode optional optional
departureRegionId required not applicable
arrivalRegionId required not applicable
departureLocationId not applicable required
arrivalLocationId not applicable required



Description : Checks whether weekend specials are available at the given Region or not. Checks whether weekend specials are available at the given Location or not.

List Of Errors Returned

Error Code Description
E_ARRIVAL_DATE_TIME_TOO_EARLY The given arrival date / time is too early.

This error occurs if:

  • The date / time is in past relative to departure date / time.

E_DEPARTURE_DATE_TIME_TOO_EARLY The given departure date / time is too early.

This error occurs if:

  • The date / time is in past relative to tomorrow.

E_XML_DATETIME_FORMAT This error occurs if one of the DateTime-Values has an invalid format. The values have to be ISO 8601 formatted date and time strings. For detailed information about date-time format please refer to the description of the property mentioned in CausingField.
E_DATE_TIME_INVALID This error occurs if one of the DateTime-Values has an invalid format, even if the format seems to be okay at the first view. The database hasn't identified a real formatting issue, but wasn't able to convert the string into a DateTime value nevertheless. For detailed information about date-time format please refer to the description of the property mentioned in CausingField.
E_DEPARTURE_PLACE_NOT_SET Neither the DepartureRegionId nor the DepartureLocationId was set in request-parameters.
E_ID_INVALID One of the id's handed over in DepartureRegionId, DepartureLocationId, ArrivalRegionId or ArrivalLocationId isn't known by the system.
E_PARAMETER_REQUIRED A required parameter was missing in the performed request. For detailed information please refer to the description of the property mentioned in CausingField.

List Of Warnings Returned

Warning Code Description
W_CURRENCY_CODE_INVALID The requested currency code is not known by the system. Using default currency instead.
W_CURRENCY_NOT_SUPPORTED The requested currency code is not supported. Using default currency instead.

See Also

CarRentalAgentService Class | SunnyCars.Services.Osi.WsReservation Namespace