/ota/OTA_HotelSummaryNotif
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.
- Retrieve actionable items to fulfill all requirements in form of erros and warnings.
- Open a property.
- Close a property.
Header parameters
Header | Description | Type | Required | Notes |
---|---|---|---|---|
Authorization | Machine account username and password | 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.
<OTA_HotelSummaryNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelSummaryNotifRS.xsd" TimeStamp="2015-07-10T11:42:28-00:00" Target="Production" Version="3.000"> <Warnings> <Warning Code="733" ShortText="Restricted">Warning on check total_num_rooms: Hotel Info: Number of active rooms: 0 </Warning> </Warnings> <Errors> <Error Code="733" ShortText="Restricted">Failed check general_contact: No general contact is specified in the correct format</Error> <Error Code="733" ShortText="Restricted">Failed check reservations_contact: No reservations contact specified</Error> <Error Code="733" ShortText="Restricted">Failed check central_reservations_contact: No central_reservations contact specified</Error> </Errors> </OTA_HotelSummaryNotifRS> <!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->
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.
This page contains list of errors with Error Message
they produce on OTA_HotelSummaryNotif Endpoint, 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 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 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 with a proper name. | - |
availability | No availability pushed | Error | Property can not go to "Open" state without any availability pushed. | Push availability. | - |
OTA_HotelDescriptiveContentNotif -> HotelInfo -> Services | No hotel facilities defined | Error | Property does not have any facilities set. | Update the property facilities. | - |
OTA_HotelDescriptiveContentNotif -> Policies | No general policy defined | Error | Property does not have any policies set. | Update 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. | - |
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, 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 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 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 with a properly resolvable address. | - |
OTA_HotelRatePlanNotifRQ -> RatePlans | No rates defined | Error | Property does not have any rates. | Update 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 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 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 with proper general contact. | - |
OTA_HotelDescriptiveContentNotif -> ContactInfos -> Addresses | Postal code not correct | Error | Property postal code is invalid. | Update the property details 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 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 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. | - |
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 - 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 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 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 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 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 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 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 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 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). |