ICal import: Difference between revisions

Jump to navigation Jump to search
 
(14 intermediate revisions by 3 users not shown)
Line 2: Line 2:
[[Category:Ical]]
[[Category:Ical]]
[[Category:Error Messages from Channels]]
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
[[Category:Troubleshooting]]
  ''Importing Bookings or Blocking dates using an external iCal or google calendar''
<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 api message field of the booking.
*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 ==
*Enter the calendar URL you want to import.
'''Step 1:  Enter the calendar URL you want to import'''
*Select whether the calendar specifies the end of the booking by last night or check-out date.
 
 
'''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.


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


== Ignore Duplicates ==
 
Bookings will be ignored if there is a booking from another channel with the same dates which is not  cancelled.
'''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 can be used in the iCal. If present they are imported into the relevant booking field.
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>
X-PHONE: 12345678


== Notes ==
== Notes ==
Line 59: Line 75:
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.
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 '''skip 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 skip 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.
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.
See the instructions for ical export -> "Data Options" to prevent re-exporting bookings which have been imported by the iCal import channel.