Get More Rooms

Note:
Few attributes in below sample response are supplier specific, hence there can be possibility these attributes will not appear in the response. We recommend you to parse these fields as mentioned in the sample responses.

/api/v1/hotel/more-rooms

This service method is used to request all available rooms information for the hotel(All rooms options available in the hotel) based on sessionId, searchKey and hotelKey.
These rooms can be selected for booking based on specified room selection rules.
In case of multiple room bookings, room selection rules will help in selecting the correct room option(s).
There are cases where you can’t freely select any room option from multiple room booking and for that room selection rules must be followed else booking may fail.

Note - Room details (attributes - bedType, roomView, maxOccupancy, sizeMeasurement) provided in this service will be provided if it is available.

Hotel More Room Request

Tags	Attribute	Description
HotelMoreRoomCriteria	(JsonObject)
	hotelKey* (String)	Unique Key for each Hotel. This should be taken from Hotel search response
	searchKey* (String)	Unique Key for the search
	culture* (String)	en

hotel more room request
{
    "hotelKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae5640HTR00000000",
    "searchKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae56",
    "culture": "en"
}

Hotel More Room Response

Tags	Attribute	Description
meta	meta (Object)
	success (String)	Response status will be return Ex: "true"
	statusCode (Boolean)	Response statusCode will be return Ex: "1"
	statusMessage (String)	Response statusMessage will be return Ex: "SUCCESS"
	actionType (String)	This attribute will indicate that client request type such as Hotel search , Prov book and Book etc... . This is for information purpose.
	conversationId (String)	conversationId a unique identifier of current conversation .
commonData	searchKey* (String)	This attribute contains a unique search key.
commonData	productCode* (String)	Product code for hotels - H
commonData	culture* (String)	en
data	hotels(JsonArray)	This encloses hotel information.
data	hotelKey* (String)	This attribute contains a unique hotel id.
	roomSelectionRules (JsonArray)	This tag encloses the multiple rules for room selection. ["rule1",”==”]

rooms	(JsonArray)*	This encloses room information
room	(JsonObject)
room	roomKey* (String)	This attribute contains the room's unique id.
room	roomIndex* (String)	represents the room number
room	roomId* (String)	This attribute contains the room id. 38_1
room	ruleInfo (String)	This attribute contains data for room rules. 38
room	roomTypeName * (String)	Room type Eg: Deluxe Room
room	standardizedRoomName (String)	Standard room name provided by hotel content solution provider (CSP). This tag will only come if any Hotel CSP enabled.
room	roomTypeDesc * (String)	Room type description
room	bedType (String)	bed type provided in the room Eg: Double
room	roomView (String)	room view description Eg: mountain view
room	maxOccupancy (Integer)	Max occupancy of a room.
room	sizeMeasurement (String)	size of the room.
room	rateNotes (String)	Eg: please Note That Three Bedroom Residence is Located In The Residence Building (This information is very important)

passengerData	(JsonObject)
passengerData	isEmailId (Boolean)	If the value of the attribute is true then send email id details in the booking request
passengerData	isPAN (Boolean)	If the value of the attribute is true then send pan details in the booking request.
passengerData	isPassport (Boolean)	If the value of the attribute is true then send passport details in the booking request.
passengerData	isPhoneNo (Boolean)	If the value of the attribute is true then send phone number details in the booking request.

roomImages	(JsonObject)
images	(JsonArray)
image	(JsonObject)
image	order (Integer)	Image order number
image	type (String)	Image type
image	description (String)	Image description
image	path (String)	image file URL.

roomFacilities	(JsonArray)	List of room facilities
roomFacility	(JsonObject)
roomFacility	type (String)	Room facility type Eg:services
roomFacility	name (String)	Room facility name
roomFacility	description (String)	Room facility description

ratePlan	(JsonObject) *
ratePlan	supplierCode * (String)
ratePlan	meal * (String)	Meal plan
ratePlan	standardizedMeal (String)	Standard meal plan provided by hotel content solution provider (CSP). This tag will only come if any Hotel CSP enabled.
ratePlan	availableStatus * (String)	availability status of the room
ratePlan	cancelPolicyIndicator (String)	The cancel policy indicators Eg: refundable
ratePlan	code * (String)	This attribute contains the room contract details
ratePlan	isPackage (String)	Shows if the room rate is a package.
ratePlan	fixedCombo * (Boolean)	Shows room selection is combined or flexible.
ratePlan	combinePolicy * (Boolean)	Shows if cancellation policy is combined or roomwise.
ratePlan	inclusions (String)	Room inclusion details Eg: ["Free Wifi", "Free pool"]
ratePlan	rateType (String)	Contains rate type Eg: Retail/Corporate
ratePlan	gstAssured (Boolean)	This indicated that available room hotel is GST assured and you can make request for GST invoices
ratePlan	lastCancellationDate (Date)	Indicates last cancellation date

