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

LOS Rates

The easiest and most flexible way of providing the prices for your properties is to push the length of stay rates .Instead of giving us a price per day and having us calculate what the final price for a stay would be -- or whether it should even be available considering restrictions -- you can (LOS).

You can directly give us the price for every possible length of stay (up to 60 nights) and occupancy (up to the max persons of the property), given a possible check-in date. In this way, we get the correct price from you and also we will avoid further calculation processes to compute the accurate final price of a stay. Besides this, by using the LOS you can let us know if a property is or is not available (hence you won’t use the AVAILABILITY endpoint).

How does it work?

  • Each entry must have:

    • the check-in date

,
    • the currency

,
    • the max amount of

guest
    • guests for which the rates are applicable followed by a value set for every possible length of stay for the given check-in day.

      • A value of 0 means that it is not possible to

checkout
      • check out at this length.

      • You can provide the prices for up to a length of 60 days.

      • If you push less than 60 values, every missing value is considered as 0 and

therefor
      • therefore not available. 

Example:

On the right side of the page, you can see an example of a possible LOS rate for the check-in day 2019-09-01.

  • The 0 in the price row indicates that the property is not available for a length of stay between 1 and 6 days

.
  • For a stay of 7 days, it would cost 120 EUR

.
  • The next available length of stay would be 14 days and so on

.
  • This price configuration is valid for up to 5 guests, if you have different prices for different

amount
  • numbers of

people
  • guests, you have to send the prices for each

amount of persons
  • variable.

    • Please make sure to always provide a rate that is valid for the max amount of people allowed in the apartment.

  • Only

checkin
  • the check-in days that are

send
  • sent to us with prices will be

taken
  • considered as available for check-in

and only length of stays with prices are available. There
  • It is not

possibility
  • possible to block a single day manually, you have to always push the full

los
  • LOS for the

apartment.
  • property

  • You also have to

push us the
  • push the full data for one apartment in one call

, there is no possibility
    • It is not possible to modify the

los
    • LOS for a single check-in day or to add

some
    • information

.
    • If you push

los
    • LOS again for the same apartment, everything from the old data will be overwritten and only the last pushed data will be

taken into account
    • considered.

Everything that you will push in rates endpoint will be ignored as soon as you send us los rates. 

Note

Discounts

Regarding discounts, you have two options

.

:

  • You can send the prices already including discounts and do the calculation on your site or,

  • you can send us the undiscounted prices and the discounts separately to the discounts endpoint. We will then calculate the discount on our site. 

Extra Costs 

You still need to push us the extra costs separate from the

los rates

LOS data in order to be correctly shown on holidu.

Warning

Availabilities

Everything

availability you push in availabilities

you PUSH to the AVAILABILITY endpoint will be overwritten by the information you

provide in the los rates, so

send to the LOS endpoint. To sum up! → In case you use LOS instead of RATES there is no use in pushing data to the availability endpoint

in case you are using los rates

.

Warning

Code Block
languagejson
"los": {
    "2019-09-01": [
      {
        "currency": "EUR",
        "guests": 5,
        "price": [
          0,
          0,
          0,
          0,
          0,
          0,
          120,
          0,
          0,
          0,
          0,
          0,
          0,
          240,
          0,
          0,
          0,
          0,
          0,
          0,
          360,
          0,
          0,
          0,
          0,
          0,
          0,
          480
        ]
      }
    ],