Beds24 Wiki - User contributions [en]

Airbnb Mapping

2023-11-14T19:04:10Z

Marco: /* Bookings and Requests */

[[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.

To use the connection you need an [https://www.airbnb.com/e/ten-things-you-should-know-about-airbnb?irgwc=1&irclid=0IZQSnSSRxyNWT%3AQ-OUPCU2lUkAXtgQxDwyFTg0&ircid=4560&c=.pi73.pk4560_252311_en_beds24_10things&sharedid=en_beds24_10things&af=126295512 account with 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 to Airbnb.
*Import bookings and booking modifications or cancellations. (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.)
*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"|Non refundable 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: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"|Check-in start
| Manual
| Manual
| Manual
|-

!style="text-align:right;" scope="row"|Check-in end
| Manual
| Manual
| Manual
|-

!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
|-

|}

<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 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 to use their API. 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 hosts. 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 hosts will then be able to use this button outside of Beds24 so they will not need to log into Beds24 to allow the connection.

=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.

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 "Enquiry". 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 "Enquiry" 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.

[[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'''.

'''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=
After the guest has checked-out, you can send the review to Airbnb via the "Mail & Actions" tab in the booking in Beds24.

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.

=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 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" 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 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 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.

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"=
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_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 =

==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.

==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.

'''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 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

'''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.

Make

2022-08-17T21:14:18Z

Marco: /* Set Up */

[[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" >
=== 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>

Custom CSS

2022-05-13T13:47:27Z

Marco: /* Navigation */

[[Category:Developers]]
[[Category:Widgets]]
[[Category:Booking Page]]
[[Category:Account]]
[[Category:Booking_Engine]]
[[Category:Customise_Control_Panel]]
<div class="heading">Custom CSS</div>
This page gives custom CSS examples which can be used to customize the booking page or the control panel.

__TOC__
= PROPERTY BOOKING PAGE =
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Custom CSS can be added in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE DEVELOPERS > "Custom CSS"

=== Bigger room name ===
<code> .at_roomnametext{font-size: 14px;} /*if you want the text even bigger use a higher number*/</code>

=== Disable clicks on calendar selector===

====Disable month back-and-forth toggle====
<code> .monthcalendarhead{pointer-events: none;}</code>

====Disable clicks on dates====
<code> .roomoffercalendarmonth{pointer-events: none;}</code>

====Disable clicks only on dates not in pointer selection====
<code> .roomoffercalendarmonth .daterequest,
.roomoffercalendarmonth .dateavail {pointer-events: none;}</code>

=== Mark dates when check-out is not allowed (i.e. for rentals on a weekly basis)===
To use this option you will need to set your check-in/check-out rules in the CALENDAR. It will not work for check-in and check-out restrictions only set in rates.

NOTE: Limit the check-in and check-out in the CALENDAR (click on "Override") to use this function.

<code> .datenco{background-color:#f4f4f4; color:#cccccc;}</code>

=== Background Image ===
To use a background image upload it to {{#fas:cog}} (SETTINGS) > BOOKING ENGINE > PICTURES.

Replace '<nowiki>https://beds24.com/pic/p0000/2049/04.jpg</nowiki>' with the url of your uploaded picture.

<code> body{background-image:url(<nowiki>https://beds24.com/pic/p0000/2049/04.jpg</nowiki>);}</code>

=== Shadow around your Booking Page (Adaptive Booking Page only)===
<code>.bookingpage {
webkit-box-shadow:0 1px 2px rgba(0, 10, 10, 0.38);
-moz-box-shadow:0 1px 2px rgba(0, 10, 10, 0.38);
box-shadow: 1px 1px 2px 1px rgba(0, 0, 0, 0.1);
box-shadow: 0 1px 2px rgba(0, 10, 10, 0.38);
margin-bottom: 20px;}</code>

=== Booking Page with rounded corners (Adaptive Booking Page only)===
<code>{border-radius:7px; -webkit-border-radius:7px; -moz-border-radius:7px;}</code>

=== Hide cents===
<code>.bookingpagecents {display:none;}</code>

=== Show prices with cents even if cents are zero ===
<code>.bookingpagecentshide {display:inline;}</code>

=== Mark certain fields in the calendar selector===
You can highlight both the headings of the calendar (i.e. Mon, Tue, Wed, Thu, Fri, Sat, Sun) and all the dates that fall on a given day of the week (i.e. all 4 or 5 dates that fall on a Saturday).

Headings = '.dayMon' (or dayTue, dayWed, dayThu, dayFri, daySat, daySun)

Dates = '.daymon' (or daytue, dayewed, daythu, dayfri, daysat, daysun)

Example 1: Set the font color for the weekday heading of Monday ('Mon')

<code>.dayMon{color:#c44a2f !important;}</code>

Example 2: Set the background color for the weekday heading of Monday ('Mon')

<code>.dayMon{background-color:#c44a2f !important;}</code>

Example 3: Set the font color for all the dates that fall on a Saturday

<code>.daysat{color:#c44a2f !important;}</code>

Example 4: Add a border around all the dates that fall on a Sunday

<code>.daysun{border:1px solid #999999 !important;}</code>

=== Add a border around the selected dates===
<code>.datestay{border: 1px solid #2f2f2f !important;}</code>

<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> If you use split dates the CSS is:
<code>.prevdatestay, .datestay{border: 1px solid #2f2f2f !important;}</code>

=== Line through unavailable dates===
<code>.datenotavail{text-decoration: line-through;}</code>

=== Mark past dates with a different background and text colour===
<code>.datepast{background-color: #xxxxxx; color: #xxxxxx;}</code>

=== Change width of hover image (Adaptive Booking Page only)===
<code>.ui-tooltip{max-width: 500px;}</code>

=== Remove the hover effect on pictures (Adaptive Booking Page only)===
<code>img{pointer-events: none;}</code>

=== Add a label above the room selector for multiple room bookings (Responsive Booking Page only)===
<code>.roomofferqtyselectlabel{display: block;}</code>

=== Hide up button (Responsive Booking Page only)===
<code>footer .button{display: none;}</code>

=== Add icons to descriptive texts (Responsive Booking Page only)===
[https://getbootstrap.com/docs/3.3/components/#glyphicons Bootstrap glyphicons] and [http://fontawesome.io/icons/ Font Awesome icons] can be added to the descriptive fields. To add icons the editor needs to be set to "Source"

Examples:

<code><nowiki><span class="glyphicon glyphicon-user" aria-hidden="true"></span></nowiki></code>

will add a Bootstap icon for a person.

<code><nowiki><i class="fa fa-bicycle" aria-hidden="true"></i></nowiki></code>

will add a Font Awesomeicon for a bicycle.

<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Icons might disappear when the editor is opened again. In this case you will need to enter it again.

If you don not show the "Features" module on the booking page you will need to add

<code><link rel="stylesheet" href="include/font-awesome/fontawesome-pro-5.14.0-web/css/all.min.css"></code>

in the "Head" section in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > DEVELOPER / {{#fas:cog}} (SETTINGS) BOOKING ENGINE > MULTIBOOKING PAGE > DEVELOPER.

=== Hide icons (Responsive Booking Page only)===
<code>.b24fa{display:none;}</code>

<code>#b24scroller .input-group-addon{display:none;}</code>

=== Change text color of language selector and currency selector (Responsive Booking Page only)===
<code>.b24languagedropdown .btn, .b24languagedropdown .btn.active, .b24languagedropdown .btn:active, .b24currencydropdown .btn, .b24currencydropdown .btn.active, .b24currencydropdown.btn:active {color:#fff;}</code>

=== Make language selector and currency selector a button (Responsive Booking Page only)===
<code>.b24languagedropdown .btn, .b24languagedropdown .btn.active, .b24languagedropdown .btn:active, .b24currencydropdown .btn, .b24currencydropdown .btn.active, .b24currencydropdown.btn:active {background:white; padding:10px;}</code>

=== Hide currencies from the currency selector (Responsive Booking Page only) ===
The currency class format is: '''.cur-XXX'''.

'''cur''' is the name of the class and '''XXX''' represents a country code: '''CAD''' = Canadian Dollars, '''GBP''' = British Pounds and so on.
The country codes are:
AUD, BHD, CAD, CLP, CRC, EUR, FJD, GBP, GEL, ILS, ISK, NZD, USD, BGN, BRL, CHF, CNY, CZK, DKK, HKD, HRK, HUF, HUF, IDR, INR, JPY, KRW, LBP, LKR, MAD, MMK, MXN, MYR, NOK, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

This code will remove all currencies except for Euros, Swiss Francs and US Dollars:
<code>.cur-AUD,.cur-BHD,.cur-CAD,.cur-CLP,.cur-CRC,.cur-FJD,.cur-GBP,.cur-GEL,.cur-ILS,.cur-ISK,.cur-NZD,.cur-BGN,.cur-BRL,.cur-CNY,.cur-CZK,.cur-DKK,.cur-HKD,.cur-HRK,.cur-HUF,.cur-HUF,.cur-IDR,.cur-INR,.cur-JPY,.cur-KRW,.cur-LBP,.cur-MAD,.cur-MMK,.cur-MXN,.cur-MYR,.cur-NOK,.cur-PHP,.cur-PLN,.cur-RON,.cur-RUB,.cur-SEK,.cur-SGD,.cur-THB,.cur-TRY,.cur-ZAR{display: none;}</code>

=== Remove 0 from adults or guests selector ===
<code>#inputnumadult option[value="0"] {display:none !important;}</code>

=== Limit quantity selectors for upsell items ===
By default all the quantity selectors have a range from 0 - 250. You can limit the range:

Example 1: Set the range of the optional quantity selector for your 2nd upsell item (set 'Per Booking') to 0-4:

<code>#optextra2 option:nth-child(n+6){display:none;}</code>

Example 2: Set the range of the optional quantity selector for your 5th upsell item (set 'Per Room/Person/Adult/Child') to 0-20:

<code>#optextraroom5 option:nth-child(n+22){display:none;}</code>

=== Hide Check-in / Check-out selector ===
<code>.b24-selector-checkin{display:none;}</code>

<code>.b24-selector-checkout{display:none;}</code>

=== Hide number of nights selector ===
<code>.b24-selector-numnight{display:none;}</code>

=== Change height of full-width slider ===
<code>.fullwidthjumbopropslider .b24fullcontainer-proprow1 .b24-prop-slider .item {height: 500px;}</code>

<code>.fullwidthjumbopropslider .b24fullcontainer-proprow1 .b24-prop-slider .carousel.slide{ height: 500px !important;}</code>

=== Hide the offer description on the check-out page===
<code>.at_offersummary {display: none;}</code>

=== Show number of nights on mobiles===
<code>.b24-selector-numnight { display: inline-block !important; }</code>

=== Hide room picture on check-out page===
<code>.b24-guest-details-right img {display: none;}</code>

=== Hide option to collect credit cards from Booking page if you want to use this option only for requests via Email===
<code>.bp2bookcollectpayment .panel-pay-card{display:none;}</code>

=== Adjust alignment for RTL languages (Arabic, Hebrew)===
<code>.rtlinject{
float: right;
}
.colorbody-he, .colorbody-he #bookingpage,
.colorbody-ar, .colorbody-ar #bookingpage {
text-align: right;
}
.colorbody-he .ssi_makeabooking, .colorbody-he .panel .fakelink,
.colorbody-ar .ssi_makeabooking, .colorbody-ar .panel .fakelink{
text-align: left;
}
.colorbody-he .datepicker, .colorbody-he .roomoffercalendarmonth td, .colorbody-he .ssi_makeabooking .colorbody-he .b24-guest-details-left, .colorbody-he .b24-guest-details-left.propconfirmbookmessage, .colorbody-he .b24-creditcard, .colorbody-he .b24-guest-details-left,
.colorbody-ar .datepicker, .colorbody-ar .roomoffercalendarmonth td, .colorbody-ar .ssi_makeabooking .colorbody-ar .b24-guest-details-left, .colorbody-ar .b24-creditcard, .colorbody-ar .b24-guest-details-left.propconfirmbookmessage, .colorbody-ar .b24-guest-details-left {
float: right;
}
.colorbody-he .book_bookingbackright, .colorbody-he .b24-guest-details-right, .colorbody-he .questionrow div:first-child, .colorbody-he .book_securelogo, .colorbody-he .ppcancelbutton,
.colorbody-ar .book_bookingbackright, .colorbody-ar .b24-guest-details-right, .colorbody-ar .questionrow div:first-child, .colorbody-ar .book_securelogo, .colorbody-ar .ppcancelbutton{
float: left;
}
.colorbody-he .at_offersummary ul,
.colorbody-ar .at_offersummary ul{
padding-right: 0;
}
.colorbody-he .booktextdiv,
.colorbody-ar .booktextdiv{
width: 100%;
}
.colorbody-he .b24-offer-cal , .colorbody-he .b24-offer-summary, .colorbody-he .b24-offer-slider {
float: right;
}
</code>

=== Change colors of warnings===
<code>.alert-danger {
color: #7e7602;
background-color: #fcf8bd;
border-color: #fcf8bd;
}
</code>

= MULTI PROPERTY BOOKING PAGE =
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Custom CSS can be added in {{#fas:cog}} (SETTINGS) > BOOKING PAGE > MULTI BOOKING PAGE > DEVELOPERS > "Custom CSS"

=== Make search criteria always visible ===

<code>#collapseAdvancedSearch{height: auto; display:block !important;}</code>

<code>.b24-agencysearchlink{display:none;}</code>

=== Change height of full-width slider ===
<code>.fullwidthjumboagencyslider .b24fullcontainer-ownerrow1 .b24-owner-slider .item {height: 600px;}</code>

<code>.fullwidthjumboagencyslider .b24fullcontainer-ownerrow1 .b24-owner-slider .carousel.slide{height: 500px !important;}</code>

=== Limit the drop-down list for number of guests ===
By default this list goes up to 99. You can limit it with the following code. Substitute X for the desired number + 2. So, if you want the drop-down list to be limited to 10 then X=12.

<code>#inputnumadult option:nth-child(n+6){display:none;}</code>

<code>#inputnumchild option:nth-child(n+6){display:none;}</code>

=== Adjust alignment for RTL languages (Arabic, Hebrew)===
<code>.rtlinject{
float: right;}
.colorbody-he,
.colorbody-ar {
text-align: right;}
.colorbody-he .b24-prop-module,
.colorbody-he .datepicker, .
colorbody-he .roomoffercalendarmonth td,
.colorbody-ar .datepicker, .
colorbody-ar .roomoffercalendarmonth td{
float: right;}
.colorbody-he .at_propnametext,
.colorbody-ar .at_propnametext {
padding-right: 10px;
}
</code>

= BOOKING WIDGETS =
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> CSS needs to be added directly in your web site

===Change the hover-color in the datepicker calendar ===

<code>.book-widget .ui-datepicker td .ui-state-active, .book-widget .ui-datepicker td .ui-state-hover, .book-widget.ui-datepicker td .ui-state-active, .book-widget.ui-datepicker td .ui-state-hover {background-color:#ffffff!important; color:#000000!important}</code>

===Make only Saturdays clickable in the datepicker calendar ===
<code>.book-widget .ui-datepicker tr > :nth-child(1), .book-widget .ui-datepicker tr > :nth-child(2), .book-widget .ui-datepicker tr > :nth-child(3), .book-widget .ui-datepicker tr > :nth-child(4), .book-widget .ui-datepicker tr > :nth-child(5), .book-widget. ui-datepicker tr > :nth-child(7){pointer-events: none;}</code>

= INVOICES and PRINT TEMPLATES =
Custom CSS can be added in {{#fas:cog}} (SETTINGS) > GUEST MANAGEMENT > STYLING > "Custom CSS"

=== Center invoice on the screen and set overall font size===
<code>body {text-align: center; font-size: 16px;}</code>

=== Set font size of property name ===
<code>#invoicepropname{font-size: 24px;}</code>

=== Set font size of address ===
<code>#invoiceaddress{font-size: 18px; padding-bottom: 50px;}</code>

=== Set font size of the invoice table ===
<code>.confirmationtable{font-size: 16px;}</code>

=== Change margin===
<code>.printbooking2 {margin: 20px;}</code>

=== TBC ===
<code>#invoicetable{margin-left:auto; margin-right:auto;}</code>

=== TBC ===
<code>#invoiceprinttime{font-size: 12px;}</code>

=== Hide edit button in the invoice ===
<code>#iconedit {display: none;}</code>

= CONTROL PANEL =
Custom CSS can be added in:
*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) then on ACCOUNT LIST to apply for all sub accounts
*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) then on ACCOUNT LIST > MANAGE ACCOUNT to apply for a specific sub account

==Navigation==
===Hide SUPPORT button===
<code>.navbar-top .btngroupdropdown{display: none}</code>

===Hide page help icon on the right===
<code>.opener-right{display: none}</code>

===Change header background color===
<code>.fixed-top {background-color: #cccccc;}</code>

===Hide "Settings" icon in left column===
<code>.#c3sidebarCollapse{display: none !important;} {display: none;}</code>

===Hide "Price Checker Tool" button===
<code>.b24btn_PriceCheck {display: none}</code>

===Hide "Try the new calendar" link===
<code>.tryTheNewCalendar {display: none;}</code>

== Dynamic Multi-Calendar ==
===Hide "Intelligence" icon===
<code>.sticky-left .row-intelligence-button{display: none;}</code>
===Hide "Help" icon in left column===
<code>.sticky-left .row-help-button {display: none;}</code>
===Hide "Notes" icon in left column===
<code>.sticky-left .fa-comment-alt-plus, .sticky-left .fa-comment-alt-lines {display: none;}</code>
===Display occupancy as color instead of number===
<code>.calendar2 .property-stats-wrapper
{margin-top: 5px;}
.calendar2 .property-stats-wrapper.empty {
display: inline-block;
background-color: #7AAB0A;
height: 10px;
width: 10px;
border-radius: 50%;
color: transparent;
}
.calendar2 .property-stats-wrapper.medium {
display: inline-block;
background-color: #fe746c;
height: 10px;
width: 10px;
border-radius: 50%;
color: transparent;
}</code>
===Change the backgound color of weekends (Saturday/Sunday)===
<code>.th-sat, .th-sun {background-color:#ffceaf !important;}</code>
===Change the backgound color of past dates===
<code>.pastdate{background-color:#d7d7d7;}</code>
===Hide Intelligence button===
<code>.sticky-left .row-intelligence-button{display: none;}</code>
===Hide contect help===
<code>.sticky-left .row-help-button {display: none;}</code>
===Change color of unavailable dates ===
<code>.inv0 { color: red }</code>
===Change color and background color of daily prices===
<code>.price { background-color:#7cc576; color:white;}</code>
===Make inventory row read-only===
<code>.calendar2 .row-room {
pointer-events: none;
}</code>

===Make Daily Price row read-only===
<code>.row-price{
pointer-events: none;
}</code>

===Disable the option to create or change views===
<code>#view-templates-button{
pointer-events: none;
}</code>

== Old Calendar ==
===Hide "Show" in the CALENDAR===
<code>.dashgridshowfilter {display:none;}</code>

===Hide "Override row" in the CALENDAR===
<code>.dashgrid_rowtype1{display:none;}</code>

===Hide item from dropdown for rooms in the CALENDAR===
<code>.dashgrid_rowroomname .dropdown ul.dropdown-menu li:nth-child(3) {display:none !important;}</code>

===Hide suitcase icon (add booking) from CALENDAR===
<code>.icon-suitcase {display:none}</code>

===Hide button 'Add Booking' from CALENDAR===
<code>.b24btn_AddBooking{display:none}</code>

===Display red when inventory is 0===
<code>.inv0 .dashgrid_inventory{color:red;}</code>

===Show weekends (Saturday/Sunday) in a different color===
<code>.weekend2{background-color:red;}</code>

===Show a certain day of the week in red===
Substitute X with the number of the weekday: Monday=1, Tuesday=2, Wednesday=3, Thursday=4, Friday=5, Saturday=6, Sunday=7
<code>.caldayX{background-color:red;}</code>

===Show today in red===
<code>.todaydate{background-color:red;}</code>

===Show past dates in a different color===
<code>.pastdate{background-color:grey;}</code>

===Display room name and icons in one line===
<code>.dashgrid_rowroomname{display:inline;}</code>

<code>.editroomlink{padding-left: 2px;}</code>

===Warning color dates not selling===
<code> .dashgrid_inventory_nap{background-color: red; color: white;}</code>

== Dashboard ==
===Hide the Dashboard selector (drop-down menu) from DASHBOARD===
<code>.dashcontrol #dashid{display: none !important}</code>

===Hide the "Padlock" menu from DASHBOARD===
<code>.dashcontrol .dropdown{display: none !important}</code>

=== Hide a certain column in the Departures Table on the DASHBOARD===
<code>.mobiledeparture tr > *:nth-child(X) {display: none;}</code>

===Hide the "Add Booking" from mobile DASHBOARD===
<code>.mobiledashaddbooking{display:none;}</code>

===Hide room on Housekeeping Units and Housekeeping Bookings modules====

.widgettype-units .roomrowclassXXX {display: none;} /* replace XXX with the room ID*/

===Hide column on the dashboard tables===
Change the child number in brackets to the desired column.

<code>.dashboardtable th:nth-child(9) {display:none;}</code>

==Align the content of a column right==
<code> .bookingtable td:nth-child(8) {text-align: right;} </code>

== Guests Menu ==

=== Hide a certain row in the "Info" tab on GUESTS===
<code>.pagetypeguests .viewguest .table tr:nth-child(x) {display: none; }</code>

== Bookings Menu ==
=== Hide property name in the BOOKING GRID ===
<code>.bookgrid_rowpropname{display: none;}</code>

=== Hide room name in the BOOKING GRID ===
<code>.bookgrid_rowroomname{display: none;}</code>

=== Hide a certain column in the BOOKING LIST Table ===
<code>.pagetypebookingslist .bookingtable tr > *:nth-child(X) {display: none;}</code>

Examples:

<code>.pagetypebookingslist .bookingtable tr > *:nth-child(1) {display: none;}</code> will hide the first column which is 'Number'.

<code>.pagetypebookingslist .bookingtable tr > *:nth-child(10) {display: none;}</code> will hide the tenth column which is 'Email'.

===Hide column on the BOOKINGS table===
Change the child number in brackets to the desired column.

<code> .bookingtable th:nth-child(12) {display:none;} </code>

=== Hide cancelled bookings in the BOOKINGS Table ===
<code>.bookingtable .cancelbooking {display:none;}</code>

=== Hide "Export" button ===
<code>.b24btn_ExportBookings {display:none;}</code>

===Disable moving of bookings===
<code> .pagetypebookingsgrid table {pointer-events: none;}</code>

== Rates Menu ==
===Hide column on the rates table===
Change the child number in brackets to the desired column.

<code> .ratetable th:nth-child(9) {display:none;} </code>

== Reports Menu ==
=== Limit selector list for custom reports ===

Example: Limit the list to reports 1 - 3:

<code>#reportid option:nth-child(n+4){display:none;}</code>

=== Hide a certain field from 'Available Columns' ===

Example: Hide the 'Email' field

<code>.pagetypereports2 #guestemail {display: none;}</code>

== Settings Menu ==
=== Hide the "Delete" button for properties ===
<code>.pagetypeproperties .b24btn_delete{display:none;}</code>

==Booking Popup==
===Hide 'Open in new Window' link===
<code>.pagetypeajaxbookedit.openinnewwindow{display:none;}</code>

=== Charges & Payments ===
====Hide the VAT column====
<code>.pagetypeajaxbookedit .invoicetablevat {display: none;}</code>

Please note: This will not hide the title column (Vat %). See for yourself if you can live with it.

====Prevent manual entry of charge items ====
<code>.chargenewitemtr input {pointer-events: none;}</code>

====Prevent manual entry of payment items ====
<code>.paymentnewitemtr input {pointer-events: none;}</code>

=== Functions and Buttons ===
====Hide the checkout selector====
<code>.pagetypeajaxbookedit #checkout{display:none;}</code>

====Hide the 'Delete' button====
<code>.pagetypeajaxbookedit .deletebookingbutton{display:none;}</code>

====Hide the 'Add Booking' button====
<code>.icon-suitcase, .b24btn_AddBooking{display:none;}</code>

====Hide the 'Copy as new' button====
<code>.pagetypeajaxbookedit #bookingcopyasnewbutton{display:none;}</code>

====Hide the 'Print' button====
<code>.pagetypeajaxbookedit #bookingprintbutton{display:none;}</code>

====Hide the 'Assign Invoice Number' button====
<code>.pagetypeajaxbookedit .b24btn_AssignInvoiceNumber{display:none;}</code>

German control panel:

<code>.pagetypeajaxbookedit .b24btn_Rechnungsnummererzeugen{display:none;}</code>

====Hide the 'Template' buttons====
<code>.pagetypeajaxbookedit #bookingtemplate1button{display:none;}</code>

<code>.pagetypeajaxbookedit #bookingtemplate2button{display:none;}</code>

<code>.pagetypeajaxbookedit #bookingtemplate3button{display:none;}</code>

====Hide the 'Continue anyway' buttons====
<code>.statusmsg .btn{display: none}</code>

====Prevent changes of the "Status" field"====
.menusetting-status{pointer-events: none;}

=== Hide Specific Fields ===
====TAB Summary====

Guest title

<code>.pagetypeajaxbookedit .menusetting-guesttitle{display:none;}</code>

Last Name

<code>.pagetypeajaxbookedit .menusetting-guestname{display:none;}</code>

Guest comments

<code>.pagetypeajaxbookedit .menusetting-guestcomments{display:none;}</code>

Notes

<code>.pagetypeajaxbookedit .menusetting-hostcomments{display:none;}</code>

Adults

<code>.pagetypeajaxbookedit .menusetting-numadults{display:none;}</code>

Children

<code>.pagetypeajaxbookedit .menusetting-numchild{display:none;}</code>

Telephone

<code>.pagetypeajaxbookedit .menusetting-guestphone{display:none;}</code>

Mobile

<code>.pagetypeajaxbookedit .menusetting-guestmobile{display:none;}</code>

Fax

<code>.pagetypeajaxbookedit .menusetting-guestfax{display:none;}</code>

Address

<code>.pagetypeajaxbookedit .menusetting-guestaddress{display:none;}</code>

City

<code>.pagetypeajaxbookedit .menusetting-guestcity{display:none;}</code>

Postcode

<code>.pagetypeajaxbookedit .menusetting-guestpostcode{display:none;}</code>

Country (manual entry)

<code>.pagetypeajaxbookedit .menusetting-guestcountry{display:none;}</code>

Country (drop-down list)

<code>.pagetypeajaxbookedit .menusetting-guestcountry2{display:none;}</code>

Status

<code>.pagetypeajaxbookedit .menusetting-status{display:none;}</code>

Room Selector
<code>.pagetypeajaxbookedit .menusetting-roomid{display:none;}</code>

====TAB Detail====
Message

<code>.pagetypeajaxbookedit .menusetting-hostmessage{display:none;}</code>

Custom Questions (X = number of custom question)

<code>.pagetypeajaxbookedit .menusetting-guestcustqX{display:none;}</code>

Reference

<code>.pagetypeajaxbookedit .menusetting-ownerreference{display:none;}</code>

Quantity

<code>.pagetypeajaxbookedit .menusetting-qty{display:none;}</code>

Cancellable

<code>.pagetypeajaxbookedit .menusetting-stopcancel{display:none;}</code>

Flag

<code>.pagetypeajaxbookedit .menusetting-flagtext{display:none;}</code>

Status Code

<code>.pagetypeajaxbookedit .menusetting-statuscode{display:none;}</code>

Created in Account

<code>.pagetypeajaxbookedit .menusetting-Createdinaccount{display:none;}</code>

Original Referrer

<code>.pagetypeajaxbookedit .menusetting-OriginalReferrer{display:none;}</code>

Time Entered

<code>.pagetypeajaxbookedit .menusetting-TimeEntered{display:none;}</code>

IP Address

<code>.pagetypeajaxbookedit .menusetting-IPAddress{display:none;}</code>

API Message

<code>.pagetypeajaxbookedit .menusetting-apimessage{display:none;}</code>

Guest Database

<code>.pagetypeajaxbookedit .menusetting-isguest{display:none;}</code>

====TAB Mail & Actions====
Email

<code>.pagetypeajaxbookedit .menusetting-guestemail{display:none;}</code>

==Add Booking==
====Prevent price to be changed====
<code>..pagetypeajaxbookedit .menusetting-unitprice, .pagetypeajaxbookedit .menusetting-price { pointer-events: none;}</code>

==Reports ==
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Custom CSS can be added in {{#fas:cog}} (SETTINGS) > GUEST MANAGEMENT > STYLING > "Custom CSS"

=== Hide a the "Booking Notes" column in the Daily Unit Activity report===
<code>.reportdailyunitactivity th > *:nth-child(9) {display: none;}</code>

<code>.reportdailyunitactivity td > *:nth-child(9) {display: none;}</code>

== Miscellaneous ==

===Change the blue Login button on the initial Beds24 page (resellers only)===
<code>.pagetypelogin .b24btn_Login{background-color:#xxxxxx;}</code>

=== Hide the "Make a Charge using Stripe" button ===
<code>#makechargeusing{display:none;}</code>

=== Hide potential issue "Less than 12 months available"===
<code>.warninglessthan12monthsavailable{ display: none}</code>

=== Hide 'Template 2' from Guest Management > Booking Templates ===
<code>.pagetypecommunicationbooktemplate #settingformid .background_boxprop:nth-of-type(2){display:none;}</code>

=== Hide the option to unlock invoices===
<code>.menusetting-invoicelock {display:none;}</code>

Google Hotel Ads & Google for Vacation Rentals

2022-03-30T15:38:26Z

Marco: /* Matching for Free Booking Links and Bidding */

[[Category:Channel Manager]]
[[Category:Google]]
[[Category:Troubleshooting]]
<div class="heading">Google Hotel Ads & Google for Vacation Rentals</div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > GOOGLE ADS and explains the interface with Google works and how to connect.

=Receive direct bookings from Google=
As official Google partner Beds24 can distribute your direct rates and inventory to Google.

*You get a direct connection to Google with the best rate coverage and real time prices 
*Display your direct rates and availability on Google Search and Maps 

Depending on the type of property you can either use Google Hotel Ads or Google for Vacation Rentals.

=For Vacation Rental Properties: Commission free bookings from Google for Vacation Rentals=
==What is Google for Vacation Rentals and how does it work ==
Google will create a vacation rental listing from the pictures (minimum requirement is 8 pictures), prices and availability and descriptions, sent from Beds24 with a direct booking link to your Beds24 booking page.

Google will display your property and live prices and availability if they meet the guests search criteria and the guest can then book directly on the Beds24 booking page.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Google does not charge and commission for bookings make via Google for Vacation Rentals.

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

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

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

==Google for Vacation Rentals Setup==
'''Step 1: Select Google for Vacation Rentals'''

Set Google Product to
*"Google for Vacation Rentals (List Rooms)" if you want to send the room content to Google or if you have multiple rooms in a property and want to connect more than one room. With this setting the names from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DESCRIPTION and the room pictures will send. If you do not have room pictures the offer pictures will send. If you do not have room pictures or offer pictures the property pictures will send.
*"Google for Vacation Property (List Property)". With this setting the name, description and pictures from the property will send.

'''Step 2: Make sure you have enough pictures '''

Google requires a minimum of 8 pictures.

Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES and double check that you have uploaded and activated at least eight pictures.

Please note that Google sometimes selects the images randomly and displays them in random order instead of the position you selected in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES

'''Step 3: Make sure your information in Beds24 is complete '''

If required update your property information in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION:
*Property Name
*City
*State
*Postcode
*Address - if you have multiple properties Google expects a different address for each property.
*Country
*Latitude 'Latitude' and 'Longitude' have to reflect the actual location of your property.

Google will not accept data which does not contain all of the above information.

Click on 'View Mapping Data' to check what will send. If what you see there is not complete go back to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

'''Step 4: Allow Beds24 to send your data'''

Google for Vacation Rentals listings are per property. Only one room per property can connect.

Set 'Synchronise' = Enable to the room you want to connect so Google can verify your content.

'''Step 5: Check your landing page'''

Make sure your landing page is provides meaningful information so guests will be confident to make a booking (see below).

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It can take Google up to 14days to verify your property. Once they have verified your property they will show it when it matches the guests search criteria.

=For hotels, B&Bs, guest houses and other hotel type properties: Google Hotel Ads=
==What is Google Hotel Ads? ==
Google Hotel Ads allows you to showcase your hotel via adverts across desktops, tablets, and mobile devices on Google.
== Who can use Google Hotel Ads ==
Google Hotel Ads is only available to hotels ad hotel type properties. Vacation rental properties can not use Google hotel ads. Googles guidelines are that the property should have all the following:
*Rooms in which paying guests can stay
*A physical presence and fixed location that is open to the public
*A staffed front desk open during normal business hours
*A minimum stay requirement of no greater than 7 days
*A "Google Profile" listing
*Google Hotel Ads is a hotel platform and does not respect minimum stay restrictions. Google checks for a one night stay on each date, if they do not find availability for one night they usually assume the date is closed and do not check any further including for stays of 2 or more days. Google prioritizes also properties which have availability in the near future.

<div class="warning">{{#fas:exclamation-triangle}} Beds24 has to be the booking engine used on your web site. If you use a different booking engine than Beds24 on your web site Google does not allow you to use Google Hotel Ads via Beds24.</div>

==Free Hotel Booking Links==
Free booking links appear on the hotel booking module alongside hotel ads when travelers look for rooms at a given hotel.

[[Image:Free_Hotel_Booking_Links.gif|450px|link=]]
[[Media:Free_Hotel_Booking_Links.gif|click to see an example]]

==Bidding ==
Certified Google Hotel Ads Integration Partners like Beds24 bid a commission on your behalf. Google will display the highest and the next highest bidder directly in the ad. The four next highest bidders will be shown after the guest clicks on "More".

If your commission bid is competitive, Google will provide a link to your direct booking page in their search results.

You only pay commission for confirmed bookings resulting from the search result, not pay per click etc.

[[Image:google_hotel_ads.png|250px|link=]]
[[Media:google_hotel_ads.png|view large]]

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> An important part of your marketing strategy on Google is to make sure that your property has a well maintained profile on Google, with pictures, descriptions, etc.

==Google Hotels Ads Setup ==
=== Matching for Free Booking Links and Bidding ===
Before using the service Google must match your property with the information they already have.

This process may take Google a few weeks to complete.

'''Step 1: Update your Business Profile on Google '''

Make sure your Google "MyBusiness profile" is verified and up to date with your hotel information. Google provides instructions on their site to help you get started.

'''Step 2: Make sure your information in Beds24 is the same as on your Business Profile on Google '''

Click on 'View Mapping Data'. Also open your Google Business listing and check that this information matches exactly the information in your Google business listing. If you do not yet have one set one up.

If required update your property information in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION:
*Property Name
*City
*State
*Postcode
*Address - if you have multiple properties Google expects a different address for each property.
*Country
*Phone Number - if you have multiple properties Google expects a unique phone number for each property.
*Latitude 'Latitude' and 'Longitude' have to reflect the actual location of your property.

Google will not accept data which does not contain all of the above information.

This information needs to match exactly the information in your "MyBusiness profile" '''

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have multiple properties Google expects a unique address and phone number for each. You can not use the same address and phone number for more than one property.

*If you want Google to show that the booking is cancellable check that you have allowed cancellations in {{#fas:cog}} (SETTINGS) PROPERTIES > BOOKING RULES and {{#fas:cog}} (SETTINGS) PROPERTIES > OFFERS

'''Step 3: Allow Beds24 to send your data'''

*Set Google Product = Google Hotel Ads.
*Set 'Synchronise' = Enable so Google can read your data and match you.

'''Step 4: Check your landing page'''

Make sure your landing page is provides meaningful information so guests will be confident to make a booking (see below).

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It can take Google up do 2 weeks to match your hotel. When you click on "Performance Report" you can check if your links are shown and how they perform. If the report is empty click on "View Mapping Data" to see why Google did not match you. Fix the issues and then check again after 10-14 days.

Once Google has matched you we can send your bid. To bid you will need to have enough credit in your Beds24 account. We recommend maintaining enough credit to cover the largest expected commission and setting up auto payments in {{#fas:cog}} (SETTINGS) ACCOUNT > BILLING. When you do not have enough credit in your account all ads may be turned off.

The rooms you are bidding Google should be your most economic double or twin rooms and have sell priority in{{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS SETUP set to highest so it is at the top of the booking page. '''Dorms are not allowed.'''

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Google Ad does not support multiple room types. They will only show one room type make sure you use your best value room types to compete.

===Deposit Collection ===
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > GOOGLE ADS there you can set options for deposit collection
*“Default” uses the “Booking Type” set in {{#fas:cog}} (SETTINGS) PROPERTIES > BOOKING RULES
*“Instant Deposit Collected” hides payment options (offline payments, credit card number collection) which do not send an instant payment notification to Beds24 on collection of funds.
*“Deposit Collection” allows all deposit collection types you have enabled for bookings from Google without affecting your normal booking rule for non Google bookings.

Deposit collection options can be setup at {{#fas:cog}} (SETTINGS) > PAYMENTS.

===Set bid ===
1. Choose a group of rooms

2. Set the maximum commission you are prepared to pay for bookings direct from Google hotel ads.

3. Under "Commission Due" you can choose if the commission is due at the time of the booking or when the guest has completed the stay.

4. The Maximum allowed booking value will show the total value of bookings allowed for your account at the selected Bidding level. If this is too low, you can raise it by adding funds to your Beds24 account.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Commission bids can be changed but every time you change the commission your property will go offline for a few hours.

It is not always possible for us to bid at every level so your actual bid may be lower than your bid setting, in this case, you will be charged the lower bid commission. Your bid will not be higher than your bid setting.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Changes to bidding commissions can take some time to propagate through to Google, bookings with commission at the old bid level are possible until the change fully propagates.

=== Commission ===
Commission payments to Google are made by Beds24, you are not required to pay Google directly.
*Commission is charged on completed bookings originating from the advertisement even if the guests books directly at a later point of time.
*If deposit collection is used, the commission is only charged after the deposit collection completes.
*If required, currency conversion will be done at market rates at the time of booking to calculate the commission in your account currency rather than booking currency.
*If you are based in Germany or the EU and have not provided us with a valid EU Vat Id, the commissions will effectively contain VAT at your countries local rate.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have set "Commission Due" = "On Booking" Google will l charge their commission even if the guest cancels a booking or does not show up. We recommend you use deposit collection at the time of booking and appropriate cancellation policies.

=Price sent to Google=
After Google has matched you we can send prices to Google.

The price sent to Google is the lowest price for 2 people from offer one and offer 2 from your direct booking prices. A 2 person price is compulsory. If no 2 person price is supplied the room will send as unavailable.

Prices for 1, 3, 4 , 6 and 8 guests will also be sent if they are defined.

Discounts set in the "Discounts" tab of rates will not send.

If you have set a multiplier percentage for the Google bookings, the price will be adjusted by this amount.

If you have compulsory taxes or fees, these will be sent in addition to the price to create the effective end price.

Guests coming from Google will be shown this price by Google and expect to pay the same price on your booking page.

'''Multiplier'''

You can set a multiplier to adjust the prices sent to Google if required. The multiplier only works on the room price not on the fees and upsell items.

=Landing page =
The Beds24 booking page is opened when a guest click to book on Google.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The conversion rate depends largely on the quality of your landing page.

You have the option to set up a dedicated layout which is used as landing page for Google.
The default template 7 is a good starting template which already contains a map.
[[Responsive_Booking_Page|This help explain how to set up and customise your layout]].

Click on "Landing Page" to check that your landing page is suitable as your landing page and contains all information a guest booking your lodging might want to see:
*Provide your logo or at least your property name
*Show at least one high quality picture for each room
*If you use a header picture or slider make sure it is not too high so that at least the first room displays without scrolling

You might consider adding the following information:
*Contact details
*Address
*Google map

The Google Ad will be shown in all languages allowed on your booking page.

You have the option to add URL parameters for the landing page in the "URL additions" fields. Only add the additional parameters do not enter your full booking page URL, for example if you add &roomid=9999, then only room 9999 will be included in your URL. For a list of available parameter please see [https://wiki.beds24.com/index.php/Category:Developers#Booking_Page_Parameters here].

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Make sure you activate all languages that you accept bookings for, in {{#fas:cog}} (SETTINGS) BOOKING PAGE >I NTERNATIONALIZATION. Guests searching in languages you do not support on your booking page will not be able to make a direct booking.

=Disconnect=
Set
*Commission Bid = None
*Synchronise = Disable

= FAQ =
=== What is the difference between Google Hotel Ads and Google for Vacation Rentals?===
Google Hotel ads is only available for hotels and hotel type properties only. For Hotel Ads Google requires the property to staffed front desk open during normal business hours, needs to have a “Google Profile” listing and Google favours properties without minimum stay restrictions.

Google for Vacation Rentals is specifically for vacation rental properties like apartments, holiday houses and can only be used by such properties.

=== What is CPA? ===
CPA stands for cost per acquisition meaning you pay a commission per booking which is only paid when you receive a booking. This model is different to the regular CPC (cost per click) meta search model where you pay for each click regardless whether a booking is made.

===What is the commission?===
You can set the maximum commission you are prepared to pay.

=== How is the commission calculated? ===
Commission is calculated on the room price not including upsells (fees and taxes setup as upsells are exempt).

If you are in based in Germany or the EU and have not provided us with a valid EU Vat Id Vat will be added to the commission.

===What happens with cancellations and no-shows?===
*If you have set "Commission Due" = "On Completed Stay" Google will refund commissions paid on cancelled bookings or no-shows. Contact us via a support ticket before check-out date and we will arrange the refund.
*If you have set "Commission Due" = "On Booking" Google will NOT refund commissions paid on cancelled bookings or no-shows. We recommend you use deposit collection to protect yourself from the risk.

=== Where are bookings made? ===
Google redirects to the hotels booking page. Charges and all other matter related to the booking have to be handled by the hotel.
The booking page is opened when a guest click to book on Google. Redirecting to a different location is not possible.

=== How do I pay? ===
The invoicing of this system is centralised through Google partners such as Beds24. Commissions will be charged to your Beds24 account instantly when there is a new booking from Google. This means to bid you will need to have enough credit in your account. Currency conversion might be done when your account is charged.

=== What happens when I do not have credit in my Beds24 acccount? ===
Guests will not be able to book if you do not have credit in your Beds24 account to pay for the commission. If you have not already done so we recommedn you set up auto payments in SETTINGS -> ACCOUNT -> BILLING. Please make sure you select an amount. If you choose 'None' we can not charge your card. Commissions will be deducted in real time so a booking might trigger the auto top up.

=== How do I know that a booking originates from Google? ===
Google will charge the commission you bid on all bookings originating from Google. These bookings have the referrer "GoogleHPA".

===How does Google know when a booking comes from Google Hotel Ads?===
Google leaves a cookie in the user’s browser. If this user carries out a booking while the cookie is still active, the conversion is reported to Google when the booking reaches the Confirmed or New status, i.e. after deposit collection has succeeded.

=== How can I check how my campaign is performing? ===
Google provides a weekly report which you can access when you click on "Weekly Performance Report".

=== Why is my Ad not showing on Google? ===
Check the following items:

1) Make sure your property matched with a Google business listing.
2) Make sure you have enough credit in your Beds24 account to pay commissions.
3) Make sure your booking page supports the language of the Google search.
4) Your bid might be too low so your ad is now shown. This happens when OTAs also bid on your property We recommend you raise your bit by one point every week until you reach a competitive level.
5) Google Ads default to a one night minimum stay and tend to perform best for near term bookings with short stays.

Google Hotel Ads & Google for Vacation Rentals

2022-03-30T15:38:05Z

Marco: /* Google for Vacation Rentals Setup */

[[Category:Channel Manager]]
[[Category:Google]]
[[Category:Troubleshooting]]
<div class="heading">Google Hotel Ads & Google for Vacation Rentals</div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > GOOGLE ADS and explains the interface with Google works and how to connect.

=Receive direct bookings from Google=
As official Google partner Beds24 can distribute your direct rates and inventory to Google.

*You get a direct connection to Google with the best rate coverage and real time prices 
*Display your direct rates and availability on Google Search and Maps 

Depending on the type of property you can either use Google Hotel Ads or Google for Vacation Rentals.

=For Vacation Rental Properties: Commission free bookings from Google for Vacation Rentals=
==What is Google for Vacation Rentals and how does it work ==
Google will create a vacation rental listing from the pictures (minimum requirement is 8 pictures), prices and availability and descriptions, sent from Beds24 with a direct booking link to your Beds24 booking page.

Google will display your property and live prices and availability if they meet the guests search criteria and the guest can then book directly on the Beds24 booking page.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Google does not charge and commission for bookings make via Google for Vacation Rentals.

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

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

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

==Google for Vacation Rentals Setup==
'''Step 1: Select Google for Vacation Rentals'''

Set Google Product to
*"Google for Vacation Rentals (List Rooms)" if you want to send the room content to Google or if you have multiple rooms in a property and want to connect more than one room. With this setting the names from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DESCRIPTION and the room pictures will send. If you do not have room pictures the offer pictures will send. If you do not have room pictures or offer pictures the property pictures will send.
*"Google for Vacation Property (List Property)". With this setting the name, description and pictures from the property will send.

'''Step 2: Make sure you have enough pictures '''

Google requires a minimum of 8 pictures.

Go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES and double check that you have uploaded and activated at least eight pictures.

Please note that Google sometimes selects the images randomly and displays them in random order instead of the position you selected in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES

'''Step 3: Make sure your information in Beds24 is complete '''

If required update your property information in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION:
*Property Name
*City
*State
*Postcode
*Address - if you have multiple properties Google expects a different address for each property.
*Country
*Latitude 'Latitude' and 'Longitude' have to reflect the actual location of your property.

Google will not accept data which does not contain all of the above information.

Click on 'View Mapping Data' to check what will send. If what you see there is not complete go back to {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION.

'''Step 4: Allow Beds24 to send your data'''

Google for Vacation Rentals listings are per property. Only one room per property can connect.

Set 'Synchronise' = Enable to the room you want to connect so Google can verify your content.

'''Step 5: Check your landing page'''

Make sure your landing page is provides meaningful information so guests will be confident to make a booking (see below).

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It can take Google up to 14days to verify your property. Once they have verified your property they will show it when it matches the guests search criteria.

=For hotels, B&Bs, guest houses and other hotel type properties: Google Hotel Ads=
==What is Google Hotel Ads? ==
Google Hotel Ads allows you to showcase your hotel via adverts across desktops, tablets, and mobile devices on Google.
== Who can use Google Hotel Ads ==
Google Hotel Ads is only available to hotels ad hotel type properties. Vacation rental properties can not use Google hotel ads. Googles guidelines are that the property should have all the following:
*Rooms in which paying guests can stay
*A physical presence and fixed location that is open to the public
*A staffed front desk open during normal business hours
*A minimum stay requirement of no greater than 7 days
*A "Google Profile" listing
*Google Hotel Ads is a hotel platform and does not respect minimum stay restrictions. Google checks for a one night stay on each date, if they do not find availability for one night they usually assume the date is closed and do not check any further including for stays of 2 or more days. Google prioritizes also properties which have availability in the near future.

<div class="warning">{{#fas:exclamation-triangle}} Beds24 has to be the booking engine used on your web site. If you use a different booking engine than Beds24 on your web site Google does not allow you to use Google Hotel Ads via Beds24.</div>

==Free Hotel Booking Links==
Free booking links appear on the hotel booking module alongside hotel ads when travelers look for rooms at a given hotel.

[[Image:Free_Hotel_Booking_Links.gif|450px|link=]]
[[Media:Free_Hotel_Booking_Links.gif|click to see an example]]

==Bidding ==
Certified Google Hotel Ads Integration Partners like Beds24 bid a commission on your behalf. Google will display the highest and the next highest bidder directly in the ad. The four next highest bidders will be shown after the guest clicks on "More".

If your commission bid is competitive, Google will provide a link to your direct booking page in their search results.

You only pay commission for confirmed bookings resulting from the search result, not pay per click etc.

[[Image:google_hotel_ads.png|250px|link=]]
[[Media:google_hotel_ads.png|view large]]

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> An important part of your marketing strategy on Google is to make sure that your property has a well maintained profile on Google, with pictures, descriptions, etc.

==Google Hotels Ads Setup ==
=== Matching for Free Booking Links and Bidding ===
Before using the service Google must match your property with the information they already have.

This process may take Google a few weeks to complete.

'''Step 1: Update your Business Profile on Google '''

Make sure your Google "MyBusiness profile" is verified and up to date with your hotel information. Google provides instructions on their site to help you get started.

'''Step 2: Make sure your information in Beds24 is the same as on your Business Profile on Google '''

Click on 'View Mapping Data'. Also open your Google Business listing and check that this information matches exactly the information in your Google business listing. If you do not yet have one set one up.

If required update your property information in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION:
*Property Name
*City
*State
*Postcode
*Address - if you have multiple properties Google expects a different address for each property.
*Country
*Phone Number - if you have multiple properties Google expects a unique phone number for each property.
*Latitude 'Latitude' and 'Longitude' have to reflect the actual location of your property.

Google will not accept data which does not contain all of the above information.

This information needs to match exactly the information in your "MyBusiness profile" '''

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have multiple properties Google expects a unique address and phone number for each. You can not use the same address and phone number for more than one property.

*If you want Google to show that the booking is cancellable check that you have allowed cancellations in {{#fas:cog}} (SETTINGS) PROPERTIES > BOOKING RULES and {{#fas:cog}} (SETTINGS) PROPERTIES > OFFERS

'''Step 3: Allow Beds24 to send your data'''

*Set Google Product = Google Hotel Ads.
*Set 'Synchronise' = Notify so Google can read your data and match you.

'''Step 4: Check your landing page'''

Make sure your landing page is provides meaningful information so guests will be confident to make a booking (see below).

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It can take Google up do 2 weeks to match your hotel. When you click on "Performance Report" you can check if your links are shown and how they perform. If the report is empty click on "View Mapping Data" to see why Google did not match you. Fix the issues and then check again after 10-14 days.

Once Google has matched you we can send your bid. To bid you will need to have enough credit in your Beds24 account. We recommend maintaining enough credit to cover the largest expected commission and setting up auto payments in {{#fas:cog}} (SETTINGS) ACCOUNT > BILLING. When you do not have enough credit in your account all ads may be turned off.

The rooms you are bidding Google should be your most economic double or twin rooms and have sell priority in{{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS SETUP set to highest so it is at the top of the booking page. '''Dorms are not allowed.'''

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Google Ad does not support multiple room types. They will only show one room type make sure you use your best value room types to compete.

===Deposit Collection ===
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > GOOGLE ADS there you can set options for deposit collection
*“Default” uses the “Booking Type” set in {{#fas:cog}} (SETTINGS) PROPERTIES > BOOKING RULES
*“Instant Deposit Collected” hides payment options (offline payments, credit card number collection) which do not send an instant payment notification to Beds24 on collection of funds.
*“Deposit Collection” allows all deposit collection types you have enabled for bookings from Google without affecting your normal booking rule for non Google bookings.

Deposit collection options can be setup at {{#fas:cog}} (SETTINGS) > PAYMENTS.

===Set bid ===
1. Choose a group of rooms

2. Set the maximum commission you are prepared to pay for bookings direct from Google hotel ads.

3. Under "Commission Due" you can choose if the commission is due at the time of the booking or when the guest has completed the stay.

4. The Maximum allowed booking value will show the total value of bookings allowed for your account at the selected Bidding level. If this is too low, you can raise it by adding funds to your Beds24 account.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Commission bids can be changed but every time you change the commission your property will go offline for a few hours.

It is not always possible for us to bid at every level so your actual bid may be lower than your bid setting, in this case, you will be charged the lower bid commission. Your bid will not be higher than your bid setting.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Changes to bidding commissions can take some time to propagate through to Google, bookings with commission at the old bid level are possible until the change fully propagates.

=== Commission ===
Commission payments to Google are made by Beds24, you are not required to pay Google directly.
*Commission is charged on completed bookings originating from the advertisement even if the guests books directly at a later point of time.
*If deposit collection is used, the commission is only charged after the deposit collection completes.
*If required, currency conversion will be done at market rates at the time of booking to calculate the commission in your account currency rather than booking currency.
*If you are based in Germany or the EU and have not provided us with a valid EU Vat Id, the commissions will effectively contain VAT at your countries local rate.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you have set "Commission Due" = "On Booking" Google will l charge their commission even if the guest cancels a booking or does not show up. We recommend you use deposit collection at the time of booking and appropriate cancellation policies.

=Price sent to Google=
After Google has matched you we can send prices to Google.

The price sent to Google is the lowest price for 2 people from offer one and offer 2 from your direct booking prices. A 2 person price is compulsory. If no 2 person price is supplied the room will send as unavailable.

Prices for 1, 3, 4 , 6 and 8 guests will also be sent if they are defined.

Discounts set in the "Discounts" tab of rates will not send.

If you have set a multiplier percentage for the Google bookings, the price will be adjusted by this amount.

If you have compulsory taxes or fees, these will be sent in addition to the price to create the effective end price.

Guests coming from Google will be shown this price by Google and expect to pay the same price on your booking page.

'''Multiplier'''

You can set a multiplier to adjust the prices sent to Google if required. The multiplier only works on the room price not on the fees and upsell items.

=Landing page =
The Beds24 booking page is opened when a guest click to book on Google.

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The conversion rate depends largely on the quality of your landing page.

You have the option to set up a dedicated layout which is used as landing page for Google.
The default template 7 is a good starting template which already contains a map.
[[Responsive_Booking_Page|This help explain how to set up and customise your layout]].

Click on "Landing Page" to check that your landing page is suitable as your landing page and contains all information a guest booking your lodging might want to see:
*Provide your logo or at least your property name
*Show at least one high quality picture for each room
*If you use a header picture or slider make sure it is not too high so that at least the first room displays without scrolling

You might consider adding the following information:
*Contact details
*Address
*Google map

The Google Ad will be shown in all languages allowed on your booking page.

You have the option to add URL parameters for the landing page in the "URL additions" fields. Only add the additional parameters do not enter your full booking page URL, for example if you add &roomid=9999, then only room 9999 will be included in your URL. For a list of available parameter please see [https://wiki.beds24.com/index.php/Category:Developers#Booking_Page_Parameters here].

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Make sure you activate all languages that you accept bookings for, in {{#fas:cog}} (SETTINGS) BOOKING PAGE >I NTERNATIONALIZATION. Guests searching in languages you do not support on your booking page will not be able to make a direct booking.

=Disconnect=
Set
*Commission Bid = None
*Synchronise = Disable

= FAQ =
=== What is the difference between Google Hotel Ads and Google for Vacation Rentals?===
Google Hotel ads is only available for hotels and hotel type properties only. For Hotel Ads Google requires the property to staffed front desk open during normal business hours, needs to have a “Google Profile” listing and Google favours properties without minimum stay restrictions.

Google for Vacation Rentals is specifically for vacation rental properties like apartments, holiday houses and can only be used by such properties.

=== What is CPA? ===
CPA stands for cost per acquisition meaning you pay a commission per booking which is only paid when you receive a booking. This model is different to the regular CPC (cost per click) meta search model where you pay for each click regardless whether a booking is made.

===What is the commission?===
You can set the maximum commission you are prepared to pay.

=== How is the commission calculated? ===
Commission is calculated on the room price not including upsells (fees and taxes setup as upsells are exempt).

If you are in based in Germany or the EU and have not provided us with a valid EU Vat Id Vat will be added to the commission.

===What happens with cancellations and no-shows?===
*If you have set "Commission Due" = "On Completed Stay" Google will refund commissions paid on cancelled bookings or no-shows. Contact us via a support ticket before check-out date and we will arrange the refund.
*If you have set "Commission Due" = "On Booking" Google will NOT refund commissions paid on cancelled bookings or no-shows. We recommend you use deposit collection to protect yourself from the risk.

=== Where are bookings made? ===
Google redirects to the hotels booking page. Charges and all other matter related to the booking have to be handled by the hotel.
The booking page is opened when a guest click to book on Google. Redirecting to a different location is not possible.

=== How do I pay? ===
The invoicing of this system is centralised through Google partners such as Beds24. Commissions will be charged to your Beds24 account instantly when there is a new booking from Google. This means to bid you will need to have enough credit in your account. Currency conversion might be done when your account is charged.

=== What happens when I do not have credit in my Beds24 acccount? ===
Guests will not be able to book if you do not have credit in your Beds24 account to pay for the commission. If you have not already done so we recommedn you set up auto payments in SETTINGS -> ACCOUNT -> BILLING. Please make sure you select an amount. If you choose 'None' we can not charge your card. Commissions will be deducted in real time so a booking might trigger the auto top up.

=== How do I know that a booking originates from Google? ===
Google will charge the commission you bid on all bookings originating from Google. These bookings have the referrer "GoogleHPA".

===How does Google know when a booking comes from Google Hotel Ads?===
Google leaves a cookie in the user’s browser. If this user carries out a booking while the cookie is still active, the conversion is reported to Google when the booking reaches the Confirmed or New status, i.e. after deposit collection has succeeded.

=== How can I check how my campaign is performing? ===
Google provides a weekly report which you can access when you click on "Weekly Performance Report".

=== Why is my Ad not showing on Google? ===
Check the following items:

1) Make sure your property matched with a Google business listing.
2) Make sure you have enough credit in your Beds24 account to pay commissions.
3) Make sure your booking page supports the language of the Google search.
4) Your bid might be too low so your ad is now shown. This happens when OTAs also bid on your property We recommend you raise your bit by one point every week until you reach a competitive level.
5) Google Ads default to a one night minimum stay and tend to perform best for near term bookings with short stays.

Template Variables

2022-03-25T15:48:39Z

Marco: /* Invoice Variables */

[[Category:Guest_Management]]
[[Category:Messaging]]
<div class="heading">Template variables</div>
On this page you find a list of template variables and information on how they are used.

These variables (short codes) will be replaced by the relevant information from each booking. They can be used in every text settings that allows their use . Copy them exactly as shown, including the square brackets and upper case.

The date variables can have an optional offset value of a number of days added after a colon, for example '''[FIRSTNIGHT:-3 days]'''

The price variables can have an optional offset value applied which can be a percentage or fixed amount with or without minus sign added after a colon, for example '''[PRICE:-10]''' or '''[INVOICEBALANCE:25%]'''

== Property Variables ==
[PROPERTYNAME] - property name

[PROPERTYADDRESS] - property address

[PROPERTYCITY] - property city

[PROPERTYSTATE] - property state

[PROPERTYCOUNTRY] - property country

[PROPERTYEMAIL] - property email

[PROPERTYWEB] - property web site

[PROPERTYPHONE] - property phone

[PROPERTYFAX] - property fax

[PROPERTYCONTACTLASTNAME] - property contact last name

[PROPERTYCONTACTFIRSTNAME] - property contact first name

[PROPERTYID] - property id number

[PROPERTYPOSTCODE] - property post code

[PROPERTYCURRENCY] - property currency code

[PROPERTYCURRENCYFRONT] - property currency symbol before number

[PROPERTYCURRENCYBACK] - property currency symbol after number

[PROPERTYLATITUDE] - property latitude

[PROPERTYLONGITUDE] - property longitude

[PROPERTYLOCATIONDESCRIPTION] - property location description

[PROPERTYLOCATIONDESCRIPTIONBR] - property location description with line break

[PROPERTYDIRECTIONS] - property directions from ( {{#fas:cog}} (SETTINGS) CHANNEL MANNAGER > PROPERTY CONTENT)

[PROPERTYHEADLINE] - property headline

[PROPERTYDESCRIPTION] - property description

[PROPERTYGENERALPOLICY] - property rental policy

[PROPERTYGENERALPOLICYBR] - property rental policy with line break

[PROPERTYLEGALPOLICY] - property rental policy / obsolete

[PROPERTYCANCELPOLICY] - property cancellation policy

[PROPERTYCANCELPOLICYBR] - property cancellation policy with line breaks

[PROPERTYHOUSERULES] - property house rules ({{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT)

[PROPERTYHOUSERULESBR] - property house rules ({{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT) with line break

[PROPERTYTEMPLATE1] - Property Template 1

[PROPERTYTEMPLATE2] - Property Template 2

[PROPERTYTEMPLATE3] - Property Template 3

[PROPERTYTEMPLATE4] - Property Template 4

[PROPERTYTEMPLATE5] - Property Template 5

[PROPERTYTEMPLATE5] - Property Template 6

[PROPERTYTEMPLATE7] - Property Template 7

[PROPERTYTEMPLATE8] - Property Template 8

[PROPERTYTEMPLATE1BR] - Property Template 1 with line breaks

[PROPERTYTEMPLATE2BR] - Property Template 2 with line breaks

[PROPERTYTEMPLATE3BR] - Property Template 3 with line breaks

[PROPERTYTEMPLATE4BR] - Property Template 4 with line breaks

[PROPERTYTEMPLATE5BR] - Property Template 5 with line breaks

[PROPERTYTEMPLATE6BR] - Property Template 6 with line breaks

[PROPERTYTEMPLATE7BR] - Property Template 7 with line breaks

[PROPERTYTEMPLATE8BR] - Property Template 8 with line breaks

[BOOKINGCOMHOTELID] - booking.com hotel id

[EXPEDIACOMHOTELID] - expedia.com hotel id

[PERMITID] - the permit ID

[CHECKINSTART] - check-in start time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in start')

[CHECKINEND] - check-in end time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in end')

[CHECKOUTEND] - check-out end time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-out end')

[CHECKINSTART12] - check-in start time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in start')

[CHECKINEND12] - check-in end time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in end')

[CHECKOUTEND12] - check-out end time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-out end')

[PROPERTYDESCRIPTION1] - Property Description 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCRIPTION2] - Property Description 2 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCBOOKPAGE1] - Property Description Booking Page 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCBOOKPAGE2] - Property Description Booking Page 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGUESTDETAILSHEADER] - Guest Details Header from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGUESTENQUIRYHEADER] - Guest Enquiry Header from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYCONFIRMBOOKBUTTON] - Confirm Booking Button Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYROOMNOTAVAIL] - Room Not Available Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYROOMNOPRICE] - Room No Price Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYNOROOMSAVAIL] - No Rooms Available Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGROUP] - shows the group keywords

== Room Variables ==
[ROOMID] - room id number

[ROOMNAME] - room names of all booked rooms (not for cancelled bookings use ROOMNAMEINC if used for cacelled bookings)

[ROOMNAMEBR] - room names with line break

[ROOMNAMEINC] room names of all booked rooms including for cancelled bookings

[ROOMNAMEINCBR] room names with line break

[ROOMNAME1] - room name of first booked room

[ROOMNAMES] - room names including quantity of each booked room

[ROOMNAMESNC] - room names including quantity of each booked room without cancelled rooms

[ROOMNAMESBR] - room names with line break

[ROOMNAMESNCBR] room names with line break without cancelled rooms

[ROOMNAMEOFFER] - room names of all booked rooms with offer name

[ROOMNAMEOFFERBR] - room names of all booked rooms with offer name with line break

[ROOMNAMEOFFERINC] room names of all booked rooms with offer name incl. cancelled bookings

[ROOMNAMEOFFERINCBR] - room names of all booked rooms with offer name with line break

[ROOMTYPEDESC] - room accommodation type first booked room

[ROOMTYPEDESCS] - room accommodation type all booked rooms

[ROOMTYPEDESCSINC] - room accommodation type all booked rooms including cancelled bookings

[ROOMSIZE] - size of the room

[ROOMTEMPLATE1] - ROOM Template 1

[ROOMTEMPLATE2] - ROOM Template 2

[ROOMTEMPLATE3] - ROOM Template 3

[ROOMTEMPLATE4] - ROOM Template 4

[ROOMTEMPLATE5] - ROOM Template 5

[ROOMTEMPLATE6] - ROOM Template 6

[ROOMTEMPLATE7] - ROOM Template 7

[ROOMTEMPLATE8] - ROOM Template 8

[ROOMTEMPLATE1BR] - ROOM Template 1 with linkbreak

[ROOMTEMPLATE2BR] - ROOM Template 2 with linkbreak

[ROOMTEMPLATE3BR] - ROOM Template 3 with linkbreak

[ROOMTEMPLATE4BR] - ROOM Template 4 with linkbreak

[ROOMTEMPLATE5BR] - ROOM Template 5 with linkbreak

[ROOMTEMPLATE6BR] - ROOM Template 6 with linkbreak

[ROOMTEMPLATE7BR] - ROOM Template 7 with linkbreak

[ROOMTEMPLATE8BR] - ROOM Template 8 with linkbreak

[ROOMMETAAUXTEXT] - room meta text setting for first booked room

[ROOMMETAAUXTEXTS] - room meta text setting for all booked rooms

[ROOMMETAAUXTEXTSINC] - room auxiliary text setting for all booked rooms

[INTERNALROOMNAME] - internal room name as used in the control panel, this is not the translated room name shown on the booking page

[OFFERID] - ID of the boked offer

[OFFERNAME] - booked offer name for all booked rooms

[OFFERNAME1] - offer name for this booked room only

[OFFERNAMEINC] - offer name for this booked room only including cancelled bookings

[OFFERDESCRIPTION1] - offer description 1 for all booked rooms

[OFFERDESCRIPTION1INC] - offer description 1 for all booked rooms incl. cancelled

[OFFERDESCRIPTION2] - offer description 2 for all booked rooms

[OFFERDESCRIPTION2INC] - offer description 2 for all booked rooms incl. cancelled

[OFFERDESCRIPTION1-1] - offer description 1 for this booked room

[OFFERDESCRIPTION2-1] - offer description 2 for this booked room

[OFFERSUMMARY] - summary offers

[OFFERSUMMARYINC] - summary offers including cancelled bookings

[UNITID] - ID of the unit (number)

[UNITNAME] - unit names of all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAMEINC] - unit names of all the assigned room types in the booking group including cancelled bookings

[UNITNAME:1] - additional information (first) about the unit for all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAME:2] - additional information (second) about the unit for all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAME1] - unit name of the assigned room for this booking number

[UNITNAME1:1] - additional information about the assigned room for this booking number / add the additional information on each line after a | symbol where you set the unit names

[UNITSTATUS1] - the status of the unit

[ROOMDESCRIPTION] - Room description from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMDESCRIPTION1] - Room description 1 from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP

[LEAVINGDAYAVAIL] - returns yes or no, can be used to trigger an Auto Action

[ROOMRACKRATENUM] - Rack Rate from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMCLEANINGFEENUM] - Cleaning fee from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMSECURITYDEPOSITNUM] - Securty deposit from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMTAXPERCENTNUM] - Tax percentate from from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMTAXPERSONNUM] - Tax per Person Night from from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

== Booking Variables ==
[VIEWBOOKING] - create a URL to log into the control panel and view this booking (for hosts, not intended to be sent to guests)

[BOOKID] - booking reference number

[BOOKIDS] - booking reference numbers of all bookings in a group

[BOOKIDSINC] - booking reference of all bookings in a group including cancelled bookings

[GROUPID] - booking reference of the master booking

[REFERENCENUMBER] - booking reference (same as [BOOKID])

[BOOKIDLAST1] - Last 1 digit of booking number

[BOOKIDLAST2] - Last 2 digits of booking number

[BOOKIDLAST3] - Last 3 digits of booking number

[BOOKIDLAST4] - Last 4 digits of booking number

[BOOKIDLAST5] - Last 5 digits of booking number

[BOOKIDLAST6] - Last 6 digits of booking number

[BOOKIDLAST7] - Last 7 digits of booking number

[BOOKIDLAST8] - Last 8 digits of booking number

[BEDDING] - displays bedding info codes

[RANDOM1] - a 1 digit random number seeded from the booking number

[RANDOM2] - a 2 digit random number seeded from the booking number

[RANDOM3] - a 3 digit random number seeded from the booking number

[RANDOM4] - a 4 digit random number seeded from the booking number

[RANDOM5] - a 5 digit random number seeded from the booking number

[RANDOM6] - a 6 digit random number seeded from the booking number

[RANDOM7] - a 7 digit random number seeded from the booking number

[RANDOM8] - a 8 digit random number seeded from the booking number

[VOUCHERPHRASE1] - Voucher Phrase - change the nubmer to the voucher you want to print out.

[VOUCHERAMOUNT1] - Voucher Amount - change the nubmer to the voucher you want to print out.

=== Content from "Info" tab ===
[BOOKINGINFOITEMS] - Booking Info Codes - Codes and text

[BOOKINGINFOITEMSBR] - Booking Info Codes - Codes and text with line break

[BOOKINGINFOTEXTS] - Booking Info Codes - Text only

[BOOKINGINFOTEXTSBR] Booking Info Codes - Text only with line break

[BOOKINGINFOCODES] - Booking Info Codes - Codes only

[BOOKINGINFOCODESBR] - Booking Info Codes - Codes and text with line break

[BOOKINGINFOCODETEXT:infoCode] - the most recent Text value of the specified Booking Info Code, "infoCode" in this example

[BOOKINGINFOCODEDATE:infoCode]- the most recent date value of the specified Booking Info Code, "infoCode" in this example, supports custom date/time formats {%A, %e %B, %Y} after the infoCode

[INTERNALNOTES] - content from "Internal Notes" on the Info Tab

[INTERNALNOTESBR] - content from "Internal Notes" on the Info Tab with line break

[INTERNALNOTESHR] - content from "Internal Notes" on the Info Tab with separating line

=== Content from "Summary" tab see also under "Room" and "Property" ===
[STATUS] - status of booking

[SUBSTATUS] - sub status of the booking

[FIRSTNIGHT] - first night booked

[FIRSTNIGHTSHORT] - first night booked in 1 Apr 2016 format

[FIRSTNIGHTYYYY-MM-DD] - first night booked in YYYY-MM-DD format

[LASTNIGHT] - last night booked

[LASTNIGHTSHORT] - last night booked in 1 Apr 2016 format

[LASTNIGHTYYYY-MM-DD] - last night booked in YYYY-MM-DD format

[LEAVINGDAY] - check-out day

[LEAVINGDAYSHORT] - check-out day in 1 Apr 2016 format

[LEAVINGDAYYYYY-MM-DD] - check-out day in YYYY-MM-DD format

[NUMNIGHT] - number of nights

[NUMNIGHTS] - number of nights sum across group booking

[NUMNIGHTSINC] - number of nights sum across group booking incl. cancelled

[GUESTTITLE] - guest title on the "summary" tab of the booking

[GUESTFIRSTNAME] - first name on the "summary" tab of the booking

[GUESTNAME] - last name on the "summary" tab of the booking

[GUESTNAMES] - name of all guests in the booking on the "summary" tab of the booking

[GUESTNAMESINC] - name of all guests in the booking on the "summary" tab of the booking incl. cancelled bookings

[GUESTNAMESINCBR] - name of all guests in the booking on the "summary" tab of the booking incl. cancelled bookings with line break on the "summary" tab of the booking

[GUESTFULLNAME] - title, first name, last name on the "summary" tab of the booking

[GUESTFULLNAMES] - titles, first names, last names of all guests in the booking on the "summary" tab of the booking

[GUESTFULLNAMESBR] - titles, first names, last names of all guests in the booking with line break on the "summary" tab of the booking

[GUESTFULLNAMESINC] - titles, first names, last names of all guests in the booking on the "summary" tab of the booking incl. cancelled

[GUESTFULLNAMESINCBR] - titles, first names, last names of all guests in the booking with line break on the "summary" tab of the booking incl. cancelled

[GUESTCOMMENTS] - comments in the booking

[GUESTCOMMENTSBR] - comments in the booking with line breaks <BR>

[NOTES] - notes

[NOTESBR] - notes with line breaks <BR>

[GUESTARRIVALTIME] - arrival time

[NUMADULT] - number of adults in this room or in group if master booking (not for cancelled bookings use NUMADULTINC if used for cacelled bookings)

[NUMADULTINC] - number of adults in this room or in group if master booking incl. cancelled bookings

[NUMADULT1] - number of adults in this room

[NUMCHILD] - number of children in this room or in group if master booking (not for cancelled bookings use NUMCHILDINC if used for cacelled bookings)

[NUMCHILDINC] number of children in this room or in group if master booking including cancelled bookings

[NUMCHILD1] - number of children in this room

[NUMPEOPLE] - number of guests in this room or in group if master booking

[NUMPEOPLEINC] - number of guests in this room or in group if master booking incl. cancelled bookings

[NUMPEOPLE1] - number of people in this room

[GUESTPHONE] - guests phone number

[GUESTPHONENUM] - guests phone number with all non-numeric characters removed

[GUESTMOBILE] - guests mobile number

[GUESTMOBILENUM] - guests mobile number with all non-numeric characters removed

[PHONELAST1] - last digit of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST2] - last 2 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST3] - last 3 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST4] - last 4 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST5] - last 5 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST6] - last 6 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[GUESTSMS:49] - attempt to convert the guest mobile number into a format suitable for SMS, if country code is missing add the one supplied in the template variable, if mobile number is empty use guest phone number instead.

[GUESTCOMPANY] - company name

[GUESTCOMPANYBR] - company name with line breaks

[GUESTFAX] - guests fax number

[GUESTFAXNUM] - guests fax number with all non-numeric characters removed

[GUESTADDRESS] - guests address

[GUESTADDRESSBR] - guests address with line breaks

[GUESTSADDRESSSBR1INC] - guests address with line breaks incl. cancelled bookings

[GUESTPOSTCODE] - guests postcode

[GUESTCITY] - guests city

[GUESTSTATE] - guests state

[GUESTCOUNTRY] - guests country from free text field is not empty, otherwise from selector list

[GUESTCOUNTRYHL] - guests country from free text field is not empty, otherwise from selector list in hosts language

[GUESTCOUNTRYGL] - guests country from free text field is not empty, otherwise from selector list in guests language

[GUESTCOUNTRYSELECT] - guests country from selector list

[GUESTCOUNTRYSELECTHL] - guests country from selector list in hosts language

[GUESTCOUNTRYSELECTGL] - guests country from selector list in guests language

[GUESTCOUNTRYTEXT] - guests country from free text field

[GUESTCOUNTRY2] - guests country from selector list as two letter code

=== Content from "Details" tab ===
[MESSAGE] - the content of the booking message field

[MESSAGEBR] - the content of the booking message field with line breaks <BR>

[GUESTCUSTOMQ1] - answer to custom question 1

[GUESTCUSTOMQ1BR] - answer to custom question 1 with line breaks <BR>

[GUESTCUSTOMQ2] - answer to custom question 2

[GUESTCUSTOMQsBR] - answer to custom question 2 with line breaks <BR>

[GUESTCUSTOMQ3] - answer to custom question 3

[GUESTCUSTOMQ3BR] - answer to custom question 3 with line breaks <BR>

[GUESTCUSTOMQ4] - answer to custom question 4

[GUESTCUSTOMQ4BR] - answer to custom question 4 with line breaks <BR>

[GUESTCUSTOMQ5] - answer to custom question 5

[GUESTCUSTOMQ5BR] - answer to custom question 5 with line breaks <BR>

[GUESTCUSTOMQ6] - answer to custom question 6

[GUESTCUSTOMQ6BR] - answer to custom question 6 with line breaks <BR>

[GUESTCUSTOMQ7] - answer to custom question 7

[GUESTCUSTOMQ7BR] - answer to custom question 7 with line breaks <BR>

[GUESTCUSTOMQ8] - answer to custom question 8

[GUESTCUSTOMQ8BR] - answer to custom question 8 with line breaks <BR>

[GUESTCUSTOMQ9] - answer to custom question 9

[GUESTCUSTOMQ9BR] - answer to custom question 9 with line breaks <BR>

[GUESTCUSTOMQ10] - answer to custom question 10

[GUESTCUSTOMQ10BR] - answer to custom question 10 with line breaks <BR>

[REFERENCE] - content of the booking reference field

[NUMROOM] - the quantity of rooms booked (first room type only)

[NUMROOMS] - the quantity of rooms booked (sum of all rooms and room types)

[NUMROOMSINC] - the quantity of rooms booked (sum of all rooms and room types) inc. cancelled

[FLAG] - Flag

[STATUSCODE] - 'Status Code' (Under tab 'Detail'. Can be a value between 0-100.)

[ORIGINALREFERRER] - Original referrer

[REFERRER] - Referrer

[APIREF] - the booking number at the originating channel

[APISOURCE] - Beds24 channel number

[APISOURCETEXT] - human readable name of the channel

[BOOKINGIP] - ip address of booker's computer

[APIMESSAGE] - api message sent by originating channel

[BOOKINGDATE] - booking date in guests language

[BOOKINGTIMEDATE] - booking date and time in guests language

[BOOKINGDATEYYYY-MM-DD] - booking date in YYYY-MM-DD format

see date and time variables below for custom time formats.

=== Content from "Charges and Payments" tab (also see "Invoice/Invoicee/Room") ===
[BOOKINGINVOICEEID] - invoicee id assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

[RATEDESC] - rate description (in the booking popup under the tab 'Charges & Payments')

[RATEDESCBR] - name of the rate with HTML <BR> to force new lines

[PRICE] - Value in price field (number entered in the price field of the booking) with currency symbol

[PRICENC] - Value in price field (number entered in the price field of the booking) without currency symbol (do not use in calculations, use PRICENUM)

[PRICE:10%] - Percentage value of Price

[PRICE:-10] - Price with offset amount

[PRICENUM] - As per [PRICE] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation).

[PRICENUM:] - As per [PRICE:] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[PRICELESSCOMMISSION] - Value in price field less value in commission field with currency symbol

[PRICELESSCOMMISSIONNUM] - As per [PRICELESSCOMMISSION] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[PRICELESSTAX] - Value in price field less value in tax field with currency symbol

[PRICELESSTAXNUM] - As per [PRICELESSTAX] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVPRICE] - Average Nightly Price with currency symbol

[AVPRICENUM] - Average Nightly Price with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVPRICE:20%] - Percentage value of Average Nightly Price

[AVPRICE:15] - Average Nightly Price with offset amount

[BASEPRICE] - Lodging Price

[BASEPRICENUM] - same as [BASEPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEGROUPPRICE] - Lodging Price for Group

[BASEGROUPPRICENUM] - same as BASEGROUPPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEVAT] - Lodging Price vat amount

[BASEVATNUM] - same as [BASEVAT] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEGROUPVAT] - Lodging Price vat amount for Group

[BASEGROUPVATNUM] - same as BASEGROUPVAT] with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVBASEPRICE] - Average Nightly Lodging Price

[AVBASEPRICENUM] - same as [AVBASEPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVBASEGROUPPRICE] Average Nightly Lodging Price for Group

[AVBASEGROUPPRICENUM] - same as [AVBASEGROUPPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[DEPOSIT] - Value in deposit field with currency symbol

[DEPOSITNUM] - As per [DEPOSIT] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[TAX] - Value in tax field with currency symbol

[TAXNUM] - As per [TAX] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation).

[COMMISSION] - Value in commission field with currency symbol

[COMMISSIONNUM] - As per [COMMISSION] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[COMMISSIONGROUP] - Value of the commission of the complete group booking

[GUESTVOUCHER] - voucher code used with booking

[CARDLASTFOUR] - last 4 digits of card

[CARDFIRSTSIX] - first 6 digits of card

===Content from Invoice" tab===
[BOOKINGINVOICEEID] - invoicee id assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

[BOOKINGINVOICEENAME] - invoicee name assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

===Content from "Group Invoice" tab===
[GROUPNOTE] - group note

=== Content from "Mail & Actions" tab ===
[GUESTEMAIL] - guest's Email address on the "summary" tab of the booking

[GUESTLANGUAGE] - guest language

[EMAIL:00] - Status of an Auto Action email. Replace 00 with the number of the Auto Action. This shows if the email has been sent and if so, the time it was sent.

=== Content from "Guests" tab ===
[GUESTSID] - all IDs of this booking

[GUESTSID1] - ID of the first guest

[GUESTSIDS] - all IDs for all bookings in the group

[GUESTSNAME] - name of all guests listed on the "guests" tab of this booking

[GUESTSNAMES] - name of all guests listed on the "guests" tab of the booking of the group booking

[GUESTSNAMESINC] - name of all guests listed on the "guests" tab of the booking of the group booking incl. cancelled

[GUESTSFIRSTNAMES] - first name of all guests listed on the "guests" tab of this booking last separated by an &

[GUESTSFIRSTNAMESINC] - first name of all guests listed on the "guests" tab of this booking incl. cancelled

[GUESTSLASTNAMES] - last name of all guests listed on the "guests" tab of this booking

[GUESTSLASTNAMESINC] - last name of all guests listed on the "guests" tab of this booking incl. cancelled

[GUESTSADDRESSSBR1] - address of the first guest on the "guests" tab of this booking group

[GUESTSADDRESSSBR1INC] - address of the first guest on the "guests" tab of this booking group incl. cancelled

[GUESTSAFULLADDRESSSBR1INC] - the first address including city, postcode, sate and country from the guests tab of the booking including cancelled bookings in international format

[GUESTSAFULLADDRESSSBR1] - the first address including city, postcode, sate and country from the guests tab of the booking in International format

[GUESTSBFULLADDRESSSBR1INC] - the first address including city, postcode, sate and country from the guests tab of the booking including cancelled bookings in European format

[GUESTSBFULLADDRESSSBR1] - the first address including city, postcode, sate and country from the guests tab of the booking in European format

[GUESTSNUMBOOKINGS1] - the total number of bookings made by the first guest, a group booking counts as one booking.

[GUESTSNUMSTAYS1] - the total number of bookings not cancelled and not in the future made by the first guest, a group booking counts as one booking.

[GUESTSCUSTOMQ1S] - answer to custom question 1 for all guests

[GUESTSCUSTOMQ1SINC] - answer to custom question 1 for all guests including cancelled bookings

[GUESTSCUSTOMQ2S] - answer to custom question 2 for all guests

[GUESTSCUSTOMQ2SINC] - answer to custom question 2 for all guests including cancelled bookings

[GUESTSCUSTOMQ3S] - answer to custom question 3 for all guests

[GUESTSCUSTOMQ3SINC] - answer to custom question 3 for all guests including cancelled bookings

[GUESTSCUSTOMQ4S] - answer to custom question 4 for all guests

[GUESTSCUSTOMQ4SINC] - answer to custom question 4 for all guests including cancelled bookings

[GUESTSCUSTOMQ5S] - answer to custom question 5 for all guests

[GUESTSCUSTOMQ5SINC] - answer to custom question 5 for all guests including cancelled bookings

[GUESTSCUSTOMQ6S] - answer to custom question 6 for all guests

[GUESTSCUSTOMQ6SINC] - answer to custom question 6 for all guests including cancelled bookings

[GUESTSCUSTOMQ7S] - answer to custom question 7 for all guests

[GUESTSCUSTOMQ7SINC] - answer to custom question 7 for all guests including cancelled bookings

[GUESTSCUSTOMQ7S] - answer to custom question 8 for all guests

[GUESTSCUSTOMQ8SINC] - answer to custom question 8 for all guests including cancelled bookings

[GUESTSCUSTOMQ9S] - answer to custom question 9 for all guests

[GUESTSCUSTOMQ9SINC] - answer to custom question 9 for all guests including cancelled bookings

[GUESTSCUSTOMQ10S] - answer to custom question 10 for all guests

[GUESTSCUSTOMQ10SINC] - answer to custom question 10 for all guests including cancelled bookings

===Cancellation, Management and Guest Login===
[CANCELLEDTIME] - date when the booking was cancelled

[CANCELLEDTIME:] - date when the booking was cancelled display can be any valid PHP strftime format string

[CANCELURL] - URL to view and cancel bookings

[CANCELDATE] - date until when the booking is cancellable displaying a phrase

[CANCELDATEYYYY-MM-DD] - date until when the booking is cancellable displaying a date. If the date is in the past 00-00-0000 will be shown

[DAYSTOCANCEL] - number of days until booking can be cancelled

[CANCELUNTIL] - shows the number of days between check-in and the last day which can be cancelled. If guest can always cancel it shows 0, if guest can never cancel it shows 9999

[GUESTLOGIN] - URL to view bookings

[TURNOVERDAYS] - days until next arrival into the same unit

[VACANTDAYS] days from previous checkout to check in of current booking

==Date and Time==

[CURRENTDATE] - current date

[CURRENTDATEYYYY-MM-DD] - current date in YYYY-MM-DD format

[CURRENTDATE:{%A, %e %B, %Y}] - current date

[CURRENTDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[CURRENTTIME] - current time and the display can be any valid PHP strftime format string.

[CURRENTTIME:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[DAYSTOCHECKIN] - number of days until check-in

[INADVANCE] - number of days between booking and check-in

[DAYSBETWEEN:2019-11-01:2019-11-10] - this template variable will calculate the number of days between the :: the dates need to be in yyyy-mm-dd format. Template variables can be used for calculation.

Example: [[DAYSBETWEEN:[FIRSTNIGHT:+5 days{%G-%m-%d}]:[CURRENTDATE:{%G-%m-%d}]] will calculate the days between 5 days after check-in and today.

[FIRSTNIGHT:{%A, %e %B, %Y}] - first night booked

[FIRSTNIGHT:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[LASTNIGHT:{%A, %e %B, %Y}] - last night booked

[LASTNIGHT:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[LEAVINGDAY:{%A, %e %B, %Y}] - check-out

[LEAVINGDAY:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[BOOKINGDATE:{%A, %e %B, %Y}] - booking date

[BOOKINGDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format.

[MODIFYDATE:{%A, %e %B, %Y}] - last booking modification date/time, the display can be any valid PHP strftime format string.

[PAYMENTDATE:{%A, %e %B, %Y}] - most recent payment date

[PAYMENTDATE:+1day{%A, %e %B, %Y}:1:1000] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be in a custom format. The second parameter specifies the payment to show, 0 or missing means the most recent payment. The third parameter specifies the invoicee.

[AUTHORIZEUNTIL] - date until which a card is authorized, this is extracted from the most recent authorize booking info code.

[AUTHORIZEUNTIL{%A, %e %B, %Y}] - custom format date until which a card is authorized, this is extracted from the most recent authorize booking info code.

[FORMATDATE:[any template variable that creates a date]{%A, %e %B, %Y}] - custom format the date. The date value could be included by inserting a different template variable containing a date.

The following codes can be used in any order between the {} brackets to create custom time and date formats.

%a An abbreviated textual representation of the day Sun through Sat
%A A full textual representation of the day Sunday through Saturday
%d Two-digit day of the month (with leading zeros) 01 to 31
%e Day of the month, with a space preceding single digits. 1 to 31
%j Day of the year, 3 digits with leading zeros 001 to 366
%u ISO-8601 numeric representation of the day of the week 1 (for Monday) through 7 (for Sunday)
%w Numeric representation of the day of the week 0 (for Sunday) through 6 (for Saturday)
%U Week number of the given year, starting with the first Sunday as the first week 13 (for the 13th full week of the year)
%V ISO-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with Monday being the start of the week 01 through 53 (where 53 accounts for an overlapping week)
%W A numeric representation of the week of the year, starting with the first Monday as the first week 46 (for the 46th week of the year beginning with a Monday)
%b Abbreviated month name, based on the locale Jan through Dec
%B Full month name, based on the locale January through December
%h Abbreviated month name, based on the locale (an alias of %b) Jan through Dec
%m Two digit representation of the month 01 (for January) through 12 (for December)
%C Two digit representation of the century (year divided by 100, truncated to an integer) 19 for the 20th Century
%g Two digit representation of the year going by ISO-8601:1988 standards (see %V) Example: 09 for the week of January 6, 2009
%G The full four-digit version of %g Example: 2008 for the week of January 3, 2009
%y Two digit representation of the year Example: 09 for 2009, 79 for 1979
%Y Four digit representation for the year Example: 2038
%H Two digit representation of the hour in 24-hour format 00 through 23
%k Hour in 24-hour format, with a space preceding single digits 0 through 23
%I Two digit representation of the hour in 12-hour format 01 through 12
%l (lower-case 'L') Hour in 12-hour format, with a space preceding single digits 1 through 12
%M Two digit representation of the minute 00 through 59
%p UPPER-CASE 'AM' or 'PM' based on the given time Example: AM for 00:31, PM for 22:23
%P lower-case 'am' or 'pm' based on the given time Example: am for 00:31, pm for 22:23
%r Same as "%I:%M:%S %p" Example: 09:34:17 PM for 21:34:17
%R Same as "%H:%M" Example: 00:35 for 12:35 AM, 16:44 for 4:44 PM
%S Two digit representation of the second 00 through 59
%T Same as "%H:%M:%S" Example: 21:34:17 for 09:34:17 PM
%X Preferred time representation based on locale, without the date Example: 03:59:16 or 15:59:16
%z The time zone offset. Example: -0500 for US Eastern Time
%Z The time zone abbreviation. Example: EST for Eastern Time
%c Preferred date and time stamp based on locale Example: Tue Feb 5 00:45:10 2009 for February 5, 2009 at 12:45:10 AM
%D Same as "%m/%d/%y" Example: 02/05/09 for February 5, 2009
%F Same as "%Y-%m-%d" (commonly used in database datestamps) Example: 2009-02-05 for February 5, 2009
%s Unix Epoch Time timestamp (same as the time() function) Example: 305815200 for September 10, 1979 08:40:00 AM
%x Preferred date representation based on locale, without the time Example: 02/05/09 for February 5, 2009
%n A newline character ("\n")
%t A Tab character ("\t")
%% A literal percentage character ("%")

== Booking Group variables ==
=== Custom Booking Group Table ===
create your own booking group list by specifying the columns in the order you want them to appear.

for example: [BOOKGROUP:PROP_ROOM_BREF_NAME]

column parameters

100% = 100% width

ADDR = Booking address

ADUL= the number of adults

ARIV = Arrival date

BOPR = Bold prices

BREF = Booking number

CITY = Booking city

CHAC = Charges with currency symbol

CHAR = Charges

CHIL = Number of children

COUN = Booking country

DEPT = Departure date

EMAI = Booking Email

EXSP = extra space between rows

FLAG = Booking flag text

FNAM = Booking first name

GADD = Guest address

GCIT = Guest city

GCOM = Guest company

GCOU = Guest country

GFLA = Guest flag text

GFNA = Guest first name

GLNA = Guest last name

GMOB = Guest mobile

GNAM = Guest full name

GEMA = Guest Email

GNOT = Guest note

GPOS = Guest postcode

GREF = Guest Id

GSTA = Guest state

GTEL = Guest phone

ICAN = Include cancelled bookings

LNAM = Booking last name

MOBI = Booking mobile

NAME = Booking full name

NOHE = no header

NOTE = Booking note

ONAM = Offer Name

ONLY = Just show the one booking

PAIC = Payment amount with currency symbol

PAID = Paid amount

PEOP = Number of guests

PHON = Booking phone

POST = Booking postcode

PROP = Property name

RDE0 = Room description from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

RDE1 = Room description 1 from {{#fas:cog}} (SETTINGS) PROPERTIES> ROOMS > SETUP

RNAM = Room Display Name

ROOM = Room name

RQTY = shows the number of rooms for each booking and a total at the bottom

STAT = Booking state

STUS = Status

TOTA = Total price

UNI2 = Unit first additional information

UNI3 = Unit second additional information

UNIT = Unit name

Connect the parameters with an underscore.

Examples:

[BOOKGROUP:PROP_ROOM_BREF_NAME] will display the property name, room name, booking number and guest name in this order.

[BOOKGROUP:BREF_NAME_PROP_ROOM] will display the booking number, guest name property name and room name in this order.

=== Booking Group Table with fixed content===
[BOOKGROUPROOMLIST] - create a table of guest names including room type for a group booking

[BOOKGROUPROOMLISTTOTAL] - create a table of guest names including room type for a group booking with guest totals

[BOOKGROUPROOMLISTCHARGETOTAL] - create a table of guest names including room type and charge for a group booking with guest totals

[BOOKGROUPNAMELIST] - create a table of guest names including room type and unit for a group booking

[BOOKGROUPNAMELISTTOTAL] - create a table of guest names including room type and unit for a group booking with guest totals

[BOOKGROUPNAMELISTCHARGETOTAL] - create a table of guest names including room type and unit and charge for a group booking with guest totals

[BOOKGROUPUNITLIST] - create a table of guest names including unit for a group booking

[BOOKGROUPUNITLISTTOTAL] - create a table of guest names including unit for a group booking with guest totals

[BOOKGROUPUNITLISTCHARGETOTAL] - create a table of guest names including unit and charge for a group booking with guest totals

== Invoice Variables ==
[INVOICENUMBER] - invoice number

[INVOICENUMBERS] - invoice number if invoicees are involved

[INVOICEDATE] - invoice date

[INVOICEDATES] - invoice date invoice number if invoicees are involved

[INVOICEDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[INVOICEDATES:+1day{%A, %e %B, %Y}] - optional date offset and display format - invoice date invoice number if invoicees are involved, The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

=== Invoice Values ===
These template variables will display a value form the invoice.

==== Custom Invoice Values====
You have the option to create a custom invoice variable to display a value from an invoice. Available content variables are:

CHA - charges

CON - currency conversion. Example: CONEURUSD will convert the first currency (Euros) to the second currency (USD). CON1.234 would multiply the prices by 1.234

DEC - Decimal points. Example: DEC, will show a comma as decimal point. If nothing is set the system will use the default for the language

DP0 - no decimal places

DP1 - 1 decimal place

DP2 - 2 decimal places

DP3 - 3 decimal places

DP4 - 4 decimal places

DESsome description - sum of values with "some description"

INV - invoicee, add the invoicee number at the end. Example: INV20 to show invoicee number 20, INV0 will show items not assigned to an invoicee, INV-1 will show all items from the booking regardless of invoicee. You can combine INV[BOOKINGINVOICEEID]] to add the invoicee from the booking

IT1 - item 1 in the invoice

IT2 - item 2 in the invoice

IT3 - item 3 in the invoice

IT4 - item 4 in the invoice

IT5 - item 5 in the invoice

MUL - multiplier. Example: MUL1.2 will multiply all prices by 1.2

NUM - show with decimal place (for scripts)

THO - thousands separator. THO. will show a dot as thousand separator. If nothing is set the system will use the default for the language

UPS1 - upsell 1

UPS2 - upsell 2

UPS3 - upsell 3

UPS4 - upsell 4

UPS5 - upsell 5

ONE - shows only items from the specified booking (not the booking group)

PAY - shows payments

QTY - shows quantity

SEX - status excluded. Calculate the balance of all invoice items except for the ones with these status, the status items can be a comma separated list. Example: SEX status1,status2,status4 will not show items with this status.

SIN - status included. Calculate the balance of all invoice items with matching status, the status items can be a comma separated list. Example: SIN status1,status2,status4 will only show items with this status.

VAT - VAT summary

Connect the variables with an underscore.

Examples:

[INVOICEVAL:PAY_THO] will show payments with a thousands separator

[INVOICEVAL:UPS1_UPS2] will show the sum of upsell 1 and upsell 2

==== Standard Invoice Values====
[INVOICEBALANCE] - invoice balance

[INVOICEBALANCE:50%] - percentage of invoice balance

[INVOICEBALANCE:-100] - invoice balance with offset amount

[INVOICEBALANCENUM] - As per [INVOICEBALANCE] but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEBALANCENUM:] - As per [INVOICEBALANCE:] but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPARTBALANCE:status1,status2,!status4:10%] - Calculate the balance of all invoice items with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset is optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTBALANCENUM:status1,status2,status4:10%] - As per INVOICEPARTBALANCE but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEBALANCE1] - invoice balance of one booking only, not the booking group

[INVOICEBALANCE1NUM] - As per [INVOICEBALANCE1] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECHARGES] - invoice sum of all charges

[INVOICECHARGES:50%] - invoice sum of all charges with percentage multiplier

[INVOICECHARGES:-100] - invoice sum of all charges with offset

[INVOICECHARGESNUM] - As per [INVOICECHARGES] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECHARGESNUM:] - As per [INVOICECHARGES:] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPARTCHARGES:status1,status2,!status4:10%] - Calculate the balance of all invoice charges with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTCHARGESNUM:status1,status2,status4:10%] - As per INVOICEPARTCHARGES but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPAYMENTS] - invoice sum of all payments

[INVOICEPAYMENTS:50%] - invoice sum of all payments with percentage multiplier

[INVOICEPAYMENTS:-100] - invoice sum of all payments with offset

[INVOICEPAYMENTSNUM] - As per [INVOICEPAYMENTS] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPAYMENTSNUM:50%] - As per [INVOICEPAYMENTS:50%] but the value is displayed with a decimal point and no thousands separator.

[INVOICEPARTPAYMENTS:status1,status2,!status4:10%] - Calculate the balance of all invoice payments with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTPAYMENTSNUM:status1,status2,status4:10%] - As per INVOICEPARTCHARGES but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAY] - all (auto and manual) pending payments including failed

[INVOICEPENDPAYNEXTDATE] - date of the next pending payment

[INVOICEPENDPAYNEXTDATE:] - date of the next pending payment display can be any valid PHP strftime format string. Information about PHP strftime Strings can be find found here: http://php.net/manual/de/function.strftime.php

[INVOICEPENDPAYNUM] - all (auto and manual) pending payments including failed but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAY1234] - all (auto and manual) pending payments including failed for the specified invoicee (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYNUM1234] - all (auto and manual) pending payments including failed for the specified invoicee (-1 will include all items regardless of invoicee) The value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYAUTO] - auto pending payments before due date

[INVOICEPENDPAYAUTONUM] - auto pending payments before due date but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYAUTO1234] auto pending payments before due date for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYAUTONUM1234] auto pending payments before due date for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYFAIL] - failed pending payments (all also past)

[INVOICEPENDPAYFAILNUM] - failed pending payments (all also past) but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPENDPAYFAIL234] - failed pending payments (all also past) for the specified invoicee (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYFAILNUM234] - failed pending payments (all also past) for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYRULE1] - shows all pending payment for this rule (exchange 1 for the rule number)

[INVOICEPENDPAYRULENUM1] - shows all pending payment for this rule (exchange 1 for the rule number) displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPENDPAYMANUAL] - manual pending payments

[INVOICEPENDPAYMANUALNUM] - manual pending payments but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYMANUALNOTDUE] manual pending payments before due date

[INVOICEPENDPAYMANUALNOTDUENUM] manual pending payments before due date but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYMANUALOVERDUE] manual pending payments after due date

[INVOICEPENDPAYMANUALOVERDUENUM] manual pending payments after due date but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECREDITS] - invoice sum of all credit items (negative items)

[INVOICECREDITS:50%] - invoice sum of all credit items with percentage multiplier

[INVOICECREDITS:-100] - invoice sum of all credit items with offset

[INVOICECREDITSNUM] - As per [INVOICECREDITS] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECREDITSNUM:] - As per [INVOICECREDITS:] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEDEBITS] - invoice sum of all debit items (positive items)

[INVOICEDEBITS:50%] - invoice sum of all debit items with percentage multiplier

[INVOICEDEBITS:-100] - invoice sum of all debit items with offset

[INVOICEDEBITSNUM] - As per [INVOICEDEBITS] but the value is displayed with a decimal point and no thousands separator (for calculations) (for calculations)

[INVOICEDEBITSNUM:] - As per [INVOICEDEBITS:] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEVAT] - invoice sum of all vat value

