Hướng dẫn dành cho Quản lý (Manager / Admin)#

Phiên bản: 2.0 | Cập nhật: 22/03/2026

Tài liệu này là hướng dẫn nội bộ dành riêng cho tài khoản được cấp quyền Quản lý (Manager) hoặc Quản trị viên (Admin) trên Marketplace Invoice. Các thao tác dưới đây giúp bạn điều phối hệ thống, quản lý người dùng và hỗ trợ khách hàng hiệu quả.

---

Mục lục#

1. Tổng quan & Vai trò
2. Bảng điều khiển (Dashboard)
3. Quản lý Người dùng
4. Quản lý Đơn hàng
5. Xử lý Nạp điểm
6. Marketplace — Quản lý đơn hàng dịch vụ (Manager)
7. Marketplace — Quản trị sản phẩm & đơn hàng (Admin)
8. Quản lý Dịch vụ & Nhà cung cấp (Admin)
9. Giao dịch & Billing (Admin)
10. Cấu hình Hệ thống & Chiết khấu
11. Bảo mật, Audit Log & Xử lý Sự cố

---

1. Tổng quan & Vai trò#

1.1. Hai cấp quyền trên Nền tảng#

1.2. Bảng so sánh quyền chi tiết#

⚠️ Quy tắc quan trọng: Mọi thao tác điều chỉnh số dư, thay đổi vai trò đều bắt buộc phải có ghi chú lý do. Hệ thống ghi log: ai làm, làm gì, khi nào.

1.3. Chuyển đổi giữa các Panel#

Người dùng có cả quyền Manager và Admin có thể chuyển đổi giữa các Panel qua menu:

---

2. Bảng điều khiển (Dashboard)#

2.1. Manager Dashboard (/manager)#

Sau khi đăng nhập vào /manager, Dashboard hiển thị:

2.2. Admin Dashboard (/admin)#

Admin Dashboard bao gồm toàn bộ thông tin của Manager, cộng thêm:

2.3. Thanh menu Manager#

2.4. Thanh menu Admin#

---

3. Quản lý Người dùng#

3.1. Danh sách Người dùng#

Manager: Truy cập /manager/users Admin: Truy cập /admin/users

Hiển thị toàn bộ tài khoản đã đăng ký trên Nền tảng:

Tính năng lọc & tìm kiếm:

• Lọc theo trạng thái: Hoạt động, Bị khoá.
• Lọc theo vai trò: User, Manager, Admin.
• Lọc theo khoảng thời gian đăng ký.
• Tìm kiếm nhanh theo email hoặc tên hiển thị.

3.2. Xem chi tiết người dùng#

Nhấn vào dòng người dùng để xem chi tiết:

3.3. Các thao tác quản lý#

⚠️ Điều chỉnh số dư (Admin): Mọi thao tác cộng/trừ điểm đều bắt buộc phải có ghi chú lý do. Hệ thống ghi nhận: người thực hiện, thời gian, số điểm thay đổi, lý do. Không điều chỉnh khi chưa có lý do chính đáng.

3.4. Các trường hợp cần khoá tài khoản#

Manager nên khoá tài khoản khi phát hiện:

• Tài khoản có hoạt động bất thường (nhiều đơn hàng thất bại liên tiếp, đăng nhập từ nhiều IP khác nhau).
• Người dùng báo cáo tài khoản bị chiếm quyền.
• Phát hiện vi phạm Điều khoản sử dụng (tạo nhiều tài khoản, lạm dụng chiết khấu).

---

4. Quản lý Đơn hàng#

4.1. Xem danh sách đơn hàng#

Manager: Truy cập /manager/marketplace/orders (đơn hàng dịch vụ) Admin: Truy cập /admin/orders (tất cả đơn)

Hiển thị toàn bộ đơn hàng dịch vụ trên Nền tảng:

Tính năng lọc & tìm kiếm:

• Lọc theo trạng thái đơn hàng.
• Lọc theo dịch vụ hoặc nhà cung cấp.
• Lọc theo khoảng thời gian.
• Tìm kiếm nhanh theo mã đơn, email người dùng, mã khách hàng.

4.2. Trạng thái đơn hàng & hành động xử lý#

4.3. Xử lý đơn hàng thất bại (FAILED)#

Nguyên nhân phổ biến:

• Mã khách hàng không hợp lệ hoặc không tồn tại trong hệ thống nhà cung cấp.
• Nhà cung cấp đang bảo trì hoặc lỗi kết nối.
• Lỗi nội bộ hệ thống (hiếm gặp).

Quy trình xử lý:

