# 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'
- target: $.paths['/hotels/{hotelId}/invoices/{invoiceId}/transactions/{transactionId}/paymentsFromInvoice'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove payments from an invoice (deprecated)
      effect: destructive
      questions:
      - How did the legacy invoice-scoped call remove payments from an AR invoice?
      - Is the payment removal endpoint that takes an invoice ID in the path deprecated?
      instructions:
      - text: Using the deprecated call, remove payment {trx_no} from invoice {invoice}, transaction {transaction}, account {account}, hotel {hotel}.
        slots:
          trx_no: query.trxNo
          invoice: path.invoiceId
          transaction: path.transactionId
          account: query.accountId
          hotel: path.hotelId
      - text: Unapply payment {trx_no} on legacy invoice {invoice} for account {account} at hotel {hotel}, transaction {transaction}.
        slots:
          trx_no: query.trxNo
          invoice: path.invoiceId
          account: query.accountId
          hotel: path.hotelId
          transaction: path.transactionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/profiles/{profileId}/accounts/{accountId}/charges'].post
  update:
    x-apievangelist-phrasing:
      intent: Post charges via profile path (deprecated)
      effect: write
      questions:
      - How did the older profile-scoped endpoint post charges to an AR account?
      - Is posting AR charges under the profile path deprecated?
      instructions:
      - text: Using the deprecated profile-scoped call, post charges to AR account {account} for profile {profile} at hotel {hotel}.
        slots:
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      - text: Add legacy charges {criteria} to AR account {account}, profile {profile}, hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/profiles/{profileId}/accounts/{accountId}/payments'].post
  update:
    x-apievangelist-phrasing:
      intent: Pay an AR account for a list of reservations
      effect: write
      questions:
      - How do I record a payment on an accounts receivable account covering several reservations?
      - Can one AR payment be applied across a list of reservations?
      instructions:
      - text: Post a payment to AR account {account} for profile {profile} at hotel {hotel}.
        slots:
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      - text: Record payment {criteria} on AR account {account} of profile {profile} at hotel {hotel} for these reservations.
        slots:
          criteria: requestBody.criteria
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/profiles/{profileId}/accounts/{accountId}/statementsHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get statement history for an AR account
      effect: read
      questions:
      - What statements have previously been sent for a profile's AR account?
      - Can I filter an AR account's statement history by the date sent?
      instructions:
      - text: Show statement history for AR account {account} of profile {profile} at hotel {hotel}.
        slots:
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      - text: List statements sent on {date_sent} for AR account {account}, profile {profile}, hotel {hotel}.
        slots:
          date_sent: query.dateSent
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/profiles/{profileId}/accounts/{accountId}/transactions/{transactionId}/reversePayment'].post
  update:
    x-apievangelist-phrasing:
      intent: Reverse a mistaken AR payment
      effect: destructive
      questions:
      - How do I reverse a payment that was posted to an AR account by mistake?
      - Can I undo an accidental accounts receivable payment transaction?
      instructions:
      - text: Reverse payment transaction {transaction} on AR account {account} for profile {profile} at hotel {hotel}.
        slots:
          transaction: path.transactionId
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      - text: Undo the erroneous AR payment {transaction} on account {account}, profile {profile}, hotel {hotel}.
        slots:
          transaction: path.transactionId
          account: path.accountId
          profile: path.profileId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/accounts/{accountId}/invoiceAppliedPayments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get payments applied to an AR invoice
      effect: read
      questions:
      - Which payments have been applied to a given accounts receivable invoice?
      - What is the current endpoint for an AR invoice's applied payment history?
      instructions:
      - text: Get applied payments for transaction {transaction} on AR account {account} at hotel {hotel}.
        slots:
          transaction: path.transactionId
          account: path.accountId
          hotel: path.hotelId
      - text: Show payments applied to invoice number {invoice_no} for account {account}, transaction {transaction}, hotel {hotel}.
        slots:
          invoice_no: query.invoiceNo
          account: path.accountId
          transaction: path.transactionId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/creditcard/payments'].get
  update:
    x-apievangelist-phrasing:
      intent: List folios paid by card linked to AR
      effect: read
      questions:
      - Which guest folios were settled with a credit card transaction code that is linked to AR?
      - Can I list card-paid AR folios for a date range at a hotel?
      instructions:
      - text: List folios paid with card transaction code {transaction} at hotel {hotel}.
        slots:
          transaction: path.transactionId
          hotel: path.hotelId
      - text: Get AR credit card folios for transaction code {transaction} at hotel {hotel} from {start} to {end}.
        slots:
          transaction: path.transactionId
          hotel: path.hotelId
          start: query.startDate
          end: query.endDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/transactions/{transactionId}/paymentsFromInvoice'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove payments applied to an AR invoice
      effect: destructive
      questions:
      - How do I unapply a payment that was applied to the wrong AR invoice?
      - What is the current endpoint for removing payments from an accounts receivable invoice?
      instructions:
      - text: Remove payment {trx_no} from transaction {transaction} on AR account {account} at hotel {hotel}.
        slots:
          trx_no: query.trxNo
          transaction: path.transactionId
          account: query.accountId
          hotel: path.hotelId
      - text: Unapply payment {trx_no} from invoice number {invoice_no} for account {account}, transaction {transaction}, hotel {hotel}.
        slots:
          trx_no: query.trxNo
          invoice_no: query.invoiceNo
          account: query.accountId
          transaction: path.transactionId
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/unlink/invoiceFromStatement'].put
  update:
    x-apievangelist-phrasing:
      intent: Unlink invoices from an AR statement
      effect: write
      questions:
      - How do I take an invoice off a statement so it can go on a different statement?
      - Can I detach AR invoices from the statement they were included in?
      instructions:
      - text: Unlink invoices {criteria} from their statement at hotel {hotel}.
        slots:
          criteria: requestBody.criteria
          hotel: path.hotelId
      - text: Remove the invoice from its current AR statement at hotel {hotel}.
        slots:
          hotel: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/invoicePayments/accounts/{accountId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get payment data for an account's invoices
      effect: read
      questions:
      - How can I see payments against all invoices on one AR account, including zero-balance ones?
      - What is the page size limit when pulling invoice payments for an AR account?
      instructions:
      - text: Get invoice payment data for AR account {account}.
        slots:
          account: path.accountId
      - text: 'List invoice payments for AR account {account} including zero-balance invoices: {incl_zero}.'
        slots:
          account: path.accountId
          incl_zero: query.inclZeroBalance
      method: generated
      generated: '2026-09-26'
- target: $.paths['/invoicePostings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AR invoice postings
      effect: read
      questions:
      - Where can I list the postings that make up accounts receivable invoices?
      - Can I pull AR invoice postings by folio number or posting date, and how many days can I span?
      instructions:
      - text: Get AR invoice postings for invoice number {invoice_no}.
        slots:
          invoice_no: query.invoiceNo
      - text: List AR postings dated {posting_date}.
        slots:
          posting_date: query.postingDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/invoices/close'].put
  update:
    x-apievangelist-phrasing:
      intent: Close (freeze) AR invoices
      effect: destructive
      questions:
      - How do I freeze an AR invoice so no more postings can be added?
      - Can I close several accounts receivable invoices at once?
      instructions:
      - text: Close AR invoices {invoices}.
        slots:
          invoices: requestBody.invoices
      - text: Freeze the selected accounts receivable invoices so they cannot be changed.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/invoicesAccount'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the AR account on an invoice
      effect: write
      questions:
      - How do I change which AR account an invoice is billed to for a profile or reservation?
      - Can I reassign an existing accounts receivable invoice to a different account for a reservation?
      instructions:
      - text: Change the AR account on invoices using {criteria}.
        slots:
          criteria: requestBody.criteria
      - text: Reassign the reservation's AR invoice to a different accounts receivable account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/oldBalances'].post
  update:
    x-apievangelist-phrasing:
      intent: Import old balances from external accounting
      effect: write
      questions:
      - How do I bring opening balances from our previous accounting system into OPERA accounts receivable?
      - Can I load legacy AR balances when migrating to a new system?
      instructions:
      - text: Import old AR balances {balances}.
        slots:
          balances: requestBody.oldBalances
      - text: Load the legacy accounting system's outstanding balances into accounts receivable.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/{profileId}/aging'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a profile's AR aging summary
      effect: read
      questions:
      - What is a company profile's overall AR position, including fixed charges, balances and statements?
      - Can I view a profile's accounts receivable aging in a specific currency?
      instructions:
      - text: Get the AR aging summary for profile {profile}.
        slots:
          profile: path.profileId
      - text: Show AR aging for profile {profile} in {currency} at hotel {hotel}.
        slots:
          profile: path.profileId
          currency: query.currency
          hotel: query.hotelIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/{profileId}/yearViews'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a profile's month-by-month AR totals
      effect: read
      questions:
      - How do I see accrued debits and credits month by month for a profile's AR accounts?
      - Can I get a yearly view of a company's accounts receivable net totals?
      instructions:
      - text: Show the AR year view for profile {profile}.
        slots:
          profile: path.profileId
      - text: Get monthly accrued debits and credits for profile {profile} in {currency}.
        slots:
          profile: path.profileId
          currency: query.currency
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reopenInvoices'].put
  update:
    x-apievangelist-phrasing:
      intent: Reopen closed AR invoices
      effect: write
      questions:
      - Can I unfreeze an AR invoice that was closed so it can be edited again?
      - How do I reopen a closed accounts receivable invoice?
      instructions:
      - text: Reopen closed AR invoices {invoices}.
        slots:
          invoices: requestBody.invoices
      - text: Unfreeze the closed accounts receivable invoice so postings can be added.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/accountReceivables/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the accounts receivable service status
      effect: read
      questions:
      - Is the OPERA Cloud accounts receivable service up right now?
      - How can I health-check the AR service before calling it?
      instructions:
      - text: Ping the accounts receivable service.
      - text: Check whether the AR service is available for hotel {hotel}.
        slots:
          hotel: header.x-hotelid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/statements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AR statements for billing
      effect: read
      questions:
      - How do I pull billing statements for an AR account holder using the current statements endpoint?
      - Can I find AR statements by folio number or fiscal bill number?
      instructions:
      - text: Get AR statements for account {account} at hotel {hotel}.
        slots:
          account: query.accountID
          hotel: query.hotelId
      - text: Find AR statements for profile {profile}.
        slots:
          profile: query.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transferInvoicesAndPayments'].put
  update:
    x-apievangelist-phrasing:
      intent: Move an invoice or payment to another AR account
      effect: write
      questions:
      - How do I move an invoice or payment from one AR account to another?
      - Can I transfer just part of an invoice to a different accounts receivable account?
      instructions:
      - text: Transfer invoices and payments between AR accounts using {criteria}.
        slots:
          criteria: requestBody.criteria
      - text: Move a portion of this AR invoice to a different company's account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transferPostings'].put
  update:
    x-apievangelist-phrasing:
      intent: Move postings between AR invoices
      effect: write
      questions:
      - Can I move individual postings from one AR invoice onto another invoice?
      - How do I transfer charges between two accounts receivable invoices?
      instructions:
      - text: Transfer postings between AR invoices using {criteria}.
        slots:
          criteria: requestBody.criteria
      - text: Move these charges off one AR invoice and onto another invoice.
      method: generated
      generated: '2026-09-26'