Difference between revisions of "ICal import"
(→Notes) |
|||
(10 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
[[Category:Ical]] | [[Category:Ical]] | ||
[[Category:Error Messages from Channels]] | [[Category:Error Messages from Channels]] | ||
− | [[Category: | + | [[Category:Troubleshooting]] |
− | + | <div class="heading">Ical Import</div> | |
+ | This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > ICAL IMPORT and explains how to import bookings or block dates using an external iCal or google calendar'' | ||
== Capabilities == | == Capabilities == | ||
Line 17: | Line 18: | ||
*The event summary is imported as the guest name. | *The event summary is imported as the guest name. | ||
*The event description is imported as the guest comment. | *The event description is imported as the guest comment. | ||
− | *The full event information from the iCal is stored in the | + | *The full event information from the iCal is stored in the Channel Info field of the booking. |
The iCal export channel can be set up to ignore bookings imported using an iCal import channel, this allows two way connections to be made to google or similar calendars without creating duplicate bookings. | The iCal export channel can be set up to ignore bookings imported using an iCal import channel, this allows two way connections to be made to google or similar calendars without creating duplicate bookings. | ||
Line 34: | Line 35: | ||
== Setup == | == Setup == | ||
− | + | '''Step 1: Enter the calendar URL you want to import''' | |
− | + | ||
+ | |||
+ | '''Step 2: Define if certain bookings should be ignored so they do not import (optional) ''' | ||
− | |||
Events in the iCal will be ignored if they contain this phrase in either their Summary or Description. | Events in the iCal will be ignored if they contain this phrase in either their Summary or Description. | ||
To specify multiple phrases, enter one phrase per line. | To specify multiple phrases, enter one phrase per line. | ||
− | + | ||
− | + | '''Step 3: Select whether the calendar specifies the end of the booking by last night or check-out date ''' | |
+ | |||
+ | *"Ignore duplicates" will ignore bookings if there is another booking from any channel with the same dates which is not cancelled. | ||
+ | *"Ignore if all dates unavailable" will not import a booking if the room is not available for any reason (no inventory, blackout). | ||
+ | *"Dont reuse cancelled if different" will import a new booking if there is already a cancelled booking with a different UUID, the default is to uncancel the existing booking. | ||
+ | |||
+ | <span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you accidentally imported from a wrong iCal or imported with the wrong settings click on the "delete booking tool link" to delete all imported bookings. | ||
== Disconnect == | == Disconnect == | ||
*Remove the URL | *Remove the URL | ||
− | *Set "Import2 = Disable | + | *Set "Import2"= Disable |
== Custom Fields == | == Custom Fields == | ||
− | The following custom fields | + | The following custom fields from an iCal feed are supported. If present in the iCal feed the data is imported into the relevant booking field. For further information contact the supplier of the iCal feed. |
+ | |||
+ | <code>X-EMAIL: [email protected]</code> | ||
+ | |||
+ | <code>X-PHONE: 12345678</code> | ||
+ | |||
+ | <code>X-NUMADULT: 2</code> | ||
+ | |||
+ | <code>X-NUMCHILD: 0</code> | ||
− | + | <code>X-PRICE: 100</code> | |
− | |||
− | |||
− | |||
− | |||
== Notes == | == Notes == |
Latest revision as of 10:11, 13 April 2024
This page is about the menu (SETTINGS) CHANNEL MANAGER > ICAL IMPORT and explains how to import bookings or block dates using an external iCal or google calendar
Contents
1 Capabilities
Beds24.com can import bookings from up to 3 iCal calendars per room. Many holiday rental sites support Ical more Information
- You can select if the end date of an event is the last night of the booking or the checkout day.
- Each full day or multi day event in your iCal calendar will be imported as a booking.
Changes to dates can be imported:
- If a booking that was previously imported is missing from a future import, the booking status will be changed to Cancelled.
- Importing changes or cancellations can be disabled for individual bookings or the entire calendar.
Import into Beds24:
- The event summary is imported as the guest name.
- The event description is imported as the guest comment.
- The full event information from the iCal is stored in the Channel Info field of the booking.
The iCal export channel can be set up to ignore bookings imported using an iCal import channel, this allows two way connections to be made to google or similar calendars without creating duplicate bookings.
The calendar will normally be checked multiple times per hour. For details please click here
2 Limitations
The iCal calendar must be available on the internet for Beds24 to poll and must be set for public access. Some calendars like google allow public access (sharing) to be set on an event basis and only public events can be imported.
Bookings must be defined as full day events on the days you want to block.
Only the information specified in the Capabilities section above can be imported from the iCal.
3 What you will need
The URL of the iCal calendar to import from.
4 Setup
Step 1: Enter the calendar URL you want to import
Step 2: Define if certain bookings should be ignored so they do not import (optional)
Events in the iCal will be ignored if they contain this phrase in either their Summary or Description.
To specify multiple phrases, enter one phrase per line.
Step 3: Select whether the calendar specifies the end of the booking by last night or check-out date
- "Ignore duplicates" will ignore bookings if there is another booking from any channel with the same dates which is not cancelled.
- "Ignore if all dates unavailable" will not import a booking if the room is not available for any reason (no inventory, blackout).
- "Dont reuse cancelled if different" will import a new booking if there is already a cancelled booking with a different UUID, the default is to uncancel the existing booking.
If you accidentally imported from a wrong iCal or imported with the wrong settings click on the "delete booking tool link" to delete all imported bookings.
5 Disconnect
- Remove the URL
- Set "Import2"= Disable
6 Custom Fields
The following custom fields from an iCal feed are supported. If present in the iCal feed the data is imported into the relevant booking field. For further information contact the supplier of the iCal feed.
X-EMAIL: [email protected]
X-PHONE: 12345678
X-NUMADULT: 2
X-NUMCHILD: 0
X-PRICE: 100
7 Notes
Duplicates
If you import bookings from a calendar that is also using ical export, (2 way connection) you will probably create duplicate bookings as they are passed back and forth between the systems.
The ignore duplicates options will not import a booking from the iCal if a non cancelled booking already exists in the same room for the same dates regardless of the source of the booking. For example a booking might be made on your booking page and exported via iCal to a third party system. If using a ignore duplicates option, iCal import will not re-import that booking. Note that only the dates are used to determine a duplicate, this means a booking will not import from ical if a booking for the exact same dates already exists in the room, even if it is in reality a different booking.
See the instructions for ical export -> "Data Options" to prevent re-exporting bookings which have been imported by the iCal import channel.
Modifications
Booking modifications and cancellations can be imported or ignored.
A booking will be considered cancelled if it is no longer in the iCal
Additionally an email notification to the host can be sent when iCal cancellations occur.
Modifications to the check-in, check-out and guest name fields are supported.