🔲 Ma trận biến thể sản phẩm
Ma trận biến thể (Sale Matrix) cho phép bạn nhập nhanh nhiều biến thể của cùng một sản phẩm — ví dụ áo theo Kích thước × Màu sắc — qua một lưới (grid) ngay trên báo giá/đơn bán, thay vì thêm từng dòng một. Bạn chỉ cần điền số lượng vào từng ô của lưới, hệ thống sẽ tự tạo các dòng biến thể tương ứng.
📷 Cần chèn ảnh:
/img/modules/sale/product-matrix/01.png— Lưới chọn biến thể (Choose Product Variants) hiển thị số lượng theo Kích thước × Màu.
🎯 Khi nào dùng ma trận biến thể
Tính năng này chỉ áp dụng cho sản phẩm có thuộc tính & biến thể (configurable attributes), chẳng hạn áo có thuộc tính Kích thước (S, M, L…) và Màu sắc (Đỏ, Xanh…). Thay vì thêm 9 dòng riêng cho 9 tổ hợp Size × Màu, bạn mở một lưới duy nhất và điền số lượng cho từng ô.
Với sản phẩm không có thuộc tính cấu hình (chỉ một biến thể), lưới không xuất hiện và bạn thêm sản phẩm như bình thường.
💡 Nếu sản phẩm chưa có thuộc tính/biến thể, hãy thiết lập trước trên phiếu sản phẩm. Xem trang Sản phẩm phần thuộc tính & biến thể.
⚙️ Bật chế độ nhập lưới cho sản phẩm
Mỗi sản phẩm có thuộc tính cấu hình sẽ chọn cách thêm vào đơn (Add product mode). Bạn cần đặt chế độ này thành Nhập lưới đơn hàng (Order Grid Entry) để mở lưới:
- Mở phiếu sản phẩm tại Bán hàng → Sản phẩm → Sản phẩm.
- Chuyển sang tab Biến thể (Variants).
- Tại nhóm Lựa chọn biến thể bán hàng (Sales Variant Selection), chọn một trong hai chế độ thêm sản phẩm (trường Thêm chế độ sản phẩm / Add product mode, hiển thị dưới dạng hai nút chọn):
- Cấu hình sản phẩm (Product Configurator) — chọn từng giá trị thuộc tính để thêm đúng một biến thể vào đơn.
- Nhập lưới đơn hàng (Order Grid Entry) — thêm nhiều biến thể cùng lúc từ lưới giá trị thuộc tính.
- Chọn Nhập lưới đơn hàng, sau đó nhấn Lưu.
📷 Cần chèn ảnh:
/img/modules/sale/product-matrix/02.png— Nhóm "Lựa chọn biến thể bán hàng" với hai lựa chọn Cấu hình sản phẩm / Nhập lưới đơn hàng trên tab Biến thể.
💡 Nhóm Lựa chọn biến thể bán hàng chỉ hiện khi sản phẩm có thuộc tính cấu hình. Mặc định mỗi sản phẩm dùng chế độ Cấu hình sản phẩm.
🧮 Nhập biến thể qua lưới trên báo giá / đơn bán
Sau khi đã đặt sản phẩm sang chế độ Nhập lưới đơn hàng, khi thêm sản phẩm đó vào báo giá hoặc đơn bán, hệ thống sẽ mở lưới chọn biến thể:
- Vào Bán hàng → Đơn hàng → Báo giá và mở (hoặc tạo) một báo giá.
- Tại bảng Dòng đơn hàng (Order Lines), thêm một dòng và chọn sản phẩm có bật chế độ nhập lưới.
- Hệ thống mở hộp thoại Chọn biến thể sản phẩm (Choose Product Variants) — đây chính là lưới: các hàng và cột là các giá trị thuộc tính (ví dụ hàng = Màu, cột = Kích thước).
- Điền số lượng vào từng ô tương ứng với biến thể bạn muốn bán. Ô để trống/0 nghĩa là không thêm biến thể đó.
- Nhấn Xác nhận (Confirm) để áp dụng — hệ thống tự tạo các dòng đơn hàng cho từng biến thể có số lượng. Nhấn Huỷ bỏ (Discard) để đóng lưới mà không thêm gì.
📷 Cần chèn ảnh:
/img/modules/sale/product-matrix/03.png— Hộp thoại Chọn biến thể sản phẩm với các ô nhập số lượng và nút Xác nhận / Huỷ bỏ.
Mỗi ô có số lượng lớn hơn 0 sẽ trở thành một dòng biến thể riêng trên báo giá. Những tổ hợp thuộc tính không khả dụng sẽ hiển thị Không khả dụng (Not available) và không nhập được.
💡 Lưới đã ghi nhớ số lượng hiện có trên đơn: khi mở lại lưới của một sản phẩm đã thêm, các ô sẽ hiển thị sẵn số lượng đang có trên các dòng để bạn chỉnh sửa.
✏️ Chỉnh sửa lại số lượng qua lưới
Bạn có thể mở lại lưới để thay đổi số lượng các biến thể đã thêm:
- Trên báo giá, mở lại lưới của sản phẩm cấu hình bằng lưới (qua thao tác chỉnh sửa dòng sản phẩm).
- Sửa số lượng trong các ô — tăng, giảm hoặc đặt về 0.
- Nhấn Xác nhận để áp dụng thay đổi.
⚠️ Khi bạn đặt một ô về 0, dòng biến thể tương ứng chỉ bị xoá khỏi đơn nếu đơn đang ở trạng thái Báo giá (draft) hoặc Báo giá đã gửi (sent). Với đơn đã ở trạng thái khác, số lượng dòng đó được đặt về 0 thay vì xoá.
⚠️ Nếu cùng một biến thể đang nằm trên nhiều dòng của đơn, hệ thống không cho đổi số lượng qua lưới và báo lỗi "Bạn không thể thay đổi số lượng của một sản phẩm hiển thị trong nhiều dòng bán hàng." (You cannot change the quantity of a product present in multiple sale lines). Khi đó hãy chỉnh trực tiếp trên các dòng đơn hàng.
🖨️ In lưới biến thể trên báo giá
Đơn bán có trường In lưới biến thể (Print Variant Grids). Khi bật, bản in/PDF của báo giá sẽ hiển thị thêm bảng lưới các biến thể (chỉ với sản phẩm dùng chế độ nhập lưới và có nhiều hơn một dòng biến thể), giúp người nhận dễ hình dung số lượng theo từng tổ hợp thuộc tính.
💡 Trường In lưới biến thể mặc định được bật. Đây là tuỳ chọn kỹ thuật và chỉ hiển thị trên biểu mẫu đơn bán ở chế độ kỹ thuật (developer); thông thường bạn không cần thay đổi.
📋 Bảng trường thông tin
| Trường | Ý nghĩa |
|---|---|
| Thêm chế độ sản phẩm (Add product mode) | Cách thêm sản phẩm có thuộc tính vào đơn: Cấu hình sản phẩm (chọn từng biến thể) hoặc Nhập lưới đơn hàng (nhập nhiều biến thể qua lưới). |
| In lưới biến thể (Print Variant Grids) | Bật để in bảng lưới biến thể trên báo giá/đơn bán (chỉ với sản phẩm dùng chế độ nhập lưới). Mặc định bật. |