API Evangelist conversational phrasing for OPERA Cloud Accounts Receivables API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OPERA Cloud Accounts Receivables API
  version: 1.0.0
extends: openapi/oracle-hospitality-accountsreceivables-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: 60
- target: $.paths['/accountReminders'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reminder letters for AR accounts
      effect: read
      questions:
      - Where can I see the payment reminder letters sent to our accounts receivable holders?
      - Can I pull the reminder statement showing payment due and current balance for a specific AR account?
      instructions:
      - text: Get the reminder statements for AR account {account}.
        slots:
          account: query.accounts
      - text: Show reminder letters for AR account {account} at hotel {hotel}.
        slots:
          account: query.accounts
          hotel: query.hotelIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accountReminders'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate AR payment reminder letters
      effect: write
      questions:
      - How do I generate a payment reminder letter for an accounts receivable holder in OPERA Cloud?
      - Can I produce new reminder statements that show payment due and the current account balance?
      instructions:
      - text: 'Generate reminder letters with these reminder details: {reminders}.'
        slots:
          reminders: requestBody.remindersDetails
      - text: Create new payment-due reminder statements for our overdue AR accounts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: Find AR accounts for a profile
      effect: read
      questions:
      - Which accounts receivable accounts are attached to a given guest or company profile?
      - Can I search AR accounts by account number or name and filter to those with a balance?
      - How do I list every direct-bill account a profile holds across hotels?
      instructions:
      - text: Find the AR accounts for profile {profile}.
        slots:
          profile: query.profileId
      - text: Search AR accounts named {name} at hotel {hotel}.
        slots:
          name: query.accountName
          hotel: query.hotelIds
      - text: Look up AR account number {account_no}.
        slots:
          account_no: query.accountNo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{accountId}/remindersHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reminder letter history for an AR account
      effect: read
      questions:
      - What reminder letters have already been sent to a particular AR account, and when?
      - Can I filter an account's past reminders by the date they were sent?
      instructions:
      - text: Show the reminder letter history for AR account {account}.
        slots:
          account: path.accountId
      - text: List reminders sent to AR account {account} on {date_sent}.
        slots:
          account: path.accountId
          date_sent: query.dateSent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{accountId}/statements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get statements for one AR account (deprecated)
      effect: read
      questions:
      - How did the older per-account statements endpoint return billing statements for one AR account?
      - Is the account-scoped AR statements lookup still supported, or has it been deprecated?
      instructions:
      - text: Using the deprecated per-account endpoint, get statements for AR account {account}.
        slots:
          account: path.accountId
      - text: Fetch billing statements for AR account {account} at hotel {hotel} via the legacy account statements call.
        slots:
          account: path.accountId
          hotel: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arTransactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List AR transactions for hotels
      effect: read
      questions:
      - How can I pull accounts receivable transactions for a set of hotels over a date range?
      - What is the longest date span I can request when listing AR transactions?
      - Can I filter AR transactions by amount range or guest name in a simple query-string request?
      instructions:
      - text: List AR transactions for hotel {hotel} from {start} to {end}.
        slots:
          hotel: query.hotelIds
          start: query.startDate
          end: query.endDate
      - text: Get AR transactions for account {account} at hotel {hotel}.
        slots:
          account: query.accounts
          hotel: query.hotelIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arTransactions/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search AR transactions with a request body
      effect: read
      questions:
      - Can I post a search body to find AR transactions instead of putting filters in the URL?
      - Is there a POST search for accounts receivable transactions across many invoices or folios?
      instructions:
      - text: Run an AR transaction search for hotel {hotel} for guest {guest}.
        slots:
          hotel: requestBody.hotelIds
          guest: requestBody.guestName
      - text: Search AR transactions at hotel {hotel} on invoices {invoices} using the POST search.
        slots:
          hotel: requestBody.hotelIds
          invoices: requestBody.invoices
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an AR account for a profile
      effect: write
      questions:
      - How do I open a new accounts receivable account for a company profile at a hotel?
      - Do I need the OPERA profile ID before creating a direct-bill account?
      instructions:
      - text: Create a new AR account at hotel {hotel} with details {criteria}.
        slots:
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Open an accounts receivable account at hotel {hotel} for this company profile.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/invoicesOnHold'].get
  update:
    x-apievangelist-phrasing:
      intent: List AR invoices on hold
      effect: read
      questions:
      - Which accounts receivable invoices are currently on hold at my hotel?
      - Can I see held AR invoices for one profile within a date range?
      instructions:
      - text: List invoices on hold at hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Show held AR invoices at hotel {hotel} for profile {profile}.
        slots:
          hotel: path.hotelId
          profile: query.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/invoicesOnHold/searches'].post
  update:
    x-apievangelist-phrasing:
      intent: Search held AR invoices with a request body
      effect: read
      questions:
      - Is there a POST search for on-hold AR invoices that takes filters in the body?
      - Can I send account name and profile criteria in a body to find held invoices?
      instructions:
      - text: Run a body-based search for held invoices at hotel {hotel} on account {account_name}.
        slots:
          hotel: path.hotelId
          account_name: requestBody.accountName
      - text: Search on-hold invoices at hotel {hotel} for profile {profile} using the POST search.
        slots:
          hotel: path.hotelId
          profile: requestBody.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one AR account's details
      effect: read
      questions:
      - How do I look up the full details of a single accounts receivable account by its ID?
      - Can I include the account's instructions, like notes and traces, when fetching an AR account?
      instructions:
      - text: Get AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Show AR account {account} at hotel {hotel} including {instructions}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          instructions: query.fetchInstructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an AR account
      effect: write
      questions:
      - How do I change the settings of an existing accounts receivable account?
      - Can I edit an AR account's details after it has been created?
      instructions:
      - text: Update AR account {account} at hotel {hotel} with {details}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          details: requestBody.accountDetails
      - text: Modify the setup of AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AR account
      effect: destructive
      questions:
      - How do I permanently remove an accounts receivable account?
      - Can an AR account be deleted by its unique account ID?
      instructions:
      - text: Delete AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Remove accounts receivable account {account} from hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/applyCreditToInvoices'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply credits to AR invoices
      effect: write
      questions:
      - How do I apply an account's credit balance against its open AR invoices?
      - Can I use a credit on an accounts receivable account to settle invoices?
      instructions:
      - text: Apply credits to invoices on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Use the available credit on AR account {account} at hotel {hotel} to settle {criteria}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/arCreditCard/transfer'].post
  update:
    x-apievangelist-phrasing:
      intent: Transfer credit card payments into AR
      effect: write
      questions:
      - How do I move credit card payment transactions into an accounts receivable account?
      - Can card settlements be transferred to AR so they are tracked on the city ledger?
      instructions:
      - text: Transfer credit card payments into AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Move the card payment transactions {criteria} to AR account {account} at hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/charges'].post
  update:
    x-apievangelist-phrasing:
      intent: Post charges to an AR account
      effect: write
      questions:
      - How do I post a charge directly to an accounts receivable account?
      - What is the current endpoint for adding charges to an AR account without a profile in the path?
      instructions:
      - text: Post a charge to AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Add charges {criteria} to AR account {account} at hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/comments'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a note on an AR account
      effect: write
      questions:
      - How do I change the text of a note that already exists on an AR account?
      - Can I edit an existing comment on an accounts receivable account?
      instructions:
      - text: Update the existing note on AR account {account} at hotel {hotel} to {comment}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          comment: requestBody.commentInfo
      - text: Edit the comment already on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/comments'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to an AR account
      effect: write
      questions:
      - How do I attach a new note to an accounts receivable account?
      - Can I record a collections comment against an AR account?
      instructions:
      - text: Add a new note {comment} to AR account {account} at hotel {hotel}.
        slots:
          comment: requestBody.commentInfo
          account: path.accountId
          hotel: path.hotelId
      - text: Create a comment on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/comments'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a note from an AR account
      effect: destructive
      questions:
      - How do I remove a note from an accounts receivable account?
      - Do I need the note ID to delete a comment from an AR account?
      instructions:
      - text: Delete note {note} from AR account {account} at hotel {hotel}.
        slots:
          note: query.id
          account: path.accountId
          hotel: path.hotelId
      - text: Remove the comments from AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/compressInvoices'].put
  update:
    x-apievangelist-phrasing:
      intent: Combine several AR invoices into one
      effect: write
      questions:
      - Can I merge two or more accounts receivable invoices into a single invoice?
      - How do I compress an AR account's invoices so the customer gets one bill?
      instructions:
      - text: Compress invoices {criteria} on AR account {account} at hotel {hotel} into one.
        slots:
          criteria: requestBody.criteria
          account: path.accountId
          hotel: path.hotelId
      - text: Combine the open invoices on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/copyAccount'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy an AR account to other hotels
      effect: write
      questions:
      - How do I replicate an accounts receivable account from one hotel to several others?
      - Can I copy an AR account setup from a source property instead of recreating it?
      instructions:
      - text: Copy AR account {account} from hotel {hotel} to the target hotels {criteria}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          criteria: requestBody.criteria
      - text: Replicate AR account {account} at hotel {hotel} across our other properties.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/fixedCharges'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a fixed charge to an AR account
      effect: write
      questions:
      - How do I set up a recurring fixed charge on an accounts receivable account?
      - Can I create fixed charges like a monthly fee on an AR account?
      instructions:
      - text: Create fixed charge {fixed_charge} on AR account {account} at hotel {hotel}.
        slots:
          fixed_charge: requestBody.fixedChargeInfo
          account: path.accountId
          hotel: path.hotelId
      - text: Add a new fixed charge to AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/fixedCharges/{fixedChargeId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a fixed charge on an AR account
      effect: write
      questions:
      - How do I change the amount or schedule of an existing fixed charge on an AR account?
      - Can I edit a fixed charge I already set up for an accounts receivable account?
      instructions:
      - text: Update fixed charge {fixed_charge} on AR account {account} at hotel {hotel}.
        slots:
          fixed_charge: path.fixedChargeId
          account: path.accountId
          hotel: path.hotelId
      - text: Change fixed charge {fixed_charge} on AR account {account} at hotel {hotel} to {details}.
        slots:
          fixed_charge: path.fixedChargeId
          account: path.accountId
          hotel: path.hotelId
          details: requestBody.fixedChargeInfo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/fixedCharges/{fixedChargeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a fixed charge from an AR account
      effect: destructive
      questions:
      - How do I stop and remove a fixed charge on an accounts receivable account?
      - Can I delete one specific fixed charge by its ID?
      instructions:
      - text: Delete fixed charge {fixed_charge} from AR account {account} at hotel {hotel}.
        slots:
          fixed_charge: path.fixedChargeId
          account: path.accountId
          hotel: path.hotelId
      - text: Remove fixed charge {fixed_charge} on AR account {account} at hotel {hotel}.
        slots:
          fixed_charge: path.fixedChargeId
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/folioPrinters'].get
  update:
    x-apievangelist-phrasing:
      intent: List folio printers for an AR account
      effect: read
      questions:
      - Which folio printers are available for printing an accounts receivable account's folios?
      - Can I find the AR folio printers while overriding the credit hold check?
      instructions:
      - text: List folio printers for AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Get AR folio printers for account {account} at hotel {hotel} for cashier {cashier}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          cashier: query.cashierId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/invoices'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an invoice on an AR account
      effect: write
      questions:
      - How do I raise a new invoice against an accounts receivable account?
      - Can I create a manual AR invoice for a company account?
      instructions:
      - text: Create invoice {invoice} on AR account {account} at hotel {hotel}.
        slots:
          invoice: requestBody.invoice
          account: path.accountId
          hotel: path.hotelId
      - text: Raise a new invoice for AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/invoices/{invoiceId}/transactions'].put
  update:
    x-apievangelist-phrasing:
      intent: Delete today's transactions on an AR invoice
      effect: destructive
      questions:
      - Can I delete transactions on an AR invoice that were posted on the current business day?
      - What reason code and cashier do I need to remove same-day postings from an invoice?
      instructions:
      - text: Delete today's transactions {transactions} on invoice {invoice} for AR account {account} at hotel {hotel}.
        slots:
          transactions: requestBody.transactionList
          invoice: path.invoiceId
          account: path.accountId
          hotel: path.hotelId
      - text: Remove same-day postings from invoice {invoice} on AR account {account} at hotel {hotel} with reason {reason}.
        slots:
          invoice: path.invoiceId
          account: path.accountId
          hotel: path.hotelId
          reason: requestBody.reasonCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/statements'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a statement for an AR account
      effect: write
      questions:
      - How do I produce a new statement with aging summary for an accounts receivable account?
      - Can I generate a statement showing an AR account's balance as of the current business date?
      instructions:
      - text: Generate a statement for AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      - text: Create a new AR statement for account {account} at hotel {hotel} using {criteria}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          criteria: requestBody.criteria
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/traces'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a trace on an AR account
      effect: write
      questions:
      - How do I modify an existing follow-up trace on an accounts receivable account?
      - Can I edit the date or text of a trace already set on an AR account?
      instructions:
      - text: Update the existing trace on AR account {account} at hotel {hotel} to {trace}.
        slots:
          account: path.accountId
          hotel: path.hotelId
          trace: requestBody.traceInfo
      - text: Modify the traces already on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/traces'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a trace to an AR account
      effect: write
      questions:
      - How do I set a follow-up trace reminder on an accounts receivable account?
      - Can I add a new trace so staff are prompted to chase an AR account?
      instructions:
      - text: Add trace {trace} to AR account {account} at hotel {hotel}.
        slots:
          trace: requestBody.traceInfo
          account: path.accountId
          hotel: path.hotelId
      - text: Create a new follow-up trace on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/traces'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a trace from an AR account
      effect: destructive
      questions:
      - How do I remove a trace from an accounts receivable account?
      - Can I delete an AR account trace by its trace ID or date?
      instructions:
      - text: Delete trace {trace} from AR account {account} at hotel {hotel}.
        slots:
          trace: query.traceID
          account: path.accountId
          hotel: path.hotelId
      - text: Remove the trace dated {trace_on} on AR account {account} at hotel {hotel}.
        slots:
          trace_on: query.traceOn
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/transactions/{transactionId}/invoicePaymentDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: Get invoice and payment detail for an AR transaction
      effect: read
      questions:
      - How do I see the credit, debit and due date for a specific AR invoice transaction?
      - Can I get invoice and payment detail for one transaction on an AR account?
      instructions:
      - text: Get invoice and payment details for transaction {transaction} on AR account {account} at hotel {hotel}.
        slots:
          transaction: path.transactionId
          account: path.accountId
          hotel: path.hotelId
      - text: Show the amount due and due date for AR transaction {transaction} on account {account}, hotel {hotel}.
        slots:
          transaction: path.transactionId
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/accounts/{accountId}/uncompressInvoices'].post
  update:
    x-apievangelist-phrasing:
      intent: Split a combined AR invoice back apart
      effect: write
      questions:
      - Can I undo an invoice compression and get the original individual AR invoices back?
      - How do I break a combined accounts receivable invoice into its separate invoices?
      instructions:
      - text: Uncompress invoice {invoice} on AR account {account} at hotel {hotel}.
        slots:
          invoice: requestBody.invoiceDetails
          account: path.accountId
          hotel: path.hotelId
      - text: Reverse the invoice compression on AR account {account} at hotel {hotel}.
        slots:
          account: path.accountId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/agingCycles'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AR aging summary by aging bucket
      effect: read
      questions:
      - How much is outstanding in each aging bucket for our accounts receivable at a hotel?
      - Can I see credit limits and total outstanding balances per aging cycle for a property?
      instructions:
      - text: Show the AR aging cycles for hotel {hotel}.
        slots:
          hotel: path.hotelId
      - text: Get the outstanding AR balance per aging bucket at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/batchCharges'].post
  update:
    x-apievangelist-phrasing:
      intent: Post a one-time charge to many AR accounts
      effect: write
      questions:
      - Can I post the same one-time charge to many accounts receivable accounts at once?
      - How do I run a batch charge process across AR accounts at a hotel?
      instructions:
      - text: Post batch charge {criteria} to multiple AR accounts at hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          hotel: path.hotelId
      - text: Start a batch charging process for AR accounts at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/directBillsToAR'].put
  update:
    x-apievangelist-phrasing:
      intent: Transfer direct bills into AR
      effect: write
      questions:
      - How do I move checked-out direct bill folios into accounts receivable?
      - Can direct bills be transferred to an AR account in bulk for a hotel?
      instructions:
      - text: Transfer direct bills {criteria} to accounts receivable at hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          hotel: path.hotelId
      - text: Move the pending direct bills at hotel {hotel} into AR.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/invoices'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or transfer AR invoice details
      effect: write
      questions:
      - What is the current way to change an AR invoice's amount or transaction code?
      - Can I update or transfer invoice detail without passing the invoice ID in the path?
      instructions:
      - text: Update invoice details {details} at hotel {hotel}.
        slots:
          details: requestBody.invoiceDetails
          hotel: path.hotelId
      - text: Change the transaction code on an AR invoice at hotel {hotel} using the current invoices endpoint.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/invoices/{invoiceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one AR invoice by ID (deprecated)
      effect: write
      questions:
      - How did the older invoice-by-ID update change an AR invoice's amount?
      - Is the single-invoice update endpoint with the invoice ID in the path deprecated?
      instructions:
      - text: Using the deprecated per-invoice call, update invoice {invoice} at hotel {hotel}.
        slots:
          invoice: path.invoiceId
          hotel: path.hotelId
      - text: Change the amount on invoice {invoice} at hotel {hotel} via the legacy endpoint with {details}.
        slots:
          invoice: path.invoiceId
          hotel: path.hotelId
          details: requestBody.invoiceDetails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/invoices/{invoiceId}/transactions/{transactionId}/accounts/{accountId}/invoiceAppliedPayments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get payments applied to an invoice (deprecated)
      effect: read
      questions:
      - How did the legacy invoice-scoped endpoint return the payments applied to an AR invoice?
      - Is the applied-payments lookup that takes an invoice ID in the path deprecated?
      instructions:
      - text: Using the deprecated invoice-scoped call, get payments applied to invoice {invoice}, transaction {transaction}, account {account}, hotel {hotel}.
        slots:
          invoice: path.invoiceId
          transaction: path.transactionId
          account: path.accountId
          hotel: path.hotelId
      - text: Show legacy applied-payment history for invoice {invoice} on account {account}, transaction {transaction}, hotel {hotel}.
        slots:
          invoice: path.invoiceId
          account: path.accountId
          transaction: path.transactionId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/overlays/oracle-hospitality-accountsreceivables-api-phrasing-overlay.yaml