Changes for page 2. Hotel Prices

Last modified by Giorgi Mdivnishvili on 2024/02/27 12:01

From version 3.1
edited by Giorgi Mdivnishvili
on 2024/02/26 15:11
Change comment: There is no comment for this version
To version 8.1
edited by Giorgi Mdivnishvili
on 2024/02/27 11:55
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,17 +1,32 @@
1 -**https:~/~/restapi.rustaronline.com/v1.01/api/hotelprices**
1 += Method Description =
2 2  
3 -Method: GET
3 +>The method returns the object with three list of prices for specified hotel. ContractPrices, Promotions, PromotionsWithConditionsNote: Parameter removedublicates is optional, used for removing duplicate seasons from the list and split prices by seasons. False is default value of this parameter.
4 4  
5 +
6 +
7 +== Endpoint URL - [Method - GET] ==
8 +
9 +(% class="box infomessage" %)
10 +(((
11 +[[https:~~/~~/restapi.rustaronline.com/v1.01/api/hotelprices>>https://restapi.rustaronline.com/v1.01/api/hotelprices]]
12 +)))
13 +
5 5  Parameters to pass: agentid, agentpassword, hotelid
6 6  
7 7  Sample URL:
8 8  
9 -**https:~/~/restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false**
10 10  
19 +== Request Parameters ==
11 11  
12 -The method returns the object with three list of prices for specified hotel. ContractPrices, Promotions, PromotionsWithConditions
21 +(% class="box infomessage" %)
22 +(((
23 +|**Key**|**Value**|**Request URL**
24 +|agentid|test.test|**[[https:~~/~~/restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false>>https://restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false]]**
25 +|agentpassword|[[TestP@ssw0rd>>mailto:TestP@ssw0rd]]|**[[https:~~/~~/restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false>>https://restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false]]**
26 +|hotelid|d6f9299f-5d94-4955-85e7-003e0383023c|**[[https:~~/~~/restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false>>https://restapi.rustaronline.com/v1.01/api/hotelprices?agentid=test.test&agentpassword=TestP@ssw0rd&hotelid=d6f9299f-5d94-4955-85e7-003e0383023c&removedublicates=false]]**
27 +|removedublicates|false|
28 +)))
13 13  
14 -Note: Parameter removedublicates is optional, used for removing duplicate seasons from the list and split prices by seasons. False is default value of this parameter.
15 15  
16 16  Return value example:
17 17  
... ... @@ -231,83 +231,46 @@
231 231  {{/code}}
232 232  
233 233  
249 +(% class="info" %)|**Value**|(((
250 +**Description**
251 +)))
252 +|**priceid**|GUID of the unique price id in the database of Rustar. This field together with placement creates unique combination of price for room/promotion/mealplan
253 +|**hotelid**|GUID of the hotel in the database of Rustar.
254 +|**roomcategory**|GUID of the Room category
255 +|**roomcategorytype**|GUID of the Room category type. Unique by description of the room
256 +|**roomcategoryname**|string. The name of the room category
257 +|**startdate**|Date. Start date of the price period
258 +|**enddate**|Date. End date of the price period
259 +|**mealplan**|CHAR(2). “RO”,"BB",”HB”,”FB”,”AL”
260 +|**adults**|Integer. Number of Aduts with beds
261 +|**teens**|Integer. Number of children (Teenagers) without extra bed
262 +|**children**|Integer. Number of children between infant and teen ages without extra bed
263 +|**infants**|Integer. Number of infants
264 +|**teenswithextrabeds**|Integer. Number of children (Teenagers) with extra bed
265 +|**childrenwithextrabeds**|Integer. Number of children between infant and teen ages with extra bed
266 +|**childpolicy**| {
267 +|**infantmaxage**|Decimal. Max age of the infant by the policy of the hotel
268 +|**childmaxage**|Decimal. Max age of the child by the policy of the hotel
269 +|**teenmaxage**|Decimal. Max age of the teenager by the policy of the hotel
270 +|**}**|
271 +|**placement**|string. Accomodation of all guests in following format e.g.
272 +|**SGL+1CHDEB(3-13,99)+1CHD(0-2,99)**|
273 +|**price**|Decimal. Price for the accommodation/placement
274 +|**currency**|CHAR(3). Currency of the price above
275 +|**promotioncode**|string. Optional. Promotion code if any of the specified price
276 +|**promotion**| {                  Promotion terms if any
277 +|**staydays**| Integer. Number of days to stay for stay/pay promotion (n nights free)
278 +|**paydays**| Integer. Number of days that will be charged in case of “staydays” stay
279 +|**discount**| Decimal. Discount % that was applied for this promotion
280 +|**cashback**| Decimal. Cashback in specified currency that was applied for this promotion
281 +|**}**|
282 +|**conditions"**| {                Optional conditions for using this price
283 +|**bookingstartdate**| Date. When it is allowed to start the reservation for this promotion/accomodation
284 +|**bookingenddate**| Date. Date, after when the sale of this promotion should be stopped.
285 +|**bookbefore**| Integer. Number of days before checkin to use this promotion (Early Bird)
286 +|**minimumstay**| Integer. Minimal stay of nights to use this promotion
287 +|**maximumstay**| Integer. Maximal stay of nights to use this promotion
288 +|**}**|
289 +|**isactive**| Boolean. True if the price is active and can be used. False if the price is deactivated/inactive.
234 234  
235 -**priceid:**                          GUID of the unique price id in the database of Rustar. This field together with placement creates unique combination of price for room/promotion/mealplan
236 -
237 -**hotelid:**                          GUID of the hotel in the database of Rustar.
238 -
239 -**roomcategory:               **GUID of the Room category
240 -
241 -**roomcategorytype:         **GUID of the Room category type. Unique by description of the room
242 -
243 -**roomcategoryname:       **string. The name of the room category
244 -
245 -**startdate:                       **Date. Start date of the price period
246 -
247 -**enddate:                        **Date. End date of the price period
248 -
249 -**mealplan:                       **CHAR(2). “RO”,"BB",”HB”,”FB”,”AL”
250 -
251 -**adults:                           **Integer. Number of Aduts with beds
252 -
253 -**teens:                            **Integer. Number of children (Teenagers) **without** extra bed
254 -
255 -**children:                        **Integer. Number of children between infant and teen ages **without** extra bed
256 -
257 -**infants:                          **Integer. Number of infants
258 -
259 -**teenswithextrabeds:      **Integer. Number of children (Teenagers) **with** extra bed
260 -
261 -**childrenwithextrabeds: **Integer. Number of children between infant and teen ages **with** extra bed
262 -
263 -**childpolicy: {**
264 -
265 -**infantmaxage:                **Decimal. Max age of the infant by the policy of the hotel
266 -
267 -**childmaxage:                 **Decimal. Max age of the child by the policy of the hotel
268 -
269 -**teenmaxage:                  **Decimal. Max age of the teenager by the policy of the hotel
270 -
271 -**}**
272 -
273 -**placement:                     **string. Accomodation of all guests in following format e.g.
274 -
275 -**"SGL+1CHDEB(3-13,99)+1CHD(0-2,99)"**
276 -
277 -**price:                             **Decimal. Price for the accommodation/placement
278 -
279 -**currency:                       **CHAR(3). Currency of the price above
280 -
281 -**promotioncode:              **string. Optional. Promotion code if any of the specified price
282 -
283 -**promotion: {                  **Promotion terms if any
284 -
285 -**staydays:                       **Integer. Number of days to stay for stay/pay promotion (n nights free)
286 -
287 -**paydays:                        **Integer. Number of days that will be charged in case of “staydays” stay
288 -
289 -**discount:                       **Decimal. Discount % that was applied for this promotion
290 -
291 -**cashback:                      **Decimal. Cashback in specified currency that was applied for this promotion
292 -
293 -**}**
294 -
295 -
296 -**conditions": {                **Optional conditions for using this price
297 -
298 -**bookingstartdate:          **Date. When it is allowed to start the reservation for this promotion/accomodation
299 -
300 -**bookingenddate:            **Date. Date, after when the sale of this promotion should be stopped.
301 -
302 -**bookbefore:                   **Integer. Number of days before checkin to use this promotion (Early Bird)
303 -
304 -**minimumstay:                **Integer. Minimal stay of nights to use this promotion
305 -
306 -**maximumstay:               **Integer. Maximal stay of nights to use this promotion
307 -
308 -**}**
309 -
310 -**isactive:                         **Boolean. True if the price is active and can be used. False if the price is deactivated/inactive.
311 -
312 -
313 313  Please be noted, that the prices are already calculated with all possible discounts.