• Documentation

Block Room

BlockRoom method is used to get the updated prices and cancellation policies for the selected rooms before proceeding with the hotel booking. Block Room will also get the norms, if any.

1.This method should preferably be called before taking guest details from the client, so that in case of any price change a proper intimation can be provided.


2.In case of Price change or Cancellation Policy change, you will get new price and/or new cancellation policy in the BlockRoom response with IsPriceChanged node and/or IsCancellationPolicyChanged node set as ‘true’


3. The price comparison is to be made at the client’s end, and BlockRoom request needs to be sent again with the updated price and/ or updated cancellation policy.

Service URL (REST) to be used:
https://hotel.srdvtest.com/v8/rest/BlockRoom
Block Room Request
Level Element Format Comments Mandatory
1 ResultIndex Integer ResultIndex (Index of the hotel for which details are to be fetched) Mandatory
2 HotelCode String Unique hotel code Mandatory
3 HotelName String Unique hotel name Mandatory
4 GuestNationality String ISO Country Code (Ex. India = IN, Great Britain = GB) Mandatory
5 NoOfRooms Integer Requested number of rooms Mandatory
6 ClientReferenceNo String Client Reference No< (Currently not in use, passs as 0) Optional
7 IsVoucherBooking Boolean This represents whether the request is to Hold the booking or to voucher it directly (Set true if you want to voucher the booking. Set false, if you want to hold the booking and voucher it later) Mandatory
8 HotelRoomsDetails[] Array Array of hotel room details Mandatory
8.1 ChildCount Integer Child Count Mandatory
8.2 RequireAllPaxDetails Boolean Represents if passenger detail is required all guests or only for lead guest. If true, then details would be required for all guests Mandatory
8.3 RoomId Integer Room Id Mandatory
8.4 RoomStatus String Room Status Mandatory
8.5 RoomIndex Integer Room Index Mandatory
8.6 RoomTypeCode Integer Room Type Code Mandatory
8.7 RoomTypeName String Room Type Name Mandatory
8.8 RatePlan String Rate Plan Mandatory
8.9 RatePlanCode String Rate Plan Code associated with room Mandatory
8.10 InfoSource String Info Source Mandatory
8.11 SequenceNo String Sequence No Optional
8.12 DayRates[] Array Day Rate Mandatory
8.12.1 Amount Decimal Amount Mandatory
8.12.2 Date DATE TIME Date Mandatory
8.13 SupplierPrice Decimal Supplier Price Mandatory
8.14 Price[] Array Price detail of the room Mandatory
8.14.1 CurrencyCode String Currency in which minimum hotel price is returned Mandatory
8.14.2 RoomPrice Decimal Price of the room Mandatory
8.14.3 Tax Decimal Tax applicable for the room Mandatory
8.14.4 ExtraGuestCharge Decimal Extra Guest Charges applicable for the room Mandatory
8.14.5 ChildCharge Decimal Child Charges applicable for the room Mandatory
8.14.6 OtherCharges Decimal Other Charges applicable for the room Mandatory
8.14.7 Discount Decimal Discount applicable for the room Mandatory
8.14.8 PublishedPrice Decimal Published Price of the room (This price would be different only if Room Price is on PUBLISHED. In case of NET, Published Price would be same as Offered Price) Mandatory
8.14.9 PublishedPriceRoundedOff Integer Published Price (rounded off) of the room (This price is for display purpose only) Mandatory
8.14.10 OfferedPrice Decimal Offered Price of the room Mandatory
8.14.11 OfferedPriceRoundedOff Integer Offered Price (rounded off) of the room Mandatory
8.14.12 AgentCommission Decimal Commission applicable on the Room Price (srdv will part this amount if Room Price is on Published) Mandatory
8.14.13 AgentMarkUp Decimal Agent Mark Up applicable on the Room Price(Agent will earn this amount if Hotel mark up is set from backend) Mandatory
8.14.14 ServiceTax Decimal Service tax applicable for the room Mandatory
8.14.15 TDS Decimal TDS applicable on Commission Earned
(This would be deducted only when commission is parted to the agent)		 Mandatory
8.14.16 ServiceCharge Decimal Service Charge Mandatory
8.14.17 TotalGSTAmount Decimal Total GST Amount Mandatory
8.14.18 GST[] Array Array of GST Mandatory
8.14.18.1 CGSTAmount Decimal CGST Amount Mandatory
8.14.18.2 CGSTRate Decimal CGST Rate Mandatory
8.14.18.3 CessAmount Decimal Cess Amount Mandatory
8.14.18.4 CessRate Decimal Cess Rate Mandatory
8.14.18.5 IGSTAmount Decimal IGST Amount Mandatory
8.14.18.6 IGSTRate Decimal IGST Rate Mandatory
8.14.18.7 SGSTAmount Decimal SGST Amount Mandatory
8.14.18.8 SGSTRate Decimal SGST Rate Mandatory
8.14.18.9 TaxableAmount Decimal TaxableAmount Mandatory
8.15 RoomPromotion Array RoomPromotion Mandatory
8.16 Amenities[] Array Amenities Mandatory
8.16.1 Name String Name Mandatory
8.16.2 FontAwesome String || null FontAwesome Mandatory
8.16.3 IcoFont String IcoFont Mandatory
8.17 SmokingPreference String SmokingPreference Mandatory
8.18 BedTypes String BedTypes Mandatory
8.19 HotelSupplements String HotelSupplements Mandatory
8.20 LastCancellationDate Boolean LastCancellationDate Mandatory
8.21 CancellationPolicies[] Array CancellationPolicies Mandatory
8.21.1 Charge Array Charge Mandatory
8.21.2 ChargeType String Name Mandatory
8.21.3 Currency String Currency Mandatory
8.21.4 FromDate String FromDate Mandatory
8.21.5 ToDate Enumeration ToDate Mandatory
8.22 BedTypeCode String Array of bed types Mandatory
8.23 Supplements String Supplements Mandatory
9 SrdvType String Simple result data version Type Mandatory
10 SrdvIndex String Simple result data Mandatory
11 TraceId String Trace ID Mandatory
12 EndUserIp String IP Address of the end user Mandatory
13 ClientId String Client ID provided to the agency at the time of registration Mandatory
14 UserName String Username provided to the agency at the time of registration Mandatory
15 Password String Password provided to the agency at the time of registration Mandatory
Block Room Response
Level Element Format Comments Mandatory
1 BlockRoomResult Object BlockRoomResult Mandatory
1.1 Error[] Array Error Mandatory
1.1.1 ErrorCode String Error Code Mandatory
1.1.2 ErrorMessage String Error Message Mandatory
1.2 AvailabilityType String Availability Type If the value is available, we may book, it means that.
(Possible Values can be 'Available' or 'Confirm'. If 'available', the user may either choose not to book the property and go for an alternate property or book the inventory but get it reconfirmed from agent/ srdv Backoffice as there is a possibility of the property being sold out. If 'confirm', the user may proceed to book the property without requiring to reconfirm from agent/ SRDV BACK OFFICE Backoffice.) 		Mandatory
1.3 TraceId String Trace ID Mandatory
1.4 ResponseStatus Enumeration Response Status
(NotSet = 0, Successfull = 1, Failed = 2, InValidRequest = 3, InValidSession = 4, InValidCredenti als = 5)		 Mandatory
1.5 GSTAllowed Boolean GSTAllowed Mandatory
1.6 IsPackageDetailsMandatory Boolean IsPackageDetailsMandatory Mandatory
1.7 IsPackageFare Boolean IsPackageFare Mandatory
1.8 IsPriceChanged Boolean Represent if price is changed or not
(Would be set true, if there is a price change. Would be set as false, if no price change)		 Mandatory
1.9 IsCancellationPolicyChanged Boolean Represent if cancellation policy is changed or not(Would be set true, if there is a change in cancellation policy. Would be set as false, if no change in cancellation policy) Mandatory
1.10 IsHotelPolicyChanged Boolean Represent if hotel policy is changed or not Mandatory
1.11 HotelNorms String Hotel Norms Optional
1.12 HotelName String Unique hotel Name Mandatory
1.13 AddressLine1 String Address Line 1 Optional
1.14 AddressLine2 String Address Line 2 Optional
1.15 City String City Mandatory
1.16 State String State Mandatory
1.17 Pincode String Pincode Mandatory
1.18 CountryName String CountryName Mandatory
1.19 HotelContactNo String HotelContactNo Mandatory
1.20 StarRating String StarRating Mandatory
1.21 HotelPolicyDetail String Hotel Policy Detail Optional
1.22 Latitude String Latitude Optional
1.23 Longitude String Longitude Optional
1.24 BookingAllowedForRoamer Boolean Booking Allowed For Roamer Optional
1.25 HotelRoomsDetails[] Array Array of hotel room details Mandatory
1.25.1 ChildCount Integer Child Count Mandatory
1.25.2 RequireAllPaxDetails Boolean Represents if passenger detail is required all guests or only for lead guest. If true, then details would be required for all guests Mandatory
1.25.3 RoomId Integer Room Id Mandatory
1.25.4 RoomStatus String Room Status Mandatory
1.25.5 RoomIndex Integer Index of the room (referenced in OptionsForBooking) Mandatory
1.25.6 RoomTypeCode SInteger Room Type Code Mandatory
1.25.7 RoomTypeName String Room Type Name Mandatory
1.25.8 RatePlanCode String Rate Plan Code associated with room Mandatory
1.25.9 RatePlan String Rate Plan Mandatory
1.25.10 InfoSource String Info Source Mandatory
1.25.11 SequenceNo String Sequence Number of the Room Optional
1.25.12 DayRates[] Array Per day rate breakup of the room Mandatory
1.25.12.1 Date Date Date for which day rate is applicable Mandatory
1.25.12.2 Amount Decimal Per day price of the room Mandatory
1.25.13 SupplierPrice Decimal Supplier Price Mandatory
1.25.14 Price[] Array Price detail of the room Mandatory
1.25.14.1 CurrencyCode String Currency in which minimum hotel price is returned Mandatory
1.25.14.2 RoomPrice Decimal Price of the room Mandatory
1.25.14.3 Tax Decimal Tax applicable for the room Mandatory
1.25.14.4 ExtraGuestCharge Decimal Extra Guest Charges applicable for the room Mandatory
1.25.14.5 ChildCharge Decimal Child Charges applicable for the room Mandatory
1.25.14.6 OtherCharges Decimal Other Charges applicable for the room Mandatory
1.25.14.7 Discount Decimal Discount applicable for the room Mandatory
1.25.14.8 PublishedPrice Decimal Published Price of the room(This price would be different only if Room Price is on PUBLISHED. In caseof NET, Published Price would be same as Offered Price) Mandatory
1.25.14.9 PublishedPriceRoundedOff Integer Published Price (rounded off) of the room (This price is for display purpose only) Mandatory>
1.25.14.10 OfferedPrice Decimal Offered Price of the room Mandatory
1.25.14.11 OfferedPriceRoundedOff Integer Offered Price (rounded off) of the room Mandatory
1.25.14.12 AgentCommission Decimal Commission applicable on the Room Price (srdv will part this amount if Room Price is on Published) Mandatory
1.25.14.13 AgentMarkUp Decimal Agent Mark Up applicable on the Room Price (Agent will earn this amount if Hotel mark up is set from backend) Mandatory
1.25.14.14 ServiceTax Decimal TDS applicable on Commission Earned (This would be deducted only when commission is parted to the agent) Mandatory
1.25.14.15 TDS Decimal TDS applicable on Commission Earned(This would be deducted only when commission is parted to the agent) Mandatory
1.25.14.16 ServiceCharge Decimal Service Charge Mandatory
1.25.14.17 TotalGSTAmount Decimal Total GST Amount Mandatory
1.25.14.18 GST[] Array Array of GST Mandatory
1.25.14.18.1 CGSTAmount Decimal CGST Amount Mandatory
1.25.14.18.2 CGSTRate Decimal CGST Rate Mandatory
1.25.14.18.3 CessAmount Decimal Cess Amount Mandatory
1.25.14.18.4 CessRate Decimal Cess Rate Mandatory
1.25.14.18.5 IGSTAmount Decimal IGST Amount Mandatory
1.25.14.18.6 IGSTRate Decimal IGST Rate Mandatory
1.25.14.18.7 SGSTAmount Decimal SGST Amount Mandatory
1.25.14.18.8 SGSTRate Decimal SGST Rate Mandatory
1.25.14.18.9 TaxableAmount Decimal TaxableAmount Mandatory
1.25.15 RoomPromotion String Room Promotion applicable for the room Optional
1.25.16 Amenities[] Array List of room amenities Optional
1.25.16.1 Name Array Name Optional
1.25.16.2 FontAwesome Array AmenFontAwesomeity Optional
1.25.16.3 IcoFont Array IcoFont Optional
1.25.17 SmokingPreference Enumeration Smoking PreferenceSmokingPrefere nce NoPreference = 0, Smoking = 1, NonSmoking = 2, Either = 3 Mandatory
1.25.18 BedTypes Array Array of bed types Optional
1.25.19 HotelSupplements Array Hotel Supplements Optional
1.25.20 LastCancellationDate Date Last Cancellation Date
(No cancellation charge will be applied up to this date. If the date is less than book date then cancellation charge will be applicable as per policy)		 Mandatory
1.25.21 IsPassportMandatory Array IsPassportMandatory Mandatory
1.25.22 IsPANMandatory Array IsPANMandatory Mandatory
1.25.23 FullRefundAllowed Array FullRefundAllowed Mandatory
1.25.24 CancellationPolicies[] Array Array of cancellation policies Mandatory
1.25.24.1 Charge Decimal Cancellation charge (Contains amount in case of Amount, Percentage value in case of Percentage, No of nights in case of Night) Mandatory
1.25.24.2 ChargeType Enumeration Cancellation charge type- CancellationPolicies - ChargeType Amount = 1, Percentage = 2, Nights = 3 Mandatory
1.25.24.3 Currency String Currency Mandatory
1.25.24.4 FromDate Date Date from which charges will apply
Format:(dd/mm/yyyy)		 Mandatory
1.25.24.5 ToDate Date Date up to which charges will apply
Format:(dd/mm/yyyy)		 Mandatory
1.25.25 CancellationPolicy String Cancellation policy in text format
(Format: Text)		 Mandatory
1.25.26 Inclusion[] Array Inclusion Optional