Handling Errors and Warnings in status endpoint
The response of the status endpoint either provides a success message or a set of Errors and/or Warnings. The Errors and Warnings provide information to make the property open bookable.
List of property-level errors
| Error Message | Message Type | Description | Resolution | Notes |
|---|---|---|---|---|
| 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. | Use Contacts API with correct phone numbers. | - |
| The email address (email) is invalid | Error | One or more of the contact emails of the property is not valid. | Use Contacts API with correct emails. | - |
| Hotel has non-Latin characters in name | Error | Property names can only contain Latin letters and numbers. | Update the property details ensuring that there are only Latin characters in the property name. | - |
| No availability pushed | Error | Property can not go to "Open" state if there is no availability for the next 18 months. | Ensure that there is an open room, open rate and open date with a price using OTA_HotelAvailNotif. | - |
| No hotel facilities defined | Error | Property does not have any facilities set. | Update the property facilities. | - |
| No general policy defined | Error | Property does not have any policies set. | Update policy to have at least one PolicyName="General". | - |
| All policies are disabled, no existing policies | Error | Property has all policies disabled, or does not have any policies. | Update policy, create at least one policy and activate it. | - |
| Hotel has non-Latin characters in city | Error | City name of the property contains non-Latin letters. | Update the property details ensuring that there are only Latin characters in the city name. | - |
| Hotel has non-Latin characters in address | Error | City name of the property contains non-Latin letters. | Update the property details ensuring that there are only Latin characters in the address. | - |
| No rates defined | Error | Property does not have any rates. | Update rate plans and create at least one rate plan. | - |
| No products defined | Error | Property does not have any products. | Create at least one room rate/product using OTA_HotelProductNotif. | - |
| No contacts specified | Error | Property does not have a Primary/General contact defined. | Update the contact details with a General/Primary contact. | - |
| Policy (policy_id) has no prepayment required | Error | Specified policy does not have a prepayment defined. | If a flexible cancellation policy is set then prepayment terms are required Update policy and define prepayment terms. | - |
| Invalid checkin/checkout | Error | Property check-in/check-out times are invalid or does not match the checkin/checkout times previously provided. | Use Property Details API to add correct check-in/check-out times. | - |
| The number of rooms are not specified | Error | Property does not have any rooms. | Specify the quantity of room with Property Details API. | - |
| Property has pending photo requests | Error | Uploaded photos are being processed. | Wait for sometime to allow processing of photos to be complete before trying again. | - |
| The geo codes are not specified | Error | Property's geo location in latitude/longitude is not set. | Update Geo location of the property using Property Details API. | - |
| Main photo is not set | Error | Property and/or room photo is missing. | Update photos using Photo API. | - |
| Main photo is not enabled | Error | Property and/or room photo is missing. | Update photos using Photo API. | - |
| License number required | Error | Missing property or room license. | Update property or room license using the License API. | - |
| Valid Legal Entity or Contract not found | Error | Signed contract in the country of location of the property is not found. | Add a signed contract for the country where the property is located using Contracting API. | - |
| Invoice check failed for hotelId (hotelId) | Error | One or more of the mandatory field/s required in invoice details for opening the property is/are missing. | Use Property Settings API to add required details that are missing. | - |
| Brazil Invoice check failed for hotelId (hotelId) | Error | A property located in Brazil is missing one or more of the mandatory field/s required in invoice details for opening the property. | Use Property Settings API to add required details that are missing. | - |
| French tax details are incomplete but mandatory for property's location. Incomplete details (details) | Error | A property located in France is missing one or more of the mandatory tax field/s required for opening the property. | Use Property Settings API to add required details that are missing. | - |
List of room-level errors
| Message | Message Type | Description | Resolution | Notes |
|---|---|---|---|---|
| No rooms active | Error | Property does not have any active rooms. | Activate a room. | - |
| Undefined room type (room_id) | Error | Room with specified room_id does not have a type defined. | [Update room details][Manage Listings] with type. | - |
| Room (room_id) does not have a kitchen or a kitchenette. | Warning / Error | Specified room is missing a kitchen or kitchenette. | Update Facilities for Kitchen with kitchen or kitchenette. | An Error is reported, if the accommodation type is one of the following needs to be corrected for the property to be Open /Bookable ACC_TYPE_APARTHOTELACC_TYPE_APARTMENT ACC_TYPE_CONDO A Warning is reported for the following accommodation types ACC_TYPE_LODGE ACC_TYPE_HOLIDAY_HOME ACC_TYPE_HOLIDAY_PARK ACC_TYPE_VILLA |
| Room (room_id) has no facilities defined | Error | No defined facilities for specified room_id. | Update Room Facilities to add room amenities. | - |
| Room has no photos | Error | Room has no Photos. | Add photos for the room using Photo API. | Required for all accommodation types except for ACC_TYPE_VILLA, ACC_TYPE_CHALET, ACC_TYPE_APARTMENT, ACC_TYPE_HOLIDAY_HOME, ACC_TYPE_APART_HOTEL |