⚙️ Workspace Settings¶
The Workspace Settings page allows Shop Owners and authorized managers to configure global settings that apply to the entire shop.
Accessing Settings¶
Navigate to ⚙️ Settings (ការកំណត់) in the sidebar, then select Workspace Settings. You must have the settings.manage permission to make changes here.
1. General Shop Information¶
- Shop Name: This is the global display name for your shop.
- Exchange Rate (USD → KHR): Set your shop's official exchange rate (e.g., $1 = 4100៛). This rate is used throughout the app to convert prices and calculate KHQR payments.
- Payout QR Code: Upload your bank's KHQR image here. ChouyLok will decode it automatically so customers can scan and pay you directly.
Restaurant (F&B) add-on¶
Every new shop starts with goods only: products, stock and the POS. Restaurant features are a paid add-on, found at the bottom of the General (ទូទៅ) tab under Add-ons (កម្មវិធីបន្ថែម).
- ភោជនីយដ្ឋាន (F&B) — Restaurant: turns on the food and drink Menu, Tables, the Kitchen screen and dispatch stations for every branch.
- លាក់ទំនិញ (ភោជនីយដ្ឋានសុទ្ធ) — Hide goods (restaurant only): appears only while the Restaurant add-on is on. Turn it on if you sell only food and drink; it hides the goods POS (លក់ទំនិញ) and the Products list. Your existing products are kept.
How the switches work:
- Only the shop owner can change them. Other staff see them greyed out.
- Each switch asks you to confirm, then takes effect immediately — you do not need to tap Save. The sidebar updates straight away.
- If you have unsaved changes elsewhere on the page, the app asks you to save or cancel them first.
- You cannot switch the Restaurant add-on off while any table order is still open or waiting for the bill, or while kitchen tickets are still waiting, cooking or ready. Close them first. Switching off hides the restaurant screens but keeps their data.
- You cannot hide goods while there are paused (parked) sales on the POS. Finish or delete them first.
Price: 20,000 ៛ a month for the whole shop, added to the product subscription and covering every branch. Under the updated subscription policy, F&B is free during the one-month trial. If enabled during a paid cycle, that cycle includes the full fee even if switched off before invoicing. There is no partial-month discount. Accounts awaiting the subscription update keep their displayed terms. See Billing & subscription.
Dedicated hosting interest¶
When available in your app, owners can open Settings → សេវាទិន្នន័យដាច់ដោយឡែក to Register interest. Registration may also show an optional guide link. Shared hosting remains the default. The page shows your current database status; the team must confirm availability and agree the service before activating it.
Describe your expected branches/orders, reason and contact details. Backup requirements, preferred date and budget are optional. Do not enter passwords. You can track the team's response and withdraw an open request from this page.
A separate database on a shared server still shares server resources. Separate server hosting may cost more. Submission creates no database, migration or charge; any future service scope, setup/migration fees and start date require agreement. See Dedicated database hosting for request statuses, maintenance, backups, restore and returning to shared storage.
2. Tax (VAT) Configuration¶
Set how your shop handles taxes at checkout:
- Tax Rate (%): The percentage of tax to charge. If left at 0, no tax is applied.
- Tax Mode:
- Inclusive (រួមបញ្ចូលពន្ធ): The shelf price already includes the tax.
- Exclusive (ដកពន្ធ): Tax is added on top of the subtotal at checkout.
- Tax Label: What the tax is called on receipts (e.g., "VAT").
3. Telegram Integration¶
Connect a Telegram bot to send digital receipts and promotions directly to your customers' Telegram accounts.
- Bot Token: Enter your Telegram bot token (from BotFather). For security, this field will appear blank after saving.
- Bot Username: Enter the @username of your bot so ChouyLok can generate links for your customers.
4. Stock Policy¶
- Expired-Stock Policy: Choose what the POS does when a product batch is expired:
- Block: Prevents the cashier from selling the expired item.
- Warn: Allows the sale but displays a warning.
Loyalty tiers, the birthday bonus and the point value are no longer here: open Customers and tap the settings button at the top (see Points and Store Credit).
Remember to click Save (រក្សាទុក) after making any changes. (The add-on switches are the exception: they take effect as soon as you confirm.)