1. Kiểm tra nguyên nhân lỗi trong chi tiết đơn (thông báo lỗi từ nhà cung cấp hoặc hệ thống).
2. Nếu lỗi do nhà cung cấp: chờ nhà cung cấp khôi phục → tạo lại đơn.
3. Nếu lỗi do mã khách hàng: thông báo cho người dùng kiểm tra lại mã.
4. Nếu đơn đã bị trừ điểm nhưng FAILED → hoàn điểm cho người dùng.

4.4. Xuất báo cáo#

Admin có thể xuất danh sách đơn hàng ra file:

• Định dạng: CSV hoặc Excel.
• Lọc theo khoảng thời gian, dịch vụ, nhà cung cấp, trạng thái trước khi xuất.

---

5. Xử lý Nạp điểm#

5.1. Khi nào cần xử lý thủ công?#

Hệ thống nạp điểm qua VietQR hoạt động tự động trong hầu hết trường hợp. Xử lý thủ công chỉ cần khi:

5.2. Quy trình xử lý thủ công#

1. Truy cập Nạp tiền → Chờ xử lý (trên Manager/Admin Panel).
2. Xem danh sách các giao dịch đang chờ.
3. Kiểm tra bằng chứng chuyển khoản của người dùng:
   • Ảnh chụp biên lai / sao kê ngân hàng
   • Mã giao dịch (transaction ID) ngân hàng
4. Đối chiếu với sao kê tài khoản ngân hàng của hệ thống.
5. Nếu hợp lệ:
   • Nhấn "Duyệt" → cộng điểm vào tài khoản người dùng.
   • Ghi chú: số tiền, người dùng, lý do xử lý thủ công.
6. Nếu không hợp lệ:
   • Nhấn "Từ chối" kèm lý do cụ thể.
   • Thông báo cho người dùng qua chat trên Nền tảng.

⚠️ Lưu ý quan trọng:

• Mọi thao tác duyệt/từ chối đều được ghi log để kiểm toán.
• Không duyệt giao dịch khi không có bằng chứng chuyển khoản rõ ràng.
• Nếu nghi ngờ gian lận → khoá tài khoản và báo cáo Admin.

5.3. Theo dõi giao dịch (Admin)#

Admin có thể xem toàn bộ lịch sử giao dịch nạp điểm tại /admin/billing/transactions:

---

6. Marketplace — Quản lý đơn hàng dịch vụ (Manager)#

6.1. Giới thiệu luồng Marketplace#

Marketplace đơn hàng dịch vụ hoạt động theo mô hình:

Người dùng A (hoàn thành đơn dịch vụ)
    → Đơn hàng dịch vụ được đăng lên Marketplace
    → Người dùng B mua đơn hàng dịch vụ
    → Người dùng B nhận thông tin chi tiết đơn

Manager có quyền đăng đơn hàng dịch vụ và xem đơn đã đăng.

6.2. Đăng đơn hàng dịch vụ#

Đường dẫn: /manager/marketplace/publish

1. Chọn đơn dịch vụ đã hoàn thành (COMPLETED) để đăng bán.
2. Nhập giá bán cho đơn hàng dịch vụ.
3. Nhấn "Đăng đơn" → đơn xuất hiện trên Marketplace.
4. Khi có người mua, bạn nhận thông báo.

Quy tắc:

• Chỉ đơn ở trạng thái COMPLETED mới được đăng.
• Mỗi đơn chỉ đăng được một lần.
• Đơn đã đăng không thể huỷ.

6.3. Xem đơn đã đăng#

Đường dẫn: /manager/marketplace/orders

Hiển thị danh sách đơn hàng dịch vụ đã đăng bán:

6.4. Xem người hoàn thành (Người mua)#

Đường dẫn: /manager/marketplace/user

Xem danh sách người dùng đã hoàn thành mua đơn hàng dịch vụ trên Marketplace:

---

7. Marketplace — Quản trị sản phẩm & đơn hàng (Admin)#

7.1. Quản lý sản phẩm số#

Đường dẫn: /admin/marketplace

Admin quản lý toàn bộ sản phẩm số trên Sàn Marketplace:

7.2. Cấu hình giá sản phẩm#

7.3. Quản lý đơn hàng Marketplace#

Đường dẫn: /admin/marketplace/orders

Xem toàn bộ đơn hàng sản phẩm số và đơn hàng dịch vụ:

Lọc: theo trạng thái, loại sản phẩm, khoảng thời gian.

---

8. Quản lý Dịch vụ & Nhà cung cấp (Admin)#

8.1. Quản lý Nhà cung cấp#

Đường dẫn: /admin/providers

