2 Feature Summary
Column Definitions
| SMALL SCALE: These UI or process-based features are typically comprised of minor field, validation, or program changes. Therefore, the potential impact to users is minimal. |
| LARGER SCALE: These UI or process-based features have more complex designs. Therefore, the potential impact to users is higher. |
| CUSTOMER ACTION REQUIRED: You must take action before these features can be used. These features are delivered disabled, and you choose if and when to enable them. |
| FEATURE |
|
STEPS TO ENABLE |
|---|---|---|
| DISTRIBUTION CHANNELS | ||
| API - Reservation Services Support Additional Elements | SMALL | |
| API - Shop Service - Separate Total Tax and Surcharge | SMALL | Yes |
| API - Shop Service - Tiered Deposit Policy Schedules | SMALL | Yes |
DISTRIBUTION CHANNELS
API - Reservation Services Support Additional Elements
API - Reservation Services postReservationNotif, putReservationNotif, getReservationNotif, postReservation,putReservation, getReservation
Distribution Reservation Notification and Distribution Book operations are enhanced to return totalTax and totalFees (such as resort/destination fees) as separate elements in the response. The response also includes a new codeType element within the tax breakdown to indicate whether each charge is a tax or a fee. Prior to this change, the response aggregated taxes and fees in total amount and returned only a combined total, limiting accurate representation of financial line items.
"total": {
"amountBeforeTax": 219.00,
"amountAfterTax": 267.79,
"currencyCode": "USD",
"taxes": {
"tax": [
{
"description": "City tax",
"code": "3",
"amount": 10.13,
"currencyCode": "USD",
"codeType": "Tax"
},
{
"description": "State tax",
"code": "15",
"amount": 10.16,
"currencyCode": "USD",
"codeType": "Tax"
},
{
"description": "County tax",
"code": "4",
"amount": 3.50,
"currencyCode": "USD",
"codeType": "Tax"
},
{
"description": "Resort fee",
"code": "12",
"amount": 25.00,
"currencyCode": "USD",
"codeType": "Fee"
}
],
"totalTax": 23.79,
"totalFees": 25.00,
"amount": 48.79,
"currencyCode": "USD",
"hotelTaxFeeDescriptions": [
{
"description": "4.15% City & County Tax"
},
{
"description": "4% State & RTD Tax"
},
{
"description": "1.6% Lodging Tax"
},
{
"description": "$25 Destination Charge"
},
{
"description": "4.15% City & County Tax"
},
{
"description": "4% State & RTD Tax"
},
{
"description": "1.6% Lodging Tax"
}
]
}
}
API - Shop Service - Separate Total Tax and Surcharge
The SHOP operations are enhanced to return totalTax and totalFees (such as resort/destination fees) as separate elements in the response. The getPropertyOffers and getPropertyOffer responses also include a new codeType element within the tax breakdown to indicate whether each charge is a tax or a fee. Prior to this change, SHOP aggregated taxes and fees in total.amount and returned only a combined total, limiting accurate representation of financial line items.
codeType, totalTax, and totalFees in getpropertyOffers, getPropertyOffer, and getPropertyAddons response:
"total": {
"amountBeforeTax": 280.00,
"amountAfterTax": 422.00,
"currencyCode": "USD",
"taxes": {
"tax": [
{
"description": "City tax",
"code": "3",
"amount": 14.00,
"currencyCode": "USD",
"codeType": "Tax"
},
{
"description": "Resort fee",
"code": "12",
"amount": 100.00,
"currencyCode": "USD",
"codeType": "Fee"
},
{
"description": "Total tax",
"code": "17",
"amount": 28.00,
"currencyCode": "USD",
"codeType": "Tax"
}
],
"amount": 142.00,
"currencyCode": "USD",
"totalTax": 42.00,
"totalFees": 100.00,
"hotelTaxFeeDescriptions": [
{
"description": "City Tax"
},
{
"description": " 25 Dollars resort fee"
},
{
"description": "Tax 4778"
}
]
}
}
Only totalTax and totalFees are in getPropertyAltenateOffers and getPropertyCalendar response:
"total": {
"amountBeforeTax": 280.00,
"amountAfterTax": 672.00,
"currencyCode": "USD",
"totalTax": 42.00,
"totalFees": 350.00
}
STEPS TO ENABLE
Channel partners intending to leverage these new fields need to update their integration mapping.
API - Shop Service - Tiered Deposit Policy Schedules
getPropertyOffers and getPropertyOffer are enhanced to support the OPERA Cloud tiered deposit policies feature.
Tiered Deposit policies in the SHOP Offer/s response:
"depositPolicies": [
{
"revenueType": "Rooms",
"policy": {
"policyCode": "FLAT60",
"deadline": {
"offsetUnitMultiplier": 1,
"offsetTimeUnit": "Day",
"offsetDropTime": "AfterBooking",
"absoluteDeadline": "2026-02-28T23:36:14.409+08:00"
},
"basisType": "FlatAmount",
"amount": 60.00,
"taxInclusive": false,
"nonRefundable": false
},
"description": "A Deposit of 60.00 USD by 2026-02-28 is required.",
"paymentTypes": []
},
{
"revenueType": "Rooms",
"policy": {
"policyCode": "FLATDEPO",
"deadline": {
"absoluteDeadline": "2026-10-15T00:00:00.000+08:00"
},
"basisType": "FlatAmount",
"amount": 10.00,
"taxInclusive": false,
"nonRefundable": false
},
"description": "A Deposit of 10.00 USD by 2026-10-15 is required.",
"paymentTypes": []
}
]
IMPACT OR OTHER CONSIDERATIONS
SHOP Channels receive multiple deposit policies when applicable. If a channel cannot support multiple deposit policies, you should avoid configuring tiered deposit policies for that channel’s rates.
STEPS TO ENABLE
Enable OPERA Control Tiered Deposit Rule Schedules to utilize the tiered deposit policy feature.