Knowledgebase
How to check availability for new seasons / Season Change
Posted by Axel Girgensohn on 25 March 2014 01:05 PM
  1. Check with [https://safe.novasol.com/api/seasons] which product countries are open for sale for which season.
  2. Check following parameters on product data:
    1. lastRentalDate – This is the date until when a property can be rented (last possible departure date). After that date the property is no longer available through NOVASOL. Once the date is expired the property is removed from the product file (batch).
    2. lastAvailabilityDate – This is the date until when a property can be rented (last possible departure date). As soon as the property is ready for the new season we will remove the date. Example:

i. < lastAvailabilityDate >=NULL this property can be booked.

ii. < lastAvailabilityDate >20130112</ lastAvailabilityDate > The last permissible date of stay for this property is January 12th 2013.

  1. If 1 and 2b are valid download availability data for 3 years (current, next and following) to get all possible rental periods.
    1. Call 1 current season: [https://safe.novasol.com/api/batch? &company=nov&season=2014&sections=availability]
    2. Call 2 next season: [https://safe.novasol.com/api/batch? &company=nov&season=2015&sections=availability]
    3. Call 3 following season: [https://safe.novasol.com/api/batch? &company=nov&season=2016&sections=availability]

NOTE:

NOVASOLs availability calendar runs from January 1st until December 31st, but the season runs from second Saturday of a year to the second Saturday of the next year (some product countries first Saturday to first Saturday).

As soon as we open a new season you need to request the calendar data for 3 years (current year, next year and the following year) to get the full availability for 2 seasons.

Data Example for available houses in Season 2014:

Season Request:

<openSeasons>

    <company name="NOV">

        <country iso="008">

            <season>

                <name>2014</name>

                <startDate>20140111</startDate>

                <endDate>20150110</endDate>

            </season>

        </country>

            …

Product Data Availability section

2014 Season: Start January 11th 2014 End January 10th 2015

            <lastAvailabilityDate>=NULL

2015 Season: Start January 10th 2015 End January 9th 2016

            <lastAvailabilityDate>20150110</lastAvailabilityDate>

Data Example for available houses in Season 2015 where current year is 2014:

Season Request:

<openSeasons>

    <company name="NOV">

        <country iso="008">

            <season>

                <name>2014</name>

                <startDate>20140111</startDate>

                <endDate>20150110</endDate>

            </season>

            <season>

                <name>2015</name>

                <startDate>20150110</startDate>

                <endDate>20160114</endDate>

            </season>

        </country>

            …

Product Data Availability section

2014 Season: Start January 11th 2014 End January 10th 2015

            <lastAvailabilityDate>=NULL

2015 Season: Start January 10th 2015 End January 9th 2016

            <lastAvailabilityDate>=NULL

2016 Season: Start January 9th 2016 End January 14th 2017

            <lastAvailabilityDate>20160114</lastAvailabilityDate>

(0 vote(s))
Helpful
Not helpful