Beds24 Wiki - User contributions [en]

Category:Payments

2026-03-08T19:14:13Z

IuriRosa: /* Using Stripe */

[[Category:Daily_Use]]
[[Category:Bookings]]
[[Category:Rules]]
[[Category:Guest_Management]]
[[Category:Automation]]
[[Category:Getting_Started]]
<div class="heading">Payments from guests</div>
This page is about the menu {{#fas:cog}} (SETTINGS) PAYMENTS

__TOC__
=Summary=
<div class="summarybox">
You can '''collect payments for direct bookings at the time of the booking''' or '''send payment requests for completed bookings'''. To do so you need to activate at least one of these payment options:
*Connect one of the integrated payment processors: '''Stripe, Paypal, Authorize.Net, globalpayments, asiapay, pesopay, siampay, paydollar, Borgun, Bitpay'''. Payments collected via an integrated payment processor will be listed in the booking.
*Credit Card Collection to only collect credit card details but not charge the card. You charge the card manually using our own service. Payments need to be entered manually to the booking.
*Offline Payments (Custom Instruction) if you require a bank transfer. Payments need to be entered manually to the booking.

'''Stripe is recommended and offers the best functionality.''' If you use Stripe you can '''automatically charge guest credit cards or virtual cards submitted from OTAs"'.
</div>
== Payment Options==
=== Integrated Payment Gateways===
The funds are deposited directly to your account. Beds24 will be notified about the payment and you will see the amount in the "Charges and Payments" tab of the booking.

You will need an account at the payment gateway you want to use. Please contact the payment gateway of your choice for details of their fees and charges.

Integrated Payment gateways are:
*[[Stripe]]- credit card payments. Stripe offers the best functionality including the option to '''automatically charge pending payments''', automatically charge virtual cards from OTAs and manually charge a card directly from the booking. [https://stripe.com Register here for a Stripe account].
*[[Authorize.Net]] - credit cards payments. [https://ems.authorize.net/oap/home.aspx?SalesRepID=98&ResellerID=24094 Register here for an Authorize.Net account].
*[[Realex]] - credit card payments. [http://www.realexpayments.ie/business-offering Register here for a Realex account].
*[[Bitpay]] - bitcoin payments. [https://bitpay.com/ Register here for a Bitpay account].
*[[Paypal]] - Paypal and credit card payments.

To connect your payment gateway go to {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > STRIPE/PAYPAL...

=== Custom Gateway ===
If you do not want to use one of the integrated payment gateways you have the option to set up a connection to an external payment gateway. To set a connection up you will need HTML and programming skills or hire a developer.

=== Credit Card Collection ===
This option will allow you to securely collect credit card details without the card being charged. If you want to charge the card you can do this via your bank or merchant account. Beds24 will not be notified about the payment so you will need to enter it manually into the "Charges and Payments" tab of the booking.

[[Image:card_deposit.png|450px|link=]]
[[Media:card_deposit.png|view large]]

If leaving credit card details is the only option you want to give to your guests go to {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > CREDIT CARD and use the [[Card_Number_Collection|Credit Card Collection help page]].

=== Offline Payments (Custom Instruction) ===
You can ask your guests to make a bank transfer or send a cheque. Beds24 will not be notified about the payment so you will need to enter it manually into the "Charges and Payments" tab of the booking.

'''If you use this method you will need to enter the payments manually in the "Charges and Payments" tab of the booking.'''

== Payments for Bookings from OTAs==
Some channels send credit card details. If you use [[Stripe]] as payment gateway you can choose to send credit cards supplied by all channels directly to Stripe. You will then be able to

*automatically charge virtual cards from OTAs when they become valid. To enable this option go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER and set "Channel Collect Payments" = Charges and Pending Payments. Then
go to the channel settings (for example {{#fas:cog}} (SETTINGS) CHANNEL MANAGER -> BOOKING.COM) and set "Auto Process Virtual Cards" = Yes and select the "Virtual Card Payment Rule", either Auto or if you have created a Payment Rule, then select your payment rule.

*charge a card manually from within the booking or in the Stripe extranet.

For details please see [[Stripe|Stripe help page]].

To collect payments from channels which do not provide credit card details or if you do not use Stripe you can send payment requests (see below).

== Create and manage pending payments ==
<div class="warning">{{#fas:exclamation-triangle}} The option to automatically collect pending payments is only available for customers who use [[Stripe]] via Stripe Connect ("Connect to Stripe" button). If you connected your Stripe account via keys please remove them and connect via the "Connect to Stripe" button.</div>

===Create pending payments===
Pending payments can either be
*added via an [[Auto_Actions#Add_a_pending_payment|Auto Action]]. The auto action will create the pending payment for the bookings which meet the trigger conditions.
*added manually on the "Charges and Payments" tab of the booking. For manually added pending payments you can choose to collect the payment automatically or manually.
*imported as virtual cards from an OTA. To import pending payments go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER and set "Channel Collect Payments" = Charges and Pending Payments. Then go to the channel settings (for example {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM) and set "Virtual Cards" = Yes

===Rules for pending payments===
In {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT RULES you can create rules and info codes for pending payments.

When the payment is due, the system checks whether the selected rule applies. If this is the case, the payment is triggered and then the selected info code is added to the "Info" tab of the booking.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> For Booking.com virtual cards you can set to adjust the charge automatically to the amount on the card. To do so create a rule with these settings:
*Funds Source: Virtual Card
*Payment value adjustment = choose any except for "None"

===Manage pending payments===
====Using Stripe====
Under "Pending Payments" on the "Charges and Payments tab of the booking you can:
*Schedule outstanding payments. Pending payments can be collected manually or automatically.
*For '''automatic charging''' set the "pending payment" to "auto" OR the Payment Rule you have created and enter a due date in the future. <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> The option to automatically collect pending payments is only available for customers who use [[Stripe]] via Stripe Connect ("Connect to Stripe" button).
*Manually collect a pending payment if the credit card has been sent to Stripe by clicking on the ... menu and then clicking on "charge now".

Successful collections will be moved from "Pending Payments" to "Payments".

After the payment was collected you will see a status information on the "Info" tab.

=====Stripe and Auto payment collections via Stripe - 30% deposit at booking OR 100% if check-in less than 30 Days =====

'''You need to setup STRIPE Payment Gateway to use the details below.'''

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
Step 1 - Setup Booking Rules
</div>
<div class="mw-collapsible-content">

Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE

*Normal Bookings - Booking Type = Confirmed with Deposit Payment 1- via payment gateway.

*Near term Bookings
**Days in Advance = 30
**Booking Type = Confirmed with Deposit Payment 2- via payment gateway
</div></div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

Step 2 - Setup Payment Collection
</div>
<div class="mw-collapsible-content">

Go to {{#fas:cog}} (SETTINGS) > BOOKING ENGINE > DEPOSIT COLLECTION DIRECT BOOKINGS
*Non Payment Booking Status = Request
*Deposit Payment 1 Percentage = 30%
*Deposit Payment 2 Percentage - 100%
</div></div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

Step 3 - Create Payment Rule
</div>
<div class="mw-collapsible-content">
{{#fas:cog}} (SETTINGS) PAYMENTS -> PAYMENT RULE

Create a Payment Rule to collect payments if bookings are not cancelled.

Payment Rule :
*Name = Enter your title - Not Cancelled (for example)
*Action = Auto

Payment Trigger :
*Booking Status = All not cancelled
*Any Booking Info Code = optional
*All Booking Info Codes = optional
*Exclude Booking Info Code = optional (can exclude Virtual Credit cards, find the Booking info code in the booking)

Payment Action :
*Funds Source = All
*Payment value adjustment = Default
*Capture = Yes - immediately charged (Capture=Yes)
*Add info code on success = add a Booking Info item to the booking on success
*Add info code on failure = add a Booking Info item to the booking on failure

Prevent Auto Payment :
*Prevent payment if booking status : Cancelled
*Prevent payment action : Set Manual (or Delete)
</div></div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
Step 4 - Create Auto Actions
</div>
<div class="mw-collapsible-content">

(Suggest 2 auto actions created, 1- add pending payment and 2 - send email to guest on successful collection of payment)

'''Add Pending payment to the booking to collect payment 30 days before arrival '''

{{#fas:cog}} (SETTINGS) GUEST MANAGEMENT> AUTO ACTIONS

'''Auto Action #1- collect balance 30 days before check-in'''
(This auto action will add a pending payment to your bookings with the payment date 30 days before check-in)

'''Trigger tab:'''

Time :
*Trigger Event = Booking
*Trigger Time = immediate

Booking Source:
*Booking Source =All (for example, you can also set different rules for different channels)

Booking Conditions:
*Invoice Balance = Not Zero

'''Invoice tab:'''

Add a Pending Payment to the booking
*Payment Type = Percent of balance due
*Description = the text you will see in the "Charges and Payments" tab (Payment Balance)
*Status = if you use the status function add the status you want to apply to the pending payment (optional)
*Amount = 100 (balance is full price so 100% of the balance)
*Payment Rule = Not Cancelled (setup in Step 3 above)
*Payment Due = check in -30

'''Auto Action #2 - Send email to guest to confirm receipt of payment'''

'''Trigger tab:'''

Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 365 day

Booking Conditions:
*Booking Status = All not cancelled
*Invoice Balance = Any Payment made OR Invoice Balance = Zero (payment in full)

'''Message tab''': For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message text :- Enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

You can use Invoice Template variables showing the booking charges/payments.
[INVOICETABLE] will show all of the Charges/Payments.

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

You can use Invoice Template variables showing the booking charges/payments.
[INVOICETABLE] will show all of the Charges/Payments.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you are using deposit collection make sure you set {{#fas:cog}} (SETTINGS) BOOKING ENGINE > DEPOSIT COLLECTION DIRECT BOOKINGS "Non Payment Booking Status" = Request.

</div>
</div>

===Without Stripe===
If you do not use Stripe you can use a pending payment
*As a reminder for yourself
*For reporting
*To send a payment request (see below)

Use an Auto Action to add a 'Manual' Pending Payment to the bookings based on your payment timetable. The Pending payment details can be used as a reminder with the Pending Payment Report in 'Bookings'.

The manual pending payment can be used as a reminder and if you use Bank Transfers as your payment option, then you can use the Pending Payment list (Bookings) to see the list of payments due, and set the Pending Payment as 'Paid' within the booking.

===Cancellations===
If you want to cancel a pending payment if the booking is cancelled you can use a payment rule which does not apply to cancelled bookings.

== Payment Request ==
A payment request can be sent to a guest at any time after booking either manually or automatically. The guest receives a link to a secure page where they can make their payment.

The link URL is in this format with at least the booking number specified https://beds24.com/bookpay.php?bookid=123456.
Additional parameters can be supplied in the URL to manage the options and amount for payment.

If you have activated Private Domain, you can use in the Payment link :- change https://beds24.com/bookpay.php?bookid=[BOOKID] to https://mydomain.com/bookpay.php?bookid=[BOOKID]

You can set up an Auto Action with a payment request. The guest can then make a payment through the payment option(s) you support. If you use one of the integrated payment gateways Beds24 will be notified about the payment and it will show in the "Charges and Payments" tab of the booking.

To use this option you need to activate at least one payment option {{#fas:cog}}(SETTINGS) PAYMENTS > PAYPAL/STRIPE...

You can show a custom message in header section of the payment request and in the confirmation which the guest sees after they have completed the payment. The settings are {{#fas:cog}}(SETTINGS) PAYMENTS " Payment Request Header" and "Payment Request Confirmation".

*Go to {{#fas:cog}}(SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS and create an Auto Action. A template is available which you can further customize. Use the context help (?Icons) in the Auto Action and on the help page (click on HELP in the top right menu) for further instructions.

In the "Messaging" tab click on "Edit" and enter your text.

You can use either template variables for a pre canned link (recommended) or create your own custom URL.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Payment links expire 28 days after check-out.

=== Using Template Variables===
*The template variable [PAYLINK] creates a payment link (HTML A tag) for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance.
*[PAYLINK:25%] -Creates a payment link (HTML A tag) for the payment request for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance.You can also use a percentage over 100% if you want to charge extra for example for credit card payments.
*[PAYLINK:200] - Creates a payment link (HTML A tag) for the payment request) for a fixed amount.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> [PAYLINK] will not work with your own URL. Use a link instead if you have activated the private lablel option and want the link to use your own domain.

*The template variable [PAYBUTTON] creates a payment button for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance.
*[PAYBUTTON:25%] - Creates a payment button for the payment request for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance. You can also use a percentage over 100% if you want to charge extra for example for credit card payments.
*[PAYBUTTON:200] - Creates a payment button for the payment request for a fixed amount.

*The template variable [PAYURL] creates a payment url for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance.
*[PAYURL:25%] - Creates a payment url for the payment request for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance. You can also use a percentage over 100% if you want to charge extra for example for credit card payments.
*[PAYURL:200] - Creates a payment url for the payment request url for a fixed amount.

*Add a H to exclude a gateway from displaying. Example: [PAYURL:200:HST] will hide Stripe

=== Using Request URL Parameters===
You can also use a direct link. The link uses the booking number and the requested amount.

For Auto Actions you can use the [BOOKID] template variable to automatically populate the bookid URL parameter:

https://beds24.com/bookpay.php?bookid=[BOOKID]

For custom Emails you can type the booking number in directly:

https://beds24.com/bookpay.php?bookid=1234567

The parameters below can be added to the URL to customize the behaviour of the payment request.

These are the parameters for the different payment options:

=====Parameters for different payment options=====
By default all payment gateways enabled for your booking page will show on the payment request page.

You can override which gateways are shown on the booking request page using the URL <code>&g=</code> and <code>&h=</code> parameters. You can specify multiple payment gateways comma separated for both the <code>&g=</code> and the <code>&h=</code> parameter.

The <code>&g=</code> parameter forces the gateway to be shown, the <code>&h=</code> forces the gateway to be hidden.

<code>an</code> AuthoizeNet

<code>bg</code> Borgun

<code>bp</code> Bitpay

<code>cc</code> credit card collection

<code>cg</code> Custom Gateway

<code>op</code> Offline Payment

<code>pm</code> Paymill

<code>pp</code> Paypal

<code>ra</code> Realex A

<code>rb</code> Realex B:

<code>st</code> - Stripe

Capture for Stripe:

<code>capture=0</code> do not capture payment

<code>capture=1</code> capture payment

Examples:

<code>https://beds24.com/bookpay.php?bookid=[BOOKID]&g=an</code> creates a payment link for Authorize.Net

<code>https://beds24.com/bookpay.php?bookid=1234567&g=st,pp</code> creates a payment link showing Stripe and Paypal

<code>https://beds24.com/bookpay.php?bookid=[BOOKID]&g=st&capture=0</code> creates a payment link for Stripe without capturing

<code>https://beds24.com/bookpay.php?bookid=1234567&h=cc</code> creates a payment link hiding credit card collection

=====Parameters to specify the amount to pay=====

If you do not specify an amount parameter the amount requested for individual booking is the outstanding balance. For group booking the outstanding balance of the group invoice will be requested.

<code>&pay=deposit</code> for a payment request collecting the amount from the "Deposit" field in the booking

<code>&pay=100</code> for a payment request for the specified amount (in this example 100)

<code>&pay=bookbalance</code> for a payment request collecting the outstanding balance for this booking <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If the booking is part of a group booking and there is no outstanding balance in this booking the value of the group balance will be requested.

<code>&pay=groupbalance</code> for a payment request collecting the outstanding balance for the group booking (the default)

<code>&pay=groupbalance&pc=25</code> pc can be used to specify a percentage of the pay amount, for example here 25% of the groupbalance will be collected.

<code>&pay=na</code> for a request to collect credit card details without showing an amount

Examples:

<code>https://beds24.com/bookpay.php?bookid=[BOOKID]&pay=70</code> creates a payment link requesting a payment of 70

===Payment Request without Payment Options Activated===
If you do not use one of the payment options you can set up an Auto Action with a Paypal payment request.
Click [[Send_Paypal_Payment_Request|here]] for instructions how to set this up.

==Request Guests to Submit Credit Card Details==
You can set up an Auto Action with a request to submit credit card details. Guests will be able to submit their card details on a secure form.

To use this option you need to
*activate credit card collection {{#fas:cog}} (SETTINGS) PAYMENTS > CREDIT CARD COLLECTION > CREDIT CARD
*set which credit cards you accept {{#fas:cog}} (SETTINGS) PAYMENTS > CREDIT CARD COLLECTION > CREDIT CARD RULES
*Go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS and create an Auto Action. Use the context help (?Icons) and the help page (click on HELP in the top right menu) for general instructions.

Template variables are used to link to the form.

In the "Email" tab click on "Edit" and enter your text. Template variables are used to specify the requested amount:

*The template variable [PAYLINK:NA:CC] creates link to the form where guest can securely enter their credit card details.
*The template variable [PAYURL:NA:CC] creates URL for the form where guest can securely enter their credit card details.
*The template variable [PAYBUTTON:NA:CC] creates button with a link to the form where guest can securely enter their credit card details.
*If you want to use custom text you can use an a link <a https://beds24.com/bookpay.php?bookid=[BOOKID]&g=cc&pay=na>Your text</a>

You can show a custom message in header section of the payment request and in the confirmation which the guest sees after they have entered their details. The settings are {{#fas:cog}}(SETTINGS) > PAYMENTS > PAYMENT COLLECTION " Payment Request Header" and "Payment Request Confirmation".

You can also use a direct link. The link uses the booking number plus the parameter &g=cc&pay=na

https://beds24.com/bookpay.php?bookid=1234567&g=cc&pay=na

https://beds24.com/bookpay.php?bookid=[BOOKID]&g=cc&pay=na

== Collect only Credit Card Details for Web Site Bookings ==
If you only want to securely collect credit card details without charging them go to {{#fas:cog}} (SETTINGS) PAYMENTS > CREDIT CARD COLLECTION. The guest will only be able to complete the booking if they leave their credit card details. The card processing must be handled manually by your bank or merchant account. You can find more information on the [[Card_Number_Collection|Credit Card Collection help page]].

Guests will be asked to enter their credit card details with their details.

[[Image:creditcard.jpg|400px|link=]]
[[Media:creditcard.jpg|view large]]

*Go to {{#fas:cog}}(SETTINGS) > BOOKING ENGINE > DEPOSIT COLLECTION DIRECT BOOKINGS and use these instructions if you want to
**automatically collect a deposit/payment though an integrated payment gateway.

*Go to {{#fas:cog}}(SETTINGS) > PAYMENTS and use these instructions if you want to
**require guests to make an offline payment (i.e. bank transfer).
**connect your own payment gateway.
**want to give guests the option to choose from two or more options (online deposit payment, offline payment, leave their credit card details)

After the guest clicked "Confirm Booking" they are directed to the payment screen.

[[Image:paymentgateway.png|500px|link=]]
[[Media:paymentgateway.png|view large]]

== Collect Deposits for Web Site Bookings ==
If you use this method the guest will not be able to complete the booking without making a payment.

'''Setup'''

'''Step 1.''' Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > DEPOSIT COLLECTION DIRECT BOOKINGS

*Set "Non Payment Booking Status". Failed or non payments can be set to leave the booking in either cancelled, inquiry or request status.
**'''Request''': When the guest clicks "Confirm Booking" the room gets reserved for the guest and will not be available for other guests to book. When they make a successful payment the status of the booking will automatically change to confirmed. If the payment is aborted or not successful the status of the room will still be blocked with the request status. You will then either need to change the status manually to cancelled or use an auto action to automatically change the status of Request bookings to Cancelled after a preset time. Auto Actions can be set up in {{#fas:cog}} (SETTINGS) > GUEST MANAGEMENT > AUTO ACTIONS.
NOTE : {{#fas:cog}} (SETTINGS) BOOKING ENGINE > REQUEST BOOKINGS - Do not block the room - this has been depreciated with the introduction of Inquiry status.
**'''Inquiry''': When the guest clicks "Confirm Booking" the booking is entered in to the calendar, but will not block the room. The dates will be available for other guests to book. When they make a successful payment the status of the booking will automatically change to confirmed. If the payment is aborted or not successful the room will not be blocked. You will then either need to change the status manually to cancelled or use an auto action to automatically change the status of Request bookings to Cancelled after a preset time. Auto Actions can be set up in {{#fas:cog}} (SETTINGS) > GUEST MANAGEMENT > AUTO ACTIONS.
**'''Cancelled''': When the guest clicks "Confirm Booking" the room will not be reserved until the payment has completed. Other guests can still book the room until a successful payment has been made leaving a small risk of double bookings.

*Set the required amount. It can be a fixed amount, a percentage of the total or the value of the first nights accommodation.
*The currency used by will be the currency you have set in the {{#fas:cog}} (SETTINGS) PROPERTY > DESCRIPTION currency to receive payments setting.

[[Image:DBPayment2a.jpg|500px|link=]]
[[Media:DBPayment2a.jpg|view large]]

'''Step 2.''' To add general information to the header section of the payment screen go to {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT COLLECTION and click on "Deposit Payment Header"

'''Step 3.''' Enable one or more payment options.

*Choose the gateway and or method(s) you want to use ({{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT GATEWAYS > PAYPAL/STRIPE..... and enter the required account information to connect your payment system to your account. Use the context help (? icons) and the page help (top right menu of each page) for instructions.

[[Image:PayGate2.jpg|500px|link=]]
[[Media:PayGate2.jpg|view large]]

If you want to offer your guests a choice between different options you can select in which order the options display.

To override the default title which the guest sees enter your custom text in the "Title" field.
*In "Instruction" you can enter a custom information to display under the payment button.

For detailed instruction for each gateway/method when you click on the context help (? icons) and on HELP in the top right corner of the payment method help page.

'''Step 4.''' Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE >

*Set "Booking Type" to either the Deposit Collection 1 or Deposit Collection 2.

Each of Deposit Collection 1 and Deposit Collection 2 can collect different deposit amounts.

Individual rules can be set for Normal, Near term and Exceptional period bookings. Individual rules can also be set directly within rates or offers.

This allows you for example to take a different deposit in high and low season or for normal and last minute bookings.

[[Image:DBPaymentPerc.jpg|500px|link=]]
[[Media:DBPaymentPerc.jpg|view large]]

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Note that booking rules for fixed prices will override rules for rooms and booking rules for offers will override booking engine booking rules.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you set "Booking Type" in = "Collect CC - auto confirmed with Credit Card" or "Request CC - Request only with credit card number" in {{#fas:cog}}(SETTINGS) > BOOKING ENGINE the guest will submit their credit card detail but the card will NOT be charged.

==Reports ==
You can set up an Auto Action ({{#fas:cog}} (SETTINGS) > GUEST MANAGEMENT > AUTO ACTIONS) to flag bookings for which a payment and set up a custom report for these bookings (REPORTS-> CUSTOM REPORTS) which you show on the dashboard.

In REPORTS-> STANDARD REPORTS you can choose from a wide range of financial reports.

== Frequently asked questions==
===How do I receive the payments?===
Beds24 never handles any payments from guests. All payments go directly into your account with the payment gateway you use.

===How can I collect payments from guests booking through an OTA? ===
Beds24 is not involved in deposit collections for bookings from booking channels. Each booking channels handles them according to their rules/your account settings. If you use [[Stripe]] you can send cards sent from OTAs to Stripe to charge them.

===How can I collect outstanding payments from guests booking through my website (Direct)? ===
If you have activated [[Stripe]] and have collected the guest credit card details then you can create a Pending Payment in the booking to collect the outstanding payment at a specified date/time. See the section on Pending Payments above.

If you do not have the guest credit card details, then you can send a Payment Request link in an email so they can make a payment via the activated payment gateways. See section on Payment requests above.

===Can I use a payment gateway to which Beds24 does not integrate? ===
In {{#fas:cog}} (SETTINGS) PAYMENTS > CUSTOM GATEWAY you can connect to your own payment gateway. If you do not have the required programming skills you can hire a developer to set this up for you. If you do not work with a developer you can hire one of our partners. Have a look here: http://shop.beds24.com/category/api-connections/

Make

2024-10-16T20:02:44Z

IuriRosa: /* Data Fields */

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

= Capabilities =
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

= Limitations =

= Set Up =
=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it. API access must be allowed in the menu ({{#fas:cog}} (SETTINGS) ACCOUNT > ACCOUNT ACCESS).
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

= Common Problems =
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

= Disconnect=
Untick "Bookings" to stop sending bookings.

= Sample Scenarios=
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Connect to API V2 ===
</div>
<div class="mw-collapsible-content">

'''Connecting Make to Beds24 API V2'''

Before using API V2 with Make, we need to set up a data store to store the refresh token and the access token. We will also need to create a scenario that triggers every 24 hours to obtain a new token using the refresh token. Once this is set up, we can configure any scenario in Make using the Beds24 API V2, as we will always have an up-to-date token.

== Step 1: Create a Data Store ==
1. Log into Make and go to '''More''' (the 2 dots) > '''Data Store'''.

[[Image:Image1.png|700px|link=]]
[[Media:Image1.png|view large]]

2. Click the '''Add Data Store''' button in the top right corner.

[[Image:Image3.png|700px|link=]]
[[Media:Image3.png|view large]]

=== Configure the Data Store ===
1. Give the data store a name (I suggest "Access Token").
2. In the '''Data Structure''', click '''Add'''.

[[Image:Image4.png|700px|link=]]
[[Media:Image4.png|view large]]

* Click '''Add Item''' and set:
* '''Name''' = “Access Token”
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No

[[Image:Image5.png|700px|link=]]
[[Media:Image5.png|view large]]

3. Click '''Add New Item''' and set:

[[Image:Image6.png|700px|link=]]
[[Media:Image6.png|view large]]

* '''Name''' = "Refresh Token"
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No
* '''Strict''' = No
4. Click '''Save''' to save the data structure and the data store.
5. Now click '''Browse''' to find the data store you just created.

[[Image:Image7.png|700px|link=]]
[[Media:Image7.png|view large]]

6. Click '''Add''' at the top of the screen.

[[Image:Image8.png|700px|link=]]
[[Media:Image8.png|view large]]

7. You will need to add a key. Click the icon and enter a random number; you will need this number later for your scenario.

[[Image:Image9.png|700px|link=]]
[[Media:Image9.png|view large]]

== Step 2: Get Tokens from Beds24 ==
1. Log in to Beds24 and navigate to '''Settings > Apps & Integrations > API''' to generate a new invite code.
2. After you have the invite code, visit [https://api.beds24.com/v2/#/Authentication/get_authentication_setup Beds24 API Authentication Setup].
3. Click '''Try Out''' and paste your invite code.

[[Image:Image10.png|700px|link=]]
[[Media:Image10.png|view large]]

4. Click '''Execute''' to retrieve your token and refresh token.

[[Image:Image11.png|700px|link=]]
[[Media:Image11.png|view large]]

5. Copy the access token and paste it into the "Access Token" field in the data store.
6. Copy the refresh token and paste it into the "Refresh Token" field in the data store.

[[Image:Image12.png|700px|link=]]
[[Media:Image12.png|view large]]

7. Click '''Save''' at the top of the screen. You now have a data store containing your token and refresh token.

== Step 3: Create a Scenario to Update the Token Every 24 Hours ==
1. Create a new scenario in Make, and add the first module as '''Data Store – Search Record'''.

[[Image:Image13.png|700px|link=]]
[[Media:Image13.png|view large]]

* Select '''Browse''' and choose the data store you created.
* In the filter, choose the '''Access Token'''.
* Set '''Basic Operation''' = Exist (this is important to check if the token exists).

[[Image:Image14.png|700px|link=]]
[[Media:Image14.png|view large]]

2. Click '''OK''' and add the second module.
3. Add an '''HTTP module – Make a Request''' to request a new token every 24 hours:
* Set '''Evaluate all states as errors''' (except for 2xx and 3xx) = No.
* '''URL''' = https://api.beds24.com/v2/authentication/token.
* '''Method''' = GET.
* In the headers, add two items:
* '''Item 1''': Name = '''refreshToken''', Value = map the refresh token from the first module (Data Store module).

[[Image:Image16.png|700px|link=]]
[[Media:Image16.png|view large]]

* '''Item 2''': Name = '''accept''', Value = '''application/json'''.
4. Save the module.
5. Add another module to update the token: '''Data Store – Add / Replace Record'''.
* Select the data store you created.
* '''Key''' = the random number you set earlier.
* '''Overwrite an existing record''' = Yes.
* '''Parse response''' = Yes (this is crucial).
6. You will need to run the HTTP module once before proceeding. Save the data store module as is for now.

[[Image:Image17.png|700px|link=]]
[[Media:Image17.png|view large]]

7. Copy your refresh token again and paste it into the "Refresh Token" field.

[[Image:Image18.png|700px|link=]]
[[Media:Image18.png|view large]]

8. Click '''OK''' to run the module and update your token.

[[Image:Image19.png|700px|link=]]
[[Media:Image19.png|view large]]

== Step 4: Finalize the Scenario ==
1. Edit the last module (Data Store) again, and map:
* '''Access Token''' = Token from the HTTP module.
* '''Refresh Token''' = Refresh token from the Data Store module.

[[Image:Image20.png|700px|link=]]
[[Media:Image20.png|view large]]

2. Save the module and set it to trigger every 24 hours. This will make an API call every day to get a new token.

== Step 5: Using the Token in API Calls ==
To make API calls to Beds24, first set the '''Data Store module – Get a Record'''. Insert your key (the number you set under Key). When you set up an HTTP module to make an API call, use the token from the data store, which will always be up to date.

</div>
</div>

Make

2024-10-16T19:41:35Z

IuriRosa: /* Connect to API V2 */

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

= Capabilities =
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

= Limitations =

= Set Up =
=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it. API access must be allowed in the menu ({{#fas:cog}} (SETTINGS) ACCOUNT > ACCOUNT ACCESS).
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

= Common Problems =
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

= Disconnect=
Untick "Bookings" to stop sending bookings.

= Sample Scenarios=
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Connect to API V2 ===
</div>
<div class="mw-collapsible-content">

'''Connecting Make to Beds24 API V2'''

Before using API V2 with Make, we need to set up a data store to store the refresh token and the access token. We will also need to create a scenario that triggers every 24 hours to obtain a new token using the refresh token. Once this is set up, we can configure any scenario in Make using the Beds24 API V2, as we will always have an up-to-date token.

== Step 1: Create a Data Store ==
1. Log into Make and go to '''More''' (the 2 dots) > '''Data Store'''.

[[Image:Image1.png|700px|link=]]
[[Media:Image1.png|view large]]

2. Click the '''Add Data Store''' button in the top right corner.

[[Image:Image3.png|700px|link=]]
[[Media:Image3.png|view large]]

=== Configure the Data Store ===
1. Give the data store a name (I suggest "Access Token").
2. In the '''Data Structure''', click '''Add'''.

[[Image:Image4.png|700px|link=]]
[[Media:Image4.png|view large]]

* Click '''Add Item''' and set:
* '''Name''' = “Access Token”
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No

[[Image:Image5.png|700px|link=]]
[[Media:Image5.png|view large]]

3. Click '''Add New Item''' and set:

[[Image:Image6.png|700px|link=]]
[[Media:Image6.png|view large]]

* '''Name''' = "Refresh Token"
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No
* '''Strict''' = No
4. Click '''Save''' to save the data structure and the data store.
5. Now click '''Browse''' to find the data store you just created.

[[Image:Image7.png|700px|link=]]
[[Media:Image7.png|view large]]

6. Click '''Add''' at the top of the screen.

[[Image:Image8.png|700px|link=]]
[[Media:Image8.png|view large]]

7. You will need to add a key. Click the icon and enter a random number; you will need this number later for your scenario.

[[Image:Image9.png|700px|link=]]
[[Media:Image9.png|view large]]

== Step 2: Get Tokens from Beds24 ==
1. Log in to Beds24 and navigate to '''Settings > Apps & Integrations > API''' to generate a new invite code.
2. After you have the invite code, visit [https://api.beds24.com/v2/#/Authentication/get_authentication_setup Beds24 API Authentication Setup].
3. Click '''Try Out''' and paste your invite code.

[[Image:Image10.png|700px|link=]]
[[Media:Image10.png|view large]]

4. Click '''Execute''' to retrieve your token and refresh token.

[[Image:Image11.png|700px|link=]]
[[Media:Image11.png|view large]]

5. Copy the access token and paste it into the "Access Token" field in the data store.
6. Copy the refresh token and paste it into the "Refresh Token" field in the data store.

[[Image:Image12.png|700px|link=]]
[[Media:Image12.png|view large]]

7. Click '''Save''' at the top of the screen. You now have a data store containing your token and refresh token.

== Step 3: Create a Scenario to Update the Token Every 24 Hours ==
1. Create a new scenario in Make, and add the first module as '''Data Store – Search Record'''.

[[Image:Image13.png|700px|link=]]
[[Media:Image13.png|view large]]

* Select '''Browse''' and choose the data store you created.
* In the filter, choose the '''Access Token'''.
* Set '''Basic Operation''' = Exist (this is important to check if the token exists).

[[Image:Image14.png|700px|link=]]
[[Media:Image14.png|view large]]

2. Click '''OK''' and add the second module.
3. Add an '''HTTP module – Make a Request''' to request a new token every 24 hours:
* Set '''Evaluate all states as errors''' (except for 2xx and 3xx) = No.
* '''URL''' = https://api.beds24.com/v2/authentication/token.
* '''Method''' = GET.
* In the headers, add two items:
* '''Item 1''': Name = '''refreshToken''', Value = map the refresh token from the first module (Data Store module).

[[Image:Image16.png|700px|link=]]
[[Media:Image16.png|view large]]

* '''Item 2''': Name = '''accept''', Value = '''application/json'''.
4. Save the module.
5. Add another module to update the token: '''Data Store – Add / Replace Record'''.
* Select the data store you created.
* '''Key''' = the random number you set earlier.
* '''Overwrite an existing record''' = Yes.
* '''Parse response''' = Yes (this is crucial).
6. You will need to run the HTTP module once before proceeding. Save the data store module as is for now.

[[Image:Image17.png|700px|link=]]
[[Media:Image17.png|view large]]

7. Copy your refresh token again and paste it into the "Refresh Token" field.

[[Image:Image18.png|700px|link=]]
[[Media:Image18.png|view large]]

8. Click '''OK''' to run the module and update your token.

[[Image:Image19.png|700px|link=]]
[[Media:Image19.png|view large]]

== Step 4: Finalize the Scenario ==
1. Edit the last module (Data Store) again, and map:
* '''Access Token''' = Token from the HTTP module.
* '''Refresh Token''' = Refresh token from the Data Store module.

[[Image:Image20.png|700px|link=]]
[[Media:Image20.png|view large]]

2. Save the module and set it to trigger every 24 hours. This will make an API call every day to get a new token.

== Step 5: Using the Token in API Calls ==
To make API calls to Beds24, first set the '''Data Store module – Get a Record'''. Insert your key (the number you set under Key). When you set up an HTTP module to make an API call, use the token from the data store, which will always be up to date.

</div>
</div>

File:Image20.png

2024-10-16T19:16:43Z

IuriRosa:

File:Image19.png

2024-10-16T19:16:35Z

IuriRosa:

File:Image18.png

2024-10-16T19:16:27Z

IuriRosa:

File:Image17.png

2024-10-16T19:16:19Z

IuriRosa:

File:Image16.png

2024-10-16T19:16:12Z

IuriRosa:

File:Image15.png

2024-10-16T19:16:03Z

IuriRosa:

File:Image14.png

2024-10-16T19:15:55Z

IuriRosa:

File:Image13.png

2024-10-16T19:15:48Z

IuriRosa:

File:Image12.png

2024-10-16T19:15:38Z

IuriRosa:

File:Image11.png

2024-10-16T19:15:29Z

IuriRosa:

File:Image10.png

2024-10-16T19:15:19Z

IuriRosa:

File:Image9.png

2024-10-16T19:15:10Z

IuriRosa:

File:Image8.png

2024-10-16T19:15:00Z

IuriRosa:

File:Image7.png

2024-10-16T19:14:52Z

IuriRosa:

File:Image6.png

2024-10-16T19:14:40Z

IuriRosa:

File:Image5.png

2024-10-16T19:14:30Z

IuriRosa:

File:Image4.png

2024-10-16T19:14:15Z

IuriRosa:

File:Image3.png

2024-10-16T19:14:00Z

IuriRosa:

File:Image2.png

2024-10-16T19:13:47Z

IuriRosa:

Make

2024-10-16T19:11:44Z

IuriRosa: /* Sample Scenarios */

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

= Capabilities =
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

= Limitations =

= Set Up =
=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it. API access must be allowed in the menu ({{#fas:cog}} (SETTINGS) ACCOUNT > ACCOUNT ACCESS).
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

= Common Problems =
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

= Disconnect=
Untick "Bookings" to stop sending bookings.

= Sample Scenarios=
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Connect to API V2 ===
</div>
<div class="mw-collapsible-content">

</div>
</div>

Make

2024-10-16T19:11:13Z

IuriRosa: /* Sample Scenarios */

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

= Capabilities =
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

= Limitations =

= Set Up =
=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it. API access must be allowed in the menu ({{#fas:cog}} (SETTINGS) ACCOUNT > ACCOUNT ACCESS).
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

= Common Problems =
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

= Disconnect=
Untick "Bookings" to stop sending bookings.

= Sample Scenarios=
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

File:Image1.png

2024-10-16T19:07:56Z

IuriRosa:

Make

2024-10-16T13:26:26Z

IuriRosa: /* Sample Scenarios */

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

= Capabilities =
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

= Limitations =

= Set Up =
=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it. API access must be allowed in the menu ({{#fas:cog}} (SETTINGS) ACCOUNT > ACCOUNT ACCESS).
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

= Common Problems =
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

= Disconnect=
Untick "Bookings" to stop sending bookings.

= Sample Scenarios=
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Connect to API V2 ===
</div>
<div class="mw-collapsible-content">

'''Connecting Make to Beds24 API V2'''

Before using API V2 with Make, we need to set up a data store to store the refresh token and the access token. We will also need to create a scenario that triggers every 24 hours to obtain a new token using the refresh token. Once this is set up, we can configure any scenario in Make using the Beds24 API V2, as we will always have an up-to-date token.

== Step 1: Create a Data Store ==
1. Log into Make and go to '''More''' (the 2 dots) > '''Data Store'''.
2. Click the '''Add Data Store''' button in the top right corner.

=== Configure the Data Store ===
1. Give the data store a name (I suggest "Access Token").
2. In the '''Data Structure''', click '''Add'''.
* Click '''Add Item''' and set:
* '''Name''' = “Access Token”
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No
3. Click '''Add New Item''' and set:
* '''Name''' = "Refresh Token"
* '''Type''' = Text
* '''Required''' = No
* '''Multi-line''' = No
* '''Strict''' = No
4. Click '''Save''' to save the data structure and the data store.
5. Now click '''Browse''' to find the data store you just created.
6. Click '''Add''' at the top of the screen.
7. You will need to add a key. Click the icon and enter a random number; you will need this number later for your scenario.

== Step 2: Get Tokens from Beds24 ==
1. Log in to Beds24 and navigate to '''Settings > Apps & Integrations > API''' to generate a new invite code.
2. After you have the invite code, visit [https://api.beds24.com/v2/#/Authentication/get_authentication_setup Beds24 API Authentication Setup].
3. Click '''Try Out''' and paste your invite code.
4. Click '''Execute''' to retrieve your token and refresh token.
5. Copy the access token and paste it into the "Access Token" field in the data store.
6. Copy the refresh token and paste it into the "Refresh Token" field in the data store.
7. Click '''Save''' at the top of the screen. You now have a data store containing your token and refresh token.

== Step 3: Create a Scenario to Update the Token Every 24 Hours ==
1. Create a new scenario in Make, and add the first module as '''Data Store – Search Record'''.
* Select '''Browse''' and choose the data store you created.
* In the filter, choose the '''Access Token'''.
* Set '''Basic Operation''' = Exist (this is important to check if the token exists).
2. Click '''OK''' and add the second module.
3. Add an '''HTTP module – Make a Request''' to request a new token every 24 hours:
* Set '''Evaluate all states as errors''' (except for 2xx and 3xx) = No.
* '''URL''' = https://api.beds24.com/v2/authentication/token.
* '''Method''' = GET.
* In the headers, add two items:
* '''Item 1''': Name = '''refreshToken''', Value = map the refresh token from the first module (Data Store module).
* '''Item 2''': Name = '''accept''', Value = '''application/json'''.
4. Save the module.
5. Add another module to update the token: '''Data Store – Add / Replace Record'''.
* Select the data store you created.
* '''Key''' = the random number you set earlier.
* '''Overwrite an existing record''' = Yes.
* '''Parse response''' = Yes (this is crucial).
6. You will need to run the HTTP module once before proceeding. Save the data store module as is for now.
7. Copy your refresh token again and paste it into the "Refresh Token" field.
8. Click '''OK''' to run the module and update your token.

== Step 4: Finalize the Scenario ==
1. Edit the last module (Data Store) again, and map:
* '''Access Token''' = Token from the HTTP module.
* '''Refresh Token''' = Refresh token from the Data Store module.
2. Save the module and set it to trigger every 24 hours. This will make an API call every day to get a new token.

== Step 5: Using the Token in API Calls ==
To make API calls to Beds24, first set the '''Data Store module – Get a Record'''. Insert your key (the number you set under Key). When you set up an HTTP module to make an API call, use the token from the data store, which will always be up to date.

</div>
</div>

Airbnb Mapping

2024-08-24T10:52:27Z

IuriRosa: /* Per Occupancy (LOS) Pricing */

[[Category:Channel Manager]]
[[Category:Airbnb]]
[[Category:Messaging]]
[[Category:Error Messages from Channels]]
[[Category:Troubleshooting]]

<div class="heading">Connect and update listings to Airbnb</div>

This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and explains how to connect your rooms in Beds24 to existing listings in Airbnb and how to create new listings in Airbnb

Beds24 provides a certified 2-way API integration which offers you many additional features and functions which will make working with Airbnb easy for you.

=Summary=
<div class="summarybox">
When all of your prices, and rooms are set up in Beds24 you can start the integration with Airbnb:
#Connect your Airbnb account
#Map your rooms
#Check which prices will send
#Select your sync type
#Click "Connect" and select the corresponding listing to this room to make the connection.
#Check what will send to Airbnb
#Import upcoming bookings
Read the complete [https://wiki.beds24.com/index.php?title=Airbnb_Mapping instructions] before you start the integration.
</div>

=Capabilities=
You can connect one or multiple Airbnb account to
*Import listings from Airbnb which will create properties and/or rooms in Beds24.
*Create new listings in Airbnb from rooms in Beds24.
*Connect to existing listings in Airbnb to send updates from Beds24.

After you have mapped your listings Beds24 will automatically.
*Synchronize prices, availability and restrictions to Airbnb.
*Import bookings and booking modifications or cancellations.
*See all messages from Airbnb guests under "Messages".
*Communicate with your guests directly from the booking in Beds24 via the "Messages" tab and via Auto Actions.

You can also choose to
*Update all content including descriptions and pictures from Beds24
*Import booking requests

[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.

<div style="display:">
==Capabilities per Sync Type==
Beds24 offers three different sync types which define which data can be updated to Airbnb.

{| class="wikitable"

! scope="col"|
! scope="col"| Occupancy based Pricing
! scope="col"| Per Day Pricing
! scope="col"| Rate Plans
|-

!style="text-align:left; background: #ffffff" scope="col" colspan =4| '''Prices and Availabilty'''

|-
!style="text-align:right" scope="row"|Prices
| Auto**
| Auto*
| Auto*
|-
!style="text-align:right;" scope="row"|Availability
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Min. Nights
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Max. Nights
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Closed to Arrival (CTA)
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Closed to Departure (CTD)
| Auto*
| Auto*
| Auto*
|-

!style="text-align:left; background: #ffffff" scope="col" colspan =4| '''Limited''' (sends "Pricing Settings" from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > "Pricing Settings" in addition to "Prices and Availability" )
|-

!style="text-align:right;" scope="row"|Listing Currency
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Guest Included
| N/A
| Auto*
| N/A
|-

!style="text-align:right;" scope="row"|Extra Person Price
| N/A
| Auto*
| N/A
|-

!style="text-align:right;" scope="row"|Dates with no Price
| N/A
| Auto*
| N/A
|-

!style="text-align:right;" scope="row"|Discounts (2-28 days)
| N/A
| Auto*
| N/A
|-

!style="text-align:right;" scope="row"|Max Days in Advance
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Advance Notice (Hours)
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Advance Notice Requests
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Early Bird Days to Check-in & Discount
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Last Minute Days to Check-in & Discount
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Custom Fees & Pass Through Taxes
| Auto*
| Auto*
| Auto*
|-

!style="text-align:right;" scope="row"|Rack Rate (Default daily price)
| Auto*
| Auto*
| Auto*
|-

!style="text-align:left; background: #ffffff" scope="col" colspan =4| '''Everything''' (sends full content additionally to "Prices and Availability" and "Limited")
|-

!style="text-align:right;" scope="row"|Listing details
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Descriptions
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Bedrooms
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Picture
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Instant Book
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Pre-Booking Message
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Cancellation Policy
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Non refundable discount
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Check-in start
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Check-in end
| Manual
| Manual
| Manual
|-

|}

<nowiki>*</nowiki>You can always manually trigger an update

<nowiki>**</nowiki>Including Extra person price from Daily Prices
</div>

= Limitations =
*Blocked dates in Airbnb are NOT imported, you need to block in Beds24.
*You can only connect listings which are live on Airbnb.
*Listings in properties which Airbnb considers "traditional hospitality" like hotels, Bed & Breakfast rooms and small inns are approved by Airbnb on a case by case basis.
*If you do not have Daily Prices or Fixed Prices in which "Airbnb" is activated in the "Channels" tab the "Base Price" (Rack Rate) will be used up to a year in advance.
*Smart Pricing is not available for API connected listings.
*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.

Airbnb does not allow Co-hosts to connect listings or disconnect listings. Only owners can make API connections. This means if you are a Co-Host Airbnb will not allow you to connect your co-hosted listings via Beds24 (or any other channel manager). Solutions to this limitation are:

*Ask the host to transfer their account to you.
*Your hosts make the connection between their Airbnb accounts and Beds24 themselves'''
**You can create a (temporary) subaccount in Beds24 for each of your owners. Your hosts will have a login where they then can connect their Airbnb accounts.
**If you manage a large number of properties we can give you the "Connect with Airbnb Account" button. Your owners will then be able to use this button outside of Beds24 so they will not need to log into

=Before you connect=
==Prices==
*We can only send availability if you have set up prices which are activated for Airbnb under "Channels" in the Daily Prices or Fixed Prices.
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*Airbnb requires a "Base Price" (Rack Rate) which you can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT. Make sure you are prepared to accept a booking for the "Base Price. If you do not have Daily Prices or Fixed Prices which are activated for channel management or in which "Airbnb" is activated the rack rate will be used up to a year in advance.
*In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set 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 Base Price.
*You can set a multiplier to mark your price up or down.

==Bookings and Requests==

<div class="warning">{{#fas:exclamation-triangle}} In instances of Airbnb bookings cancelled by the host, marked as "Cancelled by Host," please note that Airbnb maintains a restriction preventing the reopening of dates for the same property. Airbnb will not reopen dates when you have previously cancelled a booking. The dates should be available on all other channels.
</div>

When you use the API connection Airbnb only allows instant bookings. In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > 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.

In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can also add a "Custom Value" if you allow guests to send a request if they want to stay longer than your maximum stay rule allows.

After the connection has been successfully set up you can import upcoming existing bookings from Airbnb and all new bookings will automatically import.

Inquiries and requests are only imported if you opt in to importing them.

Other bookings can be uploaded as a .csv file in {{#fas:cog}} (SETTINGS) PROPERTIES.

To manually add or blocked dates click on the suitcase icon in the CALENDAR or on "Add Booking" at the top.

If you do not need the actual booking you can adjust the availability in the CALENDAR in the row "Inventory". The number shows rooms remaining to sell. They can be edited to quickly change your availability. Double-click to open a pop-up and save the changes. (it is only possible to lower the number based on the value in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP "Quantity of this type" and any existing bookings).

Airbnb collects the payment from your guest. Channel collect payments will be shown in the booking invoice if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under “Channel Collect Invoice” is set to import them. If you want to import the "Expected Payout amount" or the "Expected Payout and actual payment" from Airbnb you need to set this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under "Airbnb" "Invoice".

By changes or updates of an existing booking, Airbnb will not dynamically update the cost for extra guests if a reservation alteration is initiated by either the host or the guest.

The host can reject the reservation alteration and can update the guest count and the cost of the extra guests, then send the alteration to the main guest, who will need to accept the new reservation.

==Properties, rooms and room types ==
A listing in Airbnb is a room in Beds24.

Our connection supports room types with a quantity of more than one. If you want to send a quantity of more than one you can not use "House" as the property type.

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.

==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], [https://www.airbnb.com/help/article/1385/responsible-hosting-in-portugal Portugal] , [https://www.airbnb.com/help/article/1388/responsible-hosting-in-spain Spain], [https://www.airbnb.com/help/article/1383/responsible-hosting-in-france France], [https://www.airbnb.de/help/article/1391/responsible-hosting-in-germany Germany]

For other regions please check the Airbnb help pages.

=Set the connection up=
==Property settings==
If you have multiple rooms in a property these settings will apply to all rooms in the property.

'''Step 1: Connect your Airbnb account to your property'''

Each property can connect to one Airbnb Account. Select the Airbnb account you want to connect to.

If no Airbnb account is available go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS and connect your account.

'''Step 2 - Apply a multiplier to mark your prices up or down (optional)'''

If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number.

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.

'''Step 3: Check the currency setting is correct'''

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 multiplier (above) for conversion.

'''Step 4 - Import inquiries from Aribnb (optional)'''

If you import inquiries Beds24 will create a booking with the status "Inquiry". If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Bookings with the status "Inquiry" do not block the room. If you want to block the room for example if you have made the guest an offer you need to change the status manually.

'''Step 5 - Assign an invoicee (optional)'''

If you need to send invoices which are different from your standard invoice you can use the [[Invoicees|invoicee]] function.

==Connect listings you already have on Airbnb==
By mapping a room you connect it so it can update a listing in Airbnb.

'''Step 1 - Change the pricing model (optional)'''

Select "Occupancy Pricing" if you want to send prices for different numbers of guests and/or different length of stay. See the chapter "Pricing Models" below for more information.

Press SAVE.

'''Step 2 - Check which prices will send '''

Go to the "Mapping" tab again and then scroll down to "Room Mapping" and then click on "Price Data" under "View" to check which prices and availability will be sent. If you see no prices or no availability in the list, check if you have prices set up for your listing on Airbnb.

'''Step 3: Select your sync type'''

With sync type '''Prices & Availability''' Beds24 will only update your price data (including number of guests, extra person price, base price, max stay, minimum stay, max days in advance, advance notice/same day booking cut off) and availability and import bookings. If you want to change your discounts, descriptions, pictures, or other settings you do this in Airbnb.

With sync type '''Limited''' Beds24 will update your price data (including number of guests, extra person price, base price, taxes and fees, max stay, minimum stay, max days in advance, advance notice/same day booking cut off, last-minute discount, early-bird discount, weekly discount, monthly discount) and availability and import bookings. If you want to change your descriptions pictures or other settings you do this in Airbnb.

With sync type '''Everything''' also 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 to sync everything your listing needs to meet Airbnbs requirements. If you see a red button "Fix Content Errors" your listing does not meet Airbnb requirements. Click on the button. Any settings which do not meet Airbnb requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Always go to "View Content" to check what will send to Airbnb before selecting '''Everything'''.

'''Step 4: Connect'''

Click "Connect" and select the corresponding listing to this room to make the connection.

If you have changed the sync type to "Everything" you need to press SAVE before connecting.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

'''Step 6: Import upcoming bookings'''

Click on "Import existing bookings" to import the bookings you already have in Airbnb. Bookings previously imported via the Airbnb iCal connection will not import. We recommend you delete them before you press the button.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Blocked dates are not sent by Airbnb, manually update the dates in Beds24 calendar.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> We will import bookings from the last four weeks that are currently ongoing and have not yet reached their check-out date. However, please note that exceptionally long-term stays, those exceeding four weeks, will not be included in the import.

[[File:Airbnb_Synctyp_Prices_Availability.mp4|640px]]

[[File:Airbnb_Synctyp_Everything.mp4|640px]]

=Create a new listing=

'''Step 1 - Select "Sync Type" Everything'''

Airbnb will only publish your listing if you send the full content.

Set "Sync Type" = Everything then press SAVE.

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > PUBLISH = NO

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > UPDATE ADDRESS = YES then press SAVE.

'''Step 2 - Check if your content meets Airbnbs requirements'''

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT to revise which data will send to Airbnb. 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.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button to get to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT.

'''Step 3 - Check which prices will send'''
Go to the "Mapping" tab again and then scroll down to "Room Mapping" and then click on "Price Data" under "View" to check which prices and availability will be sent. If you see no prices or no availability in the list, check if you have prices set up for your property on Beds24.

'''Step 4: Export to Airbnb'''

When your content meets Airbnbs requirements you can click "Export'''.

Airbnbs new listing promotion helps you to get your first bookings quicker. It allows hosts to easily apply a 20% discount. This option is activated by default but you can opt out (not recommended) before sending.

'''Step 5: Complete Airbnb Registration'''

Login to your Airbnb Account, go to Listings, click on the listing, then click 'Fix' and complete the Airbnb Registraion actions.

'''Step 6: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

[[File:Create_a_new_listing_on_Airbnb.mp4|640px]]

=Airbnbs review and publishing process =
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 "Check Connection 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 "Check Connection Status".

=Updates=
*Changes to availability and prices will be instantly sent to the channel.
*Changes for settings for example minimum stays, the multiplier or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
*Content updates are only sent on demand. If you change content you will need to click "Update" to send the changes.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> It can take Airbnb a couple of minutes to process the data we sent.

If you make changes to values which are sent from Beds24 in Airbnb they will be overridden with the next update.

=Reviews=
If a guest sends you a review, you can also view it in Beds24 via the "Mail & Actions" tab and send the guest a reply from there.

After the guest has checked-out, you can send the review to Airbnb via the "Mail & Actions" tab in the booking in Beds24.

When you provide a review text guests will automatically receive a five-star review along with the provided text four days after check-out, unless you have already manually reviewed the guest.

*Review Template: If you want to automatically review your guests enter your review text under "Auto Review Text" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING. You can personalize your review by using Template Variables.

*Manual Review: If you’re using automated reviews but wish to give the guest a rating different from five stars or change the provided text, you can manually review the guest within three days after check-out.

*Disable auto review for individual bookings: Change the setting for "Allow Review" in Mail & Action tab to "Disable"

If you have multiple properties you can set a different message for each property.

=Change the Sync Type=
If you want to change the sync type all you need to do is change the setting and then press SAVE.

=Disconnect or terminate the connection=
*To disconnect a listing to manage it manually go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and click on "Disconnect".

*Click on "Disconnect" {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS.. This will set all your listings in this Airbnb account to "manual" so you can manage it manually. If you want to update the listing from Beds24 you will need to reconnect it.

If you do not want to use the API connection at all any more also disconnect the account in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS.

You can also disconnect your Airbnb account from Beds24 in Airbnb. Log into your Airbnb account and go to ACCOUNT > PRIVACY AND SHARING and remove the Beds24 app.

<div class="warning">{{#fas:exclamation-triangle}} When a listing is disconnected Airbnb resets some values to their defaults:
*minimum stay is set back to 1
* "Closed to arrival" and "Closed to departure" gets removed
*"Maximum stay" gets reset to 1125.
If you do not want these values you will need to change them. If reconnect a listing in Beds24 press "Update" after you reconnected to push the values from Beds24.
</div>

=Options for the sync types=
==Pricing models==
Airbnb supports different pricing models.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Click on the "Price Data" Button to check which prices and availability will send.

===Per Day Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Day Pricing''' (the default) if you have only ONE price 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. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.

If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send.

Only a global max. stay which is taken from {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP can send.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*The number of guests for which the daily price applies.
*An extra person price.

For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > and set Guests included = 2, Extra Person Price = 15

===Per Occupancy (LOS) Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing''' if you want to send prices for different occupancies and/or different length of stay.

If you use fixed prices the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.

If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.

The "Min Stay" set in the Calendar, Daily Prices or Rates will send.

We can send prices up to 28 days but guests can book longer stays if there are no restrictions. Airbnb will apply the average of the price of 28 days for days 29+.

The "Max Stay" set for the room will send. Max stays set in the prices will be ignored.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Beds24 sends the price for max. 16 guests. If your property accommodates more than 16 guests use "Per Day" pricing with an extra person price.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to limitations with Airbnbs multi calendar Airbnb can not show the correct prices in your Airbnb Extranet. The correct prices will be shown to the guest though and the prices sent from Beds24 will be applied for all bookings. If you want to check prices on Airbnb please start a booking for your listing.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to limitations at Airbnb if there is a change to the number of guests, Airbnb will not dynamically update the cost for extra guests if a reservation alteration is initiated by either the host or the guest.

The host can reject the reservation alteration and can update the guest count and the cost of the extra guests, then send the alteration to the main guest, who will need to accept the new reservation.

===Rate Plans===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> '''Rate plans''' are the pricing model of choice if you want
*to offer a refundable and a non-refundable option and
**set prices for refundable and non-refundable instead of Airbnbs fixed discount option
**control the cancellation policy for refundable and non-refundable prices
**control availability of the refundable/non-refundable booking option.
*parity with other channels which support rate plans i.e. Booking.com or Expedia.

You can create up to 10 rate plans which can be used for all listings in the Airbnb account. A maximum of 2 rate plans will be displayed to guests at a given time depending on the cancellation policy. Airbnb will display one refundable and another non-refundable rate plan and out of these (a) the lowest and (b) the most flexible rate.

A price for each occupancy defined in Beds24 can be sent.
*If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
*If you use fixed prices the Single, Double and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rate can not be sent.

If you want to send prices for different length of stay you need a rate plan for each.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

For more information and setup instructions click [[Airbnb_Rate_Plans |here]].

==Discounts==

If you have "Early Bird" or "Last Minute" prices which are activated for Airbnb these will automatically send. Airbnb will not mark these as promotions though.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set:
* A discount for 2 or more days, weekly or monthly. Use either the discounts for the number of days or month/week, but not both because the discount per day will override the discount per week/month.
* A discount for "Non Refundable" bookings. If you select a sync type "Limited," you can set a non-refundable discount in your Airbnb extranet.
* Early Bird and Last Minute Discounts which Airbnb will mark as promotions.

You can also create "Pricing Rules" directly in Airbnb, but we recommend you set all prices in Beds24 to avoid confusion.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Early bird or Last Minute offer are only marked as promotions if the price drops at least 10% from what Airbnb defines as the last 30 days median price. If you use both early bird and last minute and want to remove one, you will need to remove both because Airbnb will only remove them together. After you have clicked "Update" to send the change, you can reactivate the one you want to keep.

Please refer to Airbnb for more information on [https://www.airbnb.com/help/article/3421#:~:text=There%20may%20be%20a%20few,other%20discounts%20or%20promotions Discounts].

==Fees and taxes==
If you apply fees or taxes you need to send them from Beds24.
*Cleaning fee

You can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT.

Other fees supported by Airbnb can be sent as CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT. If you apply a linen fee Airbnb will add this to the cleaning fee.

*PETFEE 45 (for example)

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have a price multiplier in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB, > MAPPING this will also be applied to the Cleaning fee. If you want to over ride this, then use a CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT.

*If you want to send taxes click on "Check if you are eligible to send taxes" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. If Airbnb allows you to send taxes you can set them under "Custom". Please click on the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span>for "Custom" for detailed instructions

==Permit / Registration/ License==
In some locations Airbnb.com require the License/Registration number of the owner. Please also see under "Local legal requirements above"

If this is required for your property, please go to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID" and enter your details.

Permit IDs in Beds24 are set per property. If you have a different permit Id than the one set for the property you can set a room specific permit as "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

=Send and receive messages =
You can get communicate with Airbnb guest directly from Beds24. This function works for:
*Confirmed bookings
*Inquiries/Requests - if you receive a message from a potential guest inquiring Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

You can view all messages from the "Messages" component on the DASHBOARD and individual communication from the "API Messages" tab in the booking. You and your guests will see the messages in Airbnb. When a guest sends an attachment, Airbnb makes it available for one hour. Click on “ Reload messages” to reload the image.

To use this function you should:

1. Add the component "API Messages" to your [[:Category:Dashboard|DASHBOARD]]

2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options. We will remove the HTML from the message because Airbnb does not support HTML. You have the option to add a plain text message for this purpose.

Airbnb supports attachments in JPG, GIF and PNG format.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have moved the booking to a different room (manually or via dependencies), then ensure that both properties/rooms are connected with the same Airbnb account, otherwise this function will not work.

=Content for sync type "Everything"=
If you use this sync type all updates should be done in Beds24 (not in Airbnb) because changes you make in Airbnb will be overridden with the next update.
==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.

==Languages==
The content is sent in the language which is activated as default language for the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALIZATION.

If you have activated multiple languages and entered your descriptions in these we can multiple languages if you set "Allow Multi-Language" = Yes in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Please check the context help before changing the setting.

Following languages are supported by Airbnb and Beds24: Bahasa Indonesia, Catala, Dansk, Deutsch, English. Español, Eλληνικά, Français, Hrvatski, Italiano, Magyar, Nederlands, Norsk, Polski, Português, Suomi, Svenska, Íslenska, Čeština, Русский, עברית, ภาษาไทย, 中文, 日本語 ja
한국어.

==Property Type ==
Most of the property types which Airbnb supports can be selected in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

Other Airbnb property types can be added as "Custom" values in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

== Bedrooms and bathrooms==
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Set up bedrooms and bathroom either in the property OR the room. If you set them up in both you will double them up. Do not send additional bathroom amenities if you have a full bathrooom.

Bedrooms and bathrooms 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 "Bedroom" or "Bathroom".
*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.

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

*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.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>: Airbnb does not support all available features available in Beds24.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you add a crib in a bedroom Airbnb will display the crib as a bed. If you do not want to do this add BED_CRIB in a new line.

BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BEDROOM

BED_AIRMATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOORMATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

If you have a murphy bed it will send as single bed.

== Amenities ==
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room ({{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 "linens", towels and "toiletries".

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have "Accessability" amenities Airbnb requires you to provide a picture for each amenity which they review. You can add these amenities and the pictures in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT under "Custom".

You will find a list all all "Accessability" amenities below under "All Feature Codes".

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you do not select select child friendly amenities Airbnb might classify your listing as "Not safe or suitable for children (0-12 years)"

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb does not support all available feature codes. Make sure you pick five features which are supported by Airbnb.

==Pictures==
You can define in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT which pictures will be used.

Double check you have entered "Captions" for every picture.

Requirements and limitations from Airbnb:
*Airbnb requires a '''minimum of 1 picture per listing with high-resolution (800x500 pixels).
*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.

<div class="warning">{{#fas:exclamation-triangle}} Airbnb requires Captions. If you change pictures make sure you change/add the caption in (SETTINGS) BOOKING ENGINE > PICTURES so Airbnb recognizes the new picture.</div>

<div class="warning">{{#fas:exclamation-triangle}}Be careful changing pictures when listed in an Airbnb category. If you remove or change the picture Airbnb has choosen as your category picture you will be removed from the category.</div>

== Check-in / Check-out ==
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT you can set 'Check-in start', 'Check-in end' and 'Check-out end'.

If you want to

*send different times to Airbnb than to other channels
*send 25 for check-in
*send 25 or 26 for check-out
*offer flexible check-in

you can add this in SETTINGS > CHANNEL MANAGER > AIRBNB.COM > SPECIFIC CONTENT "Custom". [[Setting/custom|More information]].

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb requires at least two hours between check-in start and check-in end.

==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".

==Airbnb specific content ==
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT or click on the "Edit specific content for Airbnb" link to check and customize. specific content for Airbnb.

= 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

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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:

==Amenities==
AIR_CONDITIONING

BEACH_ESSENTIALS

BALCONY

CLEANING_PRODUCTS

CLOSET

CLOTHES_DRYINGRACK

CO_DETECTOR

CONDITIONER

DRYER

ELEVATOR

EXTRA_PILLOWS_BLANKETS

EV_CHARGER

FAN_PORTABLE

FIRE_EXTINGUISHER

FIRE_PIT

FIREPLACE

FIRST_AID_KIT

GAMES

GARDEN

GRILL

GRILL_EQUIPMENT

HAIR_DRYER

HAMMOCK

HANGERS

HEATING

IRON_BOARD

LINENS (if all of TOILETRIES, TOWELS and LINENS are used, this sends as "Essentials")

LIVING_ROOM

MOSQUITO_NET

OUTDOOR_FURNITURE (for outdoor seating)

PARKING

PARKING_PAID

PARKING_POSSIBLE

PIANO

POOL_TABLE

PRIVATE_ENTRANCE

ROOM_DARKENING_SHADES

TOILETRIES (body soap)

SAFETY_CARD

SHAMPOO

SHOWER_GEL

SMOKE_DETECTOR

SOAP

STEREO

TOWELS

TRASH_COMPACTER

WASHER

WATER_HOT

==Business==

==Entertainment==
TV

CABLE

VIDEO_GAMES

==Food and Drink==
BREAKFAST_INCLUDED

==Internet==
ETHERNET

INTERNET

WIFI

WIFI_POCKET

==Kitchen==
KITCHEN

KITCHEN_OUTDOOR

BAKING_SHEET

BLENDER

COFFEE

COFFEE_MAKER

COOKING_BASICS (is sent if both "DISHES_UTENSILS" and "SPICES" is selected)

DISHES_UTENSILS (is sent in combination with "SPICES" as "Cooking Basics")

DISHWASHER

FREEZER

GLASSES_WINE

KETTLE

OVEN

STOVE

REFRIGERATOR

REFRIGERATOR_MINI

RICE_MAKER

SPICES (is sent in combination with "DISHES_UTENSILS" as "Cooking Basics")

TOASTER

==Location==
BEACH_FRONT

LAKE (lake access in Airbnb)

SKI_IN

SKI_OUT

WATER_VIEW

==Pets==
PETS_CONSIDERED

==Pool & Wellness==
GYM

POOL

POOL_HEATED

POOL_INDOOR

POOL_PRIVATE

==Services==
DOORBELL

DOORMAN

RECEPTION_24HOUR

LUGGAGE_DROPOFF

CLEANING_BEFORE_CHECKOUT

BICYCLE_RENTAL

==Sports==
BOAT_SLIP

FITNESS_CENTER (for exercise equipment)

KAYAK_CANOE

TABLE_TENNIS

==Suitability==
ADULTS_ONLY

CHILDREN_NOT_ALLOWED

EVENTS_ALLOWED

INFANTS_NOT_ALLOWED

LAPTOP_FRIENDLY

LONG_TERM_RENTERS

SMOKING_ALLOWED

==Accessibility==
PARKING_DISABLED

STEP_FREE_ACCESS_BATHROOM

GRAB_RAILS_IN_SHOWER

GRAB_RAILS_IN_TOILET

ROLLIN_SHOWER

SHOWER_CHAIR

WIDE_DOORWAY_BATHROOM

TUB_WITH_SHOWER_BENCH

WIDE_CLEARANCE_TO_SHOWER_AND_TOILET

STEP_FEE_ACCESS_BEDROOM

WIDE_DOORWAY_BEDROOM

SINGLE_LEVEL_HOME

COMMON_SPACE_STEP_FREE_ACCESS

COMMON_SPACE_WIDE_DOORWAY

HOME_STEP_FREE_ACCESS

PATH_TO_ENTRANCE_LIT_AT_NIGHT

HOME_WIDE_DOORWAY

FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR

==Family==
CHANGING_TABLE

BABY_BATH

PACK_N_PLAY_TRAVEL_CRIB

FIREPLACE_GUARD

BABY_MONITOR

OUTLET_COVERS

TABLE_CORNER_GUARDS

WINDOW_GUARDS

CHILDRENS_DINNERWARE

BABYSITTER_RECOMMENDATIONS

==Bedroom==
BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

BED_AIRMATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOORMATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

==Bathroom==
BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BATH_BIDET

BATH_SHOWER_RAIN

= Troubleshooting and common errors =

==Troubleshooting==

'''You need to complete the API onboarding flow before publishing the listing'''
Beds24 sent the data but the Airbnb requires you to complete the registration process. Try the following:
1. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > PUBLISH = NO, click Save.
2. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING > scroll to the listing and click 'CHECK CONNECTION STATUS'
3. Click on 'Request review at Airbnb' (red button)
4. Refresh the page then click on the Airbnb listing id.
5. Go to your Airbnb Account, switch to Hosting, and click on 'Fix Issues' button for the listing.
6. Click on 'FIX' and follow the registration steps from Airbnb.
7. Click 'Publish'
<embedvideo service="youtube"><embedvideo service="youtube">https://youtu.be/gLwJWPTgrdw</embedvideo>

'''Unable to perform action. Please try again later or contact support if you need immediate assistance'''
Go to your Airbnb Account, switch to Hosting, and follow the steps in Airbnb to verify your account.

'''Unfortunately, a server error prevented your request from being completed. Airbnb may be undergoing maintenance or your connection may have timed out. Please try again.'''
If you continue to see this error message being reported, then check if there is an outage at Airbnb, we will send an update as soon as their system is restored.
Or go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING > scroll to the listing and click 'UPDATE'.

'''Calendar will not Load, it will only show a loading spinner wheel.'''
Please check that you have prices set and they are sending to AirBnb, have a look under
{{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > MAPPING, and click on "Price Data" to check if prices are being sent to AirBnb.

'''Sorry, we cannot activate your listing.'''
It seems you have an issue with your “Booking settings” in your Airbnb account. Please log into your Airbnb account and check what is set under the tab Booking Settings. You can find more information here: https://www.airbnb.com/help/article/1353/how-do-i-choose-who-can-instant-book-my-place

'''Listing shows as "Importing" in the Airbnb Extranet '''
Beds24 sent the data but it is stuck at Airbnb. Try the following:
1. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING
2. Click on "Disconnect"
4. Refresh the page then connect again
5. Wait a bit and then check the "Connection status"
If you then still see "Importing"in Airbnb contact Airbnb support and ask them to check why your listings are stuck. You might need to insist that they forward your request to someone who is qualified to do so.

'''You have reached your Airbnb access quota'''
Wait ten minutes and then try again. If it continues repeatedly let us know.

'''Your listing has been temporarily paused and can't be turned on until you reactivate it. '''
If you do not know what the problem is please check the Email Airbnb sent you, the messages in your Airbnb account or contact Airbnb support and ask them to help.

'''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.

'''Messages do not send or import to Beds24'''
Log into your Airbnb account and go to ACCOUNT -> PRIVACY AND SHARING. If you do not see 'Access and respond your messages' in the list of permissions, disconnect and then reconnect the Airbnb account.

'''Airbnb account is not connected, please connect account'''
Log into your Airbnb account

'''Receiving Requests/Inquiries for dates already booked'''
The problem is caused because Airbnb thinks your listing is a multi unit with more than one bookable unit.
This can happen if at any time you had a qty greater than one.
Once it happens, the only way to set it back to a standard listing is to disconnect the listing from Beds24 and then reconnect it.
This is because it is Airbnb policy not to change this listing type while it is connected.
It will then connect immediately as a standard listing with a qty of one and the calendar will sync properly.

'''No prices/availability in Airbnb'''
Your max_days_notice setting in Airbnb is set to zero which is making the listing unavailable.
You can adjust it directly in Airbnb, it is called maximum advance notice or similar.
Or you can set it to a specific value in Beds24 (Max Days in Advance = 365) and upload it to Airbnb via the Export to Airbnb button.
Note: {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > PRICING > Max Days in Advance = No Limit in Beds24 will not change the value already set in Airbnb.

'''Availability in Beds24/Dates closed in Airbnb'''
When Airbnb bookings have been marked as "Cancelled by Host" Airbnb will not reopen dates where you have previously cancelled a booking. The dates should be available at all other channels.

==Common Errors==

'''Not Processed '''
Airbnb had a temporary problem processing the updates we send. This normally comes good by itself when Airbnb fixed the problem. Wait a bit then press "Update" wait for Airbnb to process the update you just sent and then click "Update status". If the problem persists after a couple of hours notify us via a support ticket.

'''You do not have permission to access this resource'''
Click "Disconnect" and then reconnect the room and to your listing in Airbnb.

'''Not Connected '''
You have disconnected the listing in Airbnb. Click "Disconnect" and then reconnect it.

'''Lat/Long outside of hosting country OR Lat/lng outside of hosting country OR Please set latitude/longitude in valid country for your listing'''
Check the country under which you have registered your Airbnb account is the same as the country your property is in. Check your settings for "Latitude" and "Longitude" are correct and match the address you have given.

'''Sorry, please contact support if you need to change the market of your listing.'''
Check if your settings for "Latitude" and "Longitude" are correct and do match the address you have given. Airbnb uses Google maps to validate addresses. You can check with address and latitude/longitude is in Airbnbs system when you click on "View all listings" and then on "content in Airbnb". If required, correct your data and then click "Update Airbnb". Check your Google map entry and if it is incorrect request Google maps to correct your location. If the error message persists go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No or contact Airbnb support. Give them the error message, your coordinates and your address and ask them to forward your request to someone in their team who is authorized to fix the problem at their end.

'''You can't change your listing's address once you've started receiving reservation requests. If you need to make an update, please contact support.'''
Please check your address details in Beds24 match the details at Airbnb, if you need to change them, please contact Airbnb support and ask them to assist.
If you do not need to change your address details then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No.

'''Cannot change address in status Auto closed (availability). Please contact the local support for assistance.'''
Please check your address details in Beds24 match the details at Airbnb, if you need to change them, please contact Airbnb support and ask them to assist.
If you do not need to change your address details then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No.

'''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 API 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.

'''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€.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb calculates prices based on USD so what they calculate changes with the currency exchange rate.

'''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 {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > PROPERTY CONTENT > ROOM CONTENT and set a Rack Rate which meets Airbnb's requirements.

'''Your longer stay discount must be greater than or equal to your shorter stay discount.'''
Check your discounts set in {{#fas:cog}} (SETTINGS) > AIRBNB > SPECIFIC CONTENT > PRICING, ensure the logic of your discounts meets Airbnb requirements.
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set, 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.

'''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 ({{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID").

'''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.

'''You need to complete the API onboarding flow before publishing the listing'''
Login to your Airbnb Account, go to the listing, then click 'Fix' follow the instructions to complete the registration.

'''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.

'''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.

'''document_uri has already been taken.'''
You see this error if you have previously connected the room to another Airbnb account. Log into this Airbnb account and stop the sync for this listing. If you can not do this send us a support ticket asking us to delete the URI from the endpoint.

'''Expired Token'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''The document has no document element'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''Your listings are almost ready'''
If after some time you still see "Your listings are almost ready" after clicking Beds24 Channel Manager Sync" in Airbnb and see "In progress" on the "Listings" page check that "Publish = Yes is set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

'''Listing failed to import'''
Click on "Disconnect" then click on "Delete from Airbnb". Fix content errors. Then go back an publish the listing again.

'''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.

'''Access denied to Airbnb'''
Airbnb's server is currently unavailable. Try again later.

'''Please select a consistent property type and property group.'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Please specify the property and listing type'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''This listing's property type does not support multiple inventories.''' OR '''room_type_invetory_not_supported'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Not enough beds for person capacity'''
Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > FEATURES and click on 'edit Bedroom' tab, select the appropriate room/bedroom configuration for your listing.

'''Not enough beds in the room configuration'''
You do not have the appropriate bed configuration for the number of people you have selected in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > Max Guests. Scroll to FEATURES and click 'edit Bedroom' and select the appropriate number of bedrooms/beds for your guests.

'''Sorry, we can't add that amenity right now. Please try again later.'''
This was a transient error caused by an update to the Airbnb amenities data format. The error message should not repeat but if you continue to receive error emails, then please create a SUPPORT ticket.

'''Please make sure a photo has been uploaded before adding accessibility amenity. If the previous review rejects your photos, you need to upload a new photo'''
You are trying to send an accessibility amenity but do not provide a picture for this amenity. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT where you can add the accessibility amenity with a picture in "Custom". Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for further instructions.

'''All caps isn't allowed in listing titles.'''
Airbnb do not allow the Listing Name to be ALL Caps. Check the details in each of the sections below.
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > NAME
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > NAME
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > DESCRIPTIONS

'''Emojis/Special Characters isn't allowed in listing titles.'''
Airbnb do not allow the Listing Name to have emojis or special characters. Check the details in each of the sections below.
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > NAME
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > NAME
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > DESCRIPTIONS

'''Please select a consistent property type and space type'''
Check the details you have set in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION > PROPERTY TYPE, allow the setting you have selected in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > PROPERTY TYPE GROUP > LISTING TYPE. Use (?) Context help for the list of Property Types and Listing Types for Airbnb.

'''You can only host long-term rentals'''
Go to your Airbnb Account, switch to Hosting, and click on 'Fix Issues' button for the listing.
Follow the registration steps from Airbnb.

'''custom_daily_price_too_low_for_cleaning_fee''' OR '''Based on your cleaning fee of € XXX, the minimum nightly price you can charge is € YYY'''
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > CUSTOM and change your Cleaning fee.
OR
Go to the Calendar and update the daily prices.

'''Listings of different pricing_availability_model_type can not use this endpoint.'''
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and click 'UPDATE' for each room/listing.

'''Suspended_state_appeal'''
Airbnb suspended the account. Please contact Airbnb support about this.

Setting/properties.airbnbautorevt

2024-08-18T15:12:46Z

IuriRosa:

When you enter a review text, guests will automatically receive a five-star review along with the provided text four days after check-out, unless you have already manually reviewed the guest.

You can personalize your review by using Template Variables.

If you’re using automated reviews but wish to give the guest a rating different from five stars or change the provided text, you can manually review the guest within one day after check-out.

If the review text field is left empty, reviews will not be sent automatically. You can then manually review all guests from the "Mail & Action" tab in the booking.

Yield Optimiser

2024-07-28T08:52:31Z

IuriRosa: /* Setp */

[[Category:Prices]]
[[Category:Automation]]
[[Category:Dynamic_Prices]]
[[Category:Rules]]
[[Category:Enhanced_Selling]]
<div class="heading">Yield Optimizer</div>
This page is about the menu PRICES >YIELD OPTIMISER and explains how to create rules to automatically adjust prices.
__TOC__

=Summary=
<div class="summarybox">
The idea of the yield optimizer is to automatically adjust prices based on demand shortly before check-in.

You can set up rules to adjust your prices up or down. Multiple rules can be created and will work together.

Each rule can be assigned to one or more rooms. A rule will only adjust the price when it's trigger condition is met and if the room multiplier is not manually over-ridden.

The multiplier will apply to all prices. If you use Fixed Prices you can deactivate the multiplier by setting "Allow Multiplier" = No in the Summary tab of the Fixed Price.
</div>
=Setup=

== Rule ==
Set the start and end dates when the rule is valid and the percentage value of your normal price to charge when the rule is triggered.

Examples: The regular price per night is €100. 40% will lower the price to €40. 150% will raise the price to €150. 100% will leave the price unchanged.

The percentage to which a price is changed by the yield optimizer will show in the CALENDAR with a blue background. These automatic values can be manually over-ridden. Manual overrides will have a white background.

[[Image:yield.png|300px|link=]]
[[Media:yield.png|view large]]

The maximum value is 250%.

You can choose the rule not to apply for channel management.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> The yield optimizer will NOT override manually entered multipliers. To remove a manual rule go to the Calendar, click in the Price multiplier row, select 'Auto' from the drop-down list and enter a date range This will allow any Yield Optimiser rule to be applied.

== Trigger ==
Set the condition when the prices should be changed. Rules will trigger on a per date basis so they will only trigger on dates which meet the trigger condition.

A rule can be applied to bookings with arrival up to 30 days in advance. It can be restricted to a shorter period or a time window.

A rule can be set to apply when a certain number of rooms is available on the night.
*If multiple rooms are selected the availability in these rooms will be added up. This sum is then the trigger which will apply the rule.
*If no rooms are ticked the rule will automatically use the availability in the room or rooms selected in the "Apply to" tab. In this case the availability of each individual room is used to trigger the rule on that room.

== Apply to ==
The rule will be applied to the ticked rooms.

Multiple rules can apply at the same time and the changes will accumulate.

Example: Original price = 100€, Rule 1 = 120%, Rule 2 = 150%. After the application of both rules the price will come to 180€.

Explanation:
*120% of 100€ = '''120'''€.
*150% of '''120'''€ = 180€.

Note: The order of the rules does NOT matter, because:
*150% of 100€ = '''150'''€.
*120% of '''150'''€ = 180€.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> We recommend you check carefully that your rules work as expected.

Outgoing Email

2024-05-08T13:34:01Z

IuriRosa: /* Microsoft Live (Hotmail) */

[[Category:Messaging]]
[[Category:Account]]
[[Category:Troubleshooting]]
<div class="heading">Outgoing Email</div>
This page is about the menu {{#fas:cog}} (SETTINGS) ACCOUNT > OUTGOING EMAIL and explains how to send Emails to guests from your own Email address instead of a Beds24 Email address.

__TOC__
= General =
'''Sending Account''': Choose whether to use the system email server or your own email address to send email.

If you choose your own email address the guest will receive an email confirmation from your email address and you will see sent mails in your outgoing mail folder.
You can use your own email service via SMTP or Mailgun, It is also possible to use both, first we will try your SMTP server and if this fails we will try Mailgun. If both fail, the mail will be sent by the system email server.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you have entered a property Email address in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION replies from guests to confirmation messages will be sent in cc to the property EMail address. If you do not want this do not enter a property Email address.

If you do not use your own email, the guest will receive a booking notification from the system Email address.

'''The following settings are required if you use your own email address''':

'''Email Address''': This is the email address which will send email notifications.

'''Mail Server''': This is the email server which will send your email. For example the gmail server is smtp.gmail.com.

'''User Name''': This is the user name for your email server. This is often your email address.

'''Password''': This is the password for your email server. (See the details below for GMAIL Application Password)

'''Use Encryption''': This is the email server encryption setting. For example the gmail server requires SSL.

'''Port Number''': This is the email server SMTP port. This is normally 25 but can be different. For example the gmail server uses 465.

= Standard Email Providers =
== Gmail / Googlemail ==
You need to create and use an Application Password for the Gmail account because if you try to use your normal Gmail password Google might block the emails from sending and treat them as spam. Google explains how to do this [https://support.google.com/mail/answer/1173270?hl=en here.]

Mail Server: smtp.gmail.com

Encryption: SSL

Port: 465

If you have a Gmail (Googlemail) G-Suite Account (pro version):

You may need the following settings in Google to allow Email sending via Gmail:

*Open your Google Admin console (admin.google.com).
*Click SECURITY >
*Under "How you sign in to Google,"
*Click on 2-Step Verification, follow the login steps then select App Passwords.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you do not see the App Passwords link, then use this URL : https://myaccount.google.com/apppasswords

If you don’t have this option, it might be because:
*2-Step Verification is not set up for your account.
*2-Step Verification is only set up for security keys.
*Your account is through work, school, or other organisation.
*You turned on Advanced Protection.

At the bottom,
*choose Select app and choose the app you are using
*Select the device and choose the device you’re using and then Generate.
**Select App – Email
**Select Device – Other Custom Name

*In the next window write Beds24 and click Generate.
*Copy the generated Password

'''BEDS24'''
*Go to (SETTINGS) ACCOUNT > OUTGOING EMAIL and replace/paste the generated Password into the password field.

*Click SAVE.

==Microsoft Live (Hotmail)==

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Microsoft live has issues with external systems like Beds24 sending email and can block mails, we cannot recommend this system, use at your own risk.

Mail Server: smtp.live.com OR smtp-mail.outlook.com (Check the details from your email service)

Encryption: No

Port: 587 or 25

'''Set up'''

[[Image:outgoing1.png|500px|link=]]
[[Media:outgoing1.png|view large]]

The system can use your own Email address

[[Image:outgoing2.png|500px|link=]]
[[Media:outgoing2.png|view large]]

If you see an error message please check
*are all entries correct
*some systems require authentication. Please see "Trouble Shooting" (below)

[[Image:outgoing3.png|500px|link=]]
[[Media:outgoing3.png|view large]]

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>If the system fails to send a email, you might have 2-Step Authentication enabled in your Live account, you will need to create a app password

*Log into your Microsoft Live account, Go to Options > Account details (top of the list). You may be asked to sign in.

*After the account.live.com page has opened, select Security & Privacy, go to More Security Settings, scroll down and select Set up two-step verification.

*You'll have the option to confirm your identity via email, phone or the Microsoft account App. After you've completed this step, you'll need to use an app-specific password to log in via the Outlook App.

*Under Security & Privacy > More Security Settings, scroll down and select Create a new app password. Use the newly generated app password as your password for the outgoing email in Beds24.

[[:category:Sub_Account|Sub accounts]] can be used to use different outgoing Email addresses for multiple properties in one account.

= Mailgun=

Mailgun is a mail sending service.

You will need an account at mailgun and can get the Key and Domain values from your mailgun account.

= SPF Record =
Adding the following SPF record to your sending domain may help delivery of your emails and prevent them being treated as spam. Please refer to your domain register for help adding an SPF record to your domain.

v=spf1 include:mail.beds24.com ~all

= Trouble Shooting =
Hotmail and other providers might ask for '''authentication'''. Log into your Email account, check your notifications
or settings and follow the instructions given by your Email provider. If you cannot find them ask your provider
what you need to do to let third parties like Beds24 send Emails through your SMTP server.

'''Emails are not sending'''
1. Check if you outgoing E-mail is working by clicking on "Send Test Email".
2. Check your "Descriptive Sending Email Address", it cannot be a word only. The pop up help for the setting has examples of valid formats.

'''If E-mail are sending but guests do not receive your E-mails''' you can use a tool like https://www.mail-tester.com/ to check what the problem might be.

Outgoing Email

2024-05-08T13:32:34Z

IuriRosa: /* Microsoft Live (Hotmail) */

[[Category:Messaging]]
[[Category:Account]]
[[Category:Troubleshooting]]
<div class="heading">Outgoing Email</div>
This page is about the menu {{#fas:cog}} (SETTINGS) ACCOUNT > OUTGOING EMAIL and explains how to send Emails to guests from your own Email address instead of a Beds24 Email address.

__TOC__
= General =
'''Sending Account''': Choose whether to use the system email server or your own email address to send email.

If you choose your own email address the guest will receive an email confirmation from your email address and you will see sent mails in your outgoing mail folder.
You can use your own email service via SMTP or Mailgun, It is also possible to use both, first we will try your SMTP server and if this fails we will try Mailgun. If both fail, the mail will be sent by the system email server.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you have entered a property Email address in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION replies from guests to confirmation messages will be sent in cc to the property EMail address. If you do not want this do not enter a property Email address.

If you do not use your own email, the guest will receive a booking notification from the system Email address.

'''The following settings are required if you use your own email address''':

'''Email Address''': This is the email address which will send email notifications.

'''Mail Server''': This is the email server which will send your email. For example the gmail server is smtp.gmail.com.

'''User Name''': This is the user name for your email server. This is often your email address.

'''Password''': This is the password for your email server. (See the details below for GMAIL Application Password)

'''Use Encryption''': This is the email server encryption setting. For example the gmail server requires SSL.

'''Port Number''': This is the email server SMTP port. This is normally 25 but can be different. For example the gmail server uses 465.

= Standard Email Providers =
== Gmail / Googlemail ==
You need to create and use an Application Password for the Gmail account because if you try to use your normal Gmail password Google might block the emails from sending and treat them as spam. Google explains how to do this [https://support.google.com/mail/answer/1173270?hl=en here.]

Mail Server: smtp.gmail.com

Encryption: SSL

Port: 465

If you have a Gmail (Googlemail) G-Suite Account (pro version):

You may need the following settings in Google to allow Email sending via Gmail:

*Open your Google Admin console (admin.google.com).
*Click SECURITY >
*Under "How you sign in to Google,"
*Click on 2-Step Verification, follow the login steps then select App Passwords.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you do not see the App Passwords link, then use this URL : https://myaccount.google.com/apppasswords

If you don’t have this option, it might be because:
*2-Step Verification is not set up for your account.
*2-Step Verification is only set up for security keys.
*Your account is through work, school, or other organisation.
*You turned on Advanced Protection.

At the bottom,
*choose Select app and choose the app you are using
*Select the device and choose the device you’re using and then Generate.
**Select App – Email
**Select Device – Other Custom Name

*In the next window write Beds24 and click Generate.
*Copy the generated Password

'''BEDS24'''
*Go to (SETTINGS) ACCOUNT > OUTGOING EMAIL and replace/paste the generated Password into the password field.

*Click SAVE.

==Microsoft Live (Hotmail)==

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Microsoft live has issues with external systems like Beds24 sending email and can block mails, we cannot recommend this system, use at your own risk.

Mail Server: smtp.live.com OR smtp-mail.outlook.com (Check the details from your email service)

Encryption: No

Port: 587 or 25

'''Set up'''

[[Image:outgoing1.png|500px|link=]]
[[Media:outgoing1.png|view large]]

The system can use your own Email address

[[Image:outgoing2.png|500px|link=]]
[[Media:outgoing2.png|view large]]

If you see an error message please check
*are all entries correct
*some systems require authentication. Please see "Trouble Shooting" (below)

[[Image:outgoing3.png|500px|link=]]
[[Media:outgoing3.png|view large]]

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>If the system fails to send a email, you might have 2-Step Authentication enabled in your Live account,

*Log into your Microsoft Live account, Go to Options > Account details (top of the list). You may be asked to sign in.

*After the account.live.com page has opened, select Security & Privacy, go to More Security Settings, scroll down and select Set up two-step verification.

*You'll have the option to confirm your identity via email, phone or the Microsoft account App. After you've completed this step, you'll need to use an app-specific password to log in via the Outlook App.

*Under Security & Privacy > More Security Settings, scroll down and select Create a new app password. Use the newly generated app password as your password for the outgoing email in Beds24.

[[:category:Sub_Account|Sub accounts]] can be used to use different outgoing Email addresses for multiple properties in one account.

= Mailgun=

Mailgun is a mail sending service.

You will need an account at mailgun and can get the Key and Domain values from your mailgun account.

= SPF Record =
Adding the following SPF record to your sending domain may help delivery of your emails and prevent them being treated as spam. Please refer to your domain register for help adding an SPF record to your domain.

v=spf1 include:mail.beds24.com ~all

= Trouble Shooting =
Hotmail and other providers might ask for '''authentication'''. Log into your Email account, check your notifications
or settings and follow the instructions given by your Email provider. If you cannot find them ask your provider
what you need to do to let third parties like Beds24 send Emails through your SMTP server.

'''Emails are not sending'''
1. Check if you outgoing E-mail is working by clicking on "Send Test Email".
2. Check your "Descriptive Sending Email Address", it cannot be a word only. The pop up help for the setting has examples of valid formats.

'''If E-mail are sending but guests do not receive your E-mails''' you can use a tool like https://www.mail-tester.com/ to check what the problem might be.

Outgoing Email

2024-05-08T13:31:57Z

IuriRosa: /* Microsoft Live (Hotmail) */

[[Category:Messaging]]
[[Category:Account]]
[[Category:Troubleshooting]]
<div class="heading">Outgoing Email</div>
This page is about the menu {{#fas:cog}} (SETTINGS) ACCOUNT > OUTGOING EMAIL and explains how to send Emails to guests from your own Email address instead of a Beds24 Email address.

__TOC__
= General =
'''Sending Account''': Choose whether to use the system email server or your own email address to send email.

If you choose your own email address the guest will receive an email confirmation from your email address and you will see sent mails in your outgoing mail folder.
You can use your own email service via SMTP or Mailgun, It is also possible to use both, first we will try your SMTP server and if this fails we will try Mailgun. If both fail, the mail will be sent by the system email server.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you have entered a property Email address in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION replies from guests to confirmation messages will be sent in cc to the property EMail address. If you do not want this do not enter a property Email address.

If you do not use your own email, the guest will receive a booking notification from the system Email address.

'''The following settings are required if you use your own email address''':

'''Email Address''': This is the email address which will send email notifications.

'''Mail Server''': This is the email server which will send your email. For example the gmail server is smtp.gmail.com.

'''User Name''': This is the user name for your email server. This is often your email address.

'''Password''': This is the password for your email server. (See the details below for GMAIL Application Password)

'''Use Encryption''': This is the email server encryption setting. For example the gmail server requires SSL.

'''Port Number''': This is the email server SMTP port. This is normally 25 but can be different. For example the gmail server uses 465.

= Standard Email Providers =
== Gmail / Googlemail ==
You need to create and use an Application Password for the Gmail account because if you try to use your normal Gmail password Google might block the emails from sending and treat them as spam. Google explains how to do this [https://support.google.com/mail/answer/1173270?hl=en here.]

Mail Server: smtp.gmail.com

Encryption: SSL

Port: 465

If you have a Gmail (Googlemail) G-Suite Account (pro version):

You may need the following settings in Google to allow Email sending via Gmail:

*Open your Google Admin console (admin.google.com).
*Click SECURITY >
*Under "How you sign in to Google,"
*Click on 2-Step Verification, follow the login steps then select App Passwords.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you do not see the App Passwords link, then use this URL : https://myaccount.google.com/apppasswords

If you don’t have this option, it might be because:
*2-Step Verification is not set up for your account.
*2-Step Verification is only set up for security keys.
*Your account is through work, school, or other organisation.
*You turned on Advanced Protection.

At the bottom,
*choose Select app and choose the app you are using
*Select the device and choose the device you’re using and then Generate.
**Select App – Email
**Select Device – Other Custom Name

*In the next window write Beds24 and click Generate.
*Copy the generated Password

'''BEDS24'''
*Go to (SETTINGS) ACCOUNT > OUTGOING EMAIL and replace/paste the generated Password into the password field.

*Click SAVE.

==Microsoft Live (Hotmail)==

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Microsoft live has issues with external systems like Beds24 sending email and can block mails, we cannot recommend this system, use at your own risk.

Mail Server: smtp.live.com OR smtp-mail.outlook.com (Check the details from your email service)

Encryption: No

Port: 587 or 25

'''Set up'''

[[Image:outgoing1.png|500px|link=]]
[[Media:outgoing1.png|view large]]

The system can use your own Email address

[[Image:outgoing2.png|500px|link=]]
[[Media:outgoing2.png|view large]]

If you see an error message please check
*are all entries correct
*some systems require authentication. Please see "Trouble Shooting" (below)

[[Image:outgoing3.png|500px|link=]]
[[Media:outgoing3.png|view large]]

If the system fails to send a email, you might have 2-Step Authentication enabled in your Live account,

*Log into your Microsoft Live account, Go to Options > Account details (top of the list). You may be asked to sign in.

*After the account.live.com page has opened, select Security & Privacy, go to More Security Settings, scroll down and select Set up two-step verification.

*You'll have the option to confirm your identity via email, phone or the Microsoft account App. After you've completed this step, you'll need to use an app-specific password to log in via the Outlook App.

*Under Security & Privacy > More Security Settings, scroll down and select Create a new app password. Use the newly generated app password as your password for the outgoing email in Beds24.

[[:category:Sub_Account|Sub accounts]] can be used to use different outgoing Email addresses for multiple properties in one account.

= Mailgun=

Mailgun is a mail sending service.

You will need an account at mailgun and can get the Key and Domain values from your mailgun account.

= SPF Record =
Adding the following SPF record to your sending domain may help delivery of your emails and prevent them being treated as spam. Please refer to your domain register for help adding an SPF record to your domain.

v=spf1 include:mail.beds24.com ~all

= Trouble Shooting =
Hotmail and other providers might ask for '''authentication'''. Log into your Email account, check your notifications
or settings and follow the instructions given by your Email provider. If you cannot find them ask your provider
what you need to do to let third parties like Beds24 send Emails through your SMTP server.

'''Emails are not sending'''
1. Check if you outgoing E-mail is working by clicking on "Send Test Email".
2. Check your "Descriptive Sending Email Address", it cannot be a word only. The pop up help for the setting has examples of valid formats.

'''If E-mail are sending but guests do not receive your E-mails''' you can use a tool like https://www.mail-tester.com/ to check what the problem might be.

Outgoing Email

2024-05-08T13:29:34Z

IuriRosa: /* Microsoft Live (Hotmail) */

[[Category:Messaging]]
[[Category:Account]]
[[Category:Troubleshooting]]
<div class="heading">Outgoing Email</div>
This page is about the menu {{#fas:cog}} (SETTINGS) ACCOUNT > OUTGOING EMAIL and explains how to send Emails to guests from your own Email address instead of a Beds24 Email address.

__TOC__
= General =
'''Sending Account''': Choose whether to use the system email server or your own email address to send email.

If you choose your own email address the guest will receive an email confirmation from your email address and you will see sent mails in your outgoing mail folder.
You can use your own email service via SMTP or Mailgun, It is also possible to use both, first we will try your SMTP server and if this fails we will try Mailgun. If both fail, the mail will be sent by the system email server.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you have entered a property Email address in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION replies from guests to confirmation messages will be sent in cc to the property EMail address. If you do not want this do not enter a property Email address.

If you do not use your own email, the guest will receive a booking notification from the system Email address.

'''The following settings are required if you use your own email address''':

'''Email Address''': This is the email address which will send email notifications.

'''Mail Server''': This is the email server which will send your email. For example the gmail server is smtp.gmail.com.

'''User Name''': This is the user name for your email server. This is often your email address.

'''Password''': This is the password for your email server. (See the details below for GMAIL Application Password)

'''Use Encryption''': This is the email server encryption setting. For example the gmail server requires SSL.

'''Port Number''': This is the email server SMTP port. This is normally 25 but can be different. For example the gmail server uses 465.

= Standard Email Providers =
== Gmail / Googlemail ==
You need to create and use an Application Password for the Gmail account because if you try to use your normal Gmail password Google might block the emails from sending and treat them as spam. Google explains how to do this [https://support.google.com/mail/answer/1173270?hl=en here.]

Mail Server: smtp.gmail.com

Encryption: SSL

Port: 465

If you have a Gmail (Googlemail) G-Suite Account (pro version):

You may need the following settings in Google to allow Email sending via Gmail:

*Open your Google Admin console (admin.google.com).
*Click SECURITY >
*Under "How you sign in to Google,"
*Click on 2-Step Verification, follow the login steps then select App Passwords.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you do not see the App Passwords link, then use this URL : https://myaccount.google.com/apppasswords

If you don’t have this option, it might be because:
*2-Step Verification is not set up for your account.
*2-Step Verification is only set up for security keys.
*Your account is through work, school, or other organisation.
*You turned on Advanced Protection.

At the bottom,
*choose Select app and choose the app you are using
*Select the device and choose the device you’re using and then Generate.
**Select App – Email
**Select Device – Other Custom Name

*In the next window write Beds24 and click Generate.
*Copy the generated Password

'''BEDS24'''
*Go to (SETTINGS) ACCOUNT > OUTGOING EMAIL and replace/paste the generated Password into the password field.

*Click SAVE.

==Microsoft Live (Hotmail)==

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Microsoft live has issues with external systems like Beds24 sending email and can block mails, we cannot recommend this system, use at your own risk.

Mail Server: smtp.live.com OR smtp-mail.outlook.com (Check the details from your email service)

Encryption: No

Port: 587 or 25

'''Set up'''

[[Image:outgoing1.png|500px|link=]]
[[Media:outgoing1.png|view large]]

The system can use your own Email address

[[Image:outgoing2.png|500px|link=]]
[[Media:outgoing2.png|view large]]

If you see an error message please check
*are all entries correct
*some systems require authentication. Please see "Trouble Shooting" (below)

[[Image:outgoing3.png|500px|link=]]
[[Media:outgoing3.png|view large]]

If the system fails to send a email, you might have 2-Step Authentication enabled in your Live account,

Log into your Microsoft Live account, Go to Options > Account details (top of the list). You may be asked to sign in.

After the account.live.com page has opened, select Security & Privacy, go to More Security Settings, scroll down and select Set up two-step verification.

You'll have the option to confirm your identity via email, phone or the Microsoft account App. After you've completed this step, you'll need to use an app-specific password to log in via the Outlook App.

Under Security & Privacy > More Security Settings, scroll down and select Create a new app password. Use the newly generated password to log in.

[[:category:Sub_Account|Sub accounts]] can be used to use different outgoing Email addresses for multiple properties in one account.

= Mailgun=

Mailgun is a mail sending service.

You will need an account at mailgun and can get the Key and Domain values from your mailgun account.

= SPF Record =
Adding the following SPF record to your sending domain may help delivery of your emails and prevent them being treated as spam. Please refer to your domain register for help adding an SPF record to your domain.

v=spf1 include:mail.beds24.com ~all

= Trouble Shooting =
Hotmail and other providers might ask for '''authentication'''. Log into your Email account, check your notifications
or settings and follow the instructions given by your Email provider. If you cannot find them ask your provider
what you need to do to let third parties like Beds24 send Emails through your SMTP server.

'''Emails are not sending'''
1. Check if you outgoing E-mail is working by clicking on "Send Test Email".
2. Check your "Descriptive Sending Email Address", it cannot be a word only. The pop up help for the setting has examples of valid formats.

'''If E-mail are sending but guests do not receive your E-mails''' you can use a tool like https://www.mail-tester.com/ to check what the problem might be.

VRBO Setup

2024-03-15T23:04:43Z

IuriRosa: /* Payments and Payment Schedule */

[[Category:Channel Manager]]
[[Category:VRBO]]

<div class="heading">Connect with Vrbo / Homeaway Group</div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > ACCOUNT and {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > MAPPING and explains how connect to Vrbo/Homewaway and their companies.

= Capabilities =
Via the XML connection Beds24 can
*Export property listings content (create listings at Vrbo)
*Update existing listings on Vrbo
*Export prices and availability
*Import bookings
*Send date changes and status changes to "Cancelled"
*See all messages from Airbnb guests under "Messages".
*Communicate with your guests directly from the booking in Beds24 via the "Messages" tab and via Auto Actions.

To allow accurate commission calculation we have to provide Vrbo with a feed which contains all Vrbo bookings.

If you use the XML connection all updates should be done in Beds24 (not in Vrbo) because changes you make in Vrbo will be overridden with the next update.

The connection can update following Vrbo brands:

Homeaway.com,
Vrbo.com,
abritel.fr,
aluguetemporada.com.br,
CanadaStays,
fewo-direkt.de,
homdelidays.es,
homdelidays.it,
homeaway.at,
homeaway.ca,
homeaway.co.au,
homeaway.co.mx,
homeaway.co.uk,
homeaway.dk,
homeaway.es,
homeaway.fi,
homeaway.gr,
homeaway.it,,
homeaway.nl,,
homeaway.no,
homeaway.pl,
homeaway.pt,
homeaway.se,
homelidays.com,
ownersdirect.co.uk,
stayz.co.au
vacationrentals.com.

By default your listings are in "instant" book. Having listings on "Request" is not recommended because this will have a negative impact on ranking and bookings. Upon request we can set individual properties to be on "request".

= Limitations =
*Vrbo do not allow same day bookings.
*Most agencies/property managers can use Vrbos XML connection but you must have a tax number and a credit card. If you are not eligible your can use our [[Homeaway.com_iCal| Vrbo iCal]] connection to synchronise calendars.
*You can not move properties which are connected between two Beds24 accounts which are connected to Vrbo if they have bookings because this will upset VrboS commission calculation and you might get charged twice.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> '''You can not change your username when connected to Vrbo because this will break the connection.'''

= Before you connect=
==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]].

==Bookings==
Only bookings made after the connection is established will be imported and can be managed. Existing bookings can be imported via iCal or manually.

Vrbo does not send confirmation messages. They require these to be sent from Beds24. The confirmation message you have set up in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > CONFIRMATION MESSAGES will be sent to the guest.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> We do not support sending different messages based on the type of payment for Vrbo, the standard confirmation message will be sent.

==Properties, rooms and room types==
Our connection supports room types with a quantity of more than one.

==You need==
Vrbo requires you to have a '''credit card''' and a '''tax number / tax identifyer'''

= Setup =
Vrbos XML activation applies per Beds24 account. All properties owned by the connected Beds24 account or sub account can send to the connected Vrbo account. If you want to connect properties owned by different account/sub accounts you can override this. Click on the 'User' icon on the top right and then on 'Account Management (in the old control panel SUB ACCOUNT in the top right) Manage Account > Manage Property and go to "Channel Management". The setting "Vrbo Connect via Account" allows you to set that the property connects to Vrbo via a different account than the one owning it.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Vrbo provides a self-onboarding tool which is started from Beds24. If self-onboarding is not available in your region you will not be able to complete the setup and Vrbo will automatically create a support case and get in touch with you.

''' Step 1: Activate your rooms'''

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > MAPPING and tick "Enable" for all rooms you want to connect. Click on HELP <span style="color:#007bff;“ >{{#far:question-circle}} </span> in the top right of this page for detailed instructions.

If you see a red button "Fix Content Errors" your content does not meet Vrbos requirements. Click on the button. Any settings which do not meet Vrbos requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.

'''Step 2: Have your credit card and your tax number/tax identifier on hand'''

During the onboarding process Vrbo will ask you to enter your credit card and your tax number.

'''Step 3: Self-onboard to Vrbo '''

When at least one room is activated to sending you can start the self-onboarding process.
*If you have subaccounts double check you are logged into the account/subaccount you want to connect.
*Click on "Connect with Vrbo. This will start Vrbos self-onboarding process.
*Follow the steps.

This will automatically generate your "Vrbo Software User ID" which you can always see in in Beds24 under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > ACCOUNT / MAPPING.

Vrbo defines the currency you can use for your Vrbo account. Make sure this currency is set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > ACCOUNT and is used in all properties in this Beds24 account. If you use a different currency in Beds24 you can set a multiplier in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > MAPPING. Click on HELP <span style="color:#007bff;“ >{{#far:question-circle}} </span> in the top right of this page for detailed instructions.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> After you have connected with Vrbo you will have a "View Listings" button. When you click you will see the properties/rooms which are in Beds24 feed for Vrbo.

In Beds24:

[[File:connect_vrbo.mp4|640px]]

In Vrbo if you do not yet have a Vrbo account:

[[File:ssl_vrbo_new.mp4|640px]]

In VRBO if you do have a Vrbo account:

[[File:ssl_vrbo.mp4|640px]]

'''Step 5 - Enter registration (optional if registration is mandatory)'''

*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > MAPPING
*Click on the "Registration details" button
*Click on "Update Registration" to enter you registration details.

'''Step 6 - Check the listing status'''
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > MAPPING
*Click on the "View Status at Vrbo" button
*Check the content especially the "activeStatus"

'''Step 7 - Add your reviews (optional)'''

We can upload the reviews you already have to Vrbo. Vrbo only accepts direct reviews including reviews from your own website,Tripadvisor, Google or other sources for which you have the right to use them on your own website. Vrbo will not accept any reviews from other OTAs including Airbnb or Booking.com.

If you want us to send your reviews to Vrbo tell your Vrbo activation specialist for how far back you have reviews and then reach out to us via a support ticket.

= Vrbo.com Offline Bookings / Data protection=
Vrbo requires you mark bookings which originated from a Vrbo enquiry by setting the Referer value on the "Details" tab of the booking to '''Vrbo'''. Vrbo requires you to enter the guests Email address in the booking.

Vrbo will have access to these bookings for reporting purposes.

Make sure you comply with your local data protection laws.

= Updates =
Changes to availability and prices will be instantly sent to the channel. Other changes will be pulled by Vrbo with their next poll.

=Send and receive messages =
You can get communicate with Vrbo guest directly from Beds24. This function works for confirmed bookings only, inquiries/requests are currently not imported

You can view all messages from the "Messages" component on the DASHBOARD and individual communication from the "API Messages" tab in the booking.

To use this function you should:

1. Add the component "API Messages" to your [[:Category:Dashboard|DASHBOARD]]

2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options. We will remove the HTML from the message because Vrbo does not support HTML. You have the option to add a plain text message for this purpose.

Vrbo supports attachments in PDF, JPG, PNG, and GIF format.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have moved the booking to a different room (manually or via dependencies), then ensure that both properties/rooms are connected with the same Vrbo account, otherwise this function will not work.

= Cancellations =
If you set a booking to "Cancelled" we will send it as "Cancelled by guest" (this is the default) to Vrbo. If the booking is cancelled by the host you can set this as a "substatus" via the second selector next to the "Cancelled" status in the "Summary" tab of the booking, we will then send "Cancelled by Owner" to Vrbo.

<div class="warning">{{#fas:exclamation-triangle}} Never delete bookings from Vrbo because Vrbo expect to read the booking status even if they are cancelled.
</div>

=Special offers for guests =
If you want to offer a guest a special price ask the guest to book at full price. After the booking has been imported you can change the price and manually send the guest a confirmation with the revised price.

Beds24 will automatically send the amended price to Vrbo so Vrbo can adjust your commission.

=Vrbo commission=
To allow accurate commission calculation we have to provide Vrbo with a feed which contains all Vrbo bookings.

If you have added on-site services to the booking, you can add the status '''stayfee''' to them. The status needs to start with stayfee but you can add to is for example stayfee_tour. Vrbo will then not take this item into account when calculating the commission.

= Listing Content =
=== Checklist===
These factors are important for the performance of your listings:
*Choose your headline carefully and make sure your key (first) picture and your headline work together.
*Recommended are 24 pictures, make sure all have captions.
*Add '''Location Type ''' feature so your listing will show in location based searches.
*Add ''cleaning''' features''.
*Listings where guests do not have to pay the full amount with the booking perform better.
=== Languages ===
Vrbo will inform you which language is compulsory. It is the language of the Vrbo site you are listed. If this language is different from the language you use as default language for your booking page you can set it in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC CONTENT.

If you need to activate languages go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALISATION.

=== Listings ===
A listing is created for every room in Beds24.
*The "Headline" for the listing comes from "Room Headline" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT. If this field is empty the "Headline" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT will be used.
*The "Property Name" comes from the "Name" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. If you want to give each listing its own property name even though they are in one property in Beds24 you can enter a unique "Name" for each in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO> SPECIFIC ROOM CONTENT.

==== Minimum Requirements ====
To send property information to Vrbo, the following information must be entered into Beds24 to meet the Vrbo minimum content requirement for listings:
*Property name
*Property type
*Maximum number of guests
*Accurate address for each property
*Latitude and longitude for each property
*At least 6 pictures for each listing recommended resolution of 1920x1080.
*Headlines with at least 20 characters
*Each listing must have at least one bedroom and one bathroom
*For online bookings you will need prices and inventory

==== Room Configurations - Define Bedrooms and Bathrooms====
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS->SET UP.

*Click on the "edit bedrooms" or "edit bathrooms" button
*Set the type and use the selectors to define the facilities within each.
*If you have multiple bedrooms or bathrooms make sure you define them all.
*Close the pop up and then press SAVE.

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Vrbo does not support all features Beds24 offers. For a list of all feature codes Vrbo supports see "All feature codes" below.

==== Amenities, Features and Location Type====
Amenities and Location Type can be set up for the property {{#fas:cog}} (SETTING) ->PROPERTIES->DESCRIPTION) or per room {{#fas:cog}} (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 Internet. In this case you can set up the Internet in {{#fas:cog}} (SETTING)->PROPERTIES->DESCRIPTION. The number will be applied to all room/units.

Example 2: You have one unit with Internet one and another unit without Internet. In this case set the Internet up in SETTING->PROPERTIES->ROOMS->SET UP.

Features and 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.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Adding "cleaning" features and a "location type" is very important for your performance. You add them manually. Bedrooms and bathrooms and amenities can also be inserted manually. For more information see "All feature codes" below.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> For a list of all feature codes and location types Vrbo supports see "All feature codes" below.

==== Prices ====
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT you can set which type of price you want to send.

With '''Per Occupancy Pricing (LOS)''' a price for each occupancy defined in Beds24 and prices for different length of stay can be sent.

If you use Fixed Prices the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple prices with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices can not be sent.

If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.

"Max Stay" set in the CALENDAR or prices can be sent.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Beds24 sends the price for max. 16 guests. If your property accommodates more than 16 guests use "Per Day" pricing with an extra person price.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Vrbo 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 Vrbo with different minimum stays the system will send the price with the lowest minimum stay. Vrbo 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. If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send. With Per Day Pricing you can also set an extra person price.
*The number of guests for which the price applies.
*An extra person price.
*A long stay discount. Discounts are only applied to the room price not on extras. Vrbo stay discounts are cumulative.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Click on the "View Actual Data" button in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER- >VRBO > MAPPING to check which prices and availability will send.

=====Currency=====
Vrbo defines the currency used in Vrbo. You can use a multiplier if your currency in Vrbo is different from your currency in Beds24.

You can either use a fixed factor for currency conversion or '''currency conversion''' template variables. All currencies supported by the booking page currency selector can be used.

Example 1 fixed factor: '''*1.23*''' will multiply all prices by 1.23 sent (i.e. raised by 23%).

Lower prices can be sent with a multiplier less than 1, i.e. '''*0.85*''' will send a price of 85% of the normal price (i.e. lowered by 15%).

Example 2 '''currency conversion''' template variables: '''*[CONVERT:THB-USD]*''' will convert THB to USD to send to Vrbo and store bookings converted into THB.

The * at the end will add an info item '''Vrbo_MULT''' to the booking with the conversion rate applied to the imported booking. This info item is used to convert the financial figures back to the values originally sent by Vrbo when Vrbo check the status of the booking.

For example 2 the info code VRBO_MULT will convert the THB in the booking to USD when Vrbo read the booking status.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Vrbo reads the bookings from Beds24 and calculates their commission from what they read. Do not manually convert the prices imported from Vrbo to convert currencies because Vrbo will then charge you wrong commission.

=====Price Multiplier=====
If you want to add a markup to your prices you can add it to the "Price Multiplier" field in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > MAPPING.

The multiplier applies to all prices and fees which are sent.

For example, '''*1.23''' will multiply all prices by 1.23 sent for the property (i.e. raised by 23%).
Lower prices can be sent with a multiplier less than 1, i.e. '''*0.85''' will send a price of 85% of the normal price (i.e. lowered by 15%).

===== Taxes & Fees=====
Taxes and fees can be added in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > SPECIFIC ROOM CONTENT under "Custom".

*Taxes and fees can apply as a flat fee, a percentage, per day or per guest.
*You can choose taxes and fees to be "stay collected". In this case they will not be added to the booking price.

Use the context help <span style=color:#007bff;“ >{{#far:question-circle}} </span> for detailed instructions.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> A Cleaning fee is required by Vrbo and if it is not set by one of these methods a value of zero will automatically be sent. You can enter the cleaning fee in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT >ROOM CONTENT.

==== Policies and Rules ====
You can set the minimum age via a "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT.

===== Cancellation Policy =====
Vrbo requires a cancellation policy. We will send the policies set in SETTING->PROPERTIES-> BOOKING RULES > CANCELLATION POLICY.

You can set which policy applies in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT

If you want to send a custom cancellation policy you need to set the policy details in the "Custom" setting at the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT.
Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for the setting to see detailed instructions.

===== Pets=====
If you do not allow pets you choose "Pets not allowed" as feature in S {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. Fees for pets can be set as custom values in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER -> VRBO > SPECIFIC ROOM CONTENT.

===== Children=====
If you allow children set the number of children which are allowed or "Dont ask" in the setting for "Maximum Children" in SETTING->PROPERTIES-> ROOMS -> SETUP.

===== Custom House Rules and Event Rules=====
If you want to send a custom house rules you can enter them in the "Custom" setting at the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > SPECIFIC ROOM CONTENT.

==== Payments and Payment Schedule ====
By default payment is due at the time of the booking.
*You can change this to "At Check-in " in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > SPECIFIC PROPERTY CONTENT.

If payments are due at different times you can set up payment schedules
*Go to {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > VRBO.COM > PAYMENT SCHEDULE
*Then link it to your property in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > SPECIFIC PROPERTY CONTENT.

You can set up a deposit collection we will send the deposit amount that is due at the time of the booking and the remainder if any at arrival.
*Go to{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO.COM > PAYMENT SCHEDULE and set Payment 1 with 'Days After Booking' = 0 and then the amount required.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>Listings where guests do not have to pay the full amount with the booking perform better. Payment Schedules allow you to set up to five payments.

You can set the Payment Types
* Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER -> VRBO.COM > SPECIFIC PROPERTY CONTENT.

Beds24 supports the following payment options:

1. Invoice

If you choose "Invoice" you need to enter a description on how guests can pay in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER -> VRBO.COM > SPECIFIC CONTENT "Payment Options Description "

2. Credit Card

The cards you have activated in {{#fas:cog}} (SETTINGS) PAYMENTS -> Credit Card Collection will be sent as accepted cards.

===== Collect payments based on your Payment schedule - Using Stripe =====

1. Setup the Payment schedule, this will send the details to Vrbo. Go to {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > Vrbo.COM > PAYMENT SCHEDULE. Payment Schedules allow you to set up to five payments.

2. Guest credit card was sent to Stripe at the time of the booking.

*Create auto actions to add pending payments to your bookings, based on the Payment schedule. See [[Stripe_Payment_Schedule |Collect payments with payment schedule]] for more information.
* Collect the payment manually via the Stripe Button in the Charges & Payments tab of the booking. See [[Stripe#Collect_payment_manually|Manually collect payment via Stripe]] for more information.

===== Collect payments from Guests =====

1. Request the Credit card details if it was not collected at the time of the booking.

* If you want to manually process the guest credit cards in your own payment gateway, send an email to the guest to submit their Credit Card details, see [[:Category:Payments#Request_Guests_to_Submit_Credit_Card_Details|Submit Credit Card Details]] for more information.

* You can automatically process the payment via the payment gateways you have activated, send an email to the guest with a Payment Request so the guest can make a payment. See [[:Category:Payments#Payment_Request|Send Payment Request]] for more information.
** If you want to direct the guest using Template Variables then see [[:Category:Payments#Using_Template_Variables|Send Payment Request with Template variables]] for more information.
** If you want to direct the guest using URLs then see [[:Category:Payments#Using_Request_URL_Parameters|Send Payment Request URL]] for more information.
** If you want to direct the guest to Paypal then see [[:Category:Payments#Using_Request_URL_Parameters|Send PayPal Payment Request]] for more information.

2. Guest credit card was sent with the booking.

* You want to manually process the guest credit card in your own payment gateway, the guest credit card details will be stored in Beds24 and you will receive a Security Code in the Booking Notification, you can use this to access the guest CVC to charge their card. See [[Card_Number_Collection#Collect_Credit_Card_Details_for_Bookings_from_your_own_website|Process Guest Credit Cards]] for more information.

<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you do not take the total amount as a deposit, you must set up a "Payment 2" for the remaining amount.

==== Pictures====
Vrbo requires at least six pictures per listing.

Room pictures are sent. These are the pictures activated as "Room Pictures" in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES Only if there are no room pictures activate property pictures are sent. These are the pictures activated as "Property Pictures" in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES.

<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you use external pictures you need to make sure they are .jpg format.

If you need to change a picture, add or change it's caption text to ensure it gets re-imported by Vrbo.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Make sure you add captions to your pictures. Please see the pictures help page for instructions.

=Different invoice template=
If you need a different invoice template for the bookings from this channel you can use the invoicee function.

=Requests=
If your listing is set to "Having listings on "Request" requests will import with the status "Inquiry" which does not block the room. If you want to confirm the booking you will need to make sure there is availability and then change the status to "Confirmed". Vrbo periodically pulls booking information from Beds24 so they will receive the status change the next time they pull from us.

=View and reply to reviews=
If a guest sends you a review, you can view it via the "Mail & Action" tab in the booking in Beds24 and also reply to the guest directly from there.

= 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.

Each room feature code can have additional features added to it separated by a space which will list the features within this room. Multiple rooms can be added.

Example: One bedroom with a double bed
BEDROOM BED_DOUBLE

Example: The property has 3 bathrooms with various features
BATHROOM BIDET COMBO_TUB_SHOWER
BATHROOM BIDET
BATHROOM_HALF TOILET

Add feature codes one for each feature separated by spaces.

Example: A property has television, internet and beach view
TELEVISION INTERNET BEACH_VIEW

==Bathroom Types==
If there are multiple bathrooms add one code for each followed by appropriate amenity codes.

BATHROOM
BATHROOM_HALF
BATHROOM_SHOWER

==Bathroom Amenities ==
These must be specified after the bathroom type code and are applied to the preceding bathroom type code. If there are multiple features in the room add a code for each

BIDET

COMBO_TUB_SHOWER

JETTED_TUB

OUTDOOR_SHOWER

SHOWER

TOILET

TUB

==Bedroom Types ==
If there are multiple bedrooms add one code for each followed by appropriate amenity codes.

BEDROOM

BEDROOM_LIVING_SLEEPING_COMBO
BEDROOM_OTHER_SLEEPING_AREA

==Bedroom Amenities==
These must be specified after the bedroom type code and are applied to the preceding bedroom type code. If there are multiple beds in the bedroom add one code for each.

BED_BUNK

BED_CHILD

BED_DOUBLE

BED_KING

BED_MURPHY

BED_QUEEN

BED_SOFA

BED_SINGLE

==Nearest features==
Nearest features must consist of three parts in order joined by underscores, a feature type, the distance unit, the number value.

Example '''NEAREST_BEACH_KILOMETERS_3''' or '''NEAREST_BAR_METERS_200'''

NEAREST_AIRPORT

NEAREST_BEACH

NEAREST_GOLF

NEAREST_RESTAURANT

NEAREST_TRAIN

NEAREST_BAR

NEAREST_FERRY

NEAREST_HIGHWAY

NEAREST_SKI

Distance units

KILOMETRES

METRES

MILES

MINUTES

==Location type features==

BEACH

BEACH_FRONT

BEACH_VIEW

DOWNTOWN

GOLF_COURSE_FRONT

GOLF_COURSE_VIEW

LAKE

LAKE_FRONT

LAKE_VIEW

MOUNTAIN

MOUNTAIN_VIEW

NEAR_OCEAN

OCEAN_FRONT

OCEAN_VIEW

RESORT

RIVER

RURAL

SKI_IN

SKI_OUT

TOWN

VILLAGE

WATER_VIEW

WATERFRONT

==Other features==

LIVING_ROOM

FIREPLACE

WOOD_STOVE

HEATING

AIR_CONDITIONING

ELEVATOR

TELEPHONE

HAIR_DRYER

ICEMAKER

IRON_BOARD

LINENS

TOWELS

DRYER

WASHER

BALCONY

DECK_PATIO_UNCOVERED

LANAI_GAZEBO_COVERED

GARDEN

PRIVATE_YARD

GRILL

GAME_ROOM

VERANDA

GARAGE

PARKING_POSSIBLE

PARKING_PAID

EV_CHARGER

BOOKS

DVD

FOOSBALL

GAMES

MUSIC_LIBRARY

TABLE_TENNIS

POOL_TABLE

CABLE

SATELLITE

STEREO

TV

TV_SMART

TOYS

VIDEO_GAMES

VIDEO_LIBRARY

BREAKFAST_NONE

BREAKFAST_POSSIBLE

BREAKFAST_INCLUDED

PRIVATE_CHEF

DESK

DESK_WITH_CHAIR

INTERNET

WIFI

KITCHEN

DINING_AREA

DINING_ROOM

COFFEE_MAKER

DISHES_UTENSILS

CHILDRENS_DINNERWARE

PACK_N_PLAY_TRAVEL_CRIB

BABYSITTING

BABY_MONITOR

DISHWASHER

HIGHCHAIR

MICROWAVE

OVEN

REFRIGERATOR

SPICES

STOVE

TOASTER

OUTDOOR_LIGHTING

OUTDOOR_FIREPLACE

FIRE_EXTINGUISHER

FIRST_AID_KIT

MEDICAL_EMERGENCY_CONTACT

POLICE_EMERGENCY_CONTACT

FIRE_EMERGENCY_CONTACT

SMOKE_DETECTOR

CO_DETECTOR

DEADBOLT_LOCK

EMERGENCY_EXIT_ROUTE

PETS_CONSIDERED

PETS_NOT_ALLOWED

HOT_TUB

MASSAGE

POOL

POOL_HEATED

POOL_INDOOR

POOL_PRIVATE

SAUNA

B_AND_B

CAR_AVAILABLE

CHAUFFEUR

CHECK_IN_OUT_SELF

CLEANING_DISINFECTANT

CLEANING_ENHANCED

CLEANING_INCLUDED

CLEANING_POSSIBLE

CONCIERGE

GUEST_HOUSE

HOTEL

SHOP

BASKETBALL_COURT

BICYCLE

BOAT

CROSS_COUNTRY_SKIING

FISHING

FITNESS_ROOM

GOLF

HIKING

HORSE_RIDING

HUNTING

ICE_SKATING

JET_SKIING

KAYAK_CANOE

KAYAKING

MOUNTAIN_BIKING

MOUNTAIN_CLIMBING

MOUNTAINEERING

PARASAILING

RAFTING

SAILING

SPORTS_SNORKELING_DIVING

SKIING

SKIING_WATER

SNOW_SPORTS_GEAR

SNOWBOARDING

SNOWMOBILING

SPELUNKING

SURFING

SWIMMING

TUBING_WATER

WATER_SPORTS

WHITEWATER_RAFTING

WIND_SURFING

CAR_NECESSARY

CAR_RECOMMENDED

CAR_NOT_NECESSARY

CHILDREN_NOT_ALLOWED

CHILDREN_WELCOME

EVENTS_ALLOWED

SMOKING_ALLOWED

SMOKING_NOT_ALLOWED

WHEELCHAIR_YES

WHEELCHAIR_NO

BAY

COIN_LAUNDRY

DUTY_FREE

HEALTH_BEAUTY_SPA

MARINA

MUSEUMS

THEME_PARKS

WATER_PARKS

WINERY_TOURS

ZOO

ANTIQUING

BIRD_WATCHING

ECO_TOURISM

GAMBLING

OUTLET_SHOPPING

PADDLE_BOATING

SHOPPING

SLEDDING

WHALE_WATCHING

WILDLIFE_VIEWING

FITNESS_CENTER

HOSPITAL

LAUNDROMAT

FAMILY

HISTORIC

ROMANTIC

=Common Errors=
'''The Vrbo connection for this property is managed by account ....'''
'''It cannot be mapped to this account.'''
Only properties owned by the connected Beds24 account or sub account can send to the connected Vrbo account. If you want to connect properties owned by different account/sub accounts you can override this. Click on the 'User' icon on the top right and then on 'Account Management (in the old control panel SUB ACCOUNT in the top right) Manage Account > Manage Property and go to "Channel Management". The setting "Vrbo / Homeaway Connect via Account" allows you to set that the property connects to Vrbo via a different account than the one owning it.

'''Fix content errors and enable rooms before generating the Vrbo Software User ID'''
'''Fix content errors and enable rooms'''
Go back to step 2 in the chapter "Mapping"

'''Vrbo Software User ID not generated '''
Go back to step 4 in the chapter "Mapping"

'''internal error constructing XML '''
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO-> VIEW CONTENT to check if you content meets Vrbos requirements. Any settings which do not meet Vrbos requirements are highlighted on red. Click on the links in the "Settings" column to go to the settings where you can fix the problems.

Category:Prices

2024-01-09T15:38:03Z

IuriRosa: /* Fixed Prices */

[[Category:Daily_Use]]
[[Category:Use_Cases]]
[[Category:How to]]
[[Category:Getting_Started]]
<div class="heading">Prices</div>
This page is about the menu PRICES and gives on overview on prices.

__TOC__
=General=
To show/send availability the system needs a price for the guests selection. If you have no prices for a certain date the system will show no availability. For this reason it is important to keep prices up-to-date.

<embedvideo service="youtube">https://youtu.be/psU00sCgS4w</embedvideo>

<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> The [https://beds24.com/wizard/wizard3.php price wizard] will guide you through the price set up.

The system has two types of prices:
*Daily Prices
*Fixed Prices

Which type you use depends on your pricing structure:

==Daily Prices==
Daily Prices are prices for one date which are entered in the Calendar. You can have a set of daily prices with different rules.

*Daily prices flexible and easy to handle.
*If you want to dynamically adjust prices on a daily basis it is best to use daily prices.
*Extra Person prices can be sent to the channels that accept occupancy pricing.

This [https://beds24.com/wizard/wizard3.php setup wizard] guides you though the setup. Please find more information on the help page for [https://wiki.beds24.com/index.php/Category:Daily_Prices daily prices].

<embedvideo service="youtube">https://youtu.be/TkIZbqe5Cpc</embedvideo>

==Fixed Prices==
Fixed Prices have a start and end date so they apply to a range of dates. If multiple Fixed Prices are available for the same dates the rules of each Fixed Price will determine which Fixed Price is offered.

Use Fixed Prices instead of Daily Prices:
*If your prices are fixed ahead and you do not want to adjust them and you have none or few seasons
*If you want to allow guest to enquire when no price can be found but the room is not fully booked
*If you want to grant referrer discounts

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Extra Person Prices can NOT be sent to the Channels.

Please find more information on the help page for [https://wiki.beds24.com/index.php/Category:Fixed_Prices Prices Fixed Prices].

== Combination on Daily Prices and Fixed Prices ==
It is not necessary to use both Daily Prices and Fixed Prices but a combination of Daily Prices and Fixed Prices can be used to fine tune pricing structures.

*You can use Daily Prices to override the a Fixed Prices for a few individual dates. If you you often adjust prices use Daily Prices only.
*You can add a Gap Filler fill gaps when using daily prices with minimum stays is required

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Rules in Fixed Prices have no effect on Daily Prices.

==Set up Prices==
Click on the links below for further details.

The [http://beds24.com/wizard/index.php Price Wizard] guides you through the price set up.

==Multiplier==
You can add a "Multiplier" in the CALENDAR to increase or lower all prices on a certain day or date range.If you use Fixed Prices you can deactivate the multiplier by setting "Allow Multiplier" = No in the Summary tab of the price.

For most channels a "Multiplier" can be set in in channel manger settings. Check the channels help pages for instructions.

A multiplier for the booking page is available in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING PAGE.

==Check Prices==
The 'Price Check Tool' shows you which prices and rules apply for specific dates/selections and why a certain price or rule was applied or not applied.

=Prices for OTA channels and your own booking page=
Prices are used for the channels and/or the Beds24 booking page according to what is ticked under "Enable" in the daily price settings or the "Channels" tab of a price.

See [[Setting_Prices_for_Booking_Channels|this help page]] for specific information on how to set prices for OTA channels.

=Dynamic Prices=
If you want to adjust your prices dynamically you have following options:
*Use Daily Prices and manually adjust prices as required
*The Beds24 [[Yield_Optimiser|Yield Optimizer]] (PRICES -> YIELD OPTIMIZER) automatically adjust prices based on demand shortly before check-in.
*Our partners [[Pricelabs.co|Pricelabs]] ({{#fas:cog}} (SETTINGS) > APPS&INTEGRATIONS > PRICELABS) and [[RoomPriceGenie.com|RoomPriceGenie]] ({{#fas:cog}} (SETTINGS) > APPS&INTEGRATIONS > ROOMPRICEGENIE) can can automatically send daily prices to Beds24.

Make

2023-05-27T08:48:46Z

IuriRosa:

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > MAKE and explains how to connect and what you can do with the connection.

To use this service you will need an account with [https://www.make.com/en/register?pc=beds24 Make].

For Beds24 the normal channel manger fees apply.

== Capabilities ==
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

== Limitations ==

== Set Up ==

=== Beds24 ===
*Set up an Auto Action ({{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it.
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Make to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.make.com/en/register?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

== Common Problems ==
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

== Disconnect==
Untick "Bookings" to stop sending bookings.

== Examples ==
===Sample Scenarios===
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

Connect Airbnb Account

2022-12-11T16:12:11Z

IuriRosa: /* Do I have to confirm bookings?= */

Outgoing Email

2022-12-04T16:43:46Z

IuriRosa: /* Standard Email Providers */

[[Category:Messaging]]
[[Category:Account]]
[[Category:Troubleshooting]]
<div class="heading">Outgoing Email</div>
This page is about the menu {{#fas:cog}} (SETTINGS) ACCOUNT > OUTGOING EMAIL and explains how to send Emails to guests from your own Email address instead of a Beds24 Email address.

__TOC__
= General =
'''Sending Account''': Choose whether to use the system email server or your own email address to send email.

If you choose your own email address the guest will receive an email confirmation from your email address and you will see sent mails in your outgoing mail folder.
You can use your own email service via SMTP or Mailgun, It is also possible to use both, first we will try your SMTP server and if this fails we will try Mailgun. If both fail, the mail will be sent by the system email server.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you have entered a property Email address in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION replies from guests to confirmation messages will be sent in cc to the property EMail address. If you do not want this do not enter a property Email address.

If you do not use your own email, the guest will receive a booking notification from the system Email address.

'''The following settings are required if you use your own email address''':

'''Email Address''': This is the email address which will send email notifications.

'''Mail Server''': This is the email server which will send your email. For example the gmail server is smtp.gmail.com.

'''User Name''': This is the user name for your email server. This is often your email address.

'''Password''': This is the password for your email server.

'''Use Encryption''': This is the email server encryption setting. For example the gmail server requires SSL.

'''Port Number''': This is the email server SMTP port. This is normally 25 but can be different. For example the gmail server uses 465.

= Standard Email Providers =
== Gmail / Googlemail ==
You need to create and use an Application Password for the Gmail account because if you try to use your normal Gmail password Google might block the emails from sending and treat them as spam. Google explains how to do this [https://support.google.com/mail/answer/1173270?hl=en here.]

Mail Server: smtp.gmail.com

Encryption: SSL

Port: 465

If you have a Gmail (Googlemail) G-Suite Account (pro version):

You may need the following settings in Google to allow Email sending via Gmail:

*Open your Google Admin console (admin.google.com).
*Click SECURITY > BASIC SETTINGS
*Under "Signing in to Google," select App Passwords. You may need to sign in. If you don’t have this option, it might be because:
**2-Step Verification is not set up for your account.
**2-Step Verification is only set up for security keys.
**Your account is through work, school, or other organisation.
**You turned on Advanced Protection.

At the bottom,
*choose Select app and choose the app you are using
*Select the device and choose the device you’re using and then Generate.
**Select App – Email
**Select Device – Other Custom Name

*In the next window write Beds24 and click Generate

*Copy the generated Password and replace the password you have set in (SETTINGS) ACCOUNT > OUTGOING EMAIL

*Click SAVE.

==Microsoft Live (Hotmail)==

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>Microsoft live has issues with external systems like Beds24 sending email and can block mails, we cannot recommend this system, use at your own risk.

Mail Server: smtp.live.com OR smtp-mail.outlook.com (Check the details from your email service)

Encryption: No

Port: 587 or 25

'''Set up'''

[[Image:outgoing1.png|500px|link=]]
[[Media:outgoing1.png|view large]]

The system can use your own Email address

[[Image:outgoing2.png|500px|link=]]
[[Media:outgoing2.png|view large]]

If you see an error message please check
*are all entries correct
*some systems require authentication. Please see "Trouble Shooting" (below)

[[Image:outgoing3.png|500px|link=]]
[[Media:outgoing3.png|view large]]

[[:category:Sub_Account|Sub accounts]] can be used to use different outgoing Email addresses for multiple properties in one account.

= Mailgun=

Mailgun is a mail sending service.

You will need an account at mailgun and can get the Key and Domain values from your mailgun account.

= SPF Record =
Adding the following SPF record to your sending domain may help delivery of your emails and prevent them being treated as spam. Please refer to your domain register for help adding an SPF record to your domain.

v=spf1 include:mail.beds24.com ~all

= Trouble Shooting =
Hotmail and other providers might ask for '''authentication'''. Log into your Email account, check your notifications
or settings and follow the instructions given by your Email provider. If you cannot find them ask your provider
what you need to do to let third parties like Beds24 send Emails through your SMTP server.

'''Emails are not sending'''
1. Check if you outgoing E-mail is working by clicking on "Send Test Email".
2. Check your "Descriptive Sending Email Address", it cannot be a word only. The pop up help for the setting has examples of valid formats.

'''If E-mail are sending but guests do not receive your E-mails''' you can use a tool like https://www.mail-tester.com/ to check what the problem might be.

Quickbooks

2022-11-22T15:33:07Z

IuriRosa:

[[Category:Apps]]
[[Category:Invoice]]
[[Category:Automation]]

<div class="heading">Quickbooks</div>

[https://quickbooks.intuit.com/eu/ Quickbooks] accounting software can be connected via [[Integromat.com|Integromat]] ({{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > INTEGROMAT.

Auto Actions

2022-11-06T15:47:13Z

IuriRosa: /* Change the status of all "Request" bookings to "Cancelled" after three days */

[[Category:Guest Management]]
[[Category:Messaging]]
[[Category:Bookings]]
[[Category:Troubleshooting]]
[[Category:Automation]]
[[Category:Webhooks]]
[[Category:Use_Cases]]
<div class="heading">Auto Actions</div>

This page is about the menu {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS and explains how to set up and use Auto Actions.

__TOC__

== General Information ==

An Auto Action is an action which can be programmed to run at a specific time relative to the time of the '''booking''', to the '''check-in''' date or to the '''check-out''' date.

Auto actions have one or more trigger conditions and one or more actions. They can be triggered on a number of different conditions, like property, time or booking related conditions. Actions can be to send pre-drafted emails/messages or SMS, change booking or invoice information or run webhooks.

Template variables provide great flexibility when creating/managing the Auto Actions. Setup one Auto Action to trigger on multiple/all properties/rooms with the property specific details, using the [[Template Variables]]. This removes the need to duplicate your auto actions for each Property. Reducing the ongoing management, multiple copies of the same auto action will require you to edit/modify each auto action rather than update one auto action.

Using 'Group Keywords' you can refine the triggers in the Auto Action to include/exclude properties if the purpose/message in the Auto action needs to be different.

== Setup ==

Automatic actions will trigger every 15/20 minutes.

Go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> AUTO ACTION

You can create a NEW Auto Action, Modify or Delete from this section.

*To Create a NEW Auto Action, Click 'Add New Action Button'.

*To MODIFY an Auto Action, scroll to the Auto Action and click on "Edit", make the changes and click SAVE.

*To create a COPY of an Auto Action, click "Edit" on an existing auto action, scroll to the bottom of the page and click 'Save as copy'.

*To DELETE an Auto Action, click "Edit" on an existing auto action, scroll to the bottom of the page and click 'Delete'.

'''Trigger Action : '''

You can choose to trigger an auto action automatically or manually.

*'''Manual:''' If set to manual actions can be triggered manually from the MAIL/ACTION tab of each booking.

*'''Auto:''' Auto action will automatically trigger on a booking based on the rules set in the Trigger tab. Check the details in the MAIL/ACTION tab of each booking. You will see if the auto action has triggered and when, if it has not triggered then you can check if it is due to trigger and when.

===Setup Outgoing Email Service - Required for sending Emails via Auto Actions===

Go to {{#fas:cog}} (SETTINGS) ACCOUNT -> OUTGOING EMAIL and follow the instructions to connect your email address/account to Beds24.

'''Auto sending:'''

Auto Action Emails which are sent automatically by the system are sent from the EMail address of the account that created the Auto Action. This is the account set up in in {{#fas:cog}} (SETTINGS) ACCOUNT-> OUTGOING EMAIL.

'''Manual sending:'''

When sending manually by clicking on the 'Send now' button the Email address of the user you are logged in as will be be used.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>To use this function you need to set the system to use your own Email address for outgoing emails under {{#fas:cog}} (SETTINGS) ACCOUNT -> OUTGOING EMAIL.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Confirmation emails will send automatically to the guest. You can customize them in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> CONFIRMATION MESSAGES.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The auto actions will appear on the 'Mail & Actions' tab of each booking where you manually trigger the email/messages/changes to the booking.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you are using your own mail server for outgoing email/messages the Booking and Invoice actions will be applied before sending the mail.

===Auto Actions and Subaccounts===
Auto Actions are account functions, i.e. they apply per account.

'''1. Account A''' (master account or subaccount) in which the auto action was created.

Auto Actions are available according to the "Property" setting in the "Trigger" tab. I.e. either for
*A specific property or a group of properties
*All properties belonging to that account
*all properties visible in the account (properties belonging to the account, properties available in the account).

'''2. Another account B''' (master account or sub-account) in which the Auto Action has not been created.

Auto Actions are only available for properties that belong to Account A and have been made available in Account B.

If required, Auto Actions can be copied from one account to another using the "clone" function. This creates an independent Auto Action in another account, which can be changed there. The clone function is available via the 'User' icon on the top right and then on 'Account Management (in the old control panel SUB ACCOUNT in the top right).

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you have sub accounts and need an auto action to be used across multiple accounts/properties, then create the auto action at the Master Account Level and set Property = 'All visible in account' and ensure the Master account has access to the properties.

== Trigger ==
Sets the criteria which have to be fulfilled to start the Auto Action.

'''Property, Room, Unit'''

You can refine the use of the Auto Action, by specifying if it should trigger on specific properties or all properties/rooms.

You can select if it should trigger on All properties, All Owned by, All visible in account or a specific Property. If you select a specific Property then you can also select a specific Room id.

It is possible to 'Exclude' specific Beds24 Room ids, you can find the Room id from the Room Setup.

If required, you can also specify specific Offers/Units in Room Types.

Send/Exclude Property Groups, this will use the values you have entered in {{#fas:cog}} (SETTINGS) BOOKING PAGE > MULTIPLE PROPERTIES > PROPERTY SETTINGS > GROUP KEYWORDS.

'''Time'''

"Trigger Time" defines when the action is allowed to start. Once it has started it is allowed to go for the "Time Window" period. When the "Time Window" period has elapsed the auto action stops.

Both "Trigger Time" and "Time Window" are relative to a "Trigger Event" i.e. check-in, check-out, time of booking.

"Between Booking and Check in" can be used to include/exclude Same day/Near term bookings, set the number of days.

"Check In From" and "Check In To" use if you have specific information relating to bookings between these dates, special offers, major disruptions etc.

'''Booking Source'''

"Booking Source" = "Direct" applies the Auto Actions only to bookings from your own web site, manually added bookings and bookings imported though the API (not the channel manager). If you want to trigger only on manually added bookings add your username in the "Referrer" field.

'''Booking Conditions'''

"Group Booking Trigger" - use the (?) context help for the options.
"Invoice Balance" - use this to for payments and reminders.

'''Info Codes'''

If you use Booking Info Codes in your bookings, you can enter values to include/exclude bookings.

'''Booking Fields'''

Select the appropriate fields from the drop down lists. You can also use an AND/OR option.

"Template variables" can be used in the fields to generate dynamic values based on the booking. See the options in this section [[Template_Variables#Smart_Logic_Template_Variables|Smart Template Variables]]

== Actions ==

=== Messaging/Email ===
Go to "Messaging" to create or modify a prepared Email/Message template. Templates can contain [[Template Variables]] to include information specific to the booking in the Email/Message, for example the guests name or the arrival date.

*To send messages via the Message API, then enter the text in the PLAIN text box, for emails, enter the text in the HTLM Box.

*To send Emails automatically you need to set up your outgoing Email address in {{#fas:cog}} (SETTINGS) ACCOUNT -> OUTGOING EMAIL.

*To send Emails manually open a booking and go to the MAIL/Action tab. Manual Emails will open in a window, you may send it as is or edit it before sending.

Some systems have a limit of about 2000 characters for this form of email generation. If the email will not open try reducing the amount of text.

If Auto Action Emails are sent automatically they will send through your Email server. You should see this on your server. Whether you see it in your Sent box or not depends on your Email program.

If Auto Action Emails are sent manually via a link in the "Email Templates" list in the booking Beds24 will first try to send through your Email server. You should see this on your server. Whether you see it in your Sent box or not depends on your Email program.

If this does not work it will pop and send through your desktop. In this case you will see it in your Sent box.

==== Email Attachments ====
You can choose to attach an invoice or a booking template as a PDF file to emails sent by Auto Actions.

If you send Emails with pdf attachment (invoice, booking template) to Alias-Email addresses created by channels the channel might block the attachment so it is not delivered to the guest. Ask your channel about their policy regarding this.

Other files can not be attached. We recommend you use a link to a file you upload to your web site.

=== SMS ===
You can automatically send SMS messages. Please note that a fee per SMS message applies if this function is activated.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> The SMS will send in the language of the account, not the language of the booking. Read Example "Send an Email in the guests language to an internal Email address" for a way to control the language of the SMS.

=== Booking ===
Go to the tab 'Booking' to set up an auto action which modifies something in the booking.

"Execution" - default is 'One time only' or 'Allow Repeats' This action can run one time only or repeat within the trigger time period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Emails are always triggered once only regardless of this setting.

=== Booking Info ===
Set up auto actions which automatically add or remove info codes. This is good practice for reporting and also to trigger/exclude bookings from other auto actions.

=== Invoice ===

Automatically Assign Invoice Number.

Automatically add/update invoice items or pending payments.

Pending payments can use Payment Rules defined in {{#fas:cog}} (SETTINGS)->PAYMENTS->PAYMENT RULES.

Invoice changes are applied before the mail is sent.

=== API ===
Create auto actions which trigger HTTP POST notifications.

=== Webhook ===
Create auto actions which trigger a web hook when the trigger conditions are met.

== Multiple Properties ==

With Multiple Properties, the requirement to have Property specific information in the Messages/emails sent to the guest/housekeeping/owner can be achieved using Template Variables.

When you create a Property/Room in Beds24, the setup of the Property/Room is held in the database and can be accessed via Template Variables. For example in {{#fas:cog}} (SETTINGS) >PROPERTIES >DESCRIPTION, you setup the property specific details.

*Property name - can be accessed in template variable [PROPERTYNAME]
*Property Address - can be accessed in template variable [PROPERTYADDRESS]

You will find the full list of Property Template Variables when you go to [[Template_Variables#Property_Variables|Property Variables]]

There are additional Property Templates that can be used in Messages/Emails/SMS to the guest that can be customised for each Property. Each Property Template can hold customised text that can be used in Auto Actions, Booking Templates, Invoices and Reports.

Go to {{#fas:cog}} (SETTINGS) >PROPERTIES >DESCRIPTION >PROPERTY TEMPLATES you will see the list that are available.

When you create each Room/Unit the information is held in Room/Unit specific template variables.

You will find the full list of Room/Unit Template Variables when you go to [[Template_Variables#Room_Variables|Room Variables]]

See the full list of [[Template Variables]].

You can send a message/email to your guests, confirming their booking date, property details and property contact details. Use the property, room and booking templates to build the message/email in one Auto Action, rather than one auto action per property.

This approach will reduce the ongoing management, update one Auto Action and it will apply to all/selected properties rather than having to edit multiple auto actions with the same overall message.

===Example 1 - Each property has a different access code for the main building door ===

Your properties have security doors with keycodes, each property has a different code.

Go to {{#fas:cog}} (SETTINGS) >PROPERTIES >DESCRIPTION >PROPERTY TEMPLATES > Property Template 1 enter the Building Access Code, use this same field in each property and set the appropriate code.

Then in the Auto Action use [PROPERTYTEMPLATE1] in the text rather than the actual value.

*Please use this code to Access the Main building Door:- [PROPERTYTEMPLATE1]

There is no need for a separate auto action due to the front door keycode being different.

===Example 2 - Housekeeping/Cleaning Team is different for each Property. ===

Each of your properties has a different housekeeping/cleaning team and you need to send them an email with the booking details for each booking.

Go to {{#fas:cog}} (SETTINGS) >PROPERTIES >DESCRIPTION >PROPERTY TEMPLATES > Property Template 5 enter the email address for Housekeeping/Cleaning team.

In the Auto action,
*"Send Message" = Internal Only.
*"Internal Email Address" = [PROPERTYTEMPLATE5]

There is no need for a separate auto action as the message will be sent to the appropriate email from property template 5.

If you have different teams per room, then use a Room template rather than the Property Template.

===Example 3 - Send email to a Group of Properties (not all) ===

You can setup a "Group" for your Properties, this has a number of benefits, including sending/excluding messages/emails to a Group of Properties, view a "Group" of properties in your Calendar and in Reports.

To assign the "Group" to your Properties, go to {{#fas:cog}} (SETTINGS) > BOOKING ENGINE > MULTI BOOKING PAGE > PROPERTY SETTINGS > GROUP KEYWORDS.

Enter a Group name, it needs to be a single word - for example you want to identify all 4 bedroom properties, then you can add 4BEDS and add this to all 4 Bedroom properties you have.

Each property can be in multiple groups, enter multiple keywords separated by a comma, for example :- 4BEDS, OceanView, Dublin.

In the Trigger tab of the Auto Action, enter the Group keyword in
*"Send Only To Property Groups" OR "Exclude Property Groups" you want to include/exclude from the Auto Action.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This filter will not apply if you are triggering on a single property.

== Performance and Testing ==
Auto actions will test up to 1000 bookings per cycle, if your trigger condition involves more than 1000 bookings, the next 1000 will be tested on the next cycle etc.
If you require the fastest speed make sure your trigger is designed to test less than 1000 bookings.

The easiest way to do this is usually by reducing the testing window to the smallest necessary and adjusting the trigger condition to the most suitable.
For example a trigger that tests all bookings from booking time for 1 year will test many bookings while a trigger that tests only the 7 days before check-in will test less bookings and perform faster.

The test tab of the auto action has a button which will show you how many and which bookings are being tested by the auto action.

It is also possible to specify a booking number and test if the auto action would trigger on that booking with some diagnostics information shown to help trouble shooting.

== Troubleshooting ==
'''If Auto Actions do not send:'''
The list in the "Mail" tab of the booking will tell you why. Common causes are:
*Is your outgoing Email address working? Go to {{#fas:cog}} (SETTINGS) ACCOUNT->OUTGOING EMAIL and click on "Send Test Email".
*Is your Auto Action set to send automatically?
*Is the guests Email address valid ("Mails" tab of the booking)?
*Is the Plain Text box populated with the text you want to send (required when Message API is being used?
*Is the booking set to allow Allow Auto Actions ("Mails" tab of the booking)?
*Do all trigger events apply to the booking?

'''Delayed trigger of Auto Action:'''
See section Performance and testing above.

'''Auto Action is not editable'''
To have write access to an auto action an account needs to have write access to all properties to which the auto action applies. This might not be the case if you use sub accounts and the Auto Action is set to trigger for "All Properties".

'''You don't have permission to access control2.php on this server''' error message, when the save button is clicked
It is most likely something in your content triggering the firewall.
Try adding the content bit by bit until you find the item causing the problem.
Often it is a script or HTML item that appears to the firewall as a possible hacking attack.
It can also be something that looks innocent like a combination of numbers and words like "and" or "or" that hackers often use in sql injection attacks.
Once you find the item causing the problem, try rewording it.

'''Auto Action is not visible in a sub account'''
If you have sub accounts and need an auto action to be used across multiple accounts/properties, then create the auto action at the Master Account Level and set Property = 'All visible in account' and ensure the Master account has access to the properties.

== Examples ==

=== Send Emails/Message/SMS to guests ===

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Message API messages will be shown in the message tab of the booking and in the Channel Message centre. Currently this is only available for Booking.com and Airbnb.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Send an Email to the guest when the status of a booking changes to "Cancelled"====
</div>
<div class="mw-collapsible-content">

'''Trigger tab:'''

Time:
*Trigger Event = Check-in
*Trigger Time = -365
*Trigger Window = 365

Booking Source
*Booking Source = All (for example)

Booking Conditions
*Booking Status = Cancelled

'''Message tab''': For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you are using deposit collection make sure you set {{#fas:cog}} (SETTINGS) PAYMENTS->PAYMENT COLLECTION "Non Payment Booking Status" = Request.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Change the status of all upcoming direct bookings to "Cancelled" and send an Email to the guest ====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:
*Trigger Event = Check-in
*Trigger Time = -14 (for example to cancel the bookings for the next two weeks)
*Trigger Window = 14

Booking Source:
*Booking Source = Direct

Booking Conditions:
*Booking Status = All Not Cancelled

Booking tab:
*Booking Status = Cancelled

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain Text Box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an message or SMS to Guest when booking made more than 10 days in advance====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:
*Trigger Event = Check-in
*Trigger Time = -365 days
*Trigger Window = 355 days

Booking Conditions:
*Booking Status = All not cancelled

Booking tab:
*Execution = One time only
*Booking Status = No Change

'''Message tab''': For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain Text Box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

'''SMS tab :'''

Please note a charge applies per SMS message.

*Send SMS Message : Enable
*Phone Number : This is the phone number that will receive the SMS notification.

This is a global service and the notifications can be sent to almost phone in any country.

The phone number must contain the international country code and phone number as it would be dialed internationally.

Do not include any leading zeros or other characters and use no spaces.

The number must start with the country code.

EXAMPLE

to send to phone number 015625346 in the UK (Country code 44) enter the following number

4415625346

You can use the template variables [GUESTPHONE] or [GUESTMOBILE] but this will only work if the phone number has exactly the required format.

*SMS Message

Enter the message to send, messages will be truncated at 160 characters. Template variables can be used.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an message or SMS to Guest when booking made more than 7 days in advance====
</div>
<div class="mw-collapsible-content">
Alternatively you an use Between Booking and Check in

'''Trigger tab:'''

Time:
*Trigger Event = Booking (but not after check-in)
*Trigger Time = Immediate
*Trigger Window = 1 day
*Between Booking and Check in = 7 to 999

Booking Conditions:
*Booking Status = All not cancelled

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

'''SMS tab :'''

Please note a charge applies per SMS message.

*Send SMS Message : Enable
*Phone Number : This is the phone number that will receive the SMS notification.

This is a global service and the notifications can be sent to almost phone in any country.

The phone number must contain the international country code and phone number as it would be dialed internationally.

Do not include any leading zeros or other characters and use no spaces.

The number must start with the country code.

EXAMPLE

to send to phone number 015625346 in the UK (Country code 44) enter the following number

4415625346

You can use the template variables [GUESTPHONE] or [GUESTMOBILE] but this will only work if the phone number has exactly the required format.

*SMS Message

Enter the message to send, messages will be truncated at 160 characters. Template variables can be used.

'''Booking tab:'''
*Execution = One time only
*Booking Status = No Change

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an message or SMS to Guest for last minute booking - 6 days or less====
</div>
<div class="mw-collapsible-content">

'''Trigger tab:'''

Time:
*Trigger Event = Booking (but not after check-in)
*Trigger Time = Immediate
*Trigger Window = 1 day
*Between Booking and Check in = 0 to 6

Booking Conditions:
*Booking Status = All not cancelled

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain text box above. Template variables can be used [[Template_Variables| see here]]

'''SMS tab :'''

Please note a charge applies per SMS message.

*Send SMS Message : Enable
*Phone Number : This is the phone number that will receive the SMS notification.

This is a global service and the notifications can be sent to almost phone in any country.

The phone number must contain the international country code and phone number as it would be dialed internationally.

Do not include any leading zeros or other characters and use no spaces.

The number must start with the country code.

EXAMPLE

to send to phone number 015625346 in the UK (Country code 44) enter the following number

4415625346

You can use the template variables [GUESTPHONE] or [GUESTMOBILE] but this will only work if the phone number has exactly the required format.

*SMS Message

Enter the message to send, messages will be truncated at 160 characters. Template variables can be used.

'''Booking tab:'''
*Execution = One time only
*Booking Status = No Change

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an Email with a key code for a specific unit one day before check-in (Self Checkin)====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Property, Room, Unit:
*Unit = Select the number of the unit you want to send this message to. Note that the number represents the index of the unit not its name.

Time:
*Trigger Event = Check-in
*Trigger Time = -1 day
*Trigger Window = 1 day

Booking Conditions
*Booking Status = All not cancelled

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

If you are using the "Additional Information" function {{#fas:cog}} (SETTINGS) PROPERTIES->ROOMS->SET UP "Unit Names" you can use template variables

Example: Your room is [UNITNAME]. Check-in from: [UNITNAME:1] . The key code is: [UNITNAME:2]

The template variables will only work if you have entered text in {{#fas:cog}} (SETTINGS) PROPERTIES->ROOMS->SET UP "Unit Names". The context help for this setting will explain how to do this.

*HTML box - Email will be sent

If you are using the "Additional Information" function SETTINGS-{{#fas:cog}} (SETTINGS) PROPERTIES->ROOMS->SET UP "Unit Names" you can use template variables [[Template_Variables| see here]]

Example: Your room is [UNITNAME]. Check-in from: [UNITNAME:1] . The key code is: [UNITNAME:2]

The template variables will only work if you have entered text in S{{#fas:cog}} (SETTINGS) PROPERTIES->ROOMS->SET UP "Unit Names". The context help for this setting will explain how to do this.

'''Booking tab:'''
*Execution = One time only
*Booking Status = No Change

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an Email to the guest when a payment is made====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 365 day

Booking Conditions:
*Booking Status = All not cancelled
*Invoice Balance = Any Payment made OR Invoice Balance = Zero (payment in full)

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

You should consider adding the invoice table to the email so the guest can see the booking details including Charges & Payments.

[INVOICETABLE] - invoice table

It is also possible to include a customised invoice table using this template variable :- [INVOICE:PRI_QTY_CUA€] will create an invoice table with price and quantity in Euros

*HTML box - Email will be sent

Email Text :- It is possible to use the same details as in the Plain text box above. Template variables can be used [[Template_Variables| see here]]

You should consider adding the invoice table to the email so the guest can see the booking details including Charges & Payments.

[INVOICETABLE] - invoice table

It is also possible to include a customised invoice table using this template variable :- [INVOICE:PRI_QTY_CUA€] will create an invoice table with price and quantity in Euros.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an Email to guests from Channels====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1 day

Booking Source
*Booking Source = Channel Manager

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

'''Booking tab:'''
*Execution = One time only
*Booking Status = No Change

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send a message (Email or sms) to guests that have Checked-out 30 days or more====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time
*Trigger Event = Check-out
*Trigger Time = 30 days
*Trigger Window = 365 days

'''Message tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details as in the Plain text box above. Template variables can be used [[Template_Variables| see here]]

'''SMS tab :'''

Please note a charge applies per SMS message.

*Send SMS Message : Enable
*Phone Number : This is the phone number that will receive the SMS notification.

This is a global service and the notifications can be sent to almost phone in any country.

The phone number must contain the international country code and phone number as it would be dialed internationally.

Do not include any leading zeros or other characters and use no spaces.

The number must start with the country code.

EXAMPLE

to send to phone number 015625346 in the UK (Country code 44) enter the following number

4415625346

You can use the template variables [GUESTPHONE] or [GUESTMOBILE] but this will only work if the phone number has exactly the required format.

*SMS Message

Enter the message to send, messages will be truncated at 160 characters. Template variables can be used.

'''Booking tab:''' (optional)
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send a Request for payment to your guests for all bookings====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1 day

Booking Source:
*Booking Source = ALL (or select the booking source/Channel)

'''Message tab:''' Update details as appropriate
*Send Message = Booking API and Email Smart: If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address.
If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. Messages to the Email address entered in the field "Internal" are sent via Email.

*Plain text box (Using Message API)

Subject - enter the subject for your Guests
Plain Text Message :- enter the Message text you wish to send to your guests include the payment link

https://beds24.com/bookpay.php?bookid=[BOOKID]

You can find extra options to add to the payment link if you want to refine the details

https://wiki.beds24.com/index.php/Category:Payments#Payment_Request

*HTML Message (Send Email)
Email Subject - enter the subject for your Guests
Email Text :- enter the Email text you wish to send to your guests include template variable
[PAYLINK] this creates a payment link (HTML A tag) for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Check the template variables for other options.

'''Booking tab:'''
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour
Booking changes are applied before the mail is sent so that the flag template variable can be reflected in the Email.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send a Request for payment to your guests XX days before arrival====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:
*Trigger Event = Check-in
*Trigger Time = -42
*Trigger Window = 1 day

Booking Souce:
*Booking Source = ALL (or select the booking source/Channel)

'''Message tab:'''

*Send Email = Booking API and Email Smart: If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address.
If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. Messages to the Email address entered in the field "Internal" are sent via Email.

*Plain text box (Using Message API)
Subject - enter the subject for your Guests
Plain Text Message :- enter the Message text you wish to send to your guests include the payment link

https://beds24.com/bookpay.php?bookid=[BOOKID]

You can find extra options to add to the payment link if you want to refine the details

https://wiki.beds24.com/index.php/Category:Payments#Payment_Request

*HTML Message (Send Email)
Edit Email Subject - enter the subject for your Guests
Edit Email Text :- enter the Email text you wish to send to your guests include template variable
[PAYLINK] this creates a payment link (HTML A tag) for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Check the template variables for other options.

'''Booking tab:'''

*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour
Booking changes are applied before the mail is sent so that the flag template variable can be reflected in the Email.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send a Request for payment to your guests XX days after booking====
</div>
<div class="mw-collapsible-content">

You allow your guests to make X number of payments for their booking.

You can not trigger the auto action multiple times, unless you manage this manually, therefore you need to create multiple auto actions, so if you allow 3 payments for their booking, then you will need 3 auto actions.

You will need to manually add a Booking Info Code to each booking that you have agreed to allow X payments.

'''Create Auto Action one'''

'''Trigger tab:'''

*Trigger Event = Booking (but not after check-in)
*Trigger Time = +7 days
*Trigger Window = 1 day

*Booking Source = ALL (or select the booking source/Channel)
*Invoice Balance = Not Zero
*Any Booking Info Code = MULTIPLE (for example) this can be used if you only allow some guests to make multiple payments.

'''Message tab:'''

*Send Message = Booking API/Smart Email
If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. Messages to the Email address entered in the field "Internal" are sent via Email.

*Plain text box (Using Message API)
Subject - enter the subject for your Guests
Plain Text Message :- enter the Message text you wish to send to your guests include the payment link

https://beds24.com/bookpay.php?bookid=[BOOKID]

You can find extra options to add to the payment link if you want to refine the details

https://wiki.beds24.com/index.php/Category:Payments#Payment_Request

*HTML Message (Send Email)
Edit Email Subject - enter the subject for your Guests
Edit Email Text :- enter the Email text you wish to send to your guests include template variable
[PAYLINK] this creates a payment link (HTML A tag) for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Check the template variables for other options.

'''Booking tab:'''

*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour
Booking changes are applied before the mail is sent so that the flag template variable can be reflected in the Email.

'''Create additional Auto Actions for each period you want to trigger'''

'''Create Auto Action 2 (and 3, 4, 5 - how many you need) '''
*Trigger Time = +14 days (days you want to collect the payments)
*Trigger Window = 1 day

The use the settings in the previous auto action to trigger the next auto action for your booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send a Request to 'Capture' a Security deposit from your guests XX days before check-in - with Stripe====
</div>
<div class="mw-collapsible-content">

You want to capture a Security Deposit for bookings on the day before check-in from your guest.

Capture of the payment is only held by Stripe for 7 days, if the guest is staying longer you will need to send the request again.

You will need to create multiple emails to capture the payment multiple times for the same booking.

'''Trigger tab:'''

*Trigger Event = Check-in
*Trigger Time = -1 days
*Trigger Window = 1 day
*Booking Source = ALL (or select the booking source/Channel)
*Status = All not cancelled

'''Message tab''': For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]], change the pay=100 to the value you require.

https://beds24.com/bookpay.php?bookid=[BOOKID]&g=st&capture=0&pay=100.

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain text box above. Template variables can be used [[Template_Variables| see here]]

'''Booking info tab: (Optional)'''

*Booking Info Code = SECDEPOSIT (for example)
*Booking Info Text = Security deposit request sent.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an Email in the guests language to an internal Email address ====
</div>
<div class="mw-collapsible-content">
This uses a smart template variable. In this example we check whether the guest booked in French. If yes, then we send a French text. If no, we send an English text.

'''Trigger tab:'''

Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1

Booking Source:
*Booking Source = All (for example)

Booking Conditions:
*Booking Status = All Not Cancelled

Booking Fields:
*Booking Field Contains - select "Language" in the next field enter: the short code for the language this Auto Action is for.

'''Message tab:'''
Enter the message in the appropriate language under your default language.

*Send Message = Internal Only

*Internal Email Address = enter the email address this message should be sent to.

*Email Subject - enter the subject for your Guests

*HTML box - Email will be sent

*Email Text :- Template variables can be used in the message. [[Template_Variables| See here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send SMS in a certain language (if it is the language of the booking) or a default language====
</div>
<div class="mw-collapsible-content">
This uses a smart template variable. In this example the auto action will trigger on Booking and for 1 day, we check whether the guest booked in French. If yes, then we send a French text. If no, we send an English text.

'''Trigger tab:'''

Set the rules to when this Auto Action should trigger.

Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1

Booking Source:
*Booking Source = All (for example)

Booking Conditions:
*Booking Status = All Not Cancelled

'''SMS tab:'''
*Phone Number = [GUESTMOBILE]
*SMS Message = [IF=:[GUESTLANGUAGE]:fr:French_text|English_text]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Remotelock/Lockstate, Nuki PIN or Chekin Link 2 days before Check-in (Self Checkin) ====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:-
*Trigger Event = Check-in
*Trigger Time = -2 (the number of days before check-in you want to sent the code or link)
*Trigger Window = 2

Booking Souce :-
*Booking Source = All
*Booking Status = All but not cancelled

Booking Conditions:-
*Group bookings = Trigger all on master

Info Codes :-
*Info Code = LOCKSTATE_PIN or NUKI_PIN or CHEKIN_URL (select the appropriate Booking Info Code for the service you use)

'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests - Your access code (your text)

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Include these template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] or [BOOKINGINFOCODETEXT:CHEKIN_PIN] see the list of ALL template variables that can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Include these template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] or [BOOKINGINFOCODETEXT:CHEKIN_PIN] see the list of ALL template variables that can be used [[Template_Variables| see here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Pin code to guest, 2 days before Check-in (Self Checkin) ====
</div>
<div class="mw-collapsible-content">

This auto action can be used if you have set a fixed PIN code in the Room Setup or using digits from the Booking id.

To setup the PIN code for each Room/Unit then go to {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > UNIT NAMES, then in the unit names, you can add additional information including a pin code.

Example:

You have 2 units (100 and 101). Access Pin Code for 100 = 12345, for 101 - 34567

In "Unit name" enter: (Use (?) in the room setup for more details/options)

*100|12345
*101|34567

'''Trigger tab:'''

Time:-
*Trigger Event = Check-in
*Trigger Time = -2 (the number of days before check-in you want to sent the code or link)
*Trigger Window = 2

Booking Souce :-
*Booking Source = All
*Booking Status = All but not cancelled

Booking Conditions:-
*Group bookings = Trigger all on master

'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests - Your access code (your text)

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Include these template variables - [UNITNAME] and [UNITNAME:1] or [BOOKIDLAST5] - Last 5 digits of booking number. See the list of ALL template variables that can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Include these template variables - [UNITNAME] and [UNITNAME:1] or [BOOKIDLAST5] - Last 5 digits of booking number. see the list of ALL template variables that can be used [[Template_Variables| see here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to guests with check-in details 2 days before Check-in, booking paid/no outstanding balance ====
</div>
<div class="mw-collapsible-content">

This auto action will be sent only when the Invoice Balance of the booking is zero. This can be used to ensure that the checkin details are only sent when the guest has completed the payments.

'''Trigger tab:'''

Time:-
*Trigger Event = Check-in
*Trigger Time = -2 (the number of days before check-in you want to sent the code or link)
*Trigger Window = 2

Booking Source:-
*Booking Source = All
*Booking Status = All but not cancelled

Booking Conditions:-
*Group bookings = Trigger all on master
*Invoice Balance = Zero

'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests - Your access code (your text)

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. This can include any information that is important for the checkin of the guest, for example the Key code for the door, who to contact if there are any issues, template variables can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- Enter the text you wish to send to your guests this can include URLs. Include any information that is important for the checkin of the guest, for example the Key code for the door, who to contact if there are any issues, template variables can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to guests with check-in details 2 days before Check-in, Security Deposit Authorised at Stripe ====
</div>
<div class="mw-collapsible-content">

This auto action will be sent only when the a payment has been 'authorised' at Stripe. This can be used to ensure that the checkin details are only sent when the guest has completed the Security Deposit Authorisation.

'''Trigger tab:'''

Time:-
*Trigger Event = Check-in
*Trigger Time = -2 (the number of days before check-in you want to sent the code or link)
*Trigger Window = 2

Booking Source:-
*Booking Source = All
*Booking Status = All but not cancelled

Booking Conditions:-
*Group bookings = Trigger all on master
*Invoice Balance = Zero

Info codes :-
*Any Booking Info Code = STRIPEAUTHORIZE

'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests - Your access code (your text)

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. This can include any information that is important for the checkin of the guest, for example the Key code for the door, who to contact if there are any issues, template variables can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- Enter the text you wish to send to your guests this can include URLs. Include any information that is important for the checkin of the guest, for example the Key code for the door, who to contact if there are any issues, template variables can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to all current guest (Check-in) ====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''

Time:
*Trigger Event = Check-in
*Trigger Time = Immediate
*Trigger Window = 14(the max number of days your guests can stay)

Booking Source:
*Booking Source = All

Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

Info Codes:
*Any Booking Info Code = CHECKIN
*Exclude Booking Info Code = CHECKOUT

'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkin to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email with Guest Invoice - PDF attachment====
</div>
<div class="mw-collapsible-content">

You can send Invoice as an attachment to your Guests.

Setup your Invoice go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> INVOICING

'''Trigger tab:'''

Time:
*Trigger Event = Checkout
*Trigger Time = Immediate
*Trigger Window = 1 day

Booking Source:
*Booking Source = All (or select the appropriate channel/Direct)

Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

Info Codes:
*Any Booking Info Code = CHECKOUT

'''Messaging tab:'''

*Send Email = Guest API/Smart Email (or one of the other options)

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Attachment = Select the Invoice Template from the drop down list.

*Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkout to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.

If you send Emails with pdf attachment (invoice, booking template) to Alias-Email addresses created by channels the channel might block the attachment so it is not delivered to the guest. Ask your channel about their policy regarding this.

Other files can not be attached. We recommend you use a link to a file you upload to your web site.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email with Booking Registration Form - PDF attachment====
</div>
<div class="mw-collapsible-content">

You can send Booking Template attachments to your Guests.

Setup your Booking Template, go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> BOOKING TEMPLATES

'''Trigger tab:'''

Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1 day

Booking Source:
*Booking Source = All (or select the appropriate channel/Direct)

Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

'''Messaging tab:'''

*Send Message = Guest API/Smart Email (or one of the other options)

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Attachment = Select Booking Template from the drop down list.

*Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkout to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.

If you send Emails with pdf attachment (invoice, booking template) to Alias-Email addresses created by channels the channel might block the attachment so it is not delivered to the guest. Ask your channel about their policy regarding this.

Other files can not be attached. We recommend you use a link to a file you upload to your web site.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email after the cleaner has cleaned the room====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest then they can check you/the cleaner have to add a unit status to the room when it is ready. In this example we used the unit status clean

'''Trigger tab:'''

Time:
*Trigger Event = Checkin
*Trigger Time = Immediate
*Trigger Window = 1

Booking Source:
*Booking Source = All

Booking Conditions
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

Booking Fields:
*Template Variable = [UNITSTATUS1] Contains = clean

'''Messaging tab: '''
*Send Email = Guest API/Smart Email (or one of the other options)

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API

Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

*HTML box - Email will be sent

Email Text :- It is possible to use the same details as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]

*Attachment :- if you want to send a Booking/Invoice template you can select from the drop down list.

Other files can not be attached. We recommend you use a link to a file you upload to your web site.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to your guest - Upselling additional nights - nights available after checkout ====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest confirming that it is possible to extend their stay.

This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.

'''Trigger Tab :'''

Time:
*Trigger Event = Checkin (depending on when you want to notify the guest)
*Trigger Time = -2 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 2

Booking Source:
*Booking Source = All

Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

Booking Fields:
*Template Variables = [IFBETWEEN:[TURNOVERDAYS]:0:3:yes|no|no] equal yes

This template variable tests if there is 3 days between the guest booking and the next booking.

'''Message tab:'''

For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.

*Send Message = Booking API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Email Subject - enter the subject for your Guests

*Plain text box - will send to channels using Message API, enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

[IF<=:[TURNOVERDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [TURNOVERDAYS] extra night(s)|].

We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.

*HTML box - Email will be sent, enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]

[IF<=:[TURNOVERDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [TURNOVERDAYS] extra night(s)|].

We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.

'''Booking Info Tab : Optional '''
*Booking info code = EXTRANIGHTS
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to your guest - Upselling additional nights - nights available before checkin ====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest confirming that it is possible to extend their stay.

This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.

'''Trigger Tab :-'''

Time:
*Trigger Event = Checkin (depending on when you want to notify the guest)
*Trigger Time = -2 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 2

Booking Source:
*Booking Source = All

Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled

Booking Fields:
*Template Variables = [IFBETWEEN:[VACANTDAYS]:0:3:yes|no|no] equal yes

This template variable tests if there is upto 3 days from previous checkout to check in of current booking.

'''Messaging tab :- '''
*Send Message = Guest API/Smart Email

If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.

If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.

*Subject = Enter the appropriate details

*Plain Text Box = Your text, using the template variables to modify the specific text in the booking.

[IF<=:[VACANTDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [VACANTDAYS] extra night(s)|].

We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.

*HTML Box

[IF<=:[VACANTDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [VACANTDAYS] extra night(s)|].

We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.

'''Booking Info Tab :- Optional'''
*Booking info code = EXTRANIGHTS,
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to your guest - Offering Early Checkin ====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest confirming that it is possible to have an Early Checkin as room is available the day of before arrival.

This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.

Trigger Tab :-
*Trigger Event = Checkin (depending on when you want to notify the guest)
*Trigger Time = -2 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 2
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings = Trigger all on master
*Template Variables = [IF>:[VACANTDAYS]:1:yes|no] equal yes

This template variable tests if there is 1 day between the guest booking and the next booking.

Message tab :-
*Send Email = Guest API/Smart Email (or one of the other options)
*EMail Subject = Enter the appropriate details
*Email Text = Your text, using the template variables to modify the specific text in the booking. Enter the text in both Plain text Box (Messaging API) and HTML Box (Emails)

Dear, [GUESTNAME],

We are very happy to offer you 'Early Check-in' at [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK].

If you would like checkin early for your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EARLYARRIVAL’ for the special Price.
Best regards,

[PROPERTYCONTACTFIRSTNAME] [PROPERTYCONTACTLASTNAME]
[PROPERTYNAME]
[PROPERTYADDRESS],
[PROPERTYCITY],
[PROPERTYPOSTCODE],
[PROPERTYSTATE],
[PROPERTYCOUNTRY].

Email :-[PROPERTYEMAIL]
Website :- [PROPERTYWEB]

Booking Info Tab :- Optional
*Booking info code = EARLYARRIVAL,
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] Early Checkin

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to your guest - Offering Late Checkout ====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest confirming that it is possible to have a Late Checkout as room is available the day of departure.

This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.

Trigger Tab :-
*Trigger Event = Checkout
*Trigger Time = -1 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 1
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings = Trigger all on master
*Template Variables = [IF>:[TURNOVERDAYS]:1:yes|no] equal yes

This template variable tests if there is 1 day between the guest booking and the next booking.

Message tab :-
*Send Email = Guest API/Smart Email (or one of the other options)
*EMail Subject = Enter the appropriate details
*Email Text = Your text, using the template variables to modify the specific text in the booking. Enter the text in both Plain text Box (Messaging API) and HTML Box (Emails)

Dear, [GUESTNAME],

We are very happy to offer you 'Late Check-out' at [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK].

If you would like a late checkout, then please send an email to our Reservations team [PROPERTYEMAIL] confirming you would like the Late Checkout, provide your Booking Reservation Number [BOOKID] and Offer ‘LATECHECKOUT’ for the special Price.

Best regards,

[PROPERTYCONTACTFIRSTNAME] [PROPERTYCONTACTLASTNAME]
[PROPERTYNAME]
[PROPERTYADDRESS],
[PROPERTYCITY],
[PROPERTYPOSTCODE],
[PROPERTYSTATE],
[PROPERTYCOUNTRY].

Email :-[PROPERTYEMAIL]
Website :- [PROPERTYWEB]

Booking Info Tab :- Optional
*Booking info code = LATCHECKOUT,
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] Late Checkout

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send Email to your guest - Offering Late Checkout Only on a Sunday when there is no new arrival ====
</div>
<div class="mw-collapsible-content">

To send an automated Email to the guest confirming that it is possible to have a Late checkout on Sundays as the room is available on the day of departure.

This auto action will create a new booking for the date of departure, closing the calendar to any other bookings.

The URL link in the message tab, will send the guest to your guest booking page with set conditions, the leaving date of the existing booking, the room id of the existing booking and the Offer you have created for the LateCheckout.

This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.

'''Step 1: ''' Create a new offer in {{#fas:cog}} (SETTINGS) > PROPERTIES > OFFERS

*Name = Latecheckout
*Enable = Only if Available
*Booking Type = Confirmed with Deposit 2 - via payment gateway

'''Step 2:''' Create a Rate or Daily Price, PRICES

*Guests = Max Occupancy
*Max Stay = 1
*Offer = select the offer number as created in the above step.

If you are using Rates, select 'Rate allowed' = Sunday, untick all the other days.
Channel Tab, untick all channels, leave only 'beds24.com' for your booking page.

If using Daily Prices, then go to Calendar, and set the price and date range, then only Sunday, untick all the other days.
Enable list, untick all channels, leave only 'beds24.com' for your booking page.

'''Step 3: ''' Create the Auto Action

Trigger Tab :-
*Trigger Event = Checkout
*Trigger Time = -1 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 1
*Booking Source = All
*Booking Status = All but not cancelled
*Between Booking and Check in = 2 and 999 (to stop the auto action triggering on the new booking)

*Group bookings = Trigger all on master

*Template Variables = [IF=:[LEAVINGDAY:{%a}]:Sun:|[IF>=^[TURNOVERDAYS]^1^yes~no]] equal yes

This template variable tests if the departure day is a Sunday and there is at least 1 day between the existing guest booking and the next booking.

Message tab :-
*Send Email = Guest API/Smart Email (or one of the other options)
*EMail Subject = Enter the appropriate details
*Email Text = Your text, using the template variables to modify the specific text in the booking. Enter the text in both Plain text Box (Messaging API) and HTML Box (Emails)

Dear, [GUESTNAME],

We are very happy to offer you 'Late Check-out' at [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK].

If you would like a late checkout, please use this link to make the booking and payment.

https://beds24.com/booking2.php?checkin=[LEAVINGDAYYYYY-MM-DD]&br7-[ROOMID]

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The details in the URL, will direct the guest to make a new booking in the existing room with the check-in date = leaving date and for Offer 7 &br-7 (offer created in Step 1 above)

Enter your Booking Reservation Number [BOOKID] into the Booking id box on the booking page.
Best regards,

[PROPERTYCONTACTFIRSTNAME] [PROPERTYCONTACTLASTNAME]

Email :-[PROPERTYEMAIL]
Website :- [PROPERTYWEB]

Booking Info Tab :- Optional
*Booking info code = LATCHECKOUT,
*Booking Info Description = Upsell email sent [CURRENTDATE]: Late Checkout

</div>
</div>

===Send an email to the Owner/Internal email address ===
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Send an email to the Owner/Internal email address when a payment FAILS at Stripe====
</div>
<div class="mw-collapsible-content">

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Booking Info Code = STRIPEFAIL, CARDFAILSTRIPE

Messaging tab:
*Send Message = Internal
*Internal Email Address = enter the email address to receive the notification
*Subject = Failed Stripe Payment
*HTML Box = Enter the text to be sent, you can use template variables in this message, for example

[BOOKID] - booking reference number
[GUESTNAMES] - name of all guests in the booking on the "summary" tab of the booking
[FIRSTNIGHT]
[LASTNIGHT]

Booking tab: (optional)
*Execution = One time only
*Flag Text = Stripe Payment Failed
*Flag Colour - choose the flag colour
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Send an email to the Owner/Internal email address for a new booking====
</div>
<div class="mw-collapsible-content">

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 1 day
*Booking Source = All
*Booking Status = All but not cancelled

Messaging tab:
*Send Message = Internal
*Internal Email Address = enter the email address to receive the notification
*Subject = New Booking
*HTML Box = Enter the text to be sent, you can use template variables in this message, for example

[BOOKID] - booking reference number
[GUESTNAMES] - name of all guests in the booking on the "summary" tab of the booking
[FIRSTNIGHT]
[LASTNIGHT]

</div>
</div>

===Booking Info Codes===
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Add CHECKIN Booking info code to bookings ====
</div>
<div class="mw-collapsible-content">

If you need to use the Booking info code CHECKIN/CHECKOUT for reporting/other auto actions, you can set the Booking info code rather than use the Current guest module in the dashboard.

Trigger tab:
*Trigger Event = Check-in
*Trigger Time = Immediate
*Trigger Window = 1 day
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings = Trigger all on master

Booking Info tab:
*Booking Info Code = CHECKIN
*Booking Info Text = Auto Checkin
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Add CHECKOUT Booking info code to bookings ====
</div>
<div class="mw-collapsible-content">

If you need to use the Booking info code CHECKIN/CHECKOUT for reporting/other auto actions, you can set the Booking info code rather than use the Current guest module in the dashboard.

Trigger tab:
*Trigger Event = Check-out
*Trigger Time = Immediate
*Trigger Window = 1 day
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings = Trigger all on master

Booking Info tab:
*Booking Info Code = CHECKOUT
*Booking Info Text = Auto Checkout
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Group check-in ====
</div>
<div class="mw-collapsible-content">
This requires the master booking to be checked-in via the check-in function.

Trigger tab:

*Trigger Event = After Booking
*Trigger Time = immediately
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings" = Trigger all on master
*Info Code = CHECKIN

Booking info tab :
*Info Code = CHECKIN
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Identify Repeat Guest ====
</div>
<div class="mw-collapsible-content">
This requires you to use the Guest database.

Trigger tab:

*Trigger Event = After Booking
*Trigger Time = immediately
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings" = Trigger all on master
*Template Variable = [GUESTSID1] greater than 0

Booking info tab :
*Info Code = REPEAT
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Identify bookings with Custom Question ticked/unticked ====
</div>
<div class="mw-collapsible-content">
If you have a custom question with a 'Tick box' for example, they want a late checkin.

Setup the custom question in {{#fas:cog}} (SETTINGS) PROPERTIES -> BOOKING QUESTIONS -> CUSTOM QUESTIONS -> Custom question 1, set with TYPE = Tick Box.

Trigger tab:

*Trigger Event = After Booking
*Trigger Time = immediately
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Group bookings" = Trigger all on master
*Template Variable = [GUESTCUSTOMQ1] equals ticked (or) not ticked

Booking info tab :
*Info Code = LATECHECKIN
</div>
</div>

===Add invoice items to a booking ===

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Add a fee to all bookings from a channel====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Expedia (for example)

Invoice tab:
*Add Invoice Item = Add new
*Type = Amount
*Description = Cleaning fee (for example) - Template variables can be used.
*Amount = 50 (for example - the amount of your cleaning fee)
*per = Room
*Period = one time
*VAT = 19% (for example - enter the VAT amount if applicable)

The fee will be added the next time the auto actions run.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Add a fee (Penalty) to all bookings with an Outstanding Balance====

</div>
<div class="mw-collapsible-content">
You want to add a 2.2% fee to all bookings if there is an outstanding balance 2 days prior to checkin.

Trigger tab:

Time :
*Trigger Event = Checkin
*Trigger Time = -2 days
*Trigger Window = 2 days

Booking Conditions:
*Status = All not Cancelled
*Invoice Balance = Not Zero

Invoice tab:
*Type = Amount
*Description = Payment Fee||[INVOICEBALANCE:2.2%]
*Amount = 0 (leave as 0 so the value is set from the calculation in Description field)
*Per = Room
*Period = one time
*VAT = 19% (for example - enter the VAT amount if applicable)

The fee will be added the next time the auto actions run.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Add a negative value to Direct bookings for Stripe Charges====

</div>
<div class="mw-collapsible-content">
You want to add the Stripe fee to all Direct bookings to show total value of booking, i.e. if you want to show the booking value. In this example the Stripe charge will be added as a negative figure.

Trigger tab:

Time :
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1 day

Booking Conditions:
*Status = All not Cancelled

Booking Source:
*Booking Source = Direct

Invoice tab:
*Type = Amount
*Description = Stripe Fee||[INVOICECHARGESNUM:-3%]
*Amount = 0 (leave as 0 so the value is set from the calculation in the Description field)
*Per = Room
*Period = one time
*VAT = 19% (for example - enter the VAT amount if applicable)

The fee/charge will be added the next time the auto actions run.
</div>
</div>

===Modify description/values of an existing invoice item in a booking ===

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Update the Description field of a charge/invoice item====

</div>
<div class="mw-collapsible-content">

In some cases Channel bookings have different descriptions for the same charge item - i.e. Cleaning, update the description field in the invoice item so they all match, using the format (findthisinvoicedescription^replacewiththisdescription)

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Expedia (for example)

Invoice tab:
*Add Invoice Item = Update Only
*Type = Change Description
*Description = Cleaning^Cleaning Service Fee
*Invoicee = Ignore (otherwise you can add a specific Invoicee to limit the search)

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Update all values of a charge/invoice item====

</div>
<div class="mw-collapsible-content">

You need to change the charges in bookings due to an update in your prices. Tourist Tax (for example), update the description field and value using the format (findthisinvoicedescription^replacewiththisdescription)

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Time Window = 365
*Check In From = Select the first date of the Summer Season
*Check In To = Select the last date of the Summer Season

*Booking Source = Expedia (for example)

Invoice tab:
*Add Invoice Item = Update Only
*Type = Change All
*Description = Tourist Tax^Tourist Tax - Summer season 2022 (for example)
*Amount = 0.75
*Per = Per Person
*Period = One time
*Invoicee = Ignore (otherwise you can add a specific Invoicee to limit the search)

</div>
</div>

===Payments/Pending Payments===

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Add a pending payment====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking or Before Check-in
*Trigger Time = set the time you want to collect the payment
*Booking Source =All (for example, you can also set different rules for different channels)
*Group Booking Trigger = Trigger only Master (this will trigger on individual bookings and Master booking if a group)

Booking Info tab: Optional
Add a booking info tab for information and reporting
*Flag Text = PendingPayment (for example)
*Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Booking tab: Optional
*Booking Info Code = PENDPAY
*Booking Info Text = Pending payment added

Invoice tab:
*Payment Type = select on what the payment is calculated (Percent of Balance due)
*Description = the text you will see in the "Charges and Payments" tab
*Status = if you use the status function add the status you want to apply to the pending payment (optional)
*Amount = enter the amount or percentage you want to collect
*Payment Rule = use auto or manual - if you have set up payment rules in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT->PAYMENT COLLECTION they will be available here
*Payment Due = Set when the payment is due

Create a Payment Rule to collect a payments when bookings are not cancelled.

Go to Settings > Payments > Payment Rules

Payment Rule :

Name = Enter your title - Not Cancelled (for example)
Action = Auto

Payment Trigger :

*Booking Status = All not cancelled
*Any Booking Info Code = optional
*All Booking Info Codes = optional
*Exclude Booking Info Code = optional (can exclude Virtual Credit cards, find the Booking info code in the booking)

Payment Action :

*Capture = Yes - immediately charged (Capture=Yes)
*Add info code on success = add a Booking Info item to the booking on success
*Add info code on failure = add a Booking Info item to the booking on failure

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Add a pending payment - Set the Security Deposit value based on the price of the booking, using a calculation ====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking or Before Check-in
*Trigger Time = set the time you want to collect the payment
*Booking Source =All (for example, you can also set different rules for different channels)

Booking tab: Optional
*Flag Text = PendingPayment (for example)
*Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Booking Info tab: Optional
Add a booking info tab for information and reporting
*Booking Info Code = PENDPAY
*Booking Info Text = Pending payment added

Invoice tab:
*Payment Type = fixed value
*Description = Security Deposit||[IF<=:[INVOICEFIRSTITEMNUM]:800:200|[INVOICEFIRSTITEMNUM][/.0]4]
(Security Deposit is the description, then 2 | symbol, then the calculation for the 'Amount' to be set.)

This calculation, tests if the first invoice item value (usually the Accommodation value) is greater than or = 800 if so set the Security Deposit Amount = 1 quarter of the first invoice item value, otherwise set = 200.

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> A price value for the invoice item can be specified after a second pipe (|) symbol, this can be used to calculate a price using template variables. If the price value in the description field is zero or absent, the numeric value from the amount field will be used.

*Status = if you use the status function add the status you want to apply to the pending payment (optional)
*Amount = 0
*Payment Rule = use auto or manual - if you have set up payment rules in {{#fas:cog}} (SETTINGS) Payments > Payment Rules they will be available here
*Payment Due = Set when the payment is due

Create a Payment Rule to collect a payments when bookings are not cancelled.

Go to Settings > Payments > Payment Rules

Payment Rule :

Name = Enter your title - Not Cancelled (for example)
Action = Auto

Payment Trigger :

*Booking Status = All not cancelled
*Any Booking Info Code = optional
*All Booking Info Codes = optional
*Exclude Booking Info Code = optional (can exclude Virtual Credit cards, find the Booking info code in the booking)

Payment Action :

*Capture = Yes - immediately charged (Capture=Yes)
*Add info code on success = add a Booking Info item to the booking on success
*Add info code on failure = add a Booking Info item to the booking on failure

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Collect outstanding booking balance 3 days prior to arrival( Credit card details were collected at time of booking)====
</div>
<div class="mw-collapsible-content">

''''Create a Payment Rule (Optional)''''

Standard payment rules in the system are Auto & Manual, you can create additional rules for the collection of outstanding payments, you can control the collection of payments if the booking status is changed, for example the booking is cancelled before the final payment is due to be collected.

Go to {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT RULES

Create a Payment Rule to collect payments if bookings are not cancelled.

Click '''Create New Payment Rule''' :

Payment Rule:
*Name = Enter your title - Not Cancelled (for example)
*Action = Auto

Payment Trigger :
*Booking Status = All not cancelled
*Any Booking Info Code (optional)
*All Booking Info Codes (optional)
*Exclude Booking Info Code = optional (can exclude Virtual Credit cards, find the Booking info code in the booking)

Payment Action :
*Funding Source = Guest card only
*Payment value adjustment = Limit to group booking balance
*Capture = Yes - immediately charged (Capture=Yes)
*Add info code on success = add a Booking Info item to the booking on success
*Add info code on failure = add a Booking Info item to the booking on failure

Prevent Auto Payment :
*Prevent payment if booking status = Cancelled
*Prevent payment after check-out (days) = 7 (default)
*Prevent payment action = Set Manual

'''Create Auto Actions '''

Collect the outstanding balance for bookings created via your booking page.

Go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS and click '''Create New Action''' to create them.

'''Collect outstanding balance for direct bookings'''

Trigger tab:
*Time
**Trigger Event = Checkin
**Trigger Time = -3 days (set the time you want to collect the payment)
**Time Window = 3 days (set this to the same number (positive) as Trigger time.

*Booking Source
**Booking Source = Direct. You can have different auto actions/rules for direct bookings -v- channel bookings, then select ‘Direct’ this will include manually created bookings and booking page bookings.

*Booking Conditions
**Group Booking Trigger = Trigger only Master
**Status = All not cancelled
**Invoice Balance= Not Zero (can be used to refine the auto action being triggered)

Booking tab: Optional
*Flag Text = Pending payment added (for example)
*Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Booking Info tab: Optional, for information and reporting
*Booking Info Code = BALANCE (for example enter the value - use one word only)
*Booking Info Text = Enter the description/text to show in for the Booking Info Code.

Invoice tab:

<div class="warning">{{#fas:exclamation-triangle}} ONLY use Payment Type =‘ Percent of Group balance due’ if you selected Trigger tab > Booking Conditions > Group Booking Trigger = Trigger Only Master.</div>

*Add a Pending Payment to the booking
**Payment Type = Percent of Group Balance due (select on what the payment is calculated)
**Description = the text you will see in the "Charges and Payments" tab
**Status = if you use the status function add the status you want to apply to the pending payment (optional)
**Amount = 100 (this will be 100% of the outstanding group balance)
**Payment Rule = Not Cancelled - See Step 4 above (if you have set up payment rules in {{#fas:cog}} (SETTINGS) PAYMENTS ->PAYMENT RULES they will be available here)
**Payment Due = Trigger date
**Payment time = set the time to collect payment
**Invoicee = If you use the "invoicee" function you can select which invoicee the pending payment will be assigned to.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

===='Capture' a Security Deposit when Credit card is collected at time of booking. ====
</div>
<div class="mw-collapsible-content">

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = immediate
*Booking Source =All (for example, you can also set different rules for different channels)

Info Codes:
Any Booking Info Code = CARDTOSTRIPE

Invoice tab:
*Payment Type = Fixed amount
*Description = Security Deposit (the text you will see in the "Charges and Payments" tab)
*Status = if you use the status function add the status you want to apply to the pending payment (optional)
*Amount = 100 (balance is full price so 100% of the balance)
*Payment Rule = Security Deposit (Create a Payment Rule, see below)
*Payment Due = check in

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Automatic collection is only available for customer who use [[Stripe]].

Create a Payment Rule to 'Capture' a payment only. Captured payments will only be valid for 7 days, then it will expire, if the booking is for a longer period, then you can create a second Capture, you will need to create another auto action for this.

Go to {{#fas:cog}} (SETTINGS) PAYMENTS > PAYMENT RULES

Payment Rule :
*Name = Enter your title - Security Deposit (for example)
*Action = Auto

Payment Trigger :
*Booking Status = select from the drop down list
*Any Booking Info Code = optional
*All Booking Info Codes = optional
*Exclude Booking Info Code = optional (can exclude Virtual Credit cards, find the Booking info code in the booking)

Payment Action :
*Capture = Yes/No - immediately charged (Capture=Yes), if you want to make sure that the amount is available for later capture (Capture=No)
*Add info code on success = add a Booking Info item to the booking on success
*Add info code on failure = add a Booking Info item to the booking on failure
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Apply an info code and and/or icon when a payment was made====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Invoice Balance = Any Payment made

Booking Info tab:
*Execution = One time only
*Info Code = Enter the preset code for the icon or info code which you have created in {{#fas:cog}} (SETTINGS) ACCOUNT->PREFERENCES.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Assign invoice numbers====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = Check-out
*Trigger Time = Immediate
*Any Booking Info Code = CHECKOUT (optional only if you use the check-out function, if not leave blank)

Invoice tab:
*Assign Invoice Number = yes
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Using Pending Payments as a Payment Reminder====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking or Before Check-in
*Trigger Time = set the time you want to add the pending payment to the booking
*Booking Source =All (for example, you can also set different rules for different channels)

Booking Info tab:
*Optional, add a booking info tab for information and reporting

Booking tab: Optional
*Flag Text = PaymentDue1 (for example), set multiple if multiple payments are required.
*Flag Colour = select the colour as this will be visible in the Calendar/Bookings list

Invoice tab:
*Payment Type = select on what the payment is calculated (Percent of Balance due)
*Description = the text you will see in the "Charges and Payments" tab
*Status = if you use the status function add the status you want to apply to the pending payment (optional)
*Amount = enter the amount or percentage you want to collect
*Payment Rule = Manual - if you have set up payment rules in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT->PAYMENT COLLECTION they will be available here
*Payment Due = Set when the payment is due

The Pending Payment Report is available in Bookings > Pending Payments. This report can be used to see outstanding pending payments, this can be used to see all outstanding payments, when payment gateways other than Stripe are used, the Pending Payments report can be used to see outstanding payments and a checklist for bank transfers.

</div>
</div>

===Booking Flags/Colours===

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Apply a flag when a booking is cancelled====
</div>
<div class="mw-collapsible-content">
Trigger tab
*Trigger Event = After Booking
*Trigger Time = 1 Hour
*Trigger Window = 365 days
*Booking Status = Cancelled

Booking tab:
*Execution = One time only
*Booking Status = No Change
*Flag text = (enter the text you require)
*Flag Colour = Set as required
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Apply a flag for a bookings from a channel which have breakfast included====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Booking.com (for example)
*Booking Field Contains - select "API Message" in the next field enter: meal_plan=Breakfast (or Extra Breakfast - use the text the channel uses)

Booking tab:
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour

Booking changes are applied before the mail is sent so that the flag template variable can be reflected in the Email.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Apply a flag for a bookings which has BREAKFAST as a charge item====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Booking.com (for example)
*Template Variable = [IF>:[INVOICEITEMBYDESC:Breakfast]:0:yes|no] (Text for Breakfast has to match EXACTLY what is in the booking item Uppercase/Lowercase/Proper)
*Select 'equal' from the selection box
*yes (needs to be exactly the same text/upper/lowercase, as in the equation)

Booking tab:
*Execution = One time only
*Flag Text = Breakfast
*Flag Colour - choose the flag colour

Booking Info tab:
*Booking Info Code = BREAKFAST
*Booking Info Description = Breakfast included
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Apply a flag when deposit was made prior to Check-in====
</div>
<div class="mw-collapsible-content">
Trigger tab:

*Trigger Event = Check-in
*Trigger Time = -365 (for example : must be a negative value and the same as the value in Trigger window)
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Invoice Balance = Any Payment made

Message tab:

*Send Email : select appropriate option
*Enter : Subject and Email content

Booking tab: (optional)

*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour

Booking info tab : (optional)

*Booking Info Code : DEPOSITPAID (for example)
*Booking Info Text : additional text if required.

Setting details with the Booking tab and Booking info tab allows you to trigger additional (follow on) Auto Actions and Reports.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Apply a flag when booking is fully paid====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All not cancelled
*Invoice Balance = ZERO

Booking tab:
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Apply a flag/colour for a booking coming from a certain channel====
</div>
<div class="mw-collapsible-content">

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Booking.com (for example)

Booking tab:
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour

Booking changes are applied before the mail is sent so that the flag template variable can be reflected in the email.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Apply a flag when a payment was made====
</div>
<div class="mw-collapsible-content">
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Also see Example : " Apply a flag when deposit was made prior to Check-in AND/OR Apply a flag when booking is fully paid".

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All not cancelled
*Invoice Balance = Any Payment made

Booking tab:
*Execution = One time only
*Flag Text = The text you want to display
*Flag Colour - choose the flag colour
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Apply a flag when a payment FAILS at Stripe====
</div>
<div class="mw-collapsible-content">

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Booking Info Code = STRIPEFAIL, CARDFAILSTRIPE

Booking tab:
*Execution = One time only
*Flag Text = Stripe Payment Failed
*Flag Colour - choose the flag colour
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Apply a flag to Booking.com bookings and auto report the Credit Card when a payment FAILS at Stripe====
</div>
<div class="mw-collapsible-content">

Go to Settings > Channel Manager > Preferences and set Auto report failed cards = Yes

Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365
*Booking Source = All
*Booking Status = All but not cancelled
*Booking Info Code = BOOKINGCOMCARD

Booking tab:
*Execution = One time only
*Flag Text = Failed CC reported to Booking.com
*Flag Colour - choose the flag colour
</div>
</div>

===Status changes===
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
==== Change the status of all "Request" bookings to "Cancelled" after three days ====
</div>
<div class="mw-collapsible-content">
Trigger tab
*Trigger Event = Booking
*Trigger Time = 3 days
*Booking Status = Request

Booking tab:
*Execution = One time only
*Booking Status = Cancelled
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

==== Change the status of all bookings which have been imported from Ical to "Request" ====
</div>
<div class="mw-collapsible-content">
Trigger tab:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Booking Source = Ical Import (1, 2, 3)

Booking tab:
*Execution = One time only
*Booking Status = Request

Booking changes are applied before the mail is sent.
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

==== Change Room Unit Status when guest checks out ====
</div>
<div class="mw-collapsible-content">
Trigger tab
*Trigger Event = Check-out
*Trigger Time = Immediate
*Trigger Window = 1 day
*Booking Status = All but not cancelled
*Any Booking Info Code = CHECKOUT

Booking tab:
*Execution = One time only
*Change Room Unit Status = Select the option

It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkin to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.
</div>
</div>

===API/Webhook===
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Use API/Webhook to write to the field 'Message'====
</div>
<div class="mw-collapsible-content">

You can use a webhook in conjunction with the API JSON function '''setBooking''' to write to any field in the booking. First you have to configure access to the API:

You need two keys to use our API JSON functions - one for the API itself and one for the property. The keys have to consist of 16 characters of your choosing.<br>
'''API key:'''
*{{#fas:cog}} (SETTINGS) ACCOUNT -> ACCOUNT->ACCESS "API Key 1"
*API Key = my_very_secret_api_key
*API Key Access = allow any IP
*IP Whitelist = [leave empty]
*Allow Writes = Yes
*Property Access = Owned by this account only
*'''Property key:'''
*{{#fas:cog}} (SETTINGS) PROPERTIES > ACCESS > propKey = secret_key_for_prop_XXXXXX

Set the triggers you need, for example:

Booking Field Contains: Message = XXX

Set the webhook like this:

* URL = <nowiki>https://api.beds24.com/json/setBooking</nowiki>
* Custom Header = [leave empty]

Body Data:
:{
::"authentication":
::{
:::"apiKey": "my_very_secret_api_key",
:::"propKey": "secret_key_for_prop_XXXXXX"
::},
::"bookId": "[BOOKID]",
::"message": "[MESSAGE] - Append this message"
:}
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Use API/Webhook to write the value of the 'commission' field to a new invoice item====
</div>
<div class="mw-collapsible-content">
You can create a new invoice item that contains the price of the channel's commission as a negative value to subtract it from the room price. You use the API JSON function '''setBooking''' for this. First you need to configure access to the API:

You need two keys to use our API JSON functions - one for the API itself and one for the property. The keys have to consist of 16 characters of your choosing.<br>
'''API key:'''
*{{#fas:cog}} (SETTINGS) ACCOUNT -> ACCOUNT->ACCESS "API Key 1"
*API Key = my_very_secret_api_key
*API Key Access = allow any IP
*IP Whitelist = [leave empty]
*Allow Writes = Yes
*Property Access = Owned by this account only
*'''Property key:'''
*{{#fas:cog}} (SETTINGS) PROPERTIES > ACCESS> propKey = secret_key_for_prop_XXXXXX

Set the triggers you need, for example:

Booking Source = Booking.com

Set the webhook like this:

*URL = <nowiki>https://api.beds24.com/json/setBooking</nowiki>
*Custom Header = [leave empty]

*Body Data =
:{
::"authentication":
::{
:::"apiKey": "my_very_secret_api_key",
:::"propKey": "secret_key_for_prop_XXXXXX"
::},
::"bookId": "[BOOKID]",
::"invoice":
::[
:::{
::::"description": "Booking.com Commission",
::::"status": "",
::::"qty": "1",
::::"price": "-[COMMISSIONNUM]",
::::"vatRate": "7.00",
::::"type": "0",
::::"invoiceeId": ""
:::}
::]
:}
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

====Use Auto Action/Webhook to write to send data to Integromat====
</div>
<div class="mw-collapsible-content">

You can use this option to send data to your Integromat account.

Set the rules in the Trigger tab, when you need to send the data to Integromat.

Go to Webhook tab:

URL = https://hook.integromat.com/ followed by your integromat account key.

Body Data = you can use the template variables allows in the list for Integromat [[https://wiki.beds24.com/index.php/Make#Data_Fields Data fields]]

For example :-

bookingData={

"bookId":"[BOOKID]",

"guestMobileNum":"[GUESTMOBILENUM]",

"guestMobile":"[GUESTMOBILE]",

"guestSMS":"[GUESTSMS:44]",

"guestFirstName":"[REPLACE|&|and|[GUESTFIRSTNAME]]",

"propertyName":"[PROPERTYNAME]",

"propertyId":"[PROPERTYID]",

"firstNight":"[FIRSTNIGHTSHORT]",

"lastNight":"[LEAVINGDAYSHORT]"

}

</div>
</div>

===Testing for Modified bookings===
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
====Use Template Variables to test for Modified bookings====
</div>
<div class="mw-collapsible-content">

You can test if the booking has been modified, adding a booking info code to the booking will then allow you to trigger other auto actions, run reports etc.

Trigger tab
*Trigger Event = Booking (but not after Check-in) OR Booking
*Trigger Time = 1 day (this will ensure that NEW bookings do not trigger this auto action)
*Trigger Window = 365 days
*Booking Status = All not cancelled

*Template Variables [MODIFYDATE:{%Y-%m-%d %H:%M:%S}] greater than [CURRENTDATE:-1day{%Y-%m-%d %H:%M:%S}]

Booking tab: (Optional)
*Flag text = (enter the text you require)
*Flag Colour = Set as required

Booking Info tab : (optional)
*Booking Info Code = MODIFIED
*Booking Info Text = Booking modification
</div>
</div>

Webinars

2022-10-06T17:29:19Z

IuriRosa:

[[Category:Support]]
<div class="heading">Beds24 Webinars</div>
__TOC__

= Upcoming Webinars =
==Getting started with Beds24==
Date & Time: October 13th 11:00 (Amsterdam, Berlin, Paris, Rome, Stockholm, Vienna)

In this webinar we will show you what Beds24 can do for your and how it works. After the presentation we will answer your questions.

*Key Functionalities
*Walk through the control panel
*How to get help
*Q&A

Register: [https://us06web.zoom.us/meeting/register/tZAsfumoqTIsHdEyxFyYOXQWrc-WfNHvV-_f Click here to register]

<div style="display:none">

What's new and what's cooking

Date & Time: September 29th, 11:00 a.m. (Amsterdam, Berlin, Paris, Rome, Stockholm, Vienna)

In this webinar we will show you the latest feature releases new features in development and you will also have the option to ask questions.

Register: [https://us06web.zoom.us/meeting/register/tZwpfuqvrzsoGtRsFRoyNzIumB7BBm6Jo49f Click to register for this webinar]

</div>

= How to participate =
Click on the registration link above to register.

You will then receive an Email with the webinar link. The animation below shows you how you can join the webinar from your browser without a Zoom account.

[[Image:zoom.gif|600px|link=]]
[[Media:zoom.gif|View]]

= Previous Webinars =

== Getting started with Beds24==
<embedvideo service="youtube">https://youtu.be/utOguViWesA</embedvideo>

==Joint webinar with Expedia Group: Another secret to success with Expedia Group ==
<embedvideo service="youtube"> https://youtu.be/UTqWiUJzkdA</embedvideo>

==What's new 2022-04-20==
<embedvideo service="youtube"> https://youtu.be/yF3JBqK8NoQ</embedvideo>

==How to customize your booking page==
<embedvideo service="youtube">https://youtu.be/hy0trWoKYe8</embedvideo>

==Joint webinar with Google: Google Free Booking Links - A free way to reach and connect with potential customers==
<embedvideo service="youtube">https://youtu.be/2rly6iGx7j4</embedvideo>

[[Media:google_webinar.pdf|Google Webinar Guidebook]]

[https://support.google.com/business/gethelp?hl=en Contact Google Business Profile support]

==What's new 2021-09-29==
<embedvideo service="youtube">https://www.youtube.com/watch?v=tIUQUSv0tRs</embedvideo>

==Self-onboard to VRBO to reach high value customers ==
<embedvideo service="youtube">https://www.youtube.com/watch?v=cud_HF2qNh8</embedvideo>

==Joint webinar with Expedia Group: 3 Actionable Ways to Drive More Revenue ==
<embedvideo service="youtube">https://youtu.be/5ZqoYRiS0rc</embedvideo>

==Bookings from Google 2021-08-24==
<embedvideo service="youtube">https://youtu.be/QHRNDLaO-z0</embedvideo>

== Auto Actions 2021-08-10==
<embedvideo service="youtube">https://youtu.be/AOXeY-Ix66A</embedvideo>

== Stripe & Pending Payments 2021-07-06 ==
<embedvideo service="youtube">https://youtu.be/2gy9wKzpoRI</embedvideo>

== Reports 2021-06-29==
<embedvideo service="youtube">https://youtu.be/VU5V5RSVI9U</embedvideo>

==What's new 2021-04-07==
<embedvideo service="youtube">https://youtu.be/a_bOD--cKzk</embedvideo>

== Airbnb & Beds24: Road to Recovery 2021-03-04==
[[File:Airbnb Beds24 2021-03-04.mp4|640px]]

== Pricelabs & Beds24: Managing Prices and Restrictions while Markets recover 2020-10-06==
<embedvideo service="youtube">https://youtu.be/ES07TI6o_XE</embedvideo>

Airbnb Mapping

2022-08-30T11:19:11Z

IuriRosa: /* Troubleshooting and common errors */

[[Category:Channel Manager]]
[[Category:Airbnb]]
[[Category:Messaging]]
[[Category:Error Messages from Channels]]
[[Category:Troubleshooting]]

<div class="heading">Connect and update listings to Airbnb</div>

This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and explains how to connect your rooms in Beds24 to existing listings in Airbnb and how to create new listings in Airbnb

=Capabilities=
You can connect one or multiple Airbnb account to
*Import listings from Airbnb which will create properties and/or rooms in Beds24.
*Create new listings in Airbnb from rooms in Beds24.
*Connect to existing listings in Airbnb to send updates from Beds24.

After you have mapped your listings Beds24 will automatically.
*Synchronize prices, availability and restrictions (min-stay, max-stay, closed to arrival, closed to departure) to Airbnb.
*Import bookings and booking modifications or cancellations.

You can also choose to
*Update all content including descriptions and pictures from Beds24
*Import booking requests
*Communicate with Airbnb guest directly from Beds24.

[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.

= Limitations =
*You can only connect listings which are live on Airbnb.
*Listings in properties which Airbnb considers "traditional hospitality" like hotels, Bed & Breakfast rooms and small inns are approved by Airbnb on a case by case basis.
*If you do not have daily prices or rates in which "Airbnb" is activated in the "Channels" tab the "Base Price" (Rack Rate) will be used up to a year in advance.
*Smart Pricing is not available for API connected listings.
*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.
*Airbnb does not allow Co-hosts the use of their API connection. Airbnb recommend you switch to [https://www.airbnb.co.uk/help/article/970/hosting-teams-an-introduction hosting teams] instead.

=Before you connect=
==Prices==
*We can only send availability if you have set up prices which are activated for Airbnb under "Channels" in the Daily Prices or Rates.
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*Airbnb requires a "Base Price" (Rack Rate) which you can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT. Make sure you are prepared to accept a booking for the "Base Price. 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 {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set 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 Base Price.
*You can set a multiplier to mark your price up or down.

==Bookings and Requests==
When you use the API connection Airbnb only allows instant bookings. In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > 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.

In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can also add a "Custom Value" if you allow guests to send a request if they want to stay longer than your maximum stay rule allows.

After the connection has been successfully set up you can import upcoming existing bookings from Airbnb and all new bookings will automatically import.

Inquiries and requests are only imported if you opt in to importing them.

Airbnb collects the payment from your guest. Channel collect payments will be shown in the booking invoice if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under “Channel Collect Invoice” is set to import them. If you want to import the "Expected Payout amount" or the "Expected Payout and actual payment" from Airbnb you need to set this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under "Airbnb" "Invoice".

By changes or updates of an existing booking, Airbnb will not dynamically update the cost for extra guests if a reservation alteration is initiated by either the host or the guest.

The host can reject the reservation alteration and can update the guest count and the cost of the extra guests, then send the alteration to the main guest, who will need to accept the new reservation.

==Properties, rooms and room types ==
A listing in Airbnb is a room in Beds24.

Our connection supports room types with a quantity of more than one. If you want to send a quantity of more than one you can not use "House or Villa or Cottage" as property type.

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.

==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], [https://www.airbnb.com/help/article/1385/responsible-hosting-in-portugal Portugal] , [https://www.airbnb.com/help/article/1388/responsible-hosting-in-spain Spain], [https://www.airbnb.com/help/article/1383/responsible-hosting-in-france France], [https://www.airbnb.de/help/article/1391/responsible-hosting-in-germany Germany]

For other regions please check the Airbnb help pages.

=Set the connection up=
==Property settings==
If you have multiple rooms in a property these settings will apply to all rooms in the property.

'''Step 1: Connect your Airbnb account to your property'''

Each property can connect to one Airbnb Account. Select the Airbnb account you want to connect to.

If no Airbnb account is available go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS and connect your account.

'''Step 2 - Apply a multiplier to mark your prices up or down (optional)'''

If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number.

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.

'''Step 3: Check the currency setting is correct'''

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 multiplier (above) for conversion.

'''Step 4 - Import inquiries from Aribnb (optional)'''

If you import inquiries Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

'''Step 5 - Assign an invoicee (optional)'''

If you need to send invoices which are different from your standard invoice you can use the [[Invoicees|invoicee]] function.

==Connect listings you already have on Airbnb==
By mapping a room you connect it so it can update a listing in Airbnb.

'''Step 1 - Change the pricing model (optional)'''

Select "Occupancy Pricing" if you want to send prices for different numbers of guests and/or different length of stay. See the chapter "Pricing Models" below for more information.

Press SAVE.

'''Step 2 - Check which prices will send '''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 3: Select your sync type'''

With sync type '''Prices and Availability''' Beds24 will only update your prices (including taxes and fees) and availability and import bookings. If you want to change your descriptions or pictures you do this in Airbnb.

With sync type '''Everything''' also 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 to sync everything your listing needs to meet Airbnbs requirements. If you see a red button "Fix Content Errors" your listing does not meet Airbnb requirements. Click on the button. Any settings which do not meet Airbnb requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Always go to "View Content" to check what will send to Airbnb before selecting '''Everything'''.

'''Step 4: Connect'''

Click "Connect" and select the corresponding listing to this room to make the connection.

If you have changed the sync type to "Everything" you need to press SAVE before connecting.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

'''Step 6: Import upcoming bookings'''

Click on "Import existing bookings" to import the bookings you already have in Airbnb. Bookings previously imported via the Airbnb iCal connection will not import. We recommend you delete them before you press the button.

[[File:Airbnb_Synctyp_Prices_Availability.mp4|640px]]

[[File:Airbnb_Synctyp_Everything.mp4|640px]]

=Create a new listing=

'''Step 1 - Select "Sync Type" Everything'''

Airbnb will only publish your listing if you send the full content.

Set "Sync Type" = Everything then press SAVE.

'''Step 2 - Check if your content meets Airbnbs requirements'''

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT to revise which data will send to Airbnb. 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.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button to get to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT.

'''Step 3 - Check which prices will send'''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 4: Export to Airbnb'''

When your content meets Airbnbs requirements you can click "Export'''.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

[[File:Create_a_new_listing_on_Airbnb.mp4|640px]]

=Airbnbs review and publishing process =
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 "Check Connection 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 "Check Connection Status".

=Updates=
*Changes to availability and prices will be instantly sent to the channel.
*Changes for settings for example minimum stays, the multiplier or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
*Content updates are only sent on demand. If you change content you you will need to click "Update" to send the changes.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> It can take Airbnb a couple of minutes to process the data we sent.

=Change the Sync Type=

If you want to change the sync type you need to:

'''Step 1 - Disconnect '''

Click on "Disconnect"

'''Step 2 - Change sync type'''

Change to the other sync type and SAVE.

'''Step 3 - Reconnect'''

Click on "Connect" and select the corresponding listing to this room to make the connection.

=Disconnect or terminate the connection=
Click on "Disconnect". This will set all your listings in this Airbnb account to "manual" so you can manage it manually. If you want to update the listing from Beds24 you will need to reconnect it.

If you want to disconnect all listings in an Airbnb account you can do this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS.

You can also disconnect your Airbnb account from Beds24 in Airbnb. Log into your Airbnb account and go to ACCOUNT > PRIVACY AND SHARING and remove the Beds24 app.

=Options for both sync types=
==Pricing models==
Airbnb supports different pricing models.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Click on the "Price Data" Button to check which prices and availability will send.

===Per Day Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Day Pricing''' (the default) if you have only ONE price 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. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.

If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send.

Only a global max. stay which is taken from {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP can send.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*The number of guests for which the daily price applies.
*An extra person price.

For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > and set Guests included = 2, Extra Person Price = 15

===Per Occupancy (LOS) Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing''' if you want to send prices for different occupancies and/or different length of stay..

If you use rates the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.

If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Beds24 sends the price for max. 16 guests. If your property accommodates more than 16 guests use "Per Day" pricing with an extra person price.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to limitations with Airbnbs multi calendar Airbnb can not show the correct prices in your Airbnb Extranet. The correct prices will be shown to the guest though and the prices sent from Beds24 will be applied for all bookings. If you want to check prices on Airbnb please start a booking for your listing.

===Rate Plans===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> '''Rate plans''' are the pricing model of choice if you want
*to offer a refundable and a non-refundable option and
**set prices for refundable and non-refundable instead of Airbnbs fixed discount option
**control the cancellation policy for refundable and non-refundable prices
**control availability of the refundable/non-refundable booking option.
*parity with other channels which support rate plans i.e. Booking.com or Expedia.

You can create up to 10 rate plans which can be used for all listings in the Airbnb account. A maximum of 2 rate plans will be displayed to guests at a given time depending on the cancellation policy. Airbnb will display one refundable and another non-refundable rate plan and out of these (a) the lowest and (b) the most flexible rate.

A price for each occupancy defined in Beds24 can be sent.
*If you use daily prices they daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
*If you use rates 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rate can not be sent.

If you want to send prices for different length of stay you need a rate plan for each.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

For more information and setup instructions click [[Airbnb_Rate_Plans |here]].

==Discounts==
If you have "Early Bird" or "Last Minute" prices which are activated for Airbnb these will automatically send. Airbnb will not mark these as promotions though.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*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.
*A discount for "Non Refundable" bookings. If you select a sync type "Prices and Availability" you can set a non-refundable discount in your Airbnb extranet.
*Early Bird and Last Minute Discounts which Airbnb will mark as promotions.

You can also create"Pricing Rules" directly in Airbnb but we recommend you set all prices in Beds24 to avoid confusion.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Early bird or Last Minute offer are only marked as promotions if the price drops at least 10% from what Airbnb define as the last 30 days median price. If you use both early bird and last minute and want to remove one you will need to remove both because Airbnb will only remove them together. After you have clicked "Update" to send the change you can reactivate the one you want to keep.

Please refer to Airbnb for more information on [https://www.airbnb.com/help/article/2983/what-happens-if-i-offer-multiple-discounts how Airbnb calculates discounts].

==Fees and taxes==
If you apply fees or taxes you need to send them from Beds24.
*Cleaning fee

You can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT.

Other fees supported by Airbnb can be sent as CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT. If you apply a linen fee Airbnb will add this to the cleaning fee.

*PETFEE 45 (for example)

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have a price multiplier in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB, > MAPPING this will also be applied to the Cleaning fee and Security deposit. If you want to over ride this, then use a CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT.

*If you want to send taxes click on "Check if you are eligible to send taxes" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. If Airbnb allows you to send taxes you can set them under "Custom". Please click on the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span>for "Custom" for detailed instructions

==Permit / Registration/ License==
In some locations Airbnb.com require the License/Registration number of the owner. Please also see under "Local legal requirements above"

If this is required for your property, please go to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID" and enter your details.

Permit IDs in Beds24 are set per property. If you have a different permit Id than the one set for the property you can set a room specific permit as "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

==Send and receive messages ==
You can get communicate with Airbnb guest directly from Beds24. This function works for:
*Confirmed bookings
*Inquiries/Requests - if you receive a message from a potential guest inquiring Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

You can view all messages from the "Messages" component on the DASHBOARD and individual communication from the "API Messages" tab in the booking. You and your guests will see the messages in Airbnb.

To use this function you should:

1. Add the component "API Messages" to your [[:Category:Dashboard|DASHBOARD]]

2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options. We will remove the HTML from the message because Airbnb does not support HTML. You have the option to add a plain text message for this purpose.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have moved the booking to a different room (manually or via dependencies), then ensure that both properties/rooms are connected with the same Airbnb account, otherwise this function will not work.

=Content for sync type "Everything"=
==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.

==Languages==
The content is sent in the language which is activated as default language for the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALIZATION.

If you have activated multiple languages and entered your descriptions in these we can multiple languages if you set "Allow Multi-Language" = Yes in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Please check the context help before changing the setting.

Following languages are supported by Airbnb and Beds24: Bahasa Indonesia, Catala, Dansk, Deutsch, English. Español, Eλληνικά, Français, Hrvatski, Italiano, Magyar, Nederlands, Norsk, Polski, Português, Suomi, Svenska, Íslenska, Čeština, Русский, עברית, ภาษาไทย, 中文, 日本語 ja
한국어.

==Property Type ==
Most of the property types which Airbnb supports can be selected in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

Other Airbnb property types can be added as "Custom" values in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

== Bedrooms and bathrooms==
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Set up bedrooms and bathroom either in the property OR the room. If you set them up in both you will double them up. Do not send additional bathroom amenities if you have a full bathrooom.

Bedrooms and bathrooms 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 "Bedroom" or "Bathroom".
*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.

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

*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.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>: Airbnb does not support all available features available in Beds24.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you add a crib in a bedroom Airbnb will display the crib as a bed. If you do not want to do this add BED_CRIB in a new line.

BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BEDROOM

BED_AIRMATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOORMATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

If you have a murphy bed it will send as single bed.

== Amenities ==
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room ({{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 "linens", towels and "toiletries".

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have "Accessability" amenities Airbnb requires you to provide a picture for each amenity which they review. You can add these amenities and the pictures in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT under "Custom".

You will find a list all all "Accessability" amenities below under "All Feature Codes".

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you do not select select child friendly amenities Airbnb might classify your listing as "Not safe or suitable for children (0-12 years)"

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb does not support all available feature codes. Make sure you pick five features which are supported by Airbnb.

==Pictures==
You can define in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT which pictures will be used.

Double check you have entered "Captions" for every picture.

Requirements and limitations from Airbnb:
*Airbnb requires a '''minimum of 1 picture per listing with high-resolution (800x500 pixels).
*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.

<div class="warning">{{#fas:exclamation-triangle}} Airbnb requires Captions. If you change pictures make sure you change/add the caption in (SETTINGS) BOOKING ENGINE > PICTURES so Airbnb recognizes the new picture.</div>

== Check-in ==
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT you can set 'Check-in start', 'Check-in end' and 'Check-out end'.

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 end' to the same time or earlier than 'Check-in start'. This will work with all times except for 01:00 and 02:00 in the morning.

==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".

==Airbnb specific content ==
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT or click on the "Edit specific content for Airbnb" link to check and customize. specific content for Airbnb.

= 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

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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:

==Amenities==
AIR_CONDITIONING

BEACH_ESSENTIALS

BALCONY

CLEANING_PRODUCTS

CLOSET

CLOTHES_DRYINGRACK

CO_DETECTOR

CONDITIONER

DRYER

ELEVATOR

EXTRA_PILLOWS_BLANKETS

EV_CHARGER

FAN_PORTABLE

FIRE_EXTINGUISHER

FIRE_PIT

FIREPLACE

FIRST_AID_KIT

GAMES

GARDEN

GRILL

GRILL_EQUIPMENT

HAIR_DRYER

HAMMOCK

HANGERS

HEATING

IRON_BOARD

LINENS (if all of TOILETRIES, TOWELS and LINENS are used, this sends as "Essentials")

LIVING_ROOM

MOSQUITO_NET

OUTDOOR_FURNITURE (for outdoor seating)

PARKING

PARKING_PAID

PARKING_POSSIBLE

PIANO

POOL_TABLE

PRIVATE_ENTRANCE

ROOM_DARKENING_SHADES

TOILETRIES (body soap)

SAFETY_CARD

SHAMPOO

SHOWER_GEL

SMOKE_DETECTOR

SOAP

STEREO

TOWELS

TRASH_COMPACTER

WASHER

WATER_HOT

==Business==

==Entertainment==
TV

CABLE

VIDEO_GAMES

==Food and Drink==
BREAKFAST_INCLUDED

==Internet==
ETHERNET

INTERNET

WIFI

WIFI_POCKET

==Kitchen==
KITCHEN

KITCHEN_OUTDOOR

BAKING_SHEET

BLENDER

COFFEE

COFFEE_MAKER

COOKING_BASICS (is sent if both "DISHES_UTENSILS" and "SPICES" is selected)

DISHES_UTENSILS (is sent in combination with "SPICES" as "Cooking Basics")

DISHWASHER

FREEZER

GLASSES_WINE

KETTLE

OVEN

STOVE

REFRIGERATOR

REFRIGERATOR_MINI

RICE_MAKER

SPICES (is sent in combination with "DISHES_UTENSILS" as "Cooking Basics")

TOASTER

==Location==
BEACH_FRONT

LAKE (lake access in Airbnb)

SKI_IN

SKI_OUT

WATER_VIEW

==Pets==
PETS_CONSIDERED

==Pool & Wellness==
GYM

POOL

POOL_HEATED

POOL_INDOOR

POOL_PRIVATE

==Services==
DOORBELL

DOORMAN

RECEPTION_24HOUR

LUGGAGE_DROPOFF

CLEANING_BEFORE_CHECKOUT

BICYCLE_RENTAL

==Sports==
BOAT_SLIP

FITNESS_CENTER (for exercise equipment)

KAYAK_CANOE

TABLE_TENNIS

==Suitability==
ADULTS_ONLY

CHILDREN_NOT_ALLOWED

EVENTS_ALLOWED

INFANTS_NOT_ALLOWED

LAPTOP_FRIENDLY

LONG_TERM_RENTERS

SMOKING_ALLOWED

==Accessibility==
PARKING_DISABLED

STEP_FREE_ACCESS_BATHROOM

GRAB_RAILS_IN_SHOWER

GRAB_RAILS_IN_TOILET

ROLLIN_SHOWER

SHOWER_CHAIR

WIDE_DOORWAY_BATHROOM

TUB_WITH_SHOWER_BENCH

WIDE_CLEARANCE_TO_SHOWER_AND_TOILET

STEP_FEE_ACCESS_BEDROOM

WIDE_DOORWAY_BEDROOM

SINGLE_LEVEL_HOME

COMMON_SPACE_STEP_FREE_ACCESS

COMMON_SPACE_WIDE_DOORWAY

HOME_STEP_FREE_ACCESS

PATH_TO_ENTRANCE_LIT_AT_NIGHT

HOME_WIDE_DOORWAY

FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR

==Family==
CHANGING_TABLE

BABY_BATH

PACK_N_PLAY_TRAVEL_CRIB

FIREPLACE_GUARD

BABY_MONITOR

OUTLET_COVERS

TABLE_CORNER_GUARDS

WINDOW_GUARDS

CHILDRENS_DINNERWARE

BABYSITTER_RECOMMENDATIONS

==Bedroom==
BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

BED_AIR MATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOOR_MATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

==Bathroom==
BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BATH_BIDET

BATH_SHOWER_RAIN

= Troubleshooting and common errors =
'''Not Processed '''
Airbnb had a temporary problem processing the updates we send. This normally comes good by itself when Airbnb fixed the problem. Wait a bit then press "Update" wait for Airbnb to process the update you just sent and then click "Update status". If the problem persists after a couple of hours notify us via a support ticket.

'''You do not have permission to access this resource'''
Click "Disconnect" and then reconnect the room and to your listing in Airbnb.

'''Not Connected '''
You have disconnected the listing in Airbnb. Click "Disconnect" and then reconnect it.

'''Listing shows as "Importing" in the Airbnb Extranet '''
Beds24 sent the data but it is stuck at Airbnb. Try the following:
1. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING
2. Click on "Disconnect"
4. Refresh the page then connect again
5. Wait a bit and then check the "Connection status"
If you then still see "Importing"in Airbnb contact Airbnb support and ask them to check why your listings are stuck. You might need to insist that they forward your request to someone who is qualified to do so.

'''Sorry, we cannot activate your listing.'''
It seems you have an issue with your “Booking settings” in your Airbnb account. Please log into your Airbnb account and check what is set under the tab Booking Settings. You can find more information here: https://www.airbnb.com/help/article/1353/how-do-i-choose-who-can-instant-book-my-place

'''Lat/Long outside of hosting country OR Lat/lng outside of hosting country OR Please set latitude/longitude in valid country for your listing'''
Check the country under which you have registered your Airbnb account is the same as the country your property is in. Check your settings for "Latitude" and "Longitude" are correct and match the address you have given.

'''Sorry, please contact support if you need to change the market of your listing.'''
Check if your settings for "Latitude" and "Longitude" are correct and do match the address you have given. Airbnb uses Google maps to validate addresses. You can check with address and latitude/longitude is in Airbnbs system when you click on "View all listings" and then on "content in Airbnb". If required, correct your data and then click "Update Airbnb". Check your Google map entry and if it is incorrect request Google maps to correct your location. If the error message persists go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No or contact Airbnb support. Give them the error message, your coordinates and your address and ask them to forward your request to someone in their team who is authorized to fix the problem at their end.

'''ServiceInvalidRequestException: You can't change your listing's address once you've started receiving reservation requests. If you need to make an update, please contact support.'''
Please check your address details in Beds24 match the details at Airbnb, if you need to change them, please contact Airbnb support and ask them to assist.
If you do not need to change your address details then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No.

'''Your listing has been temporarily paused and can't be turned on until you reactivate it. '''
If you do not know what the problem is please check the Email Airbnb sent you, the messages in your Airbnb account or contact Airbnb support and ask them to help.

'''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 API 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.

'''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€.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb calculates prices based on USD so what they calculate changes with the currency exchange rate.

'''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 which meets Airbnb's requirements.

'''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 ({{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID").

'''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.

'''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.

'''document_uri has already been taken.'''
You see this error if you have previously connected the room to another Airbnb account. Log into this Airbnb account and stop the sync for this listing. If you can not do this send us a support ticket asking us to delete the URI from the endpoint.

'''Expired Token'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''The document has no document element'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''Your listings are almost ready'''
If after some time you still see "Your listings are almost ready" after clicking Beds24 Channel Manager Sync" in Airbnb and see "In progress" on the "Listings" page check that "Publish = Yes is set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

'''Listing failed to import'''
Click on "Disconnect" then click on "Delete from Airbnb". Fix content errors. Then go back an publish the listing again.

'''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.

'''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.

'''Please select a consistent property type and property group.'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Please specify the property and listing type'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Messages do not send or import to Beds24'''
Log into your Airbnb account and go to ACCOUNT -> PRIVACY AND SHARING. If you do not see 'Access and respond your messages' in the list of permissions, disconnect and then reconnect the Airbnb account.

'''Airbnb account is not connected, please connect account'''
Log into your Airbnb account

'''Not enough beds for person capacity'''
Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > FEATURES and click on 'edit Bedroom' tab, select the appropriate room/bedroom configuration for your listing.

'''Not enough beds in room configurations'''
You do not have the appropriate bed configuration for the number of people you have selected in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > Max Guests. Scroll to FEATURES and click 'edit Bedroom' and select the appropriate number of bedrooms/beds for your guests.

'''Sorry, we can't add that amenity right now. Please try again later.'''
This was a transient error caused by an update to the Airbnb amenities data format. The error message should not repeat but if you continue to receive error emails, then please create a SUPPORT ticket.

'''Please make sure a photo has been uploaded before adding accessibility amenity. If the previous review rejects your photos, you need to upload a new photo'''
You are trying to send an accessibility amenity but do not provide a picture for this amenity. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT where you can add the accessibility amenity with a picture in "Custom". Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for further instructions.

'''All caps isn't allowed in listing titles.'''
Airbnb do not allow the Listing Name to be ALL Caps. Check the details in each of the sections below.
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > NAME
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > NAME
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > DESCRIPTIONS

'''Calendar will not Load, it will only show a loafing spinner wheel.'''
Please check that you have prices set and this are sending to AirBnb, have a look under
{{#fas:cog}} (SETTINGS) > Channel Manager > AirBnB > Mapping, and click on "Price Data" to check if prices are being sent to AirBnb.

Airbnb Mapping

2022-08-30T11:18:53Z

IuriRosa: /* Troubleshooting and common errors */

[[Category:Channel Manager]]
[[Category:Airbnb]]
[[Category:Messaging]]
[[Category:Error Messages from Channels]]
[[Category:Troubleshooting]]

<div class="heading">Connect and update listings to Airbnb</div>

This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and explains how to connect your rooms in Beds24 to existing listings in Airbnb and how to create new listings in Airbnb

=Capabilities=
You can connect one or multiple Airbnb account to
*Import listings from Airbnb which will create properties and/or rooms in Beds24.
*Create new listings in Airbnb from rooms in Beds24.
*Connect to existing listings in Airbnb to send updates from Beds24.

After you have mapped your listings Beds24 will automatically.
*Synchronize prices, availability and restrictions (min-stay, max-stay, closed to arrival, closed to departure) to Airbnb.
*Import bookings and booking modifications or cancellations.

You can also choose to
*Update all content including descriptions and pictures from Beds24
*Import booking requests
*Communicate with Airbnb guest directly from Beds24.

[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.

= Limitations =
*You can only connect listings which are live on Airbnb.
*Listings in properties which Airbnb considers "traditional hospitality" like hotels, Bed & Breakfast rooms and small inns are approved by Airbnb on a case by case basis.
*If you do not have daily prices or rates in which "Airbnb" is activated in the "Channels" tab the "Base Price" (Rack Rate) will be used up to a year in advance.
*Smart Pricing is not available for API connected listings.
*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.
*Airbnb does not allow Co-hosts the use of their API connection. Airbnb recommend you switch to [https://www.airbnb.co.uk/help/article/970/hosting-teams-an-introduction hosting teams] instead.

=Before you connect=
==Prices==
*We can only send availability if you have set up prices which are activated for Airbnb under "Channels" in the Daily Prices or Rates.
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*Airbnb requires a "Base Price" (Rack Rate) which you can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT. Make sure you are prepared to accept a booking for the "Base Price. 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 {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set 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 Base Price.
*You can set a multiplier to mark your price up or down.

==Bookings and Requests==
When you use the API connection Airbnb only allows instant bookings. In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > 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.

In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can also add a "Custom Value" if you allow guests to send a request if they want to stay longer than your maximum stay rule allows.

After the connection has been successfully set up you can import upcoming existing bookings from Airbnb and all new bookings will automatically import.

Inquiries and requests are only imported if you opt in to importing them.

Airbnb collects the payment from your guest. Channel collect payments will be shown in the booking invoice if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under “Channel Collect Invoice” is set to import them. If you want to import the "Expected Payout amount" or the "Expected Payout and actual payment" from Airbnb you need to set this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under "Airbnb" "Invoice".

By changes or updates of an existing booking, Airbnb will not dynamically update the cost for extra guests if a reservation alteration is initiated by either the host or the guest.

The host can reject the reservation alteration and can update the guest count and the cost of the extra guests, then send the alteration to the main guest, who will need to accept the new reservation.

==Properties, rooms and room types ==
A listing in Airbnb is a room in Beds24.

Our connection supports room types with a quantity of more than one. If you want to send a quantity of more than one you can not use "House or Villa or Cottage" as property type.

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.

==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], [https://www.airbnb.com/help/article/1385/responsible-hosting-in-portugal Portugal] , [https://www.airbnb.com/help/article/1388/responsible-hosting-in-spain Spain], [https://www.airbnb.com/help/article/1383/responsible-hosting-in-france France], [https://www.airbnb.de/help/article/1391/responsible-hosting-in-germany Germany]

For other regions please check the Airbnb help pages.

=Set the connection up=
==Property settings==
If you have multiple rooms in a property these settings will apply to all rooms in the property.

'''Step 1: Connect your Airbnb account to your property'''

Each property can connect to one Airbnb Account. Select the Airbnb account you want to connect to.

If no Airbnb account is available go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS and connect your account.

'''Step 2 - Apply a multiplier to mark your prices up or down (optional)'''

If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number.

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.

'''Step 3: Check the currency setting is correct'''

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 multiplier (above) for conversion.

'''Step 4 - Import inquiries from Aribnb (optional)'''

If you import inquiries Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

'''Step 5 - Assign an invoicee (optional)'''

If you need to send invoices which are different from your standard invoice you can use the [[Invoicees|invoicee]] function.

==Connect listings you already have on Airbnb==
By mapping a room you connect it so it can update a listing in Airbnb.

'''Step 1 - Change the pricing model (optional)'''

Select "Occupancy Pricing" if you want to send prices for different numbers of guests and/or different length of stay. See the chapter "Pricing Models" below for more information.

Press SAVE.

'''Step 2 - Check which prices will send '''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 3: Select your sync type'''

With sync type '''Prices and Availability''' Beds24 will only update your prices (including taxes and fees) and availability and import bookings. If you want to change your descriptions or pictures you do this in Airbnb.

With sync type '''Everything''' also 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 to sync everything your listing needs to meet Airbnbs requirements. If you see a red button "Fix Content Errors" your listing does not meet Airbnb requirements. Click on the button. Any settings which do not meet Airbnb requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Always go to "View Content" to check what will send to Airbnb before selecting '''Everything'''.

'''Step 4: Connect'''

Click "Connect" and select the corresponding listing to this room to make the connection.

If you have changed the sync type to "Everything" you need to press SAVE before connecting.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

'''Step 6: Import upcoming bookings'''

Click on "Import existing bookings" to import the bookings you already have in Airbnb. Bookings previously imported via the Airbnb iCal connection will not import. We recommend you delete them before you press the button.

[[File:Airbnb_Synctyp_Prices_Availability.mp4|640px]]

[[File:Airbnb_Synctyp_Everything.mp4|640px]]

=Create a new listing=

'''Step 1 - Select "Sync Type" Everything'''

Airbnb will only publish your listing if you send the full content.

Set "Sync Type" = Everything then press SAVE.

'''Step 2 - Check if your content meets Airbnbs requirements'''

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT to revise which data will send to Airbnb. 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.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button to get to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT.

'''Step 3 - Check which prices will send'''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 4: Export to Airbnb'''

When your content meets Airbnbs requirements you can click "Export'''.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

[[File:Create_a_new_listing_on_Airbnb.mp4|640px]]

=Airbnbs review and publishing process =
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 "Check Connection 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 "Check Connection Status".

=Updates=
*Changes to availability and prices will be instantly sent to the channel.
*Changes for settings for example minimum stays, the multiplier or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
*Content updates are only sent on demand. If you change content you you will need to click "Update" to send the changes.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> It can take Airbnb a couple of minutes to process the data we sent.

=Change the Sync Type=

If you want to change the sync type you need to:

'''Step 1 - Disconnect '''

Click on "Disconnect"

'''Step 2 - Change sync type'''

Change to the other sync type and SAVE.

'''Step 3 - Reconnect'''

Click on "Connect" and select the corresponding listing to this room to make the connection.

=Disconnect or terminate the connection=
Click on "Disconnect". This will set all your listings in this Airbnb account to "manual" so you can manage it manually. If you want to update the listing from Beds24 you will need to reconnect it.

If you want to disconnect all listings in an Airbnb account you can do this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS.

You can also disconnect your Airbnb account from Beds24 in Airbnb. Log into your Airbnb account and go to ACCOUNT > PRIVACY AND SHARING and remove the Beds24 app.

=Options for both sync types=
==Pricing models==
Airbnb supports different pricing models.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Click on the "Price Data" Button to check which prices and availability will send.

===Per Day Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Day Pricing''' (the default) if you have only ONE price 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. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.

If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send.

Only a global max. stay which is taken from {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP can send.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*The number of guests for which the daily price applies.
*An extra person price.

For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > and set Guests included = 2, Extra Person Price = 15

===Per Occupancy (LOS) Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing''' if you want to send prices for different occupancies and/or different length of stay..

If you use rates the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.

If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Beds24 sends the price for max. 16 guests. If your property accommodates more than 16 guests use "Per Day" pricing with an extra person price.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to limitations with Airbnbs multi calendar Airbnb can not show the correct prices in your Airbnb Extranet. The correct prices will be shown to the guest though and the prices sent from Beds24 will be applied for all bookings. If you want to check prices on Airbnb please start a booking for your listing.

===Rate Plans===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> '''Rate plans''' are the pricing model of choice if you want
*to offer a refundable and a non-refundable option and
**set prices for refundable and non-refundable instead of Airbnbs fixed discount option
**control the cancellation policy for refundable and non-refundable prices
**control availability of the refundable/non-refundable booking option.
*parity with other channels which support rate plans i.e. Booking.com or Expedia.

You can create up to 10 rate plans which can be used for all listings in the Airbnb account. A maximum of 2 rate plans will be displayed to guests at a given time depending on the cancellation policy. Airbnb will display one refundable and another non-refundable rate plan and out of these (a) the lowest and (b) the most flexible rate.

A price for each occupancy defined in Beds24 can be sent.
*If you use daily prices they daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
*If you use rates 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rate can not be sent.

If you want to send prices for different length of stay you need a rate plan for each.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

For more information and setup instructions click [[Airbnb_Rate_Plans |here]].

==Discounts==
If you have "Early Bird" or "Last Minute" prices which are activated for Airbnb these will automatically send. Airbnb will not mark these as promotions though.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*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.
*A discount for "Non Refundable" bookings. If you select a sync type "Prices and Availability" you can set a non-refundable discount in your Airbnb extranet.
*Early Bird and Last Minute Discounts which Airbnb will mark as promotions.

You can also create"Pricing Rules" directly in Airbnb but we recommend you set all prices in Beds24 to avoid confusion.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Early bird or Last Minute offer are only marked as promotions if the price drops at least 10% from what Airbnb define as the last 30 days median price. If you use both early bird and last minute and want to remove one you will need to remove both because Airbnb will only remove them together. After you have clicked "Update" to send the change you can reactivate the one you want to keep.

Please refer to Airbnb for more information on [https://www.airbnb.com/help/article/2983/what-happens-if-i-offer-multiple-discounts how Airbnb calculates discounts].

==Fees and taxes==
If you apply fees or taxes you need to send them from Beds24.
*Cleaning fee

You can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT.

Other fees supported by Airbnb can be sent as CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT. If you apply a linen fee Airbnb will add this to the cleaning fee.

*PETFEE 45 (for example)

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have a price multiplier in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB, > MAPPING this will also be applied to the Cleaning fee and Security deposit. If you want to over ride this, then use a CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT.

*If you want to send taxes click on "Check if you are eligible to send taxes" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. If Airbnb allows you to send taxes you can set them under "Custom". Please click on the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span>for "Custom" for detailed instructions

==Permit / Registration/ License==
In some locations Airbnb.com require the License/Registration number of the owner. Please also see under "Local legal requirements above"

If this is required for your property, please go to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID" and enter your details.

Permit IDs in Beds24 are set per property. If you have a different permit Id than the one set for the property you can set a room specific permit as "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

==Send and receive messages ==
You can get communicate with Airbnb guest directly from Beds24. This function works for:
*Confirmed bookings
*Inquiries/Requests - if you receive a message from a potential guest inquiring Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

You can view all messages from the "Messages" component on the DASHBOARD and individual communication from the "API Messages" tab in the booking. You and your guests will see the messages in Airbnb.

To use this function you should:

1. Add the component "API Messages" to your [[:Category:Dashboard|DASHBOARD]]

2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options. We will remove the HTML from the message because Airbnb does not support HTML. You have the option to add a plain text message for this purpose.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have moved the booking to a different room (manually or via dependencies), then ensure that both properties/rooms are connected with the same Airbnb account, otherwise this function will not work.

=Content for sync type "Everything"=
==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.

==Languages==
The content is sent in the language which is activated as default language for the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALIZATION.

If you have activated multiple languages and entered your descriptions in these we can multiple languages if you set "Allow Multi-Language" = Yes in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Please check the context help before changing the setting.

Following languages are supported by Airbnb and Beds24: Bahasa Indonesia, Catala, Dansk, Deutsch, English. Español, Eλληνικά, Français, Hrvatski, Italiano, Magyar, Nederlands, Norsk, Polski, Português, Suomi, Svenska, Íslenska, Čeština, Русский, עברית, ภาษาไทย, 中文, 日本語 ja
한국어.

==Property Type ==
Most of the property types which Airbnb supports can be selected in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

Other Airbnb property types can be added as "Custom" values in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

== Bedrooms and bathrooms==
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Set up bedrooms and bathroom either in the property OR the room. If you set them up in both you will double them up. Do not send additional bathroom amenities if you have a full bathrooom.

Bedrooms and bathrooms 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 "Bedroom" or "Bathroom".
*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.

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

*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.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>: Airbnb does not support all available features available in Beds24.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you add a crib in a bedroom Airbnb will display the crib as a bed. If you do not want to do this add BED_CRIB in a new line.

BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BEDROOM

BED_AIRMATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOORMATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

If you have a murphy bed it will send as single bed.

== Amenities ==
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room ({{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 "linens", towels and "toiletries".

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have "Accessability" amenities Airbnb requires you to provide a picture for each amenity which they review. You can add these amenities and the pictures in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT under "Custom".

You will find a list all all "Accessability" amenities below under "All Feature Codes".

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you do not select select child friendly amenities Airbnb might classify your listing as "Not safe or suitable for children (0-12 years)"

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb does not support all available feature codes. Make sure you pick five features which are supported by Airbnb.

==Pictures==
You can define in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT which pictures will be used.

Double check you have entered "Captions" for every picture.

Requirements and limitations from Airbnb:
*Airbnb requires a '''minimum of 1 picture per listing with high-resolution (800x500 pixels).
*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.

<div class="warning">{{#fas:exclamation-triangle}} Airbnb requires Captions. If you change pictures make sure you change/add the caption in (SETTINGS) BOOKING ENGINE > PICTURES so Airbnb recognizes the new picture.</div>

== Check-in ==
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT you can set 'Check-in start', 'Check-in end' and 'Check-out end'.

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 end' to the same time or earlier than 'Check-in start'. This will work with all times except for 01:00 and 02:00 in the morning.

==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".

==Airbnb specific content ==
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT or click on the "Edit specific content for Airbnb" link to check and customize. specific content for Airbnb.

= 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

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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:

==Amenities==
AIR_CONDITIONING

BEACH_ESSENTIALS

BALCONY

CLEANING_PRODUCTS

CLOSET

CLOTHES_DRYINGRACK

CO_DETECTOR

CONDITIONER

DRYER

ELEVATOR

EXTRA_PILLOWS_BLANKETS

EV_CHARGER

FAN_PORTABLE

FIRE_EXTINGUISHER

FIRE_PIT

FIREPLACE

FIRST_AID_KIT

GAMES

GARDEN

GRILL

GRILL_EQUIPMENT

HAIR_DRYER

HAMMOCK

HANGERS

HEATING

IRON_BOARD

LINENS (if all of TOILETRIES, TOWELS and LINENS are used, this sends as "Essentials")

LIVING_ROOM

MOSQUITO_NET

OUTDOOR_FURNITURE (for outdoor seating)

PARKING

PARKING_PAID

PARKING_POSSIBLE

PIANO

POOL_TABLE

PRIVATE_ENTRANCE

ROOM_DARKENING_SHADES

TOILETRIES (body soap)

SAFETY_CARD

SHAMPOO

SHOWER_GEL

SMOKE_DETECTOR

SOAP

STEREO

TOWELS

TRASH_COMPACTER

WASHER

WATER_HOT

==Business==

==Entertainment==
TV

CABLE

VIDEO_GAMES

==Food and Drink==
BREAKFAST_INCLUDED

==Internet==
ETHERNET

INTERNET

WIFI

WIFI_POCKET

==Kitchen==
KITCHEN

KITCHEN_OUTDOOR

BAKING_SHEET

BLENDER

COFFEE

COFFEE_MAKER

COOKING_BASICS (is sent if both "DISHES_UTENSILS" and "SPICES" is selected)

DISHES_UTENSILS (is sent in combination with "SPICES" as "Cooking Basics")

DISHWASHER

FREEZER

GLASSES_WINE

KETTLE

OVEN

STOVE

REFRIGERATOR

REFRIGERATOR_MINI

RICE_MAKER

SPICES (is sent in combination with "DISHES_UTENSILS" as "Cooking Basics")

TOASTER

==Location==
BEACH_FRONT

LAKE (lake access in Airbnb)

SKI_IN

SKI_OUT

WATER_VIEW

==Pets==
PETS_CONSIDERED

==Pool & Wellness==
GYM

POOL

POOL_HEATED

POOL_INDOOR

POOL_PRIVATE

==Services==
DOORBELL

DOORMAN

RECEPTION_24HOUR

LUGGAGE_DROPOFF

CLEANING_BEFORE_CHECKOUT

BICYCLE_RENTAL

==Sports==
BOAT_SLIP

FITNESS_CENTER (for exercise equipment)

KAYAK_CANOE

TABLE_TENNIS

==Suitability==
ADULTS_ONLY

CHILDREN_NOT_ALLOWED

EVENTS_ALLOWED

INFANTS_NOT_ALLOWED

LAPTOP_FRIENDLY

LONG_TERM_RENTERS

SMOKING_ALLOWED

==Accessibility==
PARKING_DISABLED

STEP_FREE_ACCESS_BATHROOM

GRAB_RAILS_IN_SHOWER

GRAB_RAILS_IN_TOILET

ROLLIN_SHOWER

SHOWER_CHAIR

WIDE_DOORWAY_BATHROOM

TUB_WITH_SHOWER_BENCH

WIDE_CLEARANCE_TO_SHOWER_AND_TOILET

STEP_FEE_ACCESS_BEDROOM

WIDE_DOORWAY_BEDROOM

SINGLE_LEVEL_HOME

COMMON_SPACE_STEP_FREE_ACCESS

COMMON_SPACE_WIDE_DOORWAY

HOME_STEP_FREE_ACCESS

PATH_TO_ENTRANCE_LIT_AT_NIGHT

HOME_WIDE_DOORWAY

FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR

==Family==
CHANGING_TABLE

BABY_BATH

PACK_N_PLAY_TRAVEL_CRIB

FIREPLACE_GUARD

BABY_MONITOR

OUTLET_COVERS

TABLE_CORNER_GUARDS

WINDOW_GUARDS

CHILDRENS_DINNERWARE

BABYSITTER_RECOMMENDATIONS

==Bedroom==
BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

BED_AIR MATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOOR_MATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

==Bathroom==
BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BATH_BIDET

BATH_SHOWER_RAIN

= Troubleshooting and common errors =
'''Not Processed '''
Airbnb had a temporary problem processing the updates we send. This normally comes good by itself when Airbnb fixed the problem. Wait a bit then press "Update" wait for Airbnb to process the update you just sent and then click "Update status". If the problem persists after a couple of hours notify us via a support ticket.

'''You do not have permission to access this resource'''
Click "Disconnect" and then reconnect the room and to your listing in Airbnb.

'''Not Connected '''
You have disconnected the listing in Airbnb. Click "Disconnect" and then reconnect it.

'''Listing shows as "Importing" in the Airbnb Extranet '''
Beds24 sent the data but it is stuck at Airbnb. Try the following:
1. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING
2. Click on "Disconnect"
4. Refresh the page then connect again
5. Wait a bit and then check the "Connection status"
If you then still see "Importing"in Airbnb contact Airbnb support and ask them to check why your listings are stuck. You might need to insist that they forward your request to someone who is qualified to do so.

'''Sorry, we cannot activate your listing.'''
It seems you have an issue with your “Booking settings” in your Airbnb account. Please log into your Airbnb account and check what is set under the tab Booking Settings. You can find more information here: https://www.airbnb.com/help/article/1353/how-do-i-choose-who-can-instant-book-my-place

'''Lat/Long outside of hosting country OR Lat/lng outside of hosting country OR Please set latitude/longitude in valid country for your listing'''
Check the country under which you have registered your Airbnb account is the same as the country your property is in. Check your settings for "Latitude" and "Longitude" are correct and match the address you have given.

'''Sorry, please contact support if you need to change the market of your listing.'''
Check if your settings for "Latitude" and "Longitude" are correct and do match the address you have given. Airbnb uses Google maps to validate addresses. You can check with address and latitude/longitude is in Airbnbs system when you click on "View all listings" and then on "content in Airbnb". If required, correct your data and then click "Update Airbnb". Check your Google map entry and if it is incorrect request Google maps to correct your location. If the error message persists go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No or contact Airbnb support. Give them the error message, your coordinates and your address and ask them to forward your request to someone in their team who is authorized to fix the problem at their end.

'''ServiceInvalidRequestException: You can't change your listing's address once you've started receiving reservation requests. If you need to make an update, please contact support.'''
Please check your address details in Beds24 match the details at Airbnb, if you need to change them, please contact Airbnb support and ask them to assist.
If you do not need to change your address details then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No.

'''Your listing has been temporarily paused and can't be turned on until you reactivate it. '''
If you do not know what the problem is please check the Email Airbnb sent you, the messages in your Airbnb account or contact Airbnb support and ask them to help.

'''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 API 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.

'''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€.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb calculates prices based on USD so what they calculate changes with the currency exchange rate.

'''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 which meets Airbnb's requirements.

'''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 ({{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID").

'''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.

'''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.

'''document_uri has already been taken.'''
You see this error if you have previously connected the room to another Airbnb account. Log into this Airbnb account and stop the sync for this listing. If you can not do this send us a support ticket asking us to delete the URI from the endpoint.

'''Expired Token'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''The document has no document element'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''Your listings are almost ready'''
If after some time you still see "Your listings are almost ready" after clicking Beds24 Channel Manager Sync" in Airbnb and see "In progress" on the "Listings" page check that "Publish = Yes is set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

'''Listing failed to import'''
Click on "Disconnect" then click on "Delete from Airbnb". Fix content errors. Then go back an publish the listing again.

'''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.

'''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.

'''Please select a consistent property type and property group.'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Please specify the property and listing type'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Messages do not send or import to Beds24'''
Log into your Airbnb account and go to ACCOUNT -> PRIVACY AND SHARING. If you do not see 'Access and respond your messages' in the list of permissions, disconnect and then reconnect the Airbnb account.

'''Airbnb account is not connected, please connect account'''
Log into your Airbnb account

'''Not enough beds for person capacity'''
Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > FEATURES and click on 'edit Bedroom' tab, select the appropriate room/bedroom configuration for your listing.

'''Not enough beds in room configurations'''
You do not have the appropriate bed configuration for the number of people you have selected in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > Max Guests. Scroll to FEATURES and click 'edit Bedroom' and select the appropriate number of bedrooms/beds for your guests.

'''Sorry, we can't add that amenity right now. Please try again later.'''
This was a transient error caused by an update to the Airbnb amenities data format. The error message should not repeat but if you continue to receive error emails, then please create a SUPPORT ticket.

'''Please make sure a photo has been uploaded before adding accessibility amenity. If the previous review rejects your photos, you need to upload a new photo'''
You are trying to send an accessibility amenity but do not provide a picture for this amenity. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT where you can add the accessibility amenity with a picture in "Custom". Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for further instructions.

'''All caps isn't allowed in listing titles.'''
Airbnb do not allow the Listing Name to be ALL Caps. Check the details in each of the sections below.
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > NAME
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > NAME
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > DESCRIPTIONS

'''Calendar will not Load, it will only show a loafing spinner wheel.'''
Please check that you have prices set and this are sending to AirBnb, have a look under
*{{#fas:cog}} (SETTINGS) > Channel Manager > AirBnB > Mapping, and click on "Price Data" to check if prices are being sent to AirBnb.

Airbnb Mapping

2022-08-30T11:17:16Z

IuriRosa: /* Troubleshooting and common errors */

[[Category:Channel Manager]]
[[Category:Airbnb]]
[[Category:Messaging]]
[[Category:Error Messages from Channels]]
[[Category:Troubleshooting]]

<div class="heading">Connect and update listings to Airbnb</div>

This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING and explains how to connect your rooms in Beds24 to existing listings in Airbnb and how to create new listings in Airbnb

=Capabilities=
You can connect one or multiple Airbnb account to
*Import listings from Airbnb which will create properties and/or rooms in Beds24.
*Create new listings in Airbnb from rooms in Beds24.
*Connect to existing listings in Airbnb to send updates from Beds24.

After you have mapped your listings Beds24 will automatically.
*Synchronize prices, availability and restrictions (min-stay, max-stay, closed to arrival, closed to departure) to Airbnb.
*Import bookings and booking modifications or cancellations.

You can also choose to
*Update all content including descriptions and pictures from Beds24
*Import booking requests
*Communicate with Airbnb guest directly from Beds24.

[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.

= Limitations =
*You can only connect listings which are live on Airbnb.
*Listings in properties which Airbnb considers "traditional hospitality" like hotels, Bed & Breakfast rooms and small inns are approved by Airbnb on a case by case basis.
*If you do not have daily prices or rates in which "Airbnb" is activated in the "Channels" tab the "Base Price" (Rack Rate) will be used up to a year in advance.
*Smart Pricing is not available for API connected listings.
*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.
*Airbnb does not allow Co-hosts the use of their API connection. Airbnb recommend you switch to [https://www.airbnb.co.uk/help/article/970/hosting-teams-an-introduction hosting teams] instead.

=Before you connect=
==Prices==
*We can only send availability if you have set up prices which are activated for Airbnb under "Channels" in the Daily Prices or Rates.
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*Airbnb requires a "Base Price" (Rack Rate) which you can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT. Make sure you are prepared to accept a booking for the "Base Price. 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 {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set 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 Base Price.
*You can set a multiplier to mark your price up or down.

==Bookings and Requests==
When you use the API connection Airbnb only allows instant bookings. In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > 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.

In {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can also add a "Custom Value" if you allow guests to send a request if they want to stay longer than your maximum stay rule allows.

After the connection has been successfully set up you can import upcoming existing bookings from Airbnb and all new bookings will automatically import.

Inquiries and requests are only imported if you opt in to importing them.

Airbnb collects the payment from your guest. Channel collect payments will be shown in the booking invoice if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under “Channel Collect Invoice” is set to import them. If you want to import the "Expected Payout amount" or the "Expected Payout and actual payment" from Airbnb you need to set this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER under "Airbnb" "Invoice".

By changes or updates of an existing booking, Airbnb will not dynamically update the cost for extra guests if a reservation alteration is initiated by either the host or the guest.

The host can reject the reservation alteration and can update the guest count and the cost of the extra guests, then send the alteration to the main guest, who will need to accept the new reservation.

==Properties, rooms and room types ==
A listing in Airbnb is a room in Beds24.

Our connection supports room types with a quantity of more than one. If you want to send a quantity of more than one you can not use "House or Villa or Cottage" as property type.

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.

==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], [https://www.airbnb.com/help/article/1385/responsible-hosting-in-portugal Portugal] , [https://www.airbnb.com/help/article/1388/responsible-hosting-in-spain Spain], [https://www.airbnb.com/help/article/1383/responsible-hosting-in-france France], [https://www.airbnb.de/help/article/1391/responsible-hosting-in-germany Germany]

For other regions please check the Airbnb help pages.

=Set the connection up=
==Property settings==
If you have multiple rooms in a property these settings will apply to all rooms in the property.

'''Step 1: Connect your Airbnb account to your property'''

Each property can connect to one Airbnb Account. Select the Airbnb account you want to connect to.

If no Airbnb account is available go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS and connect your account.

'''Step 2 - Apply a multiplier to mark your prices up or down (optional)'''

If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number.

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.

'''Step 3: Check the currency setting is correct'''

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 multiplier (above) for conversion.

'''Step 4 - Import inquiries from Aribnb (optional)'''

If you import inquiries Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

'''Step 5 - Assign an invoicee (optional)'''

If you need to send invoices which are different from your standard invoice you can use the [[Invoicees|invoicee]] function.

==Connect listings you already have on Airbnb==
By mapping a room you connect it so it can update a listing in Airbnb.

'''Step 1 - Change the pricing model (optional)'''

Select "Occupancy Pricing" if you want to send prices for different numbers of guests and/or different length of stay. See the chapter "Pricing Models" below for more information.

Press SAVE.

'''Step 2 - Check which prices will send '''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 3: Select your sync type'''

With sync type '''Prices and Availability''' Beds24 will only update your prices (including taxes and fees) and availability and import bookings. If you want to change your descriptions or pictures you do this in Airbnb.

With sync type '''Everything''' also 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 to sync everything your listing needs to meet Airbnbs requirements. If you see a red button "Fix Content Errors" your listing does not meet Airbnb requirements. Click on the button. Any settings which do not meet Airbnb requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Always go to "View Content" to check what will send to Airbnb before selecting '''Everything'''.

'''Step 4: Connect'''

Click "Connect" and select the corresponding listing to this room to make the connection.

If you have changed the sync type to "Everything" you need to press SAVE before connecting.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

'''Step 6: Import upcoming bookings'''

Click on "Import existing bookings" to import the bookings you already have in Airbnb. Bookings previously imported via the Airbnb iCal connection will not import. We recommend you delete them before you press the button.

[[File:Airbnb_Synctyp_Prices_Availability.mp4|640px]]

[[File:Airbnb_Synctyp_Everything.mp4|640px]]

=Create a new listing=

'''Step 1 - Select "Sync Type" Everything'''

Airbnb will only publish your listing if you send the full content.

Set "Sync Type" = Everything then press SAVE.

'''Step 2 - Check if your content meets Airbnbs requirements'''

Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT to revise which data will send to Airbnb. 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.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Airbnbs requirements. Click on the button to get to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > VIEW CONTENT.

'''Step 3 - Check which prices will send'''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Airbnb.

'''Step 4: Export to Airbnb'''

When your content meets Airbnbs requirements you can click "Export'''.

'''Step 5: Check that the connection is working properly'''

#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Airbnb do process the data you have sent then click on "Update". If Airbnb returns an error message scroll down to the "Troubleshooting" section to see why Airbnb sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Click on "Airbnb Listing" link to open the listing on Airbnb select dates to check the listing is bookable but do NOT finish the booking.

[[File:Create_a_new_listing_on_Airbnb.mp4|640px]]

=Airbnbs review and publishing process =
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 "Check Connection 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 "Check Connection Status".

=Updates=
*Changes to availability and prices will be instantly sent to the channel.
*Changes for settings for example minimum stays, the multiplier or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
*Content updates are only sent on demand. If you change content you you will need to click "Update" to send the changes.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> It can take Airbnb a couple of minutes to process the data we sent.

=Change the Sync Type=

If you want to change the sync type you need to:

'''Step 1 - Disconnect '''

Click on "Disconnect"

'''Step 2 - Change sync type'''

Change to the other sync type and SAVE.

'''Step 3 - Reconnect'''

Click on "Connect" and select the corresponding listing to this room to make the connection.

=Disconnect or terminate the connection=
Click on "Disconnect". This will set all your listings in this Airbnb account to "manual" so you can manage it manually. If you want to update the listing from Beds24 you will need to reconnect it.

If you want to disconnect all listings in an Airbnb account you can do this in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > ACCOUNTS.

You can also disconnect your Airbnb account from Beds24 in Airbnb. Log into your Airbnb account and go to ACCOUNT > PRIVACY AND SHARING and remove the Beds24 app.

=Options for both sync types=
==Pricing models==
Airbnb supports different pricing models.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Click on the "Price Data" Button to check which prices and availability will send.

===Per Day Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Day Pricing''' (the default) if you have only ONE price 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. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.

If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send.

Only a global max. stay which is taken from {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP can send.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*The number of guests for which the daily price applies.
*An extra person price.

For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > and set Guests included = 2, Extra Person Price = 15

===Per Occupancy (LOS) Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing''' if you want to send prices for different occupancies and/or different length of stay..

If you use rates the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.

If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span> Beds24 sends the price for max. 16 guests. If your property accommodates more than 16 guests use "Per Day" pricing with an extra person price.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to limitations with Airbnbs multi calendar Airbnb can not show the correct prices in your Airbnb Extranet. The correct prices will be shown to the guest though and the prices sent from Beds24 will be applied for all bookings. If you want to check prices on Airbnb please start a booking for your listing.

===Rate Plans===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> '''Rate plans''' are the pricing model of choice if you want
*to offer a refundable and a non-refundable option and
**set prices for refundable and non-refundable instead of Airbnbs fixed discount option
**control the cancellation policy for refundable and non-refundable prices
**control availability of the refundable/non-refundable booking option.
*parity with other channels which support rate plans i.e. Booking.com or Expedia.

You can create up to 10 rate plans which can be used for all listings in the Airbnb account. A maximum of 2 rate plans will be displayed to guests at a given time depending on the cancellation policy. Airbnb will display one refundable and another non-refundable rate plan and out of these (a) the lowest and (b) the most flexible rate.

A price for each occupancy defined in Beds24 can be sent.
*If you use daily prices they daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
*If you use rates 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rate can not be sent.

If you want to send prices for different length of stay you need a rate plan for each.

The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.

For more information and setup instructions click [[Airbnb_Rate_Plans |here]].

==Discounts==
If you have "Early Bird" or "Last Minute" prices which are activated for Airbnb these will automatically send. Airbnb will not mark these as promotions though.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT you can set
*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.
*A discount for "Non Refundable" bookings. If you select a sync type "Prices and Availability" you can set a non-refundable discount in your Airbnb extranet.
*Early Bird and Last Minute Discounts which Airbnb will mark as promotions.

You can also create"Pricing Rules" directly in Airbnb but we recommend you set all prices in Beds24 to avoid confusion.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Early bird or Last Minute offer are only marked as promotions if the price drops at least 10% from what Airbnb define as the last 30 days median price. If you use both early bird and last minute and want to remove one you will need to remove both because Airbnb will only remove them together. After you have clicked "Update" to send the change you can reactivate the one you want to keep.

Please refer to Airbnb for more information on [https://www.airbnb.com/help/article/2983/what-happens-if-i-offer-multiple-discounts how Airbnb calculates discounts].

==Fees and taxes==
If you apply fees or taxes you need to send them from Beds24.
*Cleaning fee

You can set under {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT.

Other fees supported by Airbnb can be sent as CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT. If you apply a linen fee Airbnb will add this to the cleaning fee.

*PETFEE 45 (for example)

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have a price multiplier in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB, > MAPPING this will also be applied to the Cleaning fee and Security deposit. If you want to over ride this, then use a CUSTOM value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER >AIRBNB > SPECIFIC CONTENT.

*If you want to send taxes click on "Check if you are eligible to send taxes" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. If Airbnb allows you to send taxes you can set them under "Custom". Please click on the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span>for "Custom" for detailed instructions

==Permit / Registration/ License==
In some locations Airbnb.com require the License/Registration number of the owner. Please also see under "Local legal requirements above"

If this is required for your property, please go to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID" and enter your details.

Permit IDs in Beds24 are set per property. If you have a different permit Id than the one set for the property you can set a room specific permit as "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

==Send and receive messages ==
You can get communicate with Airbnb guest directly from Beds24. This function works for:
*Confirmed bookings
*Inquiries/Requests - if you receive a message from a potential guest inquiring Beds24 will create a request booking. If the request turns into a confirmed booking the status will automatically change. If you want to automatically cancel requests which do not turn into confirmed bookings you can set up an [[Auto_Actions|Auto Action]] to automatically cancel the booking after a certain period.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you import inquiries you should set "Bookings with Request Status to "Do not block the room" in {{#fas:cog}} (SETTINGS) >PROPERTIES > BOOKING RULES so the room does not get blocked in Airbnb. If you block the room Airbnb will lock it. In this case the inquiry will be imported with the status "Cancelled" so it can convert to a confirmed booking.

You can view all messages from the "Messages" component on the DASHBOARD and individual communication from the "API Messages" tab in the booking. You and your guests will see the messages in Airbnb.

To use this function you should:

1. Add the component "API Messages" to your [[:Category:Dashboard|DASHBOARD]]

2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options. We will remove the HTML from the message because Airbnb does not support HTML. You have the option to add a plain text message for this purpose.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have moved the booking to a different room (manually or via dependencies), then ensure that both properties/rooms are connected with the same Airbnb account, otherwise this function will not work.

=Content for sync type "Everything"=
==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.

==Languages==
The content is sent in the language which is activated as default language for the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALIZATION.

If you have activated multiple languages and entered your descriptions in these we can multiple languages if you set "Allow Multi-Language" = Yes in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Please check the context help before changing the setting.

Following languages are supported by Airbnb and Beds24: Bahasa Indonesia, Catala, Dansk, Deutsch, English. Español, Eλληνικά, Français, Hrvatski, Italiano, Magyar, Nederlands, Norsk, Polski, Português, Suomi, Svenska, Íslenska, Čeština, Русский, עברית, ภาษาไทย, 中文, 日本語 ja
한국어.

==Property Type ==
Most of the property types which Airbnb supports can be selected in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

Other Airbnb property types can be added as "Custom" values in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

== Bedrooms and bathrooms==
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Set up bedrooms and bathroom either in the property OR the room. If you set them up in both you will double them up. Do not send additional bathroom amenities if you have a full bathrooom.

Bedrooms and bathrooms 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 "Bedroom" or "Bathroom".
*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.

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

*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.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>: Airbnb does not support all available features available in Beds24.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you add a crib in a bedroom Airbnb will display the crib as a bed. If you do not want to do this add BED_CRIB in a new line.

BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BEDROOM

BED_AIRMATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOORMATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

If you have a murphy bed it will send as single bed.

== Amenities ==
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room ({{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 {{#fas:cog}} (SETTINGS) 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 "linens", towels and "toiletries".

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have "Accessability" amenities Airbnb requires you to provide a picture for each amenity which they review. You can add these amenities and the pictures in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT under "Custom".

You will find a list all all "Accessability" amenities below under "All Feature Codes".

You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you do not select select child friendly amenities Airbnb might classify your listing as "Not safe or suitable for children (0-12 years)"

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb does not support all available feature codes. Make sure you pick five features which are supported by Airbnb.

==Pictures==
You can define in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT which pictures will be used.

Double check you have entered "Captions" for every picture.

Requirements and limitations from Airbnb:
*Airbnb requires a '''minimum of 1 picture per listing with high-resolution (800x500 pixels).
*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.

<div class="warning">{{#fas:exclamation-triangle}} Airbnb requires Captions. If you change pictures make sure you change/add the caption in (SETTINGS) BOOKING ENGINE > PICTURES so Airbnb recognizes the new picture.</div>

== Check-in ==
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT you can set 'Check-in start', 'Check-in end' and 'Check-out end'.

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 end' to the same time or earlier than 'Check-in start'. This will work with all times except for 01:00 and 02:00 in the morning.

==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".

==Airbnb specific content ==
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT or click on the "Edit specific content for Airbnb" link to check and customize. specific content for Airbnb.

= 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

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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:

==Amenities==
AIR_CONDITIONING

BEACH_ESSENTIALS

BALCONY

CLEANING_PRODUCTS

CLOSET

CLOTHES_DRYINGRACK

CO_DETECTOR

CONDITIONER

DRYER

ELEVATOR

EXTRA_PILLOWS_BLANKETS

EV_CHARGER

FAN_PORTABLE

FIRE_EXTINGUISHER

FIRE_PIT

FIREPLACE

FIRST_AID_KIT

GAMES

GARDEN

GRILL

GRILL_EQUIPMENT

HAIR_DRYER

HAMMOCK

HANGERS

HEATING

IRON_BOARD

LINENS (if all of TOILETRIES, TOWELS and LINENS are used, this sends as "Essentials")

LIVING_ROOM

MOSQUITO_NET

OUTDOOR_FURNITURE (for outdoor seating)

PARKING

PARKING_PAID

PARKING_POSSIBLE

PIANO

POOL_TABLE

PRIVATE_ENTRANCE

ROOM_DARKENING_SHADES

TOILETRIES (body soap)

SAFETY_CARD

SHAMPOO

SHOWER_GEL

SMOKE_DETECTOR

SOAP

STEREO

TOWELS

TRASH_COMPACTER

WASHER

WATER_HOT

==Business==

==Entertainment==
TV

CABLE

VIDEO_GAMES

==Food and Drink==
BREAKFAST_INCLUDED

==Internet==
ETHERNET

INTERNET

WIFI

WIFI_POCKET

==Kitchen==
KITCHEN

KITCHEN_OUTDOOR

BAKING_SHEET

BLENDER

COFFEE

COFFEE_MAKER

COOKING_BASICS (is sent if both "DISHES_UTENSILS" and "SPICES" is selected)

DISHES_UTENSILS (is sent in combination with "SPICES" as "Cooking Basics")

DISHWASHER

FREEZER

GLASSES_WINE

KETTLE

OVEN

STOVE

REFRIGERATOR

REFRIGERATOR_MINI

RICE_MAKER

SPICES (is sent in combination with "DISHES_UTENSILS" as "Cooking Basics")

TOASTER

==Location==
BEACH_FRONT

LAKE (lake access in Airbnb)

SKI_IN

SKI_OUT

WATER_VIEW

==Pets==
PETS_CONSIDERED

==Pool & Wellness==
GYM

POOL

POOL_HEATED

POOL_INDOOR

POOL_PRIVATE

==Services==
DOORBELL

DOORMAN

RECEPTION_24HOUR

LUGGAGE_DROPOFF

CLEANING_BEFORE_CHECKOUT

BICYCLE_RENTAL

==Sports==
BOAT_SLIP

FITNESS_CENTER (for exercise equipment)

KAYAK_CANOE

TABLE_TENNIS

==Suitability==
ADULTS_ONLY

CHILDREN_NOT_ALLOWED

EVENTS_ALLOWED

INFANTS_NOT_ALLOWED

LAPTOP_FRIENDLY

LONG_TERM_RENTERS

SMOKING_ALLOWED

==Accessibility==
PARKING_DISABLED

STEP_FREE_ACCESS_BATHROOM

GRAB_RAILS_IN_SHOWER

GRAB_RAILS_IN_TOILET

ROLLIN_SHOWER

SHOWER_CHAIR

WIDE_DOORWAY_BATHROOM

TUB_WITH_SHOWER_BENCH

WIDE_CLEARANCE_TO_SHOWER_AND_TOILET

STEP_FEE_ACCESS_BEDROOM

WIDE_DOORWAY_BEDROOM

SINGLE_LEVEL_HOME

COMMON_SPACE_STEP_FREE_ACCESS

COMMON_SPACE_WIDE_DOORWAY

HOME_STEP_FREE_ACCESS

PATH_TO_ENTRANCE_LIT_AT_NIGHT

HOME_WIDE_DOORWAY

FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR

==Family==
CHANGING_TABLE

BABY_BATH

PACK_N_PLAY_TRAVEL_CRIB

FIREPLACE_GUARD

BABY_MONITOR

OUTLET_COVERS

TABLE_CORNER_GUARDS

WINDOW_GUARDS

CHILDRENS_DINNERWARE

BABYSITTER_RECOMMENDATIONS

==Bedroom==
BEDROOM

BEDROOM_ENSUITE

BEDROOM_LIVING_SLEEPING_COMBO

BEDROOM_OTHER_SLEEPING_AREA

BED_AIR MATTRESS

BED_BUNK

BED_CRIB

BED_COUCH

BED_DOUBLE

BED_FLOOR_MATTRESS

BED_FUTON

BED_HAMMOCK

BED_KING

BED_QUEEN

BED_SINGLE

BED_SOFA

BED_TODDLER

==Bathroom==
BATHROOM

BATHROOM_FULL

BATHROOM_HALF

BATH_BIDET

BATH_SHOWER_RAIN

= Troubleshooting and common errors =
'''Not Processed '''
Airbnb had a temporary problem processing the updates we send. This normally comes good by itself when Airbnb fixed the problem. Wait a bit then press "Update" wait for Airbnb to process the update you just sent and then click "Update status". If the problem persists after a couple of hours notify us via a support ticket.

'''You do not have permission to access this resource'''
Click "Disconnect" and then reconnect the room and to your listing in Airbnb.

'''Not Connected '''
You have disconnected the listing in Airbnb. Click "Disconnect" and then reconnect it.

'''Listing shows as "Importing" in the Airbnb Extranet '''
Beds24 sent the data but it is stuck at Airbnb. Try the following:
1. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > MAPPING
2. Click on "Disconnect"
4. Refresh the page then connect again
5. Wait a bit and then check the "Connection status"
If you then still see "Importing"in Airbnb contact Airbnb support and ask them to check why your listings are stuck. You might need to insist that they forward your request to someone who is qualified to do so.

'''Sorry, we cannot activate your listing.'''
It seems you have an issue with your “Booking settings” in your Airbnb account. Please log into your Airbnb account and check what is set under the tab Booking Settings. You can find more information here: https://www.airbnb.com/help/article/1353/how-do-i-choose-who-can-instant-book-my-place

'''Lat/Long outside of hosting country OR Lat/lng outside of hosting country OR Please set latitude/longitude in valid country for your listing'''
Check the country under which you have registered your Airbnb account is the same as the country your property is in. Check your settings for "Latitude" and "Longitude" are correct and match the address you have given.

'''Sorry, please contact support if you need to change the market of your listing.'''
Check if your settings for "Latitude" and "Longitude" are correct and do match the address you have given. Airbnb uses Google maps to validate addresses. You can check with address and latitude/longitude is in Airbnbs system when you click on "View all listings" and then on "content in Airbnb". If required, correct your data and then click "Update Airbnb". Check your Google map entry and if it is incorrect request Google maps to correct your location. If the error message persists go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No or contact Airbnb support. Give them the error message, your coordinates and your address and ask them to forward your request to someone in their team who is authorized to fix the problem at their end.

'''ServiceInvalidRequestException: You can't change your listing's address once you've started receiving reservation requests. If you need to make an update, please contact support.'''
Please check your address details in Beds24 match the details at Airbnb, if you need to change them, please contact Airbnb support and ask them to assist.
If you do not need to change your address details then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT and set "Update Address" = No.

'''Your listing has been temporarily paused and can't be turned on until you reactivate it. '''
If you do not know what the problem is please check the Email Airbnb sent you, the messages in your Airbnb account or contact Airbnb support and ask them to help.

'''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 API 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.

'''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€.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Airbnb calculates prices based on USD so what they calculate changes with the currency exchange rate.

'''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 which meets Airbnb's requirements.

'''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 ({{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION "Permit ID").

'''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.

'''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.

'''document_uri has already been taken.'''
You see this error if you have previously connected the room to another Airbnb account. Log into this Airbnb account and stop the sync for this listing. If you can not do this send us a support ticket asking us to delete the URI from the endpoint.

'''Expired Token'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''The document has no document element'''
Check if the listing has been deleted in Airbnb. If so you will need to send it again from Beds24.

'''Your listings are almost ready'''
If after some time you still see "Your listings are almost ready" after clicking Beds24 Channel Manager Sync" in Airbnb and see "In progress" on the "Listings" page check that "Publish = Yes is set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT.

'''Listing failed to import'''
Click on "Disconnect" then click on "Delete from Airbnb". Fix content errors. Then go back an publish the listing again.

'''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.

'''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.

'''Please select a consistent property type and property group.'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Please specify the property and listing type'''
Check the 'Property Type" in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and the 'Listing Type' match with the 'Property Type Group' you have selected in{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT. Check the (?) for Property Type Group for the correct Listing Type for each group. Please also note that Airbnb has regional restrictions for some property types. Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for information on which combinations are allowed. Check with Airbnb support if you have a problem with your property type.

'''Messages do not send or import to Beds24'''
Log into your Airbnb account and go to ACCOUNT -> PRIVACY AND SHARING. If you do not see 'Access and respond your messages' in the list of permissions, disconnect and then reconnect the Airbnb account.

'''Airbnb account is not connected, please connect account'''
Log into your Airbnb account

'''Not enough beds for person capacity'''
Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > FEATURES and click on 'edit Bedroom' tab, select the appropriate room/bedroom configuration for your listing.

'''Not enough beds in room configurations'''
You do not have the appropriate bed configuration for the number of people you have selected in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > Max Guests. Scroll to FEATURES and click 'edit Bedroom' and select the appropriate number of bedrooms/beds for your guests.

'''Sorry, we can't add that amenity right now. Please try again later.'''
This was a transient error caused by an update to the Airbnb amenities data format. The error message should not repeat but if you continue to receive error emails, then please create a SUPPORT ticket.

'''Please make sure a photo has been uploaded before adding accessibility amenity. If the previous review rejects your photos, you need to upload a new photo'''
You are trying to send an accessibility amenity but do not provide a picture for this amenity. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT where you can add the accessibility amenity with a picture in "Custom". Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for further instructions.

'''All caps isn't allowed in listing titles.'''
Airbnb do not allow the Listing Name to be ALL Caps. Check the details in each of the sections below.
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > NAME
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP > NAME
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AIRBNB > SPECIFIC CONTENT > DESCRIPTIONS

'''Calendar will not Load, it will only show a loafing spinner wheel'''
Please check that you have prices set and this are sending to AirBnb, have a look under
*(SETTINGS) > Channel Manager > AirBnB > Mapping, and click on "Price Data" to check if prices are being sent to AirBnb.

Make

2022-08-14T16:39:43Z

IuriRosa:

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > INTEGROMAT and explains how to connect and what you can do with the connection.

<div class="warning">{{#fas:exclamation-triangle}} We have reports from users that they are experiencing problems when upgrading from Integromat to Make. We advise not to migrate at the moment if you have working connections with Integromat. </div>

To use this service you will need an account with [https://www.integromat.com/en/?pc=beds24 Integromat].

For Beds24 the normal channel manger fees apply.

== Capabilities ==
Within Make you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Make which will be passed on to the services you connected to

== Limitations ==

== Set Up ==

=== Beds24 ===
*Set up an Auto Action (SETTINGS-GUEST MANAGEMENT-AUTO ACTIONS) which selects the bookings which will be sent to Make. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Make. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Make and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it.
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Make, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Integromat to re-import the bookings with every read.

=== Make ===
*Create an Make account at [https://www.integromat.com/en/?pc=beds24 Make].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Make====
The advanced section of the Make connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Make data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Make with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Make provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the "Make" App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Make you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Make when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Make and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Make via the "watch bookings" trigger.

These bookings will then be automatically transferred from Make to the apps/services in your Make scenarios.

Make triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Make.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

== Common Problems ==
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Make to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in Make and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

== Disconnect==
Untick "Bookings" to stop sending bookings.

== Examples ==
===Sample Scenarios===
Make provides a range of sample scenarios at https://www.make.com/en/integrations/beds24?fromImt=1&pc=beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Make and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Make to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Make, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Make and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Make ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Make google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Make

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Make

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== How to collect additional guest details and add to the booking ===
</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.

In this example we will show you how to collect additional guests information like “First name, Last Name, Id number and birth date. And insert this into the “Info” field of the booking

1. Setup a new google form and name this “Guests Information”

[[Image:Guestinfo1.png|650px|link=]]
[[Media:Guestinfo1.png|view large]]

2. Create the questions

a. Booking ID

b. First Name

c. Last Name

d. Id Number

e. Birth date

[[Image:Guestinfo2.png|650px|link=]]
[[Media:Guestinfo2.png|view large]]

3. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfo3.png|650px|link=]]
[[Media:Guestinfo3.png|view large]]

4. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfo4.png|650px|link=]]
[[Media:Guestinfo4.png|view large]]

5. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responces”.

6. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfo5.png|650px|link=]]
[[Media:Guestinfo5.png|view large]]

7. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

8. Now we will need to add another module, add the “Json” module and set it to “Create Json”

9. You will need to add a “Data Structure.
a. Click on “Add”
b. “Name the data structure” and click on “Generator”
c. Leave the “Content Type = Json
d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"firstNight": "2014-09-30",
"numAdult": "3",
"invoice": [
{
"invoiceId": "123456789",
"description": "deposit payment",
"status": "",
"qty": "-1",
"price": "23.45",
"vatRate": "10",
"type": "200"
}
],
"infoItems": [
{
"code": "PAYMENT",
"text": "Paid $200"
}
]
}

10. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

[[Image:Guestinfo6.png|650px|link=]]
[[Media:Guestinfo6.png|view large]]

11. You will also need to add under “Notes” the following (See image) above

a. FirstName: - add the Make variable for the First Name

b. Last Name: - add the Make variable for the Last Name

c. Id Number: - add the Make variable for the ID Number

d. Birth Date: - add the Make variable for the Birth Date

12. Set the module HTTP, and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfo7.png|650px|link=]]
[[Media:Guestinfo7.png|view large]]

After you do this, go to your Google form and fill it in as a “guest” than in Make click on “Run Once” it should retrieve the answers and insert into the booking in the field “Notes”.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Make.
Setup a google form with the information/questions you want to collect from a guest, and using Make we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Make, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Make to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Make will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Make to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to Make and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Make and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Make sometimes Make can miss out on bookings sent to Make.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Make, once the bookings is correctly picked up by Make you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Make stopping the bookings from going thru any other modules in Make.

Each customer has its own Make module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Make, it is required that you set a "template" field (template1), we are using this to pass the Info code to Make.

Make Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Make",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

Make

2022-08-14T16:14:47Z

IuriRosa:

[[Category:Apps]]
[[Category:Automation]]
[[Category:Use_Cases]]
<div class="heading">Make (formerly Integromat)</div>
This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > INTEGROMAT and explains how to connect and what you can do with the connection.

<div class="warning">{{#fas:exclamation-triangle}} We have reports from users that they are experiencing problems when upgrading from Integromat to Make. We advise not to migrate at the moment if you have working connections with Integromat. </div>

To use this service you will need an account with [https://www.integromat.com/en/?pc=beds24 Integromat].

For Beds24 the normal channel manger fees apply.

== Capabilities ==
Within Integromat you can connect Beds24 to third party Apps and services. Beds24 will then send booking data to Integromat which will be passed on to the services you connected to

== Limitations ==

== Set Up ==

=== Beds24 ===
*Set up an Auto Action (SETTINGS-GUEST MANAGEMENT-AUTO ACTIONS) which selects the bookings which will be sent to Integromat. Set "Trigger Action" = automatic.
*Select the Auto Action which you want to use for Integromat. The Auto Action must be created by the Account which owns the property, actions linked from other accounts cannot be used.
*Tick the rooms for which you want to send bookings. Only bookings from rooms enabled for Integromat and which meet the trigger conditions in the Auto Action will be sent.
*Create an apiKey of 16 or more characters and save it.
*Choose your send strategy, bookings can be sent continuously, repeatedly, once only or after each modification.
*A default set of booking information is sent to Integromat, this can be customized by specifying the fields you want to send, one per line at the setting "Data fields". See below for a set of all fields.

====Send Strategy====
The following options are available for the booking send strategy.
*Once only - send the booking once and never again, even if modified.
*Whenever modified - send bookings if they have been modified.
*Repeated - send bookings repeatedly with the last modified time of the booking.
*Continuously - send bookings repeatedly with the last modified time set to the current time. This will force Integromat to re-import the bookings with every read.

=== Integromat ===
*Create an Make account at [https://www.integromat.com/en/?pc=beds24 Integromat].
*Search for the Beds24 App.
*Connect the Beds24 App to your scenario and enter the apiKey you created and the Beds24 Property Id.

<embedvideo service="youtube">https://youtu.be/ULn_WKNKOk8</embedvideo>

*Select the trigger "watch bookings" and map the data into your scenario as you require.
*Make sure to set the limit value in "watch bookings" high enough to allow Integromat to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.
*When prompted to "Choose where to start", select the "All" option.
[[File:Integromat_choose_where_to_start.png]]

==== Send template variables to Integromat====
The advanced section of the Integromat connection form has eight template fields where you can enter Beds24 Template Variables.

The matching "template" data field must be specified in Beds24 as one of the Integromat data fields to enable the field. (template1 etc.).

The Template Variable will be calculated and it's value sent to Integromat with the booking.

<embedvideo service="youtube">https://youtu.be/rwI8_Eijeuw</embedvideo>

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Integromat provides [https://partners.integromat.com/?utm_source=sendy&utm_medium=email&utm_content=subject-a&utm_campaign=0520-newsletter list of developers] who can help with integrations.

*Make sure the Integromat App Limit can process the maximum number of bookings you expect to be sent for each trigger, especially if you are sending the bookings one time only, more bookings than the limit value will not be processed.

== How it works ==
In Integromat you create a scenario which automates tasks for you. A scenario is comprised of a series of modules that indicate how data should be transferred and transformed between Beds24 and other apps/services.

Bookings are sent from Beds24 to Integromat when the room is enabled and the booking meets the trigger condition in the selected auto action.
If you have multiple properties enabled for Integromat and the auto action applies to their bookings, those bookings will also be sent.
Bookings which were sent will appear in Integromat via the "watch bookings" trigger.

These bookings will then be automatically transferred from Integromat to the apps/services in your Integromat scenarios.

Integromat triggers the booking read when the scenario runs, they are not pushed from Beds24.

== Data Fields ==
If the data fields setting is left empty, a default set of information will be sent about each booking.

If the data fields setting is used, only the booking number, modifiedTime and the fields specified are sent to Integromat.
Data field values must be specified one per line.

<embedvideo service="youtube">https://youtu.be/jQAo4J6YVAI</embedvideo>

Possible values are:

<code>
groupId

roomId

roomName

unitId

unitName

status

checkIn

checkOut

lastNight

numAdult

numChild

guestTitle

guestFirstName

guestLastName

guestComments

guestArrivalTime

guestEmail

guestPhone

guestMobile

guestCompany

guestAddress

guestCity

guestState

guestPostCode

guestCountry

guestCountry2

lang

originalBooking

originalOTA

originalReferer

referer

notes

reference

custom1

custom2

custom3

custom4

custom5

custom6

custom7

custom8

custom9

custom10

offerId

voucher

flagColor

flagText

bookingTime

invoice

invoiceCharges

invoicePayments

totalCharges

totalPayments

totalBalance

price

tax

deposit

commission

rateDescription

template1

template2

template3

template4

template5

template6

template7

template8

</code>

== Common Problems ==
'''Some bookings are not processed'''
Make sure to set the limit value in "watch bookings" high enough to allow Integromat to process all the bookings you expect to be in the data. If you leave it at 1, only the first booking in each trigger will be processed.

'''Only new/recently modified bookings are processed'''
Make sure the "Choose where to start" option is set to "All". This option can be changed by going to the "Scenarios" tab in integromat and right clicking the Beds24 Watch Bookings module.
[[Image:Integromat_choose_where_to_start_menu.png|450px|link=]]
[[Media:Integromat_choose_where_to_start_menu.png|view large]]

== Disconnect==
Untick "Bookings" to stop sending bookings.

== Examples ==
===Sample Scenarios===
Integromat provides a range of sample scenarios at https://www.integromat.com/en/integrations/beds24.

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Create a Subaccount from a Google Form ===
</div>
<div class="mw-collapsible-content">

1. Create the Google form(https://docs.google.com/forms/u/0/) , you will need to at least “request” on the form

a)Username

b)Email

c)Password

2. Go to Integromat and create a scenario, start with a Google Forms, and set it to “Watch Responses”

[[Image:integromat_subaccount1.png|650px|link=]]
[[Media:integromat_subaccount1.png|view large]]

3. Set the connection ( you will need to Allow Integromat to access your Google account),

a) Choose the “File” this is the same name you gave your “Form” in Google forms.

b) Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c) Maximum number of returned rows, Here, set the maximum number of results that Integromat will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses.

[[Image:integromat_subaccount2.png|650px|link=]]
[[Media:integromat_subaccount2.png|view large]]

4. After this, it will ask you to “Select the first row” this means the row you want Integromat to start checking the worksheet, it should normal be set to number”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

6. You will need to add a “Data Structure.

a) Click on “Add”

b) “Name the data structure” and click on “Generator”

c) Leave the “Content Type = Json

d) On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings"
},
"createAccount": [
{
"username": "username",
"password": "password",
"apiKey": "YourKeyToUseForTheNewAccount",
"email": "mail@email.com",
"role": "0",
"systemEmails": "0",
"bookingEmails": "0",
"bookingReplyto": "0"
}
]
}

[[Image:integromat_subaccount3.png|650px|link=]]
[[Media:integromat_subaccount3.png|view large]]

*Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key,

[[Image:integromat_subaccount4.png|650px|link=]]
[[Media:integromat_subaccount4.png|view large]]

*You need to set the API key you have set under Settings -> Account - > Account Access

*Click on “Add Items” under Create Account in Integromat, here you will need to add the variables into the correct fields.

**Leave the “API” field empty, the fields
***Role
***systemEmails
***bookingEmails
***bookingReplyto
**Can be manually filled by you conform your requirements, for information about this fields please have a look at this page, https://api.beds24.com/json/createAccount

After you have done this, click on “Add” and than click on “Ok”.

Now we are going to create another module.

*Set the module HTTP, and set this to “Make a Request”

**Set the:
***URL: https://api.beds24.com/json/createAccount
***Method:Post
***Header: Leave blank
***Query String: Leave blank
***Body Type: Raw
***Content Type: JSON
***Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:integromat_subaccount5.png|650px|link=]]
[[Media:integromat_subaccount5.png|view large]]

Click on “OK” and you are ready to test this scenario,

Open you Google form and insert some information, “username / Email and password” this will be added to row 2 on your worksheet, go to Integromat and click on “Run Once” it will insert this user as a sub account into your Beds24 account.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Sending Push Notifications for Bookings to your Google Chrome/Account ===
</div>
<div class="mw-collapsible-content">
1. After you setup your Beds24 module in Integromat ( showing in this video https://wiki.beds24.com/index.php/Integromat.com#Integromat) set the Google Chrome module.

[[Image:push1.png|650px|link=]]
[[Media:push1.png|view large]]

2. Click on “Add This Chrome” and install the Integromat google chrome plugin.

[[Image:push2.png|650px|link=]]
[[Media:push2.png|view large]]

3. Click on “Add to Chrome” to install the plugin

[[Image:push3.png|650px|link=]]
[[Media:push3.png|view large]]

4. Copy the Registration Code

[[Image:push8.png|650px|link=]]
[[Media:push8.png|view large]]

5. Paste the Registration code on the Chrome module in Integromat

[[Image:push4.png|650px|link=]]
[[Media:push4.png|view large]]

6. Create the message you want to send , you can use the Beds24 Template variables that show in Integromat

[[Image:push5.png|650px|link=]]
[[Media:push5.png|view large]]

7. Once a new booking is created, Intergomat send a notification to your Google Chrome/Account

[[Image:Push6.png|650px|link=]]
[[Media:Push6.png|view large]]

[[Image:push7.jpg|650px|link=]]
[[Media:push7.jpg|view large]]
</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== How to collect additional guest details and add to the booking ===
</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information and add this to the booking, you can do this using a Google Form and Integromat.
Setup a google form with the information/questions you want to collect from a guest, and using Integromat we will get the response from the form and insert into the correct booking.

In this example we will show you how to collect additional guests information like “First name, Last Name, Id number and birth date. And insert this into the “Info” field of the booking

1. Setup a new google form and name this “Guests Information”

[[Image:Guestinfo1.png|650px|link=]]
[[Media:Guestinfo1.png|view large]]

2. Create the questions

a. Booking ID

b. First Name

c. Last Name

d. Id Number

e. Birth date

[[Image:Guestinfo2.png|650px|link=]]
[[Media:Guestinfo2.png|view large]]

3. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfo3.png|650px|link=]]
[[Media:Guestinfo3.png|view large]]

4. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfo4.png|650px|link=]]
[[Media:Guestinfo4.png|view large]]

5. Log into Integromat, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responces”.

6. Set the connection ( you will need to Allow Integromat to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Integromat will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfo5.png|650px|link=]]
[[Media:Guestinfo5.png|view large]]

7. After this, it will ask you to “Select the first row” this means the row you want Integromat to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

8. Now we will need to add another module, add the “Json” module and set it to “Create Json”

9. You will need to add a “Data Structure.
a. Click on “Add”
b. “Name the data structure” and click on “Generator”
c. Leave the “Content Type = Json
d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"firstNight": "2014-09-30",
"numAdult": "3",
"invoice": [
{
"invoiceId": "123456789",
"description": "deposit payment",
"status": "",
"qty": "-1",
"price": "23.45",
"vatRate": "10",
"type": "200"
}
],
"infoItems": [
{
"code": "PAYMENT",
"text": "Paid $200"
}
]
}

10. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

[[Image:Guestinfo6.png|650px|link=]]
[[Media:Guestinfo6.png|view large]]

11. You will also need to add under “Notes” the following (See image) above

a. FirstName: - add the Integromat variable for the First Name

b. Last Name: - add the Integromat variable for the Last Name

c. Id Number: - add the Integromat variable for the ID Number

d. Birth Date: - add the Integromat variable for the Birth Date

12. Set the module HTTP, and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfo7.png|650px|link=]]
[[Media:Guestinfo7.png|view large]]

After you do this, go to your Google form and fill it in as a “guest” than in Integromat click on “Run Once” it should retrieve the answers and insert into the booking in the field “Notes”.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >

=== Collect Guest details from a Google Form ===

</div>
<div class="mw-collapsible-content">

If you want to collect additional guest information ( or update the current information) and add this to the booking, you can do this using a Google Form and Integromat.
Setup a google form with the information/questions you want to collect from a guest, and using Integromat we will get the response from the form and insert into the correct booking.
In this example we will show you how to collect additional guests information like “First name, Last Name, address, city, postcode and country. And insert this into the corresponding field of the booking

1. Setup a new google form and name this “Guests Information”

Create the questions

a. Booking ID

b. First Name

c. Last Name

d. address

e. city

f. postcode

g. country

[[Image:Guestinfofromdoc1.png|650px|link=]]
[[Media:Guestinfofromdoc1.png|view large]]

2. Click on “Responses”, and than click on the “Excel Icon”

[[Image:Guestinfofromdoc2.png|650px|link=]]
[[Media:Guestinfofromdoc2.png|view large]]

3. Select “Create a new Spreadsheet” and click on “create”

[[Image:Guestinfofromdoc3.png|650px|link=]]
[[Media:Guestinfofromdoc3.png|view large]]

4. Log into Integromat, and start a new Scenario, the first module we are going to need is Google Forms and set this to “Watch Responses”.

4.1. Set the connection ( you will need to Allow Integromat to access your Google account),

a. Choose the “File” this is the same name you gave your “Form” in Google forms.

b. Worksheet, Google forms should create a worksheet in your Google drive, you need to select this here.

c. Maximum number of returned rows, Here, set the maximum number of results that Integromat will work with during one cycle, You can set this to one, we will make this scenario constantly checking for new responses

[[Image:Guestinfofromdoc4.png|650px|link=]]
[[Media:Guestinfofromdoc4.png|view large]]

4.2. After this, it will ask you to “Select the first row” this means the row you want Integromat to start checking the worksheet, it should normal be set to number ”2” because the first row is used for the column names.

5. Now we will need to add another module, add the “Json” module and set it to “Create Json”

[[Image:Guestinfofromdoc5.png|650px|link=]]
[[Media:Guestinfofromdoc5.png|view large]]

6. You will need to add a “Data Structure.

a. Click on “Add”

b. “Name the data structure” and click on “Generator”

c. Leave the “Content Type = Json

d. On the Sample Data insert

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"guestFirstName": "Joe",
"guestName": "Smith",
"guestAddress": "1 Big Street",
"guestCity": "London",
"guestPostcode": "EX 1234",
"guestCountry": "United_Kingdom"
}

6.1. Click on “Save”, you should now see the original “window” with your data structure and it should have a “Authentication” box where you need to insert the API key

6.2You will also need to add the correct “Google form” variables into the corresponding fields., just like the image below

[[Image:Guestinfofromdoc6.png|650px|link=]]
[[Media:Guestinfofromdoc6.png|view large]]

7. Next Add a new module, you need a HTTP module and set this to “Make a Request”

Set the:
a. URL: https://api.beds24.com/json/setBooking
b. Method:Post
c. Header: Leave blank
d. Query String: Leave blank
e. Body Type: Raw
f. Content Type: JSON
g. Request Content: JSON String ( Its a variable you need to drag and drop).

[[Image:Guestinfofromdoc7.png|650px|link=]]
[[Media:Guestinfofromdoc7.png|view large]]

7.1 Click on safe, now go to your google form, fill in the form with a actual Booking ID ( make sure it is a “test” booking) after you do this go back to integromat and click on “Run Once”, it should get the responses and insert the information into the Booking.

</div>
</div>

<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >
=== Send a booking to Integromat and set a Info Code===
</div>
<div class="mw-collapsible-content">
Due to a combination of some settings and or specific modules in Integromat sometimes Integromat can miss out on bookings sent to Integromat.

If this happens on a frequent basis we recommend that you setup Beds24 to continuously send the bookings to Integromat, once the bookings is correctly picked up by Integromat you can setup a Json module to create a code ans set a info code in the Booking in Beds24 using the API.

This way once a booking is correctly sent it will contain the Info code and based on this info code you can filter out this booking the next time it is sent to Integromat stopping the bookings from going thru any other modules in Integromat.

Each customer has its own Integromat module setup and so it is hard to create a scenario valid for everyone, however the only thing we need to setup is 2 modules a Json module to create the Json code and a HTTP module to send the code to Beds24 to set the info code.

Have a look at the following video to understand how the sequence will work,

<embedvideo service="youtube">https://youtu.be/LZp-Dau_MGc</embedvideo>

*** Beds24 Setup.

1. Under Settings > Apps & Integrations > Integromat, set the "Send strategy=Continuously"
In the Data fields set all the necessary fields that you need to pass from Beds24 to Integromat, it is required that you set a "template" field (template1), we are using this to pass the Info code to Integromat.

Integromat Setup.

Json Module,

You will need the following Data Structure,

{
"authentication": {
"apiKey": "apiKeyAsSetInAccountSettings",
"propKey": "propKeyAsSetForTheProperty"
},
"bookId": "12345678",
"infoItems": [
{
"code": "Integromat",
"text": "OK"
}
]
}

The HTTP module

You need a HTTP module after the json module and set this to “Make a Request”

Set the:

a. URL: https://api.beds24.com/json/setBooking

b. Method:Post

c. Header: Leave blank

d. Query String: Leave blank

e. Body Type: Raw

f. Content Type: JSON

g. Request Content: JSON String ( Its a variable you need to drag and drop).

Do not forget to set a filter as you saw in the video the filter will stop the booking from going further if it contains the info code,

1. Set a "Text Operator" filter "Not Equal To"

</div>
</div>

Responsive Booking Page

2021-10-13T07:45:07Z

IuriRosa:

[[Category:How to]]
[[Category:Booking Page]]
[[Category:Booking Engine]]
<div class="heading">Responsive Booking Page</div>
This page explains how to use and customise the responsive version of the booking page.

==Booking Engine Configuration ==
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/wizard/wizard4.php wizard] guides you though the options you can set for your booking engine.

==Add booking widget to your web site ==
In SETTINGS->BOOKING ENGINE->BOOKING WIDGETS you can choose from a range of widgets

Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS > IFRAME GENERATOR to generate the code to embed the booking page into your web site. Use the context help (?icons) for information about the iFrame settings.

== Set up and customise responsive booking page ==

=== Concept===
The design of the responsive booking page is modular allowing you to fully control the layout.

====Modules====
Modules can be added an removed. They have advanced settings so you can tailor the display exactly to your needs. For most modules content needs to be added so they can display. Available modules are:

*Picture slider or gallery for property, rooms and offers
*Picture for property, rooms and offers
*Featues for property and rooms
*Availability calendar (one or multiple month) for for property, rooms and offers
*Pricetable for offers
*Descriptions for property, rooms and offers
*Policies
*Map

====Templates====
We provide a set of default templates with preset modules. You can use these templates as they are or customise them to suit your requirements.

The current default template is 7.

<div><ul>
<li style="display: inline-block; vertical-align: top;"> [[File:layout7.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 7 (default)</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br>
Room: Features<br>
Offer: Offer Select (Button/Selector), Availability Calendar]]
[https://beds24.com/booking2.php?propid=13434&layout=2 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout1.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 1</p> <p style="font-weight: bold;">Modules:</p>
Offer: Picture Slider, Description 1 , Calendar, Booking Offer Select (Button/Selector)<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=1 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout2.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 2</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br><br>
Offer: Offer Select (Button/Selector), Price Table<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=2 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout3.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 3</p> <p style="font-weight: bold;">Modules:</p>
Room: Picture Slider, Description<br><br>
Offer: Price Table, Offer Select (Button/Selector), Picture Slider, Description 2<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=3 View Demo]
</li>

</ul></div>

<div><ul>
<li style="display: inline-block; vertical-align: top;"> [[File:layout4.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 4</p> <p style="font-weight: bold;">Modules:</p>
Room Top: Picture Slider<br><br>
Offer: Picture, Description 1 , Calendar, Offer Select (Button/Selector), Description 2<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=4 View Demo]
</li>

<li style="display: inline-block;vertical-align: top;"> [[File:layout5.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 5</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br><br>
Offer: Price Calendar, Offer Select (Button/Selector)<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=5 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout6.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 6</p> <p style="font-weight: bold;">Modules:</p> Property Top: Description 1<br><br>
Offer: Offer Select (Button/Selector), Price Table<br><br>
Room Bottom: Picture Slider, Description]]
[https://beds24.com/booking2.php?propid=13434&layout=6 View Demo]
</li>

</ul></div>

====Layouts====
You can use up to six different layouts at the same time if you want to display different looks on different web sites or blogs.

The Facebook app uses the "default" layout which is set in {{#fas:cog}} (SETTINGS) BOOKING ENGINE.

=== Pictures ===
To upload pictures go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES. Assign them to the property, room or offer where you want to use them.

<embedvideo service="youtube">https://www.youtube.com/watch?v=lXFa0MPO8TU</embedvideo>

=== Set up wizard===
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/wizard/wizard2.php setup wizard] guides you though the customization of your booking page.
=== Customise booking page===
To customise the the booking page go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > LAYOUT.

If you do not want to use multiple layouts leave the selector for "Layout" there and the selector for "Default Layout" in SETTINGS->BOOKING ENGINE and the selector set to 1.
==== Change template====
Choose the template you want to use and then click on "Restore default".
==== Customise modules====
The responsive booking page consists of sections:
"Offer" contains the standard offer for a room or unit.
*One offer will always be shown
*Additional offers (for example for alternative non refundable prices or packages) are optional
*All other sections are optional.
[[Image:sections.jpg|200px|link=]]
[[Media:sections.jpg|view large]]

For each section you can choose from a set of modules. For most modules content needs to be added so they can display. Click on the context help (? icons) to see where you can enter the required content.

Every module has additional settings which allow you to tailor the disply to your requirement. They are available when you click on "Manage".

<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/booking2.php?propid=24226 demo] gives you an overview on the mayor modules.

To remove a module, click 'Position' and select 'not used' from the drop down list.

'''Property modules'''
<gallery>
File:Property_slider.png|<p style=" text-align: center"><strong>Property Slider</strong><br>[[Media:Property_slider.png|view large]]</p>
File:Property_description.png|<p style=" text-align: center"><strong>Property Description</strong><br>[[Media:Property_description.png|view large]]</p>
File:Policies.png|<p style=" text-align: center"><strong>Policies</strong><br>[[Media:Policies.png|view large]]</p>
File:Map.png|<p style=" text-align: center"><strong>Map</strong><br>[[Media:Map.png|view large]]</p>
File:Property_features.png|<p style=" text-align: center"><strong>Features</strong><br>[[Media:Property_features.png|view large]]</p>
</gallery>

*If you use the property slider or property picture and have "Style" set to "Full width" you will need to make sure the slider/pictures position is set to row 1 position 1, desktop full width and mobile full width. There should be no other module in row 1. Also make sure you deactivate all modules which you do not use.
*If you want to show a '''Google Map''' you need to add an Google Map API Key in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER. You can obtain an API key from Google here https://developers.google.com/maps/documentation/javascript/get-api-key. Usually a free key is sufficient. Make sure you activate all required settings.
*The "Policies" module will use display the policies you have entered in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. A link to policies on your web site can be please wherever you can enter descriptive texts. You can set up a "custom question" (Type= Checkbox, Use=Obligatory) in {{#fas:cog}} (SETTINGS) PROPERTIES >-BOOKING QUESTIONS. If required you can add a link for example: "I accept the <a href="http://www.mywebsite.de/agb" target="_blank">terms and conditions </a>." Replace www.mywebsite.de/agb with a link to the terms and conditions on your web site.

'''Room modules'''
<gallery>
File:Room_slider.png|<p style=" text-align: center"><strong>Room Slider</strong><br>[[Media:Room_slider.png|view large]]</p>
File:Room_picture.png|<p style=" text-align: center"><strong>Room Picture</strong><br>[[Media:Room_picture.png|view large]]</p>
File:Room_calendar.png<p style=" text-align: center"><strong>Room Calendar</strong><br>[[Media:Room_calendar.png|view large]]</p>
File:Room_description.png|<p style=" text-align: center"><strong>Room Description</strong><br>[[Media:Room_description.png|view large]]</p>
File:Room_features.png|<p style=" text-align: center"><strong>Features</strong><br>[[Media:Room_features.png|view large]]</p>
</gallery>

'''Offer modules'''
<gallery>
File:Offer_slider.png|<p style=" text-align: center"><strong>Offer Slider</strong><br>[[Media:Offer_slider.png|view large]]</p>
File:Offer_picture.png|<p style=" text-align: center"><strong>Offer Picture</strong><br>[[Media:Offer_picture.png|view large]]</p>
File:Room_calendar.png|<p style=" text-align: center"><strong>Offer Calendar</strong><br>[[Media:Room_calendar.png|view large]]</p>
File:Pricetable.png|<p style=" text-align: center"><strong>Price Table</strong><br>prices will only display if booking of multiple rooms is not allowed<br>[[Media:Pricetable.png|view large]]</p>
File:Pricecalendar.png|<p style=" text-align: center"><strong>Price Calendar </strong><br>prices will only display if booking of multiple rooms is not allowed<br>[[Media:Pricecalendar.png|view large]]</p>
File:Button.png|<p style=" text-align: center"><strong>Offer Select </strong><br>one room<br>[[Media:Button.png|view large]]</p>
File:Select.png|<p style=" text-align: center"><strong>Offer Select</strong><br> multi room booking<br>[[Media:Select.png|view large]]</p>
File:Offer_description.png|<p style=" text-align: center"><strong>Offer Description</strong><br>[[Media:Offer_description.png|view large]]</p>
</gallery>

*The "Marketing Column" displays only in the modules "Price Table" and "Price Calendar". Go to {{#fas:cog}} (SETTINGS) PROPERTIES > OFFERS to enter the content for the modules.
*Offer Calendars and Price Calendars can not be used in the same layout. If you have multiple offers the calendar will show the same availability for all offers.

Modules are placed in rows. Each section can have one or more rows.

Width on desktop and mobile: Each row consists of 12 columns. The number of columns defines the width of the module.

[[Image:Booking_page.png|600px|link=]]
[[Media:Booking_page.png|view large]]

You can save your changes to this layout or under a different layout. The "Restore Default" option will remove all changes.

==== Style colors and fonts ====
To customise colors and fonts go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > STYLE

Current default setting are:

{| class="wikitable"
| '''Setting '''|| '''Value'''
|-
|Body Background ||#f4f4f4
|-
|Content Background ||#f4f4f4
|-
|Content Text ||#424242
|-
|Link Color ||#008acc
|-
|Border Color ||#dfdfdf
|-
|Highlight Background From ||#ffffff
|-
|Highlight Background To ||#ffffff
|-
|Highlight Text ||#424242
|-
|Form Background ||#ffffff
|-
|Form Text ||#424242
|-
|Selected Dates Background ||none
|-
|Selected DatesText ||#222222
|-
|Available Dates Background ||#f2f2f2
|-
|Available Dates Text ||#424242
|-
|Request Dates Background ||#dddddd
|-
|Request Dates Text ||#777777
|-
|Not Available Dates Background ||#f2dede
|-
|Not Available Dates Text ||#a94442
|-
|Button Style ||flat
|-
|Button Background ||#008acc
|-
|Button Text ||#ffffff
|-
|Font ||Arial (Helvetica)
|-
|Font Size ||14px
|-
|}

==== Behaviour ====
Changes on how the booking page opens and closes can be made in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > BEHAVIOUR

== Internationalisation ==
=== Currency converter ===
If you want to give guests the option to see your prices converted into other currencies you can activate a currency converter. Add for example &cur=EUR or &cur=USD to the URL to open the page with the conversion. If you are using Wordpress with a short code add cur=EUR or cur=USD to the short code. Go [[Developers|here]] for a complete list of currency codes.

=== Multiple languages ===
You can set your default language and activate multiple languages. Make sure you enter descriptive texts for all languages you want to use. If you are using an embedded booking page on a multilingual web site you can embed you booking page with a different default language for each language version. Click [[Multilingual_Booking_Page|here]] for instructions.

== Mobiles ==
Every module has additional settings which allow you to tailor the display on mobiles and desktops. They are available in "Layout" when you click on "Manage".

There you can set if a module is shown on mobile devices
*directly
*via a link
*not at all (shown only on desktops)

== Additional options ==
General settings which apply to all layouts like minimum/maximum number of guests, nights, type of price display etc. are in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE.
=== Multiple or single room booking===
You can allow guests to book one room or unit, multiple rooms or units of give the the choice. The setting is available in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE.

=== Allow enquiries when no price is found ===
If you are using rates you can set "Allow Enquiry" = yes. This will allow the guest to send an enquiry if you have availability but the system can not find a price. If you generally want to accept only "Requests" instead of confirmed bookings go to {{#fas:cog}} (SETTINGS) PROPERTIES > RULES and set your "Booking Type" = Request

=== Add a logo to your page ===
* Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES and choose your file and import.
* Scroll to the picture and click 'Manage', scroll to the bottom of the page and copy the URL.
* Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT "Property Description 1"
* Click 'Edit', then find the 'Image' icon and paste the url into the URL box and add a description if necessary, resize as required, click OK. Use the other features to position the image as you required (centre, left, right).
* Click Save.

=== Additional messages and warnings ===
Additional messages can be added to the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE >CONTENT. This is also where you can change the default warning messages which show when a room is not available.

=== Spam Protection ===
You can protect yourself from spam via your booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > BEHAVIOUR.

*Set "On Screen Captcha code" to "Must be Entered" so your guests will have to enter a captcha code to proceed the booking

*Set "Code Sent to Email Address" to "Must be Entered" and your guest will only be able to proceed the booking after they enter a code that has been automatically sent to them.

=== Add a TripAdvisor review widget ===
Tripadvisor provides a code snippet for reviews.

1. Copy the widget code from your TripAdvisor account.

2. Add the code to your booking page

You can add the code snippet into and editable field on the booking page. Click on "Edit" then in the editor on "Source" to insert the code into your booking pages source code.

Make sure the module which you want to use is activated.

=== Triptease price comparison widget===
To use this function you need an account withTriptease. For more information please see [[Triptease.com|here]].

=== Cookie Consent===
You can use a tool like https://cookieconsent.insites.com/download/ to generate a script which you can add in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Advanced HTML Settings"

=== Google Font===
See this [[Google_Font_on_Booking_Page|help page]] for instructions.

=== Add Chat ===
Chat systems provide a script which you can add in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Insert in HTML <HEAD>" to add a chat to a property booking page or {{#fas:cog}} (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE > DEVELOPER "Insert in HTML <HEAD>" to add a chat to the the multi property booking page.

==Use multiple layouts==
You can use up to 6 different layouts at the same time.

The default layout is defined in {{#fas:cog}} (SETTINGS) BOOKING ENGINE

If you want to use multiple layouts you can set the number you want to use them under before you save. To open another than the default layout add a parameter to the URL. Example:

https://beds24.com/booking2.php?propid=13437&layout=2

will display layout 2. If you are using Wordpress you can add a layout parameter to the shortcode as explained in the plugin settings.

The Facebook app uses the "default" layout which is set in SETTINGS-BOOKING PAGE.

== Developer options ==
Advanced functions are available in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER

*If you are comfortable working with CSS you can apply your own styles
*Add scripts e.g. for Google Analytics
*Exchange any fixed text on the booking page

Stripe and Paymill insert their button and can not be changed. To change the text of any of the other payment buttons you can place this code snippet into {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Advanced HTML Settings".

Custom Instruction:
<script type="text/javascript">
$(document).ready(function() { $("#buttoncustominstruction").val("the new text"); });
</script>

Authorize.Net:
<script type="text/javascript">
$(document).ready(function() { $("#buttonauthorizenet").val("the new text"); });
</script>

Paypal
<script type="text/javascript">
$(document).ready(function() { $("#buttonpaypal").val("the new text"); });
</script>

[[:category:Developers |Here]] you can find more developer options.

== Multiple properties ==
If you have multiple properties you can use the multiple property booking page to displays all properties in your account. It links to the property booking page where the actual booking is made.

== Change from adaptive to responsive booking page==
Go to SETTINGS->BOOKING PAGE and select "Booking Page Version" = Responsive. This setting will activate Layout 1.

When you change from adaptive to responsive you need to assign your pictures again. Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES. Set the selector to the room then choose "Offer 1" and activate the picture/pictures you want to display. If you are using more than one offer repeat for each.

<embedvideo service="youtube">https://www.youtube.com/watch?v=UOK8Hs_PnOM</embedvideo>

NOTE: If you select "Booking Page Version" = Responsive your live web site will change to the new design. If you just want to have a look you can do this adding &version=3 to the URL of your booking page. To see the different layouts also add the layout number eg. &version=3&layout=2 will show you layout 2. Alternatively you can copy your property and use the copy for testing. If you do this make sure all channel manager connections are deactivated in the copy property. The normal monthly fee will apply for additional rooms so you might want to reduce the number of rooms in the copy property. When you are finished with the customisation you can use the "Clone Property" function in SUBACCOUNTS (top right menu) to apply the changes to your real property.

Responsive Booking Page

2021-10-13T07:44:43Z

IuriRosa:

File:Booking page.png

2021-10-13T07:43:25Z

IuriRosa:

Responsive Booking Page

2021-10-13T07:42:57Z

IuriRosa:

[[Category:How to]]
[[Category:Booking Page]]
[[Category:Booking Engine]]
<div class="heading">Responsive Booking Page</div>
This page explains how to use and customise the responsive version of the booking page.

==Booking Engine Configuration ==
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/wizard/wizard4.php wizard] guides you though the options you can set for your booking engine.

==Add booking widget to your web site ==
In SETTINGS->BOOKING ENGINE->BOOKING WIDGETS you can choose from a range of widgets

Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > BOOKING WIDGETS > IFRAME GENERATOR to generate the code to embed the booking page into your web site. Use the context help (?icons) for information about the iFrame settings.

== Set up and customise responsive booking page ==

=== Concept===
The design of the responsive booking page is modular allowing you to fully control the layout.

====Modules====
Modules can be added an removed. They have advanced settings so you can tailor the display exactly to your needs. For most modules content needs to be added so they can display. Available modules are:

*Picture slider or gallery for property, rooms and offers
*Picture for property, rooms and offers
*Featues for property and rooms
*Availability calendar (one or multiple month) for for property, rooms and offers
*Pricetable for offers
*Descriptions for property, rooms and offers
*Policies
*Map

====Templates====
We provide a set of default templates with preset modules. You can use these templates as they are or customise them to suit your requirements.

The current default template is 7.

<div><ul>
<li style="display: inline-block; vertical-align: top;"> [[File:layout7.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 7 (default)</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br>
Room: Features<br>
Offer: Offer Select (Button/Selector), Availability Calendar]]
[https://beds24.com/booking2.php?propid=13434&layout=2 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout1.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 1</p> <p style="font-weight: bold;">Modules:</p>
Offer: Picture Slider, Description 1 , Calendar, Booking Offer Select (Button/Selector)<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=1 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout2.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 2</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br><br>
Offer: Offer Select (Button/Selector), Price Table<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=2 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout3.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 3</p> <p style="font-weight: bold;">Modules:</p>
Room: Picture Slider, Description<br><br>
Offer: Price Table, Offer Select (Button/Selector), Picture Slider, Description 2<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=3 View Demo]
</li>

</ul></div>

<div><ul>
<li style="display: inline-block; vertical-align: top;"> [[File:layout4.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 4</p> <p style="font-weight: bold;">Modules:</p>
Room Top: Picture Slider<br><br>
Offer: Picture, Description 1 , Calendar, Offer Select (Button/Selector), Description 2<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=4 View Demo]
</li>

<li style="display: inline-block;vertical-align: top;"> [[File:layout5.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 5</p> <p style="font-weight: bold;">Modules:</p> Property Top: Picture Slider<br><br>
Offer: Price Calendar, Offer Select (Button/Selector)<br><br>
Property Bottom: Description 2]]
[https://beds24.com/booking2.php?propid=13434&layout=5 View Demo]
</li>

<li style="display: inline-block; vertical-align: top;"> [[File:layout6.png|thumb|none|200px|<p style="font-weight: bold; text-align: center">Template 6</p> <p style="font-weight: bold;">Modules:</p> Property Top: Description 1<br><br>
Offer: Offer Select (Button/Selector), Price Table<br><br>
Room Bottom: Picture Slider, Description]]
[https://beds24.com/booking2.php?propid=13434&layout=6 View Demo]
</li>

</ul></div>

====Layouts====
You can use up to six different layouts at the same time if you want to display different looks on different web sites or blogs.

The Facebook app uses the "default" layout which is set in {{#fas:cog}} (SETTINGS) BOOKING ENGINE.

=== Pictures ===
To upload pictures go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES. Assign them to the property, room or offer where you want to use them.

<embedvideo service="youtube">https://www.youtube.com/watch?v=lXFa0MPO8TU</embedvideo>

=== Set up wizard===
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/wizard/wizard2.php setup wizard] guides you though the customization of your booking page.
=== Customise booking page===
To customise the the booking page go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > LAYOUT.

If you do not want to use multiple layouts leave the selector for "Layout" there and the selector for "Default Layout" in SETTINGS->BOOKING ENGINE and the selector set to 1.
==== Change template====
Choose the template you want to use and then click on "Restore default".
==== Customise modules====
The responsive booking page consists of sections:
"Offer" contains the standard offer for a room or unit.
*One offer will always be shown
*Additional offers (for example for alternative non refundable prices or packages) are optional
*All other sections are optional.
[[Image:sections.jpg|200px|link=]]
[[Media:sections.jpg|view large]]

For each section you can choose from a set of modules. For most modules content needs to be added so they can display. Click on the context help (? icons) to see where you can enter the required content.

Every module has additional settings which allow you to tailor the disply to your requirement. They are available when you click on "Manage".

<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> This [https://beds24.com/booking2.php?propid=24226 demo] gives you an overview on the mayor modules.

To remove a module, click 'Position' and select 'not used' from the drop down list.

'''Property modules'''
<gallery>
File:Property_slider.png|<p style=" text-align: center"><strong>Property Slider</strong><br>[[Media:Property_slider.png|view large]]</p>
File:Property_description.png|<p style=" text-align: center"><strong>Property Description</strong><br>[[Media:Property_description.png|view large]]</p>
File:Policies.png|<p style=" text-align: center"><strong>Policies</strong><br>[[Media:Policies.png|view large]]</p>
File:Map.png|<p style=" text-align: center"><strong>Map</strong><br>[[Media:Map.png|view large]]</p>
File:Property_features.png|<p style=" text-align: center"><strong>Features</strong><br>[[Media:Property_features.png|view large]]</p>
</gallery>

*If you use the property slider or property picture and have "Style" set to "Full width" you will need to make sure the slider/pictures position is set to row 1 position 1, desktop full width and mobile full width. There should be no other module in row 1. Also make sure you deactivate all modules which you do not use.
*If you want to show a '''Google Map''' you need to add an Google Map API Key in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER. You can obtain an API key from Google here https://developers.google.com/maps/documentation/javascript/get-api-key. Usually a free key is sufficient. Make sure you activate all required settings.
*The "Policies" module will use display the policies you have entered in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. A link to policies on your web site can be please wherever you can enter descriptive texts. You can set up a "custom question" (Type= Checkbox, Use=Obligatory) in {{#fas:cog}} (SETTINGS) PROPERTIES >-BOOKING QUESTIONS. If required you can add a link for example: "I accept the <a href="http://www.mywebsite.de/agb" target="_blank">terms and conditions </a>." Replace www.mywebsite.de/agb with a link to the terms and conditions on your web site.

'''Room modules'''
<gallery>
File:Room_slider.png|<p style=" text-align: center"><strong>Room Slider</strong><br>[[Media:Room_slider.png|view large]]</p>
File:Room_picture.png|<p style=" text-align: center"><strong>Room Picture</strong><br>[[Media:Room_picture.png|view large]]</p>
File:Room_calendar.png<p style=" text-align: center"><strong>Room Calendar</strong><br>[[Media:Room_calendar.png|view large]]</p>
File:Room_description.png|<p style=" text-align: center"><strong>Room Description</strong><br>[[Media:Room_description.png|view large]]</p>
File:Room_features.png|<p style=" text-align: center"><strong>Features</strong><br>[[Media:Room_features.png|view large]]</p>
</gallery>

'''Offer modules'''
<gallery>
File:Offer_slider.png|<p style=" text-align: center"><strong>Offer Slider</strong><br>[[Media:Offer_slider.png|view large]]</p>
File:Offer_picture.png|<p style=" text-align: center"><strong>Offer Picture</strong><br>[[Media:Offer_picture.png|view large]]</p>
File:Room_calendar.png|<p style=" text-align: center"><strong>Offer Calendar</strong><br>[[Media:Room_calendar.png|view large]]</p>
File:Pricetable.png|<p style=" text-align: center"><strong>Price Table</strong><br>prices will only display if booking of multiple rooms is not allowed<br>[[Media:Pricetable.png|view large]]</p>
File:Pricecalendar.png|<p style=" text-align: center"><strong>Price Calendar </strong><br>prices will only display if booking of multiple rooms is not allowed<br>[[Media:Pricecalendar.png|view large]]</p>
File:Button.png|<p style=" text-align: center"><strong>Offer Select </strong><br>one room<br>[[Media:Button.png|view large]]</p>
File:Select.png|<p style=" text-align: center"><strong>Offer Select</strong><br> multi room booking<br>[[Media:Select.png|view large]]</p>
File:Offer_description.png|<p style=" text-align: center"><strong>Offer Description</strong><br>[[Media:Offer_description.png|view large]]</p>
</gallery>

*The "Marketing Column" displays only in the modules "Price Table" and "Price Calendar". Go to {{#fas:cog}} (SETTINGS) PROPERTIES > OFFERS to enter the content for the modules.
*Offer Calendars and Price Calendars can not be used in the same layout. If you have multiple offers the calendar will show the same availability for all offers.

Modules are placed in rows. Each section can have one or more rows.

Width on desktop and mobile: Each row consists of 12 columns. The number of columns defines the width of the module.

[[Image:row.png|600px|link=]]
[[Media:row.png|view large]]

[[Image:Booking_page.png|600px|link=]]
[[Media:Booking_page.png|view large]]

You can save your changes to this layout or under a different layout. The "Restore Default" option will remove all changes.

==== Style colors and fonts ====
To customise colors and fonts go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > STYLE

Current default setting are:

{| class="wikitable"
| '''Setting '''|| '''Value'''
|-
|Body Background ||#f4f4f4
|-
|Content Background ||#f4f4f4
|-
|Content Text ||#424242
|-
|Link Color ||#008acc
|-
|Border Color ||#dfdfdf
|-
|Highlight Background From ||#ffffff
|-
|Highlight Background To ||#ffffff
|-
|Highlight Text ||#424242
|-
|Form Background ||#ffffff
|-
|Form Text ||#424242
|-
|Selected Dates Background ||none
|-
|Selected DatesText ||#222222
|-
|Available Dates Background ||#f2f2f2
|-
|Available Dates Text ||#424242
|-
|Request Dates Background ||#dddddd
|-
|Request Dates Text ||#777777
|-
|Not Available Dates Background ||#f2dede
|-
|Not Available Dates Text ||#a94442
|-
|Button Style ||flat
|-
|Button Background ||#008acc
|-
|Button Text ||#ffffff
|-
|Font ||Arial (Helvetica)
|-
|Font Size ||14px
|-
|}

==== Behaviour ====
Changes on how the booking page opens and closes can be made in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > BEHAVIOUR

== Internationalisation ==
=== Currency converter ===
If you want to give guests the option to see your prices converted into other currencies you can activate a currency converter. Add for example &cur=EUR or &cur=USD to the URL to open the page with the conversion. If you are using Wordpress with a short code add cur=EUR or cur=USD to the short code. Go [[Developers|here]] for a complete list of currency codes.

=== Multiple languages ===
You can set your default language and activate multiple languages. Make sure you enter descriptive texts for all languages you want to use. If you are using an embedded booking page on a multilingual web site you can embed you booking page with a different default language for each language version. Click [[Multilingual_Booking_Page|here]] for instructions.

== Mobiles ==
Every module has additional settings which allow you to tailor the display on mobiles and desktops. They are available in "Layout" when you click on "Manage".

There you can set if a module is shown on mobile devices
*directly
*via a link
*not at all (shown only on desktops)

== Additional options ==
General settings which apply to all layouts like minimum/maximum number of guests, nights, type of price display etc. are in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE.
=== Multiple or single room booking===
You can allow guests to book one room or unit, multiple rooms or units of give the the choice. The setting is available in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE.

=== Allow enquiries when no price is found ===
If you are using rates you can set "Allow Enquiry" = yes. This will allow the guest to send an enquiry if you have availability but the system can not find a price. If you generally want to accept only "Requests" instead of confirmed bookings go to {{#fas:cog}} (SETTINGS) PROPERTIES > RULES and set your "Booking Type" = Request

=== Add a logo to your page ===
* Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES and choose your file and import.
* Scroll to the picture and click 'Manage', scroll to the bottom of the page and copy the URL.
* Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT "Property Description 1"
* Click 'Edit', then find the 'Image' icon and paste the url into the URL box and add a description if necessary, resize as required, click OK. Use the other features to position the image as you required (centre, left, right).
* Click Save.

=== Additional messages and warnings ===
Additional messages can be added to the booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE >CONTENT. This is also where you can change the default warning messages which show when a room is not available.

=== Spam Protection ===
You can protect yourself from spam via your booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > BEHAVIOUR.

*Set "On Screen Captcha code" to "Must be Entered" so your guests will have to enter a captcha code to proceed the booking

*Set "Code Sent to Email Address" to "Must be Entered" and your guest will only be able to proceed the booking after they enter a code that has been automatically sent to them.

=== Add a TripAdvisor review widget ===
Tripadvisor provides a code snippet for reviews.

1. Copy the widget code from your TripAdvisor account.

2. Add the code to your booking page

You can add the code snippet into and editable field on the booking page. Click on "Edit" then in the editor on "Source" to insert the code into your booking pages source code.

Make sure the module which you want to use is activated.

=== Triptease price comparison widget===
To use this function you need an account withTriptease. For more information please see [[Triptease.com|here]].

=== Cookie Consent===
You can use a tool like https://cookieconsent.insites.com/download/ to generate a script which you can add in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Advanced HTML Settings"

=== Google Font===
See this [[Google_Font_on_Booking_Page|help page]] for instructions.

=== Add Chat ===
Chat systems provide a script which you can add in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Insert in HTML <HEAD>" to add a chat to a property booking page or {{#fas:cog}} (SETTINGS) BOOKING ENGINE > MULTI BOOKING PAGE > DEVELOPER "Insert in HTML <HEAD>" to add a chat to the the multi property booking page.

==Use multiple layouts==
You can use up to 6 different layouts at the same time.

The default layout is defined in {{#fas:cog}} (SETTINGS) BOOKING ENGINE

If you want to use multiple layouts you can set the number you want to use them under before you save. To open another than the default layout add a parameter to the URL. Example:

https://beds24.com/booking2.php?propid=13437&layout=2

will display layout 2. If you are using Wordpress you can add a layout parameter to the shortcode as explained in the plugin settings.

The Facebook app uses the "default" layout which is set in SETTINGS-BOOKING PAGE.

== Developer options ==
Advanced functions are available in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER

*If you are comfortable working with CSS you can apply your own styles
*Add scripts e.g. for Google Analytics
*Exchange any fixed text on the booking page

Stripe and Paymill insert their button and can not be changed. To change the text of any of the other payment buttons you can place this code snippet into {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER "Advanced HTML Settings".

Custom Instruction:
<script type="text/javascript">
$(document).ready(function() { $("#buttoncustominstruction").val("the new text"); });
</script>

Authorize.Net:
<script type="text/javascript">
$(document).ready(function() { $("#buttonauthorizenet").val("the new text"); });
</script>

Paypal
<script type="text/javascript">
$(document).ready(function() { $("#buttonpaypal").val("the new text"); });
</script>

[[:category:Developers |Here]] you can find more developer options.

== Multiple properties ==
If you have multiple properties you can use the multiple property booking page to displays all properties in your account. It links to the property booking page where the actual booking is made.

== Change from adaptive to responsive booking page==
Go to SETTINGS->BOOKING PAGE and select "Booking Page Version" = Responsive. This setting will activate Layout 1.

When you change from adaptive to responsive you need to assign your pictures again. Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES. Set the selector to the room then choose "Offer 1" and activate the picture/pictures you want to display. If you are using more than one offer repeat for each.

<embedvideo service="youtube">https://www.youtube.com/watch?v=UOK8Hs_PnOM</embedvideo>

NOTE: If you select "Booking Page Version" = Responsive your live web site will change to the new design. If you just want to have a look you can do this adding &version=3 to the URL of your booking page. To see the different layouts also add the layout number eg. &version=3&layout=2 will show you layout 2. Alternatively you can copy your property and use the copy for testing. If you do this make sure all channel manager connections are deactivated in the copy property. The normal monthly fee will apply for additional rooms so you might want to reduce the number of rooms in the copy property. When you are finished with the customisation you can use the "Clone Property" function in SUBACCOUNTS (top right menu) to apply the changes to your real property.