Skip to content

Developer Guide - Rates Push API

What is the Rates Push API?

Kurzurlaub.de uses the OTA messages OTA_HotelRateAmountNotifRQ/RS and OTA_HotelRatePlanNotifRQ/RS to receive rates and sales flags (restrictions) for a hotel.

The data sent by the OTA partner is only accepted for rooms and offers that are active and online, alternatively warnings are sent in response.

In general, rows with availability are considered individually, i.e. an error in the RoomTypeCode or in the date format, date range is only sent as a warning for this one row. All other rows are processed independently.

For example, each message contains a single RateAmountMessages element that specifies the hotel to be updated using the RateAmountMessages/@HotelCode attribute. The RateAmountMessages/RateAmountMessage elements contain the updates to be processed over a date range.

Example: <StatusApplicationControl InvTypeCode="1234" RatePlanCode="TEST-RATE-CHRISTMAS" Start="2024-12-26" End="2024-12-27"/>

Note:

Multiple RateAmountMessage updates can be made per request, but each request is limited to one hotel (HotelCode) and its rooms and/or offers.

Types of rates

The first question should always be:

Do we only use rates on

  1. Room level (RoomType only) / e.g. room daily rates
  2. Room level and/or offer level (RoomType/RatePlan combination)

This also forms the basis of all communication and is determined individually for each hotel and each OTA partner at the beginning.

1. Rates at room level

If your backend only supports rates at room level (daily rates) - i.e. only room types (RoomType) and no rate plans in combination with rooms, please use this variant.

This means daily rates for rooms.

2. Rates at room/offer level

If your backend supports rates at room/offer level - i.e. room types and rate plans (so-called RoomType/RatePlan combinations), please use this variant.

This means daily rates for special offers in a room.

Rates based on room daily rates

The question: Should we transfer package prices of the offers for all nights or is it better to always send a price per day - the daily rate of the room?

The better way would be to send the daily rate per room type and offer if applicable.

Example:

Offer: 3 nights in a double room with 2 people for 170 Euro per person.

We use a room-based price per day (daily rate) to calculate the offer/package prices per person - this means:

for 3 daily rates:

90 Euro + 100 Euro + 110 Euro daily rate per room = total 300 Euro / 2 people = 150 Euro per person for the room costs

plus 20 Euro for additional services in the arrangement (e.g. 1 dinner).

The calculated offer price is then 170 Euro per person.

If you prefer a different method, e.g. the total package price per person, let us know.

Overview of available messages

Overview of available messages - official OTA messages - for retrieving/sending rates on

Read rates from Kurzurlaub.de

  • OTA_HotelRatePlanRQ : by specifying RatePlanCode or RatePlanID, the daily rates for selected rate plans / offers and assigned rooms (with RatePlanCode) are delivered

Raten senden an Kurzurlaub.de

  • OTA_HotelRateAmountNotifRQ : Rates and restrictions with RoomType/RatePlan combinations

  • OTA_HotelRatePlanNotifRQ : Rates and restrictions (beta) - method is currently not supported globally. If you want to send rates or restrictions via this endpoint, please contact Kurzurlaub.de's Connectivity Support