Built by owners, for owners.

Getting Started

Recommended Reading

Overview

Bookings & Quotes

Properties

Guests

Quotes

My Account

Messaging

Email Template Library

Door Locks

Property Management

Reviews

Listing Site Integration

Widgets

Hosted Websites

Technical Stuff

Privacy & Security

Insurance and Damage Protection

Data Management

QuickBooks Integration

Rates

Rules

SMS Messaging

Security Deposits

Taxes

Payments

Dynamic Pricing Integrations

OwnerRez API

Other Integrations

Channel Management

Page-Specific Help

Testing

Change Log

API Integrations - Rate & Fee Differences

Our Channel Management feature is extremely powerful and can greatly simplify your channel advertising. Learn how it works by reading our Channel Management Overview article.  The most powerful part of our Channel Management is the API Integrations we have with certain channel partners.

However, each API Integrated channel has different sorts of rates and fees that they accept. Every channel supports nightly rates, but some also support additional fees, length of stay discounts, etc.

Difference Table

See the table below for a list of rates/fees that we can push to each API integrated channel. Note the info bubbles on some channels -- some things we can't push but can be configured on the channel side. Look below the table for more information about each function.

Channel Rate Discounts Fees Taxes
Nightly Week/Month Last Minute LOS Guests Cleaning Pets Other
HomeAway & VRBO Yes No Yes Yes Yes Yes Yes Yes Yes
Airbnb Yes No Yes   Yes Yes Yes No Yes   Yes  
Booking.com Yes No Yes   No   Yes No   No No   No  
TripAdvisor Yes Yes Yes   No   Yes Yes No Yes Yes
FloridaRentals.com Yes Yes FloridaRentals displays rates to the guest, but you'll get a normal OwnerRez inquiry and you will create an OwnerRez quote with full charges calculated out of OwnerRez.

There are two main categories of channels when it comes to rates -- those that do nightly rates and Length Of Stay (LOS) discounts and those that do night, week, month rates. We recommend using nightly rates and Length Of Stay (LOS) discounts only -- for channels that do week/month rates instead of LOS discounts, we will transform LOS discounts into those week/month rates. We do not transform week/month rates into LOS discounts.

Automatic mode surcharges & discounts will be applied based on the listing site criteria. Any surcharge or discount applied Manually, Optionally, or By Code will be ignored and never sent to a channel.

Targeting Surcharges & Discounts by Channel

You can target surcharges and discounts to specific channels (or to everything but specific channels) by using the Listing Site criteria.

Supported channel listing site criteria: HomeAway, Airbnb, Booking.com, TripAdvisor, FloridaRentals.com

Per-Channel Details and Idiosyncrasies

Each channel does things a bit differently. This section covers the specifics of what's supported by each one and how to configure them. We attempt to make things transparently work across as many channels as possible with the simplest configuration, but some channels just don't support certain concepts or criteria.

HomeAway/VRBO

HomeAway has the richest system to describe nightly rates rates, discounts, and fees. They do not support week/month rates but do support Last Minute discounts and LOS discounts.

Nightly Rates: We will send the exact rate you have configured in OwnerRez for each night (with any rate adjuster from the channel settings)

Discounts: Last Minute discounts, LOS discounts, and pretty much any other type of discount is supported. HomeAway supports up to 15 different discounts. You can do per-night or per-stay discounts.

Surcharges: Guest fee, Cleaning fee, Pet fee, Refundable Damage Deposit, other fees -- and pretty much any type of fee is supported. HomeAway supports up to 15 different surcharges of each type. You can do per-night or per-stay fees.

