Property Upload

Property Upload

Saves, modifies, or provisions property details and its associated room profiles in the database. When updating, the request triggers a deep structure save.

POST/api/partner/property

Request schema (PartnerPropertyNotifRQ)#

XML element / nodeTypeRequiredDescription / constraints
PropertyCodeStringOptionalYour unique identification string for this physical property (e.g. PROP_A123).
PropertyNameStringOptionalFull legal name of the property.
AddressObjectOptionalContaining address elements: Line1 (String) street name & number • City (String) town/city • Country (String) two-letter/name country code
RoomTypeListOptionalRoom configurations inside the property: Code (String, e.g. DBL) • Name (String, e.g. Deluxe Double Room) • MaxOccupancy (Integer) • RatePlan (List) rate plans nested under this room — Code (String, e.g. BAR), Name (String), Amount (Decimal), Currency (String), EffectiveDate / ExpiryDate (YYYY-MM-DD), MinimumOccupancy / MaximumOccupancy (Integer)

Example payload#

Example Request XML
xml
<?xml version="1.0" encoding="UTF-8"?>
<PartnerPropertyNotifRQ>
    <PropertyCode>PROP_A123</PropertyCode>
    <PropertyName>Grand Plaza Resort</PropertyName>
    <Address>
        <Line1>123 Ocean Drive</Line1>
        <City>Miami</City>
        <Country>USA</Country>
    </Address>
    <RoomType>
        <Code>DBL</Code>
        <Name>Deluxe Double Room</Name>
        <MaxOccupancy>2</MaxOccupancy>
        <RatePlan>
            <Code>BAR</Code>
            <Name>Best Available Rate</Name>
            <Amount>150.00</Amount>
            <Currency>USD</Currency>
            <EffectiveDate>2026-08-17</EffectiveDate>
            <ExpiryDate>2026-12-31</ExpiryDate>
            <MinimumOccupancy>1</MinimumOccupancy>
            <MaximumOccupancy>2</MaximumOccupancy>
        </RatePlan>
    </RoomType>
    <RoomType>
        <Code>SUI</Code>
        <Name>Executive Suite</Name>
        <MaxOccupancy>4</MaxOccupancy>
        <RatePlan>
            <Code>SUI_BB</Code>
            <Name>Suite Bed and Breakfast</Name>
            <Amount>280.00</Amount>
            <Currency>USD</Currency>
            <EffectiveDate>2026-08-17</EffectiveDate>
            <ExpiryDate>2026-12-31</ExpiryDate>
            <MinimumOccupancy>1</MinimumOccupancy>
            <MaximumOccupancy>4</MaximumOccupancy>
        </RatePlan>
    </RoomType>
</PartnerPropertyNotifRQ>

Response scenarios#

Upon success, returns a standard success acknowledgment.

Example Success Response (200 OK)
xml
<?xml version="1.0" encoding="UTF-8"?>
<PartnerAckRS>
    <Success/>
    <Property>
        <PropertyCode>PROP_A123</PropertyCode>
        <GoogleHotelId>900000042</GoogleHotelId>
        <PropertyName>Grand Plaza Resort</PropertyName>
        <RoomTypes>
            <RoomType>
                <Code>DBL</Code>
                <Name>Deluxe Double Room</Name>
            </RoomType>
            <RoomType>
                <Code>SUI</Code>
                <Name>Executive Suite</Name>
            </RoomType>
        </RoomTypes>
        <Status>ACTIVE</Status>
        <CreatedDate>2026-07-18T12:00:53</CreatedDate>
    </Property>
</PartnerAckRS>
Your BookOne Helper
Your AI Assistant