| 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 |
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 different 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, we can not calculate the price for requests for 6 persons and therefore it would not be available on Holidu. The same is true if you provide rates only for a maxStay of 7 days, even though it is possible to stay longer (this will also generate an error). To sum up → Always provide a rate valid for the maximum number of allowed people in the apartment and the maximum length of stay. |
If you send to us two different prices for exactly the same date, to rates with EXACTLY the same rules e.g. same minStay, the same number of persons, then we will consider the lowest price to calculate the total payment!
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 Holidu.
| Code Block | ||
|---|---|---|
| ||
{
"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
]
}
]
} |