Appearance
Module Đại lý (Dealer)
Hướng dẫn toàn diện cho vai trò Đại lý (DEALER) — từ dashboard kinh doanh, nhận hàng, bán lẻ POS đến quản lý khách hàng.
Truy cập
- Vai trò: DEALER
- Dashboard:
/dealer/dashboard(tự động sau đăng nhập) - Menu: Dashboard | Nhận hàng | Tồn kho | Bảng giá | Bán hàng | Lịch sử | Khách hàng
1. Dashboard Đại lý
Đường dẫn: /dealer/dashboard
Thẻ thống kê
| Thẻ | Icon | Mô tả |
|---|---|---|
| Doanh thu hôm nay | 💰 | Tổng tiền bán hàng trong ngày (VNĐ) |
| Doanh thu tháng | 📈 | Tổng doanh thu tháng hiện tại |
| Tổng tồn kho | 📦 | Số sản phẩm đang có trong kho. ⚠️ Hiển thị cảnh báo nếu có mã sắp hết |
| Đơn chờ nhận | 🚚 | Số phiếu giao hàng đang chờ đại lý xác nhận. Nhấn vào → sang trang Nhận hàng |
Biểu đồ doanh thu
- Biểu đồ cột hiển thị doanh thu theo ngày
- Chuyển đổi: 7 Ngày / 30 Ngày
- Hover vào cột → Hiện tooltip: Ngày + Doanh thu
Top Sản phẩm Bán chạy
| Cột | Mô tả |
|---|---|
| STT | Thứ hạng |
| Sản phẩm | Tên sản phẩm |
| Đã bán | Tổng số lượng đã bán (badge xanh) |
| Doanh thu | Tổng doanh thu từ sản phẩm |
Hoạt động Gần đây
Timeline hiển thị các sự kiện gần nhất:
- 🟢 SALE — Bán hàng thành công + số tiền
- 🔵 Khác — Nhận hàng, cập nhật giá...
2. Nhận hàng từ Công ty / NSX
Đường dẫn: /dealer/receive
Danh sách phiếu chờ nhận
| Cột | Mô tả |
|---|---|
| Mã phiếu | Mã tracking (in xanh đậm, font mono) |
| Kho xuất | Tên kho xuất phát |
| Ngày giao dự kiến | Ngày hẹn giao |
| Trạng thái | Badge màu theo trạng thái (xem bên dưới) |
| Thao tác | Nút "Xác nhận nhận" hoặc badge "Đã nhận" |
Trạng thái phiếu
| Trạng thái | Hiển thị | Mô tả |
|---|---|---|
CREATED | Mới tạo | Phiếu vừa được tạo |
SCANNING | Đang quét | Quản kho đang quét mã sản phẩm |
WAITING_DRIVER | Chờ tài xế nhận | Chờ tài xế xác nhận nhận hàng |
IN_TRANSIT | Đang vận chuyển | Hàng trên đường đến |
PENDING_DEALER_CONFIRM | Chờ xác nhận nhận | Đại lý cần xác nhận |
DELIVERED | Tài xế đã giao | Tài xế đã giao, chờ đại lý xác nhận |
AT_DEALER | Đã nhận vào kho | ✅ Hoàn thành |
Xem chi tiết sản phẩm
Nhấn mũi tên mở rộng ở đầu dòng → Hiện bảng chi tiết:
| Cột | Mô tả |
|---|---|
| STT | Số thứ tự |
| Sản phẩm | Tên sản phẩm hoặc mã serial |
| Số lượng | Số lượng cần nhận |
| Trạng thái | Trạng thái từng item |
Quy trình xác nhận nhận hàng
- Kiểm tra hàng hóa thực tế so với danh sách
- Nhấn nút "✓ Xác nhận nhận"
- Popup xác nhận:
"Xác nhận bạn đã nhận đủ danh sách mã Serial cho phiếu [MÃ]? Hệ thống sẽ tự động nhập hàng vào kho của đại lý."
- Nhấn "Đồng ý nhận"
Hệ thống tự động:
- ✅ Nhập toàn bộ sản phẩm vào kho đại lý
- ✅ Cập nhật tồn kho
- ✅ Trạng thái chuyển thành
AT_DEALER - ✅ Ghi log trong chuỗi xác nhận 3 bên (Handshake)
⚠️ Quan trọng: Đây là bước xác nhận 3 bên cuối cùng trong luồng vận chuyển. Sau khi đại lý xác nhận → dữ liệu truy xuất nguồn gốc được hoàn thiện. Xem chi tiết tại Vận chuyển & Xác nhận 3 bên.
3. Tồn kho
Đường dẫn: /dealer/stock
Xem tồn kho hiện tại theo sản phẩm:
| Cột | Mô tả |
|---|---|
| Sản phẩm | Tên sản phẩm |
| Tồn | Số lượng hiện có |
| Đã bán | Số lượng đã bán |
| Giá bán | Giá bán lẻ hiện tại |
4. Bảng giá bán lẻ
Đường dẫn: /dealer/pricing
Cấu hình giá bán cho từng sản phẩm tại đại lý:
| Cột | Mô tả |
|---|---|
| Giá gốc | Giá từ nhà cung cấp / công ty |
| Giá bán lẻ | Giá do đại lý tự đặt |
| Giá khuyến mãi | Giá ưu đãi (nếu có) |
💡 Giá bán lẻ sẽ tự động hiển thị khi quét mã sản phẩm trên POS.
5. Bán hàng POS
Đường dẫn: /dealer/sale
Giao diện POS (Point of Sale) chia 2 vùng:
Vùng trái: Quét mã & Giỏ hàng
Bước 1: Quét mã sản phẩm
- Nhập hoặc quét mã S/N (Serial Number) vào ô tìm kiếm
- Nhấn Enter hoặc nút "Thêm"
- Sản phẩm tự động thêm vào giỏ với giá từ Bảng giá
Bảng giỏ hàng:
| Cột | Mô tả |
|---|---|
| STT | Số thứ tự |
| Mã S/N | Serial Number (font mono) |
| Tên sản phẩm | Tên sản phẩm |
| SL | Số lượng (mặc định: 1) |
| Đơn giá | Có thể chỉnh sửa trực tiếp |
| Thành tiền | Đơn giá × Số lượng |
| Xóa | 🗑 Xóa khỏi giỏ |
⚠️ Hệ thống kiểm tra trùng lặp — cùng 1 mã S/N không thể thêm 2 lần.
Vùng phải: Khách hàng & Thanh toán
Chọn loại khách:
| Loại | Mô tả |
|---|---|
| Khách lẻ | Bán vãng lai, không lưu lịch sử cá nhân |
| Khách quen | Tìm hoặc tạo mới khách hàng, lưu lịch sử mua |
Khách quen — Tìm kiếm:
- Gõ tên hoặc SĐT vào ô tìm kiếm
- Chọn từ danh sách gợi ý (autocomplete)
- Thông tin khách hiển thị: Tên, SĐT, Địa chỉ
Khách quen — Tạo mới:
- Nhấn "+ Thêm khách hàng mới"
- Nhập: Tên (), SĐT (), Địa chỉ
- Nhấn "Lưu và Chọn" → Khách tự động được chọn
Thanh toán:
| Mục | Mô tả |
|---|---|
| Số lượng | Tổng số sản phẩm trong giỏ |
| Tổng tiền | Tổng thành tiền (in đậm, xanh, cỡ lớn) |
| Phương thức | Tiền mặt 💵 / Chuyển khoản 💳 |
Nhấn nút "THANH TOÁN" → Hoàn thành
Hệ thống tự động:
- ✅ Tạo hóa đơn bán hàng
- ✅ Trừ tồn kho
- ✅ Chuyển trạng thái tem: Active → Sold
- ✅ Ghi nhận doanh thu vào Dashboard
- ✅ Lưu lịch sử mua nếu là khách quen
💡 Nếu giá sản phẩm = 0đ, hệ thống sẽ cảnh báo xác nhận trước khi cho phép bán.
6. Lịch sử hóa đơn
Đường dẫn: /dealer/sales
Xem lại tất cả hóa đơn đã tạo:
| Tính năng | Mô tả |
|---|---|
| Lọc theo ngày | Chọn khoảng thời gian |
| Lọc theo khách | Tìm theo tên/SĐT |
| Xem chi tiết | Danh sách sản phẩm trong hóa đơn |
| In hóa đơn | Mở trang in /dealer/receipt/:id |
| Thống kê | Tổng doanh thu theo bộ lọc |
7. Quản lý Khách hàng
Đường dẫn: /dealer/customers
Quản lý thông tin khách hàng đã đăng ký:
| Cột | Mô tả |
|---|---|
| Tên | Tên khách hàng |
| SĐT | Số điện thoại |
| Địa chỉ | Địa chỉ (nếu có) |
| Tổng mua | Tổng giá trị đã mua |
| Lần mua cuối | Ngày mua gần nhất |
Thêm khách hàng
Có 2 cách:
- Từ trang Khách hàng: Nhấn "Thêm mới" → Nhập thông tin
- Từ POS: Khi bán hàng → Chọn "Khách quen" → "Thêm khách hàng mới" (nhanh hơn)
8. In hóa đơn
Đường dẫn: /dealer/receipt/:id
Sau mỗi giao dịch, đại lý có thể in hóa đơn:
- Nhấn "In hóa đơn" từ lịch sử
- Trang in hiển thị: Thông tin đại lý, Khách hàng, Danh sách sản phẩm, Tổng tiền
- Hỗ trợ in trên máy in nhiệt (thermal printer)
Tóm tắt luồng hoạt động Đại lý
Đại lý đăng nhập
│
├── 📊 Dashboard → Xem doanh thu, tồn kho, đơn chờ
│
├── 📥 Nhận hàng → Xác nhận phiếu giao → Hàng vào kho
│
├── 💰 Cấu hình giá → Đặt giá bán lẻ cho từng SP
│
├── 🛒 Bán hàng POS → Quét mã → Chọn khách → Thanh toán
│
├── 📋 Lịch sử → Xem lại, in hóa đơn
│
└── 👥 Khách hàng → Quản lý danh sách khách quen