Admin có quyền quản lý toàn bộ nhà cung cấp dịch vụ:

8.2. Trạng thái kết nối nhà cung cấp#

8.3. Quản lý Dịch vụ#

Đường dẫn: /admin/services

Mỗi nhà cung cấp có thể cung cấp nhiều dịch vụ. Admin quản lý:

---

9. Giao dịch & Billing (Admin)#

9.1. Trang Giao dịch#

Đường dẫn: /admin/billing/transactions

Xem toàn bộ giao dịch tài chính trên Nền tảng:

9.2. Đối soát tài chính#

---

10. Cấu hình Hệ thống & Chiết khấu#

10.1. Quy tắc Chiết khấu#

Đường dẫn: /admin/settings (phần Chiết khấu)

Hệ thống chiết khấu áp dụng theo quy tắc ưu tiên:

Chiết khấu riêng (theo người dùng)  >
Chiết khấu nhóm (theo nhóm người dùng)  >
Chiết khấu mặc định (theo nhà cung cấp)

Lưu ý: Thay đổi chiết khấu có hiệu lực ngay lập tức cho các đơn hàng mới. Đơn hàng đã hoàn thành không bị ảnh hưởng.

10.2. Cài đặt hệ thống (Admin)#

10.3. Chiết khấu hàng loạt (Bulk Discount)#

1. Vào Cài đặt chiết khấu → Chiết khấu hàng loạt.
2. Chọn nhóm dịch vụ hoặc nhóm người dùng cần áp dụng.
3. Thiết lập tỷ lệ chiết khấu mới.
4. Nhấn "Áp dụng".
5. Chiết khấu có hiệu lực ngay lập tức cho các đơn hàng mới.

---

11. Bảo mật, Audit Log & Xử lý Sự cố#

11.1. Nhật ký Hoạt động (Audit Log)#

Hệ thống ghi nhận mọi thao tác của Manager và Admin:

Dữ liệu log được lưu trữ tối thiểu 12 tháng.

11.2. Bảo mật tài khoản quản lý#

11.3. SOP — Xử lý Sự cố Thường gặp#

---

Sự cố 1: Người dùng không nhận được điểm nạp

Bước 1:  Kiểm tra mục "Nạp tiền → Chờ xử lý"
Bước 2:  Yêu cầu người dùng gửi ảnh chụp biên lai chuyển khoản
Bước 3:  Đối chiếu với sao kê ngân hàng hệ thống
Bước 4:  Nếu hợp lệ → nhấn "Duyệt" → cộng điểm
         Nếu không → nhấn "Từ chối" kèm lý do + thông báo người dùng

---

Sự cố 2: Đơn hàng bị treo ở trạng thái "Đang xử lý"

Bước 1:  Kiểm tra trạng thái nhà cung cấp trong /admin/providers
Bước 2:  Nếu nhà cung cấp OFFLINE → thông báo người dùng, chờ khôi phục
Bước 3:  Nếu nhà cung cấp ONLINE → kiểm tra log hệ thống tìm lỗi
Bước 4:  Nếu đơn FAILED sau đó → hoàn điểm cho người dùng
Bước 5:  Nếu lỗi lặp → báo cáo đội phát triển

---

Sự cố 3: Người dùng báo cáo sai số tiền chiết khấu

Bước 1:  Xem lịch sử đơn hàng của người dùng trong /admin/users/[userId]
Bước 2:  Kiểm tra quy tắc chiết khấu đang áp dụng trong /admin/settings
Bước 3:  Xác minh chiết khấu đã áp dụng đúng quy tắc chưa
Bước 4:  Nếu có sai sót:
         - Thông báo cho người dùng
         - Điều chỉnh số dư bù đắp (Admin)
         - Ghi log chi tiết

---

Sự cố 4: Phát hiện tài khoản gian lận

Bước 1:  Khoá tài khoản ngay (Manager / Admin)
Bước 2:  Kiểm tra lịch sử đơn hàng, giao dịch của tài khoản
Bước 3:  Kiểm tra địa chỉ IP, thiết bị đăng nhập
Bước 4:  Nếu xác nhận gian lận:
         - Giữ tài khoản khoá
         - Không hoàn điểm
         - Báo cáo Admin cấp cao hơn
         - Chuyển hồ sơ cho cơ quan chức năng nếu cần

---

11.4. Liên hệ hỗ trợ kỹ thuật#

Tài liệu tham khảo:

• Hướng dẫn Người dùng
• Điều khoản Dịch vụ
• Chính sách Bảo mật

---

© 2026 Marketplace Invoice. Bảo lưu mọi quyền. Chỉ sử dụng cho mục đích nội bộ.