[INVOICEVATNUM] - invoice sum of all vat value for calculations)

[INVOICEFIRSTITEM] - price of the item listed first in the invoice

[INVOICEFIRSTITEMNUM] - price of the item listed first in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICESECONDITEM] - price of the item listed second in the invoice

[INVOICESECONDITEMNUM] - price of the item listed second in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICETHIRDITEM] - price of the item listed third in the invoice

[INVOICETHIRDITEMNUM] - price of the item listed third in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEFOURTHITEM] - price of the item listed fourth in the invoice

[INVOICEFOURTHITEMNUM] - price of the item listed fourth in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEFIFTHITEM] - price of the item listed fifth in the invoice

[INVOICEFIFTHITEMNUM] - price of the item listed fifth in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELL0] - base price without upsell items or other charges added later

[INVOICEUPSELLNUM0] - as per [INVOICEUPSELL1] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELL1] - value of upsell item 1 (number can be between 0 to 20)

[INVOICEUPSELLNUM1] - as per [INVOICEUPSELL1] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELLQTY1] - quantity of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLNAME1] - name of the headline field of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLSTATUS1] - stautus of the headline field of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLHEADLINE1] - headline (name and status if used of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLDESCRIPTION1] - description of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLAMOUNTNUM1] - amout of upsell item 1

