1. Getting Started

1a. Opening the POS (Cashier Login)

Open a web browser and navigate to https://soho.nightpos.com. The NightPOS cashier login screen appears automatically.

1b. Staff Login Types

The cashier screen has two tabs:

Tab	Who uses it	How to log in
Normal	Managers and admin users with an Odoo account	Enter your Email and Password, then tap Log in.
Staff	POS cashiers assigned a numeric PIN	Enter your Staff PIN (numeric), then tap Log in.

1c. Back-Office (Admin) Login

For configuration, reporting, and settings access, use the Normal tab with your admin credentials:

1. On the cashier screen, click the Normal tab.

2. Enter Email: your Odoo admin email, and Password.

3. Tap Log in. You will be taken to the POS Dashboard.

2. POS Dashboard

2a. Dashboard Overview

After logging in, you land on the NightPOS home screen showing all available apps. Click Point of Sale to manage registers, or access NightPOS Printer, Employees, Accounting, and more.

Clicking Point of Sale opens the POS Dashboard showing all configured registers (e.g., SOHO Club and AfroRoom).

The top navigation bar provides access to:

Menu	Purpose
Dashboard	Return to the POS register list at any time.
Orders	View all past and current POS orders.
Products	Manage items available in the POS.
Reporting	Sales reports, session summaries, and statistics.
Configuration	POS settings, floor plans, printers, employees, and product categories.

2b. Opening & Continuing a Session

Each POS register card shows its status:

• Open Register — No session is running. Click to create a new session and set the opening cash balance.
• Continue Selling — A session is already open. Click to resume without entering an opening balance again.

1. From the Dashboard, find the register (e.g., SOHO Club or AfroRoom).

2. Click Open Register or Continue Selling.

3. If opening a new session, an Opening Control dialog appears. Enter the opening cash in the drawer and click Open.

4. The POS interface opens.

3. Using the Point of Sale

3a. POS Screen Overview

Area	Description
Top navigation	Tables / Register / Orders tabs, active table badge (e.g., T1), search bar, LNA button, and hamburger menu (☰).
Left panel – Order lines	Current order for the selected table. Shows qty, product name, and price per line. Total shown at the bottom.
Right panel – Product grid	Browse and tap products by category tab (Beers, Cocktails, Liquors, etc.). Products show photos and prices.
Bottom-left bar	Customer name, Note, Course, and the ellipsis (⋮) menu for additional actions.
Bottom-right	New (new order) and the purple Payment button to complete the transaction.

3b. Adding Products to an Order

1. Tap a category tab on the left to filter products.

2. Tap a product tile — it is added to the order with quantity 1.

3. To change quantity: tap the order line, then use the numpad to enter the new qty, or press + / −.

4. To remove a line: select the line and press the Delete / Trash button.

3c. Modifiers & Variants

NightPOS supports product modifiers (e.g., "Extra spicy", "No sugar") and price variants.

1. When you tap a product that has modifiers, a modifier popup appears automatically.

2. Select the desired options. Mandatory modifiers must be chosen before the item is added.

3. Tap Add to Order to confirm.

3d. Discounts & Price Changes

1. Select an order line on the right panel.

2. Tap Disc on the numpad and enter the discount percentage (e.g., 10 for 10%).

3. To override the unit price: tap Price on the numpad and type the new price.

3e. Table / Floor Plan (Restaurant Mode)

When the POS is in restaurant mode (e.g., AfroRoom), opening the session shows the floor plan with all tables, VIP booths, and the bar area.

• Tap a table (T1–T25, VIP1–VIP9, B1–B8 bar stools) to open or create its order.
• Tables with a green timer badge (e.g., "51:32") have an active order — the time shows how long the table has been occupied.
• Free tables are shown in dark/grey with no timer.
• VIP tables show the minimum spend amount (e.g., 10,000 ฿).
• Use + New Order in the top bar to create a takeaway or delivery order not tied to a table.
• Tap Register to see all open orders, or Orders to view order history.

3f. Payment

1. When the order is complete, tap the green Payment button (bottom-right of the order panel).

2. Select the payment method: Cash, Credit Card, QR/PromptPay, etc.

3. Enter the amount tendered (for cash). The change due is calculated automatically.

4. Tap Validate to complete the payment and print the receipt.

Payment Method	Notes
Cash	Enter the amount received; the system shows the change to give.
Credit / Debit Card	Process on the card terminal; mark as paid in POS.
Bank Transfer / QR (PromptPay)	Show the QR code to the customer; confirm once payment is received.
Split Payment	Tap a payment method, enter partial amount, then add another method for the remainder.

