Quản lý đại lý

Mục đích

Quản lý đại lý là nghiệp vụ trung tâm của Loto40 — mỗi đại lý là một điểm bán vé lô tô. Đại lý trực thuộc một khu vực cấp 1, nhận vé từ tổng đại lý, bán cho khách, và hàng ngày nộp bảng kê khai số dự thưởng + số trả thưởng. Sai sót trong quản lý đại lý dẫn đến sai tiền thật.

Người dùng cần dùng: Nhân viên quản lý đại lý, quản trị viên Loto.

Điều kiện

Phân quyền:

Quyền 2.9 [Khu vực] Quản lý đại lý — tạo, sửa đại lý trong khu vực được phân quyền.
Quyền 2.7 [Tất cả] Quản lý khu vực — tạo/sửa đại lý trong mọi khu vực.
Quyền 1.1 [Tất cả] Loto Admin — cấu hình giờ chốt riêng cho đại lý.
Xem thêm Cấu hình nhóm phân quyền

Điều kiện khác:

Khu vực của đại lý phải đã tồn tại và là khu vực cấp 1 (khu vực cấp cuối, nơi gắn đại lý).

Các bước thực hiện

Trên máy tính 🖥️

Vào menu: Quản lý hành chính > Quản lý đại lý
Tạo mới: Nhấn nút Tạo.
- Mã đại lý: Mã định danh đại lý, bắt buộc, duy nhất toàn hệ thống. Phải là chuỗi số từ 4 đến 10 chữ số (vd: 0001, 1234567890).
- Trạng thái: Trạng thái hoạt động, bắt buộc, mặc định Đang hoạt động.
- Tên đại lý: Tên đại lý, bắt buộc. Tối đa 80 ký tự.
- Khu vực: Khu vực trực thuộc, bắt buộc. Chỉ hiển thị khu vực cấp 1 mà người dùng hiện tại có quyền quản lý đại lý.
- Nguồn nhập bảng kê: Nguồn nhập bảng kê, bắt buộc, mặc định Bình thường:
  - Bình thường — Nhập bình thường (mọi người được phân quyền đều có thể nhập).
  - Fax — Nhập qua fax.
  - Chỉ người được gán — Chỉ người được gán trực tiếp trong danh sách phân quyền của đại lý mới được nhập (người có quyền từ khu vực cha cũng bị chặn).
- Địa chỉ: Địa chỉ đại lý, tối đa 256 ký tự.
- Số điện thoại: Số điện thoại. Phải bắt đầu bằng 02 + 9 số hoặc 03/05/07/08/09 + 8 số.
- Dùng giờ chốt riêng: Bật nếu muốn đặt giờ chốt riêng cho đại lý này (chỉ Quản trị viên Loto được cấu hình).
- Giờ chốt riêng: Giờ chốt riêng, chỉ hiện khi bật giờ chốt riêng.
Tab Thông tin bổ sung:
- Hạn mức doanh thu theo mã vé: Thiết lập hạn mức doanh thu tối đa cho từng mã vé của mỗi loại vé. Đây là bảng con, mỗi dòng gồm:
  - Loại vé: Chọn loại vé (chỉ loại đang kích hoạt).
  - Hạn mức: Hạn mức doanh thu (VNĐ), bắt buộc.
  - Không được thêm trùng loại vé cho cùng một đại lý.
- Ngày kinh doanh: Khai báo số ngày kinh doanh trong tháng. Mỗi dòng gồm:
  - Năm / Tháng: Năm và tháng, mặc định là tháng/năm hiện tại. Không được khai trùng tháng cho cùng một đại lý.
  - Số ngày kinh doanh: Số ngày kinh doanh, từ 1 đến 30.
  - Chỉ được khai cho tháng trước, tháng hiện tại, hoặc tương lai (không được khai quá 1 tháng trong quá khứ).
Tab Phân quyền: Phân quyền người dùng được nhập/xem bảng kê cho riêng đại lý này. Quyền được gán ở đây ghi đè quyền kế thừa từ khu vực.
Tab Ảnh: Xem ảnh chụp bảng kê giấy. Đây là bằng chứng gốc, hiển thị dạng lưới kèm ảnh thu nhỏ.
Chỉnh sửa:
- Mở đại lý, sửa các trường được phép.
- Khi đổi khu vực của đại lý: hệ thống tự động cập nhật lại báo cáo kinh doanh và các bảng kê liên quan.
- Không thể sửa giờ chốt nếu không có quyền Quản trị viên Loto.
Vô hiệu hóa:
- Chọn đại lý trong danh sách → Nhấn nút Hành động > Vô hiệu hóa.
- Đại lý bị vô hiệu hóa sẽ không hiển thị trong các thao tác nhập bảng kê, nhưng dữ liệu lịch sử vẫn được giữ nguyên.
- Không có nút xóa để đảm bảo toàn vẹn dữ liệu.

Trên điện thoại 📱

Ứng dụng mobile hỗ trợ đại lý:

Nhập bảng kê: Đại lý dùng app để nộp số dự thưởng và số trả thưởng hàng ngày.
Xem lịch sử bảng kê: Tra cứu các bảng kê đã nộp.

Quản lý đại lý (tạo/sửa/vô hiệu hóa) chỉ thực hiện trên máy tính.

Lưu ý & ràng buộc

⚠️ Giờ chốt bảng kê: Đại lý có thể có giờ chốt riêng. Nếu không bật, giờ chốt được kế thừa từ khu vực cha. Nếu toàn bộ cây khu vực đều không bật, dùng giá trị mặc định toàn cục. Qua giờ chốt, không ai nhập được bảng kê — đây là ràng buộc chống gian lận, không phải tính năng tiện ích.

⚠️ Nguồn nhập = “Chỉ người được gán”: Khi đại lý chọn chế độ này, chỉ người dùng có tên trong danh sách phân quyền của chính đại lý đó mới được nhập bảng kê. Người có quyền từ khu vực cha cũng bị chặn. Đây là cơ chế siết chặt chống nhập hộ gian lận.

Mối quan hệ phân cấp: Khu vực (cấp 1) → Đại lý. Mỗi đại lý phải thuộc một khu vực cấp 1. Đại lý là điểm cuối trong chuỗi cung ứng vé.
Hạn mức doanh thu: Nếu đại lý có hạn mức, bảng kê vượt hạn mức sẽ bị từ chối. Mỗi loại vé chỉ được khai một hạn mức.
Ngày kinh doanh: Dùng để tính các chỉ số báo cáo theo ngày thực tế đại lý hoạt động.
Mã đại lý phải là số: Mã đại lý bắt buộc là chuỗi chữ số 4–10 ký tự, không chấp nhận chữ cái.
Kiểm tra số điện thoại: Định dạng phải đúng chuẩn Việt Nam (đầu số cố định 02x hoặc di động 03/05/07/08/09).
Khi đổi khu vực của đại lý, hệ thống sẽ tự động tính lại tổng hợp kinh doanh và cập nhật các bảng kê liên quan.

Lỗi thường gặp

Cấu hình liên quan

Khu vực cấp 1: Đại lý phải thuộc một khu vực cấp 1. Khu vực quyết định giờ chốt kế thừa và phân quyền.
Loại vé: Quyết định danh sách loại vé có thể chọn trong hạn mức doanh thu.
Giờ chốt mặc định toàn hệ thống: Giờ chốt mặc định khi cả đại lý lẫn khu vực cha đều không đặt giờ riêng.
Quyền nhập/xem bảng kê: Quyền nhập/xem bảng kê — danh sách người dùng được phân quyền.