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

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

<div data-full-width="false"><figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FntcgpZcXwTuxCwwwIZzF%2F13.png?alt=media&#x26;token=332701d1-0c42-4e55-8e56-42e7dcc7bd37" 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="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FGHLBiodOgIIQM4cOmlwS%2F14.png?alt=media&#x26;token=b3412e7a-3566-40af-9613-fe5f95bf42f0" 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FgqShF3HB81I5Gwy5jtPV%2FScreenshot%202025-07-09%20at%2018.23.43.png?alt=media\&token=149143ff-22df-4c86-8c86-0a7e91bc7b03) hoặc ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FmzOBXA97fwxkWwzzgx55%2FScreenshot%202025-07-09%20at%2018.24.34.png?alt=media\&token=f03e59ae-141f-4b64-9b31-8202f3ad2d2c), 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="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FI3Cjzz7bsEjIDsMU6Jxa%2F15.png?alt=media&#x26;token=fc872907-ddf1-4a64-abbf-657f7a1c76ad" alt=""><figcaption><p>Xuất báo cáo cộng tác viên</p></figcaption></figure>

Bấm nút **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F3OcDgqo55p8iKClO1HTg%2FScreenshot%202025-07-09%20at%2018.25.00.png?alt=media\&token=98cacf84-af2e-4e37-8fd2-82bf44266660)**”**, 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 **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FdfRYtORH6ZLIi8SecmlG%2FScreenshot%202025-07-09%20at%2018.25.23.png?alt=media\&token=daae2211-43a4-49c8-8f73-cce5c6e92aba)**”** để 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="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F82BOnHnSTUPuv71GPS38%2F16.png?alt=media&#x26;token=46584a5a-eea5-4c89-b319-db30f62e046f" alt=""><figcaption><p>Cài đặt tỷ lệ hoa hồng</p></figcaption></figure>

Bấm **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F6CseVnDXkaGYq8DlFZhx%2FScreenshot%202025-07-09%20at%2018.25.45.png?alt=media\&token=f82afdaa-1245-4558-a960-846d7c754fd6)**”** để 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FZ7X1RD892rB56eLBgU9A%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=436d2976-d4d6-4c8c-b1ab-5912d65cf1a7) hoặc xóa ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FJvTr9Q8LacTlJhjqpKrJ%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=5ab491a2-29fd-438f-874f-c758e86f830f) cấu hình |

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

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FXzg2t5hdsTwGufMTAeZm%2F17.png?alt=media&#x26;token=bb8b9ac5-bcd8-4273-b2f4-4dda6c2d2ec4" alt=""><figcaption><p>Thêm cấp hoa hồng</p></figcaption></figure>

* Bấm nút **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F0XicbswiknogPvkvFqPT%2FScreenshot%202025-07-09%20at%2018.26.08.png?alt=media\&token=16ad28ed-de02-44fe-b384-e6af83498f03)**”**
* 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Ft9dLiZWArHJA3wEABU5u%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=a80999ba-795b-4872-903f-c737a9f0bc32) để áp dụng.

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

* Bấm nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Fr1JGsSw5zsWHUSf4yUpz%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=1df24bd6-d70a-43ba-b91f-ac6296c58f0e) ở dòng tương ứng → sửa thông tin → bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FqXkgZT5qZWuqx0nX9V1n%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=32b42940-5fa7-40a0-84d8-7faf2beb04e1).

### Xóa tỷ lệ

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FOtNnes8G3qT7weMhBCgv%2F19.png?alt=media&#x26;token=f4c8c0e0-ebb1-4438-963d-9cec7c8d1b32" alt=""><figcaption></figcaption></figure>

* Bấm nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FqqiZrrMM4pdHRm23ubN3%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=03cadd54-0ae2-4433-8385-fe2d08a9f490) → 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 ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F0OA8VgyoUQ4FNNjm39Z9%2FScreenshot%202025-07-08%20at%2011.15.58.png?alt=media\&token=e29400a6-28f0-450a-9d7a-17511e84407b) để 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.
