Difference between revisions of "AirBnB.com XML"

From Beds24 Wiki
Jump to navigation Jump to search
m (1版 をインポートしました)
m (1 revision imported)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Channel Manager]]
+
#REDIRECT [[Airbnb]]
[[Category:Error Messages from Channels]]
 
 
 
''This page is about the menu SETTINGS->CHANNEL MANAGER->AIRBNB XML''
 
 
This page explains how to use the Two-Way XML connection with Airbnb.
 
 
 
==General==
 
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
 
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
 
 
== Capabilities ==
 
*Beds24 can import listings from Airbnb which will create properties and/or rooms in Beds24.
 
*Beds24 can create new listings in Airbnb as well as connect to existing listings in Airbnb that are not API-connected.  When publishing a listing from your Beds24, you have the following options:
 
**Create and automatically publish a new listing.
 
**Connect to an existing listing to update it from Beds24.
 
*Send and update content information
 
*Send and update pictures
 
*Export prices '''Please ensure you have Prices more than 12 months in advance, otherwise Airbnb.com will use the price entered in your RACK RATE.'''
 
*Export availability. Airbnb will  check real time availability before accepting a booking. Airbnb will  update their displayed calendar multiple times per day.
 
*Import bookings and booking modifications or cancellations
 
 
 
== Limitations ==
 
*Beds24 can connect all Airbnb hosts who are eligible for XML use. Airbnb restrict XML access in some cities. If you are not sure if you can use the XML ask Airbnb support to check with your market manger if you are eligible.
 
*Hosts in the DACH region (Germany, Austria and Switzerland) which are in bigger cities can use the XML if they enter an imprint in their Airbnb profile (under ACCOUNT - only available in German).
 
*Listings in properties which Airbnb considers "traditional hospitality" like hotels, Bed & Breakfast rooms and small inns are approved on a case by case basis.
 
*If you are not eligible for XML you can still use our [[AirBnB.com|Airbnb Ical]] connection to synchronise calendars.
 
*If you do not have daily prices or rates in which "Airbnb" is activated in the "Channels" tab the  "Default Daily Price" (Rack Rate) will be used up to a year in advance.
 
 
 
== Before you connect ==
 
'''Local legal requirements'''
 
 
 
Airbnb will only accept any listing which comply to local laws. Ensure you comply with any permitting, zoning, safety, and health regulations, inform yourself about any local taxes or business license requirements or other regulations that may apply.
 
 
 
