Added property specs for release 24.2.0.0

[OHIPGITHUBBOT]

Updated the Property APIs to version 24.2.0.0

ACT - putActivitiesBulkUpdate Added

The Activities (ACT) API includes a new operation named putBulkActivities. This new operation allows you to update multiple activities in one request.

BLK Async - ShiftBlock Operation Added

The Block Async API includes the ShiftBlock async operation, enabling you to shift block dates for a business block with rooms inventory or events or both. If a record updates during the time the asynchronous process is running, a message informs you that the record is in use.

BLK - getBlocks Operation Updated

The getBlocks operation in the Block (BLK) API includes a new fetch instruction, IncludeSubBlocks. When a Master Block ID passes as the blockIdList parameter and this fetch instruction is included, the block summaries of the linked Sub Blocks return along with the Master Block Summary. If the Block ID of a non-master block passes only, the Block Summary matching the ID passed is returned.

BLK - postDefaultBlockCode Added

The Block (BLK) API includes a new postDefaultBlockCode operation when copying a master block. This operation retrieves the default values for block code based on the value defined in the Block Code Generation Pattern OPERA Control for the linked sub blocks that are copied as part of the copy block operation.

BLK - putBlock Operation Updated

The putBlock operation of the Block API (BLK) includes a new element called applyMoveEvents. This allows you to indicate whether catering event dates are to change when the block dates change.

CRM Async: stayRecords Operation Added

The stayRecords operation, added to the Profiles API (CRM), imports stay records for a profile. You can include reservation stay details such as booking date, arrival, departure date, rate information, room revenue, other revenue, and so on in the request body. This new operation follows the asynchronous pattern. See Oracle Hospitality Asynchronous APIs.

CRM Config: post/put/getMembershipType Operations Updated

The multipleRooms attribute in postMembershipTypes, putMembershipType, and getMembershipType operations (CRM Config API) is changed to an integer in order to support a maximum value of 999.

CRM - getCompanyProfile Operation Updated

The getCompanyProfile operation in the CRM API has a new Enum entry called Subscriptions added to the fetchInstructions query parameter. This allows you to fetch Subscriptions (External References) for the selected company profile.

CRM - getMembershipPointsExceptions and putMembershipPointsExceptions Operation Added

Loyalty The following operations are added the Customer Relationship Management (CRM) API:

• getMembershipPointsExceptions - allows you to fetch Membership Points Exceptions.
• putMembershipPointsExceptions - allows you to accept and reject the Membership Points Exceptions that were flagged as exceptions.
• Updated the size of type for the MembershipTransactionId object from 20 to 25.

CRM - getMembershipTransaction Operation Updated

Loyalty The getMembershipTransaction operation in CRM API is updated by adding the exceptionRejected attribute. This allows you to identify whether the Membership Points Exception is rejected.

FOF Outbound - postRoomKeysOutbound Operation Added

The postRoomKeysOutbound operation in the Front Office Outbound (FOF Outbound API) manages requests for Door Lock Room Keys. OPERA Cloud uses this operation when connected to external Door Lock Systems through the Outbound Systems configuration. OPERA Cloud uses this operation to request the following:

• New or additional room keys.
• To activate new keys after check in.
• A room key that is not related to a guest reservation but valid for a defined time.
• To re-encode a key where other keys for this room remain active.
• To read a key data from a room key and display it to the user in the property management system.
• To modify existing key data upon a room move or change of departure date (online key systems only).
• To remove/delete a room key from a room (usually sent with check out of a reservation).

Note
The Vendor can use specifications to implement the API.
The Multiple Guest Room Key OPERA Cloud function must be inactive.
The postRoomKeysOutbound operation replaces the existing postExternalRoomKeys operation.

FOF - postRoomKeysExternal Operation Added

A postRoomKeysExternal operation added to the Front Office (FOF) API allows you to manage requests for Door Lock Room Keys. The external system sends the operation through OHIP (Oracle Hospitality Integration Platform) to OPERA Cloud to request room keys and then sends out from OPERA Cloud to the outbound service. The API works only with DLS systems integrating through the postRoomKeysOutbound API.
OPERA Cloud uses the following operations:

• New or additional room keys.
• To activate new keys after check-in.
• A room key that is not related to a guest reservation but valid for a defined time.
• To re-encode a key where other keys for this room remain active.
• To read a key's data from a room key and display it to the user in the property management system.
• To modify existing key data upon room move or change of departure date (online key systems only).
• To remove/delete a room key from a room (usually sent with check out of a reservation).

Note
The Multiple Guest Room Key OPERA Cloud function to be Off.

HSK - getHousekeepingDailyInfo and setHousekeepingDailyInfo Added

New getHousekeepingDailyInfo and setHousekeepingDailyInfo operations are added in the Housekeeping (HSK) API. The fetch operation retrieves the daily Cleaning Time and Room Instruction details during the reservation stay dates. The put operation allows for the Cleaning Time and Room Instruction details to be set on a daily basis.

New Operations Added in Leisure Management (LMS) API

Four operations are added to the Leisure Management (LMS) API, enabling you to manage Leisure Activities directly on the profile in OPERA Cloud. These Activities are sent from an external application to OPERA Cloud for bookings such as spa or golf activities, advising a property that the guest has active Activity Bookings.
Operations Added:

• postActivityBookingsonProfile - enables you to create an activity booking on a guest profile.
• putActivityBookingsonProfile - enables modification of activity bookings on a guest profile.
• deleteActivityBookingsonProfile - enables you to cancel an activity booking associated to a guest profile.

RSV - getPreConfiguredRoutingInstructions API Updated

You can use the optional query parameter reservationId with the getPreConfiguredRoutingInstructions operation in the Reservation (RSV) API to retrieve default routing instructions for all associated profiles (Company, Travel Agent, Source, Group, Contact) attached to a reservation. When this query parameter is used, the response includes the profileId for each of the associated profiles with configured default routing instructions. When the Profiles Per Day OPERA Control is active, you can see the specific dates that the associated profile(s) with configured default routing instructions are attached to the reservation by referring to the beginDate and EndDate elements respectively for each associated profile included in the response.

RSV - postCombineShareReservations Operation Updated

The postCombineShareReservations operation in the Reservation (RSV) API is updated, allowing you to define a Rate Distribution for share reservations. The dailyRates element is added to the combineShareFromExistingReservationType element. The dailyRates type holds the daily rate information for the joining reservation, enabling the custom split distribution to work.