{"items":[{"operation_id":"changeGuaranteeCode","method":"PUT","path":"/api/v1/config/reservations/guarantee-codes/{code}","summary":"担保类型 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"changeGuaranteeCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_guaranteeCodeToBeChanged"},{"properties":{"hotelId":{"description":"Must equal the server-configured hotel.","type":"string"}},"required":["hotelId"],"type":"object"},{"properties":{"guaranteeCode":{"type":"object"}},"required":["guaranteeCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"担保类型 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/guaranteeCodes/{guaranteeCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"changeMarketCode","method":"PUT","path":"/api/v1/config/reservations/market-codes/{code}","summary":"市场代码 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":["forceOverride"],"contract":{"operationId":"changeMarketCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"explode":true,"in":"query","name":"forceOverride","required":false,"schema":{"type":"boolean"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_marketCodeToBeChanged"},{"properties":{"marketCode":{"type":"object"}},"required":["marketCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场代码 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketCodes/{marketcode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"changeMarketGroup","method":"PUT","path":"/api/v1/config/reservations/market-groups/{code}","summary":"市场分组 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"changeMarketGroup","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_marketGroupToBeChanged"},{"properties":{"marketGroup":{"type":"object"}},"required":["marketGroup"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场分组 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketGroups/{marketGroupCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"changeSourceCode","method":"PUT","path":"/api/v1/config/reservations/source-codes/{code}","summary":"来源代码 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"changeSourceCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_sourceCodeToBeChanged"},{"properties":{"sourceCode":{"type":"object"}},"required":["sourceCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源代码 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceCodes/{sourceCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"changeSourceGroup","method":"PUT","path":"/api/v1/config/reservations/source-groups/{code}","summary":"来源分组 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"changeSourceGroup","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_sourceGroupToBeChanged"},{"properties":{"sourceGroup":{"type":"object"}},"required":["sourceGroup"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源分组 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceGroups/{sourceGroupCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"deleteBlockCancellationReasons","method":"DELETE","path":"/api/v1/config/blocks/block-cancellation-reasons/{code}","summary":"团队房取消原因 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBlockCancellationReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房取消原因 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockCancellationReasons/{blockCancellationReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteBlockLostBookingCodes","method":"DELETE","path":"/api/v1/config/blocks/block-lost-booking-codes/{code}","summary":"团队房流失原因 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBlockLostBookingCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房流失原因 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockLostBookingCodes/{blockLostBookingCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteBlockRateOverrideReasons","method":"DELETE","path":"/api/v1/config/blocks/block-rate-override-reasons/{code}","summary":"团队房房价覆盖原因 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBlockRateOverrideReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房房价覆盖原因 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRateOverrideReasons/{blockRateOverrideReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteBlockRefusedReasons","method":"DELETE","path":"/api/v1/config/blocks/block-refused-reasons/{code}","summary":"团队房拒绝原因 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBlockRefusedReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房拒绝原因 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRefusedReasons/{blockRefusedReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteBlockStatusCode","method":"DELETE","path":"/api/v1/config/blocks/block-status-codes/{code}","summary":"团队房状态 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBlockStatusCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockStatusCodes/{blockStatusCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteBookingTypes","method":"DELETE","path":"/api/v1/config/reservations/booking-types/{code}","summary":"预订类型 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteBookingTypes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订类型 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/bookingTypes/{bookingTypesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"deleteCancellationCodes","method":"DELETE","path":"/api/v1/config/reservations/cancellation-codes/{code}","summary":"预订取消原因 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteCancellationCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订取消原因 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/cancellationCodes/{cancellationCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"deleteDestinationCodes","method":"DELETE","path":"/api/v1/config/blocks/destination-codes/{code}","summary":"目的地代码 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteDestinationCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"目的地代码 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/destinationCodes/{destinationCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteGuaranteeCode","method":"DELETE","path":"/api/v1/config/reservations/guarantee-codes/{code}","summary":"担保类型 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteGuaranteeCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"担保类型 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/guaranteeCodes/{guaranteeCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"deleteReservationMethods","method":"DELETE","path":"/api/v1/config/blocks/reservation-methods/{code}","summary":"团队房预订方式 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteReservationMethods","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房预订方式 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/reservationMethods/{reservationMethodsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"deleteRoomClass","method":"DELETE","path":"/api/v1/config/rooms/room-classes/{code}","summary":"房型分类 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteRoomClass","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型分类 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomClasses/{roomClassId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"deleteRoomTypes","method":"DELETE","path":"/api/v1/config/rooms/room-types/{code}","summary":"房型 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"deleteRoomTypes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomTypes/{roomTypeId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"getARAgingCycles","method":"GET","path":"/api/v1/finance/ar/aging-cycles","summary":"Get AR aging cycles","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"getARAgingCycles","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get AR aging cycles","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getARStatements","method":"GET","path":"/api/v1/finance/ar/statements","summary":"Search AR statements","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["profileId","profileIdContext","profileType","accountNo","accountName","closeDate","fiscalBillNo","folioDate","folioNo","folioStatus","folioTypeName","invoiceNo","invoiceType","postingDate","revenueDate","statementNo","status","transferDate","transactionDate","transactionNo","reservationId","reservationIdContext","reservationType","guestProfileId","guestProfileIdContext","guestProfileType","guestName","originalAmount","originalAmountCurrencyCode","amount","currencyCode","paymentsAmount","paymentsCurrencyCode","balanceAmount","balanceCurrencyCode","reference","remark","marketCode","marketGroup","roomClassCode","sourceCode","sourceGroup","cashierId","cashierName","transactionDescription","transactionGroup","transactionSubGroup","transactionCode","balanceForwardDate","inclFolios","inclPrinted","inclZero","filterEndDate","filterStartDate","statementText","accountID"],"contract":{"operationId":"getARStatements","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search AR statements","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getARTransactions","method":"GET","path":"/api/v1/finance/ar/transactions","summary":"Get AR transactions","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["accounts","endDate","startDate","fromAmount","fromCurrencyCode","toAmount","toCurrencyCode","guestName","invoices","folios","fiscalBillNo","accountName","addresseName"],"contract":{"operationId":"getARTransactions","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get AR transactions","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getAccount","method":"GET","path":"/api/v1/finance/ar/accounts/{accountID}","summary":"Get an AR account","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["accountNo","profileId","profileIdContext","profileType","fetchInstructions"],"contract":{"operationId":"getAccount","parameters":[{"$ref":"#/components/parameters/AccountID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get an AR account","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getAccounts","method":"GET","path":"/api/v1/finance/ar/accounts","summary":"Search AR accounts","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["balance","batchStatement","limit","offset","profileId","profileIdContext","profileType","type","accountNo","accountName","accountId","accountIdContext","accountType","includeStatementHistoryIndicator","includeReminderHistoryIndicator","superSearch","attributeName","orderType","minimumBalance"],"contract":{"operationId":"getAccounts","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search AR accounts","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getAlertNotices","method":"GET","path":"/api/v1/reservations/{reservationID}/alerts","summary":"Fetch Alert Notices","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["alertArea","welcomeOffer"],"contract":{"description":"Get the alert notices including global alerts for a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetAlertNotices\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getAlertNotices","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"in":"query","name":"alertArea","required":false,"schema":{"enum":["CheckIn","CheckOut","Reservation","Billing","InHouse"],"type":"string","uniqueItems":true}},{"description":"Determines whether to fetch Global Alert Notices or Welcome Offer Alert Notice.","in":"query","name":"welcomeOffer","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_alerts"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Fetch Alert Notices","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getAllReportGroups","method":"GET","path":"/api/v1/reports/groups","summary":"查询报表分组","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["id","idContext","type","moduleName"],"contract":{"description":" \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetAllReportGroups\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getAllReportGroups","parameters":[{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"id","required":false,"schema":{"type":"string"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT).","in":"query","name":"type","required":false,"schema":{"type":"string"}},{"description":"Used for Character Strings, length 0 to 20.","in":"query","name":"moduleName","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_repcfg_retrievedReportGroups"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询报表分组","x-capability-group":"configuration.read","x-fixed-hotel-query":"HotelId","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"REPCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/repcfg.json"}},{"operation_id":"getAllReports","method":"GET","path":"/api/v1/reports/all","summary":"查询集成报表目录","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["excludeGroup","includeInternalReports","includeRnAReports","includeUnpublished","includeWatermarkDetails","limit","multiPropertyOnly","protectedReportParam","scheduled","name","group","id","idContext","type"],"contract":{"description":"Use this API to return all reports based on search criteria such as excludeGroup, includeInternalReports, includeRnAReports, includeUnpublished, includeWatermarkDetails, limit, multiPropertyOnly, protectedReportParam, scheduled, name, group, hotel, id, idContext, type. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetAllReports\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getAllReports","parameters":[{"description":"Indicates whether a report group should be excluded","in":"query","name":"excludeGroup","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"Indicates whether sample internal reports are to be included","in":"query","name":"includeInternalReports","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether RnA reports are to be included","in":"query","name":"includeRnAReports","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether protected reports should be included","in":"query","name":"includeUnpublished","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether the watermark details is to be populated. This is needed only for the configuration and not for the actual execution.","in":"query","name":"includeWatermarkDetails","required":false,"schema":{"type":"boolean"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Indicates whether the result set should only include multi-property reports.","in":"query","name":"multiPropertyOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether protected reports should be included","in":"query","name":"protectedReportParam","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only reports that can be scheduled are included","in":"query","name":"scheduled","required":false,"schema":{"type":"boolean"}},{"description":"Partial report name or description to search.","in":"query","name":"name","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"Report group to limit search.","in":"query","name":"group","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"id","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT).","in":"query","name":"type","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_repcfg_reports"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询集成报表目录","x-capability-group":"configuration.read","x-fixed-hotel-query":"hotel","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"REPCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/repcfg.json"}},{"operation_id":"getAvailabilityRatePlanInfo","method":"GET","path":"/api/v1/availability/rate-plans/{ratePlanCode}","summary":"查询单个房价计划说明与政策","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved hotel.read application capability"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"query_names":["ratePlanCodeList"],"contract":{"description":"Oracle GET /par/v1/hotels/{hotelId}/rates/{ratePlanCode}. Rate-plan descriptions and policies, not a room-price quotation or a replacement for reservation rate information. Only the configured hotel is used. Oracle 204 becomes HTTP 200 with data: {}. Returned Oracle fields are provisional until customer UAT.","operationId":"getAvailabilityRatePlanInfo","parameters":[{"description":"Rate Plan Code.","in":"path","name":"ratePlanCode","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Rate Plan code.","explode":true,"in":"query","name":"ratePlanCodeList","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rate_par_availabilityRatePlanInfo"}},"type":"object"}]}}},"description":"Bounded Oracle rate information; data is an empty object when Oracle returns 204.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询单个房价计划说明与政策","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved hotel.read application capability"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"x-oracle-api":"PAR","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/par.json"}},{"operation_id":"getAvailabilityRatePlanInfoByMultipleRatePlans","method":"GET","path":"/api/v1/availability/rate-plans","summary":"查询多个房价计划说明与政策","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved hotel.read application capability"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"query_names":["ratePlanCodeList"],"contract":{"description":"Oracle GET /par/v1/hotels/{hotelId}/rates. Rate-plan descriptions and policies, not a room-price quotation or a replacement for reservation rate information. Only the configured hotel is used. Oracle 204 becomes HTTP 200 with data: {}. Returned Oracle fields are provisional until customer UAT.","operationId":"getAvailabilityRatePlanInfoByMultipleRatePlans","parameters":[{"description":"Rate Plan code.","explode":true,"in":"query","name":"ratePlanCodeList","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rate_par_availabilityRatePlanInfo"}},"type":"object"}]}}},"description":"Bounded Oracle rate information; data is an empty object when Oracle returns 204.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询多个房价计划说明与政策","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved hotel.read application capability"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"x-oracle-api":"PAR","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/par.json"}},{"operation_id":"getAwardUpgrades","method":"GET","path":"/api/v1/reservations/award-upgrades","summary":"Get Award Upgrades","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["profileId","idContext","profileIdType","membershipType","membershipCardNo","membershipPoints","id","reservationTimeSpanStartDate","reservationTimeSpanEndDate","reservationTimeSpanDuration","numberOfRooms","roomType"],"contract":{"description":"Get award upgrades for a specific property. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetAwardUpgrades\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getAwardUpgrades","parameters":[{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"profileId","required":false,"schema":{"type":"string"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"profileIdType","required":false,"schema":{"type":"string"}},{"description":"The type of the membership.","in":"query","name":"membershipType","required":false,"schema":{"type":"string"}},{"description":"The card number associated with this membership.","in":"query","name":"membershipCardNo","required":false,"schema":{"type":"string"}},{"description":"Current membership points available for this guest.","in":"query","name":"membershipPoints","required":false,"schema":{"type":"integer"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"id","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"in":"query","name":"reservationTimeSpanStartDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"reservationTimeSpanEndDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"reservationTimeSpanDuration","required":false,"schema":{"type":"string"}},{"description":"The number of rooms.","in":"query","name":"numberOfRooms","required":false,"schema":{"type":"integer"}},{"description":"Room type associated with the reservation.","in":"query","name":"roomType","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_awardUpgrades"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Award Upgrades","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getAwards","method":"GET","path":"/api/v1/reservations/awards","summary":"Fetch Awards","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["reservationId"],"contract":{"description":"Get certificates and awards associated with the Reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetAwards\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getAwards","parameters":[{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationId","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationAwards"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Fetch Awards","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getBalanceInfo","method":"GET","path":"/api/v1/finance/balance","summary":"Get balance information","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["id","idContext","type","folioWindowNo","cashierId","transactionCode","articleCode","amount","currencyCode","profileIdId","profileIdIdContext","profileIdType","reservationIdId","reservationIdIdContext","reservationIdType","fiscalBillNo","folioDate","folioNo","folioStatus","folioTypeName","invoiceNo"],"contract":{"operationId":"getBalanceInfo","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get balance information","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getBankAccountsForReportsLOV","method":"GET","path":"/api/v1/reports/lov/bank-accounts","summary":"报表银行账户选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for bank accounts for reports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetBankAccountsForReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getBankAccountsForReportsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"报表银行账户选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getBlock","method":"GET","path":"/api/v1/blocks/{blockID}","summary":"Get a Block by OPERA ID","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["fetchInstructions","fetchAllocatedRoomTypes","startDate","numberOfDays","roomAllocationCriteria","roomTypes","fetchRoomTypesWithInventory"],"contract":{"operationId":"getBlock","parameters":[{"$ref":"#/components/parameters/BlockID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get a Block by OPERA ID","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"getBlockAvailability","method":"GET","path":"/api/v1/blocks/{blockID}/availability","summary":"Get Block availability","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["overrideRateCode","arrivalDate","nights","adults","children","childAge","bucket1Count","bucket2Count","bucket3Count","bucket4Count","bucket5Count","rooms","ratePlanCode","existingReservationId","existingReservationIdType","roomType","fetchAllocatedRoomType","roomTypeCount","detailedAvailability"],"contract":{"operationId":"getBlockAvailability","parameters":[{"$ref":"#/components/parameters/BlockID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Block availability","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"getBlockCancellationReasons","method":"GET","path":"/api/v1/config/blocks/block-cancellation-reasons","summary":"团队房取消原因 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getBlockCancellationReasons","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房取消原因 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockCancellationReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getBlockDailyRevenue","method":"GET","path":"/api/v1/blocks/daily-revenue","summary":"Get Block daily revenue","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["statisticsDate","blockStatus","ownerCode","blockDailyRevenueCategory","revenueType","revenueGroup"],"contract":{"operationId":"getBlockDailyRevenue","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Block daily revenue","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"getBlockLostBookingCodes","method":"GET","path":"/api/v1/config/blocks/block-lost-booking-codes","summary":"团队房流失原因 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getBlockLostBookingCodes","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房流失原因 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockLostBookingCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getBlockPMReservations","method":"GET","path":"/api/v1/blocks/{blockID}/posting-master/reservations","summary":"只读查询团队 PM 预订","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved blocks.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"query_names":["postingmaster"],"contract":{"description":"Use this API to retrieve PM (Posting Master) reservations for a block. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetBlockPMReservations\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Native 204 is represented by HTTP 200 with upstream_status=204 and data={}. No automatic pagination.Always sends postingmaster=false; true is rejected because the Oracle GET may create a PM.","operationId":"getBlockPMReservations","parameters":[{"description":"Block Id","in":"path","name":"blockID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"If true, a PM reservation will be created for the block if no PM reservations exist.","in":"query","name":"postingmaster","required":false,"schema":{"const":false,"default":false,"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/booking_blk_blockPMReservations"}},"type":"object"}]}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"只读查询团队 PM 预订","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved blocks.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"x-oracle-api":"BLK","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/blk.json"}},{"operation_id":"getBlockRateOverrideReasons","method":"GET","path":"/api/v1/config/blocks/block-rate-override-reasons","summary":"团队房房价覆盖原因 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getBlockRateOverrideReasons","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房房价覆盖原因 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockRateOverrideReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getBlockRefusedReasons","method":"GET","path":"/api/v1/config/blocks/block-refused-reasons","summary":"团队房拒绝原因 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getBlockRefusedReasons","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房拒绝原因 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockRefusedReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getBlockRoomRateGrid","method":"GET","path":"/api/v1/blocks/{blockID}/room-rate-grid","summary":"Get the Block room/rate grid","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["fetchAllocatedRoomTypes","startDate","numberOfDays","roomAllocationCriteria","roomTypes","limit","offset"],"contract":{"operationId":"getBlockRoomRateGrid","parameters":[{"$ref":"#/components/parameters/BlockID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get the Block room/rate grid","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"getBlockStatusCodes","method":"GET","path":"/api/v1/config/blocks/block-status-codes","summary":"团队房状态 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["blockStatusCodes"],"contract":{"operationId":"getBlockStatusCodes","parameters":[{"explode":true,"in":"query","name":"blockStatusCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockStatusCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getBookingTypes","method":"GET","path":"/api/v1/config/reservations/booking-types","summary":"预订类型 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getBookingTypes","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订类型 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/rsv/config/v1/bookingTypes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"getBusinessDate","method":"GET","path":"/api/v1/business-date","summary":"Get the configured hotel's Business Date","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"getBusinessDate","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessDate"}}},"description":"Current open Business Date."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get the configured hotel's Business Date","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BOF"}},{"operation_id":"getCallHistory","method":"GET","path":"/api/v1/reservations/{reservationID}/calls","summary":"Get the Reservation Call History","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"Get the Reservation Call History \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetCallHistory\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getCallHistory","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_callHistory"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get the Reservation Call History","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getCancellationCodes","method":"GET","path":"/api/v1/config/reservations/cancellation-codes","summary":"预订取消原因 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getCancellationCodes","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订取消原因 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/rsv/config/v1/cancellationCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"getCancellationHistory","method":"GET","path":"/api/v1/reservations/{reservationID}/cancellation-history","summary":"Get cancellation history","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["hotelName","roomStayStartDate","roomStayEndDate","roomStayDuration","roomClass","roomType","numberOfRooms","roomId","ratePlanCode","reservationBlockHotelId","reservationBlockId","reservationBlockIdType","blockName","bookingChannelCode","linkCode","onHold","membershipAccountId","membershipBonusCode","membershipLevel","membershipId","lastStayDate"],"contract":{"description":"Get cancellation history for a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetCancellationHistory\u003c/p\u003e \u003cp\u003eThis API allows a time span of \u003cstrong\u003e30\u003c/strong\u003e days.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getCancellationHistory","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"in":"query","name":"hotelName","required":false,"schema":{"type":"string"}},{"in":"query","name":"roomStayStartDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"roomStayEndDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"roomStayDuration","required":false,"schema":{"type":"string"}},{"description":"Room class code","in":"query","name":"roomClass","required":false,"schema":{"type":"string"}},{"description":"Room type code","in":"query","name":"roomType","required":false,"schema":{"type":"string"}},{"description":"Room Id","in":"query","name":"numberOfRooms","required":false,"schema":{"type":"integer"}},{"description":"Room Id","in":"query","name":"roomId","required":false,"schema":{"type":"string"}},{"description":"Rate plan code","in":"query","name":"ratePlanCode","required":false,"schema":{"type":"string"}},{"description":"This is the HotelCode of the Block.","in":"query","name":"reservationBlockHotelId","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"reservationBlockId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"reservationBlockIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The Name of the block that is attached to the reservation.","in":"query","name":"blockName","required":false,"schema":{"type":"string"}},{"description":"Booking channel code","in":"query","name":"bookingChannelCode","required":false,"schema":{"type":"string"}},{"description":"Party code","in":"query","name":"linkCode","required":false,"schema":{"type":"string"}},{"description":"Guarantee Code.","in":"query","name":"onHold","required":false,"schema":{"type":"boolean"}},{"description":"The account identification number for this particular member in this particular program.","in":"query","name":"membershipAccountId","required":false,"schema":{"type":"string"}},{"description":"The code or name of the bonus program. BonusCode can be used to indicate the level of membership (Gold Club, Platinum member, etc.)","in":"query","name":"membershipBonusCode","required":false,"schema":{"type":"string"}},{"description":"The code or name of the membership level and indicates the level of membership (Gold Club, Platinum member, etc.). This is same as the BonusCode.","in":"query","name":"membershipLevel","required":false,"schema":{"type":"string"}},{"description":"Membership ID (Unique ID from the memberships table).","in":"query","name":"membershipId","required":false,"schema":{"type":"number"}},{"description":"Guest's last stay date.","in":"query","name":"lastStayDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_cancellationHistory"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get cancellation history","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getConfLetterReportsLOV","method":"GET","path":"/api/v1/reports/lov/confirmation-letters","summary":"确认函报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for confirmation letter reports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetConfLetterReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getConfLetterReportsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"确认函报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getConfigReportsLOV","method":"GET","path":"/api/v1/reports/lov/configuration/{moduleName}","summary":"模块配置报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for configuration reports based on search criteria such as moduleName, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetConfigReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getConfigReportsLOV","parameters":[{"description":"Value of the parameter 'moduleName' which is required to fetch ConfigReports LOV","in":"path","name":"moduleName","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"模块配置报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getConfirmationLetters","method":"GET","path":"/api/v1/reservations/confirmation-letters","summary":"Fetch Confirmation Letters","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["notAttached","pending","sent","createdOnEndDate","createdOnStartDate","arrivalEndDate","arrivalStartDate","letterStyleId","letterStyle","letterStyleIdType","reservationGuestId","reservationGuestIdType","membershipId","membershipLevelCode","membershipTypeCode","surname","givenName","blockHotelId","blockId","blockIdType","blockName"],"contract":{"description":"Get a list of Reservations for which confirmation letters need to be sent. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetConfirmationLetters\u003c/p\u003e \u003cp\u003eThis API allows a time span of \u003cstrong\u003e90\u003c/strong\u003e days.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getConfirmationLetters","parameters":[{"description":"If true then the fetch result will include the reservations that do not have a letter attached to them.","in":"query","name":"notAttached","required":false,"schema":{"type":"boolean"}},{"description":"If true then the result will include only the pending confirmation letters.","in":"query","name":"pending","required":false,"schema":{"type":"boolean"}},{"description":"If true then the result will include only the confirmation letters that have been sent to the guest.","in":"query","name":"sent","required":false,"schema":{"type":"boolean"}},{"description":"The ending value of the date range.","in":"query","name":"createdOnEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"createdOnStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The ending value of the date range.","in":"query","name":"arrivalEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"arrivalStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"letterStyleId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Name of the confirmation letter style.","explode":true,"in":"query","name":"letterStyle","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"letterStyleIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationGuestId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"reservationGuestIdType","required":false,"schema":{"type":"string"}},{"description":"Membership ID criteria.","in":"query","name":"membershipId","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"membershipLevelCode","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"membershipTypeCode","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Family name, last name.","in":"query","name":"surname","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"givenName","required":false,"schema":{"type":"string"}},{"description":"This is the HotelCode of the Block.","in":"query","name":"blockHotelId","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"blockId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"blockIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The Name of the block that is attached to the reservation.","in":"query","name":"blockName","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationConfirmationLetters"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Fetch Confirmation Letters","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getDestinationCodes","method":"GET","path":"/api/v1/config/blocks/destination-codes","summary":"目的地代码 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getDestinationCodes","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"目的地代码 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/destinationCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getDistributionReservationsSummary","method":"GET","path":"/api/v1/reservations/statistics","summary":"Get Reservation DistributionReservationsSummary","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["enterpriseId","channelCode","startDate","endDate","limit","offset"],"contract":{"description":"Get DistributionReservationsSummary. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetDistributionReservationsSummary\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getDistributionReservationsSummary","parameters":[{"description":"This is the EnterpriseId of Hotel Code","in":"query","name":"enterpriseId","required":false,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"This is the ChannelCode of Hotel Code in the Reservations","explode":true,"in":"query","name":"channelCode","required":false,"schema":{"items":{"type":"string"},"maxItems":100,"type":"array","uniqueItems":true},"style":"form"},{"description":"This is the Last Updated From Date for a Reservation","in":"query","name":"startDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"This is the Last Updated To Date for a Reservation","in":"query","name":"endDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"default":20,"minimum":0,"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"type":"integer"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_checkDistributionReservationsSummary"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation DistributionReservationsSummary","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getECoupons","method":"GET","path":"/api/v1/reservations/{reservationID}/e-coupons","summary":"Get Reservation Ecoupons","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","offset"],"contract":{"description":"Get the Reservation Ecoupons. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetECoupons\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getECoupons","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_eCoupons"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation Ecoupons","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getEndOfDayReportsLOV","method":"GET","path":"/api/v1/reports/lov/end-of-day/{beforeIncomeAudit}","summary":"日结报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for end of day reports for a specific property based on search criteria such as beforeIncomeAudit, hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetEndOfDayReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getEndOfDayReportsLOV","parameters":[{"description":"Value of the parameter 'beforeIncomeAudit' which is required to fetch EndOfDayReports LOV","in":"path","name":"beforeIncomeAudit","required":true,"schema":{"enum":["Y","N"],"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"日结报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getExternalSystemDeliveryHistory","method":"GET","path":"/api/v1/reservations/external-system-delivery-history","summary":"Get External system delivery history","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["reservationId","reservationIdType"],"contract":{"description":"Get external system delivery history. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetExternalSystemDeliveryHistory\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getExternalSystemDeliveryHistory","parameters":[{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"reservationIdType","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_deliveryHistoryLog"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get External system delivery history","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getFinancialPostings","method":"GET","path":"/api/v1/finance/financial-postings","summary":"Get Financial Postings","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["limit","offset","startDate","endDate","duration","cashierId","filterTransactionCode","code","filterRoomNumber","referenceNumberWildCard","checkNumberWildCard","supplementWildCard","approvalCode","approvalStatusCode","folioWindowNo","id","idContext","type","amount","currencyCode","closureNo"],"contract":{"operationId":"getFinancialPostings","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Financial Postings","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH","x-sensitive-query-fields-excluded":["cardNumber","cardHolderName","expirationDate"]}},{"operation_id":"getFinancialPostingsAsync","method":"GET","path":"/api/v1/finance/financial-posting-jobs/{jobID}","summary":"Get Financial Postings Net/VAT extract results","capability_group":"finance.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"operationId":"getFinancialPostingsAsync","parameters":[{"$ref":"#/components/parameters/JobID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Financial Postings Net/VAT extract results","x-capability-group":"finance.async","x-finance-policy":"read-only-job","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"CSHASYNC"}},{"operation_id":"getFinancialPostingsProcessStatusAsync","method":"GET","path":"/api/v1/finance/financial-posting-jobs/{jobID}/status","summary":"Check Financial Postings extract status","capability_group":"finance.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"operationId":"getFinancialPostingsProcessStatusAsync","parameters":[{"$ref":"#/components/parameters/JobID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatus"}}},"description":"Current Oracle process status.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}},"Retry-After":{"description":"Seconds from Oracle Cache-Control max-age before polling again, when supplied.","schema":{"type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Check Financial Postings extract status","x-capability-group":"finance.async","x-finance-policy":"read-only-job","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"CSHASYNC"}},{"operation_id":"getFolio","method":"GET","path":"/api/v1/finance/reservations/{reservationID}/folios","summary":"Get reservation folios","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["guestPayOnly","includeFolioHistory","reservationBalanceOnly","fetchInstructions","end","folioWindowNo","limit","offset","start","summaryOnly","groupType","exchangeCurrency","calculateCollectingAgentTaxes","vATOffset","includeDepositTaxes","simpleFolio"],"contract":{"operationId":"getFolio","parameters":[{"$ref":"#/components/parameters/ReservationID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get reservation folios","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getFolioTransactionDetails","method":"GET","path":"/api/v1/finance/transaction-details","summary":"Get folio transaction details","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["includeGenerates","transactionNo","includeExchangeInformation"],"contract":{"operationId":"getFolioTransactionDetails","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get folio transaction details","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getGenericReportsLOV","method":"GET","path":"/api/v1/reports/lov/generic","summary":"通用报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for generic reports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetGenericReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getGenericReportsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"通用报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getGuaranteeCodes","method":"GET","path":"/api/v1/codes/guarantees","summary":"Get hotel Guarantee Codes","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["limit","pageNumber","guaranteeCodes","inactive"],"contract":{"operationId":"getGuaranteeCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel Guarantee Codes","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSVCFG"}},{"operation_id":"getGuestMessages","method":"GET","path":"/api/v1/reservations/guest-messages","summary":"Get guest messages","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","offset","reservationId","retrieveDeliveredMessages","room","travelAgent","company","group","source","reservationStatus","retrieveUndeliveredMessages","retrievePrintedMessages","retrieveTextedMessages","blockName","recipientName","confirmationNo"],"contract":{"description":"Get guest messages which exist on a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetGuestMessages\u003c/p\u003e \u003cp\u003eThe maximum allowable limit for this API is \u003cstrong\u003e100\u003c/strong\u003e.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getGuestMessages","parameters":[{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationId","required":false,"schema":{"type":"string"}},{"description":"Flag that specified if Delivered Guest Messages will also be retrieved.","in":"query","name":"retrieveDeliveredMessages","required":false,"schema":{"type":"boolean"}},{"description":"Room number attached to the reservation.","in":"query","name":"room","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages with this Travel agent name.","in":"query","name":"travelAgent","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages with the Company name.","in":"query","name":"company","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages with the Travel agent name.","in":"query","name":"group","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages with the Source name.","in":"query","name":"source","required":false,"schema":{"type":"string"}},{"description":"Represents Reservation search type Player Snapshot.","in":"query","name":"reservationStatus","required":false,"schema":{"enum":["Any","DayUse","Arrival","Arrived","Departure","WaitList","Cancellation","CheckedOut","NoShow","Complimentary","InHouse","PostStayPendingBalance","PreRegistered","PostToRoom","OpenFolio","ScheduledCheckOut","Queued","MobileCheckout","RegisteredAndInHouse","ResvBlockTraces","GuestMessages","MassCancellation","Operator","Turndown","WalkIn","AdvanceCheckedIn","OpenBalance","AutoFolioSettlement","Routing","PlayerSnapshot"],"type":"string","uniqueItems":true}},{"description":"Flag that specified if Undelivered Guest Messages will also be retrieved.","in":"query","name":"retrieveUndeliveredMessages","required":false,"schema":{"type":"boolean"}},{"description":"Flag that specified if Printed Guest Messages will also be retrieved.","in":"query","name":"retrievePrintedMessages","required":false,"schema":{"type":"boolean"}},{"description":"Flag that specified if Texted Guest Messages will also be retrieved.","in":"query","name":"retrieveTextedMessages","required":false,"schema":{"type":"boolean"}},{"description":"Lookup messages using Block name.","in":"query","name":"blockName","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages with the recipient name.","in":"query","name":"recipientName","required":false,"schema":{"type":"string"}},{"description":"Lookup guest messages using reservation confirmation no.","in":"query","name":"confirmationNo","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_guestMessages"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get guest messages","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getGuestsTransactions","method":"GET","path":"/api/v1/finance/transactions","summary":"Get guest transactions","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["reservationList","includeGenerates","includeTransactionsWithARInvoiceNo","includeTransactionsWithFolioNo","includeTransactionsWithManualPostingOnly","idContext","type","transactionNo","transactionGroup","transactionSubGroup","billingCode","desc","routingInstructionsId","trxCodeWildCard","trxDescriptionWildCard","checkNumberWildCard","referenceNumberWildCard","supplementWildCard","windowNo","cashieringTransactionType","startDate","endDate","cashierId","code","commissionable","serviceRecoveryAllowed","postedTransactionType","billingSummary"],"contract":{"operationId":"getGuestsTransactions","parameters":[{"description":"One or more OPERA reservation IDs; repeat the query parameter for multiple values.","explode":true,"in":"query","name":"reservationList","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get guest transactions","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getHotelAvailability","method":"GET","path":"/api/v1/availability","summary":"Get hotel availability and prices","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["includeLocalRates","includeOffshoreRates","includeClosedRates","includeDefaultRatePlanSet","includeNoRatePlanSet","initialRatePlanSet","limit","pagePointerKey","ratePlanSet","redeemAwards","roomStayStartDate","roomStayEndDate","roomStayQuantity","adults","children","childAge","bucket1Count","bucket2Count","bucket3Count","bucket4Count","bucket5Count","fullStayTimeSpanStartDate","fullStayTimeSpanEndDate","prevailingRate","rateCategory","rateClass","rateGroup","ratePlanCode","promotionCode","roomType","feature","reservationGuestId","reservationGuestIdType","reservationProfileType","attachedProfileId","hotelReservationId","hotelReservationIdType","ratePlanInfo","returnOnlyAvailableRateCodes","resGuaranteeInfo","roomTypeInfo","membershipLevel","membershipType","pointsAvailable","smokingPreference","hotelPackage","ownerType","controlSegment","postingInterval"],"contract":{"description":"Uses only the configured hotel. See the Oracle getHotelAvailability schema for allowlisted field semantics.","operationId":"getHotelAvailability","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel availability and prices","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"PAR","x-sensitive-query-fields-excluded":["membershipIdNumber","membershipCardNumber"]}},{"operation_id":"getHotelReservations","method":"GET","path":"/api/v1/reservations","summary":"Get Reservations for a hotel","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["keyTrack2","discrepancy","limit","offset","searchType","text","reservationIdList","confirmationNumberList","cancellationNumberList","externalReferenceIds","externalSystemCodes","externalReferenceLegId","arrivalEndDate","arrivalStartDate","departureEndDate","departureStartDate","stayOnStartDate","createdOnStartDate","expectedArrivalEndTime","expectedArrivalStartTime","depositDueEndDate","depositDueStartDate","expectedReturnEndTime","expectedReturnStartTime","companyNames","sourceNames","travelAgentNames","groupNames","travelAgentIds","companyIds","sourceIds","contactIds","groupIds","billingContactIds","profileId","commissionPaid","vouchersGenerated","membershipCardNumber","membershipLevels","membershipTypes","reservationsWithMembershipType","surname","givenName","fromName","toName","anyVIPStatus","vipCodes","guaranteeCode","paymentMethod","discountApplied","user","createdBy","cancelledByList","cancelledOn","ratePlanCodes","sourceCodes","marketCodes","excludeBlockReservations","blockCriteriaHotelCode","blockName","blockIds","blockCodes","customReference","recordLocator","orderBy","sortOrder","roomAssignedOnly","roomUnassignedOnly","roomId","roomType","roomFeatures","roomSpecials","roomSmokingPreference","roomFloorPreferences","housekeepingRoomStatuses","roomClasses","roomRangeFrom","roomRangeTo","communication","phone","email","profileExternalReferencesToFetch","resvExternalReferencesToFetch","fetchInstructions","allowedReservationActions","allowPreRegistration","excludeNoPost","excludePMRooms","hasDepositBalance","hasOpenBalance","hasOpenFolio","includeScheduledCheckOut","linkedOnly","unlinkedOnly","actualArrivals","actualDepartures","complimentaryReservations","dayOfArrivalCancels","dayUse","earlyDepartures","expectedArrivals","expectedDepartures","extendedStays","houseUseReservations","stayovers","stayDate","roomRoutingId","periodicFolio","folioSettlementTypes","defaultDays","daysSinceLastAutoSettled","dateSinceLastAutoSettled","excludePseudoRoomReservations","excludeReservationIds","excludeVIPStatusCodes","excludeSpecials","excludeFloorPreferences","excludeAdvanceCheckedIn","excludeRoomFeatures","playerId","gamingBalanceFrom","gamingBalanceTo","compAccountingBalanceFrom","compAccountingBalanceTo","searchTypes","reservationStatuses","transportationCodes","roomReadyStatuses","checkoutMessageReceived","optedForCommunication","swapShiftRoomReservationId","roomSmokingPreferences","roomFeaturePreferences","roomsFloorPreferences","contactNames","taRecordLocatorList","packageCodes","inventoryItems","guaranteeCodes","linkedName","backToBackOnly","backToBackDateOn","scheduledRoomMoveDate","scheduledRoomMoveStartTime","scheduledRoomMoveEndTime","scheduledRoomMoveStatus","excludeBackToBackReservations","checkInInitiatedBy","flexChar","flexNum","flexDate","pkgCategoryToFetch","pkgForecastedConsumptionDateToFetch","itineraryLeg","preRegisteredOnly","similaritySearch","includeReviewedPreArrivals"],"contract":{"deprecated":true,"description":"This API will allow a user to retrieve a list of reservations based on the search criteria specified in the request body. For example you can search for reservations using query parameters like first name, last name, arrival/departure date, external confirmation number. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetHotelReservations\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}. Unsupported input fields: recentlyAccessed.","operationId":"getHotelReservations","parameters":[{"description":"keyTrack2 is an id which is either generated by the PMS or provided by the door lock system and which is associated to the reservation. With the keyTrack2 value a reservation can be identified.","in":"query","name":"keyTrack2","required":false,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"in":"query","name":"discrepancy","required":false,"schema":{"enum":["Skip","Sleep"],"type":"string","uniqueItems":true}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Represents Reservation search type Player Snapshot.","in":"query","name":"searchType","required":false,"schema":{"enum":["Any","DayUse","Arrival","Arrived","Departure","WaitList","Cancellation","CheckedOut","NoShow","Complimentary","InHouse","PostStayPendingBalance","PreRegistered","PostToRoom","OpenFolio","ScheduledCheckOut","Queued","MobileCheckout","RegisteredAndInHouse","ResvBlockTraces","GuestMessages","MassCancellation","Operator","Turndown","WalkIn","AdvanceCheckedIn","OpenBalance","AutoFolioSettlement","Routing","PlayerSnapshot","FiscalInfo","CorrectionPostings","Vouchers","ScheduledRoomMoves","PayByLinks"],"type":"string","uniqueItems":true}},{"description":"Free form text field for searching all reservation fields","in":"query","name":"text","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"reservationIdList","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"confirmationNumberList","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"cancellationNumberList","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"externalReferenceIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","explode":true,"in":"query","name":"externalSystemCodes","required":false,"schema":{"default":["External"],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"External reference leg number","in":"query","name":"externalReferenceLegId","required":false,"schema":{"type":"number"}},{"description":"The ending value of the date range.","in":"query","name":"arrivalEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"arrivalStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The ending value of the date range.","in":"query","name":"departureEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"departureStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"stayOnStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Fetches reservations which are created on the given property business date.","in":"query","name":"createdOnStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The ending value of the time span. Uses the hotel's time zone.","in":"query","name":"expectedArrivalEndTime","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"The starting value of the time span. Uses the hotel's time zone.","in":"query","name":"expectedArrivalStartTime","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"The ending value of the date range.","in":"query","name":"depositDueEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"depositDueStartDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"The ending value of the time span. Uses the hotel's time zone.","in":"query","name":"expectedReturnEndTime","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"The starting value of the time span. Uses the hotel's time zone.","in":"query","name":"expectedReturnStartTime","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Attached profile name","explode":true,"in":"query","name":"companyNames","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","explode":true,"in":"query","name":"sourceNames","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","explode":true,"in":"query","name":"travelAgentNames","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","explode":true,"in":"query","name":"groupNames","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"travelAgentIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"companyIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"sourceIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"contactIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"groupIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. API expects CompanyName Query parameter along with the ID to obtain correct results.","explode":true,"in":"query","name":"billingContactIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Unique Identifier for a guest profile associated with the reservation(s)","in":"query","name":"profileId","required":false,"schema":{"type":"string"}},{"description":"Commission Paid criteria","in":"query","name":"commissionPaid","required":false,"schema":{"type":"boolean"}},{"description":"All reservations with generated vouchers to be returned if vouchersGenerated is set to true. All reservations without the generated vouchers to be returned if it is set to false.","in":"query","name":"vouchersGenerated","required":false,"schema":{"type":"boolean"}},{"description":"Membership ID criteria.","in":"query","name":"membershipCardNumber","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"membershipLevels","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"membershipTypes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"When set to true, only reservations with a membership belonging to the specified membership type will be returned","in":"query","name":"reservationsWithMembershipType","required":false,"schema":{"type":"boolean"}},{"description":"Family name, last name.","in":"query","name":"surname","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"givenName","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"fromName","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"toName","required":false,"schema":{"type":"string"}},{"description":"VIP status of the customer.","in":"query","name":"anyVIPStatus","required":false,"schema":{"type":"boolean"}},{"description":"VIP status of the customer.","explode":true,"in":"query","name":"vipCodes","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Fetches the reservation having Guarantee Code(Reservation Type) supplied here.","in":"query","name":"guaranteeCode","required":false,"schema":{"type":"string"}},{"description":"Fetches the reservation having method of payment supplied here.","in":"query","name":"paymentMethod","required":false,"schema":{"type":"string"}},{"description":"Fetches the reservation for which discount is applied","in":"query","name":"discountApplied","required":false,"schema":{"default":false,"type":"boolean"}},{"explode":true,"in":"query","name":"user","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Fetches reservation created by specified user. If both CreatedByUsers and CreatedBy is specified, CreatedByUsers will take precedence.","in":"query","name":"createdBy","required":false,"schema":{"type":"string"}},{"description":"Fetches reservations cancelled by list of users.","explode":true,"in":"query","name":"cancelledByList","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Fetches reservations which are cancelled on the given property business date.","in":"query","name":"cancelledOn","required":false,"schema":{"format":"date","type":"string"}},{"explode":true,"in":"query","name":"ratePlanCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"sourceCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"marketCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"If true the search result will exclude the blocks reservations.","in":"query","name":"excludeBlockReservations","required":false,"schema":{"type":"boolean"}},{"description":"The Hotel Code of the Block.","in":"query","name":"blockCriteriaHotelCode","required":false,"schema":{"type":"string"}},{"description":"The Name of the block that is attached to the reservation.","in":"query","name":"blockName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"blockIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"blockCodes","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Custom reference","in":"query","name":"customReference","required":false,"schema":{"type":"string"}},{"description":"GDS Record Locator for reservation.","in":"query","name":"recordLocator","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"orderBy","required":false,"schema":{"items":{"enum":["Nights","ArrivalDate","ArrivalDateETR","DepartureDate","GuestSurname","RateAmount","RateCode","Room","RoomType","QueuePriority","QueueDurationTime","ConfirmationNo"],"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"sortOrder","required":false,"schema":{"default":["Asc"],"items":{"enum":["Asc","Desc"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Indicator to query reservations which have a room number assigned.","in":"query","name":"roomAssignedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicator to query reservations which does not have a room number assigned.","in":"query","name":"roomUnassignedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Room number of the reservation to search by.","in":"query","name":"roomId","required":false,"schema":{"type":"string"}},{"description":"Room Type.","explode":false,"in":"query","name":"roomType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"A code representing a room feature.","explode":true,"in":"query","name":"roomFeatures","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Preference value for display purposes.","explode":true,"in":"query","name":"roomSpecials","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Preference value for display purposes.","in":"query","name":"roomSmokingPreference","required":false,"schema":{"type":"string"}},{"description":"Preference value for display purposes.","explode":true,"in":"query","name":"roomFloorPreferences","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Simple type for room status instructions to be used in requests for fetching housekeeping rooms. Valid status values are Clean, Dirty, Pickup, Inspected, OutOfOrder, OutOfService.","explode":true,"in":"query","name":"housekeepingRoomStatuses","required":false,"schema":{"items":{"enum":["Clean","Dirty","Pickup","Inspected","OutOfOrder","OutOfService"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"explode":true,"in":"query","name":"roomClasses","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"in":"query","name":"roomRangeFrom","required":false,"schema":{"type":"string"}},{"in":"query","name":"roomRangeTo","required":false,"schema":{"type":"string"}},{"description":"Any communication attached to the reservation from the primary guest's profile such as phone, fax or email address.","in":"query","name":"communication","required":false,"schema":{"type":"string"}},{"description":"The phone number attached to the reservation from the primary guest's profile.","in":"query","name":"phone","required":false,"schema":{"type":"string"}},{"description":"The email address attached to the reservation from the primary guest's profile.","in":"query","name":"email","required":false,"schema":{"type":"string"}},{"description":"Define the external system(s) to return external reference ids for associated profiles for the reservation. A maximum of 10 different external systems can be be provided for this parameter.","explode":true,"in":"query","name":"profileExternalReferencesToFetch","required":false,"schema":{"items":{"type":"string"},"maxItems":10,"type":"array"},"style":"form"},{"description":"Define the external system(s) to return external reference ids for reservations. A maximum of 10 different external systems can be be provided for this parameter.","explode":true,"in":"query","name":"resvExternalReferencesToFetch","required":false,"schema":{"items":{"type":"string"},"maxItems":10,"type":"array"},"style":"form"},{"description":"Instruction on which elements of the reservation are to be fetched. Instructions are cumulative i.e. additional elements would be added, but not duplicated.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","ReservationID","Indicators","Deposits","RevenuesAndBalances","GuestServiceStatus","MasterInfo","CancellationInfo","BlockReservations","TaxType","GuestDeviceNotification","RoomAssignedByAI","SwapShiftRooms","ReservationPreferences","FiscalInfo","CommissionsInfo","DepartureReservationInfo","Vouchers","MultipleMemberships","FetchChildAges","OffshoreRates","PostingIntervals","PreArrivals"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Flag indicating whether the Enrollment is in progress or not for the Profile associated with this Reservation.","explode":true,"in":"query","name":"allowedReservationActions","required":false,"schema":{"items":{"enum":["Cancel","Move","PreCharge","PostCharge","FacilitySchedule","Upsell","PreCheckIn","PostToNoShowCancel","NoShow","NameChange","Discount","HouseKeeping","EnrollToPrimaryMembership","EnrollInProgress","MemberAwardAttached"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Flag containing true or false value for reservation to be eligible for prior check in by guest using mobile device. Pass the 'true' or 'false' values when creating / modifying reservation to indicate whether a reservation is eligible for mobile check in yes / no. Upon fetch, the current state of the flag will show true or false.","in":"query","name":"allowPreRegistration","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that reservations with No Post flag should not be expected from the result.","in":"query","name":"excludeNoPost","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that reservations with PM room type should not be expected from the result.","in":"query","name":"excludePMRooms","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only reservations with deposit balance should be expected from the result.","in":"query","name":"hasDepositBalance","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only reservations with open balance should be expected from the result.","in":"query","name":"hasOpenBalance","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only reservations with open folio should be expected from the result.","in":"query","name":"hasOpenFolio","required":false,"schema":{"type":"boolean"}},{"description":"Criteria that indicates whether to scheduled checkouts or not.","in":"query","name":"includeScheduledCheckOut","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only linked reservations should be expected from the result.","in":"query","name":"linkedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only unlinked reservations should be expected from the result.","in":"query","name":"unlinkedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which have already arrived on the Search Date is required.","in":"query","name":"actualArrivals","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which were expected to depart on the Search Date and have already checked, is required.","in":"query","name":"actualDepartures","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations where rate codes are marked as Complimentary Rates , is required. This flag should be used in conjunction with the Arrivals, Departures or StayOvers criteria.","in":"query","name":"complimentaryReservations","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which have cancelled on the Search Date which is also the day of arrival is required.","in":"query","name":"dayOfArrivalCancels","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which are day use reservation on the Search Date, is required.","in":"query","name":"dayUse","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which checked out early on the Search Date, is required.","in":"query","name":"earlyDepartures","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which are expected arrivals for the Search Date and who have not yet arrived, is required.","in":"query","name":"expectedArrivals","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which are expected departures for the Search Date and who have not yet departed, is required.","in":"query","name":"expectedDepartures","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which have extended their stays on the Search Date, is required.","in":"query","name":"extendedStays","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations where rate codes are marked as House Use Rates , is required. This flag should be used in conjunction with the Arrivals, Departures or StayOvers criteria.","in":"query","name":"houseUseReservations","required":false,"schema":{"type":"boolean"}},{"description":"Indicates if reservations which are StayOvers on the Search Date, is required.","in":"query","name":"stayovers","required":false,"schema":{"type":"boolean"}},{"description":"Date for searching the reservations. This is the date for which the search types are applicable. If date is not available, the business date will be used by default.","in":"query","name":"stayDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"roomRoutingId","required":false,"schema":{"type":"string"}},{"description":"Periodic folio type.","in":"query","name":"periodicFolio","required":false,"schema":{"enum":["Weekly","Monthly","Days"],"type":"string","uniqueItems":true}},{"description":"Comma-delimited list of Folio Settlement Type codes.","in":"query","name":"folioSettlementTypes","required":false,"schema":{"type":"string"}},{"description":"Use the Number of Days For Settlement, defined for the Reservation.","in":"query","name":"defaultDays","required":false,"schema":{"type":"boolean"}},{"description":"Use the Number of days since last auto settled.","in":"query","name":"daysSinceLastAutoSettled","required":false,"schema":{"type":"number"}},{"description":"Use the Date since last auto settled.","in":"query","name":"dateSinceLastAutoSettled","required":false,"schema":{"format":"date","type":"string"}},{"description":"Indicates to exclude Pseudo room reservations.","in":"query","name":"excludePseudoRoomReservations","required":false,"schema":{"type":"boolean"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"excludeReservationIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"VIP status of the customer.","explode":true,"in":"query","name":"excludeVIPStatusCodes","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Preference value for display purposes.","explode":true,"in":"query","name":"excludeSpecials","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Preference value for display purposes.","explode":true,"in":"query","name":"excludeFloorPreferences","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Indicates to exclude Advance Checked In Reservations from search result.","in":"query","name":"excludeAdvanceCheckedIn","required":false,"schema":{"type":"boolean"}},{"description":"Exclude the reservation(s) with provided room features from the search result.","explode":true,"in":"query","name":"excludeRoomFeatures","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Player ID associated to the reservation.","in":"query","name":"playerId","required":false,"schema":{"type":"string"}},{"description":"Balance from.","in":"query","name":"gamingBalanceFrom","required":false,"schema":{"type":"number"}},{"description":"Balance to.","in":"query","name":"gamingBalanceTo","required":false,"schema":{"type":"number"}},{"description":"Comp Balance From","in":"query","name":"compAccountingBalanceFrom","required":false,"schema":{"type":"number"}},{"description":"Comp Balance To","in":"query","name":"compAccountingBalanceTo","required":false,"schema":{"type":"number"}},{"description":"Represents Reservation search type Player Snapshot.","explode":true,"in":"query","name":"searchTypes","required":false,"schema":{"items":{"enum":["Any","DayUse","Arrival","Arrived","Departure","WaitList","Cancellation","CheckedOut","NoShow","Complimentary","InHouse","PostStayPendingBalance","PreRegistered","PostToRoom","OpenFolio","ScheduledCheckOut","Queued","MobileCheckout","RegisteredAndInHouse","ResvBlockTraces","GuestMessages","MassCancellation","Operator","Turndown","WalkIn","AdvanceCheckedIn","OpenBalance","AutoFolioSettlement","Routing","PlayerSnapshot","IncludeDetachedGuest"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Reservation status type for reservations search.","explode":true,"in":"query","name":"reservationStatuses","required":false,"schema":{"items":{"enum":["Cancelled","CheckedOut","CheckedIn","DueIn","DueOut","InHouse","NoShow","WaitList"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Codes to be searched.","explode":true,"in":"query","name":"transportationCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Enum to denote the Status of Readiness messages sent to Guest Devices.","explode":true,"in":"query","name":"roomReadyStatuses","required":false,"schema":{"items":{"enum":["Pending","Completed","Failed","Sent","Received","Cancelled","PendingAvailability"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Fetches the reservations for which Checkout Message is received.","in":"query","name":"checkoutMessageReceived","required":false,"schema":{"type":"boolean"}},{"description":"Fetches the reservations for which reservation communication has been opted.","in":"query","name":"optedForCommunication","required":false,"schema":{"type":"boolean"}},{"description":"Fetches the reservations for which this reservation room can be shifted or swapped.","in":"query","name":"swapShiftRoomReservationId","required":false,"schema":{"type":"string"}},{"description":"The smoking preferences of rooms to be fetched.","explode":true,"in":"query","name":"roomSmokingPreferences","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The room features of the rooms. Fetches reservations with rooms that have same room features. It has to be used in conjunction with roomType, arrivalStartDate, and arrivalEndDate.","explode":true,"in":"query","name":"roomFeaturePreferences","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The floor of the rooms. Fetches reservations with rooms that are on the same floor. It has to be used in conjunction with roomType, arrivalStartDate, and arrivalEndDate.","explode":true,"in":"query","name":"roomsFloorPreferences","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Name of Contact Profile associated with Reservation.","explode":true,"in":"query","name":"contactNames","required":false,"schema":{"items":{"maxLength":82,"minLength":0,"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Travel Agent Record Locators List.","explode":true,"in":"query","name":"taRecordLocatorList","required":false,"schema":{"items":{"type":"string"},"maxItems":30,"type":"array"},"style":"form"},{"description":"Package Codes and Package Groups to be searched, can only be used when searching for reservations at a single property with a maximum date range of 90 days. It is required to populate either Arrival From/To, Departure From/To, or the Stay Date filter(s).","explode":true,"in":"query","name":"packageCodes","required":false,"schema":{"items":{"maxLength":20,"minLength":0,"type":"string"},"maxItems":100,"type":"array"},"style":"form"},{"description":"Inventory Items to be searched, can only be used when searching for reservations at a single property with a maximum date range of 90 days. It is required to populate either Arrival From/To, Departure From/To, or the Stay Date filter(s)","explode":true,"in":"query","name":"inventoryItems","required":false,"schema":{"items":{"maxLength":20,"minLength":0,"type":"string"},"maxItems":100,"type":"array"},"style":"form"},{"description":"Fetches the reservation having Guarantee Codes(Reservation Type) supplied here. Example guaranteeCodes=6PM","explode":true,"in":"query","name":"guaranteeCodes","required":false,"schema":{"items":{"maxLength":20,"minLength":0,"type":"string"},"maxItems":100,"type":"array"},"style":"form"},{"description":"Name of the group of Linked Reservations to be searched.","in":"query","name":"linkedName","required":false,"schema":{"maxLength":50,"minLength":0,"type":"string"}},{"description":"Indicates that only reservations marked as Back to Back should be expected in the result.","in":"query","name":"backToBackOnly","required":false,"schema":{"type":"boolean"}},{"description":"Fetches linked Back to Back reservations with the specified Back to Back Date. Fetched reservations will be marked as Back to Back and they will either depart or arrive on the specified Back to Back day.","in":"query","name":"backToBackDateOn","required":false,"schema":{"format":"date","type":"string"}},{"description":"Scheduled Move Rooms Date Criteria. This will parameter be mandatory when search Type is ScheduledRoomMove.","in":"query","name":"scheduledRoomMoveDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Start of Scheduled Move Room Time Range Criteria (in 24 hour time format). Applicable when Search Type is ScheduledRoomMove. Uses the hotel's time zone.","in":"query","name":"scheduledRoomMoveStartTime","required":false,"schema":{"maxLength":8,"minLength":0,"pattern":"([0-1]?[0-9]|2[0-3]):[0-5][0-9]","type":"string"}},{"description":"End of Scheduled Move Room Time Range Criteria (in 24 hour time format). Applicable when Search Type is ScheduledRoomMove. Uses the hotel's time zone.","in":"query","name":"scheduledRoomMoveEndTime","required":false,"schema":{"maxLength":8,"minLength":0,"pattern":"([0-1]?[0-9]|2[0-3]):[0-5][0-9]","type":"string"}},{"description":"Scheduled Move Room Status Criteria.","in":"query","name":"scheduledRoomMoveStatus","required":false,"schema":{"enum":["Completed","Pending"],"type":"string","uniqueItems":true}},{"description":"When this flag is set to true, it will exclude the linked reservations which are marked as Back to Back in the result. Marking reservations as Back to Back is available when the Back to Back Handling for Linked Reservations OPERA control is active.","in":"query","name":"excludeBackToBackReservations","required":false,"schema":{"type":"boolean"}},{"description":"This indicates who initiated the Check In/Advance Check In.Advance Check In functionality is available when the Advance Check In OPERA Control is active.","in":"query","name":"checkInInitiatedBy","required":false,"schema":{"type":"string"}},{"description":"Search by User Defined Character Field. Available to be used when searchType = Arrival, Arrived, InHouse, Departure or CheckedOut. Format for searching by User Defined Character field is UDFCXX:\u003cSEARCH CRITERIA\u003e. For example to search for reservations with the value 'Test123' in UDFC01 field use the value UDFC01:Test123","explode":false,"in":"query","name":"flexChar","required":false,"schema":{"items":{"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Search by User Defined Number Field. Available to be used when searchType = Arrival, Arrived, InHouse, Departure or CheckedOut. Format for searching by User Defined Number field is UDFNXX:\u003cSEARCH CRITERIA\u003e. For example to search for reservations with the value '123' in UDFN01 field use the value UDFN01:123","explode":false,"in":"query","name":"flexNum","required":false,"schema":{"items":{"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Search by User Defined Date Field. Available to be used when searchType = Arrival, Arrived, InHouse, Departure or CheckedOut. Format for searching by User Defined Date field is UDFDXX:\u003cYYYY-MM-DD\u003e. For example to search for reservations with a date of December 31, 2024 as a value in UDFD01 field use the value 'UDFD01:2024-12-31'.","explode":false,"in":"query","name":"flexDate","required":false,"schema":{"items":{"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Provide a package category code to return details for packages belonging to the specified category.","in":"query","name":"pkgCategoryToFetch","required":false,"schema":{"type":"string"}},{"description":"Forecasted package consumption date for which package details are to be returned. When used,  the details of packages with a forecasted consumption date equal to the specified date will be returned for each reservation. Required if pkgCategoryToFetch is used.","in":"query","name":"pkgForecastedConsumptionDateToFetch","required":false,"schema":{"format":"date","type":"string"}},{"description":"Itinerary leg number filter; must be used with ConfirmationNumberList.","in":"query","name":"itineraryLeg","required":false,"schema":{"type":"integer"}},{"description":"Fetch only reservations that are pre-registered.","in":"query","name":"preRegisteredOnly","required":false,"schema":{"type":"boolean"}},{"description":"When set to true, the search will include results that are similar matches based on fields such as surname, givenName, and email. All other specified search criteria will still be applied to the similar results. Set to false to restrict results to only exact matches.","in":"query","name":"similaritySearch","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether to include Pre-Arrival Reservations that are currently in a Reviewed status.","in":"query","name":"includeReviewedPreArrivals","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationsDetails"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservations for a hotel","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getHotelRevenue","method":"GET","path":"/api/v1/finance/hotel-revenue","summary":"Get hotel revenue","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["businessDate"],"contract":{"operationId":"getHotelRevenue","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel revenue","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getLinkedReservations","method":"GET","path":"/api/v1/reservations/{reservationID}/linked","summary":"Get linked Reservations ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["additionalReservationId","additionalReservationIdType","fetchInstructions"],"contract":{"description":"Get linked Reservations for given Reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetLinkedReservations\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getLinkedReservations","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"additionalReservationId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"additionalReservationIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Instruction to fetch whether the room was assigned/upgraded by AI. This will also include Reservation instruction.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","Comments","GuestComments","Packages","InventoryItems","ReservationPaymentMethods","RoutingInstructions","Preferences","Memberships","Alerts","Traces","ConfirmationLetters","CallHistory","FixedCharges","GuestMessages","ReservationPolicies","Indicators","LinkedReservations","RevenuesAndBalances","GuestLastStay","ECoupons","TrackItItems","TotalCostOfStay","ReservationAwards","WebRegistrationCards","ServiceRequests","ReservationActivities","ScheduledActivities","PrepaidCards","Shares","Attachments","Locators","ProfileAwards","TransactionDiversions","Tickets","GuestMemberships","ECertificates","UpsellInfo","RoomAssignedByAI","CustomNameValue","CustomChargeExemptions"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_linkedHotelReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get linked Reservations ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getLinkedReservationsSummary","method":"GET","path":"/api/v1/reservations/{reservationID}/linked-summary","summary":"Get Reservation summary for linked Reservation","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["additionalReservationId","additionalReservationIdType","backToBackOnly","excludeCancelledReservations","excludeNoShowReservations","limit"],"contract":{"description":"Get Reservation summary for linked Reservation of given Reservation id. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetLinkedReservationsSummary\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getLinkedReservationsSummary","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"additionalReservationId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"additionalReservationIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Indicates that only reservations marked as Back to Back should be expected in the result. Returned linked Back to Back reservations will belong to the same group of linked Back to Back reservations as the specified reservation with the given reservation name id and hotel code.","in":"query","name":"backToBackOnly","required":false,"schema":{"type":"boolean"}},{"description":"When true indicates that linked reservations with Cancelled status should not be included in search results.","in":"query","name":"excludeCancelledReservations","required":false,"schema":{"type":"boolean"}},{"description":"When true indicates that linked reservations with NoShow status should not be included in search results.","in":"query","name":"excludeNoShowReservations","required":false,"schema":{"type":"boolean"}},{"description":"Indicates maximum number of records this Web Service should return. Minimum is 0. Default is 200.","in":"query","name":"limit","required":false,"schema":{"default":200,"minimum":0,"type":"integer"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_linkedReservationsInfo"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation summary for linked Reservation","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getManagerReportDetailsLOV","method":"GET","path":"/api/v1/reports/lov/manager-details","summary":"经理报表明细选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for manager report details for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetManagerReportDetailsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getManagerReportDetailsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"经理报表明细选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getManagersReportsLOV","method":"GET","path":"/api/v1/reports/lov/managers","summary":"经理报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for manager reports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetManagersReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getManagersReportsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"经理报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getMarketCodes","method":"GET","path":"/api/v1/codes/markets","summary":"Get hotel Market Codes","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["limit","pageNumber","marketCodes","marketGroupsCodes","includeInactive"],"contract":{"operationId":"getMarketCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel Market Codes","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSVCFG"}},{"operation_id":"getMarketGroups","method":"GET","path":"/api/v1/config/reservations/market-groups","summary":"市场分组 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["limit","pageNumber","marketCodes","marketGroupsCodes","includeInactive"],"contract":{"operationId":"getMarketGroups","parameters":[{"explode":true,"in":"query","name":"limit","required":false,"schema":{"type":"integer"},"style":"form"},{"explode":true,"in":"query","name":"pageNumber","required":false,"schema":{"type":"integer"},"style":"form"},{"explode":true,"in":"query","name":"marketCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"marketGroupsCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"includeInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场分组 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"hotel","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/rsv/config/v1/marketGroups","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"getNextBlockStatus","method":"GET","path":"/api/v1/blocks/next-status","summary":"查询当前状态可转入的团队状态","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved blocks.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"query_names":["currentStatus","includeCateringStatus"],"contract":{"description":"Use this API to retrieve next set of statuses and their next statuses for the current status passed in the request. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetNextBlockStatus\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Native 204 is represented by HTTP 200 with upstream_status=204 and data={}. No automatic pagination.Hotel/current-status query, not validation of an individual block. Distinct from getNextBlockStatusCodes configuration.","operationId":"getNextBlockStatus","parameters":[{"description":"Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.","in":"query","name":"currentStatus","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Flag to include catering next status.","in":"query","name":"includeCateringStatus","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/booking_blk_nextBlockStatus"}},"type":"object"}]}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询当前状态可转入的团队状态","x-capability-group":"blocks.read","x-fixed-hotel-query":"hotelId","x-integration":{"pattern":"sync-read","prerequisites":["Approved blocks.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"x-oracle-api":"BLK","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/blk.json"}},{"operation_id":"getNextBlockStatusCodes","method":"GET","path":"/api/v1/config/blocks/block-status-codes/next-status-codes","summary":"团队房状态流转 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["configuredOnly","blockStatusCodes"],"contract":{"operationId":"getNextBlockStatusCodes","parameters":[{"explode":true,"in":"query","name":"configuredOnly","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"blockStatusCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态流转 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/blockStatusCodes/nextStatusCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getOperaSettings","method":"GET","path":"/api/v1/config/opera-settings","summary":"查询 OPERA Controls","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"query_names":["cROCode","parameterNameWildCard"],"contract":{"description":"Use this API to return OPERA controls based on search criteria such as hotelId, cROCode, parameterNameWildCard. OPERA Controls determine the functionality, behavior and defaults for OPERA Cloud. The functions, parameters and settings available are determined by the Cloud Service subscriptions.\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Native 204 is represented by HTTP 200 with upstream_status=204 and data={}. No automatic pagination.","operationId":"getOperaSettings","parameters":[{"description":"This is the Central Reservation office code.","in":"query","name":"cROCode","required":false,"schema":{"maxLength":200,"type":"string"}},{"description":"Wildcard search parameter.","in":"query","name":"parameterNameWildCard","required":false,"schema":{"maxLength":4000,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/booking_entcfg_operaSettingsDetails"}},"type":"object"}]}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询 OPERA Controls","x-capability-group":"configuration.read","x-fixed-hotel-query":"hotelId","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"x-oracle-api":"ENTCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/entcfg.json"}},{"operation_id":"getPackage","method":"GET","path":"/api/v1/reservations/{reservationID}/packages","summary":"Get Package","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["postingRhythm","productCode","ratePlanCode","reservationTimeSpanStartDate","reservationTimeSpanEndDate","packageTimeSpanStartDate","packageTimeSpanEndDate","packageQuantity","packageExcludedQuantity","reservationAdults","reservationChildren","fetchInstructions"],"contract":{"description":"Get the package availability for a hotel code and reservation id \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetPackage\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getPackage","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"in":"query","name":"postingRhythm","required":false,"schema":{"type":"string"}},{"in":"query","name":"productCode","required":true,"schema":{"type":"string"}},{"in":"query","name":"ratePlanCode","required":false,"schema":{"type":"string"}},{"in":"query","name":"reservationTimeSpanStartDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"reservationTimeSpanEndDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"packageTimeSpanStartDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"packageTimeSpanEndDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"packageQuantity","required":false,"schema":{"type":"integer"}},{"in":"query","name":"packageExcludedQuantity","required":false,"schema":{"type":"integer"}},{"description":"Defines the number of Adults.","in":"query","name":"reservationAdults","required":false,"schema":{"type":"integer"}},{"description":"Defines the number of Children.","in":"query","name":"reservationChildren","required":false,"schema":{"type":"integer"}},{"description":"Simple type for package instructions that can be used in requests for partial operations.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Primary","Transaction","Classification","Schedule","InventoryItems"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_packages"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Package","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getPaymentMethods","method":"GET","path":"/api/v1/reservations/{reservationID}/payment-methods","summary":"Get a payment method ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeAmounts"],"contract":{"description":"This API will return the payment method(s) that exist on a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetPaymentMethods\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getPaymentMethods","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Flag to notify the operation to also retrieve the outstanding balance, current authorized amount and amount needed to be approved for each folio.","in":"query","name":"includeAmounts","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationPaymentMethods"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get a payment method ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getPaymentMethodsLOV","method":"GET","path":"/api/v1/codes/payment-methods","summary":"Get hotel Payment Method values","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"operationId":"getPaymentMethodsLOV","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel Payment Method values","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"LOV"}},{"operation_id":"getPostingSummary","method":"GET","path":"/api/v1/finance/posting-summary","summary":"Get Posting Summary","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["includeGenerates","postingDate","checkPostings","postingsByExternalSystem","cashierId","currency","postingSummaryType"],"contract":{"operationId":"getPostingSummary","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Posting Summary","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getPreArrivalMemberReservations","method":"GET","path":"/api/v1/reservations/pre-arrival-members","summary":"Get preArrival Member Reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["end","start","membershipType","externalReferenceType"],"contract":{"description":"Get preArrival Member Reservations. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetPreArrivalMemberReservations\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getPreArrivalMemberReservations","parameters":[{"description":"The ending value of the date range.","in":"query","name":"end","required":false,"schema":{"format":"date","type":"string"}},{"description":"The starting value of the date range.","in":"query","name":"start","required":false,"schema":{"format":"date","type":"string"}},{"description":"Membership Type.","in":"query","name":"membershipType","required":false,"schema":{"type":"string"}},{"description":"Type of the desired reservation external confirmation number.","in":"query","name":"externalReferenceType","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_preArrivalMemberReservationsDetails"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get preArrival Member Reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getPreConfiguredRoutingInstructions","method":"GET","path":"/api/v1/reservations/preconfigured-routing-instructions","summary":"Get pre-Configured Routing Instructions","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["rateCode","promotionCodes","guestName","guestIds","companyName","companyIds","groupName","groupIds","travelAgentName","travelAgentIds","sourceName","sourceIds","contactName","contactIds","billingContactName","billingContactIds","addresseeName","addresseeIds","reservationId"],"contract":{"deprecated":true,"description":"Get preConfigured Routing Instructions. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetPreConfiguredRoutingInstructions\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getPreConfiguredRoutingInstructions","parameters":[{"in":"query","name":"rateCode","required":false,"schema":{"type":"string"}},{"description":"Promotion Code for ComplimentaryRouting","explode":true,"in":"query","name":"promotionCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"guestName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"guestIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"companyName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"companyIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"groupName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"groupIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"travelAgentName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"travelAgentIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"sourceName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"sourceIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"contactName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"contactIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"billingContactName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"billingContactIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Attached profile name","in":"query","name":"addresseeName","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"addresseeIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"query","name":"reservationId","required":false,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_preConfiguredRoutingInstructions"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get pre-Configured Routing Instructions","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getProfile","method":"GET","path":"/api/v1/profiles/{profileID}","summary":"Get a profile by OPERA ID","capability_group":"profiles.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"getProfile","parameters":[{"$ref":"#/components/parameters/ProfileID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get a profile by OPERA ID","x-capability-group":"profiles.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CRM"}},{"operation_id":"getProfileAging","method":"GET","path":"/api/v1/finance/ar/profiles/{profileID}/aging","summary":"Get profile aging detail","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["currency"],"contract":{"operationId":"getProfileAging","parameters":[{"$ref":"#/components/parameters/ProfileID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get profile aging detail","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getProfileRelationships","method":"GET","path":"/api/v1/profiles/{profileID}/relationships","summary":"查询客档关系","capability_group":"profiles.read","integration":{"pattern":"sync-read","prerequisites":["Approved profiles.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"query_names":["relationshipPrimaryProfile"],"contract":{"description":" \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetProfileRelationships\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Native 204 is represented by HTTP 200 with upstream_status=204 and data={}. No automatic pagination.","operationId":"getProfileRelationships","parameters":[{"in":"path","name":"profileID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Type of Profile to be fetched from OPERA.","in":"query","name":"relationshipPrimaryProfile","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/booking_crm_profileRelationships"}},"type":"object"}]}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询客档关系","x-capability-group":"profiles.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved profiles.read capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Bounded read retries; honor Retry-After"},"x-oracle-api":"CRM","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/crm.json"}},{"operation_id":"getProfiles","method":"GET","path":"/api/v1/profiles","summary":"Search profiles with allowlisted query fields","capability_group":"profiles.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["excludeInactive","limit","offset","searchType","summaryInfo","searchString","profileType","profileIds","externalReferenceIds","externalSystemCodes","corporateIds","profileName","givenName","city","postalCode","state","countryCode","streetAddress","keyword","communication","membership","membershipType","ownerCodes","membershipLevel","aRNumber","businessSegment","accountsReceivables","corporateProfiles","excludeIncompleteProfiles","negotiatedRates","fetchInstructions","vipCodes","phone","email","lastStayBefore"],"contract":{"operationId":"getProfiles","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search profiles with allowlisted query fields","x-capability-group":"profiles.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CRM","x-sensitive-query-fields-excluded":["birthDate","taxID","identificationNo"]}},{"operation_id":"getRateInfo","method":"GET","path":"/api/v1/reservations/rate-info","summary":"查询预订房价信息（Oracle 已弃用，优先使用 searchRateInfo）","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read application capability","Oracle query span at most 21 days; split larger ranges explicitly in consuming code"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"query_names":["currencyCode","summaryInfo","criteriaStartDate","criteriaEndDate","adults","children","childAge","bucket1Count","bucket2Count","bucket3Count","bucket4Count","bucket5Count","detailDate","blockId","blockIdType","id","idExtension","idContext","type","ratePlanCode","effectiveRateEnd","effectiveRateStart","roomType"],"contract":{"deprecated":true,"description":"Oracle GET /rsv/v1/hotels/{hotelId}/reservations/rateInfo. Read-only reservation rate lookup; Oracle limits the requested time span to 21 days and validates criteria and value types. Prefer searchRateInfo for new integrations; GET getRateInfo is deprecated upstream. Only the configured hotel is used. Oracle 204 becomes HTTP 200 with data: {}. Returned Oracle fields are provisional until customer UAT.","operationId":"getRateInfo","parameters":[{"description":"The code specifying a monetary unit. Use ISO 4217, three alpha code.","in":"query","name":"currencyCode","required":false,"schema":{"type":"string"}},{"description":"Flag to indicate if summary information is required.","in":"query","name":"summaryInfo","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"criteriaStartDate","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"criteriaEndDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Defines the number of Adults.","in":"query","name":"adults","required":false,"schema":{"type":"integer"}},{"description":"Defines the number of Children.","in":"query","name":"children","required":false,"schema":{"type":"integer"}},{"description":"Age of a child in years.","explode":true,"in":"query","name":"childAge","required":false,"schema":{"items":{"type":"integer"},"type":"array"},"style":"form"},{"description":"Number of children classified under the first Age Qualifying Group(Child Bucket#1).","in":"query","name":"bucket1Count","required":false,"schema":{"type":"integer"}},{"description":"Number of children classified under the second Age Qualifying Group(Child Bucket#2).","in":"query","name":"bucket2Count","required":false,"schema":{"type":"integer"}},{"description":"Number of children classified under the third Age Qualifying Group(Child Bucket#3).","in":"query","name":"bucket3Count","required":false,"schema":{"type":"integer"}},{"description":"Number of children classified under the fourth Age Qualifying Group(Child Bucket#4).","in":"query","name":"bucket4Count","required":false,"schema":{"type":"integer"}},{"description":"Number of children classified under the fifth Age Qualifying Group(Child Bucket#5).","in":"query","name":"bucket5Count","required":false,"schema":{"type":"integer"}},{"description":"This field is only required when the criteria is meant for a detailed results. The date for the rate detail is needed.","in":"query","name":"detailDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"blockId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"blockIdType","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"id","required":false,"schema":{"type":"string"}},{"description":"Additional identifying value assigned by the creating system.","in":"query","name":"idExtension","required":false,"schema":{"type":"integer"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"type","required":false,"schema":{"type":"string"}},{"description":"Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.","in":"query","name":"ratePlanCode","required":false,"schema":{"type":"string"}},{"description":"The ending value of the date range.","explode":true,"in":"query","name":"effectiveRateEnd","required":false,"schema":{"items":{"format":"date","type":"string"},"type":"array"},"style":"form"},{"description":"The starting value of the date range.","explode":true,"in":"query","name":"effectiveRateStart","required":false,"schema":{"items":{"format":"date","type":"string"},"type":"array"},"style":"form"},{"description":"Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.","in":"query","name":"roomType","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rate_rsv_rateInfo"}},"type":"object"}]}}},"description":"Bounded Oracle rate information; data is an empty object when Oracle returns 204.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询预订房价信息（Oracle 已弃用，优先使用 searchRateInfo）","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read application capability","Oracle query span at most 21 days; split larger ranges explicitly in consuming code"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getRatePlan","method":"GET","path":"/api/v1/rate-plans/{ratePlanCode}","summary":"Get one Rate Plan","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["fetchInstructions"],"contract":{"operationId":"getRatePlan","parameters":[{"$ref":"#/components/parameters/RatePlanCode"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get one Rate Plan","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RTP"}},{"operation_id":"getRatePlansByHotel","method":"GET","path":"/api/v1/rate-plans","summary":"Get Rate Plans for the configured hotel","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["ratePlanCode","postingInterval","fetchInstructions"],"contract":{"operationId":"getRatePlansByHotel","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Rate Plans for the configured hotel","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RTP"}},{"operation_id":"getRepGroupReportsLOV","method":"GET","path":"/api/v1/reports/lov/groups/{groupName}/reports","summary":"报表分组内的报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for rep group reports based on search criteria such as groupName, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetRepGroupReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getRepGroupReportsLOV","parameters":[{"description":"Value of the parameter 'groupName' which is required to fetch RepGroupReports LOV","in":"path","name":"groupName","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"报表分组内的报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getReportParameters","method":"GET","path":"/api/v1/reports/parameters","summary":"读取报表参数定义","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["id","idContext","type"],"contract":{"description":"Use this API to return report parameters based on search criteria such as id, idContext, type. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReportParameters\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getReportParameters","parameters":[{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"id","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT).","in":"query","name":"type","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_repcfg_reportParameters"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"读取报表参数定义","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"REPCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/repcfg.json"}},{"operation_id":"getReports","method":"GET","path":"/api/v1/reports","summary":"查询报表","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["excludeGroup","includeInternalReports","includeRnAReports","includeUnpublished","includeWatermarkDetails","limit","multiPropertyOnly","protectedReportParam","scheduled","name","group","id","idContext","type"],"contract":{"description":"Use this API to return reports based on search criteria such as excludeGroup, includeInternalReports, includeRnAReports, includeUnpublished, includeWatermarkDetails, limit, multiPropertyOnly, protectedReportParam, scheduled, name, group, hotel, id, idContext, type. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReports\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getReports","parameters":[{"description":"Indicates whether a report group should be excluded","in":"query","name":"excludeGroup","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"Indicates whether sample internal reports are to be included","in":"query","name":"includeInternalReports","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether RnA reports are to be included","in":"query","name":"includeRnAReports","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether protected reports should be included","in":"query","name":"includeUnpublished","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether the watermark details is to be populated. This is needed only for the configuration and not for the actual execution.","in":"query","name":"includeWatermarkDetails","required":false,"schema":{"type":"boolean"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Indicates whether the result set should only include multi-property reports.","in":"query","name":"multiPropertyOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicates whether protected reports should be included","in":"query","name":"protectedReportParam","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only reports that can be scheduled are included","in":"query","name":"scheduled","required":false,"schema":{"type":"boolean"}},{"description":"Partial report name or description to search.","in":"query","name":"name","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"Report group to limit search.","in":"query","name":"group","required":false,"schema":{"maxLength":2000,"minLength":0,"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"id","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","in":"query","name":"idContext","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT).","in":"query","name":"type","required":false,"schema":{"maxLength":80,"minLength":0,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_repcfg_reports"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询报表","x-capability-group":"configuration.read","x-fixed-hotel-query":"hotel","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"REPCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/repcfg.json"}},{"operation_id":"getReportsGenericLOV","method":"GET","path":"/api/v1/reports/lov/modules/{moduleId}/parameters/{parameter}","summary":"读取报表参数可选值","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for generic reports based on search criteria such as parameter, moduleId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReportsGenericLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getReportsGenericLOV","parameters":[{"description":"Value of the parameter 'parameter' which is required to fetch ReportsGeneric LOV","in":"path","name":"parameter","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Value of the parameter 'moduleId' which is required to fetch ReportsGeneric LOV","in":"path","name":"moduleId","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"读取报表参数可选值","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getResStatReportRateCodeLOV","method":"GET","path":"/api/v1/reports/lov/reservation-statistics/{beginDate}/{endDate}/rate-codes","summary":"预订统计报表价码选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for report rate codes for a specific property based on search criteria such as endDate, beginDate, hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetResStatReportRateCodeLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getResStatReportRateCodeLOV","parameters":[{"description":"Value of the parameter 'endDate' which is required to fetch ResStatReportRateCode LOV","in":"path","name":"endDate","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Value of the parameter 'beginDate' which is required to fetch ResStatReportRateCode LOV","in":"path","name":"beginDate","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订统计报表价码选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getReservation","method":"GET","path":"/api/v1/reservations/{reservationID}","summary":"Get a reservation by OPERA ID","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["profileExternalReferencesToFetch","fetchInstructions","allowedActions"],"contract":{"operationId":"getReservation","parameters":[{"$ref":"#/components/parameters/ReservationID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get a reservation by OPERA ID","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSV"}},{"operation_id":"getReservationActivityLog","method":"GET","path":"/api/v1/reservations/activity-log","summary":"Fetch Reservation Activity Log","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","offset","parameterName","parameterValue","activityGroup","activityType","fromDate","toDate","searchText","userByIdsUserId","userForIdsUserId"],"contract":{"description":"Get the activity log for a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationActivityLog\u003c/p\u003e \u003cp\u003eThis API allows a time span of \u003cstrong\u003e90\u003c/strong\u003e days.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationActivityLog","parameters":[{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"in":"query","name":"activityGroup","required":false,"schema":{"type":"string"}},{"in":"query","name":"activityType","required":false,"schema":{"type":"string"}},{"description":"Search from date for the user activity log.","in":"query","name":"fromDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Search to date for the user activity log.","in":"query","name":"toDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Search text for the user activity log.","in":"query","name":"searchText","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"userByIdsUserId","required":false,"schema":{"items":{"type":"integer"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"userForIdsUserId","required":false,"schema":{"items":{"type":"integer"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_activityLog"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Fetch Reservation Activity Log","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationAttachments","method":"GET","path":"/api/v1/reservations/{reservationID}/attachments","summary":"Get Reservation attachments","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["webRegistrationCard","attachedFileName","description","digitalRegistration"],"contract":{"description":"Get Reservation attachments \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationAttachments\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationAttachments","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Indicator to retrieve e-Signed registration card attachments.","in":"query","name":"webRegistrationCard","required":false,"schema":{"type":"boolean"}},{"description":"File name used to filter final list of attachments. For example, Document.txt.","in":"query","name":"attachedFileName","required":false,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Description used to filter final list of attachments. For example, Offical guest ID. (This parameter does not require wildcard characters like * or % ).","in":"query","name":"description","required":false,"schema":{"maxLength":100,"minLength":1,"type":"string"}},{"description":"Indicator to retrieve digital registration attachments.","in":"query","name":"digitalRegistration","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationAttachments"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation attachments","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationByExtId","method":"GET","path":"/api/v1/external-systems/{externalSystemCode}/reservations/{reservationExternalID}","summary":"Get Reservation by external ID","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["profileExternalReferencesToFetch","fetchInstructions","allowedActions"],"contract":{"description":"Retrieve a reservation using the external ID. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationByExtId\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationByExtId","parameters":[{"description":"Code to identify the external system from which the request is coming. This is the ExternalSystem ID used to exchange information between OPERA and the external system.","in":"path","name":"externalSystemCode","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"External reservation Id.","in":"path","name":"reservationExternalID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Define the external system(s) to return external reference ids for associated profiles for the reservation. A maximum of 10 different external systems can be be provided for this parameter.","explode":true,"in":"query","name":"profileExternalReferencesToFetch","required":false,"schema":{"items":{"type":"string"},"maxItems":10,"type":"array"},"style":"form"},{"description":"Instruction on which of the reservation's elements are to be returned e.g. DailySummary will return summarized information for each day of the reservation. Instructions are cumulative i.e. if multiple instructions are sent in a request, then the combined reservation elements would be returned, elements will not be duplicated in the response.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","Comments","GuestComments","Packages","TotalCostOfStay","InventoryItems","ReservationPaymentMethods","RoutingInstructions","Preferences","Memberships","Alerts","Traces","ConfirmationLetters","CallHistory","FixedCharges","GuestMessages","ReservationPolicies","Indicators","LinkedReservations","RevenuesAndBalances","GuestLastStay","ECoupons","TrackItItems","ReservationAwards","WebRegistrationCards","ReservationActivities","ScheduledActivities","PrepaidCards","Shares","Attachments","Locators","ProfileAwards","TransactionDiversions","Tickets","GuestMemberships","ECertificates","UpsellInfo","RoomAssignedByAI","DailySummary","OffshoreRates","PostingIntervals","AgeThresholds"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Flag indicating whether the Enrollment is in progress or not for the Profile associated with this Reservation.","explode":true,"in":"query","name":"allowedActions","required":false,"schema":{"items":{"enum":["Cancel","Move","PreCharge","PostCharge","FacilitySchedule","Upsell","PreCheckIn","PostToNoShowCancel","NoShow","NameChange","Discount","HouseKeeping","EnrollToPrimaryMembership","EnrollInProgress"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservation"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation by external ID","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationLocators","method":"GET","path":"/api/v1/reservations/{reservationID}/guest-locators","summary":"Fetch Reservation Guest Locator","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"Get the Guest locater for a Reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationLocators\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationLocators","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationLocators"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Fetch Reservation Guest Locator","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationMethods","method":"GET","path":"/api/v1/config/blocks/reservation-methods","summary":"团队房预订方式 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["fetchInactive","codes","wildCard","description"],"contract":{"operationId":"getReservationMethods","parameters":[{"explode":true,"in":"query","name":"fetchInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"explode":true,"in":"query","name":"codes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"wildCard","required":false,"schema":{"type":"string"},"style":"form"},{"explode":true,"in":"query","name":"description","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房预订方式 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"chain","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/blk/config/v1/reservationMethods","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"getReservationPolicies","method":"GET","path":"/api/v1/reservations/{reservationID}/policies","summary":"Get Reservation Policies","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["fetchDepositPolicies","fetchCancellationPolicies"],"contract":{"description":"This API will retrieve the reservation policies for a specified reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationPolicies\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationPolicies","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"A flag which instructs whether the deposit policies needs to be fetched.","in":"query","name":"fetchDepositPolicies","required":false,"schema":{"type":"boolean"}},{"description":"A flag which instructs whether the cancel policies needs to be fetched.","in":"query","name":"fetchCancellationPolicies","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationPolicies"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation Policies","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationPreference","method":"GET","path":"/api/v1/reservations/{reservationID}/preferences","summary":"Get Reservation Preferences","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["preferenceTypeCode"],"contract":{"description":"You can use this API to retrieve the preferences that exist on a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationPreference\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationPreference","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"explode":true,"in":"query","name":"preferenceTypeCode","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationPreference"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation Preferences","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationRevenueBucketTotals","method":"GET","path":"/api/v1/finance/reservations/{reservationID}/revenue","summary":"Get reservation revenue bucket totals","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["idContext","type","revenueBucketType","compRevenue"],"contract":{"operationId":"getReservationRevenueBucketTotals","parameters":[{"$ref":"#/components/parameters/ReservationID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get reservation revenue bucket totals","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CSH"}},{"operation_id":"getReservationUpsellInfo","method":"GET","path":"/api/v1/reservations/{reservationID}/upsell","summary":"Get available Upsell offers","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"Use this API to retrieve the available upsell offers for a specific reservation. If no upsell options are configured for this hotel or available for this reservation, an appropriate error will be returned. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationUpsellInfo\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationUpsellInfo","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationUpsellInfo"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get available Upsell offers","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationsByPackage","method":"GET","path":"/api/v1/reservations/package-category","summary":"Get Reservations by pacakge and consumption date","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["packageCategory","packageCode","date","limit","offset"],"contract":{"description":"Use this API to get reservations with package consumption for a specific date. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationsByPackage\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationsByPackage","parameters":[{"description":"Package Category of the package attached to the reservation. Reserved for future development.","explode":true,"in":"query","name":"packageCategory","required":false,"schema":{"items":{"maxItems":20,"type":"string"},"type":"array"},"style":"form"},{"description":"Package code of the package attached to the reservation","explode":true,"in":"query","name":"packageCode","required":false,"schema":{"items":{"maxItems":20,"type":"string"},"type":"array"},"style":"form"},{"description":"Forecasted package consumption date","in":"query","name":"date","required":true,"schema":{"format":"date","type":"string"}},{"description":"Indicated maximum number of reservations to be sent in the response","in":"query","name":"limit","required":false,"schema":{"default":30,"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_packageCategoryReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservations by pacakge and consumption date","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationsDailySummary","method":"GET","path":"/api/v1/reservation-daily-summary-jobs/{jobID}","summary":"Get Reservation Daily Summary results","capability_group":"reservations.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"operationId":"getReservationsDailySummary","parameters":[{"$ref":"#/components/parameters/JobID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservation Daily Summary results","x-capability-group":"reservations.async","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"RSVASYNC"}},{"operation_id":"getReservationsProcessStatus","method":"GET","path":"/api/v1/reservation-daily-summary-jobs/{jobID}/status","summary":"Check Reservation Daily Summary process status","capability_group":"reservations.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"operationId":"getReservationsProcessStatus","parameters":[{"$ref":"#/components/parameters/JobID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatus"}}},"description":"Current Oracle process status.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}},"Retry-After":{"description":"Seconds from Oracle Cache-Control max-age before polling again, when supplied.","schema":{"type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Check Reservation Daily Summary process status","x-capability-group":"reservations.async","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"RSVASYNC"}},{"operation_id":"getReservationsSummary","method":"GET","path":"/api/v1/reservations/summary","summary":"Get brief summary for Reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["advancedCheckedIn","limit","offset","preRegistered","arrivalDate","departureDate","createDateTime","cancelledOn","folioClosedOn","lastName","companyId","guestNameId","reservationStatus","confirmationNumber","externalReferenceNumber","cancellationNumber","membershipNumber","registeredCardNumber","balance","roomId"],"contract":{"deprecated":true,"description":"\u003cp\u003eThis operation fetches brief summary for the reservations and also supports the Global Parameter \u003cstrong\u003eMAX ROWS FETCH COUNT\u003c/strong\u003e.\u003cbr\u003eBy default this parameter is configured to support an overall fetch of \u003cstrong\u003e5000\u003c/strong\u003e Records in total, with maximum number of records that can be fetched at a time being \u003cstrong\u003e200\u003c/strong\u003e (limit). However, this parameter can be updated to support an overall fetch value being a valid number between \u003cstrong\u003e1\u003c/strong\u003e and \u003cstrong\u003e10000\u003c/strong\u003e with maximum number of records that can be fetched at a time being same i.e. \u003cstrong\u003e200\u003c/strong\u003e (limit).\u003c/p\u003e\u003cp\u003eRequests with an \u003cstrong\u003eoffset\u003c/strong\u003e and \u003cstrong\u003elimit\u003c/strong\u003e sum exceeding the \u003cstrong\u003eMAX ROWS FETCH COUNT\u003c/strong\u003e configured would fail the request.\u003c/p\u003e \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationsSummary\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationsSummary","parameters":[{"description":"This filter indicates if the reservation(s) has performed an Advance Check-In or not. Data fetched is for 30 days ahead of business date.","in":"query","name":"advancedCheckedIn","required":false,"schema":{"type":"boolean"}},{"description":"This filter indicates number of records the API has to fetch.","in":"query","name":"limit","required":false,"schema":{"default":"200","type":"integer"}},{"description":"This filter is for the index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"This filter indicates whether the reservation is Pre-Registered for Internet Check-In or not. Data fetched is for 30 days ahead of business date.","in":"query","name":"preRegistered","required":false,"schema":{"type":"boolean"}},{"description":"This filter is for the date of arrival of reservation.","in":"query","name":"arrivalDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"This filter is for the date of departure of reservation.","in":"query","name":"departureDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"This filter is for the business date when reservation(s) was created in the system.","in":"query","name":"createDateTime","required":false,"schema":{"format":"date","type":"string"}},{"description":"This filter is for the date when reservation(s) was cancelled.","in":"query","name":"cancelledOn","required":false,"schema":{"format":"date","type":"string"}},{"description":"This filter is for the date when reservation(s) folio was closed.","in":"query","name":"folioClosedOn","required":false,"schema":{"format":"date","type":"string"}},{"description":"This filter looks up reservations with this last Name. Data fetched is for +-2 business date only when passed alone.","in":"query","name":"lastName","required":false,"schema":{"type":"string"}},{"description":"This filter is ID of the company used for the reservation. Data fetched is for +-2 business date only when passed alone.","in":"query","name":"companyId","required":false,"schema":{"type":"number"}},{"description":"This filter is ID of the guest.","in":"query","name":"guestNameId","required":false,"schema":{"type":"number"}},{"description":"This filter is computed reservation status of the reservation(s).","in":"query","name":"reservationStatus","required":false,"schema":{"enum":["Cancelled","CheckedOut","CheckedIn","DueIn","DueOut","InHouse","NoShow","WaitList"],"type":"string","uniqueItems":true}},{"description":"This filter is ID of confirmation for the reservation.","in":"query","name":"confirmationNumber","required":false,"schema":{"type":"string"}},{"description":"This filter is ID of external reference for the reservation.","in":"query","name":"externalReferenceNumber","required":false,"schema":{"type":"string"}},{"description":"This filter is ID of cancellation for the reservation.","in":"query","name":"cancellationNumber","required":false,"schema":{"type":"string"}},{"description":"This filter is used for looking up reservations with this membership number. Last Name is required along with membership number to filter the data.","in":"query","name":"membershipNumber","required":false,"schema":{"type":"string"}},{"description":"This filter is unique identifier of the registration card number. Last Name is required along with registration card number to filter the data.","in":"query","name":"registeredCardNumber","required":false,"schema":{"type":"string"}},{"description":"This filter checks reservations with balance amount greater than or equal to this amount. Departure date is required along with balance to filter the data.","in":"query","name":"balance","required":false,"schema":{"type":"number"}},{"description":"This filter is for room number.","in":"query","name":"roomId","required":false,"schema":{"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationsSummary"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get brief summary for Reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationsToShareByProfileId","method":"GET","path":"/api/v1/profiles/{profileID}/reservations/share-candidates","summary":"Get Reservations to share ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","superSearch","reservationGuestId","reservationGuestIdType","membershipId","membershipLevel","membershipType","surname","givenName","roomId","fetchInstructions"],"contract":{"deprecated":true,"description":"Get Reservations to share by profile id. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationsToShareByProfileId\u003c/p\u003e \u003cp\u003eThe maximum allowable limit for this API is \u003cstrong\u003e100\u003c/strong\u003e.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationsToShareByProfileId","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"profileID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Free form text field for searching all reservation fields","in":"query","name":"superSearch","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationGuestId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"reservationGuestIdType","required":false,"schema":{"type":"string"}},{"description":"Membership ID criteria.","in":"query","name":"membershipId","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"membershipLevel","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"membershipType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Family name, last name.","in":"query","name":"surname","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"givenName","required":false,"schema":{"type":"string"}},{"description":"Room number","in":"query","name":"roomId","required":false,"schema":{"type":"string"}},{"description":"Instruction to fetch whether the room was assigned/upgraded by AI. This will also include Reservation instruction.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","Comments","GuestComments","Packages","InventoryItems","ReservationPaymentMethods","RoutingInstructions","Preferences","Memberships","Alerts","Traces","ConfirmationLetters","CallHistory","FixedCharges","GuestMessages","ReservationPolicies","Indicators","LinkedReservations","RevenuesAndBalances","GuestLastStay","ECoupons","TrackItItems","TotalCostOfStay","ReservationAwards","WebRegistrationCards","ServiceRequests","ReservationActivities","ScheduledActivities","PrepaidCards","Shares","Attachments","Locators","ProfileAwards","TransactionDiversions","Tickets","GuestMemberships","ECertificates","UpsellInfo","RoomAssignedByAI","CustomNameValue","CustomChargeExemptions"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_fetchReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservations to share ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservationsToShareByReservationId","method":"GET","path":"/api/v1/reservations/{reservationID}/share-candidates","summary":"Get Reservations to share by Reservation id","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","superSearch","reservationGuestId","reservationGuestIdType","membershipId","membershipLevel","membershipType","surname","givenName","roomId","cancellationNumberList","externalReferenceIds","externalSystemCodes","confirmationNumberList","taRecordLocatorList","reservationStatuses","linkedName","fetchInstructions"],"contract":{"description":"Fetch the reservation that can be shared with an existing reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservationsToShareByReservationId\u003c/p\u003e \u003cp\u003eThe maximum allowable limit for this API is \u003cstrong\u003e100\u003c/strong\u003e.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservationsToShareByReservationId","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Free form text field for searching all reservation fields","in":"query","name":"superSearch","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationGuestId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"reservationGuestIdType","required":false,"schema":{"type":"string"}},{"description":"Membership ID criteria.","in":"query","name":"membershipId","required":false,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"membershipLevel","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"membershipType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Family name, last name.","in":"query","name":"surname","required":false,"schema":{"type":"string"}},{"description":"Given name, first name or names","in":"query","name":"givenName","required":false,"schema":{"type":"string"}},{"description":"Room number","in":"query","name":"roomId","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"cancellationNumberList","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"externalReferenceIds","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Used to identify the source of the identifier (e.g., IATA, ABTA).","explode":true,"in":"query","name":"externalSystemCodes","required":false,"schema":{"default":["External"],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"confirmationNumberList","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Travel Agent Record Locators List.","explode":true,"in":"query","name":"taRecordLocatorList","required":false,"schema":{"items":{"type":"string"},"maxItems":30,"type":"array"},"style":"form"},{"description":"Reservation status list for reservations search.","explode":true,"in":"query","name":"reservationStatuses","required":false,"schema":{"items":{"enum":["Cancelled","CheckedOut","CheckedIn","DueIn","DueOut","InHouse","NoShow","WaitList"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Name of the group of Linked Reservations to be searched.","in":"query","name":"linkedName","required":false,"schema":{"maxLength":50,"minLength":0,"type":"string"}},{"description":"Instruction to fetch whether the room was assigned/upgraded by AI. This will also include Reservation instruction.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","Comments","GuestComments","Packages","InventoryItems","ReservationPaymentMethods","RoutingInstructions","Preferences","Memberships","Alerts","Traces","ConfirmationLetters","CallHistory","FixedCharges","GuestMessages","ReservationPolicies","Indicators","LinkedReservations","RevenuesAndBalances","GuestLastStay","ECoupons","TrackItItems","TotalCostOfStay","ReservationAwards","WebRegistrationCards","ServiceRequests","ReservationActivities","ScheduledActivities","PrepaidCards","Shares","Attachments","Locators","ProfileAwards","TransactionDiversions","Tickets","GuestMemberships","ECertificates","UpsellInfo","RoomAssignedByAI","CustomNameValue","CustomChargeExemptions","IncludeAllReservations"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_fetchReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reservations to share by Reservation id","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getReservedInventoryItems","method":"GET","path":"/api/v1/reservations/{reservationID}/inventory-items","summary":"Get Reserved Inventory Items ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"Get the Inventory Items reserved for the Reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetReservedInventoryItems\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getReservedInventoryItems","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_inventoryItems"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Reserved Inventory Items ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getRoomCalendar","method":"GET","path":"/api/v1/reservations/room-calendar","summary":"Read room calendar and room move history","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access","Validate pagination/date boundary behavior in the target environment before claiming complete historical coverage"],"retry":"Read-only: bounded backoff for transient errors; honor Retry-After. Keep explicit page coordinates on retries; no automatic page traversal."},"query_names":["advanceCheckedIn","assignedRooms","componentRooms","connectingRoomsOnly","backToBackOnly","linkedReservationsOnly","linkedName","scheduledRoomMoveOnly","dueOut","endDate","isSortDescending","pageIndex","partiallyAssignedRooms","recordsPerPage","roomConditions","ownerRoomsOnly","ownerExclusiveOnly","sortingBy","includeRoomMoveHistory","includeComponentRoomBlockOutDates","startDate","unassignedRooms","roomId","roomType","roomClass","floor","roomFeature","roomStatus","smokingPreference","bedType","showRoomMoveSegments"],"contract":{"description":"Read the configured hotel room calendar, including checked-out records and room moves when Oracle returns them. Pass includeRoomMoveHistory=true and showRoomMoveSegments=true for history/segments. Optional segmentStartDateTime/segmentEndDateTime depend on Advance Daily Detail OPERA Control. Oracle documents a maximum span of 366 days, but does not specify inclusive/exclusive date endpoints, same-day zero-night coverage, pageIndex origin/default or recordsPerPage maximum in this pinned contract. Omit pageIndex on an initial discovery request; use returned pageIndex/recordsPerPage after environment verification. Pagination is by rooms, not reservations; totalRooms is not a reservation count. Edge does not fill defaults, paginate automatically, discard segments or choose an ARR display room. Preserve all matches by internal Reservation ID. Room schedule/dateTimeSpan timestamps use hotel time zone; roomMoveHistory.date uses database time zone; strings are unchanged. Oracle 204 becomes a 200 envelope with data {}.","operationId":"getRoomCalendar","parameters":[{"description":"If true, then filter room results to rooms with Advance Checked In Reservations.","in":"query","name":"advanceCheckedIn","required":false,"schema":{"type":"boolean"}},{"description":"If 'Y', then filter room results to rooms that are assigned to guest.","in":"query","name":"assignedRooms","required":false,"schema":{"type":"string"}},{"description":"If 'Y', then filter room results to component rooms.","in":"query","name":"componentRooms","required":false,"schema":{"type":"string"}},{"description":"If 'Y', then filter room results to only connecting rooms.","in":"query","name":"connectingRoomsOnly","required":false,"schema":{"type":"string"}},{"description":"Indicates that only reservations marked as Back to Back should be expected in the result.","in":"query","name":"backToBackOnly","required":false,"schema":{"type":"boolean"}},{"description":"Indicates that only linked reservations are expected in the result.","in":"query","name":"linkedReservationsOnly","required":false,"schema":{"type":"boolean"}},{"description":"Name of the group of Linked Reservations to be searched.","in":"query","name":"linkedName","required":false,"schema":{"maxLength":50,"minLength":0,"type":"string"}},{"description":"Indicates that only reservations having scheduled room moves should be expected in the result.","in":"query","name":"scheduledRoomMoveOnly","required":false,"schema":{"type":"boolean"}},{"description":"If 'Y', then filter room results to rooms with Due Out Reservations.","in":"query","name":"dueOut","required":false,"schema":{"type":"string"}},{"description":"The ending value of the date range.","in":"query","name":"endDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"If true, then fetch result will be sorted in descending order.","in":"query","name":"isSortDescending","required":false,"schema":{"type":"boolean"}},{"description":"Page index to be retrieved.","in":"query","name":"pageIndex","required":false,"schema":{"type":"integer"}},{"description":"If 'Y', then filter room results to component rooms that have at least one of its rooms assigned to guest.","in":"query","name":"partiallyAssignedRooms","required":false,"schema":{"type":"string"}},{"description":"Number of records per page.","in":"query","name":"recordsPerPage","required":false,"schema":{"type":"integer"}},{"description":"If 'Y', then filter room results to rooms with Room Conditions.","in":"query","name":"roomConditions","required":false,"schema":{"type":"string"}},{"description":"If 'Y', then filter room results to rooms with rotation rooms only. It is supported only if OPERA Control Room Rotation is active.","in":"query","name":"ownerRoomsOnly","required":false,"schema":{"type":"string"}},{"description":"If 'Y', then filter room results to rooms that are exclusive to the owner. It is supported only if OPERA Control Room Rotation is active.","in":"query","name":"ownerExclusiveOnly","required":false,"schema":{"type":"string"}},{"description":"A collection of supported sorting for room calendar.","in":"query","name":"sortingBy","required":false,"schema":{"enum":["Default","Room","RoomType","RoomStatus"],"type":"string","uniqueItems":true}},{"description":"Include Room Move History in result.","in":"query","name":"includeRoomMoveHistory","required":false,"schema":{"type":"boolean"}},{"description":"Include information about Component Room Reservation dates when fetching a component suite.","in":"query","name":"includeComponentRoomBlockOutDates","required":false,"schema":{"type":"boolean"}},{"description":"The starting value of the date range.","in":"query","name":"startDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"If 'Y', then filter room results to rooms that are not yet assigned to guest.","in":"query","name":"unassignedRooms","required":false,"schema":{"type":"string"}},{"description":"Room search filter.","explode":true,"in":"query","name":"roomId","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Room Type search filter.","explode":true,"in":"query","name":"roomType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Room Class search filter.","explode":true,"in":"query","name":"roomClass","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Floor search filter.","explode":true,"in":"query","name":"floor","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"A code representing a room feature.","explode":true,"in":"query","name":"roomFeature","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Simple type for room status instructions to be used in requests for fetching housekeeping rooms. Valid status values are Clean, Dirty, Pickup, Inspected, OutOfOrder, OutOfService.","explode":true,"in":"query","name":"roomStatus","required":false,"schema":{"items":{"enum":["Clean","Dirty","Pickup","Inspected","OutOfOrder","OutOfService"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Smoking Preference filter.","explode":true,"in":"query","name":"smokingPreference","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"bedType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"If set to true then reservations having past or future room moves will come according to the exact stay dates in the rooms.","in":"query","name":"showRoomMoveSegments","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/room_calendar_roomCalendar"}},"type":"object"}]}}},"description":"Oracle document preserved in the edge envelope; upstream 204 yields empty data.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Read room calendar and room move history","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access","Validate pagination/date boundary behavior in the target environment before claiming complete historical coverage"],"retry":"Read-only: bounded backoff for transient errors; honor Retry-After. Keep explicit page coordinates on retries; no automatic page traversal."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getRoomClasses","method":"GET","path":"/api/v1/config/rooms/room-classes","summary":"房型分类 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["roomClassCodes"],"contract":{"operationId":"getRoomClasses","parameters":[{"explode":true,"in":"query","name":"roomClassCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型分类 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"hotel","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomClasses","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"getRoomTypeInfo","method":"GET","path":"/api/v1/room-types/{roomTypeCode}","summary":"Get one Room Type","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"getRoomTypeInfo","parameters":[{"$ref":"#/components/parameters/RoomTypeCode"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get one Room Type","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RMCFG"}},{"operation_id":"getRoomTypes","method":"GET","path":"/api/v1/room-types","summary":"Get Room Types","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["accessible","includeInactive","limit","offset","physical","pseudo","summaryInfo","roomTypeCodes","roomClassCodes"],"contract":{"operationId":"getRoomTypes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Room Types","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RMCFG"}},{"operation_id":"getRoutingInstructions","method":"GET","path":"/api/v1/reservations/{reservationID}/routing-instructions","summary":"Get routing instructions","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeWindowRouting","includeRoomRouting","includeCompRouting","includeCompRoutingRequests","effectiveOn"],"contract":{"description":"Use this API to fetch a reservation's routing instructions. It requires a reservation ID, which can be fetched using getReservations. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetRoutingInstructions\u003c/p\u003e \u003cp\u003eThe maximum allowable limit for this API is \u003cstrong\u003e20\u003c/strong\u003e.\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getRoutingInstructions","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Include the window routing instructions to the response.","in":"query","name":"includeWindowRouting","required":false,"schema":{"type":"boolean"}},{"description":"Include the room routing instructions in the response.","in":"query","name":"includeRoomRouting","required":false,"schema":{"type":"boolean"}},{"description":"Include the comp routing instructions in the response.","in":"query","name":"includeCompRouting","required":false,"schema":{"type":"boolean"}},{"description":"Include the comp routing requests in the response.","in":"query","name":"includeCompRoutingRequests","required":false,"schema":{"type":"boolean"}},{"description":"If date is included then the search result should only be valid for dates which includes this date.","in":"query","name":"effectiveOn","required":false,"schema":{"format":"date","type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_routingInstructions"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get routing instructions","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getRsvFlexFieldValue","method":"GET","path":"/api/v1/reservations/{reservationID}/flex-field-values","summary":"Operation to fetch flex field values.","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["flexFieldId","flexFieldCode","flexFieldValue","limit","offset"],"contract":{"description":"API to fetch flex field values. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetFlexFieldValue\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getRsvFlexFieldValue","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Flex field ID","in":"query","name":"flexFieldId","required":false,"schema":{"type":"number"}},{"description":"Flex field code","explode":true,"in":"query","name":"flexFieldCode","required":false,"schema":{"items":{"maxItems":50,"type":"string"},"type":"array"},"style":"form"},{"description":"Flex field Value","in":"query","name":"flexFieldValue","required":false,"schema":{"type":"string"}},{"description":"Indicates maximum number of records a Web Service should return. Default is 50","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":1,"type":"integer"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_flexFieldsResponse"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Operation to fetch flex field values.","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getScheduledReportsExportLOV","method":"GET","path":"/api/v1/reports/lov/scheduled-exports","summary":"计划报表导出选项（不执行导出）","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for scheduled report exports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetScheduledReportsExportLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getScheduledReportsExportLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"计划报表导出选项（不执行导出）","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getScript","method":"GET","path":"/api/v1/reservations/script","summary":"Get a script","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["languageCode","scriptType","reservationId","reservationIdType","displayOffshoreRateInfo"],"contract":{"description":"This API will get the script for your property. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetScript\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getScript","parameters":[{"description":"Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.","in":"query","name":"languageCode","required":false,"schema":{"type":"string"}},{"description":"Used for Character Strings, length 0 to 40.","in":"query","name":"scriptType","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"reservationId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"reservationIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Indicates whether to display offshore rate information in the closing script or not.","in":"query","name":"displayOffshoreRateInfo","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_script"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get a script","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getSellMessageConfig","method":"GET","path":"/api/v1/reservations/sell-messages/config","summary":"Get sell messages ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["limit","offset","message","roomType","ratePlanCode","blockId","blockIdType","blockCode","languageCode","croCode","displayDate"],"contract":{"description":"Fetch the existing sell message configuration for a property. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetSellMessageConfig\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getSellMessageConfig","parameters":[{"description":"Indicates maximum number of records a Web Service should return.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Sell Message text.","in":"query","name":"message","required":false,"schema":{"type":"string"}},{"description":"Room Type.","explode":true,"in":"query","name":"roomType","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Rate Plan code.","explode":true,"in":"query","name":"ratePlanCode","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","explode":true,"in":"query","name":"blockId","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A reference to the type of object defined by the UniqueID element.","explode":true,"in":"query","name":"blockIdType","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Block Code to query for.","in":"query","name":"blockCode","required":false,"schema":{"type":"string"}},{"description":"Language code for the sell message.","in":"query","name":"languageCode","required":false,"schema":{"type":"string"}},{"description":"CRO code to query for.","in":"query","name":"croCode","required":false,"schema":{"type":"string"}},{"description":"The date on which the fetched sell message should be active.","in":"query","name":"displayDate","required":false,"schema":{"format":"date","type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_fetchSellMessageConfig"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get sell messages ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getShareReservations","method":"GET","path":"/api/v1/reservations/{reservationID}/shares","summary":"Get share Reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["fetchInstructions"],"contract":{"description":"This API can be used to retrieve the share reservations that exist on a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetShareReservations\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getShareReservations","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Instruction on which of the shared reservation's elements are to be returned e.g. DailySummary will return summarized information for each day of the shared reservation. Instructions are cumulative i.e. if multiple instructions are sent in a request, then the combined shared reservation elements would be returned, elements will not be duplicated in the response.","explode":true,"in":"query","name":"fetchInstructions","required":false,"schema":{"items":{"enum":["Reservation","Comments","ReservationMembershipAwards","GuestComments","Packages","TotalCostOfStay","InventoryItems","ReservationPaymentMethods","RoutingInstructions","Preferences","Memberships","Alerts","Traces","ConfirmationLetters","CallHistory","FixedCharges","GuestMessages","ReservationPolicies","Indicators","LinkedReservations","RevenuesAndBalances","GuestLastStay","ECoupons","TrackItItems","ReservationAwards","WebRegistrationCards","ReservationActivities","ScheduledActivities","PrepaidCards","Shares","Attachments","Locators","ProfileAwards","TransactionDiversions","Tickets","GuestMemberships","ECertificates","UpsellInfo","RoomAssignedByAI","AutoCheckInRoomType","Keys","AccompanyingGuestProfile","AccompanyingGuestMembership","AccompanyingGuestRelationship","Voucher","ScheduledRoomMoves","DailySummary","RateInfoDetails","OffshoreRates","FetchChildAges","TotalDepositPaid","ReservationProtection"],"type":"string"},"type":"array","uniqueItems":true},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_shareReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get share Reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getShareReservationsByExtId","method":"GET","path":"/api/v1/external-systems/{externalSystemCode}/reservations/{reservationExternalID}/shares","summary":"Get share Reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"This API can be used to retrieve the share reservations that exist on a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetShareReservationsByExtId\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getShareReservationsByExtId","parameters":[{"description":"Code to identify the external system from which the request is coming. This is the ExternalSystem ID used to exchange information between OPERA and the external system.","in":"path","name":"externalSystemCode","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"External reservation ID.","in":"path","name":"reservationExternalID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_shareReservations"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get share Reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getShiftReportsLOV","method":"GET","path":"/api/v1/reports/lov/shifts","summary":"班次报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for shift reports for a specific property based on search criteria such as hotelId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetShiftReportsLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getShiftReportsLOV","parameters":[{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"班次报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getShiftReportsNoParamLOV","method":"GET","path":"/api/v1/reports/lov/shift-groups/{shiftGroupId}/without-parameters","summary":"无需参数的班次报表选项","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["includeInactiveFlag","parameterName","parameterValue","excludeCodes"],"contract":{"description":"Use this API to return the list of values for shift reports no parameter based on search criteria such as shiftGroupId, includeInactiveFlag, parameterName, parameterValue. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetShiftReportsNoParamLOV\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"getShiftReportsNoParamLOV","parameters":[{"description":"Value of the parameter 'shiftGroupId' which is required to fetch ShiftReportsNoParam LOV","in":"path","name":"shiftGroupId","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Only useful for LOVs that support toggle of inactive records inclusion. When set to true, inactive records will be included.","in":"query","name":"includeInactiveFlag","required":false,"schema":{"type":"boolean"}},{"description":"Name of the parameter.","explode":true,"in":"query","name":"parameterName","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Value of the parameter.","explode":true,"in":"query","name":"parameterValue","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"excludeCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_lov_listOfValues"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"无需参数的班次报表选项","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream LOV access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"LOV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/lov.json"}},{"operation_id":"getSourceCodes","method":"GET","path":"/api/v1/codes/sources","summary":"Get hotel Source Codes","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["limit","pageNumber","sourceCodes","sourceGroupsCodes","includeInactive"],"contract":{"operationId":"getSourceCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get hotel Source Codes","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSVCFG"}},{"operation_id":"getSourceGroups","method":"GET","path":"/api/v1/config/reservations/source-groups","summary":"来源分组 · 查询","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"query_names":["limit","pageNumber","sourceCodes","sourceGroupsCodes","includeInactive"],"contract":{"operationId":"getSourceGroups","parameters":[{"explode":true,"in":"query","name":"limit","required":false,"schema":{"type":"integer"},"style":"form"},{"explode":true,"in":"query","name":"pageNumber","required":false,"schema":{"type":"integer"},"style":"form"},{"explode":true,"in":"query","name":"sourceCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"sourceGroupsCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"includeInactive","required":false,"schema":{"type":"boolean"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Oracle document; an upstream 204 becomes data {}."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源分组 · 查询","x-capability-group":"configuration.read","x-configuration-scope":"hotel","x-integration":{"pattern":"sync-read","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties"],"retry":"Bounded read retries."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceGroups","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"getStatements","method":"GET","path":"/api/v1/finance/ar/accounts/{accountID}/statements","summary":"Get statements for an AR account","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":["profileId","profileIdContext","profileType","accountNo","accountName","closeDate","fiscalBillNo","folioDate","folioNo","folioStatus","folioTypeName","invoiceNo","invoiceType","postingDate","revenueDate","statementNo","status","transferDate","transactionDate","transactionNo","reservationId","reservationIdContext","reservationType","guestProfileId","guestProfileIdContext","guestProfileType","guestName","originalAmount","originalAmountCurrencyCode","amount","currencyCode","paymentsAmount","paymentsCurrencyCode","balanceAmount","balanceCurrencyCode","reference","remark","marketCode","marketGroup","roomClassCode","sourceCode","sourceGroup","cashierId","cashierName","transactionDescription","transactionGroup","transactionSubGroup","transactionCode","balanceForwardDate","inclFolios","inclPrinted","inclZero","filterEndDate","filterStartDate","statementText"],"contract":{"operationId":"getStatements","parameters":[{"$ref":"#/components/parameters/AccountID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get statements for an AR account","x-capability-group":"finance.read","x-finance-policy":"read-only","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"getTickets","method":"GET","path":"/api/v1/reservations/{reservationID}/tickets","summary":"Get tickets","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["packageCode","retrieveIssuedOnly","retrieveNotIssuedOnly"],"contract":{"description":"Get tickets for a reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetTickets\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getTickets","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Property where the tickets messages belongs to.","in":"query","name":"packageCode","required":false,"schema":{"type":"string"}},{"description":"Flag that specified if only issued tickets will be retrieved.","in":"query","name":"retrieveIssuedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Flag that specified if only not issued tickets will be retrieved.","in":"query","name":"retrieveNotIssuedOnly","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_tickets"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get tickets","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getTicketsInquiry","method":"GET","path":"/api/v1/reservations/{reservationID}/tickets/inquiry","summary":"Inquiry for Reservation tickets","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["ticketId","ticketIdType","packageCode","reservationProductId","reservationProductIdType","ticketNumberId","ticketNumberIdType","ticketIssueDate","ticketConsumptionDate","ticketRateCode","ticketStatus"],"contract":{"description":"You can use this API to perform a Inquiry for Reservation tickets. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetTicketsInquiry\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getTicketsInquiry","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"ticketId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"ticketIdType","required":false,"schema":{"type":"string"}},{"description":"Package Code.","explode":true,"in":"query","name":"packageCode","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"reservationProductId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"reservationProductIdType","required":false,"schema":{"type":"string"}},{"description":"A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.","in":"query","name":"ticketNumberId","required":false,"schema":{"type":"string"}},{"description":"A reference to the type of object defined by the UniqueID element.","in":"query","name":"ticketNumberIdType","required":false,"schema":{"type":"string"}},{"description":"Tickets issue date.","explode":true,"in":"query","name":"ticketIssueDate","required":false,"schema":{"items":{"format":"date","type":"string"},"type":"array"},"style":"form"},{"description":"Tickets comsumption date.","explode":true,"in":"query","name":"ticketConsumptionDate","required":false,"schema":{"items":{"format":"date","type":"string"},"type":"array"},"style":"form"},{"description":"The Rate Code to which tickets belong to.","explode":true,"in":"query","name":"ticketRateCode","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The Status Code for outbound WS call.","explode":true,"in":"query","name":"ticketStatus","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_tickets"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Inquiry for Reservation tickets","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getTracesByReservation","method":"GET","path":"/api/v1/reservations/{reservationID}/traces","summary":"Get traces for a Reservation","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"You can use this API to get traces for a Reservation. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetTracesByReservation\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getTracesByReservation","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_traces"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get traces for a Reservation","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getTracesByRoom","method":"GET","path":"/api/v1/rooms/{roomID}/traces","summary":"Get traces for a Room","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"This API will fetch the traces for a Room. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetTracesByRoom\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getTracesByRoom","parameters":[{"description":"Room Id","in":"path","name":"roomID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_traces"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get traces for a Room","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"getTransactionDiversions","method":"GET","path":"/api/v1/reservations/{reservationID}/transaction-diversions","summary":"Get Transaction Diversions ","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":["transactionDiversionCodes","includeDailyDetails"],"contract":{"description":"You can use this API to get Transaction Diversions. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003egetTransactionDiversions\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"getTransactionDiversions","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"explode":true,"in":"query","name":"transactionDiversionCodes","required":false,"schema":{"items":{"type":"string"},"maxItems":4000,"type":"array"},"style":"form"},{"description":"Flag to check if the the daily details are required to be fetched for a particular transaciton.","in":"query","name":"includeDailyDetails","required":false,"schema":{"type":"boolean"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_transactionDiversions"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get Transaction Diversions ","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"pingReportsConfigServiceStatus","method":"GET","path":"/api/v1/reports/service-status","summary":"查询报表配置服务状态","capability_group":"configuration.read","integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":" \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003epingReportsConfigServiceStatus\u003c/p\u003e Read-only report metadata/options; does not execute, schedule or download a report. Edge supplies the configured hotel in the header and any hotel path/query field. Original JSON is preserved without pagination; upstream 204 becomes 200 with data {}.","operationId":"pingReportsConfigServiceStatus","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/report_repcfg_operaVersion"}},"type":"object"}]}}},"description":"Oracle JSON in the edge envelope; upstream 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询报表配置服务状态","x-capability-group":"configuration.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved configuration.read capability and upstream REPCFG access","Use actual report identity and parameter/option codes from the target environment; no inferred ARR execution contract"],"retry":"Bounded read retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"REPCFG","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/repcfg.json"}},{"operation_id":"postBlock","method":"POST","path":"/api/v1/blocks","summary":"Create a hotel-confirmed Block and read it back","capability_group":"blocks.write","integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"query_names":[],"contract":{"operationId":"postBlock","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/ConfirmedWrite"},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Block creation verified by getBlock.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Create a hotel-confirmed Block and read it back","x-capability-group":"blocks.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"x-oracle-api":"BLK"}},{"operation_id":"postBlockCancellationReasons","method":"POST","path":"/api/v1/config/blocks/block-cancellation-reasons","summary":"团队房取消原因 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBlockCancellationReasons","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockCancellationReasonsCriteria"},{"properties":{"blockCancellationReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockCancellationReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房取消原因 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockCancellationReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postBlockLostBookingCodes","method":"POST","path":"/api/v1/config/blocks/block-lost-booking-codes","summary":"团队房流失原因 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBlockLostBookingCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockLostBookingCodesCriteria"},{"properties":{"blockLostBookingCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockLostBookingCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房流失原因 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockLostBookingCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postBlockRateOverrideReasons","method":"POST","path":"/api/v1/config/blocks/block-rate-override-reasons","summary":"团队房房价覆盖原因 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBlockRateOverrideReasons","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockRateOverrideReasonsCriteria"},{"properties":{"blockRateOverrideReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockRateOverrideReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房房价覆盖原因 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRateOverrideReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postBlockRefusedReasonspostBlo","method":"POST","path":"/api/v1/config/blocks/block-refused-reasons","summary":"团队房拒绝原因 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBlockRefusedReasonspostBlo","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockRefusedReasonsCriteria"},{"properties":{"blockRefusedReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockRefusedReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房拒绝原因 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRefusedReasons","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postBlockStatusCode","method":"POST","path":"/api/v1/config/blocks/block-status-codes","summary":"团队房状态 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBlockStatusCode","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockStatusCodeDetails"},{"properties":{"blockStatusCode":{"type":"object"}},"required":["blockStatusCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockStatusCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postBlockValidate","method":"POST","path":"/api/v1/blocks/validations","summary":"Validate Block creation data without mutation","capability_group":"blocks.write","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"postBlockValidate","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/RequiredOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Validate Block creation data without mutation","x-capability-group":"blocks.write","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"postBookingTypes","method":"POST","path":"/api/v1/config/reservations/booking-types","summary":"预订类型 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postBookingTypes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_bookingTypesCriteria"},{"properties":{"bookingTypes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["bookingTypes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订类型 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/bookingTypes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postCancelReservation","method":"POST","path":"/api/v1/reservations/{reservationID}/cancellations","summary":"确认取消单笔预订","capability_group":"reservations.write","integration":{"pattern":"confirmed-write","prerequisites":["Approved reservations.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"query_names":[],"contract":{"description":"Use this if a guest would like to cancel their reservation.  You will receive a cancellation number in the response. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003epostCancelReservation\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Single-target confirmed write. Check status: verified or pending_verification. Known success returns its native HTTP 200/201 even if readback is pending. Exact replay repeats reads only; unknown outcomes require reconciliation. receipt is the original Oracle response on the first successful mutation only, never persisted; save it in the consuming application's approved evidence store.","operationId":"postCancelReservation","parameters":[{"description":"Unique OPERA reservation ID which is used to find reservation from OPERA. This ID is a primary identification of a reservation in OPERA.","in":"path","name":"reservationID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"case_id":"case-test","expected_hotel_id":"HOTEL1","hotel_confirmation_id":"approval-test","idempotency_key":"unique-test-key","payload":{"reason":{"code":"TEST_REASON"},"reservations":[{"hotelId":"HOTEL1","reservationIdList":[{"id":"RES1","type":"Reservation"}]}],"verificationOnly":false},"task_id":"task-test"},"schema":{"allOf":[{"$ref":"#/components/schemas/ConfirmedWriteRequest"},{"properties":{"payload":{"$ref":"#/components/schemas/BookingPayload_postCancelReservation"}},"type":"object"}]}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingWriteResult"}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"确认取消单笔预订","x-capability-group":"reservations.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Approved reservations.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"x-oracle-api":"RSV","x-oracle-response-schema":{"$ref":"#/components/schemas/booking_rsv_cancelReservationDetails"},"x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/rsv.json","x-verification-operation":"getReservation"}},{"operation_id":"postCancellationCodes","method":"POST","path":"/api/v1/config/reservations/cancellation-codes","summary":"预订取消原因 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postCancellationCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_cancellationCodesCriteria"},{"properties":{"cancellationCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["cancellationCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订取消原因 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/cancellationCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postDestinationCodes","method":"POST","path":"/api/v1/config/blocks/destination-codes","summary":"目的地代码 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postDestinationCodes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_destinationCodesCriteria"},{"properties":{"destinationCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["destinationCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"目的地代码 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/destinationCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postGuaranteeCode","method":"POST","path":"/api/v1/config/reservations/guarantee-codes","summary":"担保类型 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postGuaranteeCode","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_guaranteeCodeCriteria"},{"properties":{"hotelId":{"description":"Must equal the server-configured hotel.","type":"string"}},"required":["hotelId"],"type":"object"},{"properties":{"guaranteeCode":{"type":"object"}},"required":["guaranteeCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"担保类型 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/guaranteeCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postMarketCode","method":"POST","path":"/api/v1/config/reservations/market-codes/{code}","summary":"市场代码 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postMarketCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_marketCodeCriteria"},{"properties":{"marketCode":{"type":"object"}},"required":["marketCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场代码 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketCodes/{marketcode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postMarketGroup","method":"POST","path":"/api/v1/config/reservations/market-groups/{code}","summary":"市场分组 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postMarketGroup","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_marketGroupCriteria"},{"properties":{"marketGroup":{"type":"object"}},"required":["marketGroup"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场分组 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketGroups/{marketGroupCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postProfile","method":"POST","path":"/api/v1/profiles","summary":"创建 Guest 客档","capability_group":"profiles.write","integration":{"pattern":"confirmed-write","prerequisites":["Approved profiles.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"query_names":[],"contract":{"description":"When a profile doesn't already exist for a guest, use this to create a new profile. The response will provide the newly created profile's OPERA ID. There are many fields in postProfile defined by ListOfValues; ensure you have reviewed ListOfValues APIs in order successfully to use postProfile. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003epostProfile\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Single-target confirmed write. Check status: verified or pending_verification. Known success returns its native HTTP 200/201 even if readback is pending. Exact replay repeats reads only; unknown outcomes require reconciliation. receipt is the original Oracle response on the first successful mutation only, never persisted; save it in the consuming application's approved evidence store.","operationId":"postProfile","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"case_id":"case-test","expected_hotel_id":"HOTEL1","hotel_confirmation_id":"approval-test","idempotency_key":"unique-test-key","payload":{"profileDetails":{"addresses":{"addressInfo":[{"address":{"country":{"code":"CN"}}}]},"customer":{"personName":[{"surname":"测试客人"}]},"profileType":"Guest","registeredProperty":"HOTEL1"}},"task_id":"task-test"},"schema":{"allOf":[{"$ref":"#/components/schemas/ConfirmedWriteRequest"},{"properties":{"payload":{"$ref":"#/components/schemas/BookingPayload_postProfile"}},"type":"object"}]}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingWriteResult"}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"创建 Guest 客档","x-capability-group":"profiles.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Approved profiles.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"x-oracle-api":"CRM","x-oracle-response-schema":{"$ref":"#/components/schemas/booking_crm_status"},"x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/crm.json","x-verification-operation":"getProfile"}},{"operation_id":"postReservation","method":"POST","path":"/api/v1/reservations","summary":"Create a hotel-confirmed reservation and read it back","capability_group":"reservations.write","integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"query_names":[],"contract":{"operationId":"postReservation","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/ConfirmedWrite"},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Reservation creation verified by getReservation.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Create a hotel-confirmed reservation and read it back","x-capability-group":"reservations.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"x-oracle-api":"RSV"}},{"operation_id":"postReservationMethods","method":"POST","path":"/api/v1/config/blocks/reservation-methods","summary":"团队房预订方式 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postReservationMethods","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_reservationMethodsCriteria"},{"properties":{"reservationMethods":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["reservationMethods"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房预订方式 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/reservationMethods","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"postRoomClass","method":"POST","path":"/api/v1/config/rooms/room-classes","summary":"房型分类 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postRoomClass","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rmcfg_roomClassCriteria"},{"properties":{"roomClass":{"type":"object"}},"required":["roomClass"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型分类 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomClasses","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"postRoomTypes","method":"POST","path":"/api/v1/config/rooms/room-types","summary":"房型 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postRoomTypes","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rmcfg_roomTypesCriteria"},{"properties":{"roomType":{"properties":{"hotelId":{"description":"Must equal the server-configured hotel.","type":"string"}},"required":["hotelId"],"type":"object"}},"required":["roomType"],"type":"object"},{"properties":{"roomType":{"properties":{"roomTypeDetails":{"type":"object"}},"required":["roomTypeDetails"],"type":"object"}},"required":["roomType"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomTypes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"postSourceCode","method":"POST","path":"/api/v1/config/reservations/source-codes","summary":"来源代码 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postSourceCode","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_sourceCodeCriteria"},{"properties":{"sourceCode":{"type":"object"}},"required":["sourceCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源代码 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceCodes/","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"postSourceGroup","method":"POST","path":"/api/v1/config/reservations/source-groups","summary":"来源分组 · 新增","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"postSourceGroup","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_sourceGroupCriteria"},{"properties":{"sourceGroup":{"type":"object"}},"required":["sourceGroup"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"resource_code":{"maxLength":2000,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","resource_code","payload"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源分组 · 新增","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceGroups","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"putBlock","method":"PUT","path":"/api/v1/blocks/{blockID}","summary":"Apply a hotel-confirmed Block update and read it back","capability_group":"blocks.write","integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"query_names":[],"contract":{"operationId":"putBlock","parameters":[{"$ref":"#/components/parameters/BlockID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/ConfirmedWrite"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Block update verified by getBlock.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Apply a hotel-confirmed Block update and read it back","x-capability-group":"blocks.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"x-oracle-api":"BLK"}},{"operation_id":"putBlockAllocation","method":"PUT","path":"/api/v1/blocks/{blockID}/allocation","summary":"设置团队逐晚绝对房量","capability_group":"blocks.write","integration":{"pattern":"confirmed-write","prerequisites":["Approved blocks.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"query_names":[],"contract":{"description":"Use this API to add block room type allocations and rates to a specified Block. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003eputBlockAllocation\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Single-target confirmed write. Check status: verified or pending_verification. Known success returns its native HTTP 200/201 even if readback is pending. Exact replay repeats reads only; unknown outcomes require reconciliation. receipt is the original Oracle response on the first successful mutation only, never persisted; save it in the consuming application's approved evidence store.","operationId":"putBlockAllocation","parameters":[{"description":"Block Id","in":"path","name":"blockID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"case_id":"case-test","expected_hotel_id":"HOTEL1","hotel_confirmation_id":"approval-test","idempotency_key":"unique-test-key","payload":{"criteria":{"allocationRoomTypes":[{"allocationGridDates":[{"allocation":"ACTUAL","roomAllocationInfo":[{"end":"2026-10-01","inventory":{"fourPerson":0,"onePerson":0,"threePerson":0,"twoPerson":2},"start":"2026-10-01"},{"end":"2026-10-02","inventory":{"fourPerson":0,"onePerson":0,"threePerson":0,"twoPerson":3},"start":"2026-10-02"}]}],"roomType":"TEST"}],"blockId":{"id":"BLOCK1","type":"Block"},"hotelId":"HOTEL1"}},"task_id":"task-test"},"schema":{"allOf":[{"$ref":"#/components/schemas/ConfirmedWriteRequest"},{"properties":{"payload":{"$ref":"#/components/schemas/BookingPayload_putBlockAllocation"}},"type":"object"}]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingWriteResult"}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"设置团队逐晚绝对房量","x-capability-group":"blocks.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Approved blocks.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"x-oracle-api":"BLK","x-oracle-response-schema":{"$ref":"#/components/schemas/booking_blk_status"},"x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/blk.json","x-verification-operation":"getBlockRoomRateGrid"}},{"operation_id":"putBlockCancellationReasons","method":"PUT","path":"/api/v1/config/blocks/block-cancellation-reasons/{code}","summary":"团队房取消原因 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBlockCancellationReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockCancellationReasonsToBeChanged"},{"properties":{"blockCancellationReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockCancellationReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房取消原因 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockCancellationReasons/{blockCancellationReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putBlockLostBookingCodes","method":"PUT","path":"/api/v1/config/blocks/block-lost-booking-codes/{code}","summary":"团队房流失原因 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBlockLostBookingCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockLostBookingCodesToBeChanged"},{"properties":{"blockLostBookingCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockLostBookingCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房流失原因 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockLostBookingCodes/{blockLostBookingCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putBlockRateOverrideReasons","method":"PUT","path":"/api/v1/config/blocks/block-rate-override-reasons/{code}","summary":"团队房房价覆盖原因 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBlockRateOverrideReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockRateOverrideReasonsToBeChanged"},{"properties":{"blockRateOverrideReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockRateOverrideReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房房价覆盖原因 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRateOverrideReasons/{blockRateOverrideReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putBlockRefusedReasons","method":"PUT","path":"/api/v1/config/blocks/block-refused-reasons/{code}","summary":"团队房拒绝原因 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBlockRefusedReasons","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockRefusedReasonsToBeChanged"},{"properties":{"blockRefusedReasons":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["blockRefusedReasons"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房拒绝原因 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockRefusedReasons/{blockRefusedReasonsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putBlockStatus","method":"PUT","path":"/api/v1/blocks/{blockID}/status","summary":"确认变更单个团队状态","capability_group":"blocks.write","integration":{"pattern":"confirmed-write","prerequisites":["Approved blocks.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"query_names":[],"contract":{"description":"Use this to change the status of a block in Opera.  To know a hotels Block status codes, use the List Of Values API - BlockStatuses.  Also note, you can only change the status in a particular order, for example INQ to DEF, but not DEF to INQ. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003eputBlockStatus\u003c/p\u003e Fixed configured hotel; native status is in upstream_status. Single-target confirmed write. Check status: verified or pending_verification. Known success returns its native HTTP 200/201 even if readback is pending. Exact replay repeats reads only; unknown outcomes require reconciliation. receipt is the original Oracle response on the first successful mutation only, never persisted; save it in the consuming application's approved evidence store.","operationId":"putBlockStatus","parameters":[{"description":"Block Id","in":"path","name":"blockID","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"case_id":"case-test","expected_hotel_id":"HOTEL1","hotel_confirmation_id":"approval-test","idempotency_key":"unique-test-key","payload":{"changeBlockStatus":{"blockId":{"id":"BLOCK1","type":"Block"},"cancellationDetails":{"cancellationCode":{"code":"TEST_REASON"}},"currentBlockStatus":"TEST_CURRENT","hotelId":"HOTEL1","newBlockStatus":"TEST_CANCEL"},"verificationOnly":false},"task_id":"task-test"},"schema":{"allOf":[{"$ref":"#/components/schemas/ConfirmedWriteRequest"},{"properties":{"payload":{"$ref":"#/components/schemas/BookingPayload_putBlockStatus"}},"type":"object"}]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingWriteResult"}}},"description":"Oracle read or confirmed-write outcome; inspect status before continuing business workflow."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"确认变更单个团队状态","x-capability-group":"blocks.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Approved blocks.write capability and Oracle access for the configured hotel","Use actual target IDs/codes; synthetic examples are not hotel configuration"],"retry":"Never blindly retry mutations. Resubmit identical confirmation and idempotency key to retry readback only; unknown outcomes stay blocked."},"x-oracle-api":"BLK","x-oracle-response-schema":{"$ref":"#/components/schemas/booking_blk_changedBlockStatus"},"x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/4bd129b455bc5e3ab0f900ac47983611e58659b4/rest-api-specs/property/v1/blk.json","x-verification-operation":"getBlock"}},{"operation_id":"putBlockStatusCode","method":"PUT","path":"/api/v1/config/blocks/block-status-codes/{code}","summary":"团队房状态 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBlockStatusCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_blockStatusCodeDetails"},{"properties":{"blockStatusCode":{"type":"object"}},"required":["blockStatusCode"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockStatusCodes/{blockStatusCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putBookingTypes","method":"PUT","path":"/api/v1/config/reservations/booking-types/{code}","summary":"预订类型 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putBookingTypes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_bookingTypesToBeChanged"},{"properties":{"bookingTypes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["bookingTypes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订类型 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/bookingTypes/{bookingTypesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"putCancellationCodes","method":"PUT","path":"/api/v1/config/reservations/cancellation-codes/{code}","summary":"预订取消原因 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putCancellationCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rsvcfg_cancellationCodesToBeChanged"},{"properties":{"cancellationCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["cancellationCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"预订取消原因 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/cancellationCodes/{cancellationCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"putDestinationCodes","method":"PUT","path":"/api/v1/config/blocks/destination-codes/{code}","summary":"目的地代码 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putDestinationCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_destinationCodesToBeChanged"},{"properties":{"destinationCodes":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["destinationCodes"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"目的地代码 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/destinationCodes/{destinationCodesId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putNextBlockStatusCodes","method":"PUT","path":"/api/v1/config/blocks/block-status-codes/{code}/next-status-codes","summary":"团队房状态流转 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putNextBlockStatusCodes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_nextBlockStatusCode"},{"properties":{"nextBlockStatusCodeList":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["nextBlockStatusCodeList"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房状态流转 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/blockStatusCodes/{srcBlockStatusCode}/nextStatusCodes","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putReservation","method":"PUT","path":"/api/v1/reservations/{reservationID}","summary":"Apply a hotel-confirmed reservation update and read it back","capability_group":"reservations.write","integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"query_names":[],"contract":{"operationId":"putReservation","parameters":[{"$ref":"#/components/parameters/ReservationID"},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/ConfirmedWrite"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Reservation update verified by getReservation.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Apply a hotel-confirmed reservation update and read it back","x-capability-group":"reservations.write","x-integration":{"pattern":"confirmed-write","prerequisites":["Hotel-approved confirmation","Read-back reconciliation ownership"],"retry":"Reuse the original idempotency key. Reconcile unknown outcomes with read-back before retrying."},"x-oracle-api":"RSV"}},{"operation_id":"putReservationMethods","method":"PUT","path":"/api/v1/config/blocks/reservation-methods/{code}","summary":"团队房预订方式 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putReservationMethods","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"chain","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/blkcfg_reservationMethodsToBeChanged"},{"properties":{"reservationMethods":{"items":{"type":"object"},"maxItems":1,"minItems":1,"type":"array"}},"required":["reservationMethods"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"团队房预订方式 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"chain","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover chain scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/blk/config/v1/reservationMethods/{reservationMethodsId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/blkcfg.json"}},{"operation_id":"putRoomClass","method":"PUT","path":"/api/v1/config/rooms/room-classes/{code}","summary":"房型分类 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putRoomClass","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rmcfg_roomClassToBeChanged"},{"properties":{"roomClass":{"type":"object"}},"required":["roomClass"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型分类 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomClasses/{roomClassId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"putRoomTypes","method":"PUT","path":"/api/v1/config/rooms/room-types/{code}","summary":"房型 · 更新","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"putRoomTypes","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"payload":{"allOf":[{"$ref":"#/components/schemas/rmcfg_roomTypesToBeChanged"},{"properties":{"roomType":{"properties":{"hotelId":{"description":"Must equal the server-configured hotel.","type":"string"}},"required":["hotelId"],"type":"object"}},"required":["roomType"],"type":"object"},{"properties":{"roomType":{"properties":{"roomTypeDetails":{"type":"object"}},"required":["roomTypeDetails"],"type":"object"}},"required":["roomType"],"type":"object"}],"description":"One target code only, matching resource_code or the path code. Oracle-shaped fields are forwarded unchanged."},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope","payload"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"房型 · 更新","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rm/config/v1/hotels/{hotelId}/roomTypes/{roomTypeId}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rmcfg.json"}},{"operation_id":"putValidateReservationChanges","method":"PUT","path":"/api/v1/reservations/validations","summary":"Validate reservation create/change data without mutation","capability_group":"reservations.write","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"putValidateReservationChanges","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/RequiredOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Validate reservation create/change data without mutation","x-capability-group":"reservations.write","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSV"}},{"operation_id":"removeMarketCode","method":"DELETE","path":"/api/v1/config/reservations/market-codes/{code}","summary":"市场代码 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"removeMarketCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场代码 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketCodes/{marketcode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"removeMarketGroup","method":"DELETE","path":"/api/v1/config/reservations/market-groups/{code}","summary":"市场分组 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"removeMarketGroup","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"市场分组 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/marketGroups/{marketGroupCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"removeSourceCode","method":"DELETE","path":"/api/v1/config/reservations/source-codes/{code}","summary":"来源代码 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"removeSourceCode","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源代码 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceCodes/{sourceCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"removeSourceGroup","method":"DELETE","path":"/api/v1/config/reservations/source-groups/{code}","summary":"来源分组 · 删除","capability_group":"configuration.write","integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"query_names":[],"contract":{"operationId":"removeSourceGroup","parameters":[{"in":"path","name":"code","required":true,"schema":{"maxLength":2000,"minLength":1,"type":"string"}},{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"case_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_hotel_id":{"maxLength":200,"minLength":1,"type":"string"},"expected_scope":{"const":"hotel","type":"string"},"hotel_confirmation_id":{"maxLength":200,"minLength":1,"type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"type":"string"},"task_id":{"maxLength":200,"minLength":1,"type":"string"}},"required":["case_id","task_id","hotel_confirmation_id","idempotency_key","expected_hotel_id","expected_scope"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedWriteResult"}}},"description":"Upstream accepted and the target code was read back (or its absence verified for deletion). Inspect returned fields for business correctness."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"来源分组 · 删除","x-capability-group":"configuration.write","x-configuration-scope":"hotel","x-integration":{"pattern":"confirmed-write","prerequisites":["Oracle functional area and configuration access","Configured hotel context; chain configuration can affect multiple properties","Confirmation must cover hotel scope; one resource code per request; a chain code can affect multiple hotels"],"retry":"Reuse the same idempotency key; never blindly retry an unknown result. Replays perform verification reads only."},"x-oracle-path":"/rsv/config/v1/hotels/{hotelId}/sourceGroups/{sourceGroupCode}","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/tree/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsvcfg.json"}},{"operation_id":"searchARTransactions","method":"POST","path":"/api/v1/finance/ar/transactions/searches","summary":"Search AR transactions without mutation","capability_group":"finance.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"searchARTransactions","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/RequiredOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search AR transactions without mutation","x-capability-group":"finance.read","x-finance-policy":"read-only-search","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"ARS"}},{"operation_id":"searchBlocks","method":"POST","path":"/api/v1/blocks/searches","summary":"Search Blocks","capability_group":"blocks.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"searchBlocks","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/OptionalOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search Blocks","x-capability-group":"blocks.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"BLK"}},{"operation_id":"searchHotelAvailability","method":"POST","path":"/api/v1/availability/searches","summary":"Search hotel availability using an Oracle search document","capability_group":"hotel.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"searchHotelAvailability","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/OptionalOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search hotel availability using an Oracle search document","x-capability-group":"hotel.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"PAR"}},{"operation_id":"searchHotelReservations","method":"POST","path":"/api/v1/reservations/searches","summary":"Search reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"searchHotelReservations","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/OptionalOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"RSV"}},{"operation_id":"searchPreConfiguredRoutingInstructions","method":"POST","path":"/api/v1/reservations/preconfigured-routing-instructions/searches","summary":"Get pre-Configured Routing Instructions","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"Get preConfigured Routing Instructions. \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003esearchPreConfiguredRoutingInstructions\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"searchPreConfiguredRoutingInstructions","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rsv_read_searchPreConfiguredRoutingInstructionsRequest"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_preConfiguredRoutingInstructions"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Get pre-Configured Routing Instructions","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"searchProfiles","method":"POST","path":"/api/v1/profiles/searches","summary":"Search profiles using the Oracle search document","capability_group":"profiles.read","integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"query_names":[],"contract":{"operationId":"searchProfiles","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/OptionalOracleDocument"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OHIPDocument"}}},"description":"Bounded Oracle document in the stable edge envelope.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search profiles using the Oracle search document","x-capability-group":"profiles.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved application capability"],"retry":"Read-only operation; retry transient failures with bounded backoff and honor Retry-After. Validation requests do not persist changes."},"x-oracle-api":"CRM"}},{"operation_id":"searchRateInfo","method":"POST","path":"/api/v1/reservations/rate-info/searches","summary":"查询预订房价信息（推荐）","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read application capability","Oracle query span at most 21 days; split larger ranges explicitly in consuming code"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"query_names":[],"contract":{"description":"Oracle POST /rsv/v1/hotels/{hotelId}/reservations/rateInfo/searches. Read-only reservation rate lookup; Oracle limits the requested time span to 21 days and validates criteria and value types. Prefer searchRateInfo for new integrations; GET getRateInfo is deprecated upstream. Only the configured hotel is used. Oracle 204 becomes HTTP 200 with data: {}. Returned Oracle fields are provisional until customer UAT.","operationId":"searchRateInfo","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"adults":2,"criteriaEndDate":"2026-10-03","criteriaStartDate":"2026-10-01","ratePlanCode":"BAR","roomType":"DLX","summaryInfo":true},"schema":{"$ref":"#/components/schemas/rate_rsv_searchRateInfoRequest"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rate_rsv_rateInfo"}},"type":"object"}]}}},"description":"Bounded Oracle rate information; data is an empty object when Oracle returns 204.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"查询预订房价信息（推荐）","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read application capability","Oracle query span at most 21 days; split larger ranges explicitly in consuming code"],"retry":"Read-only query (including POST search); retry transient failures with bounded backoff and honor Retry-After. No reservation or price is modified."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"searchReservationsSummary","method":"POST","path":"/api/v1/reservations/summary/searches","summary":"Search brief summary for Reservations","capability_group":"reservations.read","integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"query_names":[],"contract":{"description":"\u003cp\u003eThis operation fetches brief summary for the reservations and also supports the Global Parameter \u003cstrong\u003eMAX ROWS FETCH COUNT\u003c/strong\u003e.\u003cbr\u003eBy default this parameter is configured to support an overall fetch of \u003cstrong\u003e5000\u003c/strong\u003e Records in total, with maximum number of records that can be fetched at a time being \u003cstrong\u003e200\u003c/strong\u003e (limit). However, this parameter can be updated to support an overall fetch value being a valid number between \u003cstrong\u003e1\u003c/strong\u003e and \u003cstrong\u003e10000\u003c/strong\u003e with maximum number of records that can be fetched at a time being same i.e. \u003cstrong\u003e200\u003c/strong\u003e (limit).\u003c/p\u003e\u003cp\u003eRequests with an \u003cstrong\u003eoffset\u003c/strong\u003e and \u003cstrong\u003elimit\u003c/strong\u003e sum exceeding the \u003cstrong\u003eMAX ROWS FETCH COUNT\u003c/strong\u003e configured would fail the request.\u003c/p\u003e \u003cp\u003e\u003cstrong\u003eOperationId:\u003c/strong\u003esearchReservationsSummary\u003c/p\u003e Edge fixes hotelId to the configured hotel; JSON is preserved without normalization or automatic pagination. Upstream 204 becomes 200 with data {}.","operationId":"searchReservationsSummary","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rsv_read_searchReservationsSummaryRequest"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/OHIPDocument"},{"properties":{"data":{"$ref":"#/components/schemas/rsv_read_reservationsSummary"}},"type":"object"}]}}},"description":"Original Oracle document in the stable edge envelope; 204 yields empty data."},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Search brief summary for Reservations","x-capability-group":"reservations.read","x-integration":{"pattern":"sync-read","prerequisites":["Approved reservations.read capability and upstream RSV access for the configured hotel"],"retry":"Read-only bounded retries for transient upstream failures; honor Retry-After. No automatic pagination."},"x-oracle-api":"RSV","x-oracle-source":"https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json"}},{"operation_id":"startFinancialPostingsAsync","method":"POST","path":"/api/v1/finance/financial-posting-jobs","summary":"Start a read-only Financial Postings Net/VAT extract","capability_group":"finance.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"description":"The service does not retry this job start automatically.","operationId":"startFinancialPostingsAsync","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/RequiredOracleDocument"},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}},"description":"Oracle accepted the asynchronous retrieval job.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Start a read-only Financial Postings Net/VAT extract","x-capability-group":"finance.async","x-finance-policy":"read-only-job","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"CSHASYNC"}},{"operation_id":"startReservationsDailySummaryProcess","method":"POST","path":"/api/v1/reservation-daily-summary-jobs","summary":"Start a Reservation Daily Summary retrieval job","capability_group":"reservations.async","integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"query_names":[],"contract":{"description":"Requires configured OHIP_EXTERNAL_SYSTEM_CODE; the service does not retry this job start automatically.","operationId":"startReservationsDailySummaryProcess","parameters":[{"description":"Guard only: must match the application's immutable environment; mismatch returns 409 before Oracle. Never selects a target.","in":"header","name":"X-Expected-Environment-ID","required":false,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/RequiredOracleDocument"},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}},"description":"Oracle accepted the asynchronous retrieval job.","headers":{"Cache-Control":{"schema":{"const":"no-store","type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"security":[{"CallerAPIKey":[]}],"summary":"Start a Reservation Daily Summary retrieval job","x-capability-group":"reservations.async","x-integration":{"pattern":"async-read","prerequisites":["Approved retrieval parameters","Retain process ID","Server-configured External System Code"],"retry":"Do not blindly retry a timed-out start. Retain job ID; poll status respecting Retry-After, then fetch result."},"x-oracle-api":"RSVASYNC"}}],"version":"0.12.0"}