Update Property

The endpoint allows users to update the existing property.

Endpoint

POST 

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/update

Attributes

hotel_id alphanumeric (Required)

The unique property ID as assigned by the provider upon creation of the property.

legal_entity_id string (Required)

The unique id for the legal entity associated with the hotel.

Only allowed for new properties.

position object

Object containing geographical coordinates of the property.

latitude double (Required)

Latitude coordinates of the hotel location.

longitude double (Required)

Longitude coordinates of the hotel location.

check_in object

Object containing check-in times.

Specify 24-hour check-in by using 00:00 for both from and until.

from enumerated string (Required)

Start time for check-in (required).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

until enumerated string (Optional)

End time for check-in.

Accepted values follow the Booking.com Check-In / Check-Out Times format.

check_out object

Object containing check-out times.

from enumerated string (Optional)

Start time for check-out (optional).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

until enumerated string (Required)

End time for check-out (required if check_out > from is specified).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

property_name string (Required)

Name of the hotel property on Booking.com.

Does not support using CJK Unified Ideographs.

property_category integer (Required)

Category identifier for the hotel.

For a list of supported property class type codes, see Property Class Type Code.

primary_language enumerated string (Optional)

Main preferred language spoken at the property.

languages_spoken array of enumerated strings (Optional)

Array of languages spoken at the property.

room_count integer (Required)

Number of sellable units/rooms available at the hotel.

A "sellable unit" is the smallest possible space that a guest can book at the property. In a property with 200 rooms, each room is a sellable unit, and the value would be 200. In a holiday home, guests must typically book the home in its entirety, making the value 1.

floor_count integer (Optional)

The total number of floors in the building/hotel, excluding the underground floors.

Max value can be 200.

stars string (Optional)

The number of stars, rating of the hotel.

Accepts values: 0–5. Starting from 1, accepts values in increments of .5. Some countries don't use star ratings. To see whether your property belongs to a Hotel property type,

target enumerated string (Required)

Specifies whether it is a test or production-ready property.

Accepts the following values:

  • test

  • production

provider_property_id string (Optional)

Identifier for the property provider.

Recommended for new properties. For example, the provider's internal ID. Can contain a maximum of 16 characters.

currency_code enumerated string (Optional)

The Booking.com defined currency for the property.

In select countries a currency other than the default can be selected.

physical_address object (Required)

Object containing address details.

city_name string (Required)

City where the hotel is located.

country_code enumerated string (Required)

ISO code for the country (IN for India).

postal_code string (Optional)

Postal code of the hotel's location.

Make sure the zip code (postal_code) is relevant to the country specified in the country_code.

address_line string (Required)

Detailed address of the hotel.

display_address boolean (Optional)

Boolean indicating if the address should be displayed.

- true : Shows the full address to the guest. - false : Hides the full address from the guest.

translations object

Object for multilingual support. Specifies the non-English translations of the physical address.

city_name string (Required)

Translated city name.

address_line string (Required)

Translated address line.

Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters.

language_code enumerated string (Required)

Language code for translation.

property_name enumerated string (Required)

Translated property name.

Sample Request

{
    "hotel_id": "new1",
    "legal_entity_id": "78775",
    "position": {
        "latitude": -36.8485,
        "longitude": 174.76333
    },
    "check_in": {
        "from": "12:30",
        "until": "13:00"
    },
    "check_out": {
        "from": "10:00",
        "until": "10:30"
    },
    "property_name": "TP TEST hotel NZ",
    "property_category": 30,
    "primary_language": "en-nz",
    "languages_spoken": [
        "en-nz"
    ],
    "room_count": 8,
    "floor_count": 1,
    "stars": "4",
    "target": "test",
    "provider_property_id": "test",
    "currency_code": "NZD",
    "physical_address": {
        "city_name": "Auckland",
        "country_code": "NZ",
        "postal_code": "1010",
        "address_line": "123 Queen Street",
        "display_address": true
    },
    "translations": {
        "city_name": "t1",
        "address_line": "t2",
        "language_code": "ca",
        "property_name": "New"
    }
}

Response

Sample Success Response

{
    "Status": "Success",
    "Data": {
        "property_id": 12905777
    },
    "Message": "Property updated successfully"
}

Error

Sample Error Response 

{
    "Status": "Fail",
    "Errors": [],
    "Message": "Invalid value - Legal entity 12855361 does not have a valid contract and is not allowed to create properties "
}

Response Body Elements

Status string

The status of the response.

Data object

The response data, the root element.

property_id string

Specifies the property ID that was created.

Message string

The message in the response.

PreviousRetrieve PropertyNextContact Details

Last updated

Was this helpful?