> ## Documentation Index
> Fetch the complete documentation index at: https://doc.ivycare.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Chương trình khuyến mãi

> Hướng dẫn sử dụng Chương trình khuyến mãi trên IVY Care Portal.

## Tổng quan

Chương trình khuyến mãi là nơi bạn tạo và quản lý các ưu đãi giảm giá hoặc tặng dịch vụ, ví dụ "Ưu đãi Hè 2026 – Giảm 15%". Mỗi chương trình có thời gian chạy, mức ưu đãi, đối tượng áp dụng, ngân sách riêng và phải **được duyệt** trước khi chạy. Khi nhân viên lập đơn, các chương trình đang chạy sẽ hiện ra để chọn áp dụng cho khách.

<img src="https://mintcdn.com/miasolution-7cbd1d17/1f4LXWsPLndfwtdL/images/promotions/01-list.png?fit=max&auto=format&n=1f4LXWsPLndfwtdL&q=85&s=c60c3efb4ab66a245a08141620789cf6" alt="Danh sách chương trình khuyến mãi" width="2880" height="2788" data-path="images/promotions/01-list.png" />

## Điều kiện trước khi bắt đầu

* Bạn đăng nhập bằng tài khoản có quyền quản lý khuyến mãi.
* Đã thống nhất mức ưu đãi, thời gian, đối tượng và ngân sách của chương trình.

## Vòng đời một chương trình khuyến mãi

Mỗi chương trình đi qua các trạng thái sau — các thẻ phía trên danh sách cũng lọc theo đúng những trạng thái này:

| Trạng thái         | Nghĩa là                                   | Hành động có thể làm                            |
| ------------------ | ------------------------------------------ | ----------------------------------------------- |
| **Nháp**           | Mới tạo hoặc bị thu hồi về, chưa gửi duyệt | Chỉnh sửa · Gửi duyệt · Nhân bản · Xóa          |
| **Chờ duyệt**      | Đã gửi, đang chờ quản lý quyết định        | Duyệt / Từ chối (quản lý) · Thu hồi (người tạo) |
| **Đã lên lịch**    | Được duyệt, chưa tới ngày bắt đầu          | Tự chuyển sang Đang hoạt động khi tới ngày      |
| **Đang hoạt động** | Đang áp dụng cho đơn hàng                  | Tạm dừng · Kết thúc sớm · Nhân bản              |
| **Tạm dừng**       | Ngừng áp dụng tạm thời                     | Chạy lại · Kết thúc                             |
| **Đã kết thúc**    | Hết hạn hoặc kết thúc sớm                  | Nhân bản · Xóa                                  |

## Hướng dẫn từng bước

### Tạo một chương trình khuyến mãi (wizard 5 bước)

Nhấn nút **Tạo khuyến mãi** ở góc trên bên phải. Trình tạo gồm 5 bước, thanh tiến trình phía trên cho biết bạn đang ở đâu. Ở bất kỳ bước nào cũng có thể nhấn **Lưu nháp** để lưu lại làm tiếp sau.

**Bước 1 — Thông tin cơ bản**

<img src="https://mintcdn.com/miasolution-7cbd1d17/1f4LXWsPLndfwtdL/images/promotions/02-step1-filled.png?fit=max&auto=format&n=1f4LXWsPLndfwtdL&q=85&s=675a12498460eefa0dea0c3036b6a99b" alt="Bước 1 — Thông tin cơ bản đã điền" width="2880" height="2148" data-path="images/promotions/02-step1-filled.png" />

* **Tên khuyến mãi**: ví dụ "Ưu đãi Hè 2026 – Giảm 15%". Bắt buộc.
* **Mã khuyến mãi**: giữ tích **Tự động tạo mã** để hệ thống tự sinh, hoặc bỏ tích để tự đặt.
* **Ngày bắt đầu**: để trống nếu muốn chạy ngay khi được duyệt. **Ngày kết thúc**: bắt buộc.
* **Độ ưu tiên**: khi một đơn khớp nhiều chương trình, số ưu tiên cao hơn được áp dụng.
* **Ngân sách**: tổng tiền giảm tối đa của cả chương trình, ví dụ 50.000.000. Để trống nếu không giới hạn.
* **Giới hạn tổng lượt dùng** / **Giới hạn mỗi khách hàng**: để trống nếu không giới hạn.

Nhấn **Tiếp theo**.

**Bước 2 — Điều kiện**

