Returns hotel packages.
This function returns all data which can be set in Settings - Stay packages. Hence we recommend that you check your settings before using this funtion to better understand the output structure.
Parameters
term
Returns hotel packages within selected time period.
Insert dates in W3 date format. Example: 2010-04-29
<term> [1] |
|
|
<from> [1] |
from (date) |
<to> [1] |
to (date) |
|
currencies
With this parameter you can specify in which currencies you would like prices of hotel packages to be returned. You can only select currencies which the hotel permits.
If you leave out this parameter, the function returns package prices in the default currency of the hotel.
<currencies> [0..1] |
|
|
<currency> [1..*] |
Specified curreny. Specify by EITHER currency ID OR code. |
|
|
|
Sample request
<request>
<login>prihlasovaci_jmeno</login>
<password>heslo</password>
<hotId>745896</hotId>
<term>
<from>2010-01-01</from>
<to>2010-12-31</to>
</term>
<currencies>
<currency>
<code>CZK</code>
</currency>
<currency>
<code>EUR</code>
</currency>
</currencies>
<lanId>2</lanId>
</request>
Output
Possible ways to select a package
Option |
Description |
---|
text |
As a text |
checkbox |
As a checkbox |
Billing method for packages - Version as of 6th Sept. 2010
pcuId |
Name |
Description |
---|
1 |
/balíček |
Price for the whole package |
2 |
/noc |
Price charged per night |
3 |
/os./noc |
Price charged per person per night |
4 |
/os. |
Price charged per person |
5 |
/pokoj/noc |
Price charged per room per night |
6 |
/pokoj |
Price charged per room |
Root element - packages
package
<package> [0..*] |
If the hotel doesn't offer packages, the function will not return anything. |
|
<pckId> [1] |
Package ID |
<hotId> [1] |
Hotel ID |
<tax> [1] |
VAT rate in % |
<name> [1] |
Package name |
<description> [0..1] |
Package description |
<group> [0..1] |
Group of packages. One or more packages can be included in one group. |
<nights> [0..1] |
Package can be booked only for stays of length of %d nights |
<galId> [0..1] |
Package gallery ID |
<selection> [1] |
Package selection method |
<unit> [1] |
Billing method for the package. Only of importance for online bookings. The reservation grid for these units are ignored and the price is determined based on the number of packages. |
|
<pcuId> [1] |
Unit ID |
<name> [1] |
Unit name. Price in % |
<description> [1] |
Unit description |
|
|
<season> [1..*] |
If the package price differs for various different time periods, the element <season> with its elements <from> and <to> appear multiple times in the output. If the element <season> only appears once in the output without the elements <from> and <to>, then the package price remains the same throughout the year.
|
|
<from> [0..1] |
from |
<to> [0..1] |
to |
<display> [1] |
This package is displayed on the web and on the booking form. Possible values "true" or "false" |
<required> [1] |
This package is required for online reservations. Possible values "true" or "false" |
<price> [1..*] |
Package price. If the price for different room kinds is different, the element appears multiple times in the output. |
|
<objectKind> [0..1] |
Room kind, provided that the package price is for different room kinds |
|
<obkId> [1] |
Object kind ID |
<name> [1] |
Object kind name |
|
<rate> [1..*] |
Package price. If the request specified multiple currency types, the element appears multiple times in the output. |
|
<price> [1] |
Price (amount in selected currency) |
<currency> [1] |
Currency |
|
|
|
|
|
|
Sample output
<packages>
<package>
<pckId>1</pckId>
<hotId>1</hotId>
<tax>20</tax>
<name>Silvestrovská show</name>
<selection>text</selection>
<unit>
<pcuId>1</pcuId>
<name>/balíček</name>
<description>Cena je jednorázová za celý balíček.</description>
</unit>
<season>
<display>true</display>
<required>false</required>
<price>
<rate>
<price>1500</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>60</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
</season>
</package>
<package>
<pckId>2</pckId>
<hotId>1</hotId>
<tax>20</tax>
<name>Parkovací místa (1 auto = 1 místo)</name>
<description>Parkovací místo v podzemní garáži hotelu.<description>
<group>V.I.P. klienti<group>
<selection>text</selection>
<unit>
<pcuId>5</pcuId>
<name>/pokoj/noc</name>
<description>Cena je učtována za každý pokoj a noc.</description>
</unit>
<season>
<display>true</display>
<required>false</required>
<price>
<rate>
<price>100</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>4</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
</season>
</package>
<package>
<pckId>3</pckId>
<hotId>1</hotId>
<tax>20</tax>
<name>TV k dispozici na pokoji</name>
<description>Satelitní TV s plazmovou obrazovkou.<description>
<galId>22789</galId>
<selection>text</selection>
<unit>
<pcuId>6</pcuId>
<name>/pokoj</name>
<description>Cena je učtována za každý pokoj.</description>
</unit>
<season>
<from>2010-09-01</from>
<to>2010-09-30</to>
<display>true</display>
<required>false</required>
<price>
<objectKind>
<obkId>1</obkId>
<name>Single Room</name>
</objectKind>
<rate>
<price>300</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>12</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>2</obkId>
<name>Double Room</name>
</objectKind>
<rate>
<price>400</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>15</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>3</obkId>
<name>Trojlůžkové</name>
</objectKind>
<rate>
<price>500</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>20</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>4</obkId>
<name>Double Queen Room</name>
</objectKind>
<rate>
<price>600</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>25</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
</season>
<season>
<from>2010-10-01</from>
<to>2010-10-31</to>
<display>true</display>
<required>false</required>
<price>
<objectKind>
<obkId>1</obkId>
<name>Single Room</name>
</objectKind>
<rate>
<price>330</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>15</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>2</obkId>
<name>Double Room</name>
</objectKind>
<rate>
<price>440</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>20</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>3</obkId>
<name>Trojlůžkové</name>
</objectKind>
<rate>
<price>550</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>25</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
<price>
<objectKind>
<obkId>4</obkId>
<name>Double Queen Room</name>
</objectKind>
<rate>
<price>660</price>
<currency>
<curId>1</curId>
<code>CZK</code>
</currency>
</rate>
<rate>
<price>30</price>
<currency>
<curId>2</curId>
<code>EUR</code>
</currency>
</rate>
</price>
</season>
</package>
</packages>