> For the complete documentation index, see [llms.txt](https://docs.xcloud.wms.delfi.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xcloud.wms.delfi.vn/docs/features/master-data/label-templates.md).
# Mẫu tem
### TỔNG QUAN
**Mục đích:** Cung cấp công cụ thiết kế trực quan giúp doanh nghiệp tự định nghĩa các mẫu tem nhãn (Decal) cho sản phẩm, vị trí kho hoặc tài sản theo kích thước thực tế của giấy in.
**Đối tượng sử dụng:** Quản trị viên hệ thống (Admin), Quản lý kho.
**Thời điểm thực hiện:** Khi cần thay đổi quy chuẩn tem nhãn, thay đổi kích thước giấy in (Decal), hoặc muốn bổ sung/bớt các thông tin hiển thị trên con tem (QR Code, Barcode, Logo).
***
### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC
Kích thước vật lý: Phải đo chính xác Chiều rộng và Chiều cao của con tem (đơn vị mm) từ cuộn decal thực tế.
Danh sách trường thông tin: Xác định các thông tin cần in (Ví dụ: Tên sản phẩm, Mã lô, Ngày sản xuất, QR Code).
***
### MÔ TẢ GIAO DIỆN
#### Màn hình danh sách
* Danh sách mẫu: Hiển thị Tên mẫu, Kích thước (Rộng x Cao), và Ngày cập nhật.
* Nhãn "Ưu tiên": Mẫu tem có gắn ngôi sao màu vàng là mẫu mặc định sẽ được hệ thống chọn sẵn khi thực hiện lệnh in.
* Cột hành động: \* Biểu tượng Sửa (Bút chì): Vào trình thiết kế.
* Biểu tượng Ngôi sao: Thiết lập mẫu này làm mặc định.
* Biểu tượng Xóa (Thùng rác): Loại bỏ mẫu tem.
#### Màn hình Thiết kế
* Thêm thành phần (Bên trái): Chứa các khối nội dung kéo thả gồm: Văn bản, Mã vạch, Mã QR, Logo.
* Cài đặt tem (Bên trái): Nơi nhập Tên mẫu tem và Kích thước (Rộng/Cao). Có ô tích chọn "Ưu tiên".
* Bảng vẽ (Chính giữa): Khu vực mô phỏng con tem. Các thành phần được đặt tại đây sẽ hiển thị đúng vị trí khi in ra.
* Thanh công cụ phụ: Nút Zoom (Phóng to/thu nhỏ khung nhìn) và nút \[Lưu].
* Thuộc tính & Lịch sử (Bên phải):
* Thuộc tính: Chỉnh sửa chi tiết cho từng thành phần đang chọn (Cỡ chữ, nội dung mã...).
* Lịch sử: Xem lại các phiên bản đã lưu và khôi phục nếu cần.
***
### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN
#### **Thêm mới và Thiết kế mẫu tem**
* Khởi tạo: Nhấn \[+ Thêm mới] tại màn hình danh sách.
* Thiết lập khung: Tại mục Cài đặt tem, nhập Tên mẫu và kích thước Rộng - Cao (Ví dụ: 80x40 mm). Khung trắng (Canvas) sẽ tự động thay đổi theo kích thước này.
* Thiết kế nội dung:
* Nhấp vào các biểu tượng ở mục Thêm thành phần (Văn bản, Mã QR...) để đưa chúng vào khung vẽ.
* Dùng chuột kéo các thành phần đến vị trí mong muốn.
* Sử dụng các phím mũi tên trên bàn phím để di chuyển thành phần một cách chính xác từng mm.
* Chỉnh sửa thuộc tính: Nhấp vào một thành phần trên khung vẽ, sau đó sang tab Thuộc tính bên phải để điều chỉnh nội dung hiển thị hoặc định dạng.
* Hoàn tất: Nhấn \[Lưu].
#### **Chỉnh sửa mẫu tem**
* Tại màn hình danh sách, nhấn biểu tượng Bút chì tại mẫu tem cần sửa.
* Thay đổi vị trí các thành phần hoặc kích thước tem.
* Nếu thao tác sai, có thể sang tab Lịch sử để quay lại phiên bản trước đó.
* Nhấn \[Lưu] để cập nhật thay đổi.
***
### VÍ DỤ THỰC TẾ
Kho của doanh nghiệp vừa mua một lô giấy in tem nhiệt mới có kích thước 35x22mm (nhỏ hơn khổ cũ 50x40mm). Quản lý kho thực hiện các bước sau:
* Truy cập chức năng Mẫu tem, nhấn \[Thêm mới].
* Nhập thông số Rộng: 35 và Cao: 22. Khung vẽ Canvas lập tức thu nhỏ lại đúng tỷ lệ.
* Nhấp chọn thêm "Mã QR" và "Văn bản", kéo chỉnh cho các thành phần này nằm gọn bên trong khung trắng.
* Bấm \[Lưu].
* Cài đặt mẫu tem 35x22mm này làm "Mặc định".
* Kết quả: Khi nhân viên thực hiện lệnh in tem sản phẩm, máy in sẽ in ra các con tem sắc nét, đúng khổ giấy mới mà không bị tràn viền.
***
### LƯU Ý CHUNG KHI SỬ DỤNG
| Tình huống / Lỗi | Nguyên nhân | Cách xử lý |
| -------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Nội dung in ra bị tràn lề hoặc mất nét | Thành phần trên khung vẽ Canvas nằm quá sát mép hoặc kích thước nhập vào nhỏ hơn thực tế giấy in. | Kiểm tra lại kích thước giấy in. Kéo các thành phần dịch vào bên trong khung trắng tối thiểu 1-2mm. |
| Mã vạch/QR không quét được | Kích thước mã quá nhỏ hoặc bị nén lệch tỷ lệ. | Phóng to thành phần Mã QR/Mã vạch trên Canvas và kiểm tra độ phân giải của máy in. |
| Không thể xóa mẫu tem | Mẫu tem này đang được đặt làm "Ưu tiên" (Mặc định). | Bạn cần chọn một mẫu tem khác làm "Ưu tiên" trước, sau đó nút Xóa của mẫu cũ sẽ được kích hoạt. |
| Muốn quay lại thiết kế cũ đã lưu | Thao tác sửa mới bị lỗi hoặc không đẹp bằng bản cũ. | Sử dụng tab Lịch sử ở drawer bên phải, chọn phiên bản thời gian tương ứng và nhấn nút Khôi phục (biểu tượng xoay trò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://docs.xcloud.wms.delfi.vn/docs/features/master-data/label-templates.md?ask=
```
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.