Get hotel definitions

The GET-HOTEL-DEFINITON Request is used to get the whole data of one or more hotels.

Operationcode: `GET-HOTEL-DEFINITION`

GET-HOTEL-DEFINITION

Direction

SIHOT.PMS ← SIHOT.WEB

Message

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
        <OC>GET-HOTEL-DEFINITION</OC>
        <IDLIST> <!--optional-->
                <ID>2650</ID>
                <ID>2500</ID>
        </IDLIST>
        <TN>1</TN>
       <FLAGS>GET-ALL-HOTELS;SEND-EXTRA-DATA;SEND-USERFIELD-DATA</FLAGS>
</SIHOT-Document>

Response

After a GET-HOTEL-DEFINITON Request, SIHOT sends the following answer:

<?xml version="1.0" encoding="iso-8859-1"?>
<SIHOT-Document>
    <SIHOT-Version>
        <Version>9.0.0.0000</Version>
        <EXE>D:\\SIHOT\\sinetres.exe</EXE>
    </SIHOT-Version>
    <TN>1</TN>
    <ID>2650</ID>
    <RC>0</RC>
    <OC>HOTEL-DEFINITIONS</OC>
    <A-HOTEL-DEFINITION-LIST>
        <A-HOTEL-DEFINITION>
            <ID>2650</ID>
            <NAME1>GRAND HOTEL GUBSE</NAME1>
            <NAME2/>
            <GM>Jörg Berger</GM>
            <STREET>Bahnhofstrasse</STREET>
            <POBOX/>
            <POSTCD>66578</POSTCD>
            <CITY>Schiffweiler</CITY>
            <ADDRESS2/>
            <FON>+49 6821 9646 0</FON>
            <FAX/>
            <EMAIL>grandhotel@sihot.com</EMAIL>
            <WEB/>
            <LANGUAGE>DE</LANGUAGE>
            <ISO-LANGUAGE>de</ISO-LANGUAGE>
            <COUNTRY>DE</COUNTRY>
            <HOTELTYPE>3</HOTELTYPE>
            <HOTELCATEGORY/>
            <NO-ROOMS>28</NO-ROOMS>
            <NO-BEDS>105</NO-BEDS>
            <REGION>9250</REGION>
            <BRAND/>
            <INTERNAL-NAME/>
            <SMTP/>
            <ADDITIONAL>
                <PACKAGES>UF1</PACKAGES>
                <HISTORYUPDATE>3</HISTORYUPDATE>
                <GUESTTYPE>1A</GUESTTYPE>
                <CURRENCY>EUR</CURRENCY>
                <ROUNDINGFACTOR>0.01</ROUNDINGFACTOR>
                <HISTORYSOURCE>1</HISTORYSOURCE>
                <CL-BALANCE>14</CL-BALANCE>
                <CLEARDBTIME>31</CLEARDBTIME>
                <DISCOUNTGROUP/>
                <DEFAULTRULE/>
                <AUTHORISATIONFILTER>0
                </AUTHORISATIONFILTER>
            </ADDITIONAL>
            <STATUSINFO>
                <DIRTY>01</DIRTY>
                <CHECKIN>04</CHECKIN>
                <CLEAN>04</CLEAN>
                <DIRTYBYARRIVAL>06</DIRTYBYARRIVAL>
                <ALLROOMS>1</ALLROOMS>
                <UPDCLEANINGCHECK/>
                <UPDMAINTENANCECHECK/>
            </STATUSINFO>
            <SUPPLIES>
                <SOAP/>
                <TOWEL/>
                <LINEN>A2</LINEN>
            </SUPPLIES>
            <BANK>
                <COMPANY-NO/>
                <RECIPIENT-BANK/>
                <BANKDETAILS-LIST/>
            </BANK>
            <HOTEL-EXTRA-DATA>
                <UID/>
                <UID2/>
                <UID3/>
                <FISKALNAME/>
                <FISKALSTRASSE/>
                <FISKALORT/>
                <FISKALPLZ/>
                <FISKALLAND/>
                <DIRECTOR/>
                <SUBDIRECTOR/>
                <FBMANAGER/>
                <FOMANAGER/>
                <CONTROLLER/>
                <KITCHENMANAGER/>
                <EVENTMANAGER/>
                <SMMANAGER/>
                <RESERVATIONMANAGER/>
                <GUESTRELATION/>
                <BANK1/>
                <BANKCODENUMBER1/>
                <BANKACCOUNT1/>
                <BANKINFO1/>
                <BANK2/>
                <BANKCODENUMBER2/>
                <BANKACCOUNT2/>
                <BANKINFO2/>
                <BANK3/>
                <BANKCODENUMBER3/>
                <BANKACCOUNT3/>
                <BANKINFO3/>
                <BANK4/>
                <BANKCODENUMBER4/>
                <BANKACCOUNT4/>
                <BANKINFO4/>
                <BANK5/>
                <BANKCODENUMBER5/>
                <BANKACCOUNT5/>
                <BANKINFO5/>
                <BANK6/>
                <BANKCODENUMBER6/>
                <BANKACCOUNT6/>
                <BANKINFO6/>
                <MARKETING1/>
                <MARKETING2/>
                <MARKETING3/>
                <MARKETING4/>
                <MARKETING5/>
                <HEADER/>
                <FOOTER/>
                <EMAILBODY/>
            </HOTEL-EXTRA-DATA>
            <A-USERFIELD-LIST>
                <USERFIELD>
                    <FIELD>Userfield 1</FIELD>
                    <VALUE>007</VALUE>
                </USERFIELD>
                <USERFIELD>
                    <FIELD>Userfield 2</FIELD>
                    <VALUE>008</VALUE>
                </USERFIELD>
            </A-USERFIELD-LIST>
        </A-HOTEL-DEFINITION>
    </A-HOTEL-DEFINITION-LIST>