[INVOICEUPSELLTYPE1] - type of upsell item 1

[INVOICEUPSELLPER1] - per of upsell item 1

[INVOICEUPSELLPERIOD1] - period of upsell item 1

[INVOICEEXTRAITEMDESC1] - Name of extra invoice item 1 (number can be between 0 to 20)

[INVOICEEXTRAITEM1] - value of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEEXTRAITEM1] - value of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEEXTRAITEMNUM1] - as per [INVOICEEXTRAITEM1] but the value is displayed with a decimal point and no thousands separator (for calculations).

[INVOICEEXTRAITEMQTY1] - quantity of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEGROSS:1] - gross amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

INVOICEGROSSNUM:1] gross amount of the inserted VAT rate (number is the VAT rate)

[INVOICENET:1] - net amount of the inserted VAT rate (number is the VAT rate)

[INVOICENETNUM:1] - net amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEVAT:1] - VAT amount of the inserted VAT rate (number is the VAT rate)

[INVOICEVATNUM:1] VAT amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEITEMBYDESC:Searchterm] - searches the invoice for items with this search term and adds them up

[INVOICEITEMBYDESCNUM:Searchterm] - searches the invoice for items with this search term and adds them up, value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEPAYMENTBYDESC:Searchterm] - searches the payments for items with this search term and adds them up