roomRate	(JsonObject) *
roomRate	currency* (String)	Contains selling currency room price
roomRate	netAmount* (Double)	Selling price of a room.
supplierAdditionalFareInfo	(JsonObject)	Not released yet
supplierAdditionalFareInfo	currency (String)	Not released yet
supplierAdditionalFareInfo	discount (Double)	Not released yet
supplierAdditionalFareInfo	publishedFare (Double)	Not released yet
supplierAdditionalFareInfo	commissionEarned (Double)	Not released yet
supplierAdditionalFareInfo	offeredFare (Double)	Not released yet
supplierAdditionalFareInfo	tdsOnCommission (Double)	Not released yet
supplierAdditionalFareInfo	serviceFee (Double)	Not released yet

customerAdditionalFareInfo	(JsonObject)	Not released yet
customerAdditionalFareInfo	transactionFeeEarned (Double)	Not released yet
customerAdditionalFareInfo	tdsOnCommission (Double)	Not released yet
customerAdditionalFareInfo	commissionEarned (Double)	Not released yet
customerAdditionalFareInfo	markupEarned (Double)	Not released yet
customerAdditionalFareInfo	discount (Double)	Not released yet
customerAdditionalFareInfo	vat (Double)	Not released yet
customerAdditionalFareInfo	cgst (Double)	Not released yet
customerAdditionalFareInfo	sgst (Double)	Not released yet
customerAdditionalFareInfo	igst (Double)	Not released yet

taxes	(JsonArray)
tax	(JsonObject)
tax	name (String)	Tax name
tax	amount (Double)	Tax amount
tax	included (Boolean)	Shows if the tax is included in the room rate or not.

rates	(JsonArray) *
rate	(JsonObject)
rate	name * (String)	Name of the rate Eg: daily rates
rate	amount * (String)	Rate amount
rate	from* (Date)	Start date of room rate.
rate	to * (Date)	End date of room rate.
rate	rateIndex * (String)	Rate number

offers	(JsonArray)
offer	(JsonObject)
offer	code (String)	Offer Code
offer	name (String)	Offer name
offer	from (Date)	Start date from that date offer will apply
offer	to (Date)	End date where the offer will expire
offer	amount (Double)	Offer amount
offer	included (Boolean)	indicate that the offer is applied or not

supplements	(JsonArray)
supplement	(JsonObject)
supplement	supplementKey (String)	Supplement key
supplement	type (String)	Supplement Type
supplement	name (String)	Supplement name
supplement	from (Date)	Start date from that date supplement will apply
supplement	to (Date)	End date that the supplement will expire
supplement	amount (Double)	supplement charges
supplement	included (Boolean)	indicate that the supplement is applied or not to given room
supplement	currency (String)	supplement charges currency

financialInfo	(JsonObject)
financialInfo	tmc (String)	This tag contains supplier owner name. tmc - Travel Management Company. Eg: VE
financialInfo	supplier (String)	Name of the supplier
payment	(JsonObject)
payment	paymentTypes (String)	Payment types Eg: CARD,CR
payment	paymentNetwork (String)	Payment Network Codes Not released yet

roomCombinations	(JsonArray)	Room combination 2 dimensional array Eg: [[38_1,38_2],[48_1,48_2]]

Note: Hotel More Room Response is same as hotel search response

