Use POS (point of sale)

Last verified: 2026-05-19

Use POS (point of sale)

Take in-venue or counter orders through the storefront POS screen (staff-operated).

Path

/pos/{slug} — replace {slug} with the location slug (same organization as the public storefront at /store/{slug}).

Requires staff (or admin) session with POS permissions (pos.read, pos.create_order, etc.).

Who can do this

RoleAccess
StaffWhen POS permissions granted
AdminTypically yes

Steps

  1. Sign in as staff or admin.
  2. Navigate to /pos/{location-slug} for the active branch.
  3. Build an order using the POS catalog UI (categories, items, modifiers).
  4. Assign order type (dine-in, pickup, etc.) if prompted.
  5. Submit payment or mark order per POS workflow (cash/card integrations vary by merchant).
  6. Order appears in /staff/orders or /admin/orders for fulfillment status updates.

Offline mode (cash only)

POS can continue limited operations when connectivity drops after the terminal has cached the branch catalog while online.

  1. Open /pos/{slug} online at least once so menu, categories, and tables are cached locally.
  2. Staff PIN login can use a cached credential snapshot after a prior successful online login.
  3. When offline, the banner shows Offline mode — cash orders only.
  4. New orders are saved to a local outbox and sync automatically when the connection returns.
  5. Cash payments for offline-created orders are queued and applied after the parent order sync completes.
  6. Card and e-wallet payments remain unavailable offline.

Superadmin ops can review server-side queue health at /superadmin/pos-offline-ops.

Status updates from POS

POS status changes may call /api/pos/order/status — fulfillment staff should still monitor the orders dashboard for PreparingReadyCompleted transitions.

Verify it worked

  • Order number appears in staff/admin orders list.
  • Kitchen or customer displays update if configured.

Common issues

SymptomLikely causeWhat to do
403 / redirectMissing POS permissionAdmin updates role
Wrong location catalogWrong slug in URLUse correct branch slug

Related articles

Loading footer...