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.