HomeAway doesn't display the description.  But you can use the following types:

  • Cleaning: Include the word "cleaning" or "housekeeping" in your surcharge description
  • Guest/Adult: Use a per-Guest or per-Adult multiplier
  • Pet: Use a per-Pet multiplier. NOTE: HomeAway only gives the guest a "I have a pet checkbox" so it'll come across as 0 or 1 pet. If they have more than 1 pet and you charge per pet, put that in your house rules and adjust the charges after booking accordingly
  • Refundable Damage Deposit: Include the word "refundable" in your surcharge description. This will be included as a charge on the booking and in the payments. Remember to refund it after departure (there's no auto-refund for RDD surcharges like there is for secdep holds).  Note that we recommend using secdep holds instead of refundable damage deposits.
  • Wood: Include the word "wood" in your surcharge description
  • Parking: Include the word "parking" in your surcharge description
  • Other fees: You can add as many other fees as you want (up to 15) and they'll show up as a generic Management or Booking etc. fee depending on taxability

Taxes: All taxes you configure in OwnerRez (that are applicable to the HomeAway channel) will apply. You are responsible for remitting them.

For the purposes of surcharge taxability, you can only have one taxability setting per category of surcharge. For example, you can have a taxable guest fee and a non-taxable cleaning fee. But you cannot have a taxable cleaning fee and also a non-taxable cleaning fee.

Supported Criteria & Multipliers: 

The following multipliers and booking criteria will pass through to HomeAway for surcharges and discounts. Any criteria or multiplier not on the list will not be used.

  • Standard Criteria: Property, Season, Listing Site
  • Multiplier: Guests, Adults, Children, Pets. Only supports multiplying for every 1 item (not every 2 etc). Discounts don't support multipliers.
  • Arrival Days From Now
  • Number Of Nights
  • Guests, Adults, Children: You can use any of these criteria but only one of them
  • Booked Date
  • Arrival Date
  • Departure Date
  • Booked Month of the Year
  • Arrival Month of the Year
  • Departure Month of the Year

Quirks

  • Not Equal To criteria is not supported
  • Percentage surcharges/discounts will only target rent, not other surcharges/discounts
  • Percentage multipliers are not supported
  • Month of Year criteria can wrap around the year end. If you want to target Arriving October to February, you could do:
    Arrival Month of the Year >= 10
    Arrival Month of the Year <= 2
  • Departure Date/Departure Month of the Year: HomeAway doesn't have a specific departure date criteria, so this will go to the stay date contains criteria
  • Multiple criteria can work together (i.e. you could have Arrival Days From Now and Number Of Guests), but remember that the criteria must all apply (AND). For example you could do these together:
    Arrival Days From Now >= 5
    Arrival Days From Now < 8

    But not:
    Arrival Days From Now = 5
    Arrival Days From Now = 6

    Because the combination of criteria will never apply.
  • HomeAway evaluates based on ANY date criteria matching, not ALL as OwnerRez does. We recommend using a single date range field, like Arrival Date >= 1/1/2020 and Arrival Date <= 12/31/2020. If you use multiple fields (like Arrival Date >= 1/1/2020 and Departure Date <= 12/31/2020) then it will match if either of those criteria matches rather than requiring both to match.

Airbnb

Airbnb supports nightly rates and some specific surcharges and discounts.

Nightly Rates: We will send the rate you have configured in OwnerRez for each night, combined with any rate adjuster from the channel settings, and also combined with any per-night surcharge or discount that applies to that single night. Airbnb doesn't support rich surcharge/discount criteria, so instead we roll as much as possible into the nightly rates, and push updates every 24 hours to keep them up to date as date criteria adjusts.  By its nature, this means that daily rates displayed in Airbnb will often not be exactly the same as those displayed elsewhere, but the general "gist" of your rate setup should be maintained.

Discounts: Per-stay LOS discounts are supported with date range and number of nights greater than criteria.

Any other discounts like Last Minute discounts must be per-night or per-stay percentage, with criteria that allows them to match a night. If they meet those requirements, the discount will be applied as an adjustment to the nightly rate.

Surcharges: A limited set of per-stay surcharges are supported. Guest fee is the only per-night surcharge supported. Any other per-night surcharges must be per-night or per-stay percentage, with criteria that allows them to match a night. If they meet those requirements, the surcharge will be applied as an adjustment to the nightly rate.

For details on surcharge configuration, see the Airbnb Surcharges FAQ entry.

Taxes: Taxes can be remitted by Airbnb or remitted by you depending on what Airbnb supports in your area. In some places Airbnb lets you add or override the taxes they collect but in others the only thing you can do for additional taxes is to include in your nightly rate.

For details on surcharge configuration, see the Airbnb Taxes FAQ entry.

NOTE: Airbnb only supports flat per guest, flat per night, flat per guest and night, and percent per reservation taxes. They do not support flat per stay taxes.

Unsupported Criteria & Multipliers

  • Arrival/departure date criteria is used to form an applicable range for dates of stay, but but won't exclude bookings lapping over the beginning or end of the time period.
  • Day of week/month
  • Date Booked
  • Length of stay discounts do not support only "number of days from now" criteria. They do support minimum-nights criteria and date-range criteria.
  • Maximum-nights criteria is not supported
  • Guests/Adults is supported only for the Guest fee
  • Guests/Adults/Pets is not supported for any other surcharges or discounts

Booking.com

Booking.com supports updating nightly rates and a per-guest fee via API. Any other fee, discount, or tax has to be configured on booking.com and then it will come through to OwnerRez as part of a booking.

Nightly Rates: We will send the rate you have configured in OwnerRez for each night combined with any rate adjuster from the channel settings and also combined with any per-night surcharge or discount that applies to that single night. Booking.com doesn't support rich surcharge/discount criteria so instead we roll as much as possible into the nightly rates and push updates every 24 hours to keep them up to date as date criteria adjusts

Discounts: No per-stay discounts are supported. Any other discounts like Last Minute discounts must be per-night or per-stay percentage, with criteria that allows them to match a night. If they meet those requirements, the discount will be applied as an adjustment to the nightly rate.

Surcharges: Only a per-guest fee is supported. All other fees must be configured on the booking.com side. When you configure a taxable fee in booking.com, make sure to set it taxable on booking.com so they will send the correct tax to OwnerRez. If you don't see an option for taxability, contact booking.com support and they'll be able to make the change for you.

Taxes: Taxes must be configured on the booking.com side. Booking.com passes back a total tax amount to OwnerRez and we will split that total among the taxes you have configured in OwnerRez.

Unsupported Criteria & Multipliers

  • Arrival/departure date criteria is used to form an applicable range for dates of stay but but won't exclude bookings lapping over the beginning or end
  • Booked
  • Maximum nights criteria is not supported
  • Guests/Adults is supported only for the Guest fee
  • Guests/Adults/Pets is not supported for any other surcharges or discounts

TripAdvisor

TripAdvisor supports nightly rates and also week/month rates as well as surcharges, discounts, and taxes. We recommend using LOS discounts instead of week/month rates but we do support week/month rates currently.

TripAdvisor has two sets of rates that are used:

  1. We will send the rate, total tax percent, and per-guest fee you have configured in OwnerRez settings. If you have week/month rates, we will also send those.

    This is what will be initially displayed to the guest in a search mode.
  2. When the guest goes to book, TripAdvisor will request a live quote from OwnerRez. This will calculate nightly rates (or week/month if possible) as well as surcharges, discounts, and taxes just as a standard OwnerRez quote would. So the total amount of surcharges, discounts, and taxes should match what you'd see in an OwnerRez quote for the same booking.

    Note: While the total will match, TripAdvisor supports only fee line items. Rent, tax, and Refundable Damage Deposit are single total values and there is no support for discount display. So discounts will be subtracted from the rent total instead of broken out to a separate line item.