Existing Owners' Page

Information, hints and tips for existing owners on the Kalkan Secrets website

 

Existing owners can login to update their calendars here: OWNER LOGIN

(If you have lost or forgotten your login details, please email us for a reminder).

 

Existing owners can enter their 2019 rates here: 2019 RATES

Existing owners can upload new photos and/or new details hereUPLOAD NEW PHOTOS/DETAILS

 

An explanation of iCal and syncing your other calendars with Kalkan Secrets

What is iCal?

iCalendar, often referred to as iCal, is a standard internet calendar format that enables users to create and share electronic calendars across different computers and different programs. Originally conceived as an interchange for personal calendars such as Apple's iCal, Mozilla Sunbird, Google Calendar, Yahoo! calendar and Microsoft Outlook, the standard is also used by some rental Listing sites to enable remote updating.

How the Kalkan Secrets calendar interacts with other sites

The KS calendar can either EXPORT to various listing sites in order to update their calendars to reflect bookings that have been recorded in KS, or KS can IMPORT booked dates that may have been recorded in any other 3rd party websites, and then your KS database is updated to reflect these external bookings. Whether it's importing or exporting, the iCal synchronisation process is a delayed process, and not instantaneous. KS calendar will run its export every hour on the hour, and will import every hour on the half hour. Each 3rd party site will have its own schedule.

Export

The most common form of synchronisation is KS Export. The system writes a special file (.ics) and publishes it in a public area on the KS server. The importing site (your listing site) needs to be told the precise URL of that .ics file. This URL is unique for your property, we can generate it for you on request and email it to you. You will need to copy/paste the URL for your property into each of your listing sites that require it.

The system will normally only export confirmed bookings and not provisional bookings or open enquiries. However, with the expansion of instant bookings at the various listing sites, you may want to select this option to block out your calendars at the listing sites as soon as you get an enquiry from other sources.

NB: This will only help to minimise unexpected instant bookings as there is a delay of between 1 hour and 1 day depending on the listing site between taking the booking in KS and the listing site updating itself.

Import

Where a booking may be initiated on a remote site AND where that remote site can itself export iCal files, then KS can read (import) iCal files and update the KS database.
The process for importing is similar to exporting, but of course, in reverse. 

Important notes for importing:

  • A typical iCal record only contains 3 items:- Start date, End date and Booking name, So KS has to make a number of assumptions when importing each record.
  • Each record is assumed to be a Confirmed booking
  • If the start and end dates do not conflict with any existing bookings, then we import the new record and mark it in KS system as an iCal import.
  • If the start and end dates EXACTLY match an existing booking in KS, then we assume its simply a repeat of a previously included booking, and we just ignore it.
  • If the dates on the imported record overlap in any other way, then we record this as an ERROR
  • If any ERRORS are noted, then an email is sent. No email is sent when normal imports are completed or when there is nothing to import.

Holiday/Vacation Rental Listing Sites

Here is a partial list of some Listing sites that support iCal import. This is not an exhaustive list. More are appearing all the time, and just because its not on the list here, does not mean that it will not work with the KS iCal export. Please check the documentation at your chosen listing site for information on how to import the KS iCal .ics file. The KS file will be the same for all Listing sites.

Airbnb
FlipKey
France-Voyage
HolidayLettings
HomeAway and all its subsidiaries
CountryCottagesOnline
IndependentCottages
Last Minute Cottages
letaway.com
OwnerHolidays
TripAdvisor
Wimdu
voya.ge
theholidaylet.com
+ Others being added all the time

And, of course, for Google Calendar or Outlook

So:

To IMPORT an external iCal calendar into your KS calendar, all you need to do is email us the .ics file code you get from your sourcing calendar.

If you want to EXPORT your KS calendar, just ask us for the .ics file code and we will generate it for you.

We can do this for you (either way round) but we would need your login details for your external sites in order to do so.