[INVOICEPAYMENTBYDESCNUM:Searchterm] - searches the payments for items with this search term and adds them up, value is displayed with a decimal point and no thousands separator (for calculations)

=== Invoice Table ===
These template varibles will display an invoice table.
==== Standard Invoice Tables ====
[INVOICETABLE] - invoice table

[INVOICETABLEVAT] - invoice table with vat information and vat summary

[INVOICETABLE:$1.1$] - invoice table and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEPART:status1,status2,!status4] - Invoice table showing only items with matching status. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1.

[INVOICETABLE2] - invoice table with status field

[INVOICETABLE2:$1.1$] - invoice table with status field and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLECHARGES] - invoice table showing charges only

[INVOICETABLECHARGESINVOICEE1234] - invoice table showing charges only assigned to the specified invoicee, specify the invoicee Id number.

[INVOICETABLENOTOT] - invoice table without grand total

[INVOICETABLENOTOT:$1.1$] - invoice table without grand total and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLENOTOT2] - invoice table with status field without grand total

[INVOICETABLENOTOT2:$1.1$] - invoice table with status field without grand total and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT:$1.1$] - invoice table with vat information and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCOMPACT] - compact version of invoice table with vat information and vat summary

[INVOICETABLEVATCOMPACT:$1.1$] - compact version of invoice table with vat information and vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCOMPACTNOSUM] - compact version of invoice table with vat information without vat summary

[INVOICETABLEVATCOMPACTNOSUM:$1.1$] - compact version of invoice table with vat information without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATNOSUM] - invoice table with vat information without vat summary

[INVOICETABLEVATNOSUM:$1.1$] - invoice table with vat information without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEDATEVATNOSUM] - invoice table with vat information and date without vat summary

[INVOICETABLEDATEVATNOSUM:$1.1$] - invoice table with vat information and date without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT2] - invoice table with vat information and status field and vat summary

[INVOICETABLEVAT2:$1.1$] - invoice table with vat information and status field and vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT2NOSUM] - invoice table with vat information and status field without vat summary

[INVOICETABLEVAT2NOSUM:$1.1$] - invoice table with vat information and status field without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCHARGES] - invoice table showing charges only with vat information and vat summary

[INVOICETABLENOPRICE] - invoice table with no price information

[INVOICETABLEINVOICEE] - invoice table excluding items assigned to an invoicee.

[INVOICETABLEINVOICEE1234] - invoice table for a specific invoicee, specify the invoicee Id number.

[UPSELLTABLE] - table with all upsell items

[UPSELLTABLEVAT] - table with all upsell items with vat information and vat summary

[UPSELLTABLENOREFUND] - table with all upsell items except refundable items

==== Custom Invoice Table ====
You have the option to create a custom invoice table. Available content variables are:

AMO - shows the net value (price x quantity)

CEX - charges excluded (charges will not be shown)

CON - currency conversion. Example: CONEURUSD will convert the first currency (Euros) to the second currency (USD). CON1.234 would multiply the prices by 1.234

CUA - currency symbol showing after the numbers. Example: CUA€ will show € after the figures

CUB - currency symbol showing before the numbers. Example: CUB€ will show € before the figures

DAT - adds a date column - you have the option to control the format of the date using [[Template_Variables#Date_and_Time|date and time variables]] for example DAT{%d-%m-%Y}

DEC - Decimal points. Example: DEC, will show a comma as decimal point. If nothing is set the system will use the default for the language

DP0 - no decimal places

DP1 - 1 decimal place

DP2 - 2 decimal places

DP3 - 3 decimal places

DP4 - 4 decimal places

GAT - sum for each column

GRP - Group Totals. Displays the same items as a total

GRT - Grand Total

INV - invoicee, add the invoicee number at the end. Example: INV20 to show invoicee number 20, INV0 will show items not assigned to an invoicee, INV-1 will show all items from the booking regardless of invoicee. You can combine INV[BOOKINGINVOICEEID]] to add the invoicee from the booking

LAN - language. Example LANDE will force the language to German

MUL - multiplier. Example: MUL1.2 will multiply all prices by 1.2

NIN - do not show invoice number and invoice date on locked invoices

NOC - charges will not be displayed but their vat values are still calculated for the vat summary (VAT)

NOP - payments will not be displayed

ONE - shows only items from the specified booking (not the booking group)

ORB - order by booking, this keeps the items for each booking (room) together in the table

PAA - shows a column with payment amounts

PAY - shows payments

PEN - shows pending payments description

PPA - shows pending payments amount

PRI - shows prices in a column

QTY - shows quantity

SEX - status excluded. Calculate the balance of all invoice items except for the ones with these status, the status items can be a comma separated list. Example: SEX status1,status2,status4 will not show items with this status.

SIN - status included. Calculate the balance of all invoice items with matching status, the status items can be a comma separated list. Example: SIN status1,status2,status4 will only show items with this status.

STA- shows staus

THO - thousands separator. THO. will show a dot as thousand separator. If nothing is set the system will use the default for the language

TOT - shows total amounts

VAA - shows VAT amounts

VAP - shows VAT percents

VAT - VAT summary

Connect the variables with an underscore.

Examples:

[INVOICE:PRI_QTY_CUA€] will create an invoice table with price and quantity in Euros.

[INVOICE:PAY_TOT_CEX] will create an invoice table which will only show payments.

[INVOICE:PRI_QTY_CUA_TOT_VAT_QTY_PAY_GRT_AMO_VAA] will create an invoice table with more information.

== Invoicee Variables ==
[INVOICEEBALANCE] - invoice balance for unassigned invoice items.

[INVOICEEBALANCENUM] - invoice balance for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEEBALANCE1234] - invoice balance for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number).

[INVOICEEBALANCENUM1234] - invoice balance for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number) displayed with a decimal point and no thousands separator.

[INVOICEECHARGES] - invoice charges for unassigned invoice items.

[INVOICEECHARGESNUM] - invoice charges for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEECHARGES1234] - invoice charges for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number).

[INVOICEECHARGESNUM1234] - invoice charges for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number) displayed with a decimal point and no thousands separator.

[INVOICEEPAYMENTS] - invoice payments for unassigned invoice items.

[INVOICEEPAYMENTSNUM] - invoice payments for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEEPAYMENTS1234] - invoice payments for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number)

[INVOICEEPAYMENTSNUM1234] - invoice payments for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number)

[INVOICEENAME] - name of the invoicee account the invoice is assigned to or blank

[INVOICEECODE] - code of the invoicee account the invoice is assigned to or blank

[INVOICEECURRENCY] - currency of the invoicee account the invoice is assigned to if it is not the property default or blank

[INVOICEETEMPLATE1] - template value 1 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE2] - template value 2 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE3] - template value 3 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE4] - template value 4 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE5] - template value 5 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE6] - template value 6 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE7] - template value 7 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE8] - template value 8 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE1BR] - template value 1 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE2BR] - template value 2 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE3BR] - template value 3 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE4BR] - template value 4 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE5BR] - template value 5 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE6BR] - template value 6 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE7BR] - template value 7 of the invoice account the invoice is assigned to or blank with linkebreak

[INVOICEETEMPLATE8BR] - template value 8 of the invoice account the invoice is assigned to or blank with linkebreak

== Payment Request Variables ==
[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.

[PAYURL:200] - Creates a payment url for the payment request url for a fixed amount. nt.

[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.

[PAYLINK:200] - Creates a payment link (HTML A tag) for the payment request) for a fixed amount.

[PAYBUTTON] - Creates a payment button for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Not recommended for emails.

[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. Not recommended for emails.

[PAYBUTTON:200] - Creates a payment button for the payment request for a fixed amount.

[PAYPALURL] - Creates a Paypal payment url for the amount in the booking deposit field if non zero, otherwise the outstanding balance.

[PAYPALURL:25%] - Creates a Paypal payment url for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance.

[PAYPALURL:200] - Creates a Paypal payment url for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount.

[PAYPALLINK] - Creates a Paypal payment link (HTML A tag) for the amount in the booking deposit field if non zero, otherwise the outstanding balance.

[PAYPALLINK:25%] - Creates a Paypal payment link (HTML A tag) for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance.

[PAYPALLINK:200] - Creates a Paypal payment link (HTML A tag) for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount.

[PAYPALBUTTON] - Creates a Paypal payment button for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Not recommended for emails.

[PAYPALBUTTON:25%] - Creates a Paypal payment button for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance. Not recommended for emails.

[PAYPALBUTTON:200] - Creates a Paypal payment button for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount. Not recommended for emails.

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

== Text Operators ==

[REPLACE|searchForThisText|replaceWithThisText|textToSearch] - replace "searchForThisText" with "replaceWithThisText" within the text "textToSearch"

[SUBSTR|startCharacterNumber|numberOfCharacters|textToGetSubstringFrom] - get a sub string from "textToGetSubstringFrom" starting at character "startCharacterNumber" (integer, 0 is the first char) with a length of "numberOfCharacters" (integer)

[TRIM| string to trim ] - remove whitespace from the start and end of " string to trim "

== iCal Links ==
These template variables will create iCal links which allow the booking to be added to a calendar.

[ICALURL] - Calendar link

[ICALURL:16] - Calendar link with check-in hour. Replace '16' with the hour check-in starts.

[ICALURL::10] - Calendar link with check-out hour. Replace '10' with the hour with the hour check-out ends.

[ICALURL:::summary text] - Calendar link with a summary text

[ICALURL::::description text] - Calendar link with a descriptive text

Example:

Calendar link with check-in time 16:00, check-out time 10:00, the summary text "Booking" and the description text "Sunny Hotel":

[ICALURL:16:10:Booking:Sunny Hotel]

== Mathematical Operators ==

Place mathematical operators between two numbers <b>or between two template variables</b> that return a number.

[+] - Example: 2 [+] 3 = 5

[-] - Example: 5 [-] 1 = 4

[*] - Example: 3 [*] 4 = 12

[/] - Example: 15 [/] 5 = 3

[MIN] - Example: 2 [MIN] 3 = 2

[MAX] - Example: 2 [MAX] 3 = 3

Brackets are not supported as a way to control processing order, the processing order is fixed as *, /, +, -, MIN, MAX

If you want to use * and - in the same calculation, for example you need 20% of the result, then you will need to use the calculation below as a * calculation will be calculated first.

[INVOICECHARGESNUM][*]0.2[-][INVOICESECONDITEMNUM][*]0.2[-][COMMISSIONNUM][*]0.2

<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Property Template 1-8 and Room Template 1-8 can be used to set calculations. If using Room Templates to make a calculation, then use Room Template 8 before Room Template 7.

If you want to see the value 10.
Set Room template 6 = [ROOMTEMPLATE7][+][ROOMTEMPLATE8] and enter 4 in Room template 7 and 6 in Room template 8.

You can set a calculation in Room Templates to show in Property Templates, but not the other way around. So "Property Template1" could pull the calculation of [ROOMTEMPLATE6] and the result = 10.

=== Rounding and controlling decimal places ===

==== Default ====

2 [/] 3 = 0.66666666666667

==== Rounding to the nearest integer ====

2 [/.0] 3 = 1

==== Rounding to 1,2,3 or 4 decimal place(s) ====

2 [/.1] 3 = 0.7

2 [/.2] 3 = 0.67

2 [/.3] 3 = 0.667

2 [/.4] 3 = 0.6667

<b>This works on all operators including [MIN] and [MAX]</b>

Note: Always use the template variables ending with NUM. The math functions will only work with numbers with a decimal point (not a decimal comma) and no thousands separator and no currency symbol.

== Currency Conversion ==

[CONVERT:EUR-USD] - get the actual conversion rate between two currencies, this can be used with math functions to show alternative currency values. All currencies supported by the booking page currency selector can be used.

Example: [INVOICECHARGESNUM] [*.2] [CONVERT:EUR-USD] will convert the invoice charge value from Euros to USD with two decimal points.

If you use the multiplier to convert currencies for channels: For example hotel id 123456 and a multiplier to convert USD to EUR at todays rate:

123456*[CONVERT:USD-EUR]*

or this to convert EUR to USD

123456*[CONVERT:EUR-USD]

123456*[CONVERT:USD-EUR][/]0.85 will convert to Euros and divides the price by 0.85 which raises it by circa 15%

==Account Variables (account of the booking) ==

[ACCOUNTUSERNAME] - Username of the account owning the booking

[LOGGEDINACCOUNTUSERNAME] - Username of the person logged in

[ACCOUNTID] - account id of the booked property

[ACCOUNTTEMPLATE1] - Account Template 1

[ACCOUNTTEMPLATE2] - Account Template 2

[ACCOUNTTEMPLATE3] - Account Template 3

[ACCOUNTTEMPLATE4] - Account Template 4

[COMMISSIONLIMIT] - shows the available commission amount for the owner account of the booking

[MASTERACCOUNTTEMPLATE1] - Account Template 1 from master account

[MASTERACCOUNTTEMPLATE2] - Account Template 2 from master account

[MASTERACCOUNTTEMPLATE3] - Account Template 3 from master account

[MASTERACCOUNTTEMPLATE4] - Account Template 4 from master account

==Account Variables (logged in account, only for display in control panel , not for auto actions or emails etc.) ==
These variables can for example used by resellers who added a custom tab to the bookings.

[LOGGEDINACCOUNTID] - account id of the logged in user

[LOGGEDINACCOUNTTEMPLATE1] - Account Template 1

[LOGGEDINACCOUNTTEMPLATE2] - Account Template 2

[LOGGEDINACCOUNTTEMPLATE3] - Account Template 3

[LOGGEDINACCOUNTTEMPLATE4] - Account Template 4

[LOGGEDINAPIKEY] - apiKey

[MASTERLOGGEDINACCOUNTTEMPLATE1] - Account Template 1 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE2] - Account Template 2 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE3] - Account Template 3 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE4] - Account Template 4 from master account

== Smart Logic Template Variables ==

IF style template variables will compare two values and display a text if the comparison is true and an alternative text if the comparison is false.
Colons : are used between the two comparison values and the first text, a pipe | is used between the two texts.
Empty text is allowed if you do not want to display anything for a condition.

[IF=:if this:equals this:display this text|otherwise display this text]

[IFIN:if this:is contained in this:display this text|otherwise display this text]

[IFLIKE:if this:is like this:display this text|otherwise display this text]

[IF>:if this:is greater than this:display this text|otherwise display this text]

[IF>=:if this:is greater than or equal to this:display this text|otherwise display this text]

[IF<:if this:is less than this:display this text|otherwise display this text]

[IF<=:if this:is less than or equal to this:display this text|otherwise display this text]

[IFBETWEEN:if this:is between this:and this:display this text|if it is lower display this text|if it is higher display this text]

You can use IF variables inside other IF variables to create complex logic but the internal IF: must be processed before the external IF
There are special versions of each IF constructed with ^ and ~ separators like [IF=^this^this^same~different]
The special versions are processed first so should be used as the internal IF so it's result can be processed by the outer if.
The special versions can also be used if you expect : or | characters within your data.

