STL Cookbook

Sell retail goods at the front desk

Configure retail products in Console, create a store order manually, and settle to a non-guest folio.

Front-desk or operations staff use this flow to sell physical retail goods (multiple products and quantities in one order). It does not cover Guest App self-service purchases (such as extra cleaning or kitchen unlock), and it does not cover front-desk manual orders for products whose target guest is In-house guests only.

Entry: Console → Stey+ Store → Store Order Center. Product setup: Console → Stey+ Store → Product Management.

Prerequisites

  • The property has product category retail_goods (Retail goods); auto-redeem after successful payment.
  • The retail category is bound to an appropriate revenue transaction code. See Product categories.
  • Products to sell are created, listed, and set to target guest Everyone (manual create does not show In-house guests only products).
  • The non-guest folio has at least one Window; otherwise settlement is blocked. See Non-guest folio.
  • For manual payment, the property has payment transaction codes with group=payment and is_revenue=false.
  • For POS payment, a POS payment provider is configured under finance payment settings.
  • Permissions: access to Store Order Center and related finance actions (exact permission names pending confirmation).

Steps

Configure retail products

Go to Console → Stey+ Store → Product Management, then click Create Product (or edit an existing product).

Fill in basic fields (same rules as Create product); set Product Category to retail_goods (Retail goods):

  • Product Code (required): up to 20 characters, English letters and numbers only, must be unique; cannot be changed after creation.
  • Product Name (required): up to 50 characters; Chinese and English supported.
  • Product Description (required): up to 200 characters; Chinese and English supported.
  • Product Price (required): tax-inclusive; positive number under 6 digits, up to 2 decimal places (placeholder: enter tax-inclusive price).
  • Inventory (required): positive integer under 6 digits; default 99 on create.
  • Listed: toggle, off by default; turn on for front-desk sale.

Select Target guest (required): Everyone (available for front-desk manual sale; default) or In-house guests only (hidden from the front-desk create-order catalog).

(Optional) Upload a product image: JPG/PNG, under 500KB, single image; proportional crop supported. If omitted, a default placeholder is used.

Click Confirm, and verify the product is listed with correct inventory.

Create/edit dialogs can update target guest and product image. Product Code cannot be edited later; use Set product price / Set product inventory under More for price and stock (same limits as create). At feature launch, existing listed products are set to In-house guests only; change them to Everyone and confirm listing before front-desk retail sale.

Create a store order and add items

Go to Console → Stey+ Store → Store Order Center, then click Create store order.

Search or browse the catalog and click a product card to add it (each click adds 1). Products with inventory 0 show Out of stock and cannot be added.

In the selected list, adjust quantity with +/− or by typing (1–999), or remove a line; check total pieces and amount.

Under Posting location, select the non-guest folio Window (required; defaults to the first Window).

When products and Window are set, click Go to settlement.

The catalog shows only listed products with target guest Everyone, sorted by creation time ascending. Inventory is not checked while adding; it is checked when clicking Go to settlement. If stock is insufficient, the line shows available inventory; if OK, the system creates a pending-payment store order, deducts inventory, and opens the settlement dialog.

Settle with manual payment

In the settlement dialog, check quantity and amount, then choose Manual payment.

Select a payment transaction code (required, no default; searchable).

Click Confirm.

After confirm, the system posts a charge and a payment on the selected Window (remarks include store order number and product list) and auto-redeems the store order to Completed. Verify amount, Window, and transaction code before confirming.

Remark language follows the property preferred language. You return to a refreshed Store Order Center.

Settle with POS payment

POS payment appears only when a POS provider is configured under finance payment settings.

In the settlement dialog, check totals, choose POS payment, then click Confirm.

The system posts a charge on the Window and opens the POS dialog for the pending amount; complete payment on the terminal.

POS success: a payment is posted and the store order is redeemed to Completed. POS failure or timeout: no payment is posted; the charge created for this attempt is deleted. After closing the dialog, Console has no resume-settlement entry for that order — wait for payment timeout so the order cancels and inventory restores, then create a new order.

Cancel settlement

Click Cancel in the settlement dialog to close it. Console has no resume-settlement entry. After the existing payment timeout, the order becomes Cancelled and inventory is restored. To sell again, create a new store order.

Inventory is deducted as soon as Go to settlement succeeds. After cancel or POS failure, inventory restores only when the order times out and cancels — do not expect to collect on the same order again.

View details and receipt PDF

In Store Order Center, click View details for the order (new browser tab).

Check basics, product lines, and posting location; click View PDF when a receipt is needed.

Edit remarks on the detail page if needed, then save (Save stays enabled).

For non-guest folio posting, guest shows as Customer, and posting location shows Non-guest folio | window name. The PDF title is Receipt; numbers are unique and sequential per day (example: 250315-HIN-0234). VAT is omitted when the property has no VAT config. Redeem / unlock actions appear only under existing rules; retail orders auto-redeem after successful payment, so manual redeem is usually unnecessary.

Result

  • Store order status is Completed.
  • The non-guest folio Window has charge and payment transactions (remarks include store order number and product list).
  • Inventory is reduced by sold quantities.
  • Product detail PDF is available from the detail page when needed.

FAQ

On this page