<img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/03-step2-dieu-kien.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=dcd23d4b497cd2ee956be89e67bcc33e" alt="Bước 2 — Thêm nhóm điều kiện" width="2880" height="1800" data-path="images/promotions/03-step2-dieu-kien.png" />

Đặt điều kiện để chương trình chỉ áp dụng khi đơn thoả yêu cầu. Nhấn **Thêm nhóm điều kiện**, chọn cách kết hợp — **Tất cả điều kiện đều thỏa (VÀ)** hoặc **Bất kỳ điều kiện nào thỏa (HOẶC)** — rồi **Chọn dịch vụ** hoặc **Thêm điều kiện** cho từng dòng. Có thể **Thêm nhóm con** để lồng điều kiện. Nếu để trống, chương trình áp dụng cho mọi đơn hàng.

**Bước 3 — Ưu đãi**

<img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/04-step3-uu-dai.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=f5d204cffd318267baf3679c024cf151" alt="Bước 3 — Chọn kiểu ưu đãi Giảm theo %" width="2880" height="1800" data-path="images/promotions/04-step3-uu-dai.png" />

Chọn kiểu ưu đãi:

* **Giảm số tiền**: giảm thẳng một số tiền, nhập **Số tiền giảm**.
* **Giảm theo %**: nhập **Phần trăm giảm (%)** (ví dụ 15) và **Giảm tối đa** (ví dụ 1.000.000) để chặn mức giảm trần.
* **Tặng dịch vụ**: tặng kèm một dịch vụ.

Nhấn **Thêm ưu đãi** nếu chương trình có nhiều mức.

**Bước 4 — Đối tượng**

<img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/05-step4-doi-tuong.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=c61247bd1af67e128fc3e2cea7a6a562" alt="Bước 4 — Chọn đối tượng áp dụng" width="2880" height="1800" data-path="images/promotions/05-step4-doi-tuong.png" />

Chọn ai được hưởng qua **Chọn hạng thành viên** và **Chọn nhóm khách hàng**. Để trống nếu áp dụng cho tất cả khách.

**Bước 5 — Xem lại**

<img src="https://mintcdn.com/miasolution-7cbd1d17/1f4LXWsPLndfwtdL/images/promotions/06-step5-xem-lai.png?fit=max&auto=format&n=1f4LXWsPLndfwtdL&q=85&s=bf1d423ec28410ac27137db9bc006f0a" alt="Bước 5 — Xem lại và Gửi duyệt" width="2880" height="1886" data-path="images/promotions/06-step5-xem-lai.png" />

Kiểm tra toàn bộ thông tin. Cần sửa thì nhấn **Chỉnh sửa** hoặc **Quay lại**. Khi đã đúng, nhấn **Gửi duyệt** để chuyển cho quản lý phê duyệt, hoặc **Lưu nháp** nếu chưa muốn gửi.

### Ví dụ cấu hình một số khuyến mãi thường gặp

Mọi khuyến mãi đều dựng theo cùng một công thức: đặt **Điều kiện** ở Bước 2 (khi nào được hưởng) và **Ưu đãi** ở Bước 3 (khách được gì). Dưới đây là bốn kiểu hay dùng nhất:

| Muốn làm gì                                                                                     | Bước 2 — Điều kiện                                          | Bước 3 — Ưu đãi                                                                     |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Đơn từ X trở lên, giảm % giá trị đơn** (ví dụ đơn từ 2.000.000đ giảm 10%)                     | Thêm nhóm điều kiện → **Tổng đơn hàng ≥ 2.000.000đ**        | Chọn **Giảm theo %**, nhập 10%, đặt **Giảm tối đa** để chặn trần (ví dụ 1.000.000đ) |
| **Đơn từ X trở lên, giảm một số tiền** (ví dụ đơn từ 3.000.000đ giảm 500.000đ)                  | Thêm nhóm điều kiện → **Tổng đơn hàng ≥ 3.000.000đ**        | Chọn **Giảm số tiền**, nhập 500.000đ                                                |
| **Đơn từ X trở lên, tặng một dịch vụ** (ví dụ đơn từ 5.000.000đ tặng 1 buổi cạo vôi)            | Thêm nhóm điều kiện → **Tổng đơn hàng ≥ 5.000.000đ**        | Chọn **Tặng dịch vụ**, chọn dịch vụ tặng                                            |
| **Mua nhóm dịch vụ này thì được tặng dịch vụ** (ví dụ mua gói niềng răng tặng 1 buổi tẩy trắng) | Thêm nhóm điều kiện → chọn **dịch vụ/combo** khách phải mua | Chọn **Tặng dịch vụ**, chọn dịch vụ tặng                                            |

