Oracle Hospitality Commissions API
Commission web service provides commission processing service like payment processing, payment activity and search.
Operations 23
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
GET
/hotels/{hotelId}/bankAccounts
List commission bank accounts · Operation to fetch bank accounts
#
Ask an LLM
“Which bank accounts does my hotel pay travel agent commissions from?”
“Can I filter commission bank accounts by currency using query parameters?”
Tell an agent
List commission bank accounts for hotel {hotel}.
Show bank accounts at {hotel} in currency {currency} via query filters.
POST
/hotels/{hotelId}/bankAccounts/searches
Search commission bank accounts by criteria · Operation to fetch bank accounts
#
Ask an LLM
“How do I search commission bank accounts by bank name with a POST body?”
“Can I look up a bank account by its account number in a search request?”
Tell an agent
Search bank accounts at hotel {hotel} for bank name {bank}.
Run a bank account search at {hotel} for account number {account}.
GET
/hotels/{hotelId}/bankAccounts/{bankAccountId}/agents/{agentId}/reservationsForCommissions
List a travel agent's commissionable reservations · Operation to fetch Reservations for Commissions associated to a Travel Agent
#
Ask an LLM
“Which reservations is a travel agent owed commission on?”
“Can I list only the reservations where the commission is already paid?”
Tell an agent
List commission reservations for agent {agent} on bank account {account} at hotel {hotel}.
Show agent {agent}'s commission reservations for guest {guest}.
POST
/hotels/{hotelId}/bankAccounts/{bankAccountId}/agents/{agentId}/reservationsForCommissions/searches
Search a travel agent's commission reservations · Operation to fetch Reservations for Commissions associated to a Travel Agent
#
Ask an LLM
“How do I search an agent's commission reservations by confirmation number in a request body?”
“Can I search for commission reservations that are on hold?”
Tell an agent
Search commission reservations for agent {agent} on account {account} at {hotel} by confirmation {confirmation}.
Run a search for agent {agent}'s on-hold commission reservations.
PUT
/hotels/{hotelId}/bankAccounts/{bankAccountId}/commissionChecks
Change a commission check · Operation to change commission check
#
Ask an LLM
“How do I update a commission check issued from a bank account?”
“Can I correct the details on a commission check after it was generated?”
Tell an agent
Change the commission check on bank account {account} at hotel {hotel}.
Update commission check details for account {account} using {criteria}.
GET
/hotels/{hotelId}/bankAccounts/{bankAccountId}/commissionPayments
View commission payment activity for an account · Operation to fetch commission payments activity
#
Ask an LLM
“What commission payments have gone out from a bank account?”
“Can I find a commission payment by check number or payee?”
Tell an agent
Show commission payment activity for bank account {account} at hotel {hotel}.
Find commission payments on account {account} with check number {check}.
PUT
/hotels/{hotelId}/bankAccounts/{bankAccountId}/commissionPayments
Update commission payment activity by range · Operation to change commission payment activity by range
#
Ask an LLM
“How do I update a range of commission payment records at once?”
“Can I change the status of commission payments across a check range?”
Tell an agent
Change commission payment activity by range on bank account {account} at hotel {hotel}.
Update commission payment activity on account {account} matching {criteria}.
PUT
/hotels/{hotelId}/bankAccounts/{bankAccountId}/reprintCommission
Reprint a range of commission checks · Operation to reprint commission check by range
#
Ask an LLM
“How do I reprint commission checks that failed to print?”
“Can I reprint a whole range of commission checks from one bank account?”
Tell an agent
Reprint commission checks by range for bank account {account} at hotel {hotel}.
Reprint the commission checks on account {account} matching {criteria}.
GET
/hotels/{hotelId}/bankAccounts/{bankAccountId}/travelAgentsForCommissions
List travel agents with commissions on an account · Operation to fetch Travel Agents associated with commissions for the given bank…
#
Ask an LLM
“Which travel agents have commissions tied to this bank account?”
“Who are the agents I need to pay from a given commission account?”
Tell an agent
List travel agents with commissions on bank account {account} at hotel {hotel}.
Show which agents are paid from account {account}.
PUT
/hotels/{hotelId}/commissionAgent/{commissionAgentId}/commissions
Attach a commission agent to reservations · Operation to associate commission agent to reservations
#
Ask an LLM
“How do I link a travel agent to reservations so they earn commission?”
“Can I attach one commission agent to several reservations at once?”
Tell an agent
Associate commission agent {agent} at hotel {hotel} with reservations {reservations}.
Attach agent {agent} to these reservations for commission.
DELETE
/hotels/{hotelId}/commissionAgent/{commissionAgentId}/commissions
Detach a commission agent from reservations · Operation to remove commission agent from reservations
#
Ask an LLM
“How do I take a travel agent off a reservation so no commission is paid?”
“Can I remove a commission agent from one specific reservation?”
Tell an agent destructive · confirm first
Remove commission agent {agent} from reservations at hotel {hotel}.
Detach agent {agent} from reservation {reservation}.
DELETE
/hotels/{hotelId}/commissionChecks
Discard generated commission checks · Operation to discard commission checks
#
Ask an LLM
“How do I throw away a batch of commission checks before they are paid?”
“Can I discard commission checks starting from a particular check number?”
Tell an agent destructive · confirm first
Discard commission checks at hotel {hotel} for bank account {account}.
Discard commission checks in batch {batch} from check {fromCheck}.
PUT
/hotels/{hotelId}/commissionPayments
Process commission payments · Operation to process commission payments
#
Ask an LLM
“How do I run the commission payment process to pay travel agents?”
“What criteria control which commissions get paid in a payment run?”
Tell an agent
Process commission payments at hotel {hotel}.
Run commission payments at {hotel} using {criteria}.
Ask an LLM
“What commissions are recorded for my hotel's travel agents?”
“Can I filter commissions by agent or by payment batch?”
Tell an agent
List commissions at hotel {hotel}.
Show commissions at {hotel} for agent {agent}.
PUT
/hotels/{hotelId}/commissions
Calculate commissions for a hotel · Operation to calculate commissions
#
Ask an LLM
“How do I recalculate all travel agent commissions for my property?”
“Can I trigger a commission calculation run before paying agents?”
Tell an agent
Calculate commissions for hotel {hotel}.
Run the commission calculation at {hotel} now.
POST
/hotels/{hotelId}/commissions/instructions
Set commission processing instructions for agents · Operation to set processing instructions
#
Ask an LLM
“How do I tell the system how to process commissions for specific agents?”
“Can I set processing instructions for several travel agents in one call?”
Tell an agent
Set commission processing instructions at hotel {hotel} for agents {agents}.
Apply processing instructions to these commission agents at {hotel}.
GET
/hotels/{hotelId}/commissions/{commissionId}
Get one commission record · Operation to fetch commission
#
Ask an LLM
“What are the details of a single commission record?”
“How much commission was calculated on one specific entry?”
Tell an agent
Get commission {commission} at hotel {hotel}.
Show me the details of commission {commission}.
PUT
/hotels/{hotelId}/commissions/{commissionId}
Update a commission record · Operation to change commission
#
Ask an LLM
“How do I correct the amount or details on an existing commission?”
“Can I edit a single commission before it is paid?”
Tell an agent
Update commission {commission} at hotel {hotel} with {detail}.
Change the details on commission {commission}.
DELETE
/hotels/{hotelId}/commissions/{commissionId}
Remove a commission record · Operation to remove commission
#
Ask an LLM
“How do I delete a commission that should not be paid?”
“Can I record a reason when I detach a commission?”
Tell an agent destructive · confirm first
Remove commission {commission} at hotel {hotel}.
Delete commission {commission} with the reason {reason}.
PUT
/hotels/{hotelId}/commissions/{commissionId}/commissionCodes/{commissionCode}/recalculate
Recalculate a commission after a code change · Operation to recalculate commission on code change
#
Ask an LLM
“How do I recompute a commission after switching its commission code?”
“Does changing the commission code on a record recalculate the amount?”
Tell an agent
Recalculate commission {commission} at hotel {hotel} using commission code {code}.
Switch commission {commission} to code {code} and recalculate it.
GET
/hotels/{hotelId}/reservations/{reservationId}/commissionNotes
Get commission notes on a reservation · Operation to fetch commission notes
#
Ask an LLM
“What commission notes were left on a reservation?”
“Can I read the comments explaining a reservation's commission?”
Tell an agent
Get commission notes for reservation {reservation} at hotel {hotel}.
Show the commission notes on reservation {reservation}.
GET
/hotels/{hotelId}/reservations/{reservationId}/commissionPaymentDetails
Get commission payment details for a reservation · Fetch Commission Payment Details
#
Ask an LLM
“Has the commission on a reservation been paid, and how?”
“Where can I see payment details of the commission for one booking?”
Tell an agent
Get commission payment details for reservation {reservation} at hotel {hotel}.
Show how the commission on reservation {reservation} was paid.
Ask an LLM
“Is the commissions service available right now?”
“Which version of the commissions service is running?”
Tell an agent
Ping the commissions service.
Get the commissions service version as hotel {hotel}.
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