The `OTA_HotelSummaryNotif` (HSN) endpoint is now under deprecation The `OTA_HotelSummaryNotif` (HSN) endpoint was deprecated in December 2024. We will fully sunset this endpoint on **December 31, 2026**. For more information on the deprecation and sunsetting timeline, see [OTA_HotelSummaryNotif (HSN) endpoint in Content API](/connectivity/docs/deprecation-policy/deprecation-and-sunsetting#ota_hotelsummarynotif-hsn-endpoint-in-content-api). We strongly encourage you to implement the [Property API `status` endpoint](/connectivity/docs/property-api/status-endpoint/status-introduction#property-apis-status-endpoint) at your earliest convenience. # /ota/OTA_HotelSummaryNotif ```http POST https://supply-xml.booking.com/hotels/ota/OTA_HotelSummaryNotif ``` The `ota/OTA_HotelSummaryNotif` endpoint enables you to: * [Verify whether a property fulfills the necessary requirements to be open and bookable.](/connectivity/docs/preparing-a-property-to-be-open-bookable/#verifying-opening-and-closing-a-property) * [Retrieve actionable items to fulfill all requirements in form of erros and warnings.](/connectivity/docs/preparing-a-property-to-be-open-bookable/#verifying-opening-and-closing-a-property) * [Open a property.](/connectivity/docs/preparing-a-property-to-be-open-bookable/#verifying-opening-and-closing-a-property) * [Close a property.](/connectivity/docs/preparing-a-property-to-be-open-bookable/#verifying-opening-and-closing-a-property) ## Header parameters | Header | Description | Type | Required | Notes | | --- | --- | --- | --- | --- | | `Authorization` | [Machine account username and password](/connectivity/docs/authentication) | string | Required | Example: `Authorization: Basic {username:password}` | ## Sample response with errors Error messages occur when a property's content is incorrect or incomplete. You cannot open a property as long as errors are returned. ```xml Warning on check total_num_rooms: Hotel Info: Number of active rooms: 0 Failed check general_contact: No general contact is specified in the correct format Failed check reservations_contact: No reservations contact specified Failed check central_reservations_contact: No central_reservations contact specified ``` ## HotelSummaryNotif error guidelines Before your property can become "Open / bookable" on Booking.com, it needs to pass some validations. For more information, see [Check a property's content](/connectivity/docs/preparing-a-property-to-be-open-bookable). This page contains list of errors with `Error Message` they produce on [OTA_HotelSummaryNotif Endpoint](/connectivity/docs/ota-hotelsummarynotif), their descriptions and possible resolution steps. Please note the Message Type for each message. - Type "Error" means this is a blocker and you can't proceed with going to "Open" status. - Type "Warning" means something is uncertain, but you can still proceed. ### List of property-level errors | Caused by Object | Error Message | Message Type | Description | Resolution | Notes | | --- | --- | --- | --- | --- | --- | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Phones` | The phone number *(number)* is not valid for international calling | Error | One or more of the contact phones of the property is not in international format. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with correct phone numbers. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Emails` | The email address *(email)* is invalid | Error | One or more of the contact emails of the property is not valid. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with correct emails. | - | | `OTA_HotelDescriptiveContentNotif -> HotelName` | Hotel has non-Latin characters in name | Error | Property names can only contain latin letters and numbers. | [Update the property details](/connectivity/docs/tsk-modify-property-name) with a proper name. | - | | `availability` | No availability pushed | Error | Property can not go to "Open" state without any availability pushed. | [Push availability](/connectivity/docs/b_xml-availability). | - | | `OTA_HotelDescriptiveContentNotif -> HotelInfo -> Services` | No hotel facilities defined | Error | Property does not have any facilities set. | [Update the property facilities](/connectivity/docs/tsk-modify-property-facilities). | - | | `OTA_HotelDescriptiveContentNotif -> Policies` | No general policy defined | Error | Property does not have any policies set. | [Update property policies](/connectivity/docs/tsk-modify-property-policies) to have at least one PolicyName="General". | - | | `OTA_HotelDescriptiveContentNotif -> Policies` | No policies defined | Error | Property does not have any policies set. | [Update property policies](/connectivity/docs/tsk-modify-property-policies). | - | | `OTA_HotelDescriptiveContentNotif -> Policies` | All policies are disabled, not existing policies | Error | Property has all policies disabled, or does not have any policies. | [Update property policies](/connectivity/docs/tsk-modify-property-policies), create at least one policy and activate it. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Addresses -> Phones` | Hotel has non-Latin characters in city | Error | City name of the property contains non-latin letters. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with a proper city name. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Addresses` | Hotel has non-Latin characters in address | Error | City name of the property contains non-latin letters. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with a proper address. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Addresses` | No resolvable address is specified | Error | System marks the property address as invalid. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with a properly resolvable address. | - | | `OTA_HotelRatePlanNotifRQ -> RatePlans` | No rates defined | Error | Property does not have any rates. | [Update rate plans](/connectivity/docs/room-type-and-rate-plan-management/managing-rate-plans/#what-falls-under-managing-rate-plans) and create at least one rate plan. | - | | `OTA_HotelProductNotifRQ -> HotelProducts` | No products defined | Error | Property does not have any products. | Create a product for the property. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos` | No contacts specified | Error | Property does not have any contacts. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with at least one contact. | - | | `OTA_HotelProductNotifRQ -> HotelProducts` | Hotel has a mix of domestic *(number)* and non-domestic *(number)* products | Error / Warning | Property has both domestic and non-domestic products. | Update property products to make sure you only have products of one category. | This can be either an error or a warning, depending on the type of accommodation. | | `OTA_HotelDescriptiveContentNotif -> Policies` | Policy *(policy_id)* has no prepayment required | Error | Specified policy does not have a prepayment defined. | [Update property policies](/connectivity/docs/tsk-modify-property-policies) and define a prepayment for specified *(policy_id)*. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos` | No general contact is specified in the correct format | Error | Property does not have a correct general contact specified. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with proper general contact. | - | | `OTA_HotelDescriptiveContentNotif -> ContactInfos -> Addresses` | Postal code not correct | Error | Property postal code is invalid. | [Update the property details](/connectivity/docs/tsk-modify-property-contact-info) with a valid postal code. | - | | `OTA_HotelDescriptiveContentNotif -> HotelInfo -> CategoryCodes -> HotelCategory` | Hotel type not set | Error | Property does not have a proper accommodation type. | Update the property details with a suitable accommodation type. | - | | `OTA_HotelDescriptiveContentNotif -> Policies` | Invalid checkin/checkout | Error / Warning | Property check-in/check-out times are invalid. | [Update property policies](/connectivity/docs/tsk-modify-property-policies) with proper check-in/check-out times. | This can be either an error or a warning, depending on the accommodation type. | | `OTA_HotelDescriptiveContentNotif -> HotelInfo -> OwnershipManagementInfos` | No company name for invoicing found | Warning | Property does not have a valid company name set for invoicing. | Update the property details with proper invoice details. | - | | `OTA_HotelDescriptiveContentNotif -> HotelInfo -> CategoryCodes -> GuestRoomInfo -> Quantity` | The number of rooms are not specified | Error | Property does not have any rooms. | Specify the quantity of room in [GuestRoomInfo](/connectivity/docs/api-reference/guestroominfo) object. | - | ### List of room-level errors | Object | Message | Message Type | Description | Resolution | Notes | | --- | --- | --- | --- | --- | --- | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | No rooms active | Error | Property does not have any active rooms. | [Activate a room](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types/#activating-a-room-type). | - | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | *(number)* duplicates for room name *(room_name)* *(room_ids_list)* | Error | Duplicated rooms were found for this property. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) - delete or rename rooms with duplicated names. | - | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Undefined room type *(room_id)* | Error | Room with specified room_id does not have a type defined. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with proper type. | - | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Unhandled room type *(room_type_id)* for room *(room_id)* | Error | The room type ID for specified room_id is invalid. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with proper type. | - | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room *(room_id)* does not have a kitchen or a kitchenette. | Warning / Error | Specified room is missing a kitchen or kitchenette. | [Update room details](/connectivity/docs/tsk-modify-room-amenities) with kitchen or kitchenette. | This can be either an error or a warning, depending on the type of accommodation and the status of the room (active room = error, inactive room = warning). | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room name for room *(room_id)* *(room_name)* does not correspond to RoomType *(room_type_name)* | Warning / Error | Room name does not correspond to Room Type. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with the proper room name. | This can be either an error or a warning, depending on the status of the room (active room = error, inactive room = warning). | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room type for room *(room_id)* *(room_name)* does not correspond to expected RoomType *(room_type_name)* | Warning / Error | Room type mismatch. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with the proper room type. | This can be either an error or a warning, depending on the status of the room (active room = error, inactive room = warning). | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room occupancy *(number)* for room *(room_id)* *(room_name)* does not correspond to RoomType *(room_type)* | Warning / Error | Invalid occupancy for this room type. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with the proper occupancy. | This can be either an error or a warning, depending on the status of the room (active room = error, inactive room = warning). | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room *(room_id)* has no occupancy defined | Warning / Error | No defined occupancy for this room type. | [Update room details](/connectivity/docs/room-type-and-rate-plan-management/managing-room-types) with the proper occupancy. | This can be either an error or a warning, depending on the status of the room (active room = error, inactive room = warning). | | `OTA_HotelInvNotif -> SellableProducts -> GuestRoom` | Room *(room_id)* has no facilities defined | Warning / Error | No defined facilities for specified room_id. | [Update room details](/connectivity/docs/tsk-modify-room-amenities) to add room amenities. | This can be either an error or a warning, depending on the status of the room (active room = error, inactive room = warning). |