hotel more room response
 {
  "meta": {
    "success": true,
    "statusCode": "",
    "statusMessage": "",
    "additionalProperties": [
      {
        "key": "timeStamp",
        "value": "YYYY-MM-DD HH:MM:SST",
        "description": "description"
      },
      {
        "key": "serverKey",
        "value": "Server01",
        "description": "description"
      }
    ],
    "actionType": "",
    "conversationId": "fe22cb8d-67e9-4c29-92af-e44dffdcb9a9"
  },
  "warnings": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Check In Time' can't be blank",
      "value": "Check In Time might be changed"
    }
  ],
  "errors": [
    {
      "code": "validation_required",
      "documentationUrl": "api-doc/docs/troubleshoot/api-error-codes/index.html",
      "message": "Field 'City' can't be blank",
      "value": "Field 'City' can't be blank",
      "source": {
        "field": "City",
        "pointer": "/HotelSearchCriteria/city"
      },
      "title": "Required field",
      "type": "validation_error"
    }
  ],
  "commonData": {
    "searchKey": "260d6c37-ab74-4331-9fdc-a9d42a5b55a6",
    "culture": "en"
  },
  "data": [
    {
      "hotelKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae5640htr00000000",
      "roomSelectionRules": [
        "rule1",
        "=="
      ],
      "rooms": [
        {
          "roomKey": "fb0920a8-70b8-433a-a8e2-a8e32efeae5640htr00000001rcmb00000000",
          "roomIndex": "1",
          "roomId": "38_1",
          "ruleInfo": "38",
          "roomTypeName": "standard",
          "roomTypeDesc": "standard",
          "bedType": "double",
          "roomView": "mountainView",
          "maxOccupancy": 2,
          "sizeMeasurement": "275Sqm",
          "passengerData": {
            "isEmailId": true,
            "isPAN": true,
            "isPassport": true,
            "isPhoneNo": true
          },
          "roomImages": {
            "image": [
              {
                "order": 1,
                "type": "Room",
                "description": "Room",
                "path": "http://photos.hotelbeds.com/giata/42/428622/428622a_hb_ro_137.jpg"
              },
              {
                "order": 2,
                "type": "Room",
                "description": "Room",
                "path": "http://photos.hotelbeds.com/giata/42/428622/428622a_hb_ro_138.jpg"
              }
            ]
          },
          "roomFacilities": [
            {
                "type": "services",
                "name": "shower",
                "description": "shower"
            },
            {
                "type": "services",
                "name": "smokingPolicy",
                "description": "smokingPolicy"
            }
          ],
          "ratePlan": {
            "supplierCode": "1",
            "meal": "roomOnly",
            "availableStatus": "available",
            "cancelPolicyIndicator": "refundable",
            "code": "76-1360717",
            "isPackage": false,
            "fixedCombo": true,
            "combinePolicy": false,
            "inclusions": [
              "Free Wifi",
              "Free pool"
            ],
            "rateType": "retail",
            "gstAssured": false,
            "lastCancellationDate": "YYYY-MM-DD",
            "additionalProperties": [
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              },
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              }
            ]
          },
          "roomRate": {
            "supplierAdditionalFareInfo": {
              "currency": "AED",
              "discount": 0,
              "publishedFare": 5184,
              "commissionEarned": 74.36,
              "offeredFare": 5109.64,
              "tdsOnCommission": 3.72,
              "serviceFee": 0,
              "additionalProperties": [
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                },
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                }
              ]
            },
            "customerAdditionalFareInfo": {
              "transactionFeeEarned": 5184,
              "tdsOnCommission": 3.72,
              "commissionEarned": 74.36,
              "markupEarned": 20,
              "discount": 0,
              "vat": 0,
              "cgst": 0,
              "sgst": 0,
              "igst": 0,
              "additionalProperties": [
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                },
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                }
              ]
            },
            "taxes": [
              {
                "name": "VAT on NT & TF",
                "amount": 54.45,
                "included": true
              }
            ],
            "rates": [
              {
                "name": "daily rates",
                "amount": 1889.635,
                "from": "YYYY-MM-DD",
                "rateIndex": "1",
                "to": "YYYY-MM-DD"
              }
            ],
            "currency": "INR",
            "netAmount": 1889.635,
            "additionalProperties": [
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              },
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              }
            ]
          },
          "offers": [
            {
              "code": "9002",
              "name": "earlyBookingDiscount",
              "from": "YYYY-MM-DD",
              "to": "YYYY-MM-DD",
              "amount": 19.86,
              "included": true,
              "additionalProperties": [
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                },
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                }
              ]
            }
          ],
          "supplements": [
            {
              "supplementKey": "ABFJKHEJHBMNSDFH",
              "type": "mandatory",
              "name": "testSupplement-1",
              "from": "YYYY-MM-DD",
              "to": "YYYY-MM-DD",
              "amount": 10,
              "included": true,
              "currency": "usd",
              "additionalProperties": [
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                },
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                }
              ]
            },
            {
              "supplementKey": "ergerhrth",
              "type": "optional",
              "name": "testSupplement-1",
              "from": "YYYY-MM-DD",
              "to": "YYYY-MM-DD",
              "amount": 10,
              "included": false,
              "currency": "usd",
              "additionalProperties": [
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                },
                {
                  "key": "key1",
                  "value": "value1",
                  "description": "description"
                }
              ]
            }
          ],
          "rateNotes": "Please note that Three Bedroom Residence is located in The Residence Building.",
          "financialInfo": {
            "tmc": "VE",
            "supplier": "Hotelbed",
            "payment": {
              "paymentTypes": "CARD,CR",
              "paymentNetwork": "DS,CA,DC,VI,AX"
            },
            "additionalProperties": [
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              },
              {
                "key": "key1",
                "value": "value1",
                "description": "description"
              }
            ]
          },
          "additionalProperties": [
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            },
            {
              "key": "key1",
              "value": "value1",
              "description": "description"
            }
          ]
        }
      ],
      "roomCombinations": [
        [
          "38_1",
          "38_4"
        ],
        [
          "48_1",
          "48_4"
        ],
        [
          "58_1",
          "58_4"
        ]
      ]
    }
  ]
}