> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/tiep-thi-lien-ket.md).

# Tiếp thị liên kết

## Danh sách cộng tác viên

<div data-full-width="false"><figure><img src="/files/TI7144RbBZMJpjqlwLIl" alt=""><figcaption><p>Vị trí hiện thị tiếp thị liên kết trên Mini App - Danh sách tiếp thị liên kết trên CMS</p></figcaption></figure></div>

Tại màn hình chính của module **Tiếp Thị Liên Kết**, admin sẽ thấy bảng danh sách cộng tác viên kèm theo:

| Cột                 | Mô tả                                                   |
| ------------------- | ------------------------------------------------------- |
| Cộng Tác Viên       | Tên hoặc số điện thoại người giới thiệu                 |
| Tổng hoa hồng       | Tổng tiền hoa hồng phát sinh                            |
| Chưa thanh toán     | Số tiền chưa thanh toán                                 |
| Đã thanh toán       | Số tiền đã thanh toán                                   |
| Số người giới thiệu | Số lượng người dùng được giới thiệu từ cộng tác viên đó |
| Thao tác            | Các nút xem/xử lý thêm                                  |

🔍 **Bộ lọc tìm kiếm:**

* Tìm theo tên hoặc số điện thoại
* Lọc theo **trạng thái thanh toán** (Tất cả / Đã thanh toán / Chưa thanh toán)
* Lọc theo khoảng **thời gian phát sinh giao dịch**

## Tính hoa hồng

<figure><img src="/files/e1rlltrp9Zd6uDhPXf2X" alt=""><figcaption><p>Tính hoa hồng theo khoảng thời gian</p></figcaption></figure>

**✅ Tính theo khoảng thời gian**

Bấm nút **“Tính hoa hồng theo khoảng thời gian”**, hệ thống sẽ mở popup nhập:

* **Ngày bắt đầu**
* **Ngày kết thúc**

Sau khi bấm ![](/files/co0GuCFeZPdOKK5VkonV) hoặc ![](/files/ItMOlmnIobhcMWfkcFVk), hệ thống sẽ tính toán lại hoa hồng cho tất cả cộng tác viên trong khoảng thời gian đó.

📌 Khi xử lý thành công, hệ thống sẽ hiển thị thông báo:

> ✅ *"Tính hoa hồng thành công!"*

## Xuất Excel báo cáo

<figure><img src="/files/wdtIdm6xRcCiY3jsfG4i" alt=""><figcaption><p>Xuất báo cáo cộng tác viên</p></figcaption></figure>

Bấm nút **“**![](/files/rjyU9cQQb2UyM2GLJtFz)**”**, popup sẽ xuất hiện cho phép chọn:

* Ngày bắt đầu – Ngày kết thúc

Sau đó bấm **“**![](/files/6On8gzqXt7ytqbVZ57Nx)**”** để tải về file báo cáo cộng tác viên dưới dạng Excel.

## Cài đặt tỷ lệ hoa hồng

<figure><img src="/files/e6wgmAQWT9xYHQO3XnDc" alt=""><figcaption><p>Cài đặt tỷ lệ hoa hồng</p></figcaption></figure>

Bấm **“**![](/files/SzUuhqnnbv6Dbbucqa4j)**”** để mở danh sách các mức hoa hồng theo cấp.

Trong bảng hiển thị:

| Cột           | Mô tả                                                                                   |
| ------------- | --------------------------------------------------------------------------------------- |
| Cấp           | Cấp giới thiệu (1 = trực tiếp, 2 = gián tiếp...)                                        |
| Tỷ lệ (%)     | Phần trăm hoa hồng                                                                      |
| Trạng thái    | Hoạt động / Không hoạt động                                                             |
| Ngày hiệu lực | Thời điểm cấu hình này có hiệu lực                                                      |
| Thao tác      | Sửa ![](/files/XiwhggKZkv9Ubeb1xx32) hoặc xóa ![](/files/0817ceoJ31LOYgzfCdlP) cấu hình |

### Thêm cấp hoa hồng:

<figure><img src="/files/cEJqJMvahKEAeaIAu4Wh" alt=""><figcaption><p>Thêm cấp hoa hồng</p></figcaption></figure>

* Bấm nút **“**![](/files/UgocQQ2vI13NaI5pQWlm)**”**
* Nhập:
  * **Cấp hoa hồng**
  * **Tỷ lệ (%)** *(ví dụ: 5 = 5%)*
  * **Trạng thái**
  * **Ngày hiệu lực**

Bấm ![](/files/a7jGeXppK2zPkbIhLpQn) để áp dụng.

**📝 Chỉnh sửa tỷ lệ:**

* Bấm nút ![](/files/aRWVhNEzfwCm5co42bv2) ở dòng tương ứng → sửa thông tin → bấm ![](/files/i0BNJTu56m694HOpdYwV).

### Xóa tỷ lệ

<figure><img src="/files/wD0xCbgMFdsbigvhD2T4" alt=""><figcaption></figcaption></figure>

* Bấm nút ![](/files/fncQwXn0hwsKoWUocgkg) → Hệ thống hiện popup xác nhận:

> “Bạn có chắc chắn muốn xóa tỷ lệ hoa hồng này?”\
> → Bấm ![](/files/F4QaTouFXoAAoTGqOLPu) để xóa.

### **Gợi ý sử dụng**

* Tỷ lệ hoa hồng phải được cấu hình trước khi có giao dịch giới thiệu.
* Có thể thay đổi tỷ lệ áp dụng theo thời gian mà không làm mất dữ liệu lịch sử.
* Dữ liệu hoa hồng có thể xuất ra báo cáo để phục vụ đối soát & thanh toán.