</SIHOT-Document>

Attributes Response

IDLIST

The <IDLIST> block contains a list of hotel numbers. For all hotels in this list the response returns the corresponding hotel definition. The <IDLIST> block is optional. If there is no block in the request specified than the response contains the hotel definitions of every hotel or only for the current hotel.

FLAGS

The following flags in the <FLAGS>-tag can limit the amount of information in the response:

GET-ALL-HOTELS if set and the <IDLIST> block is missing than the response contains the hotel definitions of every else only for the current hotel.

SEND-EXTRA-DATA if set than the response contains the <HOTEL-EXTRA-DATA> block.

SEND-USERFIELD-DATA if set than the response contains the <A-USERFIELD-LIST> block.

The flags are separated through a semicolon.

String

A-HOTEL-DEFINITION-LIST

The block contains a list of every hotel definition. A single hotel definition is defined in the <A-HOTEL-DEFINITION> block and contains all information around the hotel.

`A-HOTEL-DEFINITION`

Attribute	Description	Data type
ID	SIHOT.WEB ID of the hotel	String
NAME1, NAME2	Hotel name(s)	String
GM	General manager name	String
STREET	Hotel street	String
POBOX	Postal box	String
POSTCD	Postal code	String
CITY	Town	String
ADDRESS2	Additional town info (not salutation!)	String
FON	Phone number	String
FAX	Fax number	String
EMAIL	Email	String
LANGUAGE	SIHOT language code	String
COUNTRY	Country code	String
HOTELTYPE	Type of hotel, zoom type U1	Char
HOTELCATEGORY	Category, zoom type U2	Char
NO-ROOMS	Number of rooms	Short
NO-BEDS	Number of beds	Short
REGION	Hotel region	String
BRAND	Hotel brand	String
INTERNAL-NAME	Internal hotel name	String
SMTP	SMTP server	String
ADDITIONAL	Block with additional hotel info
STATUSINFO	Block with status codes
SUPPLIES	Block with supply rhythm info. This block returns the information about Housekeeping rhythms to change soap, towels or linen in an occupied room.
BANK	Block with bank details
HOTEL-EXTRA-DATA	Block with extra data, if requested in SCOPE
A-USERFIELD-LIST	Block with user fields, if requested in SCOPE
ISO-LANGUAGE	ISO 639-1 language code	String

