Last updated

/ota/OTA_HotelSummaryNotif

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelSummaryNotif

The ota/OTA_HotelSummaryNotif endpoint enables you to:

Header parameters

HeaderDescriptionTypeRequiredNotes
AuthorizationMachine account username and passwordstringRequiredExample: 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 ObjectError MessageMessage TypeDescriptionResolutionNotes
OTA_HotelDescriptiveContentNotif -> ContactInfos -> PhonesThe phone number (number) is not valid for international callingErrorOne 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 -> EmailsThe email address (email) is invalidErrorOne or more of the contact emails of the property is not valid.Update the property details with correct emails.-
OTA_HotelDescriptiveContentNotif -> HotelNameHotel has non-Latin characters in nameErrorProperty names can only contain latin letters and numbers.Update the property details with a proper name.-
availabilityNo availability pushedErrorProperty can not go to "Open" state without any availability pushed.Push availability.-
OTA_HotelDescriptiveContentNotif -> HotelInfo -> ServicesNo hotel facilities definedErrorProperty does not have any facilities set.Update the property facilities.-
OTA_HotelDescriptiveContentNotif -> PoliciesNo general policy definedErrorProperty does not have any policies set.Update property policies to have at least one PolicyName="General".-
OTA_HotelDescriptiveContentNotif -> PoliciesNo policies definedErrorProperty does not have any policies set.Update property policies.-
OTA_HotelDescriptiveContentNotif -> PoliciesAll policies are disabled, not existing policiesErrorProperty 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 -> PhonesHotel has non-Latin characters in cityErrorCity name of the property contains non-latin letters.Update the property details with a proper city name.-
OTA_HotelDescriptiveContentNotif -> ContactInfos -> AddressesHotel has non-Latin characters in addressErrorCity name of the property contains non-latin letters.Update the property details with a proper address.-
OTA_HotelDescriptiveContentNotif -> ContactInfos -> AddressesNo resolvable address is specifiedErrorSystem marks the property address as invalid.Update the property details with a properly resolvable address.-
OTA_HotelRatePlanNotifRQ -> RatePlansNo rates definedErrorProperty does not have any rates.Update rate plans and create at least one rate plan.-
OTA_HotelProductNotifRQ -> HotelProductsNo products definedErrorProperty does not have any products.Create a product for the property.-
OTA_HotelDescriptiveContentNotif -> ContactInfosNo contacts specifiedErrorProperty does not have any contacts.Update the property details with at least one contact.-
OTA_HotelProductNotifRQ -> HotelProductsHotel has a mix of domestic (number) and non-domestic (number) productsError / WarningProperty 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 -> PoliciesPolicy (policy_id) has no prepayment requiredErrorSpecified policy does not have a prepayment defined.Update property policies and define a prepayment for specified (policy_id).-
OTA_HotelDescriptiveContentNotif -> ContactInfosNo general contact is specified in the correct formatErrorProperty does not have a correct general contact specified.Update the property details with proper general contact.-
OTA_HotelDescriptiveContentNotif -> ContactInfos -> AddressesPostal code not correctErrorProperty postal code is invalid.Update the property details with a valid postal code.-
OTA_HotelDescriptiveContentNotif -> HotelInfo -> CategoryCodes -> HotelCategoryHotel type not setErrorProperty does not have a proper accommodation type.Update the property details with a suitable accommodation type.-
OTA_HotelDescriptiveContentNotif -> PoliciesInvalid checkin/checkoutError / WarningProperty 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 -> OwnershipManagementInfosNo company name for invoicing foundWarningProperty does not have a valid company name set for invoicing.Update the property details with proper invoice details.-
OTA_HotelDescriptiveContentNotif -> HotelInfo -> CategoryCodes -> GuestRoomInfo -> QuantityThe number of rooms are not specifiedErrorProperty does not have any rooms.Specify the quantity of room in GuestRoomInfo object.-

List of room-level errors

ObjectMessageMessage TypeDescriptionResolutionNotes
OTA_HotelInvNotif -> SellableProducts -> GuestRoomNo rooms activeErrorProperty does not have any active rooms.Activate a room.-
OTA_HotelInvNotif -> SellableProducts -> GuestRoom(number) duplicates for room name (room_name) (room_ids_list)ErrorDuplicated rooms were found for this property.Update room details - delete or rename rooms with duplicated names.-
OTA_HotelInvNotif -> SellableProducts -> GuestRoomUndefined room type (room_id)ErrorRoom with specified room_id does not have a type defined.Update room details with proper type.-
OTA_HotelInvNotif -> SellableProducts -> GuestRoomUnhandled room type (room_type_id) for room (room_id)ErrorThe room type ID for specified room_id is invalid.Update room details with proper type.-
OTA_HotelInvNotif -> SellableProducts -> GuestRoomRoom (room_id) does not have a kitchen or a kitchenette.Warning / ErrorSpecified 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 -> GuestRoomRoom name for room (room_id) (room_name) does not correspond to RoomType (room_type_name)Warning / ErrorRoom 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 -> GuestRoomRoom type for room (room_id) (room_name) does not correspond to expected RoomType (room_type_name)Warning / ErrorRoom 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 -> GuestRoomRoom occupancy (number) for room (room_id) (room_name) does not correspond to RoomType (room_type)Warning / ErrorInvalid 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 -> GuestRoomRoom (room_id) has no occupancy definedWarning / ErrorNo 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 -> GuestRoomRoom (room_id) has no facilities definedWarning / ErrorNo 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).