Vài lưu ý khi cấu hình:

* Nếu để **Điều kiện** trống, khuyến mãi áp cho **mọi đơn hàng** — dùng cho các đợt giảm giá toàn phòng khám.
* Ô **Giảm tối đa** ở kiểu "Giảm theo %" giúp khống chế số tiền giảm tối đa mỗi đơn, tránh giảm quá tay với đơn giá trị lớn.
* Một chương trình có thể có nhiều điều kiện (kết hợp **VÀ** / **HOẶC**) và nhiều ưu đãi — nhấn **Thêm điều kiện** / **Thêm ưu đãi** để thêm dòng.

### Chỉnh sửa một chương trình

1. Ở danh sách, nhấn vào dòng chương trình để mở trang chi tiết.

   <img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/07-detail-draft.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=73adf519c3545dfd9b5320870736c380" alt="Chi tiết chương trình ở trạng thái Nháp" width="2880" height="1800" data-path="images/promotions/07-detail-draft.png" />

2. Với chương trình **Nháp** (hoặc bị từ chối), nhấn **Chỉnh sửa** để mở lại wizard 5 bước và sửa bất kỳ phần nào.

3. Chương trình đang **Chờ duyệt** thì không sửa trực tiếp — nhấn **Thu hồi** đưa về Nháp trước, sửa xong gửi duyệt lại.

### Gửi duyệt, Duyệt / Từ chối, Thu hồi

1. Từ trang chi tiết chương trình **Nháp**, nhấn **Gửi duyệt**. Trạng thái chuyển sang **Chờ duyệt**.

   <img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/08-detail-cho-duyet.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=84f3a9a3f4b54a81f45f8a96ab7207e4" alt="Chi tiết ở trạng thái Chờ duyệt — nút Duyệt / Từ chối và Thu hồi" width="2880" height="1800" data-path="images/promotions/08-detail-cho-duyet.png" />

2. **Quản lý phê duyệt**: nhấn **Duyệt / Từ chối** — cửa sổ xem xét mở ra với hai lựa chọn:

   <img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/09-tu-choi-dialog.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=c16c1d75351684a36122b859b07630d0" alt="Cửa sổ Duyệt / Từ chối khuyến mãi" width="2880" height="1800" data-path="images/promotions/09-tu-choi-dialog.png" />

   * **Duyệt**: chương trình chuyển sang **Đã lên lịch** (nếu chưa tới ngày bắt đầu) hoặc chạy ngay.
   * **Từ chối**: chương trình quay về để người tạo sửa và gửi lại.

3. **Người tạo đổi ý**: nhấn **Thu hồi** khi chương trình còn **Chờ duyệt**. Hệ thống hỏi lại: "Bạn có chắc chắn muốn thu hồi chương trình khuyến mãi này? Chương trình sẽ trở về trạng thái nháp." — nhấn **Thu hồi** để xác nhận.

### Tạm dừng, Kết thúc sớm, Nhân bản, Xóa

1. Mở trang chi tiết một chương trình **Đang hoạt động**:

   <img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/10-detail-active.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=2d6397b79ed08b9957e87667ae2008ae" alt="Chi tiết chương trình đang hoạt động — Tạm dừng và Kết thúc sớm" width="2880" height="1800" data-path="images/promotions/10-detail-active.png" />

   * **Tạm dừng**: ngừng áp dụng tạm thời — đơn mới không được hưởng ưu đãi cho tới khi chạy lại.
   * **Kết thúc sớm**: dừng hẳn trước ngày kết thúc. Không đảo ngược được — hệ thống ghi lại lý do kết thúc sớm.
   * **Nhân bản**: tạo bản sao ở trạng thái Nháp — tiện khi chạy lại chương trình tương tự mùa sau.

2. **Xóa** chỉ dùng được với chương trình **Nháp** hoặc **Đã kết thúc**. Chương trình đã có lượt sử dụng thì nên giữ lại để đối soát, không nên xóa.

### Theo dõi hiệu quả: Ngân sách, Tổng giảm giá, Lượt sử dụng

Đầu trang chi tiết mỗi chương trình có ba ô số liệu để bạn biết chương trình đang chạy ra sao:

<img src="https://mintcdn.com/miasolution-7cbd1d17/vkQlB-jasGVEXYiK/images/promotions/10-detail-active.png?fit=max&auto=format&n=vkQlB-jasGVEXYiK&q=85&s=2d6397b79ed08b9957e87667ae2008ae" alt="Ba ô số liệu ở đầu trang chi tiết chương trình" width="2880" height="1800" data-path="images/promotions/10-detail-active.png" />

