> 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/khach-hang/danh-sach-khach-hang.md).

# Danh sách khách hàng

<figure><img src="/files/7pzNaTKKXVbwmAeP4fjX" alt=""><figcaption><p>Hiển thị khách hàng trên Mini App và CMS</p></figcaption></figure>

## Tìm kiếm và lọc khách hàng

<figure><img src="/files/JsJXN0YdiqX5TEO40RZw" alt=""><figcaption><p>Tìm kiếm và bộ lọc</p></figcaption></figure>

* Ở phía trên bảng danh sách.
* Điền **Tên hoặc Số điện thoại** → Bấm **🔍** để lọc nhanh.
* Chọn **khoảng Thời gian đăng ký** → Bấm **Lọc** để lọc theo ngày.

| Thành phần         | Ý nghĩa                            |
| ------------------ | ---------------------------------- |
| Ô tìm kiếm         | Nhập tên hoặc số điện thoại        |
| Từ ngày – Đến ngày | Lọc theo ngày đăng ký tài khoản KH |
| Nút Lọc            | Áp dụng điều kiện lọc              |

## Danh sách khách hàng

<figure><img src="/files/fHVw6kJXtvGf9sNQ90Ni" alt=""><figcaption><p>Hiển thị Danh sách khách hàng</p></figcaption></figure>

| Cột          | Ý nghĩa / Mô tả                  |
| ------------ | -------------------------------- |
| STT          | Số thứ tự                        |
| Thông tin KH | Tên, ảnh, SĐT                    |
| Sinh Nhật    | Ngày/tháng/năm sinh (nếu có)     |
| Nguồn        | Tag hoặc nhóm phân loại (nếu có) |
| Điểm         | Tổng điểm tích luỹ               |
| Hạng         | Bạc, Vàng, Platinum...           |
| Thao tác     | Các nút để quản lý khách hàng    |

## Các nút thao tác

<figure><img src="/files/2JXLY7grCj1T6lGekcbw" alt=""><figcaption><p>Các nút thao tác</p></figcaption></figure>

✅ Bấm vào nút cần thao tác trong cột “Thao tác” ở dòng khách hàng.

| Icon / Nút                                                                                          | Ý nghĩa / Tác vụ                   |
| --------------------------------------------------------------------------------------------------- | ---------------------------------- |
| <div><figure><img src="/files/WgD7YXCDwjl0bhuHXV97" alt=""><figcaption></figcaption></figure></div> | Xem/sửa chi tiết khách hàng        |
| <div><figure><img src="/files/GCky2cnS3VSUHW2OCL7a" alt=""><figcaption></figcaption></figure></div> | Xem người giới thiệu khách này     |
| <div><figure><img src="/files/0z1CJ1TbNKWSSadpKW6z" alt=""><figcaption></figcaption></figure></div> | Xoá khách hàng (cảnh báo xác nhận) |
| <div><figure><img src="/files/m1xnrwBgS5jG6GqQ6KJx" alt=""><figcaption></figcaption></figure></div> | Xem lịch sử mua hàng của khách     |

## Xem, sửa chi tiết khách hàng

<figure><img src="/files/5ea0a7YIXxxkjkCuLVTL" alt=""><figcaption><p>Xem, sửa chi tiết khách hàng</p></figcaption></figure>

✅ Khi bấm nút → ![](/files/hx18HOyLS5y70IofWGai) Popup mở chi tiết KH:

### 1. Thông tin cơ bản

| Trường          | Hướng dẫn điền                                |
| --------------- | --------------------------------------------- |
| Tên             | Tên đầy đủ KH                                 |
| Số điện thoại   | Bắt buộc, dạng số, duy nhất                   |
| Sinh nhật       | dd/MM/yyyy (tuỳ chọn)                         |
| Nghề nghiệp     | Tuỳ chọn                                      |
| Hạng thành viên | Chọn từ danh sách có sẵn (Đồng, Bạc, Vàng...) |

### 2. Thông tin điểm & tài khoản

| Trường        | Mô tả                     |
| ------------- | ------------------------- |
| Điểm tích luỹ | Sửa điểm thủ công nếu cần |
| Mã giới thiệu | Tự tạo, có thể sao chép   |
| Liên kết QR   | Link chia sẻ QR           |

### 3. Thông tin phân loại

| Trường   | Ý nghĩa                    |
| -------- | -------------------------- |
| Tag nhóm | Phân nhóm khách dễ quản lý |
| Ghi chú  | Tuỳ chọn thêm thông tin    |

### 4. Địa chỉ khách hàng

✅ Nhập địa chỉ rõ ràng – phục vụ giao hàng / phân tích.

### 5. Thông tin hoá đơn

| Tuỳ chọn     | Ý nghĩa                           |
| ------------ | --------------------------------- |
| Doanh nghiệp | Nếu KH có nhu cầu xuất hoá đơn DN |
| Cá nhân      | Xuất hoá đơn cho khách lẻ         |

### 6. Thông tin mở rộng (tuỳ chọn)

✅ Admin có thể **thêm mới các trường tự do**:

| Trường tuỳ chỉnh | Ví dụ      |
| ---------------- | ---------- |
| Giới tính        | Nam / Nữ   |
| Ngày kỷ niệm     | 23/04/2025 |

