# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Oracle Hospitality Cashiering API version: 1.0.0 extends: openapi/oracle-hospitality-cashiering-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 203 - target: $.paths['/hotels/{hotelId}/memberships/{membershipId}/compRedemptions'].get update: x-apievangelist-phrasing: intent: List comp redemptions for a PTS member effect: read questions: - What complimentary redemptions can a guest with a PTS membership use? - Can I see the comp buckets available to a player's membership before redeeming? instructions: - text: Show the complimentary redemptions available to membership {membershipId} at hotel {hotelId}. slots: membershipId: path.membershipId hotelId: path.hotelId - text: Fetch comp redemption options for PTS member {membershipId}. slots: membershipId: path.membershipId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/memberships/{membershipId}/compRedemptionAuthorizations'].put update: x-apievangelist-phrasing: intent: Authorize comp redemptions for a PTS member effect: write questions: - How do I get complimentary redemptions approved for a PTS member before posting them? - Is there a step to authorize a player's comp redemption ahead of charging it? instructions: - text: Authorize the comp redemptions for membership {membershipId} at hotel {hotelId}. slots: membershipId: path.membershipId hotelId: path.hotelId - text: Request authorization of {compRedemptions} for PTS member {membershipId}. slots: compRedemptions: requestBody.compRedemptions membershipId: path.membershipId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/memberships/{membershipId}/compRedemptionPostings'].post update: x-apievangelist-phrasing: intent: Post comp redemptions against a membership effect: write questions: - How can I post a complimentary redemption directly against a guest's PTS membership number? - Can comp redemptions be posted by membership rather than by reservation? instructions: - text: Post comp redemptions to membership {membershipId} at hotel {hotelId}. slots: membershipId: path.membershipId hotelId: path.hotelId - text: Post these redemptions {compRedemptions} against PTS member {membershipId}'s account. slots: compRedemptions: requestBody.compRedemptions membershipId: path.membershipId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/memberships/{membershipId}/compRedemptionReversals'].post update: x-apievangelist-phrasing: intent: Reverse comp redemptions on a membership effect: destructive questions: - How do I undo a complimentary redemption that was posted to a player's membership? - Can a PTS membership comp redemption be reversed using just the membership number? instructions: - text: Reverse the comp redemptions posted to membership {membershipId} at hotel {hotelId}. slots: membershipId: path.membershipId hotelId: path.hotelId - text: Undo redemptions {compRedemptions} on PTS member {membershipId}. slots: compRedemptions: requestBody.compRedemptions membershipId: path.membershipId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/asyncCompPostingsApproval'].put update: x-apievangelist-phrasing: intent: Submit bulk comp postings for vendor approval effect: write questions: - Can I send a large batch of comp postings to the vendor for approval asynchronously? - What's the way to queue many comp postings for vendor sign-off at once? instructions: - text: Submit bulk comp postings for asynchronous vendor approval at hotel {hotelId}. slots: hotelId: path.hotelId - text: Queue comp postings {compPostings} for vendor approval in the background. slots: compPostings: requestBody.compPostings method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compPostingsApproval'].put update: x-apievangelist-phrasing: intent: Request approval of comp postings effect: write questions: - How do I request approval for comp postings right away rather than in bulk? - Which call asks for comp postings to be approved synchronously? instructions: - text: Request approval for comp postings {compPostings} at hotel {hotelId}. slots: compPostings: requestBody.compPostings hotelId: path.hotelId - text: Send the pending comp postings at hotel {hotelId} for approval now. slots: hotelId: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compPostingsReversal'].put update: x-apievangelist-phrasing: intent: Request reversal of comp postings effect: destructive questions: - How can I reverse comp postings that were already approved? - Is it possible to request a reversal of several comp postings together? instructions: - text: Request reversal of comp postings {compPostings} at hotel {hotelId}. slots: compPostings: requestBody.compPostings hotelId: path.hotelId - text: Reverse the comp postings I list at hotel {hotelId}. slots: hotelId: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/cashierReportPostings'].get update: x-apievangelist-phrasing: intent: Get postings for a cashier report effect: read questions: - Which postings make up a cashier report for a given date range? - Can I pull cashier report postings filtered by closure number or drop bag? instructions: - text: Get cashier report postings at hotel {hotelId} from {startDate} to {endDate}. slots: hotelId: query.hotelId startDate: query.startDate endDate: query.endDate - text: Pull cashier report postings for cashier {cashierId} at hotel {hotelId}. slots: cashierId: query.cashierId hotelId: query.hotelId method: generated generated: '2026-09-26' - target: $.paths['/cashiers/{cashierId}/closure'].put update: x-apievangelist-phrasing: intent: Close a cashier effect: write questions: - How do I close out a cashier at the end of a shift? - Does closing a cashier need the cashier lock handle I acquired? instructions: - text: Close cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: header.x-hotelid - text: Close cashier {cashierId} using lock handle {cashierLockHandle}. slots: cashierId: path.cashierId cashierLockHandle: requestBody.cashierLockHandle method: generated generated: '2026-09-26' - target: $.paths['/cashiers/{cashierId}/locks'].get update: x-apievangelist-phrasing: intent: Acquire a lock on a cashier effect: write questions: - How do I lock a cashier before starting its closure? - Can I obtain a cashier lock so nobody else posts while I close? instructions: - text: Acquire a lock on cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: header.x-hotelid - text: Lock cashier {cashierId} so I can close it. slots: cashierId: path.cashierId method: generated generated: '2026-09-26' - target: $.paths['/cashiers/{cashierId}/locks'].delete update: x-apievangelist-phrasing: intent: Break an existing cashier lock effect: destructive questions: - A cashier is stuck locked by someone else — how can I force the lock off? - Can I break a cashier lock using only the cashier ID? instructions: - text: Break the lock on cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: header.x-hotelid - text: Force-remove whatever lock is held on cashier {cashierId}. slots: cashierId: path.cashierId method: generated generated: '2026-09-26' - target: $.paths['/cashiers/{cashierId}/transactions'].get update: x-apievangelist-phrasing: intent: List a cashier's transactions effect: read questions: - What transactions has a particular cashier posted during their shift? - Can I filter a cashier's transactions by closure number or bag number? instructions: - text: List transactions for cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: header.x-hotelid - text: Show cashier {cashierId}'s transactions for closure {closureNo}. slots: cashierId: path.cashierId closureNo: query.closureNo method: generated generated: '2026-09-26' - target: $.paths['/cashiersLock/{lockId}'].delete update: x-apievangelist-phrasing: intent: Release a cashier lock by lock ID effect: destructive questions: - How do I release the cashier lock I hold once I'm done? - Can a cashier lock be released using the lock ID it returned? instructions: - text: Release cashier lock {lockId} at hotel {hotelId}. slots: lockId: path.lockId hotelId: header.x-hotelid - text: Let go of lock {lockId} on the cashier. slots: lockId: path.lockId method: generated generated: '2026-09-26' - target: $.paths['/compAccountingJournal'].get update: x-apievangelist-phrasing: intent: Read the comp journal via the deprecated endpoint effect: read questions: - Is the older, deprecated comp accounting journal call still usable for legacy integrations? - Which deprecated call did comp journal lookups use before the posting journal replaced it? instructions: - text: Use the deprecated comp accounting journal call at hotel {hotelId} from {startDate} to {endDate}. slots: hotelId: query.hotelId startDate: query.startDate endDate: query.endDate - text: Pull legacy comp accounting journal rows for room {filterRoomNumber} via the deprecated endpoint. slots: filterRoomNumber: query.filterRoomNumber method: generated generated: '2026-09-26' - target: $.paths['/fbaReimbursements'].post update: x-apievangelist-phrasing: intent: Create a food and beverage allowance reimbursement effect: write questions: - How do I record a reimbursement for food and beverage allowance certificates? - Can I reconcile FBA certificates as a reimbursement? instructions: - text: Create an FBA reimbursement at hotel {hotelId}. slots: hotelId: header.x-hotelid - text: Record an FBA reimbursement for certificate reconciliation types {certificateReconciliationTypes}. slots: certificateReconciliationTypes: requestBody.certificateReconciliationTypes method: generated generated: '2026-09-26' - target: $.paths['/fbaSettlements'].post update: x-apievangelist-phrasing: intent: Create a food and beverage allowance settlement effect: write questions: - How can I settle food and beverage allowance certificates? - What records an FBA settlement instead of a reimbursement? instructions: - text: Create an FBA settlement at hotel {hotelId}. slots: hotelId: header.x-hotelid - text: Settle FBA certificates of reconciliation types {certificateReconciliationTypes}. slots: certificateReconciliationTypes: requestBody.certificateReconciliationTypes method: generated generated: '2026-09-26' - target: $.paths['/foreignCurrency'].put update: x-apievangelist-phrasing: intent: Calculate a foreign currency exchange amount effect: read questions: - How much local currency does a guest get for a foreign cash amount? - Can the exchange calculation include the exchange commission? instructions: - text: Calculate the foreign currency exchange {exchange} at hotel {hotelId}. slots: exchange: requestBody.exchange hotelId: header.x-hotelid - text: Work out exchange {exchange} with commission added. slots: exchange: requestBody.exchange method: generated generated: '2026-09-26' - target: $.paths['/foreignCurrencyExchange'].post update: x-apievangelist-phrasing: intent: Record a foreign currency exchange effect: write questions: - How do I record that a guest exchanged foreign cash at the front desk? - Can several currency exchanges be posted in one request? instructions: - text: Post a foreign currency exchange at hotel {hotelId}. slots: hotelId: header.x-hotelid - text: Record these currency exchanges {foreignCurrencyExchangeList}. slots: foreignCurrencyExchangeList: requestBody.foreignCurrencyExchangeList method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/advanceFolio/batchJobs'].post update: x-apievangelist-phrasing: intent: Start a batch advance folio job effect: write questions: - How do I generate advance folios for many reservations in one batch job? - Is there a batch job for advance folios? instructions: - text: Start a batch advance folio job at hotel {hotelId}. slots: hotelId: path.hotelId - text: Run batch advance folio {batchAdvanceFolio}. slots: batchAdvanceFolio: requestBody.batchAdvanceFolio method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/articlesSale'].post update: x-apievangelist-phrasing: intent: Post an articles sale effect: write questions: - How do I ring up a sale of articles like minibar items or merchandise? - Can I post an article sale that isn't tied to a room charge flow? instructions: - text: Post an articles sale at hotel {hotelId}. slots: hotelId: path.hotelId - text: Record an article sale with criteria {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/authorizers/credits'].get update: x-apievangelist-phrasing: intent: Get comp authorizers' credit information effect: read questions: - How much comp credit does each authorizer have available for a period? - Can I see credit details for a specific comp authorizer code? instructions: - text: Get authorizer credit info at hotel {hotelId} from {startDate} to {endDate}. slots: hotelId: path.hotelId startDate: query.startDate endDate: query.endDate - text: Show credit details for authorizer {code}. slots: code: query.code method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/autoCheckoutReservations/batchJobs'].post update: x-apievangelist-phrasing: intent: Start an auto checkout batch job effect: write questions: - How can I check out a batch of departing reservations automatically? - Is there a batch job that runs auto checkout for reservations? instructions: - text: Start an auto checkout batch for reservations at hotel {hotelId}. slots: hotelId: path.hotelId - text: Auto check out reservations matching {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/autoSettlements/batchJobs'].post update: x-apievangelist-phrasing: intent: Start a batch auto settlement job effect: write questions: - How do I run auto settlement across many folios in a batch? - Can auto settlement be kicked off as a background batch job? instructions: - text: Start a batch auto settlement at hotel {hotelId}. slots: hotelId: path.hotelId - text: Run auto settlement for folios matching {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/batchDeposits'].post update: x-apievangelist-phrasing: intent: Create batch deposits effect: write questions: - How do I post deposits for many reservations at once? - Can I take a batch deposit across several reservations in one call? instructions: - text: Create batch deposits at hotel {hotelId}. slots: hotelId: path.hotelId - text: Post batch deposit {batchDeposit}. slots: batchDeposit: requestBody.batchDeposit method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bedTax'].get update: x-apievangelist-phrasing: intent: Get bed tax information effect: read questions: - What bed tax registration details are on file for arrivals on a date? - Can I look up bed tax info by arrival date? instructions: - text: Get bed tax information at hotel {hotelId} for arrivals on {arrival}. slots: hotelId: path.hotelId arrival: query.arrival - text: Show the bed tax records at hotel {hotelId}. slots: hotelId: path.hotelId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bedTax'].post update: x-apievangelist-phrasing: intent: Create bed tax information effect: write questions: - How do I register new bed tax information for guests? - Can I add a bed tax registration record? instructions: - text: Create bed tax information at hotel {hotelId}. slots: hotelId: path.hotelId - text: Add bed tax record {bedTaxInfoType}. slots: bedTaxInfoType: requestBody.bedTaxInfoType method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bedTax/{taxRegistraitionNo}'].put update: x-apievangelist-phrasing: intent: Update a bed tax registration effect: write questions: - How do I correct an existing bed tax registration? - Can I change bed tax details using the tax registration number? instructions: - text: Update bed tax registration {taxRegistraitionNo} at hotel {hotelId}. slots: taxRegistraitionNo: path.taxRegistraitionNo hotelId: path.hotelId - text: Change bed tax registration {taxRegistraitionNo} to {bedTaxInfoType}. slots: taxRegistraitionNo: path.taxRegistraitionNo bedTaxInfoType: requestBody.bedTaxInfoType method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bedTax/{taxRegistraitionNo}'].delete update: x-apievangelist-phrasing: intent: Delete a bed tax registration effect: destructive questions: - How do I remove a bed tax registration that was entered by mistake? - Can a bed tax record be deleted by its registration number? instructions: - text: Delete bed tax registration {taxRegistraitionNo} at hotel {hotelId}. slots: taxRegistraitionNo: path.taxRegistraitionNo hotelId: path.hotelId - text: Remove bed tax record {taxRegistraitionNo}. slots: taxRegistraitionNo: path.taxRegistraitionNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/billingCharges'].put update: x-apievangelist-phrasing: intent: Change billing charges effect: write questions: - How do I edit billing charges that were already posted? - Can I change several billing charges together by criteria? instructions: - text: Change billing charges at hotel {hotelId}. slots: hotelId: path.hotelId - text: Update the billing charges matching {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bulkCCSettlements/{batchId}/status'].get update: x-apievangelist-phrasing: intent: Check status of a batch card settlement job effect: read questions: - Has my batch credit card settlement job finished yet? - Can I check the progress of a bulk card settlement by batch ID? instructions: - text: Check the status of batch card settlement {batchId} at hotel {hotelId}. slots: batchId: path.batchId hotelId: path.hotelId - text: Is bulk settlement batch {batchId} done — show its status. slots: batchId: path.batchId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/bulkPrepaidCards'].post update: x-apievangelist-phrasing: intent: Create multiple prepaid cards effect: write questions: - How do I issue a large number of prepaid cards in one go? - Can I create prepaid cards in bulk with card details? instructions: - text: Create prepaid cards in bulk at hotel {hotelId}. slots: hotelId: path.hotelId - text: Issue multiple prepaid cards with details {cardDetails}. slots: cardDetails: requestBody.cardDetails method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/cashiers/{cashierId}/closure'].get update: x-apievangelist-phrasing: intent: Get closure details for a cashier effect: read questions: - What does a cashier's closure summary look like before I close? - Can I preview a cashier closure using my lock handle? instructions: - text: Get closure details for cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: path.hotelId - text: Preview closing cashier {cashierId} with lock handle {cashierLockHandle}. slots: cashierId: path.cashierId cashierLockHandle: query.cashierLockHandle method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/cashiers/{cashierId}/closureReports'].get update: x-apievangelist-phrasing: intent: List a cashier's closure reports effect: read questions: - Which closure reports are available for a cashier? - Can I find a cashier's closure reports by closure number? instructions: - text: List closure reports for cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: path.hotelId - text: Show closure report {closureNo} for cashier {cashierId}. slots: closureNo: query.closureNo cashierId: path.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/cashiers/{cashierId}/folioTaxPayments'].put update: x-apievangelist-phrasing: intent: Reverse a folio tax payment effect: destructive questions: - How do I reverse a folio tax payment a cashier posted? - Can a cashier undo a folio tax payment with reverse criteria? instructions: - text: Reverse a folio tax payment for cashier {cashierId} at hotel {hotelId}. slots: cashierId: path.cashierId hotelId: path.hotelId - text: Undo folio tax payment {reverseCriteria} under cashier {cashierId}. slots: reverseCriteria: requestBody.reverseCriteria cashierId: path.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/cashierslock/{lockId}'].put update: x-apievangelist-phrasing: intent: Extend a cashier lock effect: write questions: - My cashier lock is about to expire — can I extend it? - How much extra time can I add to a cashier lock? instructions: - text: Extend cashier lock {lockId} at hotel {hotelId}. slots: lockId: path.lockId hotelId: path.hotelId - text: Add {additionalTimeToLive} more time to lock {lockId}. slots: additionalTimeToLive: requestBody.additionalTimeToLive lockId: path.lockId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/cashsurcharge'].get update: x-apievangelist-phrasing: intent: Get the surcharge for a cash payment effect: read questions: - Is there a surcharge when a guest pays cash, and how much? - Can I calculate the cash surcharge for a specific amount and currency? instructions: - text: Get the cash surcharge at hotel {hotelId} for {trxAmount} {currencyCode}. slots: hotelId: path.hotelId trxAmount: query.trxAmount currencyCode: query.currencyCode - text: Check cash surcharge for payment method {paymentMethod}. slots: paymentMethod: query.paymentMethod method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/ccSettlement'].post update: x-apievangelist-phrasing: intent: Settle a credit card payment effect: write questions: - How do I settle a single credit card transaction? - Can I push one credit card settlement outside the batch job? instructions: - text: Create a credit card settlement at hotel {hotelId}. slots: hotelId: path.hotelId - text: Settle card transaction {creditCardSettlement}. slots: creditCardSettlement: requestBody.creditCardSettlement method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/ccSettlements/batchJobs'].post update: x-apievangelist-phrasing: intent: Start a batch credit card settlement job effect: write questions: - How can I settle all outstanding credit card transactions in a batch? - Is there a batch job for settling many card payments? instructions: - text: Start a batch credit card settlement job at hotel {hotelId}. slots: hotelId: path.hotelId - text: Run batch card settlements for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/check/{checkNumber}'].get update: x-apievangelist-phrasing: intent: Get details of a guest check effect: read questions: - What's on a restaurant guest check by its check number? - Can I look up a guest check's details? instructions: - text: Get details of check {checkNumber} at hotel {hotelId}. slots: checkNumber: path.checkNumber hotelId: path.hotelId - text: Show guest check {checkNumber}. slots: checkNumber: path.checkNumber method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/check/{checkNumber}'].put update: x-apievangelist-phrasing: intent: Update a guest check effect: write questions: - How do I update the details on an existing guest check? - Can I change which reservation a guest check belongs to? instructions: - text: Update guest check {checkNumber} at hotel {hotelId}. slots: checkNumber: path.checkNumber hotelId: path.hotelId - text: Change check {checkNumber} to reservation {reservationId}. slots: checkNumber: path.checkNumber reservationId: requestBody.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/check/{checkNumber}'].post update: x-apievangelist-phrasing: intent: Post a guest check to a reservation effect: write questions: - How do I post an outlet guest check onto a reservation's bill? - Can a new guest check be posted with its line details? instructions: - text: Post guest check {checkNumber} at hotel {hotelId}. slots: checkNumber: path.checkNumber hotelId: path.hotelId - text: Post check {checkNumber} to reservation {reservationId}'s bill. slots: checkNumber: path.checkNumber reservationId: requestBody.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/check/{checkNumber}/charges'].delete update: x-apievangelist-phrasing: intent: Void charges posted from a check effect: destructive questions: - How do I void the charges that came from a guest check? - Can I remove a check's charges for a specific amount and revenue date? instructions: - text: Void the charges for check {checkNumber} at hotel {hotelId}. slots: checkNumber: path.checkNumber hotelId: path.hotelId - text: Remove {amount} charged from check {checkNumber} on reservation {reservationId}. slots: amount: query.amount checkNumber: path.checkNumber reservationId: query.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/closureList'].get update: x-apievangelist-phrasing: intent: Look up cashier closures effect: read questions: - Which cashier closures happened on a business date? - Can I search closures by cashier, closure number or bag number? instructions: - text: Look up cashier closures at hotel {hotelId} for business date {closureBusinessDate}. slots: hotelId: path.hotelId closureBusinessDate: query.closureBusinessDate - text: Find closure {closureNo} for cashier {cashierId}. slots: closureNo: query.closureNo cashierId: query.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compAccountingJournal'].get update: x-apievangelist-phrasing: intent: Get the comp posting journal effect: read questions: - Where can I see comp postings journaled over the last 30 days? - Can I page through the comp posting journal, up to 50 entries at a time, by authorizer? instructions: - text: Get the comp posting journal at hotel {hotelId} from {startDate} to {endDate}. slots: hotelId: path.hotelId startDate: query.startDate endDate: query.endDate - text: Show comp posting journal entries for authorizer {authorizerNameCode}, {limit} per page. slots: authorizerNameCode: query.authorizerNameCode limit: query.limit method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compRoutingInstructions'].get update: x-apievangelist-phrasing: intent: List comp routing instructions effect: read questions: - Which reservations have comp routing instructions set up? - Can I list comp routing instructions by guest name or room number? instructions: - text: List comp routing instructions at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show comp routings for guests named {nameWildcard}. slots: nameWildcard: query.nameWildcard method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compRoutingInstructions/searches'].post update: x-apievangelist-phrasing: intent: Search comp routing instructions with a POST body effect: read questions: - Can I search comp routing instructions by sending criteria in a request body? - What if my comp routing filters are too long for a query string? instructions: - text: Search comp routing instructions at hotel {hotelId} with body criteria. slots: hotelId: path.hotelId - text: POST a comp routing search for membership {membershipId}. slots: membershipId: requestBody.membershipId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/compTrxAuthorizers'].get update: x-apievangelist-phrasing: intent: Get authorizers for a comp transaction effect: read questions: - Who can authorize a particular comp transaction? - Can I find comp authorizers by cashier and target folio window? instructions: - text: Get comp transaction authorizers at hotel {hotelId} for cashier {cashierId}. slots: hotelId: path.hotelId cashierId: query.cashierId - text: Find who can authorize comp transaction {transaction}. slots: transaction: query.transaction method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/covers'].get update: x-apievangelist-phrasing: intent: Get covers counted for transactions effect: read questions: - How many covers were recorded for outlet transactions on a date? - Can I see covers for one transaction code? instructions: - text: Get transaction covers at hotel {hotelId} for {coversDate}. slots: hotelId: path.hotelId coversDate: query.coversDate - text: Show covers on {coversDate} for transaction code {transactionCode}. slots: coversDate: query.coversDate transactionCode: query.transactionCode method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/covers'].put update: x-apievangelist-phrasing: intent: Change transaction covers effect: write questions: - How do I correct the number of covers recorded for a transaction? - Can covers info be updated after posting? instructions: - text: Change transaction covers at hotel {hotelId}. slots: hotelId: path.hotelId - text: Update covers to {coversInfo}. slots: coversInfo: requestBody.coversInfo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditBill'].post update: x-apievangelist-phrasing: intent: Create a credit bill effect: write questions: - How do I issue a credit bill against a folio? - Can I generate a credit note for an already billed folio? instructions: - text: Create a credit bill at hotel {hotelId}. slots: hotelId: path.hotelId - text: Issue a credit bill with criteria {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditBill/action/validate'].put update: x-apievangelist-phrasing: intent: Validate a credit bill before issuing it effect: read questions: - Can I check whether a credit bill is allowed before actually creating it? - What validation runs ahead of issuing a credit bill? instructions: - text: Validate a credit bill at hotel {hotelId} without issuing it. slots: hotelId: path.hotelId - text: Dry-run credit bill checks for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditLimitsOveragePayments'].get update: x-apievangelist-phrasing: intent: List guests over their credit limit effect: read questions: - Which in-house guests have gone over their credit limit and owe a payment? - Can I find credit limit overages by guest name or room number? instructions: - text: List credit limit overages at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show overage payments due for room {roomNumberWildCard}. slots: roomNumberWildCard: query.roomNumberWildCard method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditLimitsOveragePayments'].post update: x-apievangelist-phrasing: intent: Collect payments for credit limit overages effect: write questions: - How do I take payment from guests who exceeded their credit limit? - Can I post overage payments for several guests together? instructions: - text: Post credit limit overage payments at hotel {hotelId}. slots: hotelId: path.hotelId - text: Collect overage payments matching {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditcardTransaction/logs'].post update: x-apievangelist-phrasing: intent: Log a credit card vault transaction effect: write questions: - How do I register a card vault HTTP transaction in the log? - Can the tokenization vault's request and response be recorded for audit? instructions: - text: Register a vault transaction log at hotel {hotelId}. slots: hotelId: path.hotelId - text: Log vault message {httpTransactionMessage}. slots: httpTransactionMessage: requestBody.httpTransactionMessage method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/creditcardsurcharge'].get update: x-apievangelist-phrasing: intent: Get the surcharge for a credit card payment effect: read questions: - Will a guest be charged a surcharge for paying by credit card? - Does the card type change the credit card surcharge? instructions: - text: Get the credit card surcharge at hotel {hotelId} for card type {cardType}. slots: hotelId: path.hotelId cardType: query.cardType - text: Check card surcharge for payment method {paymentMethod} at cashier {cashierId}. slots: paymentMethod: query.paymentMethod cashierId: query.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/depositFolio'].get update: x-apievangelist-phrasing: intent: Get a deposit folio effect: read questions: - What's on the deposit folio for a reservation or block? - Can I look up a deposit folio by block or deposit policy? instructions: - text: Get the deposit folio at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show the deposit folio for block {blockIdId}. slots: blockIdId: query.blockIdId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/depositTransactions'].get update: x-apievangelist-phrasing: intent: Get deposit folio transaction details effect: read questions: - What are the details of a transaction posted on a deposit folio? - Can I include generated taxes when viewing a deposit transaction? instructions: - text: Get deposit folio transaction {transactionNo} at hotel {hotelId}. slots: transactionNo: query.transactionNo hotelId: path.hotelId - text: Show deposit transaction {transactionNo} with its generates. slots: transactionNo: query.transactionNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/depositfolios/action/validate'].put update: x-apievangelist-phrasing: intent: Validate a deposit folio effect: read questions: - Can I verify that a deposit folio is valid before generating it? - What checks does the system run on a deposit folio? instructions: - text: Validate the deposit folio at hotel {hotelId}. slots: hotelId: path.hotelId - text: Check deposit folio validity for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/externalSystems/{externalSysCode}/reservations/{reservationId}/depositPayments'].post update: x-apievangelist-phrasing: intent: Take a deposit using an external reservation ID effect: write questions: - How can a partner system post a deposit using its own reservation reference? - Can I take a deposit without knowing the internal reservation ID? instructions: - text: Post a deposit for external reservation {reservationId} from system {externalSysCode} at hotel {hotelId}. slots: reservationId: path.reservationId externalSysCode: path.externalSysCode hotelId: path.hotelId - text: Record deposit {criteria} on {externalSysCode} booking {reservationId}. slots: criteria: requestBody.criteria externalSysCode: path.externalSysCode reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/financialPostings'].get update: x-apievangelist-phrasing: intent: Search financial postings effect: read questions: - Which charges and payments were posted over the last few days? - Can I filter financial postings by cashier, transaction code or room? instructions: - text: Get financial postings at hotel {hotelId} from {startDate} to {endDate}. slots: hotelId: path.hotelId startDate: query.startDate endDate: query.endDate - text: Find postings by cashier {cashierId} for room {filterRoomNumber}. slots: cashierId: query.cashierId filterRoomNumber: query.filterRoomNumber method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/financialPostingsNetVat'].get update: x-apievangelist-phrasing: intent: Get a folio's postings with net and VAT split effect: read questions: - Can I see a folio's postings broken down into net and VAT amounts? - What's the VAT breakdown for one folio window on a reservation? instructions: - text: Get net and VAT postings for reservation {reservationId} window {folioWindowNo} at hotel {hotelId}. slots: reservationId: query.reservationId folioWindowNo: query.folioWindowNo hotelId: path.hotelId - text: Show VAT breakdown of window {folioWindowNo} on reservation {reservationId}. slots: folioWindowNo: query.folioWindowNo reservationId: query.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalCommands'].post update: x-apievangelist-phrasing: intent: Create a fiscal invoice effect: write questions: - How do I issue a fiscal invoice to meet local tax rules? - What is the current call for creating fiscal invoices? instructions: - text: Create a fiscal invoice at hotel {hotelId}. slots: hotelId: path.hotelId - text: Issue a fiscal command invoice for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalFolioResponse'].get update: x-apievangelist-phrasing: intent: Get fiscal activity for a folio effect: read questions: - What fiscal responses has a folio received from the fiscal partner? - Can I see fiscal activity by folio sequence number? instructions: - text: Get fiscal folio activity at hotel {hotelId} for folio sequence {folioSeqNo}. slots: hotelId: path.hotelId folioSeqNo: query.folioSeqNo - text: List fiscal activity on folio {folioSeqNo}. slots: folioSeqNo: query.folioSeqNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalFolioResponse/{folioSeqNo}'].get update: x-apievangelist-phrasing: intent: Get a fiscal response attempt's details effect: read questions: - What exactly did the fiscal partner return for a folio's response attempt? - Can I inspect a specific retry attempt for a fiscal folio? instructions: - text: Get fiscal response details for folio {folioSeqNo} at hotel {hotelId}. slots: folioSeqNo: path.folioSeqNo hotelId: path.hotelId - text: Show attempt {responseAttemptNo} of fiscal folio {folioSeqNo}. slots: responseAttemptNo: query.responseAttemptNo folioSeqNo: path.folioSeqNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalFolios'].post update: x-apievangelist-phrasing: intent: Generate a fiscal information folio effect: write questions: - How do I create an information folio for fiscal reporting? - Can a fiscal info folio be generated on request? instructions: - text: Generate a fiscal information folio at hotel {hotelId}. slots: hotelId: path.hotelId - text: Create fiscal info folio for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalPrinting'].get update: x-apievangelist-phrasing: intent: Validate fiscal printing details for a folio effect: read questions: - Before printing a fiscal folio, can I check its printing details for the queue? - Which fiscal printing details apply to a debit or manual folio? instructions: - text: Validate fiscal printing details at hotel {hotelId} for folio type {folioType}. slots: hotelId: path.hotelId folioType: query.folioType - text: Check fiscal printing for manual folio {manualFolioNo}. slots: manualFolioNo: query.manualFolioNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalSupportingDocuments'].get update: x-apievangelist-phrasing: intent: List fiscal supporting documents effect: read questions: - Which fiscal supporting documents are still pending with the fiscal partner? - Can I find supporting documents by guest surname or confirmation number? instructions: - text: List fiscal supporting documents at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show supporting documents for confirmation {confirmationNo}. slots: confirmationNo: query.confirmationNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalSupportingDocuments'].post update: x-apievangelist-phrasing: intent: Resend failed supporting documents effect: write questions: - A supporting document failed to reach the fiscal partner — how do I resend it? - Can failed fiscal documents be retried? instructions: - text: Resend failed supporting documents at hotel {hotelId}. slots: hotelId: path.hotelId - text: Retry sending documents matching {criteria} to the fiscal partner. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/fiscalSupportingDocuments/searches'].post update: x-apievangelist-phrasing: intent: Search supporting documents with a POST body effect: read questions: - Can I search fiscal supporting documents with criteria in a request body? - Is there a body-based search for supporting documents by departure dates? instructions: - text: Search supporting documents at hotel {hotelId} using a request body. slots: hotelId: path.hotelId - text: POST a supporting document search for document number {documentNo}. slots: documentNo: requestBody.documentNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folio/{folioId}/convert'].put update: x-apievangelist-phrasing: intent: Convert a folio's type (deprecated) effect: write questions: - How did the older deprecated call convert a folio to another type? - Is the convert folio endpoint still supported for legacy use? instructions: - text: Convert folio {folioId} at hotel {hotelId} with the deprecated call. slots: folioId: path.folioId hotelId: path.hotelId - text: Use legacy folio conversion on {folioId}. slots: folioId: path.folioId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folio/{folioId}/customerVatFolio'].post update: x-apievangelist-phrasing: intent: Create a customer factura VAT folio effect: write questions: - How do I generate a customer factura VAT folio from an existing folio? - Can a VAT factura be issued for a guest's folio? instructions: - text: Create a customer VAT folio from folio {folioId} at hotel {hotelId}. slots: folioId: path.folioId hotelId: path.hotelId - text: Issue factura for folio {folioId}. slots: folioId: path.folioId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folio/{folioId}/fiscalCommands'].post update: x-apievangelist-phrasing: intent: Create a fiscal invoice for a folio (deprecated) effect: write questions: - Which deprecated call created a fiscal invoice tied to a specific folio ID? - Can I still issue a fiscal invoice per folio through the older endpoint? instructions: - text: Create a fiscal invoice for folio {folioId} at hotel {hotelId} using the deprecated call. slots: folioId: path.folioId hotelId: path.hotelId - text: Use the legacy per-folio fiscal invoice for {folioId}. slots: folioId: path.folioId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folioHistory'].get update: x-apievangelist-phrasing: intent: Look up folio history effect: read questions: - Can I find past folios for a guest by name or room? - Which folios were produced at checkout on a given date? instructions: - text: Look up folio history at hotel {hotelId} for folio date {folioDate}. slots: hotelId: path.hotelId folioDate: query.folioDate - text: Find old folios for guest {name} in room {room}. slots: name: query.name room: query.room method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folioHistory/searches'].post update: x-apievangelist-phrasing: intent: Search folio history with a POST body effect: read questions: - Is there a way to search folio history by sending filters in the body? - Can I POST a folio history search for a credit card number? instructions: - text: Search folio history at hotel {hotelId} with a request body. slots: hotelId: path.hotelId - text: POST a folio history search for folio number {folioNo}. slots: folioNo: requestBody.folioNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folioPrinters'].get update: x-apievangelist-phrasing: intent: Get printers available for folios effect: read questions: - Which printers can I send a folio to? - Are there fiscal terminal printers for a given folio window? instructions: - text: Get folio printers at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show printers for folio window {folioWindowNo} at cashier {cashierId}. slots: folioWindowNo: query.folioWindowNo cashierId: query.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folioTypeNames'].get update: x-apievangelist-phrasing: intent: Get the name of a folio type effect: read questions: - What folio type name applies to an internal folio window? - Can I get folio type names in a particular language? instructions: - text: Get the folio type name at hotel {hotelId} for window {internalFolioWindowId}. slots: hotelId: path.hotelId internalFolioWindowId: query.internalFolioWindowId - text: Show folio type names in language {languageCode}. slots: languageCode: query.languageCode method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folioTypes'].get update: x-apievangelist-phrasing: intent: List folio types effect: read questions: - What folio types are configured at the property? - Can I include credit and compressed folio types in the list? instructions: - text: List folio types at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show folio type {folioType} with credit types included. slots: folioType: query.folioType method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/folios/{folioId}/fiscal'].put update: x-apievangelist-phrasing: intent: Retry fiscal processing for a folio effect: write questions: - A folio's fiscal submission failed — how do I retry it? - Can I reprocess the fiscal retry status on a folio? instructions: - text: Retry fiscal processing for folio {folioId} at hotel {hotelId}. slots: folioId: path.folioId hotelId: path.hotelId - text: Reprocess fiscal status of folio {folioId}. slots: folioId: path.folioId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/passerBySale'].post update: x-apievangelist-phrasing: intent: Post a passer-by sale effect: write questions: - How do I charge someone who isn't staying at the hotel? - Can I post a sale for a walk-in without a reservation? instructions: - text: Post a passer-by sale at hotel {hotelId}. slots: hotelId: path.hotelId - text: Record a walk-in sale with {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/payees/{payeeId}/taxNumber'].put update: x-apievangelist-phrasing: intent: Change a payee's tax number effect: write questions: - How do I update the tax ID for a payee on a folio? - Can a payee's tax number be corrected after billing? instructions: - text: Change the tax number for payee {payeeId} at hotel {hotelId}. slots: payeeId: path.payeeId hotelId: path.hotelId - text: Set payee {payeeId}'s tax number using {criteria}. slots: payeeId: path.payeeId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/policies/{policyId}/transactions/{transactionId}/deposit'].put update: x-apievangelist-phrasing: intent: Attach a deposit policy to a payment effect: write questions: - How do I apply a payment toward a specific deposit policy? - Can an existing payment transaction be linked to a deposit rule? instructions: - text: Attach deposit policy {policyId} to payment {transactionId} at hotel {hotelId}. slots: policyId: path.policyId transactionId: path.transactionId hotelId: path.hotelId - text: Link transaction {transactionId} to deposit policy {policyId}. slots: transactionId: path.transactionId policyId: path.policyId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/postingDates/date/postingSummary'].get update: x-apievangelist-phrasing: intent: Get a posting summary for a date effect: read questions: - What's the total of postings made on a business date? - Can the posting summary be broken out by cashier or external system? instructions: - text: Get the posting summary at hotel {hotelId} for {postingDate}. slots: hotelId: path.hotelId postingDate: query.postingDate - text: Summarize postings by cashier {cashierId} in {currency}. slots: cashierId: query.cashierId currency: query.currency method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/prepaidCards'].post update: x-apievangelist-phrasing: intent: Create a prepaid card effect: write questions: - How do I issue a new prepaid card to a guest? - Can a single prepaid card be created at the desk? instructions: - text: Create a prepaid card at hotel {hotelId}. slots: hotelId: path.hotelId - text: Issue a prepaid card with {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/prepaidCards/activate'].put update: x-apievangelist-phrasing: intent: Activate a prepaid card effect: write questions: - How do I activate a prepaid card before it can be used? - Does a new prepaid card need activation? instructions: - text: Activate a prepaid card at hotel {hotelId}. slots: hotelId: path.hotelId - text: Activate prepaid card {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/prepaidCards/cancel'].put update: x-apievangelist-phrasing: intent: Cancel a prepaid card transaction effect: destructive questions: - How do I cancel a transaction made on a prepaid card? - Can a prepaid card load or redemption be cancelled? instructions: - text: Cancel a prepaid card transaction at hotel {hotelId}. slots: hotelId: path.hotelId - text: Cancel prepaid card transaction {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/prepaidCards/cashOut'].put update: x-apievangelist-phrasing: intent: Cash out a prepaid card effect: write questions: - Can a guest get the remaining balance of a prepaid card back in cash? - How do I cash out a prepaid card? instructions: - text: Cash out a prepaid card at hotel {hotelId}. slots: hotelId: path.hotelId - text: Pay out the remaining balance on prepaid card {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/prepaidCards/reload'].put update: x-apievangelist-phrasing: intent: Reload a prepaid card effect: write questions: - How do I top up a prepaid card with more value? - Can I add funds to an existing prepaid card? instructions: - text: Reload a prepaid card at hotel {hotelId}. slots: hotelId: path.hotelId - text: Top up prepaid card {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/profiles/{profileId}/creditCardWallet'].get update: x-apievangelist-phrasing: intent: Get a profile's credit card wallet effect: read questions: - Which credit cards are saved on a guest profile's wallet? - Can I view stored cards for a profile? instructions: - text: Get the card wallet for profile {profileId} at hotel {hotelId}. slots: profileId: path.profileId hotelId: path.hotelId - text: Show cards saved on profile {profileId}. slots: profileId: path.profileId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/profiles/{profileId}/creditCardWallet'].delete update: x-apievangelist-phrasing: intent: Remove cards from a profile's wallet effect: destructive questions: - How do I delete a saved credit card from a guest profile? - Can I remove a specific card from a profile wallet? instructions: - text: Delete card {creditCardId} from profile {profileId}'s wallet at hotel {hotelId}. slots: creditCardId: query.creditCardId profileId: path.profileId hotelId: path.hotelId - text: Remove stored card {creditCardId} from profile {profileId}. slots: creditCardId: query.creditCardId profileId: path.profileId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/profiles/{profileId}/paymentMethods/creditCard/authorize'].post update: x-apievangelist-phrasing: intent: Authorize a card amount on a profile effect: write questions: - How do I place a credit card authorization using a guest profile rather than a reservation? - Can a card pre-authorization be taken for a profile? instructions: - text: Authorize a credit card amount for profile {profileId} at hotel {hotelId}. slots: profileId: path.profileId hotelId: path.hotelId - text: Pre-authorize {criteria} on profile {profileId}'s card. slots: criteria: requestBody.criteria profileId: path.profileId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/profiles/{profileId}/paymentMethods/creditCard/authorizeInstructions'].post update: x-apievangelist-phrasing: intent: Get card authorization instructions for a profile effect: read questions: - What card authorization rules apply to a guest profile? - Can I fetch authorization instructions using a profile ID? instructions: - text: Get card authorization instructions for profile {profileId} at hotel {hotelId}. slots: profileId: path.profileId hotelId: path.hotelId - text: Fetch profile {profileId}'s card auth instructions for {criteria}. slots: profileId: path.profileId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/receiptHistory'].get update: x-apievangelist-phrasing: intent: Look up receipt history effect: read questions: - Can I find receipts issued to a guest in a date range? - Which receipts match a receipt number or tax invoice? instructions: - text: Look up receipt history at hotel {hotelId} from {fromDate} to {toDate}. slots: hotelId: path.hotelId fromDate: query.fromDate toDate: query.toDate - text: Find receipt {receiptNo}. slots: receiptNo: query.receiptNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/receiptHistory/searches'].post update: x-apievangelist-phrasing: intent: Search receipt history with a POST body effect: read questions: - Can I search receipts by sending filters in a request body? - Is there a body-based receipt search by receipt type name? instructions: - text: Search receipt history at hotel {hotelId} with a request body. slots: hotelId: path.hotelId - text: POST a receipt search for custom number {customNumber}. slots: customNumber: requestBody.customNumber method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservation/{reservationId}/rateCode/{rateCode}'].post update: x-apievangelist-phrasing: intent: Post a rate code to a reservation effect: write questions: - How do I post a rate code's charges onto a reservation? - Can I apply a rate code posting to one booking? instructions: - text: Post rate code {rateCode} on reservation {reservationId} at hotel {hotelId}. slots: rateCode: path.rateCode reservationId: path.reservationId hotelId: path.hotelId - text: Apply rate code {rateCode} charges to booking {reservationId}. slots: rateCode: path.rateCode reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservation/{reservationId}/rateCode/{rateCode}/action/validate'].put update: x-apievangelist-phrasing: intent: Validate a rate code posting effect: read questions: - Can I check a rate code posting on a reservation before committing it? - Will posting this rate code to the booking pass validation? instructions: - text: Validate posting rate code {rateCode} on reservation {reservationId} at hotel {hotelId}. slots: rateCode: path.rateCode reservationId: path.reservationId hotelId: path.hotelId - text: Check rate code {rateCode} can be posted to {reservationId}. slots: rateCode: path.rateCode reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/billingCharges'].post update: x-apievangelist-phrasing: intent: Post charges to many reservations effect: write questions: - How do I post the same charge to many reservations at once? - Can billing charges be posted in batch? instructions: - text: Post billing charges in batch at hotel {hotelId}. slots: hotelId: path.hotelId - text: Batch post charges for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/cCSettlements'].get update: x-apievangelist-phrasing: intent: List reservations for batch card settlement effect: read questions: - Which reservations are pending credit card settlement? - Can I filter pending card settlements by guest or offline status? instructions: - text: List batch card settlements at hotel {hotelId}. slots: hotelId: path.hotelId - text: Show pending card settlements for guest {guestName} on {transactionDate}. slots: guestName: query.guestName transactionDate: query.transactionDate method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/vouchers'].get update: x-apievangelist-phrasing: intent: List vouchers for a guest's reservations effect: read questions: - Which vouchers were generated across a guest's reservations? - Can I get vouchers by guest ID? instructions: - text: List vouchers for guest {guestId} at hotel {hotelId}. slots: guestId: query.guestId hotelId: path.hotelId - text: Show every voucher issued to guest {guestId}. slots: guestId: query.guestId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/additionalTaxes'].get update: x-apievangelist-phrasing: intent: Get additional taxes on a reservation effect: read questions: - What additional taxes apply to a reservation? - Can I see additional taxes in a different currency? instructions: - text: Get additional taxes for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show additional taxes on {reservationId} in {currencyCode}. slots: reservationId: path.reservationId currencyCode: query.currencyCode method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/advancePaymentBalance'].get update: x-apievangelist-phrasing: intent: Get a reservation's advance payment balance effect: read questions: - How much does a guest need to pay in advance for their nights? - Can I compute the advance balance for a number of nights? instructions: - text: Get the advance payment balance for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Calculate advance balance on {reservationId} for {numberOfNights} nights. slots: reservationId: path.reservationId numberOfNights: query.numberOfNights method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/advanceRoomCharges'].post update: x-apievangelist-phrasing: intent: Post room charges in advance effect: write questions: - How do I charge a guest's room nights up front? - Can room charges be posted in advance for a reservation? instructions: - text: Post advance room charges on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Charge the room nights ahead of time for booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/advanceRoomCharges'].delete update: x-apievangelist-phrasing: intent: Remove advance folio transactions effect: destructive questions: - How do I undo room charges that were posted in advance? - Can I delete advance folio transactions for a booking? instructions: - text: Delete advance room charges on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Remove the advance folio postings from {reservationId} as cashier {cashierId}. slots: reservationId: path.reservationId cashierId: query.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/alerts'].get update: x-apievangelist-phrasing: intent: Get alert notices on a reservation effect: read questions: - Are there any alerts the cashier should see for this reservation? - Can I filter reservation alerts by area such as checkout? instructions: - text: Get alerts for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show {alertArea} alerts on booking {reservationId}. slots: alertArea: query.alertArea reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/authorizationHistory'].get update: x-apievangelist-phrasing: intent: Get card authorization history effect: read questions: - What credit card authorizations have been taken on a reservation? - Can I include failed authorizations and refunds in the history? instructions: - text: Get card authorization history for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show authorizations and failures on booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/charges'].get update: x-apievangelist-phrasing: intent: Preview a charge before posting it effect: read questions: - Can I see how a charge would post, with routing applied, before posting it? - What would a billing charge of a given amount look like on the folio? instructions: - text: Preview billing charge {transactionCode} on reservation {reservationId} at hotel {hotelId}. slots: transactionCode: query.transactionCode reservationId: path.reservationId hotelId: path.hotelId - text: Show how {amount} would post to window {folioWindowNo} on {reservationId}. slots: amount: query.amount folioWindowNo: query.folioWindowNo reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/charges'].post update: x-apievangelist-phrasing: intent: Post a charge to a folio effect: write questions: - How do I post a charge to a guest's folio? - Can a cashier add a room service charge to a reservation's bill? instructions: - text: Post a charge to reservation {reservationId}'s folio at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Charge booking {reservationId} with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/chargesAndPayments'].post update: x-apievangelist-phrasing: intent: Post charges and payments together effect: write questions: - Can I post both charges and a payment to a reservation in one request? - How do I charge a guest and settle it in the same call? instructions: - text: Post charges and payments on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Add charges {charges} and payments {payments} to {reservationId}. slots: charges: requestBody.charges payments: requestBody.payments reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/check/{checkNumber}/charges'].post update: x-apievangelist-phrasing: intent: Pre-validate a check charge effect: read questions: - Can I validate a guest check charge before it posts to the folio? - Will this outlet check post cleanly to the reservation? instructions: - text: Pre-validate check {checkNumber} for reservation {reservationId} at hotel {hotelId}. slots: checkNumber: path.checkNumber reservationId: path.reservationId hotelId: path.hotelId - text: Check that check {checkNumber} can post to {reservationId}. slots: checkNumber: path.checkNumber reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/checkOuts'].post update: x-apievangelist-phrasing: intent: Check out a guest effect: write questions: - How do I check a guest out of their room? - Can I run a checkout as verification only without completing it? instructions: - text: Check out reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Verify checkout of {reservationId} without completing it. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/checkOuts/reinstate'].put update: x-apievangelist-phrasing: intent: Reinstate a checked-out reservation effect: write questions: - A guest was checked out by mistake — how do I reinstate them? - Can I reverse a checkout and notify interfaces? instructions: - text: Reinstate checked-out reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Undo checkout of {reservationId} and notify interfaces. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/comp/folios/autoSettlements'].put update: x-apievangelist-phrasing: intent: Auto-settle a reservation's comp folios effect: write questions: - How do I settle comp folios on a reservation automatically? - Can comp folios be auto-settled at checkout? instructions: - text: Auto-settle comp folios on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Settle comp windows for booking {reservationId} using {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/compRedemptionPostings'].post update: x-apievangelist-phrasing: intent: Post comp bucket redemptions on a reservation effect: write questions: - How do I post complimentary bucket redemptions onto a reservation's folio? - Can a PTS member's comp buckets be redeemed against their stay? instructions: - text: Post comp bucket redemptions on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Redeem comp buckets for stay {reservationId} with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/compRedemptionReversals'].post update: x-apievangelist-phrasing: intent: Reverse comp bucket redemptions on a reservation effect: destructive questions: - How do I reverse comp bucket redemptions posted to a reservation? - Can bucket redemptions on a stay be undone? instructions: - text: Reverse comp bucket redemptions on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Undo bucket redemptions on stay {reservationId} for {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/compositeDeposit'].post update: x-apievangelist-phrasing: intent: Take a deposit payment or create a deposit folio effect: write questions: - Can I take a deposit and create its deposit folio in one step? - How do I record a deposit that may also need a folio? instructions: - text: Create a composite deposit on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Post deposit payment or folio for {reservationId} with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/creditCardWallet'].get update: x-apievangelist-phrasing: intent: Get a reservation's credit card wallet effect: read questions: - Which cards are stored against a reservation? - Can I see a reservation's wallet for one profile on it? instructions: - text: Get the card wallet on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show cards on booking {reservationId} for profile {profileId}. slots: reservationId: path.reservationId profileId: query.profileId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/creditCardWallet'].delete update: x-apievangelist-phrasing: intent: Remove cards from a reservation's wallet effect: destructive questions: - How do I delete a stored card from a reservation? - Can a card be removed from a reservation wallet for one profile? instructions: - text: Delete card {creditCardId} for profile {profileId} from reservation {reservationId} at hotel {hotelId}. slots: creditCardId: query.creditCardId profileId: query.profileId reservationId: path.reservationId hotelId: path.hotelId - text: Remove card {creditCardId} from booking {reservationId}'s wallet (profile {profileId}). slots: creditCardId: query.creditCardId reservationId: path.reservationId profileId: query.profileId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/deferredTaxesProcess'].post update: x-apievangelist-phrasing: intent: Submit a job to post deferred taxes effect: write questions: - How do I post taxes that were deferred on a reservation? - Is there a background job for deferred taxes? instructions: - text: Submit a deferred taxes job for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Post the deferred taxes on {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/deposit'].post update: x-apievangelist-phrasing: intent: Process a reservation deposit effect: write questions: - How do I process the deposit due on a reservation? - Can deposit processing be run for a single booking? instructions: - text: Process the deposit on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Run deposit processing for {reservationId} with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositCreditBill'].post update: x-apievangelist-phrasing: intent: Create a credit bill for a deposit effect: write questions: - How do I issue a credit bill against a reservation's deposit? - Can a deposit be credited back with a credit bill? instructions: - text: Create a deposit credit bill on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Credit-bill the deposit for {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositFolios'].post update: x-apievangelist-phrasing: intent: Create a deposit folio for a reservation effect: write questions: - How do I produce a deposit folio for a booking? - Can a deposit folio be generated for the guest? instructions: - text: Create a deposit folio on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Generate the deposit folio for {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositMaturity'].get update: x-apievangelist-phrasing: intent: Get deposit maturity information effect: read questions: - When do a reservation's deposits mature? - Can I see deposit maturity for a cashier? instructions: - text: Get deposit maturity info for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show when deposits on {reservationId} mature. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositPayments'].get update: x-apievangelist-phrasing: intent: List matured deposits on a reservation effect: read questions: - Which deposit payments on a reservation have already matured? - What matured deposits can I transfer to the guest folio? instructions: - text: List matured deposits on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show matured deposit payments for {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositPayments'].post update: x-apievangelist-phrasing: intent: Take a deposit payment effect: write questions: - How do I take a deposit from a guest on their reservation? - Can a deposit be posted using the internal reservation ID? instructions: - text: Post a deposit payment on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Take deposit {criteria} for booking {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/depositTransition'].put update: x-apievangelist-phrasing: intent: Move a deposit to the guest folio effect: write questions: - How do I transfer a deposit onto the guest folio at check-in? - Can deposits transition to the folio before arrival? instructions: - text: Transition the deposit to the guest folio on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Move deposits for {reservationId} onto the guest folio. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/earlyDeparture'].put update: x-apievangelist-phrasing: intent: Process an early departure effect: write questions: - How do I handle a guest leaving earlier than booked? - Can an early departure penalty be applied? instructions: - text: Process early departure on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Shorten stay {reservationId} for early departure with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/earlyDeparture/verify'].get update: x-apievangelist-phrasing: intent: Check the impact of an early departure effect: read questions: - What happens to rates and penalties if a guest leaves early? - Can I check early departure while ignoring rate restrictions? instructions: - text: Verify early departure for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Check early departure on {reservationId} with penalty {postEarlyDeparturePenalty}. slots: reservationId: path.reservationId postEarlyDeparturePenalty: query.postEarlyDeparturePenalty method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/eligibleBillAmount'].get update: x-apievangelist-phrasing: intent: Get the amount eligible for redemption effect: read questions: - How much of a folio is eligible to be paid with a redemption? - Can I see the eligible bill amount for one folio view? instructions: - text: Get the eligible bill amount on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show redemption-eligible amount for {reservationId} folio view {folioView}. slots: reservationId: path.reservationId folioView: query.folioView method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fetchStagedTransactions'].get update: x-apievangelist-phrasing: intent: Get staged transactions for a reservation effect: read questions: - Which transactions are staged but not yet posted on a reservation? - Can I see staged transactions on one folio window? instructions: - text: Get staged transactions for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show staged items on window {folioWindowNo} of {reservationId}. slots: folioWindowNo: query.folioWindowNo reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/finalCharges'].post update: x-apievangelist-phrasing: intent: Apply final postings before checkout effect: write questions: - How do I apply the final charges to a reservation at departure? - Can final postings be applied ahead of checkout? instructions: - text: Apply final postings on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Post the final charges for departing booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fiscalInfo'].post update: x-apievangelist-phrasing: intent: Generate the fiscal checkout payload effect: write questions: - How do I produce the fiscal checkout payload for a reservation? - Can fiscal info be generated at checkout for a partner? instructions: - text: Generate fiscal checkout info for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Post fiscal payload {fiscalPayloadType} for {reservationId}. slots: fiscalPayloadType: requestBody.fiscalPayloadType reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fiscalPrinting'].get update: x-apievangelist-phrasing: intent: Get fiscal printing details for a reservation effect: read questions: - What fiscal printing details apply to a reservation's folio? - Can I fetch fiscal print info per reservation and folio type? instructions: - text: Get fiscal printing details for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show fiscal print data on {reservationId} for folio type {folioType}. slots: reservationId: path.reservationId folioType: query.folioType method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fixedCharges'].get update: x-apievangelist-phrasing: intent: Get a reservation's fixed charges effect: read questions: - Which recurring fixed charges are set on a reservation? - Can I see scheduled fixed charges for a stay? instructions: - text: Get fixed charges for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show recurring fixed charges on {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fixedCharges'].put update: x-apievangelist-phrasing: intent: Update a reservation's fixed charges effect: write questions: - How do I change an existing fixed charge on a stay? - Can fixed charge amounts or schedules be edited? instructions: - text: Update fixed charges on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Change fixed charges on {reservationId} to {fixedCharges}. slots: reservationId: path.reservationId fixedCharges: requestBody.fixedCharges method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fixedCharges'].post update: x-apievangelist-phrasing: intent: Add fixed charges to a reservation effect: write questions: - How do I set up a new recurring charge like parking on a reservation? - Can I add a fixed charge to a stay? instructions: - text: Add fixed charges to reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Create fixed charges {fixedCharges} on booking {reservationId}. slots: fixedCharges: requestBody.fixedCharges reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/fixedCharges'].delete update: x-apievangelist-phrasing: intent: Delete a fixed charge from a reservation effect: destructive questions: - How do I remove a fixed charge from a reservation? - Can a single fixed charge be deleted by its ID? instructions: - text: Delete fixed charge {fixedChargeID} from reservation {reservationId} at hotel {hotelId}. slots: fixedChargeID: query.fixedChargeID reservationId: path.reservationId hotelId: path.hotelId - text: Remove the fixed charges on booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/flexibleBenefitPostings'].post update: x-apievangelist-phrasing: intent: Apply flexible benefit postings effect: write questions: - How do I apply a guest's flexible benefits to their folio? - Can flexible benefit postings be applied to a stay? instructions: - text: Apply flexible benefit postings on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Post flexible benefits for {reservationId} using {applyFlexibleBenefitCriteria}. slots: reservationId: path.reservationId applyFlexibleBenefitCriteria: requestBody.applyFlexibleBenefitCriteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/folioTaxPayments'].get update: x-apievangelist-phrasing: intent: Get folio tax payment information effect: read questions: - What tax payments apply to a reservation's folio window? - Can I see folio tax payment info for a card payment method? instructions: - text: Get folio tax payment info for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show tax payments on window {folioWindowNo} of {reservationId}. slots: folioWindowNo: query.folioWindowNo reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/folios'].get update: x-apievangelist-phrasing: intent: Get a reservation's folios effect: read questions: - What's on a guest's bill right now? - Can I get just the balance or a summary of a reservation's folios? instructions: - text: Get folios for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show folio window {folioWindowNo} for {reservationId}. slots: folioWindowNo: query.folioWindowNo reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/folios'].put update: x-apievangelist-phrasing: intent: Close a reservation's folio effect: write questions: - How do I close a folio once it's settled? - Can a reservation folio be closed without checkout? instructions: - text: Close the folio on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Close folio {criteria} for {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/folios'].post update: x-apievangelist-phrasing: intent: Generate folios for a reservation effect: write questions: - How do I generate a printable folio for a guest? - Can folios be generated for all windows of a stay? instructions: - text: Generate folios for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Produce the folio for {reservationId} with {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/memberships/{membershipId}/awardTransactions'].post update: x-apievangelist-phrasing: intent: Pay with a membership award effect: write questions: - How do I pay part of a bill with loyalty points or an award voucher? - Can a member redeem points against their reservation folio? instructions: - text: Post an award payment for membership {membershipId} on reservation {reservationId} at hotel {hotelId}. slots: membershipId: path.membershipId reservationId: path.reservationId hotelId: path.hotelId - text: Redeem {redeemAmount} from membership {membershipId} on booking {reservationId}. slots: redeemAmount: requestBody.redeemAmount membershipId: path.membershipId reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packageAllowance/links'].delete update: x-apievangelist-phrasing: intent: Unlink a shared package allowance effect: destructive questions: - How do I stop two reservations from sharing a package allowance? - Can a package allowance link be removed? instructions: - text: Unlink the package allowance on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Remove package allowance links from {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/packageOptions'].get update: x-apievangelist-phrasing: intent: Get a reservation's package options effect: read questions: - What package options are available on a reservation? - Which packages could this stay use? instructions: - text: Get package options for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show packages available to {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods/creditCard/authorize'].post update: x-apievangelist-phrasing: intent: Authorize a card amount on a reservation effect: write questions: - How do I take a credit card pre-authorization for a reservation? - Can I raise the authorized amount on a guest's card? instructions: - text: Authorize a card amount on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Pre-authorize {criteria} on booking {reservationId}'s card. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods/creditCard/authorize/manual'].post update: x-apievangelist-phrasing: intent: Register a manual card authorization effect: write questions: - How do I record an authorization code obtained by phone? - Can a manual credit card authorization be registered on a reservation? instructions: - text: Register a manual card authorization on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Record manual auth {criteria} for {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/paymentMethods/creditCard/authorizeInstructions'].post update: x-apievangelist-phrasing: intent: Get card authorization instructions for a reservation effect: read questions: - What authorization amount rules apply to a reservation's card? - Can I fetch card authorization instructions by reservation? instructions: - text: Get card authorization instructions for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Fetch auth instructions on booking {reservationId} for {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/payments'].post update: x-apievangelist-phrasing: intent: Post a payment to a reservation effect: write questions: - How do I record a guest's payment on their bill? - Can a payment be posted as an advance deposit? instructions: - text: Record a guest payment against the bill of reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Record payment {criteria} for {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/postingActivities'].get update: x-apievangelist-phrasing: intent: Get posting activity log for a reservation effect: read questions: - Who posted or changed charges on a reservation, and when? - Can I filter posting activity by user or action type? instructions: - text: Get posting activity for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show posting activity on {reservationId} by user {logUserName}. slots: reservationId: path.reservationId logUserName: query.logUserName method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/prepaidCards/redemptions'].put update: x-apievangelist-phrasing: intent: Redeem prepaid cards against a reservation effect: write questions: - How do I pay a reservation's bill with a prepaid card? - Can multiple prepaid cards be redeemed on a stay? instructions: - text: Redeem prepaid cards on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Use prepaid cards {criteria} to pay {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/proforma'].post update: x-apievangelist-phrasing: intent: Create a pro-forma invoice for a reservation effect: write questions: - How do I produce a pro-forma invoice for a guest before they pay? - Can I preview charges as a pro-forma for a stay? instructions: - text: Create a pro-forma for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Generate pro-forma {criteria} for {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/proformaFolio'].post update: x-apievangelist-phrasing: intent: Create a pro-forma folio for external partners effect: write questions: - Can an external partner request a pro-forma folio for a reservation? - Which call gives partners a pro-forma folio rather than the in-house pro-forma? instructions: - text: Create a partner pro-forma folio for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Produce an external-partner pro-forma folio on {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/revenueBuckets'].get update: x-apievangelist-phrasing: intent: Get revenue bucket totals for a reservation effect: read questions: - How much revenue has a reservation generated in each revenue bucket? - Can I include comp revenue in the bucket totals? instructions: - text: Get revenue bucket totals for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show {revenueBucketType} totals on {reservationId}. slots: revenueBucketType: query.revenueBucketType reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/reverseCertificate'].post update: x-apievangelist-phrasing: intent: Reverse certificate postings effect: destructive questions: - How do I reverse a gift or award certificate posted to a reservation? - Can certificate postings be backed out? instructions: - text: Reverse certificate postings on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Undo certificate postings {reverseCriteria} on {reservationId}. slots: reverseCriteria: requestBody.reverseCriteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].get update: x-apievangelist-phrasing: intent: Get a reservation's routing instructions effect: read questions: - Where are a guest's charges being routed? - Can I see room and window routing effective on a date? instructions: - text: Get routing instructions for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show routing on {reservationId} effective {effectiveOn}. slots: reservationId: path.reservationId effectiveOn: query.effectiveOn method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions'].delete update: x-apievangelist-phrasing: intent: Delete all routing instructions on a reservation effect: destructive questions: - How do I clear every routing instruction on a reservation? - Can I wipe all billing routing from a stay at once? instructions: - text: Delete all routing instructions on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Clear every routing rule from {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/change'].put update: x-apievangelist-phrasing: intent: Change existing routing instructions effect: write questions: - How do I edit a routing instruction that's already on a reservation? - Can routing limits or dates be changed? instructions: - text: Change routing instructions on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Modify routing on {reservationId} to {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/comp'].delete update: x-apievangelist-phrasing: intent: Delete comp routing on a reservation effect: destructive questions: - How do I remove comp routing from a reservation? - Can comp routing for a specific authorizer be deleted? instructions: - text: Delete comp routing on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Remove comp routing by authorizer {authorizerId} from {reservationId}. slots: authorizerId: query.authorizerId reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/create'].put update: x-apievangelist-phrasing: intent: Create routing instructions effect: write questions: - How do I route a guest's charges to another folio or company? - Can I set up new billing routing on a reservation? instructions: - text: Create routing instructions on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Add new routing {criteria} to {reservationId}. slots: criteria: requestBody.criteria reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/folio'].delete update: x-apievangelist-phrasing: intent: Delete folio window routing effect: destructive questions: - How do I remove routing to a particular folio window? - Can window routing for one payee be deleted? instructions: - text: Delete folio routing on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Remove window {folioWindowNo} routing from {reservationId}. slots: folioWindowNo: query.folioWindowNo reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/request'].delete update: x-apievangelist-phrasing: intent: Delete a comp routing request effect: destructive questions: - How do I withdraw a pending comp routing request? - Can a routing request be deleted with a comment? instructions: - text: Delete the routing request on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Withdraw the routing request on {reservationId} with comment {comments}. slots: reservationId: path.reservationId comments: query.comments method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/routingInstructions/room'].delete update: x-apievangelist-phrasing: intent: Delete room-to-room routing effect: destructive questions: - How do I stop charges routing from one room to another? - Can room routing be removed for a date range? instructions: - text: Delete room routing on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Remove room routing from {reservationId} between {startDate} and {endDate}. slots: reservationId: path.reservationId startDate: query.startDate endDate: query.endDate method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactions'].put update: x-apievangelist-phrasing: intent: Delete today's transactions on a reservation effect: destructive questions: - How do I delete charges posted to a reservation today? - Is a reason code required to delete same-day transactions? instructions: - text: Delete transactions {transactionList} on reservation {reservationId} at hotel {hotelId}. slots: transactionList: requestBody.transactionList reservationId: path.reservationId hotelId: path.hotelId - text: Remove today's postings on {reservationId} with reason {reasonCode}. slots: reservationId: path.reservationId reasonCode: requestBody.reasonCode method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactions/{transactionId}'].get update: x-apievangelist-phrasing: intent: Check if a deposit can be refunded effect: read questions: - Is a guest's deposit eligible for a refund? - Can I check refund eligibility for a specific deposit transaction? instructions: - text: Check refund eligibility of deposit {transactionId} on reservation {reservationId} at hotel {hotelId}. slots: transactionId: path.transactionId reservationId: path.reservationId hotelId: path.hotelId - text: Can deposit {transactionId} on {reservationId} be refunded — check it. slots: transactionId: path.transactionId reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transactions/{transactionId}'].put update: x-apievangelist-phrasing: intent: Split a deposit transaction effect: write questions: - How do I split one deposit into several amounts? - Can a deposit payment be divided across policies? instructions: - text: Split deposit {transactionId} on reservation {reservationId} at hotel {hotelId}. slots: transactionId: path.transactionId reservationId: path.reservationId hotelId: path.hotelId - text: Divide deposit {transactionId} on {reservationId} as {depositTransaction}. slots: transactionId: path.transactionId reservationId: path.reservationId depositTransaction: requestBody.depositTransaction method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transferFolioTransactions'].put update: x-apievangelist-phrasing: intent: Move a whole folio to another window effect: write questions: - How do I move everything on one folio window to another? - Can a full folio be transferred between windows? instructions: - text: Transfer a folio to another window on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Move the whole folio on {reservationId} per {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/transferTransactions'].put update: x-apievangelist-phrasing: intent: Move transactions to another window effect: write questions: - How do I move individual charges to a different folio window? - Can selected transactions be shifted between windows? instructions: - text: Transfer transactions to another window on reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Move selected charges on {reservationId} per {criteria}. slots: reservationId: path.reservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/voidfolios/{folioId}'].put update: x-apievangelist-phrasing: intent: Void a folio effect: destructive questions: - How do I void a folio that was generated in error? - Can a specific folio on a reservation be voided? instructions: - text: Void folio {folioId} on reservation {reservationId} at hotel {hotelId}. slots: folioId: path.folioId reservationId: path.reservationId hotelId: path.hotelId - text: Cancel folio {folioId} for {reservationId}. slots: folioId: path.folioId reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/vouchers'].get update: x-apievangelist-phrasing: intent: List vouchers for one reservation effect: read questions: - Which vouchers have been generated for a reservation? - Can I see a single stay's vouchers? instructions: - text: List vouchers for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Show vouchers issued on booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{reservationId}/vouchers'].post update: x-apievangelist-phrasing: intent: Generate vouchers for a reservation effect: write questions: - How do I generate vouchers for a guest's reservation? - Can vouchers be created for one booking? instructions: - text: Generate vouchers for reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: path.hotelId - text: Create the vouchers on booking {reservationId}. slots: reservationId: path.reservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{resvNameId}/compTransactionAuthorizers'].get update: x-apievangelist-phrasing: intent: Get comp authorizers for a reservation's transaction effect: read questions: - Who can authorize a comp for a transaction on a specific reservation? - Can I filter a reservation's comp authorizers by name? instructions: - text: Get comp authorizers for transaction {transactionId} on reservation {resvNameId} at hotel {hotelId}. slots: transactionId: query.transactionId resvNameId: path.resvNameId hotelId: path.hotelId - text: Find authorizers named {authorizerName} for {transactionId} on {resvNameId}. slots: authorizerName: query.authorizerName transactionId: query.transactionId resvNameId: path.resvNameId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{sourceReservationId}/deposit/transfers'].put update: x-apievangelist-phrasing: intent: Transfer a deposit to another reservation effect: write questions: - How do I move a deposit from one reservation to another? - Can deposits be transferred between bookings? instructions: - text: Transfer the deposit from reservation {sourceReservationId} at hotel {hotelId}. slots: sourceReservationId: path.sourceReservationId hotelId: path.hotelId - text: Move deposit from {sourceReservationId} per {criteria}. slots: sourceReservationId: path.sourceReservationId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/reservations/{toReservationId}/transferTransaction'].put update: x-apievangelist-phrasing: intent: Transfer transactions to another reservation effect: write questions: - How do I move a charge from one guest's bill to another reservation? - Can transactions be transferred to a different booking? instructions: - text: Transfer transactions to reservation {toReservationId} at hotel {hotelId}. slots: toReservationId: path.toReservationId hotelId: path.hotelId - text: Move charges {criteria} onto booking {toReservationId}. slots: criteria: requestBody.criteria toReservationId: path.toReservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/revenue'].get update: x-apievangelist-phrasing: intent: Get hotel revenue for a business date effect: read questions: - What was the hotel's revenue on a given business date? - Can I pull property revenue for yesterday? instructions: - text: Get hotel revenue at hotel {hotelId} for {businessDate}. slots: hotelId: path.hotelId businessDate: query.businessDate - text: Show revenue for business date {businessDate}. slots: businessDate: query.businessDate method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/routingInstructionCodes'].get update: x-apievangelist-phrasing: intent: List billing routing instruction codes effect: read questions: - What routing instruction codes are configured for billing? - Can I search billing instruction codes by description? instructions: - text: List billing instruction codes at hotel {hotelId}. slots: hotelId: path.hotelId - text: Find routing codes matching {codeWildCard}. slots: codeWildCard: query.codeWildCard method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/sourceReservations/{sourceReservationId}/destinationReservations/{destinationReservationId}/packageAllowance/links'].post update: x-apievangelist-phrasing: intent: Share a package allowance between reservations effect: write questions: - How do I let two reservations share one package allowance? - Can a package allowance be linked from one stay to another? instructions: - text: Link package allowance from reservation {sourceReservationId} to {destinationReservationId} at hotel {hotelId}. slots: sourceReservationId: path.sourceReservationId destinationReservationId: path.destinationReservationId hotelId: path.hotelId - text: Share allowances of {sourceReservationId} with {destinationReservationId}. slots: sourceReservationId: path.sourceReservationId destinationReservationId: path.destinationReservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/sourceReservations/{sourceReservationId}/targetReservations/{targetReservationId}/roomRouting'].get update: x-apievangelist-phrasing: intent: Get postings to refresh room routing effect: read questions: - Which postings would move if I refresh room routing between two reservations? - Can I preview room routing refresh postings for a date range? instructions: - text: Get postings for routing refresh from {sourceReservationId} to {targetReservationId} at hotel {hotelId}. slots: sourceReservationId: path.sourceReservationId targetReservationId: path.targetReservationId hotelId: path.hotelId - text: Preview routing refresh postings {sourceReservationId} to {targetReservationId} from {startDate}. slots: sourceReservationId: path.sourceReservationId targetReservationId: path.targetReservationId startDate: query.startDate method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/sourceReservations/{sourceReservationId}/targetReservations/{targetReservationId}/roomRouting'].put update: x-apievangelist-phrasing: intent: Refresh room routing between reservations effect: write questions: - How do I re-apply room routing so postings move to the target reservation? - Can room routing be refreshed after it changes? instructions: - text: Refresh room routing from {sourceReservationId} to {targetReservationId} at hotel {hotelId}. slots: sourceReservationId: path.sourceReservationId targetReservationId: path.targetReservationId hotelId: path.hotelId - text: Process routing refresh {sourceReservationId} into {targetReservationId}. slots: sourceReservationId: path.sourceReservationId targetReservationId: path.targetReservationId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/storedFolios/{folioId}'].get update: x-apievangelist-phrasing: intent: Get a stored folio's details effect: read questions: - What details are stored for a folio after it was issued? - Can I look up a stored folio by invoice number? instructions: - text: Get stored folio {folioId} at hotel {hotelId}. slots: folioId: path.folioId hotelId: path.hotelId - text: Show stored folio {folioId} for invoice {invoiceNo}. slots: folioId: path.folioId invoiceNo: query.invoiceNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/storedFolios/{folioId}'].post update: x-apievangelist-phrasing: intent: Save stored folio details effect: write questions: - How do I store details for an issued folio? - Can stored folio details be recorded for a folio ID? instructions: - text: Save stored details for folio {folioId} at hotel {hotelId}. slots: folioId: path.folioId hotelId: path.hotelId - text: Store {storedFolioDetails} on folio {folioId}. slots: storedFolioDetails: requestBody.storedFolioDetails folioId: path.folioId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/supplementFolios'].post update: x-apievangelist-phrasing: intent: Post a supplemental folio effect: write questions: - How do I issue a supplemental folio after the main one? - Can I add a supplemental folio for extra charges? instructions: - text: Post a supplemental folio at hotel {hotelId}. slots: hotelId: path.hotelId - text: Create a supplement folio with {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactionCodes'].get update: x-apievangelist-phrasing: intent: List transaction codes effect: read questions: - Which transaction codes can I post charges with? - Can I list only codes that allow manual posting? instructions: - text: List transaction codes at hotel {hotelId}. slots: hotelId: path.hotelId - text: Find transaction codes matching {wildCard}. slots: wildCard: query.wildCard method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactionDetails'].get update: x-apievangelist-phrasing: intent: Get folio transaction details effect: read questions: - What are the full details of a transaction on a guest folio? - Can I include exchange information for a folio transaction? instructions: - text: Get folio transaction {transactionNo} at hotel {hotelId}. slots: transactionNo: query.transactionNo hotelId: path.hotelId - text: Show guest-folio transaction {transactionNo} with exchange details. slots: transactionNo: query.transactionNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions'].get update: x-apievangelist-phrasing: intent: List transactions across reservations effect: read questions: - What transactions are posted across a list of reservations? - Can I filter guests' transactions by transaction group? instructions: - text: List transactions for reservations {reservationList} at hotel {hotelId}. slots: reservationList: query.reservationList hotelId: path.hotelId - text: Show {transactionGroup} transactions for {reservationList}. slots: transactionGroup: query.transactionGroup reservationList: query.reservationList method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/adjust'].put update: x-apievangelist-phrasing: intent: Adjust posted transactions effect: write questions: - How do I adjust a charge that was posted wrong? - Can posted transactions be adjusted with a reason? instructions: - text: Adjust transactions at hotel {hotelId}. slots: hotelId: path.hotelId - text: Make adjustments {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/arInvoices/reverse'].delete update: x-apievangelist-phrasing: intent: Reverse an AR invoice effect: destructive questions: - How do I reverse an invoice that was sent to accounts receivable? - Is a reason code needed to reverse an AR invoice? instructions: - text: Reverse the AR invoice at hotel {hotelId} with reason {reasonCode}. slots: hotelId: path.hotelId reasonCode: query.reasonCode - text: Reverse AR invoice transactions {transactionCodes} as cashier {cashierId}. slots: transactionCodes: query.transactionCodes cashierId: query.cashierId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/split'].put update: x-apievangelist-phrasing: intent: Split a transaction effect: write questions: - How do I split one charge into smaller amounts? - Can a transaction be split by percentage or amount? instructions: - text: Split a transaction at hotel {hotelId}. slots: hotelId: path.hotelId - text: Split charge per {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/splitAndTransfer'].put update: x-apievangelist-phrasing: intent: Split a transaction and transfer part effect: write questions: - How do I split a charge and move part of it to another folio? - Can splitting and transferring happen in one request? instructions: - text: Split and transfer a transaction at hotel {hotelId}. slots: hotelId: path.hotelId - text: Split then move charge per {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}'].get update: x-apievangelist-phrasing: intent: Validate a transaction code effect: read questions: - Is a transaction code valid for posting on a folio? - Can I validate a code for a specific event? instructions: - text: Validate transaction code {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Check code {transactionId} for event {event}. slots: transactionId: path.transactionId event: query.event method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}'].post update: x-apievangelist-phrasing: intent: Submit a comp transaction effect: write questions: - How do I submit a comp transaction for processing? - Can a comp be submitted using its transaction number? instructions: - text: Submit comp transaction {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Submit comp {transactionId} with trx number {trxNo}. slots: transactionId: path.transactionId trxNo: requestBody.trxNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/charges'].put update: x-apievangelist-phrasing: intent: Change a posted charge effect: write questions: - How do I edit a single posted charge? - Can a charge's amount or details be changed after posting? instructions: - text: Change charge {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Update posted charge {transactionId} with {criteria}. slots: transactionId: path.transactionId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/compRequestStatus'].get update: x-apievangelist-phrasing: intent: Get a gaming comp request's status effect: read questions: - What's the status of a gaming comp request? - Has the casino system approved a comp request yet? instructions: - text: Get gaming request status for transaction {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Check comp request status on {transactionId}. slots: transactionId: path.transactionId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/flexibleBenefitPostings'].delete update: x-apievangelist-phrasing: intent: Reverse a flexible benefit posting effect: destructive questions: - How do I undo a flexible benefit that was applied to a folio? - Can a flexible benefit posting be removed? instructions: - text: Reverse flexible benefit posting {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Delete flexible benefit on {transactionId}. slots: transactionId: path.transactionId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/payments'].put update: x-apievangelist-phrasing: intent: Change a posted payment effect: write questions: - How do I edit a payment that was already recorded? - Can a payment's details be corrected? instructions: - text: Change payment {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Update payment {transactionId} with {criteria}. slots: transactionId: path.transactionId criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/policies/detach/deposit'].put update: x-apievangelist-phrasing: intent: Detach a deposit policy from a payment effect: write questions: - How do I unlink a payment from a deposit policy? - Can a deposit rule be detached from a transaction? instructions: - text: Detach the deposit policy from payment {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Unlink deposit policy from {transactionId}. slots: transactionId: path.transactionId method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/reversePayments'].post update: x-apievangelist-phrasing: intent: Reverse a payment effect: destructive questions: - How do I reverse a payment that was posted? - Can a card payment be reversed? instructions: - text: Reverse payment {transactionId} at hotel {hotelId}. slots: transactionId: path.transactionId hotelId: path.hotelId - text: Reverse payment {transactionId} using {payment}. slots: transactionId: path.transactionId payment: requestBody.payment method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transactionsTotal'].get update: x-apievangelist-phrasing: intent: Get balance information (deprecated) effect: read questions: - How did the deprecated balance information call compute a folio balance? - Is the older transactions total endpoint still usable? instructions: - text: Get balance info at hotel {hotelId} with the deprecated call. slots: hotelId: path.hotelId - text: Use legacy balance total for window {folioWindowNo}. slots: folioWindowNo: query.folioWindowNo method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/transferCompTransactions'].post update: x-apievangelist-phrasing: intent: Move comp transactions to a window effect: write questions: - How do I transfer comp transactions to another folio window? - Can comp charges be moved between windows? instructions: - text: Transfer comp transactions to a window at hotel {hotelId}. slots: hotelId: path.hotelId - text: Move comp transactions per {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/vouchers/batchJobs'].post update: x-apievangelist-phrasing: intent: Start a batch voucher generation job effect: write questions: - How do I generate vouchers for many reservations at once? - Is there a batch job for voucher generation? instructions: - text: Start batch voucher generation at hotel {hotelId}. slots: hotelId: path.hotelId - text: Generate vouchers in batch for {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/zeroBalanceCheckoutReservations/batchJobs'].post update: x-apievangelist-phrasing: intent: Batch check out zero-balance reservations effect: write questions: - How can I check out every departing guest whose balance is zero? - Is there a batch job for zero balance checkouts? instructions: - text: Start a zero balance checkout batch at hotel {hotelId}. slots: hotelId: path.hotelId - text: Check out zero-balance reservations matching {criteria}. slots: criteria: requestBody.criteria method: generated generated: '2026-09-26' - target: $.paths['/reservations/{reservationId}/postRoomAndTaxForDayUse'].post update: x-apievangelist-phrasing: intent: Post room and tax for a day-use stay effect: write questions: - How do I charge room and tax for a day-use reservation? - Can day-use room charges be posted by a cashier? instructions: - text: Post room and tax for day-use reservation {reservationId} at hotel {hotelId}. slots: reservationId: path.reservationId hotelId: header.x-hotelid - text: Charge day-use room and tax on {reservationId} as cashier {cashierId}. slots: reservationId: path.reservationId cashierId: requestBody.cashierId method: generated generated: '2026-09-26' - target: $.paths['/roundingDifference'].get update: x-apievangelist-phrasing: intent: Get a payment's rounding difference effect: read questions: - What rounding difference applies when a guest pays a certain amount? - Can I calculate rounding for a cash payment in a currency? instructions: - text: Get the rounding difference at hotel {hotelId} for {amount} {currencyCode}. slots: hotelId: query.hotelId amount: query.amount currencyCode: query.currencyCode - text: Check rounding on window {folioWindowNo} for payment method {paymentMethod}. slots: folioWindowNo: query.folioWindowNo paymentMethod: query.paymentMethod method: generated generated: '2026-09-26' - target: $.paths['/services/cashiering/status'].get update: x-apievangelist-phrasing: intent: Check the cashiering service status effect: read questions: - Is the cashiering service up and responding? - Can I health-check the cashiering API? instructions: - text: Check the cashiering service status at hotel {hotelId}. slots: hotelId: header.x-hotelid - text: Ping the cashiering service. method: generated generated: '2026-09-26' - target: $.paths['/hotels/{hotelId}/financialPostingsNetVat/{statusId}'].get update: x-apievangelist-phrasing: intent: Get async financial postings results effect: read questions: - How do I fetch the results of an asynchronous financial postings request? - Where do I get net and VAT postings once the async job is done? instructions: - text: Get async financial postings results {statusId} at hotel {hotelId}. slots: statusId: path.statusId hotelId: path.hotelId - text: Fetch finished financial postings job {statusId}. slots: statusId: path.statusId method: generated generated: '2026-09-26'