* **Lượt sử dụng**: số lần chương trình đã được áp vào đơn hàng, so với tổng số lượt còn được phép dùng. Mỗi lần một khách được hưởng ưu đãi tính là **một lượt**. Khi chạm giới hạn (đặt ở Bước 1: *Giới hạn tổng lượt dùng*), chương trình ngừng áp dụng.
* **Tổng giảm giá**: tổng số tiền chương trình đã thực sự giảm cho khách, cộng dồn từ tất cả các lượt đã dùng. Đây là con số cho biết chương trình đã "tiêu" bao nhiêu tiền ưu đãi.
* **Ngân sách**: hiển thị dạng *đã dùng / tổng ngân sách (%)* kèm thanh tiến trình. Tổng ngân sách là mức tiền giảm tối đa bạn đặt ở Bước 1. Khi phần đã dùng chạm mức tổng, chương trình **tự ngừng** để không giảm vượt ngân sách. Thanh gần đầy (ví dụ 95%) là dấu hiệu nên chuẩn bị gia hạn ngân sách hoặc kết thúc chương trình.

> 💡 **Mẹo**: Đặt **Ngân sách** và **Giới hạn tổng lượt dùng** ngay từ đầu để chương trình tự dừng đúng lúc, tránh giảm giá vượt kế hoạch.

### Thẻ Lịch sử — nhật ký và lượt sử dụng

Nhấn thẻ **Lịch sử** trong trang chi tiết để xem toàn bộ diễn biến của chương trình:

<img src="https://mintcdn.com/miasolution-7cbd1d17/-Q0Y9JXW52xMT6aK/images/promotions/11-detail-history.png?fit=max&auto=format&n=-Q0Y9JXW52xMT6aK&q=85&s=790d538841dcc320b48a7ab5d1f8048e" alt="Thẻ Lịch sử — bảng lượt sử dụng theo từng đơn" width="2880" height="2122" data-path="images/promotions/11-detail-history.png" />

Thẻ này gồm hai phần:

1. **Nhật ký hoạt động**: các mốc thay đổi trạng thái — *Đã kích hoạt*, *Đã tạm dừng*, *Đã kết thúc* — kèm người thực hiện, thời gian và lý do (nếu có). Giúp bạn biết ai đã bật/dừng chương trình và vì sao.
2. **Lịch sử sử dụng**: bảng liệt kê từng lượt khách đã dùng ưu đãi, gồm **Khách hàng**, **Số điện thoại**, **Mã đơn hàng**, **Số tiền giảm**, **Dịch vụ tặng** và **Thời gian áp dụng**. Nhấn mã đơn hàng để mở đơn tương ứng. Dùng phần này để đối soát chính xác chương trình đã áp cho những đơn nào.

## Các trường hợp thường gặp

| Tình huống                                       | Cách xử lý                                                                                                                                   |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Không nhấn được **Tiếp theo** ở bước 1           | Kiểm tra đã điền **Tên khuyến mãi** và **Ngày kết thúc** — hai trường bắt buộc.                                                              |
| Chương trình đã duyệt nhưng chưa áp dụng cho đơn | Xem trạng thái: **Đã lên lịch** nghĩa là chưa tới **Ngày bắt đầu** — tới ngày sẽ tự chạy.                                                    |
| Muốn sửa chương trình đang chờ duyệt             | Nhấn **Thu hồi** để đưa về Nháp, sửa xong **Gửi duyệt** lại.                                                                                 |
| Hết ngân sách giữa chừng                         | Khi tổng tiền giảm chạm **Ngân sách**, chương trình tự ngừng áp dụng. Thanh ngân sách ở trang chi tiết cho biết đã dùng bao nhiêu phần trăm. |

## Câu hỏi thường gặp

**Q: Nhiều chương trình cùng khớp một đơn thì tính sao?**
A: Hệ thống áp chương trình có **Độ ưu tiên** cao hơn. Đặt số ưu tiên để kiểm soát thứ tự.

**Q: Khác nhau giữa Tạm dừng và Kết thúc sớm?**
A: Tạm dừng là nghỉ tạm — chạy lại được. Kết thúc sớm là dừng hẳn, không mở lại được; muốn chạy tiếp phải **Nhân bản** thành chương trình mới.

## Liên hệ hỗ trợ

Khi cần hỗ trợ, liên hệ đội **MIA Solution** qua **Group Zalo hỗ trợ** đã được cung cấp cho phòng khám.
