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

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