API - Shop Service - getPropertyOffers and getPropertyOffer Cancel Policy Enhancements

getPropertyOffers and getPropertyOffer are enhanced to support OPERA Cloud tiered cancellation policies, Grace Period Duration, and the Grace Period Advanced Booking Window.


EXAMPLES

Grace period in the SHOP Offer/s response

    {
        "policy": {
            "policyCode": "GRACE",
            "deadline": {
                "absoluteDeadline": "2025-12-10T04:26:29.701+08:00",
                "offsetFromBookingDate": 1
            },
            "amountPercent": {
                "amount": 0,
                "basisType": "FlatAmount",
                "taxInclusive": false,
                "currencyCode": "USD"
            },
            "penaltyDescription": "Cancel latest by 2025-12-10 04:26 without penalty"
        }
    }


Tiered cancel policies in the SHOP Offer/s response

"cancellationPolicies": [
    {
        "policy": {
            "policyCode": "GRACE",
            "deadline": {
                "absoluteDeadline": "2025-12-10T04:26:29.701+08:00",
                "offsetFromBookingDate": 1
            },
            "amountPercent": {
                "amount": 0,
                "basisType": "FlatAmount",
                "taxInclusive": false,
                "currencyCode": "USD"
            },
            "penaltyDescription": "Cancel latest by 2025-12-10 04:26 to avoid penalty of 0 USD."
        }
    },
    {
        "revenueType": "Rooms",
        "policy": {
            "policyCode": "15DAYS",
            "deadline": {
                "absoluteDeadline": "2025-12-05T18:00:00.000+08:00",
                "offsetFromArrival": 15,
                "offsetFromBookingDate": -3
            },
            "amountPercent": {
                "amount": 50,
                "basisType": "FlatAmount",
                "taxInclusive": false,
                "currencyCode": "USD"
            },
            "penaltyDescription": "Cancel latest by 2025-12-05 18:00 to avoid penalty of 50.00 USD."
        }
    },
    {
        "revenueType": "Rooms",
        "policy": {
            "policyCode": "7DAYS",
            "deadline": {
                "absoluteDeadline": "2025-12-13T18:00:00.000+08:00",
                "offsetFromArrival": 7,
                "offsetFromBookingDate": 5
            },
            "amountPercent": {
                "percent": 50,
                "amount": 0,
                "basisType": "Percentage",
                "taxInclusive": false,
                "currencyCode": "USD"
            },
            "penaltyDescription": "Cancel latest by 2025-12-13 18:00 to avoid penalty of 0.00 USD."
        }
    }
],


IMPACT OR OTHER CONSIDERATIONS

SHOP Channels may receive multiple cancellation policies when applicable. If a channel cannot support multiple cancellation policies, properties should not configure tiered cancellation policies or grace-period settings for that channel’s rates.


STEPS TO ENABLE

  • Enable OPERA Cloud Control Tiered Cancel Penalty Schedules to utilize the tiered cancellation penalty feature.
  • Configure OPERA Cloud Control Grace Period Duration to allow cancellations without penalty within the defined grace period.