✅ Nhấn **Thêm** → điền tên trường và giá trị → Lưu.

#### ✅ **Bước cuối:**

* Nhấn **Cập nhật** để lưu.
* Hoặc **Đóng** để huỷ thay đổi.

## Xem người giới thiệu

<figure><img src="/files/iB3IIZpR56eeYsPe6e0t" alt=""><figcaption><p>Xem người giới thiệu</p></figcaption></figure>

✅ Bấm nút ![](/files/b3qnG8iuFuEqZbbYA1K5) → Popup sẽ hiển thị:

| Nội dung hiển thị mẫu:    |
| ------------------------- |
| Nguyễn Văn A (8491xxxxxx) |

✅ Nút **Đóng** để thoát.

## Xem lịch sử mua hàng

<figure><img src="/files/xVHiY7UQk9DWFQUAMs63" alt=""><figcaption><p>Xem lịch sử mua hàng</p></figcaption></figure>

✅ Bấm nút ![](/files/YhR3PxNyTbqIScVbIsXc)để mở bảng chi tiết:

| Cột                                   | Ý nghĩa                             |
| ------------------------------------- | ----------------------------------- |
| STT                                   | Số thứ tự                           |
| Mã đơn hàng                           | ID duy nhất                         |
| Ngày đặt                              | Thời gian đặt hàng                  |
| Tổng tiền                             | Giá trị đơn                         |
| Trạng thái                            | Đã hoàn thành, Chờ xác nhận, Đã huỷ |
| Thanh toán                            | Đã thanh toán, Chưa thanh toán      |
| ![](/files/z54VlmkA2ET4Fez9RBun)(Xem) | Xem chi tiết đơn hàng               |

## Xoá khách hàng

<figure><img src="/files/aqEK14KeGNBjCMUGO38Q" alt=""><figcaption><p>Xoá khách hàng</p></figcaption></figure>

✅ Bấm nút ![](/files/Mk9VLwCw6v8T0kq7a97T) → hiện popup cảnh báo:

> “Dữ liệu sẽ không được phục hồi với thao tác này!”

✅ Chọn:

* **Huỷ** – không xoá
* **Xác nhận** – xoá vĩnh viễn

## Nhập danh sách khách hàng hàng loạt bằng file Excel

<figure><img src="/files/ab4mtE9qNdEj7KIlOZ5B" alt=""><figcaption><p>Nhập bằng danh sách Excel</p></figcaption></figure>

✅ Bấm nút **“Nhập danh sách khách hàng”** (góc trên phải).\
✅ Popup hướng dẫn hiện ra.

### 1. Chuẩn bị file Excel

Định dạng cột bắt buộc:

| Cột           | Mô tả                     |
| ------------- | ------------------------- |
| STT           | Số thứ tự                 |
| Tên           | Tên khách hàng            |
| Số điện thoại | Số di động (chỉ số)       |
| Sinh nhật     | dd/MM/yyyy hoặc d/M/yyyy  |
| Nghề nghiệp   | Tuỳ chọn                  |
| Hạng          | Đồng/Bạc/Vàng/Platinum    |
| Điểm          | Điểm tích luỹ             |
| Địa chỉ       | Địa chỉ cụ thể            |
| Ghi chú       | Tuỳ chọn, có thể để trống |

Ví dụ minh hoạ trong Excel:

| STT | Tên       | SĐT        | Sinh nhật | Nghề nghiệp | Hạng   | Điểm | Địa chỉ | Ghi chú     |
| --- | --------- | ---------- | --------- | ----------- | ------ | ---- | ------- | ----------- |
| 1   | Nguyễn An | 0912345678 | 1/1/1990  | Kế toán     | Gold   | 500  | Hà Nội  | Khách VIP   |
| 2   | Lê Bình   | 0912345678 | 15/5/1985 | Bác sĩ      | Silver | 300  | TP HCM  | Mới đăng ký |

Thao tác tải lên:

✅ Bấm **Choose File** → chọn file trên máy.\
✅ Nhấn **Tải lên** → hệ thống tự kiểm tra & nhập.\
✅ Nếu có lỗi → xem thông báo để sửa file.

Mẹo hướng dẫn nhanh cho Admin:

✅ **Trước khi nhập file Excel:**

* Đảm bảo số điện thoại hợp lệ.
* Định dạng sinh nhật chính xác (dd/MM/yyyy).
* Không chứa ký tự lạ trong cột số.

✅ **Trong quản lý hằng ngày:**

* Phân hạng KH để dễ ưu đãi.
* Kiểm tra lịch sử mua để ưu tiên CSKH.
* Ghi chú các chi tiết đặc biệt nếu có.

## **Xuất danh sách**&#x20;

<figure><img src="/files/DKRbK8O9ZuzYTLlwmfZ4" alt=""><figcaption><p>Xuất danh sách Excel</p></figcaption></figure>

✅ Bấm nút **“Xuất Excel”** (góc trên phải).\
✅ Tải về file Excel chứa toàn bộ danh sách khách hàng.


---

# 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/khach-hang/danh-sach-khach-hang.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.