[https://www.airbnb.com/help/article/1386/responsible-hosting-in-japan Japan] contact: jp-account@airbnb.com
 
 
 
[https://www.airbnb.com/help/article/1385/responsible-hosting-in-portugal Portugal] contact: profisionais@airbnb.com
 
 
 
[https://www.airbnb.com/help/article/1388/responsible-hosting-in-spain Spain]  contact: profesionale@airbnb.com
 
[
 
https://www.airbnb.com/help/article/1383/responsible-hosting-in-france France] contact: pro@airbnb.com
 
 
 
[https://www.airbnb.de/help/article/1391/responsible-hosting-in-germany Germany]  contact: ferienunterkuenfte@airbnb.com
 
 
 
For other regions please check the Airbnb help pages. 
 
 
 
'''Prices'''
 
*We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
*We can send prices and a minimum stay.
 
*In addition to the prices sent Airbnb needs a "rack rate" which is shown before the guest starts a booking.
 
*If you have activated "Smart Pricing" in Airbnb make sure you deactivate it before using the XML.
 
 
 
'''Bookings'''
 
 
 
When you use the XML connection Airbnb only allows instant bookings. In Settings > Channel Manager > AirBnB.com XML > Specific Content you can set which groups of guests are allowed to book. Strictest is only to allow experienced Airbnb guests who provide government ID to book.
 
 
 
You can import existing booking though via SETTINGS-CHANNEL MANAGER-AIRBNB ICAL. Make sure you deactivate the iCal connection after the bookings have imported.
 
 
 
If you do not use the Airbnb.com iCal connection, then you make want to update your calendar manually before activating the connection.
 
 
 
New bookings will import automatically but Airbnb will not send bookings which you had before the connection was made. But Airbnb do send a booking modification changing the payout amount when the guest arrives. We do import this modification as a new booking. If there is already a booking with the same Airbnb booking number imported via the Airbnb iCal sync this booking will be set to "Canceled"
 
 
 
'''Auto EMails'''
 
 
If you want to send Auto Action Emails to Airbnb guests you will need to use the Email address you use for your Airbnb account as outgoing EMail (SETTINGS-ACCOUNT-OUTGOING EMAIL)
 
 
 
'''Multiple Airbnb accounts'''
 
 
 
One Beds24 account connects with one Airbnb account, if you manage  multiple Airbnb accounts, create sub accounts for each with the respective properties in Beds24.
 
 
 
'''Airbnb requirements for hosts using the XML'''
 
*If you use the XML connection you agree to Airbnbs terms: https://www.airbnb.com/terms (“ Terms of Service”); https://www.airbnb.com/terms/payments_terms (“ Payment Terms of Service ”); https://www.airbnb.com/terms/privacy_policy
 
*You need to provide "Qualified Listings". For details please see below.
 
 
 
== Connect to an  Airbnb Account ==
 
 
 
Note: One Beds24 account connects with one Airbnb account, if you manage  multiple Airbnb accounts, create sub accounts for each with the respective properties in Beds24.
 
=== Connect to an existing Airbnb Account===
 
To initiate the connection click on the "Connect to Airbnb" button.
 
 
 
[[Image:airbnbxml_connect.png|450px|link=]]
 
[[Media:airbnbxml_connect.png|view large]]
 
 
 
 
 
You will then see this screen:
 
 
 
[[Image:airbnbxml_create_account_de.png|450px|link=]]
 
[[Media:airbnbxml_create_account_de.png|view large]]
 
 
 
Log into the Airbnb account you want to connect.
 
 
 
The final authorization page looks like this:
 
 
 
[[Image:airbnbxml1.jpg|450px|link=]]
 
[[Media:airbnbxml1.jpg|view large]]
 
 
 
 
 
Once you are connected the "Connect to Airbnb" button is replaced with a "View Listings in Account" button and you will see a line like this
 
 
 
[[Image:airbnbxml_connected.png|450px|link=]]
 
[[Media:airbnbxml_connected.png|view large]]
 
 
 
showing the Airbnb account number you are connected to.
 
 
 
If you have multiple properties you will need to do the authorization for each property.
 
 
 
=== Create a new Airbnb Account===
 
To initiate the connection click on the "Connect to Airbnb" button. You will then see this screen:
 
 
 
[[Image:airbnbxml_create_account_de.png|450px|link=]]
 
[[Media:airbnbxml_create_account_de.png|view large]]
 
 
 
Click on "Sign Up" to create a new Airbnb account.
 
 
 
The final authorization page looks like this:
 
 
 
[[Image:airbnbxml1.jpg|450px|link=]]
 
[[Media:airbnbxml1.jpg|view large]]
 
 
 
 
 
Once you are connected the "Authorize Airbnb" button is no longer visible and you will see a line like this
 
 
 
Connected with Airbnb account 00000000
 
 
 
showing the Airbnb account number you are connected to.
 
 
 
If you have multiple properties you will need to do the authorization for each property.
 
 
 
'''Profile'''
 
 
 
Log into your Airbnb account to complete your profile.
 
*A profile picture is required.
 
*Enter a phone number under which guests can reach the host.
 
*Use the  E-Mail address of the E-Mail account to which you want to receive enquiries
 
*Enter payout preferences in the  account settings
 
*Hosts in cities in Germany, Austria or Switzerland need an imprint  https://www.airbnb.de/users/settings/ (in German only).
 
 
 
For agencies:
 
*If you are an agency you should list the name of the agency. It can include the name of the contact person (i.E Maria from Agency XYZ).
 
*Agencies should use the profile picture of a team member, the manager or a team photo (a real person which is part of the agency).
 
*The descriptive text of the profile should picture the host as professional hosts (make it clear that you are not a private person renting a space in your home) to prevent negative reviews.
 
 
 
==Importing a listing to Beds24==
 
You can import content from Airbnb to autmatically create a room in Beds24.
 
*Click on "View all listings"
 
*Click on the "Import" button
 
*Select if you want to create a new property with a room or add a room to a property you already have in Beds24. After you have done this you will see the new property/room in SETTINGS->PROPERTIES->ROOMS.
 
 
 
What you need to do in Beds24:
 
*Go to SETTINGS->CHANNEL MANAGER->AIRBNB XML ->VIEW CONTENT or click on the "View content sent to Airbnb" link to check what was imported from Airbnb.
 
*Set up prices in Beds24. Use this [[:Category:Prices|help page]] for instructions and also read the information about prices below.
 
*Airbnb does not send pictures. Add your pictures in SETTINGS->BOOKING PAGE->PICTURES.
 
*If you want to sync the listing you have in Airbnb from Beds24 you will need to set up a connection.  See the section "Sending Data to Airbnb" below.
 
**We do not import bathroom and bedroom configurations. You will need to set them up as described in the section "Define Bedrooms and Bathrooms" below.
 
 
 
==Sending Data to Airbnb==
 
===Prices===
 
In >CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT you can set which type of price you want to send.
 
 
 
With '''Per Occupancy Pricing'''  a price for each occupancy defined in Beds24 and prices for different length of stay can be sent. If you use rates for one rate a price for Single (1 guest), Double (2 guests) and a room price (for the number of guests you have defined in the rate ) can be sent. If you have more than 3 occupancy levels you can set up additional rates for each occupancy level.
 
 
 
Note: Airbnb occupancy pricing only support minimum stays up to 30 days.
 
 
 
With '''Per Day Pricing''' the price sent is a room price, only ONE price can be sent per date. If you have multiple prices activated for Airbnb with different minimum stays the system will send the price with the lowest minimum stay. Airbnb applies the minimum stay " first night only" meaning restrictions must only be satisfied for the arrival date of the booking but not on every day of the booking. With Per Day Pricing you can also set
 
*The number of guests for which the price applies.
 
*An extra person price.
 
 
 
Airbnb requires a "Default Daily Price" (Rack Rate) which you can set under SETTINGS->CHANNEL MANAGER-->PROPERTY CONTENT->ROOM CONTENT. If you do not have daily prices or rates which are activated for channel management or rates in which "Airbnb" is activated the rack rate will be used up to a year in advance.
 
 
 
In SETTINGS->CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT you can set
 
*A factor for a discount for 2 or more days, weekly or monthly. Use either the discounts for number of days or month/week but not both because the discount per days will override the discount per week/month.
 
*Rules for dates with no price. If you require minimum stays we recommend you set this to the default "Close the Room" because we can not send minimum stays to the default daily price.
 
 
 
In SETTINGS-> CHANNEL MANAGER-> PROPERTY CONTENT-> ROOM CONTENT you can set
 
*Cleaning fee
 
*Security deposit
 
 
 
Note: If you have a price multiplier in SETTINGS->CHANNEL MANAGER->AIRBNB XML, this will also be applied to the Cleaning fee/Security deposit. If you want to over ride this, then use a CUSTOM value in SETTINGS->CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT.
 
 
 
Certain global settings can be overridden with custom values. If required see this [[Setting/custom|list of custom parameters]].
 
 
 
 
 
Airbnb only supports following currencies: ARS,AUD,BRL,CAD,CHF,CNY,CZK,DKK,EUR,GBP,HKD,HUF,IDR,ILS,INR,JPY,KRW,MYR,MXN,NOK,NZD,PHP,PLN,RUB,SEK,SGD,THB,TRY,TWD,USD,VND,ZAR
 
 
 
If you are using a different currency in Beds24 select one of the above and use the price multiplier.
 
 
 
'''To check which prices are sent to Aribnb click on "View Actual Data".'''
 
 
 
====Price Multiplier====
 
If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number in the "Price Multiplier" field in SETTINGS-CHANNEL MANAGER->AIRBNB.
 
 
 
The multiplier applies to all prices and fees which are sent.
 
 
 
For example  '''*1.23''' will multiply all prices by 1.23 (i.e. raised by 23%).
 
Lower prices can be sent with a multiplier less than 1, i.e. '''*0.85''' will send a price 85% of the normal price (i.e. lowered by 15%)
 
 
 
To convert the price of bookings imported add a * after the multiplier, for example '''*1.23*''' will divide the price of the booking by 1.23.
 
 
 
You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
 
 
 
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
 
 
 
===House Rules and Children===
 
*Airbnb counts children  2-12 years as guests.
 
*Infants from 0-2 years are not counted as guests. 
 
 
 
By default children are allowed.
 
 
 
To disallow children and/or infants use the feature codes for children not allowed/infants not allowed or adults only.
 
 
 
If you do not allow children and/or infants Airbnb requires a textual explanation. You can add this in
 
SETTINGS-> CHANNEL MANAGER-> AIRBNB.COM-> SPECIFIC CONTENT "Custom".  [[Setting/custom|More information]].
 
 
 
For house rules you can  optionally add a textual description. The house rules plus (if you want to send) their descriptions can be entered in SETTINGS-> CHANNEL MANAGER-> AIRBNB.COM-> SPECIFIC CONTENT "Custom".  [[Setting/custom|More information]].
 
 
 
{| class="wikitable"
 
| '''Rule''' || '''Description''' 
 
|-
 
| REQUIRESSTAIRS || Must climb stairs. Describe the stairs (for example, how many flights).
 
|-
 
| POTENTIALNOISE || Potential for noise. Describe the noise and when it’s likely to take place.
 
|-
 
| LIMITEDPARKING || No parking on property. Describe the parking situation around the listing.
 
|-
 
| SHAREDSPACES || Some spaces are shared. Describe the spaces the guests will share.
 
|-
 
| LIMITEDAMENITIES || Amenity limitations. Describe an amenity or service that’s limited, such as weak wifi or limited hot water.
 
|-
 
| SURVEILLANCE|| Surveillance or recording devices on property. Describe any device that records or sends video, audio, or still images. Specify each device’s location and whether it will be on or off.
 
|-
 
| WEAPONS || Weapons on property. Describe any weapons (firearms, airguns, tasers, etc.), their location, and how they’re secured.
 
|-
 
| ANIMALS || Dangerous animals on property. Describe any domesticated or wild animals that could be a health or safety risk to guests or other animals.
 
 
 
|-
 
| HASPETS || Pet(s) live on property. Describe the pets.
 
 
 
|}
 
 
 
===Registration/License/Permit Id===
 
 
 
In some locations Airbnb.com require the License/Registration number of the owner.
 
 
 
If this is required for your property, please go to SETTINGS->CHANNEL MANAGER-->PROPERTY CONTENT-> PERMIT ID and enter your details.
 
 
 
=== Activate Connection ===
 
The Airbnb XML connection supports room types with a quantity of more than one . You can not use "House or Villa or Cottage" as property type if you want to send a quantity of more than one.
 
 
 
The name sent  is: 
 
*For properties with one unit: property name
 
*For properties with more than one unit type it consists of  property name - room name.
 
 
 
The content is sent in the language which is activated as default language for the booking page in SETTINGS->BOOKING PAGE->INTERNATIONALIZATION.
 
 
 
If you do not provide all obligatory information Airbnb will not accept your listing.
 
 
 
Go to SETTINGS->CHANNEL MANAGER->AIRBNB XML ->VIEW CONTENT or click on the "View content sent to Airbnb" link. Any settings which do not meet Airbnbs requirements are highlighted on red. Click on the links in the "Settings" column to go to the settings where you can fix the problems.
 
 
 
As far as possible existing fields are sent to Airbnb. Unique information for Airbnb can be entered in SETTINGS CHANNEL MANAGER->AIRBNB XML -> SPECIFIC CONTENT.
 
 
 
*If you have activated "Smart Pricing" in Airbnb make sure you deactivate it.
 
 
 
*If you want to not allow channel modifications by default you can change the setting for "Allow Channel Modifications" value" in SETTINGS->CHANNEL MANAGER.
 
==== If you have existing listings on Airbnb====
 
If you have existing (manually created) listings on Airbnb that you now want to manage through Beds24, you will need to map (merge) them to keep existing content and reviews, and to avoid creating duplicates.
 
 
 
#Tick the check box for "Enabled" and SAVE.
 
#Click on the "Connect" button next to the listing you want to connect the room to .
 
#Choose the "Sync Type".
 
a) "Full Sync" means your existing listings descriptive content will be overridden by the descriptive content in Beds24 and can no longer be edited in Airbnb.
 
 
 
If you want a full sync your listing needs to meet Airbnbs requirements. If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button.  Any settings which do not meet Airbnbs requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.
 
 
 
b)"Limited Sync" means your content will remain in your Airbnb listing and only the calendar and prices are updated.
 
 
 
By default the payout amount is imported into the "Invoice" tab of new bookings.  After you have chosen your sync option you can change this option in SETTINGS-CHANNEL MANAGER "Invoice" = Booking Amount if you want to import the amount the guest pays. If you use this option the lodging amount and cleaning fee will be shown separately.
 
 
 
==== If you don’t have existing listings on Airbnb====
 
Any new isting that you create through Beds24 must be compliant with [https://www.airbnb.com/help/article/2350/what-are-the-policies-for-listings-created-through-api-connected-software Airbnbs API program policies].
 
 
 
If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button.  Any settings which do not meet Airbnbs requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.
 
 
 
<embedvideo service="youtube">http://www.youtube.com/watch?v=niyApC_mNBk</embedvideo>
 
 
 
When your listing meets Airbnbs requirements:
 
#Tick the check box for "Enabled" and SAVE.
 
#Click on the "Connect" button.
 
#Click on "Create new listing in Airbnb". 
 
 
 
By default the payout amount is imported into the "Invoice" tab of new bookings.  After you have choosen your sync option you can change this option in SETTINGS-CHANNEL MANAGER "Invoice" = Booking Amount if you want to import the amount the guest pays. If you use this option the lodging amount and cleaning fee will be shown separately.
 
 
 
====Review and Publishing process at Airbnb====
 
Connecting to an existing lisitng or creating a new listing  triggers Airbnb's automated review. The review validates the listing against the [https://www.airbnb.com/help/article/2350/what-are-the-policies-for-listings-created-through-api-connected-software API Program Listing Requirements].
 
 
 
Click on "Get Update Status" to see the status at Airbnb.
 
 
 
If the listing is rejected, the message you see there tells you the reason. Fix the problem and the click "Update" to resubmit the listing.
 
 
 
Some listings require manual approval, in which case the status will remain as "ready for review". Once these listings are reviewed by Airbnb, you will see the result when you click on "Get Update Status" .
 
 
 
Once Airbnb has approved the listing one of three things will occur.
 
 
 
*If the sync type was set to "full sync" it will automatically be published.
 
*If the synctype is  empty  ("undecided" - meaning you have not selected a sync option in Beds24) and you have no existing listings on Airbnb that are not API-connected, then the new listing will automatically be published. The sync category will be set to Everything (i.e. "full sync").
 
*If the synctype is  empty  ("undecided" - meaning you have not selected a sync option in Beds24) and you have existing listings on Airbnb that are not API-connected, the you must go to the sync page in Airbnb to ensure a duplicate listing is not created when publishing.
 
 
 
If after some time you still see  "Your listings are almost ready" after clickin Beds24 Channel Manager Sync"  in Airbnb and see "In progress" on the "Listings" page check that  "Publish = Yes is set in  SETTINGS-> CHANNEL MANAGER-> AIRBNB XML-> SPECIAL CONTENT.
 
 
 
Note: If you want to connect what Airbnb calls  "traditional hospitality" (hotel, boutique hotel, guest house, B&B, Aparthotel, Resort) a special team at Airbnb might need to approve your listings. You can contact them at hospitality@airbnb.com.
 
 
 
<div style="display:none">
 
Merge a listing in Airbnb
 
If you have published a new listing from Beds24 instead of connecting it to an extisting listing in  Beds24 you need to merge them in your Airbnb extranet to prevent duplicate listings:
 
 
 
 
 
'''Step 1''': Login into Airbnb and  to Host and then "Your listings". Any listings that you have imported from your Beds24  will display as "Ready to publish".
 
 
 
'''Step 2''': Select the existing Airbnb listing you want to merge from the drop-down in the second column.
 
 
 
'''Step 3''': Select your sync setting for the merged listings from the drop-down (either Limited or Everything).
 
 
 
'''Step 4''': Publish your merged listings individually or in bulk.
 
</div>
 
 
 
==== Change the sync type  ====
 
If you want to change the sync type you need to do this in your Aribnb account.
 
 
 
'''Step 1''': Login into Airbnb and  to Host and then "Your listings".
 
 
 
'''Step 2''': Click on "Beds24 Channel Manager Sync" button at the top of the page
 
 
 
'''Step 3''': Select the appropriate tab to find the listings you want to change.
 
 
 
'''Step 4''': Look for the Sync settings column. From the dropdown menu next to each listing, change from Everything to Limited.
 
 
 
== Disconnect or Delete a listing from Airbnb ==
 
=== Delete  a listing ===
 
Go to  SETTINGS->CHANNEL MANAGER->AIRBNB XML -> and click on "View all listings". Then click on "Disconnect listing". This will delete the listing in Airbnb.
 
 
 
Note: Deleting a listing might not work if you have bookings and/or reviews.
 
 
 
===  Unpublish a listing from Airbnb to not offer the room ===
 
Go to SETTINGS->CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT and set "Publish" = No (and save). Then go back to SETTINGS->CHANNEL MANAGER->AIRBNB XML -> and click "Update".
 
 
 
=== Stop the sync to manually manage the listing in Airbnb ===
 
Go to  SETTINGS->CHANNEL MANAGER->AIRBNB XML -> and click on "View all listings". Then click on "Stop Sync". This will delete the connection between  Airbnb and Beds24.
 
 
 
Note: You cannot reverse a stop sync. Do not stop the sync in Airbnb if you want to update a listing from Beds24. Stopping the sync converts the listing to a "manual" listing which can not be updated from Beds24. If you want  to resume managing the listing through Beds24, you must connect to the listing again.
 
 
 
=== Remove Import Id===
 
If you need to remove the Import Id go to SETTINGS->CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT  and then add &delete=show to the end of the URL in your browser and hit the enter key to refresh the page, it will now show the Delete  button and allow you to delete the Airbnb Import Id and Airbnb Listing Id so you can reconnect the room.
 
 
 
=== Disconnect Airbnb Account ===
 
After all listings have been deleted you can disconnect from the Airbnb account you are connected to. Click on "View all listings" then click "Disconnect".
 
 
 
If you have connected to the wrong Airbnb account and it contains listings you do not want to delete, Click on "View all listings" and then add '''&allowdisconnect''' to the end of the URL in your browser and hit the enter key to refresh the page, it will now show the Disconnect button and allow you to disconnect.
 
 
 
If you have deleted your properties Beds24 cannot access your connection any more. Log into your Airbnb account and go to ACCOUNT SETTINGS->CONNECTED APP and remove the Beds24 app.
 
If this does not work do the following to recover:
 
1. Go to SETTINGS-PROPERTIES. Add a property.
 
2. Go to SETTINGS-PROPERTIES-ROOMS. Add a room.
 
3. Go to SETTINGS-CHANNEL MANAGER-AIRBNB XML and connect to your Airbnb account.
 
4. Then click on "View Listings in Account" and there on "Disconnect".
 
 
 
== Update information sent to Airbnb ==
 
*Airbnb will update their displayed calendar multiple times per day. But Airbnb will check real time availability before accepting a booking. This ensures that your latest availability will be applied.
 
*Bookings and booking modifications or cancellations will import instantly
 
*Price changes will be sent with the next update. To immediately push them through click "Update Airbnb"
 
*To send other changes to Airbnb click "Update Airbnb" to push changes in your listing to Airbnb.
 
 
 
Note: If you change pictures make sure you change the caption so Airbnb recognizes the new picture.
 
 
 
== Troubleshooting and common errors ==
 
'''Listing was published into the wrong Airbnb Account'''
 
Click on "View listings in account" and then add &allowdisconnect to the end of the URL in your browser and hit the enter key to refresh the page, it will now show the Disconnect button and allow you to disconnect.
 
 
 
'''Your listings are almost ready'''
 
If after some time you still see  "Your listings are almost ready" after clickin Beds24 Channel Manager Sync"  in Airbnb and see "In progress" on the "Listings" page check that  "Publish = Yes is set in  SETTINGS-> CHANNEL MANAGER-> AIRBNB XML-> SPECIAL CONTENT.
 
 
 
'''Listing failed to import'''
 
Click on "View Listings in Account" and click on "Delete from Airbnb". Fix content errors. Then go back an publish the listing again.
 
 
 
'''document_uri has already been taken.'''
 
You see this error if you have previously connected the room to another Airbnbn account. Log into this Airbnb account and stop the sync for this lisitng. If you can not do this send us a support ticket asking us to delete the URI from the endpoint.
 
 
 
'''The document has no document element'''
 
Check if the listing has been deleted in Airbnb. If so contact Airbnb support and ask them to reinstate the listing.
 
 
 
'''Lat/lng outside of hosting country'''
 
Check the country under which you have registered your Airbnb account is the same as the country your property is in.
 
 
 
'''Sorry, please contact support if you need to change the market of your listing.'''
 
Check your settings for "Latitude" and "Longitude" are correct and match the address you have given. If required correct your data and then click "Update Airbnb". If the error message persists contact Airbnb support.  Give them the error message your coordinates and your address and ask them to fix the problem at their end.
 
 
 
'''The listing is in a prohibited vacation rental market. Please go to Airbnb to fix these issues.'''
 
  Your listings is in an area for which Airbnb does not allow the use of the XML connection. Contact Airbnb support and ask them to fill out the "Market Clearance Requests for Policy Form". This will the go the the department which can lift the restriction.
 
 
 
'''Listing is classified not suitable for children'''
 
Airbnb explains [https://www.airbnb.com/help/article/1348/if-i-specify-that-my-listing-is-safe-or-suitable-for-children--what-should-i-know here] how to specify that your listing is safe or suitable for children.
 
 
 
'''You have reached your Airbnb access quota'''
 
Wait ten minutes and then try again. If it continues repeatedly let us know.
 
 
 
'''Too many redirects'''
 
Most likely you are using external pictures which do not link directly to your pictures or which redirect to another page.  Using links to their storage place is not possible. You need to use direct links to your pictures.
 
 
 
'''You do not have permission to access this resource'''
 
  This listing is not in the connected Airbnb account. Send us a support ticket.
 
 
 
 
'''Last Error: Airbnb error code = 404: record_not_found - Unfortunately, this is no longer available.'''
 
Your listing has either been deleted from Airbnb or the sync was stopped which converts the listing to a manual listing. If you have deleted the listing in Airbnb please contact Airbnb support and ask them if they can reinstate the listing. If you have not deleted the listing in Airbnb remove the token as explained above. 
 
 
 
 
 
'''There was an error processing the request. Hosting model validation error'''
 
For some regions the payout method needs to be set up before publishing the listing. Please log into your Airbnb account and set up the payout method.
 
 
 
'''Last Error: [400] Error ID: XXXXXXXXX. There was an error processing the request. Your daily price is too low. The minimum is 13$'''
 
Go to Settings  >  Channel Manager  > Property Content  > Room Content and set a Rack Rate of at least 9€.
 
 
 
'''Last Error: [400] Error ID: XXXXXXXXX. There was an error processing the request. Please use a base price of at least €9 but no more than €21,467.
 
Go to Settings  >  Channel Manager  > Property Content  > Room Content and set a Rack Rate of at least 9€.
 
 
 
'''Smart Pricing was not deactivated before connecting'''
 
If you forgot to deactivate smart pricing before setting the connection up you can do so from your mobile.
 
 
 
'''"The listing is subject to city registration. Please submit an application or input existing registration details"'''
 
Airbnb require you to register your permit ID, usually they will provide a link to a page inside the Airbnb system to do this, if you are unsure please ask Airbnb how to register.  Also make sure you have entered your Permit Id into Beds24.
 
 
 
'''No "Update Airbnb" button'''
 
If  you do not see an "Update Airbnb" button the connection is lost.  Click the "Connect to Airbnb" Button. After the connection is restored you will see the update button.
 
 
 
'''Access denied to Airbnb'''
 
Airbnb's server is currently unavailable. Try again later.
 
 
 
==Content==
 
=== Define Bedrooms and Bathrooms===
 
Bedrooms and bathrooms are configured by feature codes which are entered in the "Features" field.
 
 
 
They can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
 
 
 
Criteria which apply to all rooms in the property should be set up with the property. They will be automatically applied to all rooms in the property.
 
 
 
Criteria which only applies to one room should be entered in the room.
 
 
 
Make sure you do not create duplicates.
 
 
 
 
 
'''Example 1:'''
 
All units (rooms) have one bedroom and one bathroom.
 
 
 
In this case you can set up the bedroom and bathroom in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to all room/units.
 
 
 
'''Example 2:'''
 
 
 
You have one unit with one bedroom and another unit with two bedrooms. In this case set the bedrooms up in SETTING->PROPERTIES->ROOMS->SET UP.
 
 
 
*Click on the "Edit " button next to the "Feature" field.
 
*In the pop up click on "Bedroom tab" or "Bathroom tab".
 
*Set the type and use the selectors to define the features within each room.
 
 
 
*If you have multiple bedrooms or bathrooms make sure you define them all.
 
 
 
*If you have more than 2 rooms click "Close" and SAVE. The system will then automatically add more rooms when you click on the "Edit" button again.
 
*Close the pop up and then press SAVE.
 
 
 
Requirements from Airbnb:
 
*Studio apartments should have 1 bedroom.
 
*Any properties with more than 10 bedrooms must be listed as having “10 bedrooms.” On the front end this will appear as “10+ bedrooms.”
 
 
 
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
 
 
 
Note: Airbnb does not support all available features available in Beds24.
 
 
 
BATHROOM
 
 
 
BATHROOM_FULL
 
 
 
BATHROOM_HALF
 
 
 
BEDROOM
 
 
 
BED_KING
 
 
 
BED_QUEEN
 
 
 
BED_DOUBLE
 
 
 
BED_SINGLE
 
 
 
BED_SOFA
 
 
 
BEDFUTON
 
 
 
BED_FLOOR_MATTRESS
 
 
 
BED_BUNK
 
 
 
BED_TODDLER
 
 
 
BED_CRIB
 
 
 
BED_HAMMOCK
 
 
 
BED_AIR MATTRESS
 
 
 
BED_COUCH
 
 
 
BEDROOM_LIVING_SLEEPING_COMBO
 
 
 
BEDROOM_OTHER_SLEEPING_AREA
 
 
 
If you have a murphy bed it will send as single bed.
 
 
 
=== Set up Airbnb specific content ===
 
Go to SETTINGS->CHANNEL MANAGER->AIRBNB XML ->SPECIFIC CONTENT or click on the "Edit specific content for Airbnb" link to check and customise specific content for Airbnb.
 
 
 
Requirements and limitations from Airbnb:
 
*Phone numbers, email addresses and URLs are not allowed in the host profile.
 
*No internal housing codes in the Name.
 
*Descriptions must be unique and well written, paragraph breaks and spacing should be used. Content in ALL CAPS will lead to a listing’s rejection.
 
*France Only: Bed & Breakfast listings should have B&B in the title.
 
 
 
=== Amenities ===
 
'''Airbnb requires at least 5 amenities.'''
 
 
 
They can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
 
 
 
Criteria which apply to all rooms in the property should be set up with the property. They will be automatically applied to all rooms in the property.
 
 
 
Criteria which only applies to one room should be entered in the room.
 
 
 
Make sure you do not create duplicates.
 
 
 
 
 
Example 1: All units (rooms) have Wifi. In this case you can set up the Wifi in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to all room/units.
 
 
 
Example 2: You have one unit with Wifi and another unit without Wifi. In this case set the Wifi up in SETTING->PROPERTIES->ROOMS->SET UP.
 
 
 
Amenities are configured by feature codes which are entered in the "Features" field. 
 
 
 
*Click on the "Edit " button next to the "Features" field.
 
*In the pop up click on "Amenities".
 
*Tick the amenities you provide.
 
*Close the pop up and then press SAVE.
 
 
 
If you provide '''"Essentials"''' you will need to tick "linen", towels and "toiletries".
 
 
 
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
 
 
 
Note: If you do not select  select child friendly amenities Airbnb might classify your listing as "Not safe or suitable for children (0-12 years)"
 
 
 
Note: Airbnb does not support all available feature codes. Make sure you pick five features which are supported by Airbnb.
 
 
 
===Pictures===
 
In SETTINGS->CHANNEL MANAGER->AIRBNB XML -> SPECIFIC CONTENT you can set which pictures are sent.
 
 
 
Double check you have entered "Captions" for every picture.
 
 
 
Requirements and limitations from Airbnb:
 
*Airbnb requreis a '''minimum of 7 pictures per listing'''.
 
*Bedrooms should be included in the photos so that users are able to see accommodations.
 
*Listings with stock photos or with photos including non Airbnb watermarks will be rejected.
 
*Listings with photos containing contact information (email addresses / phone numbers) will be rejected.
 
 
 
Note: If you change pictures make sure you change the caption so Airbnb recognizes the new picture.
 
 
 
 
 
=== Check-in ===
 
Choose 6:00 if your check-in is flexible.
 
 
 
If your check-in starts at a certain time and the end is flexible set check-in ends to the same time or earlier than check-in starts.  This will work with all times except for  01:00 and 02:00 in the morning.
 
 
 
=== All feature codes  ===
 
You can also manually add bedrooms and bathrooms and amenities typing the feature codes exactly as listed below into the "Features" field.
 
 
 
Example:  One bedroom with a double bed and a crib
 
BEDROOM BED_DOUBLE BED_CRIB
 
 
 
Example: The property has 2 bathrooms one full and one half
 
BATHROOM_FULL
 
BATHROOM_HALF
 
 
 
Add feature codes one for each feature separated by spaces.
 
 
 
Example: A property has a kitchen, television and internet
 
KITCHEN TELEVISION INTERNET
 
 
 
 
 
Note: Airbnb does not support all available feature codes and there are also Airbnb specific features which can be manually added in the "features" settings.  These feature codes are supported:
 
 
 
KITCHEN
 
 
 
INTERNET
 
 
 
TV
 
 
 
TOILETRIES
 
 
 
SHAMPOO
 
 
 
LINEN (is sent in combination with "toiletries" as "Essentials")
 
 
 
HEATING
 
 
 
AIR_CONDITIONING
 
 
 
WASHER
 
 
 
DRYER
 
 
 
COFFEE_MAKER
 
 
 
DISHES_UTENSILS
 
 
 
SPICES  (is sent in combination with "DISHES_UTENSILS" as "Cooking Basics")
 
 
DISHWASHER
 
 
 
OVEN
 
 
 
STOVE
 
 
 
REFRIGERATOR
 
 
 
BALCONY
 
 
 
GARDEN
 
 
 
GRILL
 
 
 
PARKING
 
 
 
WIFI
 
 
 
CABLE
 
 
 
BREAKFAST_INCLUDED
 
 
 
PETS_CONSIDERED
 
 
 
ADULTS_ONLY
 
 
 
CHILDREN_NOT_ALLOWED
 
 
 
INFANTS_NOT_ALLOWED
 
 
 
EVENTS_ALLOWED
 
 
 
SMOKING_ALLOWED
 
 
 
FIREPLACE
 
 
 
DOORBELL
 
 
 
DOORMAN
 
 
 
RECEPTION_24HOUR
 
 
 
HANGERS
 
 
 
FIRE_EXTINGUISHER
 
 
 
FIRST_AID_KIT
 
 
 
LAPTOP_FRIENDLY
 
 
 
SAFETY_CARD
 
 
 
HOT_TUB
 
 
 
GYM
 
 
 
SMOKE_DETECTOR
 
 
 
CO_DETECTOR
 
 
 
POOL
 
 
 
POOL_HEATED
 
 
 
POOL_INDOOR
 
 
 
POOL_PRIVATE
 
 
 
IRON_BOARD
 
 
 
HAIR_DRYER
 
 
 
BEACH_FRONT
 
 
 
LAKE
 
 
 
WATER_VIEW
 
 
 
SKI_IN
 
 
 
SKI_OUT
 
 
 
LONG_TERM_RENTER
 
 
BED_KING
 
 
 
BED_QUEEN
 
 
 
BED_DOUBLE
 
 
 
BED_SINGLE
 
 
 
BED_SOFA
 
 
 
BED_FUTON
 
 
 
BED_FLOOR_MATTRESS
 
 
 
BED_BUNK
 
 
 
BED_TODDLER
 
 
 
BED_CRIB
 
 
 
BED_HAMMOCK
 
 
 
BED_AIR_MATTRESS
 
 
 
BED_COUCH
 
 
 
BEDROOM
 
 
 
BEDROOM_LIVING_SLEEPING_COMBO
 
 
 
BEDROOM_OTHER_SLEEPING_AREA
 
 
 
BATHROOM
 
 
 
BATHROOM_FULL
 
 
 
BATHROOM_HALF
 
 
 
ROOM_DARKENING_SHADES
 
 
 
CHANGING_TABLE
 
 
 
BABY_BATH
 
 
 
PACK_N_PLAY_TRAVEL_CRIB
 
 
 
BEACH_ESSENTIALS
 
 
 
PARKING_DISABLED
 
 
 
EV_CHARGER
 
 
 
FIREPLACE_GUARD
 
 
 
BABY_MONITOR
 
 
 
OUTLET_COVERS
 
 
 
STAIR_GATES
 
 
 
TABLE_CORNER_GUARDS
 
 
 
WINDOW_GUARDS
 
 
 
CHILDRENS_DINNERWARE
 
 
 
BABYSITTER_RECOMMENDATIONS
 
 
 
LUGGAGE_DROPOFF
 
 
 
CLEANING_BEFORE_CHECKOUT
 
 
 
STEP_FREE_ACCESS_BATHROOM
 
 
 
GRAB_RAILS_IN_SHOWER
 
 
 
GRAB_RAILS_IN_TOILET
 
 
 
ACCESSIBLE_HEIGHT_TOILET
 
 
 
ROLLIN_SHOWER
 
 
 
SHOWER_CHAIR
 
 
 
WIDE_DOORWAY_BATHROOM
 
 
 
TUB_WITH_SHOWER_BENCH
 
 
 
WIDE_CLEARANCE_TO_SHOWER_AND_TOILET
 
 
 
HANDHELD_SHOWER_HEAD
 
 
 
STEP_FEE_ACCESS_BEDROOM
 
 
 
WIDE_CLEARANCE_TO_BED
 
 
 
WIDE_DOORWAY_BEDROOM
 
 
 
ACCESSIBLE_HEIGHT_BED
 
 
 
SINGLE_LEVEL_HOME
 
 
 
COMMON_SPACE_STEP_FREE_ACCESS
 
 
 
COMMON_SPACE_WIDE_DOORWAY
 
 
 
WIDE_HALLWAY_CLEARANCE
 
 
 
HOME_STEP_FREE_ACCESS
 
 
 
PATH_TO_ENTRANCE_LIT_AT_NIGHT
 
 
 
HOME_WIDE_DOORWAY
 
 
 
FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR
 
 
 
== Notes ==
 
Changes of inventory are pushed  instantly. Price changes and content changes are sent with the next update. To push price changes immediately  press the "Update" buttons.
 
 
 
Channel collect payments will be shown in the booking invoice if SETTINGS->CHANNEL MANAGER -> “Import Channel Collect Payments”  is set to “Yes”.
 
 
 
=== Qualified listing===
 
*is located in designated “green” regions according to last Airbnb’s API Listing Approvals Regional Guidelines ,
 
*the named host has an email address that has been verified through the Airbnb platform,
 
*the named host has a telephone number that has been verified through the Airbnb Platform,
 
*the listing has not less than ten (10) high-resolution photographs in accordance with the Airbnb photo guidelines (file size not less than 45 kb each) of the space without logos or watermarks of the listing is in one or multiple language(s) supported by Airbnb’s API (e.g. English, German, French etc.) and the listing description is formatted properly for the Airbnb Platform including amenities and in each language is at least 150 words long,
 
*the listing is an active and instant bookable listing on the Airbnb Platform,
 
*he host has a description that is at least fifteen (15) words long,
 
*the host has a profile picture,
 
*the host has set up a functional payout method, and
 
*the host has been directly verified by Airbnb as a host.
 
 
 
These requirements from Airbnb may be subject to change.
 
 
 
== FAQ==
 
===Who can use the XML interface?===
 
Almost all customers can use the XML. Your Airbnb market manager (vr@airbnb.com) can give you more information on Airbnb`s policies and restrictions.
 
 
 
=== Can I import a listing from Airbnb to Beds24?===
 
Yes. The process is explained above. 
 
 
 
===What is the difference between the XML interface and the iCal interface?===
 
Main differences are the update speed and the transferred data. iCal updates can take up to 24 hours. Changes via the XML are applied within a minute.
 
 
 
The XML interface can:
 
*Create listings
 
*Send content and update content
 
*Send pictures
 
*Automatically send availability to Airbnb
 
*Send prices from Beds24 to Airbnb
 
*Import bookings (including number of guests, Email address, price), modifications and cancellations from Airbnb
 
 
 
The iCal interface can  only export inventory and import bookings (without price and number of guests) , booking modifications and booking cancellations.
 
 
 
===I am already listed with Airbnb. Can I connect it?===
 
Yes. You can connect an existing Airbnb account.
 
 
 
===Can I still use Ical?===
 
Of course, you can use iCal or XML but not both for the same room (remember that iCal has delays and does not transfer prices or detailed booking information).
 
 
 
===Can I accept requests?===
 
No. The XML interface support only instant booking.
 
 
 
=== Can I connect more than one Airbnb account? ===
 
One Beds24 account connects with one Airbnb account, if you manage multiple Airbnb accounts, create sub accounts for each with the respective properties in Beds24. You can create subaccounts via SUB ACCOUNT (top right).
 
 
 
===Can I send special prices to Airbnb?===
 
Yes. This [[Setting_Prices_for_Booking_Channels|tutorial]] explains how to do this.
 
 
 
===If I have a room type with 6 units (i.e. 6 double rooms) do I need a listing for each room?===
 
No. Airbnb supports room types.
 
 
 
=== Will I receive notifications on new bookings or changes?===
 
Airbnb will send you a notification for new bookings.
 
 
 
=== Do guests receive a confirmation? ===
 
The channel confirms the booking with the guest. Beds24 will not sent a confirmation message. If you want to send one as well you can set up an Auto Action Email.
 
 
 
=== Do I have to confirm bookings?===
 
All listings managed via XML are activated for instant booking meaning all bookings are confirmed. You have the option to cancel bookings if required in the Airbnb extranet.
 
 
 
=== How can I communicate with guests?===
 
Exchange of information will be done directly in the Airbnb account. Beds24 can send Auto Emails to guests.  Guest will receive these  their  Airbnb Email address. You will see these in your outging EMail folder.
 
 
 
=== How will I get paid?===
 
The channel charges the guest and pays you via bank transfer or Paypal.
 
 
 
=== Can guests modify bookings?===
 
If a guest modifies a booking you will receive an Email from Airbnb. If you agree to the modification Beds24 will import the modification.
 
 
 
=== Can agencies use the XML Interface===
 
Yes. All properties in one Beds24 account or subaccount can be connected to the same Airbnb account. If required you can set up multiple sub accounts. If you work with multiple Airbnb accounts make sure you are always logged into the right account.
 
 
 
Connecting two different accounts or sub accounts to the same Airbnb account is not possible.
 
 
 
===Can I send several languages?===
 
No.  The content is sent in the language which is activated as default language for the booking page. Airbnb will do the translation.
 

Latest revision as of 01:33, 19 May 2021

Redirect to: