Skip to content

Rentals United

Jump to bottom
Konstantin Kolotyuk edited this page Sep 20, 2016 · 7 revisions

Rentals United

Website: http://rentalsunited.com

Rentals United is a channel manager, supporting 50+ channels and hosting 250.000 properties.

Documentation

API

  • API format: XML
  • API URL: http://rm.rentalsunited.com/api/Handler.ashx (the same for all API endpoints)
  • API usage limits: unknown

Authentication

All API calls must contain login/password pair embedded in XML payloads. Valid login/password pairs from main website are valid for API calls. Example

<Pull_ListAmenities_RQ>
 <Authentication>
   <UserName>user@name.com</UserName>
   <Password>password</Password>
 </Authentication>
</Pull_ListAmenities_RQ>

Communication

There is Slack chat with Rentals United & Roomorama people.

Integration notes

Quote price

Quote price is performed using Pull_GetPropertyAvbPrice_RS API method. The final price includes fees and discounts.

Request example:

<Pull_GetPropertyAvbPrice_RQ>
  <Authentication>
    <UserName>username@domain.com</UserName>
    <Password>password</Password>
  </Authentication>
  <PropertyID>562441</PropertyID>
  <DateFrom>2016-09-19</DateFrom>
  <DateTo>2016-09-20</DateTo>
  <NOP>2</NOP>
</Pull_GetPropertyAvbPrice_RQ>

Response example:

<Pull_GetPropertyAvbPrice_RS>
    <Status ID="0">Success</Status>
    <PropertyPrices PropertyID="562441">
        <PropertyPrice AdditionalFees="0.00" Cleaning="44.50" Deposit="1200.00" ExtraPersonPrice="0.00" NOP="2" SecurityDeposit="40.00">1744.50</PropertyPrice>
    </PropertyPrices>
</Pull_GetPropertyAvbPrice_RS>
Booking

Rentals United supports special method Push_PutPropertesOnHold_RQ for holding reservation for 15 minute before actual booking. However, this step is not mandatory and reservation confirmation method can be called without previous holdings.

Since we don't support holding in our platform, then Push_PutConfrmedReservatonMult_RQ is called without any previous steps for holding.

Push_PutConfrmedReservatonMult_RQ supports multiple properties booking in the same reservation. Our platform doesn't support such feature, so that currently Push_PutConfrmedReservatonMult_RQ is always called with a single property.

Request example:

<Push_PutConfirmedReservationMulti_RQ>
  <Authentication>
    <UserName>username@domain.com</UserName>
    <Password>password</Password>
  </Authentication>
  <Reservation>
    <StayInfos>
      <StayInfo>
        <PropertyID>562441</PropertyID>
        <DateFrom>2016-09-19</DateFrom>
        <DateTo>2016-09-20</DateTo>
        <NumberOfGuests>2</NumberOfGuests>
        <Costs>
          <RUPrice>244.50</RUPrice>
          <ClientPrice>244.50</ClientPrice>
          <AlreadyPaid>244.50</AlreadyPaid>
        </Costs>
      </StayInfo>
    </StayInfos>
    <CustomerInfo>
      <Name>Test</Name>
      <SurName>Test</SurName>
      <Email>test.test@test.com</Email>
      <Phone>+11 111 111 111</Phone>
      <Address>Some address</Address>
      <ZipCode>644119</ZipCode>
    </CustomerInfo>
    <Comments></Comments>
  </Reservation>
</Push_PutConfirmedReservationMulti_RQ>

Response example:

<Push_PutConfirmedReservationMulti_RS>
  <Status ID="0">Success</Status>
  <ReservationID>90377000</ReservationID>
</Push_PutConfirmedReservationMulti_RS>
Cancellation

Booking cancellation is done by using API method called Push_CancelReservaton_RQ. The only parameter for this method except credentials is ReservationID. The response includes nothing except default request success status attribute.

Request example:

<Push_CancelReservation_RQ>
  <Authentication>
    <UserName>username@domain.com</UserName>
    <Password>password</Password>
  </Authentication>
  <ReservationID>90387471</ReservationID>
</Push_CancelReservation_RQ>

Response example:

<Push_CancelReservation_RS>
  <Status ID="0">Success</Status>
</Push_CancelReservation_RS>
Synchronisation

RU: Quick Start Guide describes three types of possible strategies for pulling inventory from Rentals United. For scalability reasons the strategy called Big OTAs (10k+) is currently chosen for this integration.

Metadata synchronisation steps:

  • Fetch location ids which have at least one active property
  • Fetch locations by ids
  • Fetch property ids for every location
  • Fetch property details for every property id

Availabilities synchronisation steps:

  • Fetch availabilities
  • Fetch rates (called price seasons in terms of Rentals United)
Clone this wiki locally