May 2024 ReadMe

Overview

This document contains a list of upcoming major changes to Oracle Hospitality APIs.

What will Change	Details of the Change	Target Product and Version	Impact	Call to Action
Event resources will enforce a minimum of zero attendees.	The following operations will enforce a minimum of zero attendees: postEvents getEvent changeEvents changeEventsResourcesByChain getEventsResources changeEventsResources getEventResourceByMenu changeEventResourceByMenu getEventItemSplitQuantity getCateringPackages changeCateringPackages getWaitlistedEvents manageWaitlistedEvents In the following properties: Expected, Guaranteed, Billed, Actual, Set, Package Expected, Package Guaranteed, Package Billed and Package Actual Attendees.	Oracle Hospitality OPERA Cloud 24.3	If a negative number of attendees is supplied, the call will fail with a 400 HTTP status error response.	Ensure that a positive number of attendees is supplied to these operations.
Enhancing error response bodies.	The error response body will be enhanced in the following operations. Note that the HTTP response codes are not changing. Module OperationId blk getblock blk getblockavailability blk getblocks crm getProfile crm postProfile crm putProfile csh applyfinalpostings csh generatefolio csh getccsurchargeinfo csh getdepositfolio csh getfoliotypename csh postcheckout ent gethotel fof getroomkeyinterfacedetails fof getroomkeys int getbusinessevents int getbusinesseventsbyExternalSystem inv gethotelinventory inv getinventorystatistics inv getrevenueinventorystatistics inv getrevenueinventorystatisticsprocessstatus inv startrevenueinventorystatisticsprocess lov getlistofvalues lov getnotetypeslov lov getpaymentmethodslov lov getreservationpackageslov lov validatelistofvalues rsv gethotelreservations rsv getrateinfo rsv getreservation rsv getreservationActivityLog rsv getReservationProcessStatus rsv getreservations rsv getreservationsdailysummary rsv postcancelreservationByExtId rsv putreservation rsv startreservationsdailysummaryprocess rtp getRatePlan rtp getRatePlanSchedules	Oracle Hospitality OPERA Cloud 24.4	If the body of error responses is parsed, this could result in failures or miscounts.	Alter integrations that branch based upon the error response body to be built on the HTTP response code. Utilize the enhanced error response bodies to guide development work.
Promotion of Oracle Hospitality Distribution v0 APIs to v1. Deprecation of v0 Oracle Hospitality Distribution APIs.	Oracle Hospitality Distribution APIs are currently available only as /v0. All operations will now be v1 with v0 APIs deprecated in 12 months’ time. All v0 APIs will be removed.	Oracle Hospitality Integration Platform 24.2	When the v0 Oracle Hospitality Distribution APIs are removed, calls with /v0 in the URL will fail.	Change /v0 to /v1 in the URI of every API call to an Oracle Hospitality Distribution API.