The cancellation policy is built using "Frames". Every frame represents a period of time, and has has a "type" parameter, which states the terms of cancellation within that time frame. The first frame begins on the booking date, and ends on the date specified in the endTime parameter. The next frame begins on the previous frame's endTime, and so on. The type parameter possible values are: "fully-refundable", "partial", "non-refundable" or "according-to-terms". For Example: <cancellation> <frame endTime="2017-09-14 00:00:00" timezone="UTC" type="fully-refundable"></frame> <frame endTime="2017-09-18 00:00:00" timezone="UTC" type="partial"> <cost amount="1117" currency="USD"></cost> <remarks><![CDATA[text text text]]></remarks> </frame></cancellation>In the case above, the cancellation is free until 23:59:59 UTC, September 13th, 2017. From 00:00:00 UTC, September 14th and until 23:59:59 UTC on September 17th the cancellation penalty will be 1117 USD. Note that cancellation is not permitted after the check-in date. If the booking is non-refundable, there will not be a "fully-refundable" frame type, and once the booking is made, some fee will be charged in case of cancellation. In case the booking is 100% non refundable, the frame type will be "non-refundable". For Example: <cancellation> <frame endTime="2017-10-05 00:00:00" timezone="UTC" type="partial"> <cost amount="423" currency="USD"></cost> <remarks><![CDATA[text text text]]></remarks> </frame> <frame endTime="2017-10-08 00:00:00" timezone="UTC" type="non-refundable"/></cancellation>In the case above, until 23:59:59 UTC, October 4th, 2017 the cancellation penalty will be 423 USD. From 00:00:00 UTC, October 5th the booking is non-refundable. In some cases, the frame type will be "according-to-terms". This means that we cannot parse the cancellation policy, or that we cannot give a specific date and penalty. In this case you can choose either to treat it as non-refundable or just show the terms to the user. |
Mishor 4 Documentation > 6. Lookups >