How to Connect an Airbnb Account and its Listings
In order to add a new AirBnb connection to your hoteliga account please follow the steps described below:
Contents
Connect your Account
Authorize the AirBnb Account
At this moment, you are supposed to already have an AirBnb account. You are advised to open a tab in your browser and log in to the Airbnb account.
In the hoteliga account, navigate to the Channel Manager area (Options ⇒ Channel Manager) and go to the Accounts page, the first button in the AirBnb (Official) area.
You should be able to see the AirBnb (Official) area (image above). If you don't, it means you don't have permission to create an AirBnb channel (please contact hoteliga support for more information).
In Accounts, you will see an empty page with a red button “Connect with Airbnb”:
- Before clicking the button, make sure that you are logged in to your AirBnb account.
- The button “Connect with Airbnb” will redirect you to the Airbnb page, where you will give access to hoteliga:
- After giving access, you will be redirected back to account list:
The account was authorized successfully.
To add another account, repeat 1-3 steps above.
Unauthorize your AirBnb Account
To disconnect an Airbnb account, go to Accounts and click on the account you want to disable and select "Disconnect account":
After disconnecting successfully, no information about this account will be available to hoteliga.
You can also remove the access from your Airbnb control panel:
If you do so, you also have to remove this account from hoteliga by clicking "Remove disconnected account" (Accounts page).
Manage the Listings
Airbnb Listings are equivalent to hoteliga room types. If a room type has more than one rooms, all rooms should offer the same amenities and services.
Once you authorize access to the Airbnb account, all listings will become available for connection in hoteliga channel manager.
For example, you have 3 listing in your Airbnb account:
Inside hoteliga Listings (Channel Manager ⇒ Listings, second button in AirBnb section) you will be able to see all the Airbnb listings from all the authorized accounts:
The meaning of each column is:
- Listing name: the name you have set inside Airbnb account for a listing
- Account email: the email of the authorized account
- Room type: associated hoteliga room type title (when the listing is connected)
- Available: if a listing is available, no – listing is not available, and no reservation can be made
- Connected: if a listing is connected, that is prices and inventory are managed through hoteliga
- Channel name: the channel name which will be created in hoteliga and associated with airbnb listing
- Sync category:
- Disconnected – a listing is not managed by hoteliga
- Limited - hoteliga sends updates only about prices and availability
Connect an AirBnb listing
When you click on a listing, you will see a modal, where you can edit only 3 fields:
- Room type
- Connected
- Available
To connect a listing to hoteliga you should choose the appropriate hoteliga room type and enable Connected.
When you reopen the window you will see that Available is enabled, there is an associated Channel name and the Sync category is Limited.
- The field Approved means that from AirBnb side this listing was checked for minimum required information (title and at least one photo).
- If there is no photo, instead of approved you will see rejected and below in Approval notes the reason this listing was rejected.
- Rejected means no reservation can be made for this listing.
- You can also make the listing unavailable, but it will still be managed through hoteliga.
- Unavailable is equivalent to a closed property.
Now, from your hoteliga domain, you can manage the AirBnb listing.
Set up the AirBnb Channel
After connecting a listing, an associated record in channels (Options ⇒ Channel Manager ⇒ Channels) will be created:
When you disconnect a listing, the associated record will be deleted from channels.
Click on the newly created channel.
- Title – here, you can change the channel's title.
- Channel property ID – is the associated listing ID
- account_id – the host's ID (AirBnb account ID)
- inventory_count – should be 0 or 1 depending on the available rooms inside the related room type in hoteliga:
- 0 – means that the mapped hoteliga room type has only one room and AirBnb will be updated if the room type is available or not
- 1 – means that the mapped hoteliga room type has more than one rooms and AirBnb will be updated with how many rooms are available
- include_commission – should be 0 or 1:
- 0 – means that the Airbnb commission will not be calculated in the agreed price of the reservation
- 1 – means that the Airbnb commission will be calculated in the agreed price of the reservation
For this channel, the ”room types” mapping is, also, completed automatically. Here, you could change the mapped room type, if needed:
Finally, you need to map rates inside “Price list” tab.
For Airbnb, there is only one rate.
Create a contract
After successfully connecting a listing to hoteliga, you need to:
- create a booking agency for Airbnb (Options > Settings > Agencies > New Agency) and
- a price list (Options > Settings > Pricing Policy > Pricelists > New Pricelist),
if they are not created already.
Then you can create the contract for the newly created Airbnb channel (Options > Settings > Agencies > Contracts > New Contract).
Upload the available rooms
From the tab "Rooms", inside the contract, you need to set your sales target and click “Save”, so that Airbnb gets updated with the current room availability.
Upload the prices
From the tab "Price list", inside the contract, you need to Upload the prices to Airbnb.
Compare availability & prices
Once you complete the steps above, please double-check your availability and prices in Airbnb to make sure that everything was done correctly.
Set Prices
After properly connecting the listings, in the Airbnb (Official) area you should be able to see one line for each listing with the following tabs:
- Set Prices
- Set Restrictions
- Clear Restrictions
From the Set Prices modal, you are able to define several special and extra charges:
Important: Make sure that the Default Daily Price corresponds to the listing's overnight value. Airbnb applies the Default Daily Price whenever prices are not updated and availability is open.
Set Retrictions
From the Set Restrictions modal, you can set various restrictions in the tab Global Settings and restrictions for a specific period in the tab Options.
Default min nights: Minimum Stay. Note: Airbnb uses only Minimum Stay Arrival.
Default max nights: Maximum duration of a reservation.
Min hours ahead: The minimum number of hours between the booking time and the check-in time.
Allow request to book: Allow guests to send reservation requests.
Max days ahead: The maximum number of days between the booking date and the check-in date.
- Select 0 to make ALL future dates Unavailable.
- Select -1 to make ALL the future dates Available
Preparation time: The number of days to be blocked before and after a reservation.
Check-in days: Days of the week that check-in is possible.
Check-out days: Days of the week that check-out is possible.
Min nights for check in on: Minimum stay arrival based on each day of the week.
Clear Restrictions
From the Clear Restrictions modal, you can remove all previously defined restrictions. By doing so, the default restrictions will apply.
Seasonal Rules
Seasonal Rules are pricing and/or availability rules that are created on account level and can be applied for a specific time period over listings.
In order to review the existing seasonal rules, for all authorized accounts, select "Seasonal Rules" (Channel Manager => Seasonal Rules).
Create a Seasonal Rule (Availability/Pricing)
From Options > Channel Manager > Airbnb > Seasonal Rules select the "New Seasonal Rule".
In the modal that will open, the minimum required fields are a title and the e-mail of the account to which the new rule will be added.
Note that seasonal rules can apply only to listings of the specific account.
"Rule id" can not be selected or modified, since it is determined from Airbnb.
- Title - is the selected naming of the seasonal rule
- Rule id - can not be selected or modified, since it is a unique identifier determined from Airbnb.
- Color - select the color that will be applied to the days that this rule is applied to (calendar in Airbnb page)
- E-mail - the e-mail of the account for which the rule will be created
- Pricing Rules
- Seasonal adjustment - a percentage or fixed amount applied to the base nightly price (daily or custom price)
- Length-of-stay adjustment - a percentage or fixed amount applied to the adjusted seasonal price if they stay a specified length of time
- Last-minute discount - modify the adjusted seasonal price by a percentage or fixed amount if guests book within a specified date/time of their stay
- Booking-ahead discount - deduct a percentage or fixed amount from the adjusted seasonal price if they book before a specified date/time before their stay
- Availability Rules
- Closed on arrival - days of the week when guests cannot check-in
- Closed on departure - days of the week when guests cannot check-out
- Max nights - for each day of the week, the maximum nights guests can stay if they check-in on that day
- Min nights - for each day of the week, the minimum nights guests can stay if they check-in on that day
When adding pricing rule(s), remember to click on the "Add" button so that it is added.
After creating the desired pricing and/or availability rules click on "Save".
Update a Seasonal Rule
Select the desired rule and apply the desired modifications.
"Rule id" and "E-mail" fields can not be updated.
After applying changes click on "Save".
Delete a Seasonal Rule
Select the desired rule and click on the "Delete" button.
Apply a Seasonal Rule
In order to apply a Seasonal Rule, go from Options > Channel Manager > Airbnb > Listings, select the listing you want and go to the tab Seasonal Rules. There select one from the "Title" dropdown menu, define the period for which you want to apply the rule and click "Add".
- The same rule can be applied for different time periods.
- If applying multiple rules for the same time period, the latest one will take effect.
In order to remove an applied Seasonal Rules, select the desired time period and click on "Delete" button.
In order to review the applied seasonal rules on a listing, select the desired listing from listings' list (Channel Manager ⇒ Listings).
In the modal, select the “Seasonal Rules” tab. Here you can review, which rule and over which time period(s) is applied.
Getting Prices from AirBnb
Navigate to available listings (Channel Manager ⇒ Listings) and select a connected listing.
Selecting "Get Prices" will retrieve the prices that are set for this listing for the next two(2) years and will update accordingly the related hoteliga price list.
In order to use this feature, it is required that listing is connected and there is already a contract for the related channel.
Getting Reservations from AirBnb
Navigate to available listings (Channel Manager ⇒ Listings) and select a connected listing.
Selecting "Get Reservations" will retrieve and register in hoteliga all future reservations made for this listing.
