Skip to content

Developer Guide - Inventory Push API

What is the Inventory Push API?

Kurzurlaub.de uses the OTA messages OTA_HotelAvailNotifRQ/RS and OTA_HotelInvCountNotifRQ/RS, to receive availabilities and sales flags for a hotel.

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

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

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

Notice:

There can be multiple AvailStatusMessage updates per request, however each request is limited to one hotel (HotelCode) and its rooms and/or offerings.

Two types of availability data

The first question should always be:

We only use availabilities on

  1. room level (RoomType only)
  2. room level and/or rate level (RoomType/RatePlan combination)

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

1. Room level based availability

If your backend only supports room-level availabilities - i.e. only room types (RoomType) and no rate plans, please use this variant.

2. Room/Rate based availability

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

Overview of available messages

Overview of available messages - official OTA messages - for retrieving/sending availabilities

Read availability from Kurzurlaub.de

Send availabilities to Kurzurlaub.de