3g. Receipts

After validation, the receipt is sent to the configured printer automatically. You can also:

• Tap Send by Email to email the receipt to the customer.
• Tap Print to reprint manually.
• Tap New Order to skip the receipt screen and start the next order immediately.

3h. Cancelling & Refunds

Cancel an order (before payment)

1. Tap the menu icon ☰ in the top bar.

2. Select Cancel Order (or delete all order lines individually).

Refund a paid order

1. From the POS, tap ☰ → Orders to find the original order.

2. Open the order and tap Refund.

3. Select which lines to refund and the quantity.

4. Tap Apply, then process the refund payment (cash back or card reversal).

3i. Closing a POS Session

1. Tap ☰ → Close.

2. Count the physical cash in the drawer and enter the Closing Cash Balance.

3. Review the session summary (total sales, payments by method, cash difference).

4. Tap Close Session to finalise. All data is posted to accounting.

4. POS Settings

4a. Opening Settings

1. From the dashboard, click Configuration in the top menu.

2. Click Settings.

3. Use the POS configuration selector at the top to switch between registers (e.g., SOHO Club, AfroRoom).

4b. Receipt Printer (NightPOS)

This section controls how customer receipts are printed after each payment.

Device Print Policy

Policy	When to use
Shop setting on every device	All devices use the same print mode configured in Settings. Best when all terminals are identical.
Auto-detect on each device	Each device picks the best method automatically (Sunmi → built-in printer, PC → browser). Recommended for mixed environments.
Per-device choice (saved in database)	Each device's choice is saved permanently. The operator selects mode on POS login. Use when devices need different explicit modes.

Receipt Print Mode

Mode	Description
NightPOS Browser / IoT Box	Uses the browser print dialog or Odoo IoT Box. No extra hardware needed.
TCP/IP (Server)	Odoo server connects directly to a network ESC/POS printer via IP:port. Printer must be on the same network as the server.
Sunmi built-in (NightPOS App)	Uses the built-in hardware printer in Sunmi devices (T1, V2, P2). Requires the NightPOS Android app.
Chrome Extension (Local)	Prints to a local Windows or CUPS printer via the NightPOS Chrome Extension. Best for PC-based POS on a LAN printer.

Paper Width

Choose 58 mm (Sunmi T1, V2, P2 narrow roll) or 80 mm (standard wide roll).

Test Print

After configuring the printer, click Test Print to verify the printer works before going live.

4c. Preparation / Kitchen Printers

Kitchen/bar printers receive order tickets when an order is placed (before payment).

1. Enable the Preparation Printers toggle.

2. Click Add a line to assign one or more printer records (see §5 to create printers).

3. Each printer in the list receives a kitchen ticket whenever an order is sent to the kitchen.

4. Click Test Print to verify each kitchen printer.

5. Click Manage Printers to open the full printer list.

4d. Floor Plan

Configure the restaurant table layout under Configuration → Floor Plans.

1. Click New to create a floor (e.g., "Main Hall", "Terrace", "Bar").

2. Use the visual editor to add and arrange tables.

3. Set the number of seats for each table.

4. Click Save and reload the POS session to see the updated floor plan.

4e. Staff & Access Control

• Go to Configuration → Employees to manage POS staff.
• Each employee can have a PIN for fast POS login (Staff tab).
• Roles (Cashier, Manager) control which actions require a PIN override — discounts, refunds, cash in/out.
• Managers can reset PINs or revoke access from this screen.

4f. Products & Categories

• Products → Products — add/edit items, set POS price, category, and product image.
• Each product must have Available in POS enabled to appear in the POS.
• Configuration → Product Categories — reorder the category tabs shown in the POS product grid.
• Use Modifiers to add options (size, toppings, customisations) to products.

5. Printer Management

5a. Adding a Printer

1. Go to Configuration → Printers (NightPOS Printer menu) or click Manage Printers inside POS Settings.

2. Click New.

3. Enter a Name (e.g., "Cashier Counter", "Kitchen 1", "Bar Printer").

4. Choose the Printer Type (see §5b).

5. Fill in the required fields for that type (IP address, port, printer name, etc.).

6. Click Save, then Test Print to verify.

5b. Printer Types Explained