IF's are processed in the following order.
i.e. all the [IF=^ will be processed first, then all the [IFIN^ etc.

[IF=^
[IFIN^
[IFLIKE^
[IF>^
[IF>=^
[IF<^
[IF<=^
[IFBETWEEN^
[IF=:
[IFIN:
[IFLIKE:
[IF>:
[IF>=:
[IF<:
[IF<=:
[IFBETWEEN:

=== Examples ===

Template variables can be used inside this template variable as per the examples <span style="color: #019cde">comparison in blue</span>, <span style="color: #75d5ad">positive result in green</span>, <span style="color: #fe746c">negative result in red</span>:

1. [<span style="color: #019cde">IF=:[GUESTNAME]</span><span style="color: #75d5ad">:Miller</span><span style="color: #75d5ad"><span style="color: #75d5ad">:yes</span> <span style="color: #fe746c">|no</span>]

If the guestname is Miller the text "yes" will display. If the guest name is not Miller the text "no" will display

2.[<span style="color: #019cde"> IF>:[NUMADULT]:2</span><span style="color: #75d5ad">:please contact us about you bedding requirements|</span>]

If the number of adults is higher than 2 the text"please contact us about you bedding requirements" will display. If the number of adults is lower than or equal 2 nothing will display.

3. [<span style="color: #019cde">IF<:[NUMADULT]:3</span><span style="color: #75d5ad">:|linen for two adults is included free of charge</span>]

If the number of adults is lower than 3 nothing will display. If the number of adults is not lower than 3 the text "linen for two adults is included free of charge" will display.

4. [<span style="color: #019cde">IF<=:[NUMADULT]:2</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|no</span>]

5. [<span style="color: #019cde">IF>=:[NUMADULT]:2</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|no</span>]

6. [<span style="color: #019cde">IFBETWEEN:[NUMADULT]:1:3</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|too low|too high</span>]

7. [<span style="color: #019cde">IFLIKE:[GUESTTITLE]</span><span style="color: #75d5ad">:Mr:Dear</span><span style="color: #fe746c">|Hi</span>]

IFLIKE works like IF= except it is case insensitive and removes any spaces from the start and end of the words

8. [<span style="color: #019cde">IFIN:John:[GUESTFIRSTNAME]</span><span style="color: #75d5ad">:Hi John</span><span style="color: #fe746c">|Your name does not contain John?</span>]

If the first word is contained in the second word the first option is displayed, otherwise the second option is displayed

9. [<span style="color: #019cde">IFIN:CHECKIN:[BOOKINGINFOITEMS]</span><span style="color: #75d5ad">:[BOOKINGINFOCODETEXT:CHECKIN]</span><span style="color: #fe746c">|</span>]

If the Booking Info Code CHECKIN has been added to the booking then you will see the value in the text (date/time) otherwise blank.

Using multiple IF statements to display special messages :-

10. [<span style="color: #019cde">IFIN:DEPOSIT:[BOOKINGINFOCODES]:|[IF=:[GUESTCOUNTRY2]:AU</span><span style="color: #75d5ad">:Credit card details are required </span><span style="color: #fe746c">|A deposit is required]|No deposit is required</span>]

You want to display a special message to Australians if the booking has a DEPOSIT info item code, if a deposit is required from a non Australia they get "A deposit is required" and if no deposit is required they see "No deposit is required"

11. [<span style="color: #019cde">IF<:[INADVANCE]:|[IFIN:TRANSFER:[BOOKINGINFOCODES]:3</span><span style="color: #75d5ad">:Payment Due Date: ASAP </span><span style="color: #fe746c">|Payment Due Date: [FIRSTNIGHT:- 30days]]|</span>]

You want display a special message to your guests 3 days before checkin with a Booking Info Code = TRANSFER.

12. [<span style="color: #019cde">IF=:[STATUS]:Confirmed:PAID|[IF<^[INADVANCE]^30</span><span style="color: #75d5ad">^Payment Due Date: As soon as possible</span><span style="color: #fe746c">~Payment Due Date: [FIRSTNIGHT:- 30 days]]</span>]

You want to display a special message for your guests for any bookings with Status not = Confirmed, and if the checkin date is more than 30 days in advance, then send the message with "Payment Due Date : "or that the "Payment is due As soon as possible".

13. [<span style="color: #019cde">IFBETWEEN:[TURNOVERDAYS]:0:3:</span><span style="color: #75d5ad">yes|</span><span style="color: #fe746c">no</span>]

You want to test if the days until next arrival into the same unit is between 0 and 3 days. Could be used for offering Late Checkouts or additional days to the guest where there is a gap between bookings.

14. [<span style="color: #019cde">IF>:[VACANTDAYS]:1:</span><span style="color: #75d5ad">yes|</span><span style="color: #fe746c">no</span>]

You want to test if there is 1 day from the previous checkout to check in of current booking. Could be used for offering Early Checkouts or additional days to the guest where there is a gap between bookings.

== Write out the number in Words. ==

[INWORDS] - writes out a number in words. This works in English only.

Expamles:

[INWORDS] 10 will write out then

[INWORDS] [INVOICEPAYMENTSNUM] will write out the invoice sum of all payments

[INWORDS] [INVOICEPAYMENTSNUM] [+] 10 will write out the invoice sum of all payments plus 10

== Encoding Template Variables ==

[ENCODEURL:value] encode value for URL data format

[ENCODEJSON:value] encode value for JSON data format

Note: Always use the template variables ending with NUM if numbers are involved. The math functions will only work with numbers with a decimal point (not a decimal comma) and no thousands separator and no currency symbol.

Auto Actions

2022-03-14T17:05:39Z

Marco: /* Add a pending payment - Set the Security Deposit value based on the price of the booking, using a calculation */

[[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====
</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 ====
</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 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 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 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 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 = 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>

===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:
*Type = Amount
*Description = Cleaning fee (for example)
*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>

===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)

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 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

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 = After 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>

===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>

Auto Actions

2022-03-14T17:04:49Z

Marco: /* Add a pending payment - Set the Security Deposit value based on the price of the booking, using a calculation */

[[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====
</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 ====
</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 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 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 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 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 = 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>

===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:
*Type = Amount
*Description = Cleaning fee (for example)
*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>

===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)

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
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 Info tab: Optional
*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 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

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 = After 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>

===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>

Hotelbeds.com

2022-02-16T18:01:58Z

Marco: /* Charge Virtual Credit Cards */

[[Category:Channel Manager]]
[[Category:Error Messages from Channels]]
[[Category:Troubleshooting]]
<div class="heading">Hotelbeds</div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOTELBEDS and explains how the connection with Hotelbeds works and how to set it up.
http://www.hotelbeds.com

This connection to Hotelbeds will also update GTA and Tourico Travel.
__TOC__
==General==
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].

==Capabilities==
*Beds24 can export inventory
*Beds24 can export rates. We send ONE ROOM price. If you have multiple rates by default the lowest price will be sent.
*Beds24 can export minimum stay
*Beds24 can import bookings
*Beds24 can import changes to bookings

For details please [[Channel_Manager_Capabilities|click here]]

==Limitations==
*Rates - Only the ROOM price is sent.

== 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]].
*Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.

'''Bookings'''

New Bookings are imported.

Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.

'''Extras and Taxes'''

"Upsell Items" can not be exported.

'''Credit Cards'''

If you want to access credit card details through Beds24 ask Hotelbeds to only accept bookings with credit card details and always send all details to Beds24.

'''Rooms and room types'''

If you sell rooms individually at another channel or your own web site and want to sell them here as a "roomtype" with a quantity of more than one you can [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]].

==You need==
*Hotelbeds username
*Hotelbeds password
== Hotelbeds ==
Contact Hotelbeds support with your Hotelbeds username which you are using to access the Hotelbeds extranet and ask them to connect with Beds24. Include following information in the email:

1. The URL where the reservations will be sent is: https://api.beds24.com/hotelbeds.com/booking

2. The email address where the reservations will be sent in case Beds24 cannot process them.

Hotelbeds will notify you when the BMS connection is ready.

== Set Up ==
Once you have this confirmation from Hotelbeds enter:
*Enter your Hotelbeds username into the field "Username"
*Enter your Hotelbeds password in the field "Password".

==Beds24==
Click on the "Get Contract List" link to access your contract list.

Enter account data:
*Enter your Hotelbeds Hotel Code into the field "Hotel Code"
*Enter your Hotelbeds Contract Name in the field "Contract Name".
*Enter your Hotelbeds Sequence into the field "Sequence"
*Enter your Hotelbeds Office Code into the field "Incoming Office Code"

Press SAVE.

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

== Map rooms ==
Click on the "Get Contract Detail" link to access your contract details.

For each room you want to connect:
*Enter your Hotelbeds Room Code into the field "Room Code"
*Enter your Hotelbeds Room Characteristic into the field "Room Characteristic"

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

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Click on the "View Actual Data" Button to check which prices and availability will send.

== Multiple contracts ==
Specify the first contract in the channel manager settings. Make sure "Hotelbeds" is ticked in the "Channels" tab of all rates you want to send to this contract.
Multiple contracts require rates to be defined for each contract.

Open the rates or daily prices you want to send to the second contract.
*In rates go to the "Channels" tab. Tick "Hotelbeds" and enter the contract name and sequence for this contract separated by the / symbol.
* Daily Prices, scroll down to 'Enable List' Tick "Hotelbeds" and enter the contract name and sequence for this contract separated by the / symbol under "Enable" in the Daily Price settings.
Example: NRF-BAR/45678

If the office code for the contract is different to that set in the channel manager settings, it can be specified as a third item in the rate setting.

Example: NRF-BAR/45678/164

Daily prices and rates in which you have not specified a contract will send only to the first contract.

[[Image:hotelbeds2.png|350px|link=]]
[[Media:hotelbeds2.png|view large]]

== Activate ==
You can view the live availability and prices that will be sent to Hotelbeds before or after activating using the "View actual data" button.

When everything is correct tick "Inventory", "Prices" and "Bookings" to activate the connection.

==Price Multiplier==
If you want to add a multiplier to your prices - perhaps because Hotelbds requires a different currency to your Beds24 currency - add a '''*''' followed by the multiplier number to your Contract Name.

For example a Contract Name setting '''ABC*1.23''' will multiply all prices by 1.23 sent for Contract Name ABC. (i.e. raised by 23%)
Lower prices can be sent with a multiplier less than 1, i.e. '''ABC*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 12345678*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.

== Check Connection ==
The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.

== Updates and Changes==
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.

==Manage bookings ==
By default the payout amount is imported into the "Invoice" tab of new bookings. After you have chosen your sync option you can change this option in SETTINGS-CHANNEL MANAGER "Invoice" = Booking Amount if you want to import the amount the guest pays. If you use this option the lodging amount and cleaning fee will be shown separately.

If you need a different invoice template for the bookings from this channel you can use the invoicee function. Enter the ID number of the invoicee and all incoming bookings from the channel will be assigned to this invoicee (it does not change existing bookings.

====Charge Virtual Credit Cards ====
Virtual cards can be set to be auto charged at the date they become valid. To use this option set "Auto Process Virtual Cards" = Yes

Virtual cards can be set to be auto charged at the date they become valid.

<div class="warning">{{#fas:exclamation-triangle}} This option is available for customers who use [[Stripe|Stripe]]. If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.</div>

A payment rule can be specified to be attached to the pending payment, the payment rule can further manage the conditions to collect the payment, for example it could specify to use virtual cards only and not a guest card.

You can only select a "payment rule" in Hotelbeds.com after you have created one.
Settings > Payments > Payment Rules and set Payment Source = Virtual card only > then select the payment rule in the channel manager setup for Hotelbeds.com

If you manually charge virtual credit cards please note that they can only be charged after the card activation date.

====Info Codes====
Info Codes in the "Info" tab of the booking show you relevant information.

{| class="wikitable"

! scope="col"| Code
! scope="col"| Use
|-

| VIRTUALCARD
| virtual card was sent from the channel
|-

|CARDTOSTRIPE
| card details were sent to Stripe
|-

|STRIPEPAYMENT
| payment imported from Stripe
|-

|STRIPEFAIL
| card could not sent to Stripe
|-

|CARDEXPIRES
| added when the card expires before check-in
|-

|}

== Common Errors ==
'''Incorrect user or password'''
Check if your username password and hotel code are entered correctly. .
If yes send and email to hotelconnect@hotelbeds.com and ask them to check the connection with Beds24 is activated.

'''This change is not permitted as it does not agree with the signed contract.'''
You have a contracted allotment or restriction (for example on the minimum stay you are allowed to send) in Hotelbeds. Click on the "Get Contract Detail" link to check if/which minimum stay restriction (MLOS=X) applies. Make sure the data you send from Beds24 complies with your contract with Hotelbeds.

== Notes ==
*If you want to sync only inventory and have multiple contracts you need a rate for each contract with a price. In the "Channels" tab of the rate deselect "Hotelbeds" and if will not send.

VRBO Setup

2022-02-07T16:44:39Z

Marco: /* Pictures */

[[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/HOMEAWAY > ACCOUNT and {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO/HOMEAWAY > 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/Homeaway)
*Update existing listings on VRBO
*Export prices and availability
*Import bookings
*Send date changes and status changes to "Cancelled"

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/Homeaway) because changes you make in VRBO/Homeaway 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.

= Limitations =
*VRBO/Homeaway do not allow same day bookings.
*Most agencies/property managers can use VRBOs XML connection. In some regions VRBO applies minimum requirements. If you are not eligible your can use our [[Homeaway.com_iCal| VRBO iCal]] connection to synchronise calendars.

<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/Homeaway 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.

= Setup =
VRBO/Homeaways 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 / Homeaway 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/HOMEAWAY > 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 on hand'''

During the onboarding process VRBO will ask you to enter your credit card.

'''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/HOMEAWAY > 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/HOMEAWAY > 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/HOMEAWAY > 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 - 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"

= VRBO/Homeaway.com Offline Bookings / Data protection=
VRBO requires you mark bookings which originated from a VRBO/Homeaway enquiry by setting the Referer value on the "Details" tab of the booking to '''VRBO'''. VRBO/Homeaway requires you to enter the guests Email address in the booking.

VRBO/Homeaway 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/Homeaway with their next poll.

= Cancellations =
If you set a booking to "Cancelled" we will send it as "Cancelled by guest" to VRBO/Homeaway. If the booking is cancelled by the owner you can set this as a "substatus" via the second selector next to the "Cancelled" status in the "Summary" tab of the booking.

If a different reason for the cancellation applies you can set this by adding one of the following info codes in to "Info" tab of the booking:

CANCELLED_BY_OWNER

CANCELLED_BY_OWNER_INVALID_CARD

CANCELLED_BY_OWNER_NO_PAYMENT

CANCELLED_BY_OWNER_UNIT_NOT_AVAILABLE

<div class="warning">{{#fas:exclamation-triangle}} Never delete bookings from VRBO/Homeaway because VRBO/Homeaway 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 imported you can change the price and manually sent the guest a confirmation with the revised price.

Beds24 will automatically send the amened 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/Homeaway will inform you which language is compulsory. It is the language of the VRBO/Homeaway 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/Homeaway > 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 > 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 / HOMEAWAY > SPECIFIC ROOM CONTENT.

==== Minimum Requirements ====
To send property information to VRBO/Homeaway, the following information must be entered into Beds24 to meet the VRBO/Homeaway 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" butten
*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/Homeaway does not support all features Beds24 offers. For a list of all feature codes VRBO/Homeaway supports see "All feature codes" below.

==== Amenities, Features and Location Type====
Amenities and Location Type can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).

Criteria which apply to all rooms in the property should be set up with the property. They will be automatically applied to all rooms in the property.

Criteria which only applies to one room should be entered in the room.

Make sure you do not create duplicates.

Example 1: All units (rooms) have Internet. In this case you can set up the Internet in 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/Homeaway supports see "All feature codes" below.

==== Prices ====
In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO/Homeaway > SPECIFIC ROOM CONTENT you can set which type of price you want to send.

With '''Per Occupancy Pricing''' a price for each occupancy defined in Beds24 and prices for different length of stay can be sent.

If you use rates 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.

"Max Stay" set in the CALENDAR or rates can be sent.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> VRBO/Homeaway 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/Homeaway with different minimum stays the system will send the price with the lowest minimum stay. VRBO/Homeaway 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/Homeaway 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/HOMEAWAY > 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/Homeaway.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/Homeaway.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/Homeaway 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.

==== 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/HOMEAWAY > SPECIFIC ROOM CONTENT.

==== Policies ====
You can set the minimum age via a "Custom" value in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT.

===== Cancellation Policy =====
VRBO/Homeaway requires a cancellation policy. We will send the policies set in SETTING->PROPERTIES-> DESCRIPTION.

You can 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 actual policy in "Custom" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO > SPECIFIC ROOM CONTENT.
Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for detailed instructions.

===== 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.

==== 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/Homeaway.COM > SPECIFIC PROPERTY CONTENT.

If payments are due at different times you can set up payment schedules in {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > VRBO > PAYMENT SCHEDULE and link it to your property in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > VRBO/Homeaway.COM > SPECIFIC PROPERTY CONTENT.

If you have set up deposit collection in {{#fas:cog}} (SETTINGS) PAYMENTS- > PAYMENT COLLECTION we will send the deposit amount set there to be due at the time of the booking and the remainder if any at arrival.

<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 to set up to five payments.

In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER -> VRBO/Homeaway.COM > SPECIFIC PROPERTY CONTENT you can set which payment types you accept. Beds24 supports 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/HOMEAWAY.COM > SPECIFIC CONTENT "Payment Options Description "

2. Credit Card

The cards you have activated in {{#fas:cog}} (SETTINGS) PAYMENTS -> PAYMENT GATEWAYS -> CREDIT CARD will be sent as accepted cards.

If you do not receive a credit card with the booking and require a payment prior to the guest arrival, you can use an Auto Action to request payments from guests.

You can collect their credit card details to charge manually see [[:Category:Payments#Request Guests to Submit Credit Card Details|Here]] via your payment gateway,
or automatically if you use the Stripe Integration see [[:Category:Payments#Payment_Request|Here]] 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/Homeaway.

<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.

= 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 and a crib
BEDROOM BED_DOUBLE BED_CRIB

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_CRIB

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/Homeaway-> VIEW CONTENT to check if you content meets VRBO/Homeaways requirements. Any settings which do not meet VRBO/Homeaways requirements are highlighted on red. Click on the links in the "Settings" column to go to the settings where you can fix the problems.

Auto Top up rooms

2021-11-02T14:14:11Z

Marco:

[[Category:How to]]
[[Category:Bookings]]
[[Category:Rooms]]
[[Category:Room Linking and Dependencies]]
[[Category:Enhanced_Selling]]
<div class="heading">Auto Top up rooms</div>

This page explains how to offer only a limited number of your rooms for sale and add increase the inventory whenever one room is booked.
__TOC__
=Use=
You can use this method if:

You have a number of individual rooms connected to individual listings at a channel and want to limit the number of rooms you offer at any one time.

<div class="warning">{{#fas:exclamation-triangle}} If you are using dependencies please test thoroughly to make sure your set up reflects your rules. If you are connecting one physical room more than once to a booking channel you are risking overbookings.</div>

=How it works=

Bookings are assigned to the 'real' room (Top-up).
The virtual room (Double) will control the maximum number of units available in Top-up

The total number of units/rooms available will show as the lower number and will be 'topped - up' as each new booking is created in the calendar, until the total bookings meet the total inventory.

=Set up=

'''Example:''' A hotel has 10 double rooms. They want to offer only 2 rooms for booking and open an additional room whenever they receive a booking.

'''Step 1: Create "real" room'''
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS and add a room
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP
**Give room a Name "Top-up"
**Set "Quantity" = 10
**If you do not want to show the room on the booking page set Sell Priority = Hide (optional)
**Set Overbooking Protection =Property
**Use the context help <span style="color:#007bff;“ >{{#far:question-circle}} </span> for further setup instructions.

'''Step 2: Create a virtual room (Double)'''

*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS and add a room
*Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP
**Give the room a Name "DOUBLE"
**Set "Quantity" = 2
**Set all other settings to the same characteristics as your "real" room
**If you do not want to show the virtual room on the booking page set Sell Priority = Hide (optional)
**Set Overbooking Protection =Property

'''Step 3: Set dependencies for the virtual room '''

'''Double'''

Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DEPENDENCIES and set:
*Requires Availability in = Top-up
*Combination Logic = Any room must be available
*Assign Bookings to = Top-Up

'''Top-up'''

Go to {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DEPENDENCIES and set:
*Use Prices from = Double (Double needs prices for availability calculation)

'''Step 4: Check existing bookings'''

If you already have bookings in the virtual room type you need to move them to one of the real room

=Manage bookings=
<div class="warning">{{#fas:exclamation-triangle}} If you manually add a booking you need to do this in the "real" room not in the virtual room.</div>

Booking.com: Synchronise bookings prices availability

2021-10-27T15:13:17Z

Marco: /* 6. Activate in Beds24 and Booking.com */

[[Category:Channel Manager]]
[[Category:Booking.com]]
[[Category:Troubleshooting]]

<div class="heading">Booking.com: Synchronize Bookings, Prices and Availability</div>
This page is about the menu {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > BOOKING.COM > MAPPING and explains how to export prices, availability, rules and import bookings, modifications to bookings and cancellations for existing listings on Booking.com

Use [[Booking.com:_Import_Properties_from_Booking.com_to_Beds24|these instructions]] if you want to import properties from Booking.com to Beds24.

__TOC__
=Capabilities and limitations=
These instructions explain how to connect existing listings on Booking.com. If you do not yet have a listing and/or a Booking.com accout you can [[Booking.com:_Create_and_update_properties_and_rooms_on_Booking.com|create it directly from Beds24]].

With this connection you can
*export prices, availability
**send inventory (available rooms)
**send minimum stay
**send maximum stay
**send closed to arrival and closed to departure
**send multiple rates
**add a multiplier to mark prices up or down.
*import bookings, modifications to bookings and cancellations, importing modifications or cancellations can be disabled for individual bookings
*create Booking.com rate plans
*report invalid cards and no-shows can be reported to Booking.com from the "Details" tab of the booking. If you use Stripe you can set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER to automatically report invalid cards to Booking.com
*create and manage promotions
*view reviews and react to reviews

If you want to export inventory Booking.com demands prices to be sent from Beds24 so you will not be able to set in the Booking.com extranet after the connection has been enabled.

Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays, or quantity of rooms or the multiplier will send with the next update. Click on "Update" if you want to push them through instantly.

Credit card details are imported and shown on the "INVOICE" tab of the booking. If not please refer to "Missing credit card details" in "Troubleshooting" section below.

Bookings with payment collected by Booking.com will show the payment amount collected as a payment in the "Invoice" tab of the booking.

=Before you connect=
==Familiarize yourself with the channel manager==
<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> [[:Category:Channel Manager|Learn]] how the channel manager works.

==Make sure you have suitable prices set up in Beds24==
<div class="warning">{{#fas:exclamation-triangle}} When the connection is activated, Booking.com will remove all price and availability details on the Booking.com extranet and replace them with the data sent from Beds24. Therefore prices and availability of all rooms must be set up in Beds24 before connecting. </div>

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]].

Our connection with Booking.com supports these pricing models:

1. '''Per Occupancy Pricing (OBP)''' RECOMMENDED - If your Booking.com Rate Type is Per Occupancy Pricing a price for each occupancy defined in Beds24 can be sent. Set the Booking.com Rate Type to '''Occupancy'''.
*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 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.

2. '''Per Day Pricing (Standard)''' - If your Booking.com Rate Type is "Per Day Pricing / Standard" you will need a price for the maximum room occupancy.
*If maximum number of guests is 4 you need a ROOM price for four guests. Prices for 1, 2 or 3 guests are not sent.
*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. The price for the extra person will not send.
*If you have multiple prices for one rate code which are activated for Booking.com the system will use the price for the highest occupancy.
*If you want to send an additional "Single" price Booking.com needs to activate the single price option. After this is done you can set the Booking.com Rate Type to '''Per Day Pricing + Single'''.

3. '''Derived Prices (RLO)''' - If Booking.com has set up derived (RLO) prices for you where Booking.com calculates prices for different occupancies from the standard price sent from Beds24 set the Booking.com Rate Type to '''Per Day Pricing'''. <span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> With derived (RLO) prices Booking.com do not allow you to send a single price. We recommend you use "Per Occupancy Pricing" instead so you can control all prices from Beds24.

*If you want to offer multiple price options for example a non-refundable rate or your rate plan contains meals you can create additional rate plans in [[Booking.com:_Create_Booking.com_Rate_Plans_in_Beds24|{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > RATE PLANS]].

For '''dorms''' Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Make sure you set "Booking.com Rate Type"= Per Day Pricing. If you want to send a single price for other rooms you can create additional rate plans for single use in [[Booking.com:_Create_Booking.com_Rate_Plans_in_Beds24|{{#fas:cog}} (SETTINGS) CHANNEL MANAGER->BOOKING.COM > RATE PLANS]].

<span style=color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Booking.com does not support occupancy pricing for dorms. If you have dorms log into your Booking.com account and change your pricing model to "Standard" and set the Pricing model in Beds24 to "Per Day".

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].

==Extras, taxes and credit card rules in your Booking.com extranet==
"Upsell Items" can not be exported to Booking.com. If required you can enter extras and fees directly in Booking.com.

If you have set up additional taxes in {{#fas:cog}} (SETTINGS) PROPERTIES > UPSELL ITEMS that have the exact same name as your additional taxes in Booking.com, they can be imported as taxes during the booking import.

Booking.com does not send a tax rate for extras. Therefore, for extras, the VAT rate of the accommodation is applied by default. If an extra (e.g. breakfast) has a different tax rate, this vat rate can only be applied to imported bookings, if you have an extra with the exact same wording in {{#fas:cog}} (SETTINGS) PROPERTIES > UPSELL ITEMS.

If you want to access credit card details through Beds24 ask Booking.com to only accept bookings with credit card details and always send all details to Beds24.

==Make sure your rooms and room types in Beds24 match your set up in Booking.com==
If you sell rooms individually at another channel or your own web site and want to sell them on Booking.com as a "roomtype" with a quantity of more than one you can [[Combine_individual_rooms_into_a_roomtype|set up virtual rooms]].

==Disable the auto opening rooms after cancellations==
Beds24 will automatically reopen rooms when you have availability. If you have this feature enabled Booking.com will not wait for the an update sent from Beds24 but will automatically re-open the closed room when a guest cancels even if you have a booking from another source. You can opt-out of the feature by following these steps:
*Log into your Booking. com account
*Click on the Rates & Availability tab
*Go to the Settings symbol on the top-right corner of your Calendar
*Click on Auto-Replenishment
*Under Calendar Settings, click "No" to turn off the Auto-Replenishment feature

=The set up process=
Setting up the connection is a 4 step process:

1) You request a connection on Booking.com extranet. Nothing changes. You are still bookable according to the prices and inventory you have set in the Booking.com extranet.

2) Beds24 accepts your request. Nothing changes. You are still bookable according to the prices and inventory you have set in the Booking.com extranet.

Between step 2 and 3 you should map your rooms and rates, check everything and import existing bookings from Booking.com to block the booked dates.

3) You enable the connection in Booking.com. This is when Booking.com removes your inventory and rates and you are temporarily not bookable.

4) Beds24 sends prices and availability to Booking.com. You are bookable again. To send the update immediately click the "Update" buttons in the channel manager settings.

Bookings are not removed from the Booking.com extranet. Existing and new bookings are always visible in the Booking.com extranet.

==1. Initiate the connection in Booking.com==
Initiate the connection from the property menu within the booking.com extranet and then do the Beds24 setup.

1) Login to Booking.com and go to ACCOUNT > CONNECTIVITY PROVIDER. If you do not see this option contact Booking.com support and tell them you want to use a channel manager

2) Search for BEDS24.

3) Tick all tick boxes.

[[Image:extranet-booking.png|500px|link=]]
[[Media:extranet-booking.png|view large]]

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> For a two-way connection you need to select both "Reservations" and "Rates and Availability". Beds24 can then both export inventory to Booking.com and import bookings from Booking.com. If you select only "Reservations" or only "Rates and Availability" you only have a "one-way" connection meaning the action you did not select must be manually maintained by you.

4) Complete the rest of the on screen instructions.

<div class="warning">{{#fas:exclamation-triangle}} Booking.com does currently offer two options:
*If you choose "Connect me automatically to the provider" Booking.com will instantly remove your prices and availability. Choose this option only if your have check that your prices in Beds24 are all set up and ready to send.
*If you choose "Dont connect me automatically to the provider" you can confirm the connection after you have done the setup in Beds24.
</div>

5) When ready you will receive a notification from Booking.com, go to the Channel Manager menu again and activate the connection.

==2. Set up and mapping in Beds24==
1) Enter your Booking.com Hotel Id into SETTINGS -> CHANNEL MANAGER -> BOOKING.COM "Hotel ID" setting and choose your "Booking.com Rate Type". Then scroll to the bottom of the page and click SAVE'''.

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

2) Set "Booking Price Import" to either import the room price only or the room price plus unpaid extras (cleaning charges, local taxes etc.)

3) Some Booking.com rate ids can accept a room price plus a single occupancy price on the same rate id. If you have this rate type and want to send the single occupancy price set "Booking.com Rate Type " = "Per Day Pricing + Single". If you do not have this rate type or you are not sure set "Booking.com Rate Type "= " Per Day Pricing"

4) Mapping

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

Map Rooms:
*Click on the "Get Code" link next to the room id setting, a list of room ids will be retrieved from Booking.com and displayed.
*Choose the Booking.com room you want to map to the Beds24 room and click on it.
*When the correct room id has copied to the room id setting, click Save.

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

Map Rates:
*Click on the "Get Code" link next to the rate id setting and a list of rate ids will be retrieved from Booking.com for the saved room id.
*Choose the Booking.com rate id for this room and click on it. This will normally be the standard rate.
*When the correct rate id has copied to the rate id setting, click Save.

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

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> Click on the "View Actual Data" Button to check which prices and availability will send.

==3. If you have different price options i.e. refundable/non refundable rates, meal plans==
Booking.com can support more than one price per room and day.

If you need additional rate plans, for example a for different occupancies, or a non-refundable rate, or your rate plan contains meals, you can create additional rate plans in [[Booking.com:_Create_Booking.com_Rate_Plans_in_Beds24|{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > RATE PLANS]].

[[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these mapping instructions if you have multiple rate codes]].

==4. If you want to mark your prices for Booking.com up or down or need currency conversion==
You can add a multiplier to your prices, add a '''*''' followed by the multiplier number in the "Multiplier" field

Examples:
*'''*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: '''*0.85''' will send 85% of the normal price (i.e. lowered by 15%).
*To convert the price of bookings imported from the channel add a '''*''' AFTER the multiplier. '''*1.23*''' will divide the price of the booking by 1.23.
*For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
**'''*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.
**'''*[CONVERT:IDR-EUR][/]0.85''' will convert Indonesian Rupees to Euros and lower the price by 15%.

==5. Limit the maximum number accepted bookings if you do not want to offer all rooms ==
By default all available rooms are sent to activated channels. In {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > CHANNEL INVENTORY limit the number of accepted bookings for this channel.

==6. Activate in Beds24 and Booking.com==
1) You can view the live availability and prices that will be sent to Booking.com before or after activating using the "View actual data" button.

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

2) Make sure your inventory is correct in Beds24. Check existing bookings in Booking.com imported and dates blocked by other sources are blocked in Beds24. Dates can be blocked by either entering a booking manually into Beds24 for those dates or using the inventory and override functions on the control panel calendar for those dates. Failure to do this could allow new bookings on dates you are not available. All available dates in Beds24 will be sent to Booking.com as available for new bookings.

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

3) Enable the connection in Beds24 by ticking "Inventory and Rates" for each mapped room and saving. The "Bookings" checkbox should already be ticked but tick it as well if it is not ticked and bookings should be imported.

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

4) When all the set up in Beds24 is correct you can make the final step to confirm the connection (go live) from the Booking.com extranet.

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

You have to / can do this only if you initially selected "Dont automatically connect me to the provider".

When you go live your rates and inventory will be deleted from Booking.com and a full reload will occur from your Beds24 Inventory.

You can use the "Update" button on each room to speed this up. Your bookings will not be deleted from Booking.com but make sure the dates are blocked in Beds24 before going live so they will not be reopened.

5) Click on "Get Connection Status" to see the connection is properly activated.

6) Import existing bookings from Booking.com (all upcoming bookings)

Make sure the "Bookings" check box for each mapped room is ticked and saved and then click the "Import existing bookings" button.

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

If for any reason your existing bookings do not import, the dates could be reopened and resold. To prevent this import the bookings via CSV.

a. Export your bookings as CSV from booking.com
b. Go to https://api.beds24.com/csv/putbookingcomcsv.php and import the csv file to Beds24.

Follow the instructions on the page carefully so they import to the correct rooms.

If this is also unsuccessful, block the booked dates in the beds24 calendar. Please note that in this case cancellations and modifications will not be imported automatically.

7) Once updated, check all your values in the Booking.com extranet for correctness and if required make any adjustments to the settings to fix.

8) Channel collect payments will be shown in the booking invoice if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER “Import Channel Collect Payments” is set to “Yes”.

9) You can allow cancellation fees and commission values to overwrite booking values when cancelled by channel if {{#fas:cog}} (SETTINGS) CHANNEL MANAGER “Import Cancel Fees” is set to “Yes”.

== 7. Check that the connection is working properly ==
The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.

== Setup problems==
1) The room is being unexpectedly closed at Booking.com

The channel manager will close the room on all dates which do not have a valid price available for sending to Booking.com. Make sure you have prices for the complete range of dates you are sending (1 year or 2 years)

2) "Room code is not unique" warning when saving in Beds24.

Each Booking.com room id is unique and can be mapped to only one room in Beds24. If you enter the same Booking.com room id more than once the room updates will overwrite each other causing inaccurate information being sent to Booking.com

=Create and manage Booking.com promotions=
Promotions can be created, modified and deactivated in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING-COM >PROMOTIONS.

[[Booking.com:_Promotions|Click here for more information and setup instructions.]]

=Manage bookings=
==Communication with guests==
You can communicate with Booking.com guest directly from Beds24.

You can view all messages which Booking.com makes available from the "API Messages" component on the DASHBOARD and individual communication from the "Messages" tab in the booking.

You and your guests will see the messages in Booking.com Messaging Center.

Currently messaging with guests from Booking.com has following limitations:
*Guests must click on "View Messages" in the email to login to Booking.com and answer from there.
*If a guest hits "reply" on E-mail they received from Booking.com, Booking.com does not send the reply to Beds24 and will also not make the reply available in Booking.com.

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 on the "Messaging" tab in the Auto Action to one of the API options.

3. Bookings need to be in a Property that is connected to Booking.com to use the Message API, otherwise communication will be via Email.

==VAT value on extra items==
If an extra item name in the booking matches the name of an upsell item for the property, the VAT value of the upsell item will be used.
Otherwise the VAT value defined in the Property booking rules will be used.

==Report No-shows, Invalid cards or restrict channel modifications==
This screenshot shows specific settings for bookings from Booking.com:

[[Image:bookingcom_manage.png|800px|link=]]
[[Media:bookingcom_manage.png|view large]]

If you want to not allow channel modifications by default you can change the setting for "Allow Channel Modifications" value" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER.

<embedvideo service="youtube">https://youtu.be/T-I3CnXnvZQ</embedvideo>

==Charge virtual credit cards ==
Virtual cards can be set to be auto charged at the date they become valid. To use this option set "Auto Process Virtual Cards" = Yes

Virtual cards can be set to be auto charged at the date they become valid.

<div class="warning">{{#fas:exclamation-triangle}} This option is available for customers who use [[Stripe|Stripe]]. If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.</div>

If you manually charge virtual credit cards please note that they can only be charged on the check-out date.

==Different invoice templates ==
If you need a different invoice template for the bookings from this channel you can use the [[Invoicees|invoicee]] function.

==Reviews==
To access Booking.com reviews from your DASHBOARD unlock the DASHBORAD click on the hamburger menu then on "Extentions" and add the Booking.com Review Module.

==Info Codes==
Info Codes in the "Info" tab of the booking show you relevant information.

{| class="wikitable"
! scope="col"| Code
! scope="col"| Use
|-

| BOOKINGCOMCARD
| invalid card reported to Booking.com
|-

| BOOKINGCOMFLAG
| Booking.com general info flag (Genius/no credit card)
|-

| BOOKINGCOMVIRTCARD
| Booking.com sent a virtual card
|-

| BOOKINGCOMBANKTRANS
| booking paid via bank transfer from Booking.com
|-

|CARDTOSTRIPE
| card details were sent to Stripe
|-

|STRIPEPAYMENT
| payment imported from Stripe
|-

|STRIPEFAIL
| card could not sent to Stripe
|-

|CARDEXPIRES
| added when the card expires before check-in
|-

|}

= Updates and Changes=
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.

=Disconnect=
*Unticking "Inventory and Prices" and "Bookings" will stop Beds24 sending data to Booking.com. This will not remove the data from Booking.com and it will still be bookable.
*To completely disconnect the channel manager please log into your Booking.com extranet and click on the Account icon in the top right-hand corner. Select Channel Manager from the drop-down menu. Click the Deactivate button to cancel the connection to Beds24.

=Trouble shooting=
==Deleting a rate or price in Beds24 will not delete the price in Booking.com==
If you need to close a rate at Booking.com, make the rate id unbookable at Beds24, for example by closing the room or removing the price and wait for it to update at Booking.com. Only once the rate has closed at Booking.com it is safe to remove it from Beds24.

You can close a rate at booking.com by making sure there is no price for it on the dates to close in Beds24.
As long as the rate has at least a price for 1 day in the next year, all the other dates without prices will be closed.

If you have multiple rates at booking.com, the other rates can continue to be available by giving them prices.

Note that if there is no price on any day at all for a rate, this will not necessarily close the rate, in this case no information will be sent and whatever data is in Booking.com will remain.

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> Click on the "View Actual Data" Button to check which prices and availability will send.
==Missing credit card details==
When Booking.com sends the credit card number it will be available in the "Payments and Charges" tab of the booking unless it has been stored in a third party system such as Stripe.
The encoded CVC number is available from the booking notification email sent to the host as the line labelled Security Code. Enter the Security Code value from the email into the booking to view the CVC.

*If there is no Security Code item in the host notification email, the CVC was not collected or sent for this booking. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information.
*If credit card details are always missing and you require them, please ask Booking.com to collect and send credit card details to Beds24
*If Booking.com normally sends credit card details but did not do so for a specific booking and you always want a card as security, please ask Booking.com to exclusively accept bookings with a credit card number.

==No Room codes are available==

During the Setup of your connection, click on 'Get the Booking.com Room and Rate Codes for this "Property Code"'

You will see the list of Rooms/Rate codes returned from Booking.com. If Booking.com does not make any rooms available. If you are sure you have rooms please forward the RUID to Booking.com support and ask them to check why they do not return any rooms.

==Error messages==
Any errors reported by Booking.com will be emailed to you with the error message as returned by Booking.com.
The error message usually includes information about the date, rate or room with the problem and a brief description.
Below are common error messages and how to fix them.

'''Access denied while trying to get rooms for hotel XXXXXX '''
Check if you have received a notification from Booking.com that the connection is ready.
*If not please check in the Booking.com extranet that the connection has been requested.
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
*Click on "Connection Status" to check that the connection is properly activated.
**If you see "Status" = Pending Property you need to confirm the connection in your Booking.com Extranet as explained under „Activating in Beds24 and Booking.com“ step 4 (https://wiki.beds24.com/images/1/16/Bookingconfirm.png).

'''Access denied''' or '''Hotel not allowed for connection type'''
*Click on "Connection Status" to check that the connection is properly activated.
**If you see "Status" = Pending Property you need to confirm the connection in your Booking.com Extranet as explained under „Activating in Beds24 and Booking.com“ step 4 (https://wiki.beds24.com/images/1/16/Bookingconfirm.png).

'''Updating availability hasn't been enabled for hotel 0000'''
You have not activated the connection in the booking.com extranet. Please log into your booking.com extranet and activate the connection.

'''SINGLE_USE_PRICING_PASSED_FOR_RLO_RATE or OBP_PRICING_PASSED_FOR_SINGLE_USE_RATE'''
Booking.com does not allow you to send a single price.
Set "Booking.com Rate Type"= Per Day Pricing

'''OBP_PRICING_PASSED_FOR_DEFAULT_RATE'''
Your Booking.com Rate Type is "Per Occupancy". The system will automatically adjust your rate type so prices for different occupancies can send.

'''OBP_PRICING_PASSED_FOR_RLO_RATE'''
Your Booking.com Rate Type is "Per Day Pricing". Booking.com will automatically adjust your rate type so prices for different occupancies will be displayed in Booking.com.
Set "Booking.com Rate Type"= Per Day Pricing

'''OCCUPANCY_NOT_VALID'''
Check that "Max guests" set in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP is the same as the occupancy you have set for the room in your Booking.com extranet.

'''Did not set price to XX on date xxxx-xx-xx for Room 'abd' and Rate Category 'def' and occupancy x because the room has a max occupancy of x.'''
You have either set the wrong number of guests in Booking.com or in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP. Please correct so both numbers are the same.

'''TAG_HAS_INVALID_VALUE '''
1. Your connection type does not allow the use the the Booking.com content API. If you have set to use "Occupancy Pricing" in Beds24 we can not automatically adjust your settings in Booking.com. Log into Booking.com, stop the connection and request a new one with Content API.
2. Booking.com does not support occupancy pricing for dorms. If you have dorms log into your Booking.com account and change your pricing model to "Standard" and set the Pricing model in Beds24 to "Per Day".

'''Did not set price to xx.xx on date xxxx-xx-xx1 for Room xx and occupancy x because the room has a max occupancy of x.'''
You are trying to send a price for a number of guests which is higher than the number of guests Booking.com has the room set for. Adjust the maximum number of guests to be the same in Beds24 and Booking.com and if required adjust your prices.

'''WARN_PRICE_TOO_LOW_LIMIT'''
'''WARN_PRICE_TOO_HIGH_LIMIT'''
Booking.com considers the price you want to send varies significantly from the prices which are already in Booking.com, or if it’s outside the accepted threshold – the minimum being €5 and the maximum being €50,000 (or the equivalent in the local currency).
Either adjust your price in Beds24 or try to change the limitation at Booking.com

'''Not allowed to update Single Use Rate for Room''' or '''CANNOT_SET_SINGLE_USE_RATE'''
Booking.com have not activated a single occupancy price for the room.
Either ask Booking.com to allow a single price (set up a "Single" rate id) or set "Booking.com Rate Type" = Per Day Pricing

If it is a dorm: Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Set "Booking.com Rate Type" = Per Day Pricing and make sure to set your prices in all rates as a room price (and not as a single price).

'''Not allowed to update Single Use Rate for Room'''
Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Set "Booking.com Rate Type"= Per Day Pricing. If you want to send a single price for other rooms ask Booking.com to set up a "Single" rate id for these.

'''Rooms to Sell were set below the Minimum Contracted rooms for these dates'''
You have agreed to supply a minimum number of rooms to Booking.com on the mentioned dates and Beds24 is trying to update them to a number lower than your agreed minimum. Booking.com have ignored the Beds24 values on those dates and used your agreed minimum instead.
*Make sure you have valid rates for the mentioned dates and no bookings from other sources
*Beds24: change your inventory to send the allotment you have guaranteed Booking.com
*Booking.com: Ask Booking.com to remove the guaranteed allotment

'''Rate is not active''' or '''RATE_NOT_ACTIVE''' or '''RATE_NOT_ACTIVE_FOR_ROOM'''
You do not have an active Booking.com rate id with this number. Please double check your rates and daily prices and select a valid Booking.com rate id from the list in 'get codes'. You can only send prices for active Booking.com rate codes. You will see your active rate codes when you click on "Get Codes". Make sure you only map these rates in you channel manager settings, daily prices and rates.

'''Room is not active''' or '''ROOM_NOT_ACTIVE'''
Booking.com has not activated the room for selling. Please ask Booking.com to activate it and check the room id is correct.

'''Rate 123456 cannot be updated via XML'''
This rate has not been activated for channel management. Ask Booking.com to activate it.

'''Did not set Close Room 'XY for Rate Category 'ZZ' because of remaining Minimum Contracted Rooms on dates.....'''
You have guaranteed and to have a minimum number of rooms to sell on Booking.com but the channel manager is sending a lower quantity than contracted.
*Make sure you have valid rates for the mentioned dates and no bookings from other sources
*Beds24: change your inventory to send the minimum contracted rooms you have guaranteed Booking.com
*Booking.com: Ask Booking.com to remove the minimum contracted rooms

'''Rate does not exist'''
You have added a number which is not a valid Booking.com rate id into the field in the "Channels" tab of a rate/daily price.
*Open your rates (Channel Tab) and make sure the correct booking.com rate id is selected from the 'get codes' list.
*Open your daily prices (Enable list) and make sure the correct booking.com rate id is selected from the 'get codes' list.

'''hotel 'xxxxx' not allowed for user 'Beds24ProductionServer''''
Check if you have received a notification from Booking.com that the connection is ready.
*If not please check in the Booking.com extranet that the connection has been requested.
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.

'''hotel 'xxxxx' not allowed for user''''
Check if you have received a notification from Booking.com that the connection is ready.
*If not please check in the Booking.com extranet that the connection has been requested.
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.

'''room/rate combination is not active'''
Your codes are not correctly mapped. Check you have entered the right Booking.com mapping codes.
You have added a number which is not a valid Booking.com rate id into the field in the "Channels" tab of a rate/daily price.
*Open your rates (Channel Tab) and make sure the correct booking.com rate id is selected from the 'get codes' list.
*Open your daily prices (Enable list) and make sure the correct booking.com rate id is selected from the 'get codes' list.

'''Room reservation does not belong to this hotel reservation'''
The booking was already cancelled in Booking.com before the Channel synchronisation.

'''Code 150 - Changes are not permitted. This is because property 5587283 has status Open / bookable. Please contact your account manager if you want to modify latitude, longitude, property name, address'''
This means that changes (to certain values like language, latitude, longitude) are not permitted because you have already put the property online. If you want to change anything now you have to contact your account manager at Booking.com and ask for the property to be reviewed again.

= FAQ =
'''Will I receive notifications on new bookings?'''

After you activate the channel manager the channel will stop sending notifications. You will receive them from Beds24 instead.

'''Do guests receive a confirmation?'''

The channel confirms the booking with the guest. Beds24 will not sent a confirmation message. If you want to send one as well you can set up an Auto Action Email.

'''How do I modify or cancel a booking?'''

Bookings coming from a channel should be modified by the channel. Cancelling a booking in Beds24 will not cancel the booking in Booking.com and can cause a double booking. Please ask booking.com or the guest to cancel the booking in Booking.com and the cancellation will be sent to Beds24.

If for some reason you need to make a change in Beds24 and do not want an update from the channel to override it, you can set "Allow Channel Modifications" = No ("Details" tab of the booking"). If you have changed the room you can set "Allow Channel Modifications" = All except room changes.

'''How can I access credit card details?'''

This is how you can [[View_Credit_Card_Details| view credit card details]]. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information to always be sent.

'''How do I add a promotion or special price?'''

You can set up promotions directly in Beds24 in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > PROMOTIONS or in the Booking.com extranet.

'''How do I add extra costs or fees?'''

Extra Costs, e.g. tax, cleaning fee, service charge can be set directly in the channels extranet.

'''Can I send different prices for different minimum stays or for different numbers of guests?'''

Yes. You can do this either with occupancy based Daily Prices or multiple rates ids. See the "Multiple rates" section of this page.

''' have multiple Booking.com hotel ids. How do I set this up?'''

The system can handle multiple properties in one account. Each Booking.com hotel requires one property in Beds24.

'''I have multiple Booking.com accounts. How do I set this up? '''

The system can handle multiple properties in one account. It doesn't matter whether the Booking.com properties are in different Booking.com accounts. Each Booking.com property still requires one property in Beds24, though.

'''What to do when I receive an overbooking?'''

*Check if you are receiving error messages by email or in the potential issues menu. Error messages need to be addressed immediately because they can mean the channel manger is able to make updates.
*Entering the same Booking.com room code in multiple rooms in Beds24 can cause overbookings. Check your set up for warnings.

If you can not see a problem in your set up send us a support ticket with the booking numbers and dates.

'''Why did a booking not import?'''

*Check if the room for which you received the booking is properly mapped.

If you can not see a problem in your set up send us a support ticket with the booking number and the date the booking was made.

Why is the price for the booking wrong?'''

*A special offer set up in the channel may have reduced the price the channel manager sent.
*Your prices are not set up as you expect.

'''What are contracted rooms?'''

This is an agreement between you and the channel where you agree to provide a number of rooms exclusively to that channel. This means you will not be able to sell these rooms directly or on other channels.

'''What do I do when I have a no show?'''

To report a no show to Booking.com open the booking and click the button in the "Details" tab.

'''What do I do when a guest provides an invalid credit card number?'''

Invalid cards can be reported to Booking.com via a button on the "Details" tab of the booking.

If you use Stripe you can set in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER to automatically report invalid cards to Booking.com.

'''I originally set my connection as a one-way connection, now I want a two-way connection'''

You will need to disconnect your connection with Beds24 in the Booking.com extranet and then initiate the connection with two-way connection.

Warning channel update failure

2021-09-08T10:18:45Z

Marco:

[[Category:Troubleshooting]]
[[Category:Channel_Manager]]
<div class="heading">Error messages from channels</div>
This page explains what to do if you receive error messages from booking channels

If a connection is not working the channel is sending error messages which we forward to you by Email. Follow the steps to solve the channel errors:

'''Step 1: Find out what the error is'''

Open the Email and error message we sent you, have a look at the section where you see

<div style="background-color: #f8f9fa !important; border: 1px solid #eaecf0;border-radius: 2px; padding: 1px 4px;">
<nowiki>= = = = ERROR MESSAGE STARTS = = = =</nowiki>

This is the text of the error message.

<nowiki>= = = = ERROR MESSAGE ENDS = = = =</nowiki>
</div>

'''Step 2: Open the help page for the channel which sends the error'''

Go to {{#fas:cog}} (SETTINGS) ->CHANNEL MANAGER > and open the page for the channel you are receiving the error message and click on the top right <span style="color:#007bff;“ >{{#far:question-circle}} </span> help icon to open the channel help page or use the links below:

{| class="wikitable"
|+Links to common errors for selected channels
|-
|[[Agoda.com#Common_Errors|Agoda common errors]]
|[[Airbnb_Mapping#Troubleshooting_and_common_errors|AirBnb common errors ]]
|[[Booking.com:_Synchronise_bookings_prices_availability#Error_messages|Booking.com common errors]]
|-
|[[Ctrip#Common_Errors|Ctrip common errors]]
|[[Expedia_Mapping#Common_Errors|Expedia common errors ]]
|[[Hotelbeds.com#Common_Errors|Hotelbeds Common Errors]]
|-
|[[HostelWorld.com#Common_Errors|Hostelworld common errors]]
|[[Hrs#Common_Errors|HRS common errors]]
|[[Travelokacom#Common_Errors|Triaveloka common errors]]
|}

'''Step 3: Find the error on the help page'''
Go to the section '''Common Errors''' and search for the error text from the Email.

If you do not find the error on the channel help page send us a support ticket via the SUPPORT button in the top of your control panel.

'''Step 4: Fix the error'''

Follow the instruction on how to fix the error.

'''Step 5: Check if the error is fixed'''

If the error messages stop the error is fixed.

Template Variables

2021-08-23T16:51:55Z

Marco: /* Standard Invoice Values */

[[Category:Guest_Management]]
[[Category:Messaging]]
<div class="heading">Template variables</div>
On this page you find a list of template variables and information on how they are used.

These variables (short codes) will be replaced by the relevant information from each booking. They can be used in every text settings that allows their use . Copy them exactly as shown, including the square brackets and upper case.

The date variables can have an optional offset value of a number of days added after a colon, for example '''[FIRSTNIGHT:-3 days]'''

The price variables can have an optional offset value applied which can be a percentage or fixed amount with or without minus sign added after a colon, for example '''[PRICE:-10]''' or '''[INVOICEBALANCE:25%]'''

== Property Variables ==
[PROPERTYNAME] - property name

[PROPERTYADDRESS] - property address

[PROPERTYCITY] - property city

[PROPERTYSTATE] - property state

[PROPERTYCOUNTRY] - property country

[PROPERTYEMAIL] - property email

[PROPERTYWEB] - property web site

[PROPERTYPHONE] - property phone

[PROPERTYFAX] - property fax

[PROPERTYCONTACTLASTNAME] - property contact last name

[PROPERTYCONTACTFIRSTNAME] - property contact first name

[PROPERTYID] - property id number

[PROPERTYPOSTCODE] - property post code

[PROPERTYCURRENCY] - property currency code

[PROPERTYCURRENCYFRONT] - property currency symbol before number

[PROPERTYCURRENCYBACK] - property currency symbol after number

[PROPERTYLATITUDE] - property latitude

[PROPERTYLONGITUDE] - property longitude

[PROPERTYLOCATIONDESCRIPTION] - property location description

[PROPERTYLOCATIONDESCRIPTIONBR] - property location description with line break

[PROPERTYDIRECTIONS] - property directions from ( {{#fas:cog}} (SETTINGS) CHANNEL MANNAGER > PROPERTY CONTENT)

[PROPERTYHEADLINE] - property headline

[PROPERTYDESCRIPTION] - property description

[PROPERTYGENERALPOLICY] - property rental policy

[PROPERTYGENERALPOLICYBR] - property rental policy with line break

[PROPERTYLEGALPOLICY] - property rental policy / obsolete

[PROPERTYCANCELPOLICY] - property cancellation policy

[PROPERTYCANCELPOLICYBR] - property cancellation policy with line breaks

[PROPERTYHOUSERULES] - property house rules ({{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT)

[PROPERTYHOUSERULESBR] - property house rules ({{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT) with line break

[PROPERTYTEMPLATE1] - Property Template 1

[PROPERTYTEMPLATE2] - Property Template 2

[PROPERTYTEMPLATE3] - Property Template 3

[PROPERTYTEMPLATE4] - Property Template 4

[PROPERTYTEMPLATE5] - Property Template 5

[PROPERTYTEMPLATE5] - Property Template 6

[PROPERTYTEMPLATE7] - Property Template 7

[PROPERTYTEMPLATE8] - Property Template 8

[BOOKINGCOMHOTELID] - booking.com hotel id

[EXPEDIACOMHOTELID] - expedia.com hotel id

[PERMITID] - the permit ID

[CHECKINSTART] - check-in start time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in start')

[CHECKINEND] - check-in end time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in end')

[CHECKOUTEND] - check-out end time in 24hr format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-out end')

[CHECKINSTART12] - check-in start time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in start')

[CHECKINEND12] - check-in end time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-in end')

[CHECKOUTEND12] - check-out end time in am/pm format (From {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT 'Check-out end')

[PROPERTYDESCRIPTION1] - Property Description 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCRIPTION2] - Property Description 2 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCBOOKPAGE1] - Property Description Booking Page 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYDESCBOOKPAGE2] - Property Description Booking Page 1 from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGUESTDETAILSHEADER] - Guest Details Header from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGUESTENQUIRYHEADER] - Guest Enquiry Header from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYCONFIRMBOOKBUTTON] - Confirm Booking Button Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYROOMNOTAVAIL] - Room Not Available Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYROOMNOPRICE] - Room No Price Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYNOROOMSAVAIL] - No Rooms Available Message from {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PROPERTY BOOKING PAGE > CONTENT

[PROPERTYGROUP] - shows the group keywords

== Room Variables ==
[ROOMID] - room id number

[ROOMNAME] - room names of all booked rooms (not for cancelled bookings use ROOMNAMEINC if used for cacelled bookings)

[ROOMNAMEBR] - room names with line break

[ROOMNAMEINC] room names of all booked rooms including for cancelled bookings

[ROOMNAMEINCBR] room names with line break

[ROOMNAME1] - room name of first booked room

[ROOMNAMES] - room names including quantity of each booked room

[ROOMNAMESNC] - room names including quantity of each booked room without cancelled rooms

[ROOMNAMESBR] - room names with line break

[ROOMNAMESNCBR] room names with line break without cancelled rooms

[ROOMNAMEOFFER] - room names of all booked rooms with offer name

[ROOMNAMEOFFERBR] - room names of all booked rooms with offer name with line break

[ROOMNAMEOFFERINC] room names of all booked rooms with offer name inkl. cancelled bookings

[ROOMNAMEOFFERINCBR] - room names of all booked rooms with offer name with line break

[ROOMTYPEDESC] - room accommodation type first booked room

[ROOMTYPEDESCS] - room accommodation type all booked rooms

[ROOMTYPEDESCSINC] - room accommodation type all booked rooms including cancelled bookings

[ROOMSIZE] - size of the room

[ROOMTEMPLATE1] - ROOM Template 1

[ROOMTEMPLATE2] - ROOM Template 2

[ROOMTEMPLATE3] - ROOM Template 3

[ROOMTEMPLATE4] - ROOM Template 4

[ROOMTEMPLATE5] - ROOM Template 5

[ROOMTEMPLATE6] - ROOM Template 6

[ROOMTEMPLATE7] - ROOM Template 7

[ROOMTEMPLATE8] - ROOM Template 8

[ROOMMETAAUXTEXT] - room meta text setting for first booked room

[ROOMMETAAUXTEXTS] - room meta text setting for all booked rooms

[ROOMMETAAUXTEXTSINC] - room auxiliary text setting for all booked rooms

[INTERNALROOMNAME] - internal room name as used in the control panel, this is not the translated room name shown on the booking page

[OFFERID] - ID of the boked offer

[OFFERNAME] - booked offer name for all booked rooms

[OFFERNAME1] - offer name for this booked room only

[OFFERNAMEINC] - offer name for this booked room only inluding cancelled bookings

[OFFERDESCRIPTION1] - offer description 1 for all booked rooms

[OFFERDESCRIPTION1INC] - offer description 1 for all booked rooms inkl. cancelled

[OFFERDESCRIPTION2] - offer description 2 for all booked rooms

[OFFERDESCRIPTION2INC] - offer description 2 for all booked rooms inkl. cancelled

[OFFERDESCRIPTION1-1] - offer description 1 for this booked room

[OFFERDESCRIPTION2-1] - offer description 2 for this booked room

[OFFERSUMMARY] - summary offers

[OFFERSUMMARYINC] - summary offers including cancelled bookings

[UNITID] - ID of the unit (number)

[UNITNAME] - unit names of all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAMEINC] - unit names of all the assigned room types in the booking group including cancelled bookings

[UNITNAME:1] - additional information (first) about the unit for all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAME:2] - additional information (second) about the unit for all the assigned room types in the booking group (cancelled bookings are not shown)

[UNITNAME1] - unit name of the assigned room for this booking number

[UNITNAME1:1] - additional information about the assigned room for this booking number / add the additional information on each line after a | symbol where you set the unit names

[UNITSTATUS1] - the status if the unit

[ROOMDESCRIPTION] - Room description from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMDESCRIPTION1] - Room description 1 from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP

[LEAVINGDAYAVAIL] - returns yes or no, can be used to trigger an Auto Action

[ROOMRACKRATENUM] - Rack Rate from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMCLEANINGFEENUM] - Cleaning fee from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMSECURITYDEPOSITNUM] - Securty deposit from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMTAXPERCENTNUM] - Tax percentate from from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

[ROOMTAXPERSONNUM] - Tax per Person Night from from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

== Booking Variables ==
[VIEWBOOKING] - create a URL to log into the control panel and view this booking (for hosts, not intended to be sent to guests)

[BOOKID] - booking reference number

[BOOKIDS] - booking reference numbers of all bookings in a group

[BOOKIDSINC] - booking reference of all bookings in a group including cancelled bookings

[GROUPID] - booking reference of the master booking

[REFERENCENUMBER] - booking reference (same as [BOOKID])

[BOOKIDLAST1] - Last 1 digit of booking number

[BOOKIDLAST2] - Last 2 digits of booking number

[BOOKIDLAST3] - Last 3 digits of booking number

[BOOKIDLAST4] - Last 4 digits of booking number

[BOOKIDLAST5] - Last 5 digits of booking number

[BOOKIDLAST6] - Last 6 digits of booking number

[BOOKIDLAST7] - Last 7 digits of booking number

[BOOKIDLAST8] - Last 8 digits of booking number

[BEDDING] - displays bedding info codes

[RANDOM1] - a 1 digit random number seeded from the booking number

[RANDOM2] - a 2 digit random number seeded from the booking number

[RANDOM3] - a 3 digit random number seeded from the booking number

[RANDOM4] - a 4 digit random number seeded from the booking number

[RANDOM5] - a 5 digit random number seeded from the booking number

[RANDOM6] - a 6 digit random number seeded from the booking number

[RANDOM7] - a 7 digit random number seeded from the booking number

[RANDOM8] - a 8 digit random number seeded from the booking number

=== Content from "Info" tab ===
[BOOKINGINFOITEMS] - Booking Info Codes - Codes and text

[BOOKINGINFOITEMSBR] - Booking Info Codes - Codes and text with line break

[BOOKINGINFOTEXTS] - Booking Info Codes - Text only

[BOOKINGINFOTEXTSBR] Booking Info Codes - Text only with line break

[BOOKINGINFOCODES] - Booking Info Codes - Codes only

[BOOKINGINFOCODESBR] - Booking Info Codes - Codes and text with line break

[BOOKINGINFOCODETEXT:infoCode] - the most recent Text value of the specified Booking Info Code, "infoCode" in this example

[BOOKINGINFOCODEDATE:infoCode]- the most recent date value of the specified Booking Info Code, "infoCode" in this example, supports custom date/time formats {%A, %e %B, %Y} after the infoCode

[INTERNALNOTES] - content from "Internal Notes" on the Info Tab

[INTERNALNOTESBR] - content from "Internal Notes" on the Info Tab with line break

[INTERNALNOTESHR] - content from "Internal Notes" on the Info Tab with separating line

=== Content from "Summary" tab see also under "Room" and "Property" ===
[STATUS] - status of booking

[SUBSTATUS] - sub status of the booking

[FIRSTNIGHT] - first night booked

[FIRSTNIGHTSHORT] - first night booked in 1 Apr 2016 format

[FIRSTNIGHTYYYY-MM-DD] - first night booked in YYYY-MM-DD format

[LASTNIGHT] - last night booked

[LASTNIGHTSHORT] - last night booked in 1 Apr 2016 format

[LASTNIGHTYYYY-MM-DD] - last night booked in YYYY-MM-DD format

[LEAVINGDAY] - check-out day

[LEAVINGDAYSHORT] - check-out day in 1 Apr 2016 format

[LEAVINGDAYYYYY-MM-DD] - check-out day in YYYY-MM-DD format

[NUMNIGHT] - number of nights

[NUMNIGHTS] - number of nights sum across group booking

[NUMNIGHTSINC] - number of nights sum across group booking incl. cancelled

[GUESTTITLE] - guest title on the "summary" tab of the booking

[GUESTFIRSTNAME] - first name on the "summary" tab of the booking

[GUESTNAME] - last name on the "summary" tab of the booking

[GUESTNAMES] - name of all guests in the booking on the "summary" tab of the booking

[GUESTNAMESINC] - name of all guests in the booking on the "summary" tab of the booking incl. cancelled bookings

[GUESTNAMESINCBR] - name of all guests in the booking on the "summary" tab of the booking incl. cancelled bookings with line break on the "summary" tab of the booking

[GUESTFULLNAME] - title, first name, last name on the "summary" tab of the booking

[GUESTFULLNAMES] - titles, first names, last names of all guests in the booking on the "summary" tab of the booking

[GUESTFULLNAMESBR] - titles, first names, last names of all guests in the booking with line break on the "summary" tab of the booking

[GUESTFULLNAMESINC] - titles, first names, last names of all guests in the booking on the "summary" tab of the booking incl. cancelled

[GUESTFULLNAMESINCBR] - titles, first names, last names of all guests in the booking with line break on the "summary" tab of the booking incl. cancelled

[GUESTCOMMENTS] - comments in the booking

[GUESTCOMMENTSBR] - comments in the booking with line breaks <BR>

[NOTES] - notes

[NOTESBR] - notes with line breaks <BR>

[GUESTARRIVALTIME] - arrival time

[NUMADULT] - number of adults in this room or in group if master booking (not for cancelled bookings use NUMADULTINC if used for cacelled bookings)

[NUMADULTINC] - number of adults in this room or in group if master booking incl. cancelled bookings

[NUMADULT1] - number of adults in this room

[NUMCHILD] - number of children in this room or in group if master booking (not for cancelled bookings use NUMCHILDINC if used for cacelled bookings)

[NUMCHILDINC] number of children in this room or in group if master booking including cancelled bookings

[NUMCHILD1] - number of children in this room

[NUMPEOPLE] - number of guests in this room or in group if master booking

[NUMPEOPLEINC] - number of guests in this room or in group if master booking incl. cancelled bookings

[NUMPEOPLE1] - number of people in this room

[GUESTPHONE] - guests phone number

[GUESTPHONENUM] - guests phone number with all non-numeric characters removed

[GUESTMOBILE] - guests mobile number

[GUESTMOBILENUM] - guests mobile number with all non-numeric characters removed

[PHONELAST1] - last digit of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST2] - last 2 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST3] - last 3 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST4] - last 4 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST5] - last 5 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[PHONELAST6] - last 6 digits of the guests phone number if guest phone is empty it will use the guests mobile number

[GUESTSMS:49] - attempt to convert the guest mobile number into a format suitable for SMS, if country code is missing add the one supplied in the template variable, if mobile number is empty use guest phone number instead.

[GUESTCOMPANY] - company name

[GUESTCOMPANYBR] - company name with line breaks

[GUESTFAX] - guests fax number

[GUESTFAXNUM] - guests fax number with all non-numeric characters removed

[GUESTADDRESS] - guests address

[GUESTADDRESSBR] - guests address with line breaks

[GUESTSADDRESSSBR1INC] - guests address with line breaks incl. cancelled bookings

[GUESTPOSTCODE] - guests postcode

[GUESTCITY] - guests city

[GUESTSTATE] - guests state

[GUESTCOUNTRY] - guests country from free text field is not empty, otherwise from selector list

[GUESTCOUNTRYHL] - guests country from free text field is not empty, otherwise from selector list in hosts language

[GUESTCOUNTRYGL] - guests country from free text field is not empty, otherwise from selector list in guests language

[GUESTCOUNTRYSELECT] - guests country from selector list

[GUESTCOUNTRYSELECTHL] - guests country from selector list in hosts language

[GUESTCOUNTRYSELECTGL] - guests country from selector list in guests language

[GUESTCOUNTRYTEXT] - guests country from free text field

[GUESTCOUNTRY2] - guests country from selector list as two letter code

=== Content from "Details" tab ===
[MESSAGE] - the content of the booking message field

[MESSAGEBR] - the content of the booking message field with line breaks <BR>

[GUESTCUSTOMQ1] - answer to custom question 1

[GUESTCUSTOMQ1BR] - answer to custom question 1 with line breaks <BR>

[GUESTCUSTOMQ2] - answer to custom question 2

[GUESTCUSTOMQsBR] - answer to custom question 2 with line breaks <BR>

[GUESTCUSTOMQ3] - answer to custom question 3

[GUESTCUSTOMQ3BR] - answer to custom question 3 with line breaks <BR>

[GUESTCUSTOMQ4] - answer to custom question 4

[GUESTCUSTOMQ4BR] - answer to custom question 4 with line breaks <BR>

[GUESTCUSTOMQ5] - answer to custom question 5

[GUESTCUSTOMQ5BR] - answer to custom question 5 with line breaks <BR>

[GUESTCUSTOMQ6] - answer to custom question 6

[GUESTCUSTOMQ6BR] - answer to custom question 6 with line breaks <BR>

[GUESTCUSTOMQ7] - answer to custom question 7

[GUESTCUSTOMQ7BR] - answer to custom question 7 with line breaks <BR>

[GUESTCUSTOMQ8] - answer to custom question 8

[GUESTCUSTOMQ8BR] - answer to custom question 8 with line breaks <BR>

[GUESTCUSTOMQ9] - answer to custom question 9

[GUESTCUSTOMQ9BR] - answer to custom question 9 with line breaks <BR>

[GUESTCUSTOMQ10] - answer to custom question 10

[GUESTCUSTOMQ10BR] - answer to custom question 10 with line breaks <BR>

[REFERENCE] - content of the booking reference field

[NUMROOM] - the quantity of rooms booked (first room type only)

[NUMROOMS] - the quantity of rooms booked (sum of all rooms and room types)

[NUMROOMSINC] - the quantity of rooms booked (sum of all rooms and room types) inc. cancelled

[FLAG] - Flag

[STATUSCODE] - 'Status Code' (Under tab 'Detail'. Can be a value between 0-100.)

[ORIGINALREFERRER] - Original referrer

[REFERRER] - Referrer

[APIREF] - the booking number at the originating channel

[APISOURCE] - Beds24 channel number

[APISOURCETEXT] - human readable name of the channel

[BOOKINGDATE] - booking date

[BOOKINGTIMEDATE] - booking date and time

[BOOKINGDATEYYYY-MM-DD] - booking date in YYYY-MM-DD format

[BOOKINGIP] - ip address of booker's computer

[APIMESSAGE] - api message sent by originating channel

=== Content from "Charges and Payments" tab (also see "Invoice/Invoicee/Room") ===
[BOOKINGINVOICEEID] - invoicee id assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

[RATEDESC] - rate description (in the booking popup under the tab 'Charges & Payments')

[RATEDESCBR] - name of the rate with HTML <BR> to force new lines

[PRICE] - Value in price field (number entered in the price field of the booking) with currency symbol

[PRICENC] - Value in price field (number entered in the price field of the booking) without currency symbol (do not use in calculations, use PRICENUM)

[PRICE:10%] - Percentage value of Price

[PRICE:-10] - Price with offset amount

[PRICENUM] - As per [PRICE] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation).

[PRICENUM:] - As per [PRICE:] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[PRICELESSCOMMISSION] - Value in price field less value in commission field with currency symbol

[PRICELESSCOMMISSIONNUM] - As per [PRICELESSCOMMISSION] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[PRICELESSTAX] - Value in price field less value in tax field with currency symbol

[PRICELESSTAXNUM] - As per [PRICELESSTAX] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVPRICE] - Average Nightly Price with currency symbol

[AVPRICENUM] - Average Nightly Price with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVPRICE:20%] - Percentage value of Average Nightly Price

[AVPRICE:15] - Average Nightly Price with offset amount

[BASEPRICE] - Lodging Price

[BASEPRICENUM] - same as [BASEPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEGROUPPRICE] - Lodging Price for Group

[BASEGROUPPRICENUM] - same as BASEGROUPPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEVAT] - Lodging Price vat amount

[BASEVATNUM] - same as [BASEVAT] with a decimal point and no thousands separator and no currency symbols (for calculation)

[BASEGROUPVAT] - Lodging Price vat amount for Group

[BASEGROUPVATNUM] - same as BASEGROUPVAT] with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVBASEPRICE] - Average Nightly Lodging Price

[AVBASEPRICENUM] - same as [AVBASEPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[AVBASEGROUPPRICE] Average Nightly Lodging Price for Group

[AVBASEGROUPPRICENUM] - same as [AVBASEGROUPPRICE] with a decimal point and no thousands separator and no currency symbols (for calculation)

[DEPOSIT] - Value in deposit field with currency symbol

[DEPOSITNUM] - As per [DEPOSIT] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[TAX] - Value in tax field with currency symbol

[TAXNUM] - As per [TAX] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation).

[COMMISSION] - Value in commission field with currency symbol

[COMMISSIONNUM] - As per [COMMISSION] but the value is displayed with a decimal point and no thousands separator and no currency symbols (for calculation)

[COMMISSIONGROUP] - Value of the commission of the complete group booking

[GUESTVOUCHER] - voucher code used with booking

[CARDLASTFOUR] - last 4 digits of card

[CARDFIRSTSIX] - first 6 digits of card

===Content from Invoice" tab===
[BOOKINGINVOICEEID] - invoicee id assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

[BOOKINGINVOICEENAME] - invoicee name assigned to this booking, this comes from the booking invoicee setting, not from the bookings invoice items

===Content from "Group Invoice" tab===
[GROUPNOTE] - group note

=== Content from "Mail & Actions" tab ===
[GUESTEMAIL] - guest's Email address on the "summary" tab of the booking

[GUESTLANGUAGE] - guest language

[EMAIL:00] - Status of an Auto Action email. Replace 00 with the number of the Auto Action. This shows if the email has been sent and if so, the time it was sent.

=== Content from "Guests" tab ===
[GUESTSID] - all IDs of this booking

[GUESTSID1] - ID of the first guest

[GUESTSIDS] - all IDs for all bookings in the group

[GUESTSNAME] - name of all guests listed on the "guests" tab of this booking

[GUESTSNAMES] - name of all guests listed on the "guests" tab of the booking of the group booking

[GUESTSNAMESINC] - name of all guests listed on the "guests" tab of the booking of the group booking incl. cancelled

[GUESTSFIRSTNAMES] - first name of all guests listed on the "guests" tab of this booking last separated by an &

[GUESTSFIRSTNAMESINC] - first name of all guests listed on the "guests" tab of this booking incl. cancelled

[GUESTSLASTNAMES] - last name of all guests listed on the "guests" tab of this booking

[GUESTSLASTNAMESINC] - last name of all guests listed on the "guests" tab of this booking incl. cancelled

[GUESTSADDRESSSBR1] - address of the first guest on the "guests" tab of this booking group

[GUESTSADDRESSSBR1INC] - address of the first guest on the "guests" tab of this booking group incl. cancelled

[GUESTSNUMBOOKINGS1] - the total number of bookings made by the first guest, a group booking counts as one booking.

[GUESTSNUMSTAYS1] - the total number of bookings not cancelled and not in the future made by the first guest, a group booking counts as one booking.

===Cancellation, Management and Guest Login===
[CANCELLEDTIME] - date when the booking was cancelled

CANCELLEDTIME:] - date when the booking was cancelled display can be any valid PHP strftime format string

[CANCELURL] - URL to view and cancel bookings

[CANCELDATE] - date until when the booking is cancellable displaying a phrase

[CANCELDATEYYYY-MM-DD] - date until when the booking is cancellable displaying a date. If the date is in the past 00-00-0000 will be shown

[DAYSTOCANCEL] - number of days until booking can be cancelled

[CANCELUNTIL] - shows the number of days between check-in and the last day which can be canecelled. If guest can always cancel it shows 0, if guest can never cancel it shows 9999.

[GUESTLOGIN] - URL to view bookings

[TURNOVERDAYS] - days until next arrival into the same unit.

==Date and Time==

Many date template variables support PHP strftime format strings between {} brackets to create custom date formats. Information on PHP strftime strings is available at [http://php.net/manual/en/function.strftime.php http://php.net/manual/en/function.strftime.php]

[CURRENTDATE] - current date

[CURRENTDATEYYYY-MM-DD] - current date in YYYY-MM-DD format

[CURRENTDATE:{%A, %e %B, %Y}] - current date

[CURRENTDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[CURRENTTIME] - current time and the display can be any valid PHP strftime format string.

[CURRENTTIME:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[DAYSTOCHECKIN] - number of days until check-in

[INADVANCE] - number of days between booking and check-in

[DAYSBETWEEN:2019-11-01:2019-11-10] - this template variable will calculate the number of days between the :: the dates need to be in yyyy-mm-dd format. Template variables can be used for calculation.

Example: [[DAYSBETWEEN:[FIRSTNIGHT:+5 days{%G-%m-%d}]:[CURRENTDATE:{%G-%m-%d}]] will calculate the days between 5 days after check-in and today.

[FIRSTNIGHT:{%A, %e %B, %Y}] - first night booked

[FIRSTNIGHT:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[LASTNIGHT:{%A, %e %B, %Y}] - last night booked

[LASTNIGHT:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[LEAVINGDAY:{%A, %e %B, %Y}] - check-out

[LEAVINGDAY:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[BOOKINGDATE:{%A, %e %B, %Y}] - booking date

[BOOKINGDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[MODIFYDATE:{%A, %e %B, %Y}] - last booking modification date/time, the display can be any valid PHP strftime format string.

[PAYMENTDATE:{%A, %e %B, %Y}] - most recent payment date

[PAYMENTDATE:+1day{%A, %e %B, %Y}:1:1000] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string. The second parameter specifies the payment to show, 0 or missing means the most recent payment. The third parameter specifies the invoicee.

[FORMATDATE:[any template variable that creates a date]{%A, %e %B, %Y}] - format the date in the strftime format. The date value could be included by inserting a different template variable containing a date.

== Booking Group variables ==
=== Custom Booking Group Table ===
create your own booking group list by specifying the columns in the order you want them to appear.

for example: [BOOKGROUP:PROP_ROOM_BREF_NAME]

column parameters

100% = 100% width

ADDR = Booking address

ADUL= the number of adults

ARIV = Arrival date

BOPR = Bold prices

BREF = Booking number

CITY = Booking city

CHAC = Charges with currency symbol

CHAR = Charges

CHIL = Number of children

COUN = Booking country

DEPT = Departure date

EMAI = Booking Email

EXSP = extra space between rows

FLAG = Booking flag text

FNAM = Booking first name

GADD = Guest address

GCIT = Guest city

GCOM = Guest company

GCOU = Guest country

GFLA = Guest flag text

GFNA = Guest first name

GLNA = Guest last name

GMOB = Guest mobile

GNAM = Guest full name

GEMA = Guest Email

GNOT = Guest note

GPOS = Guest postcode

GREF = Guest Id

GSTA = Guest state

GTEL = Guest phone

ICAN = Include cancelled bookings

LNAM = Booking last name

MOBI = Booking mobile

NAME = Booking full name

NOHE = no header

NOTE = Booking note

ONAM = Offer Name

ONLY = Just show the one booking

PAIC = Payment amount with currency symbol

PAID = Paid amount

PEOP = Number of guests

PHON = Booking phone

POST = Booking postcode

PROP = Property name

RDE0 = Room description from {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > PROPERTY CONTENT > ROOM CONTENT

RDE1 = Room description 1 from {{#fas:cog}} (SETTINGS) PROPERTIES> ROOMS > SETUP

RNAM = Room Display Name

ROOM = Room name

RQTY = shows the number of rooms for each booking and a total at the bottom

STAT = Booking state

STUS = Status

TOTA = Total price

UNI2 = Unit first additional information

UNI3 = Unit second additional information

UNIT = Unit name

Connect the parameters with an underscore.

Examples:

[BOOKGROUP:PROP_ROOM_BREF_NAME] will display the property name, room name, booking number and guest name in this order.

[BOOKGROUP:BREF_NAME_PROP_ROOM] will display the booking number, guest name property name and room name in this order.

=== Booking Group Table with fixed content===
[BOOKGROUPROOMLIST] - create a table of guest names including room type for a group booking

[BOOKGROUPROOMLISTTOTAL] - create a table of guest names including room type for a group booking with guest totals

[BOOKGROUPROOMLISTCHARGETOTAL] - create a table of guest names including room type and charge for a group booking with guest totals

[BOOKGROUPNAMELIST] - create a table of guest names including room type and unit for a group booking

[BOOKGROUPNAMELISTTOTAL] - create a table of guest names including room type and unit for a group booking with guest totals

[BOOKGROUPNAMELISTCHARGETOTAL] - create a table of guest names including room type and unit and charge for a group booking with guest totals

[BOOKGROUPUNITLIST] - create a table of guest names including unit for a group booking

[BOOKGROUPUNITLISTTOTAL] - create a table of guest names including unit for a group booking with guest totals

[BOOKGROUPUNITLISTCHARGETOTAL] - create a table of guest names including unit and charge for a group booking with guest totals

== Invoice Variables ==
[INVOICENUMBER] - invoice number

[INVOICENUMBERS] - invoice number if invoicees are involved

[INVOICEDATE] - invoice date

[INVOICEDATES] - invoice date invoice number if invoicees are involved

[INVOICEDATE:+1day{%A, %e %B, %Y}] - optional date offset and display format. The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

[INVOICEDATES+1day{%A, %e %B, %Y}] - optional date offset and display format - invoice date invoice number if invoicees are involved, The offset can be any plus or minus any number of days and the display can be any valid PHP strftime format string.

=== Invoice Values ===
These template variables will display a value form the invoice.

==== Custom Invoice Values====
You have the option to create a custom invoice variable to display a value from an invoice. Available content variables are:

CHA - charges

CON - currency conversion. Example: CONEURUSD will convert the first currency (Euros) to the second currency (USD). CON1.234 would multiply the prices by 1.234

DEC - Decimal points. Example: DEC, will show a comma as decimal point. If nothing is set the system will use the default for the language

DP0 - no decimal places

DP1 - 1 decimal place

DP2 - 2 decimal places

DP3 - 3 decimal places

DP4 - 4 decimal places

DESsome description - sum of values with "some description"

INV - invoicee, add the invoicee number at the end. Example: INV20 to show invoicee number 20, INV0 will show items not assigned to an invoicee, INV-1 will show all items from the booking regardless of invoicee. You can combine INV[BOOKINGINVOICEEID]] to add the invoicee from the booking

IT1 - item 1 in the invoice

IT2 - item 2 in the invoice

IT3 - item 3 in the invoice

IT4 - item 4 in the invoice

IT5 - item 5 in the invoice

MUL - multiplier. Example: MUL1.2 will multiply all prices by 1.2

NUM - show with decimal place (for scripts)

THO - thousands separator. THO. will show a dot as thousand separator. If nothing is set the system will use the default for the language

UPS1 - upsell 1

UPS2 - upsell 2

UPS3 - upsell 3

UPS4 - upsell 4

UPS5 - upsell 5

ONE - shows only items from the specified booking (not the booking group)

PAY - shows payments

QTY - shows quantity

SEX - status excluded. Calculate the balance of all invoice items except for the ones with these status, the status items can be a comma separated list. Example: SEX status1,status2,status4 will not show items with this status.

SIN - status included. Calculate the balance of all invoice items with matching status, the status items can be a comma separated list. Example: SIN status1,status2,status4 will only show items with this status.

VAT - VAT summary

Connect the variables with an underscore.

Examples:

[INVOICEVAL:PAY_THO] will show payments with a thousands separator

[INVOICEVAL:UPS1_UPS1] will show the sum of upsell 1 and upsell 2

==== Standard Invoice Values====
[INVOICEBALANCE] - invoice balance

[INVOICEBALANCE:50%] - percentage of invoice balance

[INVOICEBALANCE:-100] - invoice balance with offset amount

[INVOICEBALANCENUM] - As per [INVOICEBALANCE] but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEBALANCENUM:] - As per [INVOICEBALANCE:] but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPARTBALANCE:status1,status2,!status4:10%] - Calculate the balance of all invoice items with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset is optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTBALANCENUM:status1,status2,status4:10%] - As per INVOICEPARTBALANCE but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEBALANCE1] - invoice balance of one booking only, not the booking group

[INVOICEBALANCE1NUM] - As per [INVOICEBALANCE1] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECHARGES] - invoice sum of all charges

[INVOICECHARGES:50%] - invoice sum of all charges with percentage multiplier

[INVOICECHARGES:-100] - invoice sum of all charges with offset

[INVOICECHARGESNUM] - As per [INVOICECHARGES] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECHARGESNUM:] - As per [INVOICECHARGES:] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPARTCHARGES:status1,status2,!status4:10%] - Calculate the balance of all invoice charges with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTCHARGESNUM:status1,status2,status4:10%] - As per INVOICEPARTCHARGES but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPAYMENTS] - invoice sum of all payments

[INVOICEPAYMENTS:50%] - invoice sum of all payments with percentage multiplier

[INVOICEPAYMENTS:-100] - invoice sum of all payments with offset

[INVOICEPAYMENTSNUM] - As per [INVOICEPAYMENTS] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPAYMENTSNUM:50%] - As per [INVOICEPAYMENTS:50%] but the value is displayed with a decimal point and no thousands separator.

[INVOICEPARTPAYMENTS:status1,status2,!status4:10%] - Calculate the balance of all invoice payments with matching status and apply optional multiplier or offset. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1. The offset optional and can be specified after a second colon (:) and it can be a percentage by ending the number with the percent (%) symbol or a numeric value offset.

[INVOICEPARTPAYMENTSNUM:status1,status2,status4:10%] - As per INVOICEPARTCHARGES but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAY] - all (auto and manual) pending payments including failed

[INVOICEPENDPAYNEXTDATE] - date of the next pending payment

[INVOICEPENDPAYNEXTDATE:] - date of the next pending payment display can be any valid PHP strftime format string. Information about PHP strftime Strings can be find found here: http://php.net/manual/de/function.strftime.php

[INVOICEPENDPAYNUM] - all (auto and manual) pending payments including failed but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAY1234] - all (auto and manual) pending payments including failed for the specified invoicee (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYNUM1234] - all (auto and manual) pending payments including failed for the specified invoicee (-1 will include all items regardless of invoicee) The value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYAUTO] - auto pending payments before due date

[INVOICEPENDPAYAUTONUM] - auto pending payments before due date but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYAUTO1234] auto pending payments before due date for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYAUTONUM1234] auto pending payments before due date for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYFAIL] - failed pending payments (all also past)

[INVOICEPENDPAYFAILNUM] - failed pending payments (all also past) but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPENDPAYFAIL234] - failed pending payments (all also past) for the specified invoicee (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYFAILNUM234] - failed pending payments (all also past) for the specified invoicee but the value is displayed with a decimal point and no thousands separator (for calculation) (-1 will include all items regardless of invoicee)

[INVOICEPENDPAYRULE1] - shows all pending payment for this rule (exchange 1 for the rule number)

[INVOICEPENDPAYRULENUM1] - shows all pending payment for this rule (exchange 1 for the rule number) displayed with a decimal point and no thousands separator (for calculation)

[INVOICEPENDPAYMANUAL] - manual pending payments

[INVOICEPENDPAYMANUALNUM] - manual pending payments but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYMANUALNOTDUE] manual pending payments before due date

[INVOICEPENDPAYMANUALNOTDUENUM] manual pending payments before due date but the value is displayed with a decimal point and no thousands separator (for calculation).

[INVOICEPENDPAYMANUALOVERDUE] manual pending payments after due date

[INVOICEPENDPAYMANUALOVERDUENUM] manual pending payments after due date but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECREDITS] - invoice sum of all credit items (negative items)

[INVOICECREDITS:50%] - invoice sum of all credit items with percentage multiplier

[INVOICECREDITS:-100] - invoice sum of all credit items with offset

[INVOICECREDITSNUM] - As per [INVOICECREDITS] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICECREDITSNUM:] - As per [INVOICECREDITS:] but the value is displayed with a decimal point and no thousands separator (for calculation)

[INVOICEDEBITS] - invoice sum of all debit items (positive items)

[INVOICEDEBITS:50%] - invoice sum of all debit items with percentage multiplier

[INVOICEDEBITS:-100] - invoice sum of all debit items with offset

[INVOICEDEBITSNUM] - As per [INVOICEDEBITS] but the value is displayed with a decimal point and no thousands separator (for calculations) (for calculations)

[INVOICEDEBITSNUM:] - As per [INVOICEDEBITS:] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEVAT] - invoice sum of all vat value

[INVOICEVATNUM] - invoice sum of all vat value for calculations)

[INVOICEFIRSTITEM] - price of the item listed first in the invoice

[INVOICEFIRSTITEMNUM] - price of the item listed first in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICESECONDITEM] - price of the item listed second in the invoice

[INVOICESECONDITEMNUM] - price of the item listed second in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICETHIRDITEM] - price of the item listed third in the invoice

[INVOICETHIRDITEMNUM] - price of the item listed third in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEFOURTHITEM] - price of the item listed fourth in the invoice

[INVOICEFOURTHITEMNUM] - price of the item listed fourth in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEFIFTHITEM] - price of the item listed fifth in the invoice

[INVOICEFIFTHITEMNUM] - price of the item listed fifth in the invoice but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELL0] - base price without upsell items or other charges added later

[INVOICEUPSELLNUM0] - as per [INVOICEUPSELL1] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELL1] - value of upsell item 1 (number can be between 0 to 20)

[INVOICEUPSELLNUM1] - as per [INVOICEUPSELL1] but the value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEUPSELLQTY1] - quantity of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLNAME1] - name of the headline field of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLSTATUS1] - stautus of the headline field of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLHEADLINE1] - headline (name and status if used of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLDESCRIPTION1] - description of upsell item 1 (number can be between 1 to 20)

[INVOICEUPSELLAMOUNTNUM1] - amout of upsell item 1

[INVOICEUPSELLTYPE1] - type of upsell item 1

[INVOICEUPSELLPER1] - per of upsell item 1

[INVOICEUPSELLPERIOD1] - period of upsell item 1

[INVOICEEXTRAITEMDESC1] - Name of extra invoice item 1 (number can be between 0 to 20)

[INVOICEEXTRAITEM1] - value of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEEXTRAITEM1] - value of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEEXTRAITEMNUM1] - as per [INVOICEEXTRAITEM1] but the value is displayed with a decimal point and no thousands separator (for calculations).

[INVOICEEXTRAITEMQTY1] - quantity of extra invoice item 1 (number can be between 0 to 20) Note: the order goes by the order in the dropdown list not by the order the items are entered.

[INVOICEGROSS:1] - gross amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

INVOICEGROSSNUM:1] gross amount of the inserted VAT rate (number is the VAT rate)

[INVOICENET:1] - net amount of the inserted VAT rate (number is the VAT rate)

[INVOICENETNUM:1] - net amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEVAT:1] - VAT amount of the inserted VAT rate (number is the VAT rate)

[INVOICEVATNUM:1] VAT amount of the inserted VAT rate (number is the VAT rate), value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEITEMBYDESC:Searchterm] - searches the invoice for items with this search term and adds them up

[INVOICEITEMBYDESCNUM:Searchterm] - searches the invoice for items with this search term and adds them up, value is displayed with a decimal point and no thousands separator (for calculations)

[INVOICEPAYMENTBYDESC:Searchterm] - searches the payments for items with this search term and adds them up

[INVOICEPAYMENTBYDESCNUM:Searchterm] - searches the payments for items with this search term and adds them up, value is displayed with a decimal point and no thousands separator (for calculations)

=== Invoice Table ===
These template varibles will display an invoice table.
==== Standard Invoice Tables ====
[INVOICETABLE] - invoice table

[INVOICETABLEVAT] - invoice table with vat information and vat summary

[INVOICETABLE:$1.1$] - invoice table and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEPART:status1,status2,!status4] - Invoice table showing only items with matching status. The status items can be a comma separated list. To exclude status items prefix them with an exclamation mark, for example !status1.

[INVOICETABLE2] - invoice table with status field

[INVOICETABLE2:$1.1$] - invoice table with status field and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLECHARGES] - invoice table showing charges only

[INVOICETABLECHARGESINVOICEE1234] - invoice table showing charges only assigned to the specified invoicee, specify the invoicee Id number.

[INVOICETABLENOTOT] - invoice table without grand total

[INVOICETABLENOTOT:$1.1$] - invoice table without grand total and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLENOTOT2] - invoice table with status field without grand total

[INVOICETABLENOTOT2:$1.1$] - invoice table with status field without grand total and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT:$1.1$] - invoice table with vat information and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCOMPACT] - compact version of invoice table with vat information and vat summary

[INVOICETABLEVATCOMPACT:$1.1$] - compact version of invoice table with vat information and vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCOMPACTNOSUM] - compact version of invoice table with vat information without vat summary

[INVOICETABLEVATCOMPACTNOSUM:$1.1$] - compact version of invoice table with vat information without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATNOSUM] - invoice table with vat information without vat summary

[INVOICETABLEVATNOSUM:$1.1$] - invoice table with vat information without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEDATEVATNOSUM] - invoice table with vat information and date without vat summary

[INVOICETABLEDATEVATNOSUM:$1.1$] - invoice table with vat information and date without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT2] - invoice table with vat information and status field and vat summary

[INVOICETABLEVAT2:$1.1$] - invoice table with vat information and status field and vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVAT2NOSUM] - invoice table with vat information and status field without vat summary

[INVOICETABLEVAT2NOSUM:$1.1$] - invoice table with vat information and status field without vat summary and currency multiplier with optional new currency symbol before or after price.

[INVOICETABLEVATCHARGES] - invoice table showing charges only with vat information and vat summary

[INVOICETABLENOPRICE] - invoice table with no price information

[INVOICETABLEINVOICEE] - invoice table excluding items assigned to an invoicee.

[INVOICETABLEINVOICEE1234] - invoice table for a specific invoicee, specify the invoicee Id number.

[UPSELLTABLE] - table with all upsell items

[UPSELLTABLEVAT] - table with all upsell items with vat information and vat summary

[UPSELLTABLENOREFUND] - table with all upsell items except refundable items

==== Custom Invoice Table ====
You have the option to create a custom invoice table. Available content variables are:

AMO - shows the net value (price x quantity)

CEX - charges excluded (charges will not be shown)

CON - currency conversion. Example: CONEURUSD will convert the first currency (Euros) to the second currency (USD). CON1.234 would multiply the prices by 1.234

CUA - currency symbol showing after the numbers. Example: CUA€ will show € after the figures

CUB - currency symbol showing before the numbers. Example: CUB€ will show € before the figures

DAT - adds a date column - you have the option to control the format of the date using [[Template_Variables#Date_and_Time|date and time variables]] for example DAT{%d-%m-%Y}

DEC - Decimal points. Example: DEC, will show a comma as decimal point. If nothing is set the system will use the default for the language

DP0 - no decimal places

DP1 - 1 decimal place

DP2 - 2 decimal places

DP3 - 3 decimal places

DP4 - 4 decimal places

GAT - sum for each column

GRP - Group Totals. Displays the same items as a total

GRT - Grand Total

INV - invoicee, add the invoicee number at the end. Example: INV20 to show invoicee number 20, INV0 will show items not assigned to an invoicee, INV-1 will show all items from the booking regardless of invoicee. You can combine INV[BOOKINGINVOICEEID]] to add the invoicee from the booking

LAN - language. Example LANDE will force the language to German

MUL - multiplier. Example: MUL1.2 will multiply all prices by 1.2

NIN - do not show invoice number and invoice date on locked invoices

NOC - charges will not be displayed but their vat values are still calculated for the vat summary (VAT)

NOP - payments will not be displayed

ONE - shows only items from the specified booking (not the booking group)

ORB - order by booking, this keeps the items for each booking (room) together in the table

PAA - shows a column with payment amounts

PAY - shows payments

PEN - shows pending payments description

PPA - shows pending payments amount

PRI - shows prices in a column

QTY - shows quantity

SEX - status excluded. Calculate the balance of all invoice items except for the ones with these status, the status items can be a comma separated list. Example: SEX status1,status2,status4 will not show items with this status.

SIN - status included. Calculate the balance of all invoice items with matching status, the status items can be a comma separated list. Example: SIN status1,status2,status4 will only show items with this status.

STA- shows staus

THO - thousands separator. THO. will show a dot as thousand separator. If nothing is set the system will use the default for the language

TOT - shows total amounts

VAA - shows VAT amounts

VAP - shows VAT percents

VAT - VAT summary

Connect the variables with an underscore.

Examples:

[INVOICE:PRI_QTY_CUA€] will create an invoice table with price and quantity in Euros.

[INVOICE:PAY_TOT_CEX] will create an invoice table which will only show payments.

[INVOICE:PRI_QTY_CUA_TOT_VAT_QTY_PAY_GRT_AMO_VAA] will create an invoice table with more information.

== Invoicee Variables ==
[INVOICEEBALANCE] - invoice balance for unassigned invoice items.

[INVOICEEBALANCENUM] - invoice balance for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEEBALANCE1234] - invoice balance for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number).

[INVOICEEBALANCENUM1234] - invoice balance for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number) displayed with a decimal point and no thousands separator.

[INVOICEECHARGES] - invoice charges for unassigned invoice items.

[INVOICEECHARGESNUM] - invoice charges for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEECHARGES1234] - invoice charges for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number).

[INVOICEECHARGESNUM1234] - invoice charges for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number) displayed with a decimal point and no thousands separator.

[INVOICEEPAYMENTS] - invoice payments for unassigned invoice items.

[INVOICEEPAYMENTSNUM] - invoice payments for unassigned invoice items displayed with a decimal point and no thousands separator.

[INVOICEEPAYMENTS1234] - invoice payments for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number)

[INVOICEEPAYMENTSNUM1234] - invoice payments for invoice items assigned to invoicee 1234 (change 1234 to the required Invoicee Id number)

[INVOICEENAME] - name of the invoicee account the invoice is assigned to or blank

[INVOICEECODE] - code of the invoicee account the invoice is assigned to or blank

[INVOICEECURRENCY] - currency of the invoicee account the invoice is assigned to if it is not the property default or blank

[INVOICEETEMPLATE1] - template value 1 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE2] - template value 2 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE3] - template value 3 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE4] - template value 4 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE5] - template value 5 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE6] - template value 6 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE7] - template value 7 of the invoice account the invoice is assigned to or blank

[INVOICEETEMPLATE8] - template value 8 of the invoice account the invoice is assigned to or blank

== Payment Request Variables ==
[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.

[PAYURL:200] - Creates a payment url for the payment request url for a fixed amount. nt.

[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.

[PAYLINK:200] - Creates a payment link (HTML A tag) for the payment request) for a fixed amount.

[PAYBUTTON] - Creates a payment button for the payment request for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Not recommended for emails.

[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. Not recommended for emails.

[PAYBUTTON:200] - Creates a payment button for the payment request for a fixed amount.

[PAYPALURL] - Creates a Paypal payment url for the amount in the booking deposit field if non zero, otherwise the outstanding balance.

[PAYPALURL:25%] - Creates a Paypal payment url for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance.

[PAYPALURL:200] - Creates a Paypal payment url for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount.

[PAYPALLINK] - Creates a Paypal payment link (HTML A tag) for the amount in the booking deposit field if non zero, otherwise the outstanding balance.

[PAYPALLINK:25%] - Creates a Paypal payment link (HTML A tag) for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance.

[PAYPALLINK:200] - Creates a Paypal payment link (HTML A tag) for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount.

[PAYPALBUTTON] - Creates a Paypal payment button for the amount in the booking deposit field if non zero, otherwise the outstanding balance. Not recommended for emails.

[PAYPALBUTTON:25%] - Creates a Paypal payment button for a percentage of the outstanding balance. Use 100% to specify the full outstanding balance. Not recommended for emails.

[PAYPALBUTTON:200] - Creates a Paypal payment button for a fixed amount. A zero amount will cause paypal to provide a field to enter an amount. Not recommended for emails.

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

== Text Operators ==

[REPLACE|searchForThisText|replaceWithThisText|textToSearch] - replace "searchForThisText" with "replaceWithThisText" within the text "textToSearch"

[SUBSTR|startCharacterNumber|numberOfCharacters|textToGetSubstringFrom] - get a sub string from "textToGetSubstringFrom" starting at character "startCharacterNumber" (integer, 0 is the first char) with a length of "numberOfCharacters" (integer)

[TRIM| string to trim ] - remove whitespace from the start and end of " string to trim "

== iCal Links ==
These template variables will create iCal links which allow the booking to be added to a calendar.

[ICALURL] - Calendar link

[ICALURL:16] - Calendar link with check-in hour. Replace '16' with the hour check-in starts.

[ICALURL::10] - Calendar link with check-out hour. Replace '10' with the hour with the hour check-out ends.

[ICALURL:::summary text] - Calendar link with a summary text

[ICALURL::::description text] - Calendar link with a descriptive text

Example:

Calendar link with check-in time 16:00, check-out time 10:00, the summary text "Booking" and the description text "Sunny Hotel":

[ICALURL:16:10:Booking:Sunny Hotel]

== Mathematical Operators ==

Place mathematical operators between two numbers <b>or between two template variables</b> that return a number.

[+] - Example: 2 [+] 3 = 5

[-] - Example: 5 [-] 1 = 4

[*] - Example: 3 [*] 4 = 12

[/] - Example: 15 [/] 5 = 3

[MIN] - Example: 2 [MIN] 3 = 2

[MAX] - Example: 2 [MAX] 3 = 3

Brackets are not supported as a way to control processing order, the processing order is fixed as *, /, +, -, MIN, MAX

=== Rounding and controlling decimal places ===

==== Default ====

2 [/] 3 = 0.66666666666667

==== Rounding to the nearest integer ====

2 [/.0] 3 = 1

==== Rounding to 1,2,3 or 4 decimal place(s) ====

2 [/.1] 3 = 0.7

2 [/.2] 3 = 0.67

2 [/.3] 3 = 0.667

2 [/.4] 3 = 0.6667

<b>This works on all operators including [MIN] and [MAX]</b>

Note: Always use the template variables ending with NUM. The math functions will only work with numbers with a decimal point (not a decimal comma) and no thousands separator and no currency symbol.

== Currency Conversion ==

[CONVERT:EUR-USD] - get the actual conversion rate between two currencies, this can be used with math functions to show alternative currency values. All currencies supported by the booking page currency selector can be used.

Example: [INVOICECHARGESNUM] [*.2] [CONVERT:EUR-USD] will convert the invoice charge value from Euros to USD with two decimal points.

If you use the multiplier to convert currencies for channels: For example hotel id 123456 and a multiplier to convert USD to EUR at todays rate:

123456*[CONVERT:USD-EUR]*

or this to convert EUR to USD

123456*[CONVERT:EUR-USD]

123456*[CONVERT:USD-EUR][/]0.85 will convert to Euros and divides the price by 0.85 which raises it by circa 15%

==Account Variables (account of the booking) ==

[ACCOUNTID] - account id of the booked property

[ACCOUNTTEMPLATE1] - Account Template 1

[ACCOUNTTEMPLATE2] - Account Template 2

[ACCOUNTTEMPLATE3] - Account Template 3

[ACCOUNTTEMPLATE4] - Account Template 4

[COMMISSIONLIMIT] - shows the available commission amount for the owner account of the booking

[MASTERACCOUNTTEMPLATE1] - Account Template 1 from master account

[MASTERACCOUNTTEMPLATE2] - Account Template 2 from master account

[MASTERACCOUNTTEMPLATE3] - Account Template 3 from master account

[MASTERACCOUNTTEMPLATE4] - Account Template 4 from master account

==Account Variables (logged in account, only for display in control panel , not for auto actions or emails etc.) ==
These variables can for example used by resellers who added a custom tab to the bookings.

[LOGGEDINACCOUNTID] - account id of the logged in user

[LOGGEDINACCOUNTTEMPLATE1] - Account Template 1

[LOGGEDINACCOUNTTEMPLATE2] - Account Template 2

[LOGGEDINACCOUNTTEMPLATE3] - Account Template 3

[LOGGEDINACCOUNTTEMPLATE4] - Account Template 4

[LOGGEDINAPIKEY] - apiKey

[MASTERLOGGEDINACCOUNTTEMPLATE1] - Account Template 1 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE2] - Account Template 2 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE3] - Account Template 3 from master account

[MASTERLOGGEDINACCOUNTTEMPLATE4] - Account Template 4 from master account

== Smart Logic Template Variables ==

IF style template variables will compare two values and display a text if the comparison is true and an alternative text if the comparison is false.
Colons : are used between the two comparison values and the first text, a pipe | is used between the two texts.
Empty text is allowed if you do not want to display anything for a condition.

[IF=:if this:equals this:display this text|otherwise display this text]

[IFIN:if this:is contained in this:display this text|otherwise display this text]

[IFLIKE:if this:is like this:display this text|otherwise display this text]

[IF>:if this:is greater than this:display this text|otherwise display this text]

[IF>=:if this:is greater than or equal to this:display this text|otherwise display this text]

[IF<:if this:is less than this:display this text|otherwise display this text]

[IF<=:if this:is less than or equal to this:display this text|otherwise display this text]

[IFBETWEEN:if this:is between this:and this:display this text|if it is lower display this text|if it is higher display this text]

You can use IF variables inside other IF variables to create complex logic but the internal IF: must be processed before the external IF
There are special versions of each IF constructed with ^ and ~ separators like [IF=^this^this^same~different]
The special versions are processed first so should be used as the internal IF so it's result can be processed by the outer if.
The special versions can also be used if you expect : or | characters within your data.

IF's are processed in the following order.
i.e. all the [IF=^ will be processed first, then all the [IFIN^ etc.

[IF=^
[IFIN^
[IFLIKE^
[IF>^
[IF>=^
[IF<^
[IF<=^
[IFBETWEEN^
[IF=:
[IFIN:
[IFLIKE:
[IF>:
[IF>=:
[IF<:
[IF<=:
[IFBETWEEN:

Template variables can be used inside this template variable as per the examples <span style="color: #019cde">comparison in blue</span>, <span style="color: #75d5ad">positive result in green</span>, <span style="color: #fe746c">negative result in red</span>:

1. [<span style="color: #019cde">IF=:[GUESTNAME]</span><span style="color: #75d5ad">:Miller</span><span style="color: #75d5ad"><span style="color: #75d5ad">:yes</span> <span style="color: #fe746c">|no</span>]

If the guestname is Miller the text "yes" will display. If the guest name is not Miller the text "no" will display

2.[<span style="color: #019cde"> IF>:[NUMADULT]:2</span><span style="color: #75d5ad">:please contact us about you bedding requirements|</span>]

If the number of adults is higher than 2 the text"please contact us about you bedding requirements" will display. If the number of adults is lower than or equal 2 nothing will display.

3. [<span style="color: #019cde">IF<:[NUMADULT]:3</span><span style="color: #75d5ad">:|linen for two adults is included free of charge</span>]

If the number of adults is lower than 3 nothing will display. If the number of adults is not lower than 3 the text "linen for two adults is included free of charge" will display.

4. [<span style="color: #019cde">IF<=:[NUMADULT]:2</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|no</span>]

5. [<span style="color: #019cde">IF>=:[NUMADULT]:2</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|no</span>]

6. [<span style="color: #019cde">IFBETWEEN:[NUMADULT]:1:3</span><span style="color: #75d5ad">:yes</span><span style="color: #fe746c">|too low|too high</span>]

7. [<span style="color: #019cde">IFLIKE:[GUESTTITLE]</span><span style="color: #75d5ad">:Mr:Dear|Hi</span>]

IFLIKE works like IF= except it is case insensitive and removes any spaces from the start and end of the words

8. [<span style="color: #019cde">IFIN:John:[GUESTFIRSTNAME]</span><span style="color: #75d5ad">:Hi John</span><span style="color: #fe746c">|Your name does not contain John?</span>]

If the first word is contained in the second word the first option is displayed, otherwise the second option is displayed

9. [<span style="color: #019cde">IFIN:CHECKIN:[BOOKINGINFOITEMS]</span><span style="color: #75d5ad">:[BOOKINGINFOCODETEXT:CHECKIN]</span><span style="color: #fe746c">|</span>]

If the Booking Info Code CHECKIN has been added to the booking then you will see the value in the text (date/time) otherwise blank.

[INWORDS] - writes out a number in words. This works in English only.

Expamles:

[INWORDS] 10 will write out then

[INWORDS] [INVOICEPAYMENTSNUM] will write out the invoice sum of all payments

[INWORDS] [INVOICEPAYMENTSNUM] [+] 10 will write out the invoice sum of all payments plus 10

Example: You want to display a special message to Australians if the booking has a DEPOSIT info item code, if a deposit is required from a non Australia they get "A deposit is required" and if no deposit is required they see "No deposit is required"

[<span style="color: #019cde">IFIN:DEPOSIT:[BOOKINGINFOCODES]:I[IF=:[GUESTCOUNTRY2]:AU</span><span style="color: #75d5ad">:Credit card details are required </span><span style="color: #fe746c">|A deposit is required]|No deposit is required</span>]

== Encoding Template Variables ==

[ENCODEURL:value] encode value for URL data format

[ENCODEJSON:value] encode value for JSON data format

Note: Always use the template variables ending with NUM if numbers are involved. The math functions will only work with numbers with a decimal point (not a decimal comma) and no thousands separator and no currency symbol.

Google Calendar

2021-08-17T18:50:16Z

Marco:

[[Category:Channel Manager]]
[[Category:Google]]
[[Category:Ical]]
[[Category:Troubleshooting]]
<div class="heading">Google Calendar API </div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > GOOGLE CALENDAR API and explains how to connect to Googles Calendar API

= Capabilities =
This connection allows an instant two-way sync with Google Calendars.
*Beds24.com can export bookings to Google Calendar as events.
*Beds24.com can import events from Google Calendar as bookings.

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> The Google Calendar API connection updates faster than an iCal connection. Use this connection to sync with Google Calendars instead of iCal.

= Limitations =
Changes need to be made at the origin of the booking:
*Changes to booking which were created in Google and were imported from the Google Calendar need to be made in Google. Beds24 will then import the change and update the booking.
*Changes to bookings which origin from Beds24 or an OTA need to be changed where they were made. Beds24 will then update the change to Google Calendar.

<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Only one property from Beds24 can be connected to the same Google Calendar. If you want to connect several properties, you need to have several different Google Calendars.

= Setup =
'''Step 1: Authentication'''
*Click the "Connect Google Calendar" link.
*Sign in to your Google account if prompted.
*Click "Allow" on the "Calendar API wants to access your Google Account" screen.

'''Step 2: Map your rooms to calendars'''
*Click "Get codes" and fill the field with the calendar you want to connect to this room.

'''Step 2: Choose in "Synchronization" what you want to synchronize''''
*"import and export" is a two-way connection which will import bookings originally entered in the Google Calendar to Beds24 and export bookings from Beds24 to Google Calendar.
*"import only" is a one-way connection which will only import bookings originally entered in the Google Calendar to Beds24.
*"export only" is a one-way connection which will only export bookings from Beds24 to Google Calendar.

If "Blocked Date Summary" is not empty, dates blocked in Beds24 for reasons other than a booking will be exported to the Google calendar with this summary.

'''Step 4: Customize data sending (optional)'''

Click on "Edit" for the room and customise what gets exported or imported.
*By default the start time for exported bookings is 14:00 local time and end time for exported bookings is 10:00 local time. You have the option to replace these times with your check-in and check-out times.
*The Summary, Description and Location of each event can be customized using text and [[Template Variables]].
*Prevent certain events from being imported.

= Troubleshooting =

= Disconnect =
Set "Sync Type" = Disabled to stop syncing the room.

/Embedded Iframe

2021-07-27T17:11:26Z

Marco: Created page with "=Embedded Iframe Troubleshooting = ==Booking page does not redirect to the secure payment page== If the booking page is used within an Iframe or in Wordpress it sometimes cann..."

=Embedded Iframe Troubleshooting =
==Booking page does not redirect to the secure payment page==
If the booking page is used within an Iframe or in Wordpress it sometimes cannot redirect the user to secure payment due to the security settings in browsers or the payment gateway will block iframes.

To fix this you can allow the the secure page to open in the full window or a new window. You set this in SETTINGS > BOOKING ENGINE > BOOKING PAGE > BEHAVIOUR setting "Open in New Window" = On secure payment.

Booking.com: Import Properties from Booking.com to Beds24

2021-07-26T17:44:13Z

Marco: /* Step by Step Guide */

[[Category:Channel Manager]]
[[Category:Booking.com]]
[[Category:Channel Manager]]
[[Category:Troubleshooting]]
<div class="heading">Booking.com: Import properties from Booking.com to Beds24</div>
This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > CONTENT and explains how to import properties from Booking.com to Beds24.

= Import Properties from Booking.com =
You can create a new property and rooms in Beds24 from a property in Booking.com. The Booking.com hotel and room IDs will be automatically added to the channel manager settings.

= Step by Step Guide =
'''Step 1: Initiate the XML connection with Booking.com'''

Initiate the XML connection from the property menu within the booking.com extranet and then do the Beds24 setup.

#Login to Booking.com and go to ACCOUNT->CHANNEL MANAGER. If you do not see this option contact Booking.com and tell them you want to use a channel manager
#Click the Start button and search for BEDS24.
#Choose NOT to connect automatically [[Image:bookingmanual.png|500px|link=]] [[Media:bookingmanual.png|view large]]
#Complete the rest of the on screen instructions and make sure you select a two-way connection and content.
#When ready you will receive a notification from Booking.com.

<div class="warning">{{#fas:exclamation-triangle}} '''IMPORTANT:''' DO NOT confirm the connection in Booking.com until you perform the STEPS, below in Beds24. If you confirm the connection Booking.com will remove your prices and we will not be able to import them.</div>

'''Step 2: Import Property shell with rooms and prices'''
#Go to {{#fas:cog}} (SETTINGS) PROPERTIES then click on "Import from OTA" and choose "Booking.com".
#Click on the "Import a property from Booking.com" button.
#Enter the Booking.com hotel ID of the property you want to import then click on "Import from Booking.com".
#Go to the CALENDAR and check that your prices imported properly.
#Go to SETTINGS->CHANNEL MANAGER-BOOKING.COM and
##Click on the "View Actual Data" Button to check which prices and availability will send to Booking.com.
##Check that all tick boxes for "Inventory and Prices" and "Bookings" are ticked for all rooms.

Up to 10 prices will import as daily prices. Minimum stays will not import.

At this stage Booking.com will NOT send all content. You can check what Booking.com sent when you click on the "View content sent to Booking.com" link so you can see which information needs to be set up in Beds24.

'''Step 3: Confirm the connection in Booking.com'''

When your prices are correct you can confirm the connection in Booking.com.

[[Image:bookingconfirm.png|600px|link=]]
[[Media:bookingconfirm.png|view large]]

Booking.com will remove your prices and Beds24 will now automatically update prices, availability and import bookings.

'''Step 4: Import content and existing bookings from Booking.com'''
*Click on "Manage Content".
*Click on "Property" and select "Import from Booking.com"
*Go back to SETTINGS->CHANNEL MANAGER->BOOKING.COM and click on the the "Import existing bookings" button to import bookings which for future dates.

<div style="display:none">

Step by Step Guide

'''Step 1: Request Import '''

Sent us a support ticket via SUPPORT in the top you your control panel in which you give us the Booking.com hotel IDs of the properties you want to import.

'''Step 2: Confirmation from Beds24'''

After we have confirmed your import request you can import the property shell and prices.

'''Step 3: Import Property Shell with Rooms and Prices '''

#Click on "Sync Content".
#Cick on "Import New Property from Booking.com".
#Enter the Booking.com hotel ID of the property you want to import then click on "Import from Booking.com".
#Go to the CALENDAR and check that your prices imported properly.
#Go to SETTINGS->CHANNEL MANAGER-BOOKING.COM and
##Click on the "View Actual Data" Button to check which prices and availability will send to Booking.com.
##Check that all tick boxes for "Inventory and Prices" and "Bookings" are ticked for all rooms.

'''Step 4: Initiate the connection with Booking.com'''

After your prices have imported you can initiate the XML connection from the property menu within the booking.com extranet and then do the Beds24 setup.

#Login to Booking.com and go to ACCOUNT->CHANNEL MANAGER. If you do not see this option contact Booking.com and tell them you want to use a channel manager
#Click the Start button and search for BEDS24. <embedvideo service="youtube">https://youtu.be/VYzWI-PDVYk</embedvideo>
#Complete the rest of the on screen instructions and make sure you select a two-way connection and content.
#When ready you will receive a notification from Booking.com.

<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Booking.com will remove your prices and Beds24 will now automatically update prices, availability and import bookings.

'''Step 5: Import Content and existing Bookings from Booking.com'''

*Click on "Sync Content".
*Click on "Import from Booking.com"
*Go back to SETTINGS->CHANNEL MANAGER->BOOKING.COM and click on the the "Import existing bookings" button to import bookings which for future dates.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Booking.com will not send all content. You can check what Booking.com sent when you click on the "View content sent to Booking.com" link so you can see which information needs to be set up in Beds24.

Setting/propertiesreqtel

2021-04-07T19:55:35Z

Marco:

Select if you want to

*not collect this information - the field will not appear on your booking page: set to not used

*make it obligatory meaning your guests can not proceed the booking without entering this information: set to compulsory

*show the field on your booking page but leave it to your guest to enter information or not: set to optional

If you want to receive the phone numbers from guests who made a booking through the OTAs, select at least "Internal".

Options with 'Guest can edit' will be coming soon to the Guest Login.

Setting/propertiesreqtel

2021-04-07T19:54:40Z

Marco:

Select if you want to

*not collect this information - the field will not appear on your booking page: set to not used

*make it obligatory meaning your guests can not proceed the booking without entering this information: set to compulsory

*show the field on your booking page but leave it to your guest to enter information or not: set to optional

*If you want to receive the phone numbers from guests who made a booking through the OTAs, select at least "Internal".

Options with 'Guest can edit' will be coming soon to the Guest Login.

Setting/propertiesreqtel

2021-04-07T19:52:29Z

Marco:

Select if you want to

*not collect this information - the field will not appear on your booking page: set to not used

*make it obligatory meaning your guests can not proceed the booking without entering this information: set to compulsory

*show the field on your booking page but leave it to your guest to enter information or not: set to optional

*If you want to receive the phone numbers from bookings from the OTAs, select at least "Internal".

Options with 'Guest can edit' will be coming soon to the Guest Login.

Airbnb Mapping

2021-02-24T17:51:45Z

Marco: /* Send and receive messages */

Facebook

2021-02-03T17:27:46Z

Marco: /* Beds24 Facebook App - available for Facebook users whose Facebook page has more than 2000 fans */

[[Category:Widgets]]
[[Category:Apps]]
<div class="heading">Facebook App</div>
This page explains how to use the Facebook App
__TOC__
== Booking Page link on Call-to-Action Button ==
You can link your Beds24 booking page to a "Book Now" Call-to-Action button on your Facebook page.

You can find the link to your booking page in {{#fas:cog}} (SETTINGS) BOOKING ENGINE and {{#fas:cog}} (SETTINGS) ä.lö-ä#üöä-üäBOOKNG PAGE->LINK.

Information on how to use a Call-toAction is available in the [https://www.facebook.com/help/977869848936797 Facebook help].

== Beds24 Facebook App - available for Facebook users whose Facebook page has more than 2000 fans ==
The App will create a custom "Book Now" tab which shows your booking page directly in Facebook. For an example visit our our [https://www.facebook.com/Beds24com/?fref=ts Facebook page]

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Currently Facebook does not allow all pages to add customer tabs. We suggest you add a [https://www.facebook.com/help/977869848936797 "Book Now" Call-to-Action] button with a link to your Beds24 booking page if you can not add a tab.

*Log into your Facebook account and go to [https://www.facebook.com/Beds24com https://www.facebook.com/Beds24com]
*Click on "Install App"

[[Image:fb_.png|350px|link=]]
[[Media:fb_.png|view large]]

[[Image:fb1.png|350px|link=]]
[[Media:fb1.png|view large]]

*Select the page you want to install the App on and click on "Add Tab".
[[Image:fb2.png|350px|link=]]
[[Media:fb2.png|view large]]

*If asked enter the security code.

*Go to your Facebook page and click on "Book Now".
[[Image:fb_id_1.png|350px|link=]]
[[Media:fb_id_1.png|view large]]

*When you click on "Book Now" you will be asked if you want to show one property or multiple properties.
If you want to show a single properties enter your Beds24 property ID. You can find the property id number in your your Beds24.com account in {{#fas:cog}} (SETTINGS) PROPERTIES >
DESCRIPTION.

[[Image:fb_id_2.png|350px|link=]]
[[Media:fb_id_2.png|view large]]

Please make sure you enter the '''your correct property ID'''. Facebook stores the data in cookies on your pc which makes it remember the old settings.

If you want to show multiple properties enter your Beds24 account number. You can find the account number in your your Beds24.com account in {{#fas:cog}} (SETTINGS) ACCOUNT.

[[Image:fb_id_3.png|350px|link=]]
[[Media:fb_id_3.png|view large]]

Please make sure you enter '''your correct account number'''. Facebook stores the data in cookies on your pc which makes it remember the old settings.

*Once the number is entered the App is active and your live Beds24.com booking page will be shown.
[[Image:fb8.png|350px|link=]]
[[Media:fb8.png|view large]]

Facebook allows you to change the settings for your tabs and add a picture. Please use the [https://www.facebook.com/help/371634529571035/ Facebook help] for instructions how to do this.

If you entered a wrong number we will need to reset your account. Please open a support ticket with a link to your Facebook page. NOTE: Resetting accounts is an extra service for which we will need to charge a fee.

<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> If you are using your own domain: Facebook will block the display if the page is not SSL secured.

== Mobile Devices ==
Currently Facebook does not show custom tabs on mobiles. We suggest you add a [https://www.facebook.com/help/977869848936797 "Book Now" Call-to-Action] button which will also display on mobile devices.

== Track bookings ==
All bookings from Facebook have the referrer 'facebook'.

For conversion tracking you can add the Facebook tracking pixel image in your "on screen confirmation message". This will only show after the booking is confirmed.

== Discounts for guests booking on Facebook ==
To offer a discount you can use the referrer discount in the "Discounts" tab of the rate. The referrer code to enter is facebook.