Bán lẻ (POS)
Trang này được sinh tự động từ nội dung hướng dẫn trong ứng dụng — sửa ở
featureToggleGuidesrồi chạypnpm gen:feature-toggle-docs.
Bắt buộc khách hàng khi bán
Chặn hoàn tất giao dịch nếu chưa gắn khách hàng.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.customer_required_on_sale | Tắt | /pos/settings | — |
Cách hoạt động
Mọi giao dịch bán gửi lên máy chủ (quầy, đồng bộ bill offline, kênh bán) phải gắn khách POS hoặc khách hàng CRM; không có thì giao dịch bị từ chối.
Khi BẬT
Nút Thu tiền bị chặn tới khi chọn khách. Giao dịch tới máy chủ mà không có khách bị từ chối và không lưu gì — không bill, không trừ kho, không thanh toán.
Khi TẮT
Cho bán khách vãng lai. Vẫn gắn khách được để tích điểm và theo dõi doanh số.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Thanh toán ở quầy POS, đồng bộ bill offline, đơn từ kênh bán, Cài đặt POS.
Lưu ý
Quầy chặn nút Thu tiền kèm thông báo khi chưa chọn khách, trước khi nhận tiền — áp cả cho bill bán offline, miễn là quầy đã tải cấu hình lúc có mạng. Các nơi khác (mobile, API, kênh bán) bị máy chủ chặn với lỗi “thiếu khách hàng”. Huỷ và hoàn tiền không bị ảnh hưởng.
Ví dụ
Cửa hàng chỉ bán cho hội viên bật công tắc để mọi hoá đơn gắn thẻ thành viên.
Bắt buộc lý do khi hoàn tiền
Phải nhập lý do khi hoàn tiền giao dịch POS.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.refund_requires_reason | Tắt | /pos/settings | — |
Cách hoạt động
Hoàn tiền bill POS (toàn phần hoặc một phần) phải kèm lý do; lý do để trống bị từ chối.
Khi BẬT
Hoàn tiền không lý do ⇒ bị từ chối, không hoàn tiền, không nhập lại kho.
Khi TẮT
Lý do không bắt buộc. Hộp thoại hoàn tiền vẫn có danh sách lý do và ô ghi chú.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Nút Hoàn tiền trên trang chi tiết giao dịch POS, Cài đặt POS.
Lưu ý
Chỉ kiểm chữ không rỗng. Lý do trống bị từ chối với lỗi “thiếu lý do”. Huỷ bill theo công tắc riêng.
Bắt buộc lý do khi hủy
Phải nhập lý do khi hủy giao dịch POS.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.void_requires_reason | Tắt | /pos/settings | — |
Cách hoạt động
Huỷ bill POS phải kèm lý do; lý do để trống bị từ chối.
Khi BẬT
Huỷ không lý do ⇒ bị từ chối, bill giữ trạng thái hoàn tất. Lý do được ghi vào ghi chú bill dạng “VOID: …”.
Khi TẮT
Lý do không bắt buộc. Hộp thoại huỷ vẫn có danh sách lý do và ô ghi chú.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Nút Huỷ trên trang chi tiết giao dịch POS, Cài đặt POS.
Lưu ý
Chỉ kiểm chữ không rỗng — gõ gì cũng qua. Lý do trống bị từ chối với lỗi “thiếu lý do”. Bill đã gắn hoá đơn điện tử bán lẻ không huỷ được dù bật hay tắt (dùng hoàn tiền). Hoàn tiền theo công tắc riêng.
Điểm thưởng thành viên
Tích điểm thưởng (1 điểm mỗi đơn vị tiền) cho khách POS khi mua; trừ lại khi huỷ/hoàn tiền.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.loyalty_points_enabled | Bật | /pos/settings | — |
Cách hoạt động
Khách POS trên bill được cộng 1 điểm cho mỗi đơn vị tiền tròn của tổng bill. Huỷ trừ điểm theo tổng bill bị huỷ, hoàn tiền trừ điểm theo tiền hàng được hoàn (không xuống dưới 0).
Khi BẬT
Điểm cộng vào số dư của khách POS khi thanh toán và bị trừ lại khi huỷ/hoàn tiền.
Khi TẮT
Bán cộng 0 điểm; huỷ/hoàn các bill đó không trừ điểm. Số dư hiện có giữ nguyên.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Thanh toán POS, huỷ, hoàn tiền, trang khách POS (số dư điểm), Cài đặt POS.
Lưu ý
Chưa có tiêu điểm khi thanh toán — điểm chỉ được tích và hiển thị. Mỗi bill ghi lại số điểm đã cộng: huỷ trừ đúng số đó, hoàn tiền trừ theo số tiền hoàn nhưng cộng dồn không vượt số bill đã cộng — bất kể công tắc lúc huỷ/hoàn đang bật hay tắt. Huỷ và hoàn tiền luôn giảm tổng chi tiêu của khách. Bill bán trước khi có dấu này theo công tắc lúc huỷ/hoàn.
Trừ kho khi bán
Quản lý tồn cho bán POS: hàng tồn kho bị trừ khỏi kho của quầy, ngay khi thanh toán hoặc sau khi thủ kho xác nhận. Tắt = POS không theo dõi tồn.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.inventory_sync_on_sale | Bật | /pos/settings | — |
Cách hoạt động
Quyết định POS có quản lý tồn hay không. BẬT: bill có hàng tồn kho được đóng dấu “đã xuất” (trừ kho của quầy hoặc cửa hàng ngay) hoặc “chờ xuất” (chờ thủ kho), tuỳ chế độ kho của cửa hàng và công tắc “Tự trừ kho khi xác nhận bán”. TẮT: bill đóng dấu “không theo dõi”, không có biến động kho.
Khi BẬT
Bán mặt hàng tồn kho cần mặt hàng đã gán vào kho của quầy, nếu không giao dịch bị từ chối. Giá vốn ghi từ sổ kho.
Khi TẮT
Không biến động kho, POS không ghi giá vốn, thủ kho xác nhận không áp dụng.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Thanh toán POS, huỷ, hoàn tiền, hàng đợi xuất kho của thủ kho, kho của quầy/cửa hàng, cảnh báo trong trợ lý thiết lập.
Lưu ý
Huỷ và hoàn tiền theo dấu trên bill gốc, không theo công tắc hiện tại — bill bán khi TẮT không bao giờ nhập lại kho, bill bán khi BẬT vẫn được đảo sau khi tắt. Bill chờ xuất vẫn nằm trong hàng đợi thủ kho và vẫn xác nhận được.
Ví dụ
Quán cà phê không quản lý kho tắt công tắc này; cửa hàng tiện lợi giữ bật.
Tự trừ kho khi xác nhận bán
Trừ kho ngay khi bill được xác nhận. Tắt (hoặc đặt cửa hàng “Thủ kho xác nhận”) khi cần thủ kho xác nhận từng lần xuất kho.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
pos.auto_issue_on_sale | Bật | /pos/settings | Trừ kho khi bán (pos.inventory_sync_on_sale) |
Cách hoạt động
Với cửa hàng để chế độ kho “Theo cấu hình chung”: BẬT trừ kho ngay khi bill được xác nhận, TẮT để bill ở “chờ xuất” cho tới khi thủ kho xác nhận. Cửa hàng đặt “Tự động” hoặc “Thủ kho xác nhận” thắng công tắc này.
Điều kiện để có hiệu lực
Cần bật “Trừ kho khi bán”.
Khi BẬT
Cửa hàng theo cấu hình chung trừ kho và ghi giá vốn lúc thanh toán.
Khi TẮT
Cửa hàng theo cấu hình chung tạo bill chờ xuất; kho trừ khi thủ kho xác nhận. Nếu bật sổ kho nghiêm ngặt, hàng được giữ chỗ để quầy khác không bán trùng.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Thanh toán POS, hàng đợi xuất kho của thủ kho, tổng kết đóng ca (số bill chờ xuất), cài đặt cửa hàng, Cài đặt POS.
Lưu ý
Đổi công tắc không đụng bill đã bán — bill chờ xuất vẫn chờ, bill đã xuất vẫn đã xuất. Huỷ bill chờ xuất sẽ nhả chỗ giữ; hoàn tiền thì nhập lại kho. Đóng ca khi còn bill chờ xuất vẫn được; tổng kết ca hiện số bill còn chờ.