Type	Required fields	Best for
NightPOS Browser / IoT Box	None (uses browser)	Standard Odoo IoT box or browser print dialog.
TCP/IP (ESC/POS)	IP Address, Port (default 9100)	Any network-connected ESC/POS thermal printer. The Odoo server must reach the printer's IP directly.
Sunmi built-in	Leave IP empty for built-in; IP+Port to print to a network printer from Sunmi	Sunmi T1, V2, P2, P2 Pro hardware printers via the NightPOS Android app.
Chrome Extension (Local)	Windows / Local Printer name (exact queue name)	PC browser printing to a USB or local network printer using the NightPOS Chrome Extension.

Network Protocol (TCP/IP only)

Protocol	Description
TCP/IP (ESC/POS port 9100)	Raw ESC/POS bytes over a socket. Most common for standalone thermal printers.
Epson ePOS (HTTP)	Sends print via HTTP to the printer's built-in web server. Works via Chrome LNA.
Sunmi built-in (NightPOS App)	Delegates to the NightPOS Android app SDK. No IP needed.

Paper Width

Set to 58 mm or 80 mm to match the paper roll installed. This controls receipt column width and layout.

Shared / Exclusive

Enable Shared if any device in the shop may use this printer. Leave off to assign it to one specific terminal (e.g., cashier's tablet only).

5c. Test Print

From the Printer form or from POS Settings, click Test Print. A test receipt is sent immediately. If the test fails:

• Verify the IP address and port are correct and the printer is powered on and connected to the network.
• Ensure the Odoo server and the printer are on the same LAN (or connected via VPN).
• For Chrome Extension: ensure the NightPOS Print Server app is running on the PC.
• For Sunmi: ensure the NightPOS app is open and not minimised or sleeping.

5d. Per-device Printer Profiles

When Device Print Policy is set to Per-device choice, each terminal selects its own printer at POS login:

1. On the POS login screen, tap This device: … at the top-right.

2. A dialog lets you pick the print mode and printer for this device only.

3. The choice is saved in the database, linked to the browser's device key, and remembered across sessions.

Managers can review and change per-device assignments from Settings → Device print profiles.

6. Orders & Reporting

6a. Viewing Orders

Go to Orders → Orders in the top menu. You can:

• Filter by date, cashier, payment method, or status.
• Search by order number or customer name.
• Click any order to view its detail, reprint the receipt, or initiate a refund.

6b. Sessions

Go to Orders → Sessions to see all past and current POS sessions. Each session shows the cashier, opening/closing balance, total sales, and whether it was properly closed.

6c. Sales Reports

Go to Reporting in the top menu for:

• Sales — revenue by product, category, or period.
• Daily / Weekly summaries — per-session totals with cash reconciliation.
• Payment method breakdown — split between cash, card, QR, etc.

7. Troubleshooting

Problem	Likely cause	Solution
POS login shows "Please fill out this field"	Submitted without entering credentials	Enter your Staff PIN (Staff tab) or Email + Password (Normal tab) before clicking Log in.
Receipt does not print after payment	Printer offline, wrong IP, or wrong mode	Use Test Print in Settings to diagnose. Verify IP, port, and that the printer is on the network and powered on.
Kitchen ticket not sent	Preparation printer not assigned or offline	Go to Settings → Preparation Printers, verify the printer is listed. Run a test print.
Register shows "Open Register" even though it was used yesterday	Yesterday's session was properly closed	Normal — click Open Register to start a new session. Enter the opening cash balance.
Register is stuck / won't open (says "already open")	A previous session was not closed properly	Go to Orders → Sessions in the back office, find the open session, and close it manually.
Cash drawer does not open	Cashdrawer not enabled or wrong printer selected	In Settings, enable the Cashdrawer toggle and ensure the receipt printer is the one the drawer is connected to (usually via the RJ-11 port).
Products not visible in POS	"Available in POS" not enabled on the product	Go to Products → Products, open the product, and enable Available in POS.
Modifier popup does not appear	Modifiers not linked to the product or category	Go to Configuration → Modifiers and assign modifiers to the product category or product.
Chrome Extension not printing	NightPOS Print Server app not running on PC	Open the NightPOS Print Server desktop app on the cashier PC, confirm the correct printer name, and refresh the Chrome printer list in Settings.
Wrong paper width on receipt	Paper width setting mismatch	In Settings → Receipt Printer, set Paper Width to match the roll installed (58mm or 80mm). Do a test print.
Cannot close session — "payment difference" error	Cash counted differs from system total	Re-count the cash carefully. If there is a genuine difference, the system will record it as an over/short and allow you to close anyway.