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

# Danh sách hoá đơn

<figure><img src="/files/ZGcvzGT8xbS3gP5IeJPz" alt=""><figcaption><p>Danh sách mẫu hoá đơn</p></figcaption></figure>

| Thành phần            | Mô tả                                                                                               |
| --------------------- | --------------------------------------------------------------------------------------------------- |
| 🔍 Tìm kiếm           | Tìm theo tên mẫu hóa đơn                                                                            |
| Danh sách bảng        | Hiển thị STT, Tên, Mặc định, Ngày tạo                                                               |
| Trạng thái “Mặc định” | Chỉ có 1 mẫu có thể được đặt làm mặc định                                                           |
| Nút thao tác          | ![](/files/baY2YGdhihjUul2x7C69) Sửa mẫu hóa đơn / ![](/files/CHHGdv6hZPetpn3nGhux) Xóa mẫu hóa đơn |

**🔔 Lưu ý:**

* Nếu admin bấm xóa mẫu, hệ thống sẽ hiển thị cảnh báo: “Dữ liệu sẽ không được phục hồi với thao tác này!”
* Không thể xóa mẫu mặc định nếu đang được sử dụng.

## Thêm mới mẫu hóa đơn

<figure><img src="/files/4OrTgvHcOKSA1CZtOnwg" alt=""><figcaption><p>Thêm mới mẫu hoá đơn</p></figcaption></figure>

Cho phép admin khởi tạo một mẫu hóa đơn mới và soạn nội dung theo ý muốn bằng trình soạn thảo HTML (TinyMCE).

| Thành phần       | Mô tả                                            |
| ---------------- | ------------------------------------------------ |
| **Tên**          | Tên mẫu hóa đơn hiển thị trong danh sách         |
| **Mẫu mặc định** | Có thể chọn Có / Không                           |
| **Nội dung**     | Nhập nội dung hóa đơn, có thể dùng các biến động |

### Hướng dẫn sử dụng biến động:

Biến từ đơn hàng:

| Biến                | Ý nghĩa           |
| ------------------- | ----------------- |
| `{OrderId}`         | Mã đơn hàng       |
| `{ReceiverName}`    | Tên người nhận    |
| `{PhoneNumber}`     | SĐT người nhận    |
| `{DeliveryAddress}` | Địa chỉ giao hàng |
| `{Notes}`           | Ghi chú           |
| `{Total}`           | Tổng tiền         |
| `{CreatedDate}`     | Ngày tạo đơn      |

Biến từ sản phẩm (trong bảng `<tbody>`):

| Biến                | Ý nghĩa      |
| ------------------- | ------------ |
| `{ProductName}`     | Tên sản phẩm |
| `{ProductPrice}`    | Giá          |
| `{ProductQuantity}` | Số lượng     |
| `{ProductSubtotal}` | Thành tiền   |

> ✅ Hệ thống sẽ tự lặp dòng với mỗi sản phẩm trong đơn.

## Cập nhật mẫu hóa đơn

<figure><img src="/files/MfwRe2TxBgxiC2Zi6tcm" alt=""><figcaption><p>Cập nhật mẫu hoá đơn</p></figcaption></figure>

Cho phép chỉnh sửa lại nội dung mẫu hóa đơn. Giao diện bên phải sẽ hiển thị bản xem trước trực tiếp.

| Thành phần chính   | Mô tả                                                                                 |
| ------------------ | ------------------------------------------------------------------------------------- |
| Tên + Mẫu mặc định | Cập nhật thông tin chung                                                              |
| Nội dung hóa đơn   | Dùng trình editor để định dạng, chèn bảng, biến động...                               |
| Bản xem trước      | Hiển thị mẫu hóa đơn đầy đủ: tên công ty, người nhận, bảng sản phẩm, tổng tiền, QR... |

## Xóa mẫu hoá đơn

<figure><img src="/files/mdHQIeRWdZrXOb9khi4s" alt=""><figcaption><p>Xoá mẫu hoá đơn</p></figcaption></figure>

Xác nhận hành động trước khi xóa mẫu hóa đơn.

| Nội dung hiển thị                                  | Ghi chú                     |
| -------------------------------------------------- | --------------------------- |
| "Dữ liệu sẽ không được phục hồi với thao tác này!" | Cảnh báo không thể hoàn tác |
| Nút xác nhận                                       | `Xác nhận` để xóa vĩnh viễn |
| Nút hủy                                            | `Hủy` để quay lại           |


---

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