Documentation

Cancellations policies

In order to see the cancellations policies, you need to check the “cancellationPolicies” array and can also read the “RateClass” value.

For Example:

rates": [{
    "rateClass": "NOR",
    "rateDetails": [{
            "operationDates": [{
            "from": "2019-10-11",
            "to": "2019-10-11",
            "cancellationPolicies": [{
                "dateFrom": "2019-10-09T00:00:00.000Z",
                "amount": 553.72
              }

The “cancellationPolicies” will determine when the “amount” will be charged if cancel the booking.

For example, placing the booking on “2019-10-11”, if you cancel after "dateFrom" “2019-10-09T00:00:00” (always destination time zone) the “amount” will be charged. If canceled before the "dateFrom" date, there will not be charges.

You can also consider the “rateClass” value, in case of “NRF” it’s always NON refundable (so at the moment of confirmation there will be charges for cancellation), if “rateClass” value is “NOR” you need to read the “cancellationPolicies” array in order to determine when they will be applied.

In some cases you’ll found “rateClass” value “NOR” and there will not be “cancellationPolicies” array or will be null, for those cases you can cancel until the last moment without charges.

Please also consider that some “cancellationPolicies” will have different amount range depending on cancellations time, for example:

{
  "from": "2019-10-20",
  "to": "2019-10-20",
  "cancellationPolicies": [{
      "dateFrom": "2019-10-18T00:00:00.000Z",
      "amount": 51.15
    }, {
      "dateFrom": "2019-10-19T00:00:00.000Z",
      "amount": 102.3
    }
  ]
}

If cancel:

-Before 2019-10-18T00:00: No cancellations charges.

-After 2019-10-18T00:00: 51.15 will be charged.

-After 2019-10-19T00:00: 102.3 will be charged

See where the cancellations are returned in the API:

*Availability request:

-RateClass: AvailabilityRS.activities[X].modalities[X].rates[X].rateClass.

-Cancellation Policies array: AvailabilityRS.activities[X].modalities[X].rates[X].rateDetails[X].operationDates[X].cancellationPolicies[]

*Details request:

-RateClass: DetailRS.activity.modalities[X].rates[X].rateClass.

-Cancellation Policies DetailRS.activity.modalities[X].rates[X].rateDetails[X].operationDates[X].cancellationPolicies

*ConfirmRS (no rateClass present):

-Cancellation Policies Array: ConfirmRS.booking.activities[X].cancellationPolicies[].