Skip to content

Request for special rates

Rates can be calculated directly in SIHOT.PMS. This happens if: 1. No rates are set in SIHOT.WEB 2. There are complicated rates, e. g. special agreements.

Direction

SIHOT.PMS ← SIHOT.WEB: PI

Operationcode

PI

Message

The request for special rates is only allowed for the interaction between SIHOT.WEB and SIHOT.PMS. Special rates are e. g. needed for arrangement with weekend rates. If special rates are requested for a guest, the element <MATCHCODE> is set.

The current version is “2.1”, older versions aren’t supported.

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
    <VER>2.1</VER>
    <OC>PI</OC>
    <ID>1</ID>
    <TN>1</TN>
    <RC>0</RC>
    <MSG>OK</MSG>
    <MATCHCODE>GUBSE</MATCHCODE>
    <GUEST-OBJID>25</GUEST-OBJID>
    <ARATELIST>
        <RATE>
            <FROM>2005-08-22</FROM>
            <TO>2005-08-24</TO>
            <SID>VP</SID>
            <CAT>2Z</CAT>
            <PERS-TYPE>1A</PERS-TYPE>
            <PRICE-ATTRIBUTE>1</PRICE-ATTRIBUTE>
            <RATE-SEGMENT/>
            <ROOM-OCCUPATION>
                <PERS-TYPE>
                    <TYPE>1A</TYPE>
                    <NO>1</NO>
                </PERS-TYPE>
                <PERS-TYPE>
                    <TYPE>1B</TYPE>
                    <NO>1</NO>
                </PERS-TYPE>
            </ROOM-OCCUPATION>
        </RATE>
        <RATE>
            <FROM>2005-08-22</FROM>
            <TO>2005-08-24</TO>
            <SID>VP</SID>
            <CAT>4Z</CAT>
            <PERS-TYPE>1A</PERS-TYPE>
            <RATE-SEGMENT/>
            <ROOM-OCCUPATION>
                <PERS-TYPE>
                    <TYPE>1A</TYPE>
                    <NO>1</NO>
                </PERS-TYPE>
                <PERS-TYPE>
                    <TYPE>2A</TYPE>
                    <NO>2</NO>
                </PERS-TYPE>
            </ROOM-OCCUPATION>
        </RATE>
    </ARATELIST>
</SIHOT-DOCUMENT>

Attributes Message

Element Description Data type Usage
OC Operation Code=”PI” String Mandatory
TN Transaction number String Mandatory
VER Version number ( use “2.1”!) String Mandatory
ID ID of the hotel String Mandatory, if no IDLIST is given
IDLIST List with several hotel IDs Mandatory, if no ID is given
MATCHCODE Matchcode of a guest profile used for rate calculation String Optional
GUEST-OBJID OBJID from guest String Optional
ARATELIST Block with several RATE blocks inside Mandatory

Following elements are to be filled inside a RATE-block:

Element Description Data type Usage
FROM Start date Date Mandatory
TO End date Date Mandatory
SID Package code String Optional
SID-LIST List of package codes Optional
CAT Room type String Optional
CAT-LIST List of room types Optional
PERS-TYPE Guest type String Optional
RATE-SEGMENT Rate segment String Optional
MULTOC Flag if multiple categories could be used Char Optional
CURRENCY Currency used for rate calculation String Optional
IDX Index of the rate Short Optional
ALLOTMENT-NO Number of the allotment contract, if available Long Optional
PRICE-ATTRIBUTE Filter for available rates Long Optional

If there are price categories in a rate request, they are written in the <CAT> element. Otherwise the <CAT> element contains the room categories.

Message

Answer OC:PIA

After a PI request, SIHOT.PMS sends the following answer with the <OC>PIA</OC>.

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
    <VER>2.1</VER>
    <OC>PIA</OC>
    <ID>1</ID>
    <TN>1</TN>
    <RC>0</RC>
    <MSG>OK</MSG>
    <ARATELIST>
        <RATE>
            <CURRENCY>EUR</CURRENCY>
            <SID>VP</SID>
            <CAT>2Z</CAT>
            <PERS-TYPE>1A</PERS-TYPE>
            <R>
                <DAY-PRICE>
                    <D>2005-08-22</D>
                    <PPU>112.00</PPU>
                </DAY-PRICE>
                <DAY-PRICE>
                    <D>2005-08-23</D>
                    <PPU>114.00</PPU>
                </DAY-PRICE>
            </R>
        </RATE>
        <RATE>
            <CURRENCY>EUR</CURRENCY>
            <SID>VP</SID>
            <CAT>4Z</CAT>
            <PERS-TYPE>2A</PERS-TYPE>
            <R>
                <DAY-PRICE>
                    <D>2005-08-22</D>
                    <PPU>102.00</PPU>
                </DAY-PRICE>
                <DAY-PRICE>
                    <D>2005-08-23</D>
                    <PPU>104.00</PPU>
                </DAY-PRICE>
            </R>
        </RATE>
    </ARATELIST>
</SIHOT-DOCUMENT>

Attributes Response

Explanation of elements inside RATE block:

Element Description Data type
CURRENCY Currency used for rate calculation String
SID Package code String
CAT Room type String
MULTOC Flag Char
ID Hotel id Long
PERS-TYPE person type String
RATE-SEGMENT Rate segment String
IDX Index send in the request Short
ALLOTMENT-NO Number of the allotment contract, if available Long
R Block with daily rates

Elements inside R-Block are returned in several DAY-PRICE-blocks which include the following elements:

Element Description Data type
D Day Date
PPU Price for this day Decimal
PRICE-ATTRIBUTE Special availability flag Long