`ADDITIONAL`

Attribute	Description	Data type
PACKAGES	Standard package code of the hotel	String
HISTORYUPDATE	Code for type of guest profiles which should be updated after a stay.	Char
GUESTTYPE	Guest type code representing the target market (e.g. 1A = Adult)	String
CURRENCY	Hotel currency	String
ROUNDINGFACTOR	Hotel rounding factor	Decimal
HISTORYSOURCE	Code for history source	String
CL-BALANCE	Standard number of days after which a city ledger should be booked out	Short
CLEARDBTIME	Standard number of days after which the data base should be cleared	long
DISCOUNTGROUP	Default discount group	String
DEFAULTRULE	Code for default rule, zoom type RU	String
AUTHORISATIONFILTER	In MPE-installations, this field determines which guests are authorized to reserve rooms at the property. Only guests with the corresponding guest rate type flag in their profile can make reservations.	Long

`STATUSINFO`

Attribute	Description	Data type
DIRTY	Status for rooms which are not clean. The status is set during the night run.	String
CHECKIN	Status which renders a room available for check-in.	String
CLEAN	Status which defines a room as clean, but not yet available for check-in.	String
DIRTYBYARRIVAL	Status after check-in.	String
ALLROOMS	If ‚1‘, all rooms are changed to status dirty during the night run. If ‚0‘, only occupied rooms are changed to status dirty during the night run.	Char
UPDCLEANINGCHECK	Status to be entered after Check-out. If field is empty, the status will not be changed.	String
UPDMAINTENANCECHECK	Status to be entered after Check-out. If empty, the status will not be changed.	String

`SUPPLIES`

SOAP

Zoom type LH,

e.g. “ANRE” = arrival day

String

TOWEL

LINEN

`BANK`

Attribute	Description	Data type
COMPANY-NO	Company code	String
RECIPIENT-BANK	Bank name	String
BANKDETAILS-LIST

`BANKDETAILS`

Attribute	Description	Data type
TYPE	STANDARD	String
ACC-NO	Account number	String
ACCNAME	Account name	String
BANKACC	Bank name	String
BSB-NO	Bank ID	String
STREET	Street	String
COUNTRY	Country	String
POBOX	Postal box	String
CITY	Town	String
FON	Phone number	String
EMAIL	Email	String
CONTACT	Contact person	String

`HOTEL-EXTRA-DATA`

Attribute	Description	Data type
UID	Fiscal number	String
UID2	Fiscal number 2	String
UID3	Fiscal number 3	String
FISKALNAME	Fiscal data for the hotel	String
FISKALSTRASSE		String
FISKALORT		String
FISKALPLZ		String
FISKALLAND		String
DIRECTOR	SIHOT.PMS User IDs for the according person	String
SUBDIRECTOR		String
FBMANAGER		String
FOMANAGER		String
CONTROLLER		String
KITCHENMANAGER		String
EVENTMANAGER		String
SMMANAGER		String
RESERVATIONMANAGER		String
GUESTRELATION		String
BANK(n)	Additional bank details for up to 6 further banks ( n=1..6)	String
BANKCODENUMBER(n)		String
BANKACCOUNT(n)		String
BANKINFO(n)		String
MARKETING(n)	Up to 5 marketing information	String
HEADER	Head line for Emails	String
FOOTER	Foot line for Email	String
EMAILBODY	Body for EMails	String

Get hotel definitions

Operationcode: GET-HOTEL-DEFINITION

Direction

Message

Response

Attributes Response

A-HOTEL-DEFINITION

ADDITIONAL

STATUSINFO

SUPPLIES

BANK

BANKDETAILS

HOTEL-EXTRA-DATA