Vacation Rental Management for busy people!

How do I get my availability in iCal format?

If you'd like to  get access to your availability calendar in other systems that support the standard iCal format (such as Google and Microsoft Outlook) then you can provide a unique URL link to myvrzone that will update those calendars automatically.

This provides a one-way link where you can see the availability on, say, your personal calendar or mobile device or add it to another listing site that can take that as an input (AirBnB for example).

A second type of link is provided that shows Availability per day (rather than what's booked) aimed at those with multiple properties so that they can look at a day and know instantly if they have availability in any property and how many days there are either side.

From this point onwards it is assumed that you really know what you are doing when it comes to the use of the ical data. See the sections at the bottom of this page for help setting up Google and MS Outlook calendars.

What is the URL I need to use?

You can see the links needed for your own properties when logged in on the Setup>Main >> Advertisers+Synchronizations tab in the section called "Useful URLs". These show the public and private links that you'd need.

For these that are interested or want to use the Availability link, this is the general form of the URL:

http://www.myvrzone.com/Services/ICAL/?t=TYPE&cid=UID-PID&token=TOKEN&ext=EXT

where:

Parameter Description and Examples
cid

Your system User ID (UID) [REQUIRED] and Property ID (PID) [OPTIONAL]

General format: cid=UID-PID

Eg. cid=2
User ID of 5 and all properties

Eg. cid=2-3
User ID of 2 and a Property ID of 3

Find: the UID in the top area of the screen, next to your name, when logged in.

Find: the PID either:
1/ On the Properties page of the VR Hub, to the right of the property name in gray, or
2/ On the Setup>Main >> Property Tab to the right of the Property select box inside the square brackets as [PID#]

If PID is set to "0" then all properties will be included in the output.

This is ignored if the Display Type (t) is set to "a".

t

Display type - show reservations or availability per day

Eg. Leave this blank for reservations [DEFAULT]

Eg. t=a

Show availability.  You must also set the token parameter for "a" to work - if you don't then you'll just see the reservations.
token

Your account token

Eg. token=701PDBQCZV8xX1

If provided, and correct, then more information about the reservation is provided - all reservations from 2 months ago onwards are shown along with the Guest name, contact info and the reservation notes.

If not provided then only the reservations that block dates included, showing the property name and status.

This must be set if you set the type to "a".

NOTE: Don't use the token if others are going to see the calendar - the token is private and is for owners eyes only.

Find: your account token here.

ext

Set an extension

Sets an extension on the url - no changes to the content.

If the place you use the URL expects a file, they may look for a file extension and then fail if they don't find what they expect. This argument allows you to overcome this by adding any extension that you want.

Eg. ext=.ics

This MUST be the last argument.

setc

Sets Confirmed reservations status (overriding any account settings)

Eg. setc=1
Sets Confirmed reservations to be ignored

Eg. setc=2
Sets Confirmed reservations to be Confirmed

setp

Sets Pending reservations status (overriding any account settings)

Eg. setp=1
Sets Pending reservations to be ignored

Eg. setp=2
Sets Pending reservations to be Confirmed

sett

Sets Tentative reservations status (overriding any account settings)

Eg. sett=1
Sets Tentative reservations to be ignored

Eg. sett=2
Sets Tentative reservations to be Confirmed

Calendar Merging

See this page for how to merge multiple calendar availabilities together

 

Examples

In addition to the predefined URLs on the setup page, here are more examples.

Note that if you put the http links below into your browser then you will just see a bunch of raw data - it is not designed to be human readable. If you are using an application that reads the ical format then give it one of these links to see what it really looks like.

If you already use Google or Outlook then you can quickly see what they look like by following the guidelines at the bottom of this page.

These examples are for a demo account with UID=2 and TOKEN=0701PDBQCZV8xX1.

For public viewing of one property with PID=1:

http://www.myvrzone.com/Services/ICAL/?cid=2-1

http://www.myvrzone.com/Services/ICAL/?cid=2-1&ext=.ics

For public viewing of all properties:

http://www.myvrzone.com/Services/ICAL/?cid=2-0

For private viewing of one property with PID=2:

http://www.myvrzone.com/Services/ICAL/?cid=2-2&token=0701PDBQCZV8xX1

For private viewing of all properties:

http://www.myvrzone.com/Services/ICAL/?cid=2-0&token=0701PDBQCZV8xX1

Viewing Availability per day (for those with multiple properties)

http://www.myvrzone.com/Services/ICAL/?t=a&cid=2-0&token=0701PDBQCZV8xX1

Each entry shows the number of properties available in the title and then inside gives a list of the properties that are available, along with the number of days before and after the current day that are available.

You should be able to look at a day and know if you have availability by looking at the info inside.

NOTE that days with no availability do not have an entry. However, after the latest reservation  of all properties, no more entries will be created in the calendar. So if you look far enough ahead, it may look like there's no availability - but it's just because the date is after the latest reservation.

Creating a Google Calendar (gcal)

Please click here for directions on creating a Google Calendar showing your reservations.

Real Example: My Vacation Rentals - Public view

Creating an Outlook Calendar

Please click here for directions on creating a Outlook Calendar showing your reservations.

Caveats

The timezone set for your property is used (confgured as an offset in hours) so be sure that this is set correctly. If no timezone offset is defined, then GMT is assumed.