Programming with php: Can I use the php5 SOAP extension?
We do not recommend the use of this method for programming as there seems to be an interoperability problem between php and .NET.
The problem might be caused by the fact that our type of .NET web service requires a document/literal request whilst the php5 extension probably does not send it that way by default.A SOAP request will be created which will not fit our interface structure.
Webservice clients using CURL and NuSoap generally achieve satisfactory results.
When requesting large areas like Bavaria the response time is too long.How can it be reduced?
Due to direct connections to the biggest Central Reservation Systems worldwide and the high number of hotels being requested, we strongly advise against making requests for such important locations.In order to have a more satisfactory search use the GetMultiAvailability method instead which will optimize your results as you are able to request hotels just by PropertyNumber.
When using the method GetAvailableHotelsFromDestination we do not receive any results at all, irrespective of the destination we are looking for.
You need to switch to the production interface (using your product AffiliateNumber) first and check whether you are getting a response.If not, please send us your xml-request and xml-response pair to assure speedy assistance.We also recommend using the method GetAvailableHotelsFromLocationNr for better response data quality.
Is my XML request well formed?I get an error message.
For quick and adequate support please create an xml-request with one of the recommended tools (i.e. SoapUI) and try sending it to our production interface (containing your production AffiliateNumber).If you still receive an error message please send us a support query including:
your XML request and response
the WSDL endpoint you´re using currently
Can we get all hotel information in one single request?(availability + details)
There is no possibility of receiving all information in one request due to performance parameters.Providing all hotel information in one request would generate poor results in respect of the response time and also create a possible overload for our external providers.
The best way to use our webservice is by requesting the hotel details only should the customer wish to view them, e.g. clicking on "details" on your website.In this case we recommend the application of the GetPropertyDescription method.As hotel information can change frequently we recommend retrieving all information by live request.Only then will you receive the most up to date hotel information displayed.
Please note: Only one property description can be requested at a time.
Can we request all room types/rates in one request?
No.Only requests for one room type are possible.The AllowRoomUpgrade option might be of use as this value also considers higher room types.Where no double room is available the next higher room type will be displayed depending on availability.
Can we download the complete hotel catalogue via the webservice?
No.Our webservice is not meant to be used for the creation of your own database but for live requests only.For this reason it is not allowed.
2. General questions on the response
Is there any method to limit the response amount, e.g. for big cities like Berlin or London, or to even to restrict the maximum number of hotels being returned?
No, there is not.In order to decrease the amount of available properties you can limit the result by ContractStatus, Radius, etc. We also recommend setting the flag RequestMyRESOnly to "true" for big European cities like Berlin or London.
Is there a pre-sort function for the response we are getting from your webservice?
No, there is not.The hotel response sort is the same as that of hotel.info.If you need a different sort you have to use different response parameters in order to make the sort for yourself.
3. Price information
We have noticed price discrepancies between the webservice and your website.Why is this?
In order to retrieve live information analog to our website please use the production interface as our test system is not up to date.
What kind of prices does your webservice provide?There seems to be a price discrepancy between your webservice and your website.
There is no guarantee for the average price obtained from external Central Reservation Systems.We can guarantee this only for our myRES properties.It might however be that prices shown are valid for one night and not an average over more than one night.
If you would like to display the total price on your website by calculating the price received from our webservice, please add a preamble to your terms and conditions, stating that the total price is displayed on your hotel provider's website and clearly indicate that you do not take any responsibility for the accuracy of what is displayed.(=DirectBookingLink to the booking step 3).
Sample calculation for the average price: You would like to book a room for 5 nights in a hotel..The price for the first 3 nights is 50 EUR per night, the price for the 2 remaining nights is 120 EUR per night (e.g. where the hotel increased the rate price due to a fair/exhibition).
3 x 50 EUR = 150 EUR
2 x 120 EUR = 240 EUR
Consequently the booking price is 390 EUR for the 5 nights.The average of 390 is 78 EUR.This should be the price you obtain from our webservice (mostly myRES).
If you request just one night the cheapest room for one night will be shown.
4. Hotel information
How can I request high resolution hotel pictures?
The ThumbnailPictureURL from the GetAvailable-methods just show small icons.Use the method GetPropertyDescription to obtain high quality hotel pictures.
Which description languages are available in the GetPropertyDescription?
You can choose from one of our languages: German, English, French, Spanish or Italian as the Description Language.For some hotels there already is a description available in the chosen language, if not, the English description will be displayed.In the case of an external CRS it depends on each hotel as to which description language is stored.The following language descriptions (German, English, French, Spanish, and Italian) are currently available for our myRES-hotels.