> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/tiep-thi-lien-ket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.