SIHOT.PMS ←→ Price Systems
A “Price system” in this chapter is a system that can manage:
- Either packages
- Their calculation
- The components
- And the prices
- Of only a system that manages prices like an Yield-System.
SIHOT can receive from a “Price system” a complete new package including all components. Still the basic parameters are defined in SIHOT, like revenue code or payments types. Therefore, a new message type is introduced to request from SIHOT all this basic data. On this interface we check if all data is consistent and send back to the price system some error codes with plain text.
Request basic configuration
With this record a booking is requested (not all of these data need to be filled):
Attribute | Denotation | Type |
---|---|---|
OC | Action Type:GCF = Get Configuration | String |
CFTYPE | Configuration Type.A detailed description is given below | String |
LN | Language | String |
A request for gathering information about Revenue accounts (CFTYPE is UK) in hotel number 1:
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4729</TN>
<HN>1</HN>
<OC>GCF</OC>
<LN>EN</LN>
<CFTYPE>UK</CFTYPE>
</SIHOT-Document>
The answer will be:
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4729</TN>
<OC>GCF</OC>
<HN>1</HN>
<SIHOT-CFG>
<KEY>20000000</KEY>
<VALUE>Sum Food</VALUE>
</SIHOT-CFG>
<SIHOT-CFG>
<KEY>20010000</KEY>
<VALUE>Sum Beverage</VALUE>
</SIHOT-CFG>
<SIHOT-CFG>
…
</SIHOT-Document>
Request configuration for packages
Below, you find the configuration types to be requested to get all configuration values for a package. This is based on the following screen:
In the basic data:
Description | Value for CFTYPE |
---|---|
Package Type | 32 |
Manual Rate | 68 |
Discount | 07 |
Commission | 07 |
VAT Group | |
Currency | |
Posting frequency | LH |
VAT | 53 |
VAT Calculation | 07 |
Grouping | GP |
Rate per Person | 68 |
Card revenue | 07 |
Type of posting | KB |
Hide data | 68 |
Not identify./calc | 68 |
Rate Segment | PS |
Guest Type | PG |
Post components | 68 |
In the component list:
Description | Value for CFTYPE |
---|---|
Service | 09L |
Posting frequency | LH |
HSK frequency | LH |
Quantity depending on number of pax/room | 68 |
Manual rate | 68 |
Manual commission | 68 |
Sending packages
Sending a package from a “Price system” to SIHOT is split into two parts:
- Basic data for the packages, including components
- Prices of the package, also for different seasonal dates.
Send package (basics)
The SPB message sends a complete package to SIHOT. In case this package did not exist, the package is created, otherwise modified. The prices of an existing package are not changed. A deletion of a package is not possible. To reach the same result, set the attribute “Hide Data”
to Yes.
Attribute | Denotation | Type |
---|---|---|
OC | Action Type:SPB = Sends packages basics | String |
SID | Service Identification | String |
RS | Rate segment | String |
GT | Guest Type | String |
IT | Internal Package Type | String |
PT | Package Type | String |
MR | Manual Rate | String |
DI | Discount | String |
CO | Commission | String |
VG | VAT Group | String |
CU | CurrencyCurrency code has only to be send in case of an package in foreign currency | String |
PF | Posting frequencyPosting frequency has to be send only in case that the frequency is not “every day”. | String |
VA | VAT | String |
VC | VAT Calculation | String |
GR | Grouping | String |
IS | Invoice sequence | |
FC | Free of charge | |
PC | Post components | String |
RP | Rate per person | String |
CR | Card revenue | String |
TP | Type of posting | String |
HD | Hide data | String |
NI | Not ident. | String |
SA | SAP Code | |
PV | Price valid for n-days | |
DESC | Description in default language | |
COMM | Comment in default language | |
MC | ID of Mother company |
The attributes are included in <SIHOT-PACKAGE>
and </SIHOT-PACKAGE>
.
For descriptions in other languages than the default:
Attribute | Denotation | Type |
---|---|---|
ISO | ISO language code | |
DESC | description |
The attributes are included in <DESC-LANG>
.
For comments in other languages than the default:
Attribute | Denotation | Type |
---|---|---|
ISO | ISO language code | |
COMM | comment |
The attributes are included in <COMM-LANG>
.
For the components:
Attribute | Denotation | Type |
---|---|---|
SID | Service Identification | |
CT | Component type | |
FI | Fixed, only on component is allowed as not fixed. | |
PF | Posting frequency | |
HF | HSK frequency | |
QP | Quantity pending on no of pax/room | |
QA | Quantity | |
PPU | Price per unit | |
MR | Manual rate | |
CR | Commission rate | |
CO | Manual commission rate | |
GT | Guest Type | String |
The attributes are included in <SIHOT-PACKAGE-COMP>
and <SIHOT-PACKAGE-COMP>
.
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4789</TN>
<OC>SPB</OC>
<HN>4711</HN>
<SIHOT-PACKAGE>
<SID>AP</SID>
<RS></RS>
<GT></GT>
<IT>R</IT>
<PT>\*\*</PT>
<MR></MR>
<DI>1</DI>
<CO>2</CO>
<VG></VG>
<CU></CU>
<PF></PF>
<VA>00</VA>
<VC>1</VC>
<GR></GR>
<IS></IS>
<FC></FC>
<PC></PC>
<RP>0</RP>
<CR>0</CR>
<TP></TP>
<HD></HD>
<NI>0</NI>
<SA></SA>
<PV>0</PV>
<SIHOT-PACKAGE-COMPONENT>
<SID>LO</SID>
<CT>G</CT>
<FI>0</FI>
<PF></PF>
<HF></HF>
<QP>0</QP>
<QA></QA>
<PPU>0</PPU>
<MR>0</MR>
<CR>0</CR>
<CO>0</CO>
</SIHOT-PACKAGE-COMPONENT>
<SIHOT-PACKAGE-COMPONENT>
<SID>FR</SID>
<CT>G</CT>
<FI>1</FI>
<PF></PF>
<HF></HF>
<QP>0</QP>
<QA></QA>
<PPU>18.00</PPU>
<MR>0</MR>
<CR>0</CR>
<CO>0.00</CO>
</SIHOT-PACKAGE-COMPONENT>
</SIHOT-PACKAGE>
</SIHOT-Document>
Everything was stored correctly:
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4789</TN>
<OC>ACK</OC>
<RC>0</RC>
</SIHOT-Document>
Send package (prices)
These attributes are necessary to identify a package.
Attribute | Denotation | Type |
---|---|---|
OC | Action Type:SPP = Sends packages prices | String |
SID | Service Identification | String |
RS | Rate segment | String |
GT | Guest Type | String |
CU | CurrencyCurrency code has only to be send in case of an package in foreign currency | String |
These attributes are responsible to control prices. The prices given are always in currency of the package.
Attribute | Denotation | Type |
---|---|---|
CAT | Room category | String |
FROM | Price is valid from | Date |
TO | Price is valid until | Date |
P0 – P14 | Price 0 to Price 14The interpretation of Price 0 to Price 14 is given by attribute IT . For Details see user handbook for SIHOT. |
Money |
The attributes are included in <SIHOT-PACKAGE-PRICE>
and
<SIHOT-PACKAGE-PRICE>
.
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4790</TN>
<OC>SPP</OC>
<HN>4711</HN>
<SIHOT-PACKAGE>
<SID>AP</SID>
<RS></RS>
<GT></GT>
<SIHOT-PACKAGE-PRICE>
<FROM>2006-01-01</FROM>
<TO>2006-12-31</TO>
<CAT>EZ</EZ>
<P0>100.00</P0>
<P1>100.00</P1>
<P2>110.00</P2>
<P3>0.00</P3>
<P4>0.00</P4>
<P5>0.00</P5>
<P6>0.00</P6>
<P7>0.00</P7>
<P7>7.50</P7>
</SIHOT-PACKAGE-PRICE>
<SIHOT-PACKAGE-PRICE>
<FROM>2006-01-01</FROM>
<TO>2006-12-31</TO>
<CAT>DZ</EZ>
<P0>120.00</P0>
<P1>120.00</P1>
<P2>130.00</P2>
<P3>0.00</P3>
<P4>0.00</P4>
<P5>0.00</P5>
<P6>0.00</P6>
<P7>0.00</P7>
<P7>7.50</P7>
</SIHOT-PACKAGE-PRICE>
<SIHOT-PACKAGE-PRICE>
<FROM>2006-01-01</FROM>
<TO>2006-12-31</TO>
<CAT>SUI</EZ>
<P0>150.00</P0>
<P1>150.00</P1>
<P2>160.00</P2>
<P3>0.00</P3>
<P4>0.00</P4>
<P5>0.00</P5>
<P6>0.00</P6>
<P7>0.00</P7>
<P7>7.50</P7>
</SIHOT-PACKAGE-PRICE>
</SIHOT-PACKAGE>
</SIHOT-Document>
Everything was stored correctly.
<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
<TN>4790</TN>
<OC>ACK</OC>
<RC>0</RC>
</SIHOT-Document>