Vacation Rental Management for busy people!

Merging Availability from Multiple Calendars

If you have multiple properties and would like a calendar that shows net availability from more than one of them then this is for you.

What does it do?

The system can take the availability from more than one of your MyVRZone properties and create a new merged availability for another "virtual" MyVRZone property. You can do this for as many virtual properties as you like.

There are 2 merge types:

  • Available
    If any of the properties have availability then that day will be shown as available.
    Use this when you only want days to show as blocked if ALL of the properties are blocked.
  • Blocked
    If any of the properties are booked then that day will be shown as booked.
    Use this when you want days to show as blocked if ANY of the properties are blocked.

How do I set this up?

  1. You must have a property set up that you can use as the virtual property in your MyVRZone/VRSync account
    You may need to create another one - do that quickly in the VR Hub.
    All properties involved must have active VRSync subscriptions.
    The merge will only work when the URL is used within VRSync, set up in the VR Hub. It will NOT work if you use it anywhere else.
  2. Create the required ical URL that will perform the merge that you require
    Directions and examples are given below.
  3. Add that ical URL to the VRSync ical list for that virtual property
    See this help on how to add an ical url.
    The merge will NOT work if you use the URL anywhere else.
  4. Run a manual sync for that virtual property to check that it's working
    See this help on how to run a manual sync.
  5. Review the day-by-day availability for the virtual property when you look at its calendar
    See this help on how to view your calendar here.

Note: The merged calendar will have separate reservations for each day that is blocked. It is not anticipated that these reservations will be used for any purpose other than settiing availability.

How do I create the ical URL that does the merge?

There are additional parameters to the normal ical setup shown here. This is the general form of the ical URL:

http://www.myvrzone.com/Services/ICAL/?cid=UID&mergelist=LIST&mergetype=TYPE

where:

Parameter Description and Examples
cid

Your system User ID (UID) [REQUIRED]

Eg: cid=2
This example shows User ID 5 - yours will be different

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

mergelist

List of properties to merge [REQUIRED]

This requires a colon-separated list of the Property IDs that should be merged

Eg. mergelist=1:2
T
his will merge properties with PIDs 1 and 2

Eg. mergelist=1:3:4
This will merge properties with PIDs 1, 3 and 4

If less than two properties are listed then no merge will be performed.

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#]

mergetype

Type of merge to perform

Eg. mergetype=available
If any days are available then the merged day will be shown as available.
Reservation status is considered here, and the lowest blocked status from all of the properties will be used in this order: available (no reservaion), Tentative, Pending, Confirmed, Unavailable.

Eg. mergetype=blocked
If any days are blocked then the merged day will be shown as blocked.
Reservation status is considered here, and the highest blocked status from all of the properties will be be used in this order: Unavailable, Confirmed, Pending, Tentative - otherwise it will be shown as Available.

NOTE: If the parameter is not specified then type=available is assumed

OTHER

Other ical parameters shown at this link are also available but these are ignored when merging:

  • Token (token=)
  • Display Type (t=)

 

Full examples

Here are some full URL examples as reference for a user with User ID = 2.

REMEMBER: These URLs do not produce human-readable pages - it's just data for other computers to read.

Example 1

Goal: Merge properties with PID's 1 and 2 so that if any one has availability then show as available

http://www.myvrzone.com/Services/ICAL/?cid=2&mergelist=1:2&mergetype=available

Example 2

Goal: Merge properties with PID's 3 and 5 so that if any one is booked then show as booked

http://www.myvrzone.com/Services/ICAL/?cid=2&mergelist=3:5&mergetype=blocked

Example 3

Goal: Same as Example 2 but treat Pending reservations as unbooked (using the setp ical parameter)

http://www.myvrzone.com/Services/ICAL/?cid=2&mergelist=3:5&mergetype=blocked&setp=1

NOTE that the "setp" parameter overrides any other display settings that you may have set in your account