Room type information
Operationcode: CATINFO
CATINFO
SIHOT.WEB can check the occupation information that a hotel user sees in the SIHOT front office system. This information can be different from AV.
Direction
SIHOT.PMS ← SIHOT.WEB
Message
SIHOT.WEB makes the following request (CATINFO) to SIHOT.PMS in order to receive the information data for a period.
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-DOCUMENT>
<OC>CATINFO</OC>
<ID>1</ID>
<TN>1</TN>
<FROM>2012-12-01</FROM>
<TO>2012-12-24</TO>
<CAT>DZ</CAT>
</SIHOT-DOCUMENT>
Attributes Message
| Element | Description | Data type | Usage |
|---|---|---|---|
| OC | Operation code | String | Mandatory |
| ID | Property number to request availability for if you only need to request for a single hotel | String | Optional* |
| FROM | First date to get information for | Date | Mandatory |
| TO | Last date to get information for | Date | Mandatory |
| CAT | The room category that you wish to request availability for. If not provided then all room categories available for SIHOT.WEB at a property will be returned |
String | Optional |
| VER | Version of the request | String | Optional |
Response
<?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>
<OC>CATINFO</OC>
<RC>0</RC>
<MSG>OK</MSG>
<MSG-LIST/>
<TN>1</TN>
<ID>1</ID>
<ACATINFO>
<CAT>DZ</CAT>
<DAYS>
<D>2012-12-01</D>
<TOTAL>33</TOTAL>
<OOO>0</OOO>
<OCC>0</OCC>
<D>2012-12-02</D>
<TOTAL>33</TOTAL>
<OOO>0</OOO>
<OCC>0</OCC>
<D>2012-12-03</D>
<TOTAL>33</TOTAL>
<OOO>0</OOO>
<OCC>0</OCC>
</DAYS>
</ACATINFO>
</SIHOT-Document>
Attributes Response
| Attribute | Description | Data type |
|---|---|---|
| D | Day | Date |
| TOTAL | The total number of room of this room type. This figure can be different each day, because rooms can be out of inventory. | Integer |
| OOO | Number room out of order | Integer |
| OCC | Occupation% of this room type. The formula for this percentage is defined in SIHOT. In this percentage group blocks, allotments ... have an influence. This percentage cannot be recalculated. | Integer |
Operationcode: GET-CAT-DEFINITION
GET-CAT-DEFINITION
To receive the special PMS settings for any category, SIHOT.Web sends the following base request to SIHOT.PMS:
Direction
SIHOT.PMS ← SIHOT.WEB
Message
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<OC>GET-CAT-DEFINITION</OC>
<TN>0</TN>
</SIHOT-Document>
Attributes Message
None
Response
<?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>3</TN>
<ID>1</ID>
<RC>0</RC>
<OC>CAT-DEFINITIONS</OC>
<A-CAT-DEFINITION-LIST>
<ID>1</ID>
<CAT-DEFINITION>
<CAT>EZ</CAT>
<NAME>Single Room</NAME>
<ISBED>N</ISBED>
<EXTERNAL-CAT>HTNG=EZ:\*;SW=EZ:\*</EXTERNAL-CAT>
<PERCENTAGE-TO-WEB>100</PERCENTAGE-TO-WEB>
<IS-HIDDEN>N</IS-HIDDEN>
<IS-SUITE>N</IS-SUITE>
<ORDER>2</ORDER>
<MIN-PAX>0</MIN-PAX>
<MAX-PAX>1</MAX-PAX>
<MAX-EXTRA-PAX>1</MAX-EXTRA-PAX>
<HAS-CRITERIA>N</HAS-CRITERIA>
</CAT-DEFINITION>
<CAT-DEFINITION>
<CAT>DZ</CAT>
<NAME>Double Room</NAME>
<ISBED>N</ISBED>
<EXTERNAL-CAT>HTNG=DZ:\*;SW=DZ:\*</EXTERNAL-CAT>
<PERCENTAGE-TO-WEB>100</PERCENTAGE-TO-WEB>
<IS-HIDDEN>N</IS-HIDDEN>
<IS-SUITE>N</IS-SUITE>
<ORDER>3</ORDER>
<MIN-PAX>0</MIN-PAX>
<MAX-PAX>2</MAX-PAX>
<MAX-EXTRA-PAX>2</MAX-EXTRA-PAX>
<HAS-CRITERIA>N</HAS-CRITERIA>
</CAT-DEFINITION>
<CAT-DEFINITION>
<CAT>SUI</CAT>
<NAME>Suite</NAME>
<ISBED>N</ISBED>
<EXTERNAL-CAT/>
<PERCENTAGE-TO-WEB>0</PERCENTAGE-TO-WEB>
<IS-HIDDEN>N</IS-HIDDEN>
<IS-SUITE>Y</IS-SUITE>
<ORDER>4</ORDER>
<A-SUITE-PART-LIST>
<SUITE-PART>
<PART-CAT>DZ</PART-CAT>
<PART-CAT-NUMBER>2</PART-CAT-NUMBER>
</SUITE-PART>
</A-SUITE-PART-LIST>
<MIN-PAX>0</MIN-PAX>
<MAX-PAX>999</MAX-PAX>
<MAX-EXTRA-PAX>0</MAX-EXTRA-PAX>
<HAS-CRITERIA>N</HAS-CRITERIA>
</CAT-DEFINITION>
</A-CAT-DEFINITION-LIST>
<A-RESTRICT-LIST>
<ID>1</ID>
</A-RESTRICT-LIST>
</SIHOT-Document>
Element A-CAT-DEFINITION-LIST
| Element | Description | Data type |
|---|---|---|
| A-CAT-DEFINITION-LIST/ID | Web ID for the hotel | Long |
| CAT | Short name for the category | String |
| NAME | Long description for the category | String |
| ISBED | “Y” = this category represents beds | Char |
| EXTERNAL-CAT | Code for the external system and the external code for this category in the external system | String |
| PERCENTAGE-TO-WEB | Percentage amount of free rooms available for SIHOT.Web | Integer |
| IS-HIDDEN | Flag, if this category is hidden | Char |
| IS-SUITE | Flag, if this category is a suite | Char |
| ORDER | The order in which the room categories should be displayed. | Integer |
| A-SUITE-PART-LIST | If the category is a suite, this list is exported. See table below | |
| STD-PAX | Default number of guests in this room | Short |
| MIN-PAX | Number of persons necessary for bookings | Short |
| MAX-PAX | Max. number of base persons allowed | Short |
| MAX-EXTRA-PAX | Max. number of extra persons allowed | Short |
| L-COMMENTS | List of comments, see table below | |
| HAS-CRITERIA | Flag, of there are special criteria for this cat | Char |
| A-CRITERION-LIST | List of criteria | |
| CRITERION_NAME | Name of the criterion | String |
| CRITERION_ID | ID for this criterion | Unsigned long |
| A-RESTRICT-LIST | List of restrictions, see chapter 29.3 for more details |
L-COMMENTS
| Element | Description | Data type |
|---|---|---|
| COMMENT | Block for each language | |
| LANG | Language code | String |
| T | Comment | String |
A-SUITE-PART-LIST
| Element | Description | Data type |
|---|---|---|
| SUITE-PART | Block with data for each room type in this suite | |
| PART-CAT | Containing category code | String |
| PART-CAT-NUMBER | Number of rooms of this category in this suite | Integer |
A-ROOM-PART-LIST
| Element | Description | Data type |
|---|---|---|
| ROOM-PART | Block with data for each bed type in this room | |
| PART-CAT | Containing bed category code | String |
| PART-CAT-NUMBER | Number of beds of this bed category in this room | Integer |