Skip to content

Transmission of allotments

There are two types of messages we support.

  1. SIHOT.PMS → SIHOT.WEB (notification request)
  2. SIHOT.WEB → SIHOT.PMS (request for allotment data)

Operationcode: ALLOT

ALLOT

At startup and at a regular base, SIHOT.PMS is sending this notification request to SIHOT.WEB including the active allotments for guests with an internet password and a matchcode.

Direction

SIHOT.PMS → SIHOT.WEB (notification request)

SIHOT.WEB → SIHOT.PMS (request for allotment data)

Message

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
    <OC>ALLOT</OC>
    <ID>1</ID>
    <TN>1</TN>
    <AALLOTMENTLIST>
        <ALLOTMENT>
            <ALLOTMENT-NO>4</ALLOTMENT-NO>
            <ALLOTMENT-EXT-NO>17</ALLOTMENT-EXT-NO>
            <MATCHCODE>g3454</MATCHCODE>
            <CENTRALGUEST-ID>89789</CENTRALGUEST-ID>
            <AVAILABLE-FOR-ALL-CLIENTS>Y</AVAILABLE-FOR-ALL-CLIENTS>
            <FROM>2006-01-01</FROM>
            <TO>2006-12-31</TO>
            <CONTACT/>
            <RELEASE>0</RELEASE>
            <TYPE>0</TYPE>
            <T-TYPE>Kontingent</T-TYPE>
            <GROUP>1</GROUP>
            <T-GROUP>Test 1</T-GROUP>
            <TXT>
                <LANG>DE</LANG>
                <T>Weihnachtsbäckerei</T>
            </TXT>
            <AVAILABLE>
                <CAT>4B</CAT>
                <AV>
                    <D>2004-10-21</D>
                    <NO>100</NO>
                </AV>
                <AV>
                    <D>2004-10-22</D>
                    <NO>104</NO>
                </AV>
            </AVAILABLE>
            <AVAILABLE>
                <CAT>XB</CAT>
                <AV>
                    <D>2004-10-21</D>
                    <NO>106</NO>
                </AV>
                <AV>
                    <D>2004-10-22</D>
                    <NO>109</NO>
                </AV>
            </AVAILABLE>
        </ALLOTMENT>
        <ALLOTMENT>
            <ALLOTMENT-NO>1</ALLOTMENT-NO>
            <MATCHCODE>elm</MATCHCODE>
            <CENTRALGUEST-ID>89780</CENTRALGUEST-ID>
            <AVAILABLE-FOR-ALL-CLIENTS>N
            </AVAILABLE-FOR-ALL-CLIENTS>
            <TXT>
                <LANG>DE</LANG>
                <T>Weihnachtsbäckerei</T>
            </TXT>
            <AVAILABLE>
                <CAT>4B</CAT>
                <AV>
                    <D>2004-10-21</D>
                    <NO>100</NO>
                </AV>
                <AV>
                    <D>2004-10-22</D>
                    <NO>104</NO>
                </AV>
            </AVAILABLE>
            <AVAILABLE>
                <CAT>XB</CAT>
                <AV>
                    <D>2004-10-21</D>
                    <NO>106</NO>
                </AV>
                <AV>
                    <D>2004-10-22</D>
                    <NO>109</NO>
                </AV>
            </AVAILABLE>
        </ALLOTMENT>
    </AALLOTMENTLIST>
</SIHOT-DOCUMENT>

Attributes Message

Element Description Data type
ID Hotel id Long
ALLOTMENT-EXT-NO External allotment number, contract number Long
ALLOTMENT-NO Internal allotment number Long
ALLOTMENT-EXT-KEY External key of the allotment String
MATCHCODE Matchcode of the allotment owner String
CENTRALGUEST-ID Central guest ID of the allotment owner Unsigned long
AVAILABLE-FOR-ALL-CLIENTS Y, means, that all guest can book this allotment, not only the one who owns this allotment Char
FROM Start date Date
TO End date Date
CONTACT Contact person String
RELEASE Release Short
TYPE Allotment type code Char
T-TYPE Allotment type description String
GROUP Group type code Char
T-GROUP Group type description String
RATE-SEGMENT Price segment String
AVAILABLE Block with availabilities

AVAILABLE

Inside AVAILABLE, there are following elements:

Element Description Data type
CAT Room type code String
AV Several availability data
D Date Date
NO Number of free rooms Integer
NOOVB Number of available rooms Integer
NO2STOPSELL Number of free rooms until stop sell, if stop sell is set Integer
NOOVB2STOPSELL Number of available rooms until stop sell, of stop sell is set Integer
SCOPE Overall size of the allotment Integer
TENTATIVE-SCOPE Number of all tentative rooms Integer
TENTATIVE-USED Number of used rooms Integer
NOCONTRACT Number of rooms contracted Integer

Response

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
        <OC>ALLOT</OC>
        <ID>1</ID>
        <TN>1</TN>
        <RC>0</RC>
        <MSG>OK</MSG>
</SIHOT-DOCUMENT>

Operationcode

ALLOT

The external system can also requested detailed information about an allotment.

Direction

External System → SIHOT.PMS

Message

This request is used to retrieve allotment information for certain allotments for a guest or to retrieve allotment information for the requested allotment.

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
        <OC>ALLOT</OC>
        <ID>1</ID>
        <TN>1</TN>
        <MATCHCODE></MATCHCODE>
        <ALLOTMENT-NO>12</ALLOTMENT-NO>
        <ALLOTMENT-EXT-NO>234</ALLOTMENT-EXT-NO>
        <FROM>2017-03-02</FROM>
        <TO>20017-03-10</TO>
</SIHOT-DOCUMENT>

Attributes Message

Element Description Data type
ID Hotel id Long
ALLOTMENT-EXT-NO External allotment number, contract number Long
ALLOTMENT-NO Internal allotment number Long
ALLOTMENT-EXT-KEY External key for the allotment String
FROM Start date Date
TO End date Date
MATCHCODE Matchcode of the allotment holder String

Response

Attributes Response