Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

There are two different ways of providing the prices for an apartment. One is providing us with the daily rates, the other is using LOS (length of stay rates).

Be aware that if you choose LOS we will not consider data sent to the endpoints RATES and AVAILABILITIES

Daily Rates 

If you are using daily rates (instead of LOR), you will have to send us the prices for every available day.

How does it work?

  • You can send multiple rate plans for an apartment and day if you change the parameters of the rate

.
  • You can send, for example, different rates for the same days for a stay from 1 to 6 days and a stay 7 days and longer

.
  • You can also provide different rate plans for

a
  • different

amount of people.
  • numbers of guests

Example:

In the example on the right side, there are 2 rate plans. :

  • One for short stays (between 1 and 6 days long), and

  • one for longer stays (from 7 days and longer), both for a maximum of 5 people

.
Warning

Please make sure to always provide rates for all possible stays.

If e.g. the apartment can fit 6 persons, but you only specify rates for 5 persons, we can not calculate prices the price for requests for 6 persons and therefor therefore it would not be available on holiduHolidu. The  

The same is true if you would provide rates only rates for a maxStay of 7 days, although even though it is possible to stay longer .So please always provide always (this will also generate an error).

To sum up → Always provide a rate valid for the maximum number of allowed persons people in the apartment and the maximum length of stay!.

Availabilities

You need to make sure that the availabilities and prices you push are synchronized. Only if a specific day is pushed as available and has a price configured, it will be shown as available on holiduHolidu

Code Block
languagejson
{
 "providerApartmentId": "123456",
 "ratePlans": [
   {
     "rateId": "SHORT_STAY",
     "persons": 5,
     "currency": "EUR",
     "minStay": 1, 
     "maxStay": 6,
     "dailyRates": [
       {
         "date": "2024-11-24",
         "price": 200, // Price per night
         "extraPerson": 0, // Price for any extra person between 5 and the max capacity
         "checkInDay": true, // Can a customer check-in on this date ?
         "checkOutDay": false // Can a customer check-out on this date ?
       },
       {
         "date": "2024-11-25",
         "price": 200,
         "extraPerson": 0,
         "checkInDay": true,
         "checkOutDay": true
       },
       {
         "date": "2024-11-26",
         "price": 200,
         "extraPerson": 0,
         "checkInDay": false,
         "checkOutDay": true
       },

       // Add other dates here
     ]
   },
   {
     "rateId": "MEDIUM_STAY",
     "persons": 5,
     "currency": "EUR",
     "minStay": 7,
     "maxStay": 365,
     "dailyRates": [
       {
         "date": "2024-11-24",
         "price": 150,
         "extraPerson": 0,
         "checkInDay": true,
         "checkOutDay": false
       },

       // Add other dates
     ]
   }
 ]
}