Oracle Hospitality Block Config API
The Block Configuration module offers capability of creating, managing, and retrieving of Block configuration.
Operations 32
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“What block status codes are configured for our chain?”
“Which block statuses are deduct versus non-deduct?”
Tell an agent
List the configured block status codes.
Show details for block status codes {blockStatusCodes}.
Ask an LLM
“How do I add a new block status such as Tentative Hold?”
“Can I define a brand-new status code for group blocks?”
Tell an agent
Create block status code {blockStatusCode}.
Add a new non-deduct block status called {blockStatusCode}.
GET
/blockStatusCodes/nextStatusCodes
Get allowed next statuses for a block status · Get next block status codes
#
Ask an LLM
“Which statuses can a block move to from its current status?”
“What is the configured status progression for blocks at a property?”
Tell an agent
Show the allowed next statuses after {blockStatusCodes}.
List only the configured next-status transitions for block statuses.
Ask an LLM
“How do I remove a block status we no longer use?”
“Can I delete a configured block status code?”
Tell an agent destructive · confirm first
Delete block status code {blockStatusCode}.
Remove the unused block status {blockStatusCode} from configuration.
Ask an LLM
“How do I edit the description or type of an existing block status?”
“Can I rename a block status code that's already configured?”
Tell an agent
Update block status code {code}.
Change the settings of existing block status {code} to {blockStatusCode}.
PUT
/blockStatusCodes/{srcBlockStatusCode}/nextStatusCodes
Set the next statuses for a block status · Change next block status codes
#
Ask an LLM
“How do I control which statuses a block can move to next?”
“Can I change the allowed transitions from a given block status?”
Tell an agent
Set the next statuses after {srcBlockStatusCode} to {nextBlockStatusCodeList}.
Update the status transitions allowed from {srcBlockStatusCode}.
PUT
/hotels/{hotelId}/blockCutoffScheduleRange
Set a cutoff schedule over a date range · Set block cutoff schedule range
#
Ask an LLM
“Can I apply cutoff days to blocks across a whole date range?”
“How do I set default cutoff days per room type for a period?”
Tell an agent
Set the block cutoff schedule range at hotel {hotelId} using {criteria}.
Apply cutoff days over a stay date range at hotel {hotelId}.
Ask an LLM
“How many rooms are we allowed to sell to groups on each night?”
“What's the block sales allowance by room type for the next 90 days?”
Tell an agent
Show block sales allowance at hotel {hotelId} from {startDateRange} to {endDateRange}.
Get sales allowance for room types {roomTypesCodes} at hotel {hotelId}.
GET
/hotels/{hotelId}/blockSalesAllowance/activityLog
Review the block sales allowance activity log · Get the Block Sales Allowance activity log
#
Ask an LLM
“Who changed the block sales allowance and when?”
“Can I see the history of sales allowance changes for a date?”
Tell an agent
Show the sales allowance activity log for hotel {hotelId}.
List sales allowance changes made by user {userId} at hotel {hotelId}.
DELETE
/hotels/{hotelId}/blockSalesAllowanceRange
Delete block sales allowance for a date range · Delete block sales allowance range
#
Ask an LLM
“How do I clear the sales allowance for a range of dates?”
“Can I remove the allowance only on weekends within a date range?”
Tell an agent destructive · confirm first
Delete block sales allowance at hotel {hotelId} from {startDate} to {endDate}.
Clear Saturday sales allowances at hotel {hotelId} between {startDate} and {endDate}.
PUT
/hotels/{hotelId}/blockSalesAllowanceRange
Set block sales allowance for a date range · Set block sales allowance range
#
Ask an LLM
“How do I cap group room sales across a range of dates?”
“Can I set the sales allowance for many nights in one request?”
Tell an agent
Set block sales allowance at hotel {hotelId} using {criteria}.
Raise the group sales allowance for next month at hotel {hotelId}.
GET
/hotels/{hotelId}/cutoffSchedules
List block cutoff schedule codes · Get block cutoff schedule codes
#
Ask an LLM
“What cutoff schedule codes are configured at a property?”
“Which cutoff schedules start after a certain date?”
Tell an agent
List cutoff schedule codes at hotel {hotelId}.
Show cutoff schedules {cutoffCodes} at hotel {hotelId}.
POST
/hotels/{hotelId}/cutoffSchedules
Create a block cutoff schedule code · Create a block cutoff schedule code
#
Ask an LLM
“How do I create a new cutoff schedule for group blocks?”
“Can I define a cutoff code with default cutoff days per room type?”
Tell an agent
Create cutoff schedule code {cutoffCodes} at hotel {hotelId}.
Add a new 21-day cutoff schedule at hotel {hotelId}.
GET
/hotels/{hotelId}/cutoffSchedules/{cutoffCodeId}
Get the details of a cutoff schedule · Get cutoff Schedules Details for a cutoff schedule code
#
Ask an LLM
“What cutoff days apply per stay date and room type under a cutoff code?”
“Can I see the day-by-day detail of one cutoff schedule?”
Tell an agent
Show the details of cutoff schedule {cutoffCodeId} at hotel {hotelId}.
List stay dates and cutoff days under code {cutoffCodeId}.
PUT
/hotels/{hotelId}/cutoffSchedules/{cutoffCodeId}
Change a block cutoff schedule code · Change block cutoff schedule code
#
Ask an LLM
“How do I edit an existing cutoff schedule code?”
“Can I change the cutoff days on a schedule already in use?”
Tell an agent
Update cutoff schedule {cutoffCodeId} at hotel {hotelId} with {cutoffCodes}.
Change the cutoff days on schedule {cutoffCodeId}.
DELETE
/hotels/{hotelId}/cutoffSchedules/{cutoffCodeId}
Delete a cutoff schedule code · Delete cutoff schedule code
#
Ask an LLM
“How do I remove a cutoff schedule we no longer apply to blocks?”
“Can I delete a cutoff schedule code at a property?”
Tell an agent destructive · confirm first
Delete cutoff schedule {cutoffCodeId} at hotel {hotelId}.
Remove cutoff code {cutoffCodeId} from configuration.
Ask an LLM
“Who are the sales managers assigned to a property?”
“Can I look up one hotel's sales manager by last name?”
Tell an agent
List the sales managers at hotel {hotelId}.
Find sales managers named {lastName} at hotel {hotelId}.
POST
/hotels/{hotelId}/salesManagers/searches
Search a hotel's sales managers with a body · Get Sales Managers by Hotel
#
Ask an LLM
“Can I send a search request body to find a property's sales managers by owner code?”
“Is there a POST search for one hotel's sales managers?”
Tell an agent
Run a POST search for sales managers with owner codes {ownerCodes} at hotel {hotelId}.
Search hotel {hotelId}'s sales managers by first name {firstName} via the searches endpoint.
GET
/hotels/{hotelId}/salesManagers/{salesManagerId}/salesManagerGoals
Get a sales manager's goals at a hotel · Get Sales Manager Goals by Hotel
#
Ask an LLM
“What revenue and room night goals does a sales manager have at a property?”
“Can I see only a sales manager's future goals for one hotel?”
Tell an agent
Show goals for sales manager {salesManagerId} at hotel {hotelId}.
List future goals of sales manager {salesManagerId} at hotel {hotelId}.
POST
/hotels/{hotelId}/salesManagers/{salesManagerId}/salesManagerGoals
Create goals for a sales manager · Create Sales Manager Goals
#
Ask an LLM
“How do I set new sales goals for a sales manager?”
“Can I add quarterly targets to a sales manager's record?”
Tell an agent
Create goals {salesManagerGoals} for sales manager {salesManagerId} at hotel {hotelId}.
Add new sales targets for manager {salesManagerId}.
PUT
/hotels/{hotelId}/salesManagers/{salesManagerId}/salesManagerGoals/{salesGoalId}
Update a sales manager's goal · Update Sales Manager Goal in a hotel by ID
#
Ask an LLM
“How do I revise an existing goal for a sales manager?”
“Can I change one specific sales goal by its goal ID?”
Tell an agent
Update goal {salesGoalId} for sales manager {salesManagerId} at hotel {hotelId}.
Change goal {salesGoalId} of manager {salesManagerId} to {salesManagerGoals}.
Ask an LLM
“How do I set up a wash schedule that releases unsold group rooms over time?”
“Can I create a new wash schedule code for blocks?”
Tell an agent
Create wash schedule {washCodes} at hotel {hotelId}.
Add a new block wash schedule at hotel {hotelId}.
DELETE
/hotels/{hotelId}/washSchedules/{washScheduleCode}
Delete a block wash schedule · Delete block wash schedule
#
Ask an LLM
“How do I remove a wash schedule we no longer use?”
“Can I delete a block wash schedule code?”
Tell an agent destructive · confirm first
Delete wash schedule {washScheduleCode} at hotel {hotelId}.
Remove wash code {washScheduleCode}.
PUT
/hotels/{hotelId}/washSchedules/{washScheduleCode}
Change an existing block wash schedule · Change block wash schedule
#
Ask an LLM
“How do I edit the wash percentages on an existing wash schedule?”
“Can I change a wash schedule that is already configured?”
Tell an agent
Update wash schedule {washScheduleCode} at hotel {hotelId}.
Change existing wash schedule {washScheduleCode} to {washCodes}.
Ask an LLM
“Who are the sales managers across several of our properties?”
“Can I list sales managers for multiple hotels at once?”
Tell an agent
List sales managers at hotels {hotelIds}.
Find sales managers with owner codes {ownerCodes} across hotels {hotelIds}.
Ask an LLM
“Is there a POST search that finds sales managers across many hotels?”
“Can I send a multi-property sales manager search in the request body?”
Tell an agent
Run a multi-hotel POST search for sales managers at {hotelIds}.
Search sales managers named {lastName} across hotels {hotelIds} via the searches endpoint.
DELETE
/salesManagers/{salesManagerId}/salesManagerGoals
Delete several sales manager goals · Delete Sale Manager Goals
#
Ask an LLM
“How do I delete several goals from a sales manager at once?”
“Can I clear a list of goals off a sales manager?”
Tell an agent destructive · confirm first
Delete goals {salesGoalId} for sales manager {salesManagerId}.
Remove the listed goals from manager {salesManagerId}.
GET
/salesManagers/{salesManagerId}/salesManagerGoals
Get a sales manager's goals across hotels · Get Sales Manager Goals
#
Ask an LLM
“What goals does a sales manager have across all the hotels they cover?”
“Can I see a sales manager's goals for several properties together?”
Tell an agent
Show goals for sales manager {salesManagerId} across all their hotels.
List goals of sales manager {salesManagerId} for hotels {hotelIds}.
DELETE
/salesManagers/{salesManagerId}/salesManagerGoals/{salesGoalId}
Delete one sales manager goal · Delete Sale Manager Goal
#
Ask an LLM
“How do I delete a single goal by its goal ID?”
“Can I remove just one target from a sales manager?”
Tell an agent destructive · confirm first
Delete goal {salesGoalId} of sales manager {salesManagerId}.
Remove only goal {salesGoalId} from manager {salesManagerId}.
Ask an LLM
“Is the block configuration service up?”
“How can I health-check the block config service?”
Tell an agent
Ping the block configuration service for hotel {hotel}.
Check whether block config is responding.
PUT
/upsert/hotels/{hotelId}/washSchedules/{washScheduleCode}
Create or update a wash schedule · Create/Change block wash schedule
#
Ask an LLM
“Can I save a wash schedule whether or not it already exists?”
“Is there an upsert for block wash schedules?”
Tell an agent
Upsert wash schedule {washScheduleCode} at hotel {hotelId}.
Create or replace wash schedule {washScheduleCode} with {washCodes}.
Ask an LLM
“What wash schedules are configured across our hotels?”
“Can I search wash schedules with a wildcard?”
Tell an agent
List wash schedules for hotels {hotelIds}.
Show wash schedules matching {wildCard}.
Documentation
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_distribution_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_nor1_integrated_upsell_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_property_apis.htm