Mẫu được tạo tự động

• Bạn có thể sửa nội dung mẫu mặc định, nội dung đã sửa sẽ được giữ nguyên sau khi khởi động lại.
• Nếu bạn xóa một mẫu mặc định, lần khởi động tiếp theo hệ thống sẽ tạo lại mẫu đó với nội dung gốc.
• Hai mẫu tin nhắn new_customer_message và payment_message không được tạo tự động, bạn cần tự tạo nếu muốn dùng (xem phần Các mẫu tin nhắn OA).

Cập nhật mẫu qua EzySupport

Tìm mẫu

1. Vào Các mẫu (/ezysupport/templates).
2. Ở ô Kiểu, chọn EXPORTABLE_DATA_FIELDS hoặc OA_RESPONSE_MESSAGE. Có thể mở thẳng đường dẫn đã lọc sẵn: /ezysupport/templates?type=EXPORTABLE_DATA_FIELDS.
3. Gõ tên mẫu (ví dụ delivery_order_code) vào ô Từ khoá để lọc nhanh.

Sửa mẫu có sẵn

1. Bấm vào tên mẫu hoặc biểu tượng sửa để mở trang chi tiết, rồi bấm Sửa (/ezysupport/templates/{id}/edit).
2. Sửa ô Nội dung:
   • Mẫu EXPORTABLE_DATA_FIELDS: sửa mảng JSON các cột.
   • Mẫu OA_RESPONSE_MESSAGE: sửa nội dung tin nhắn.
3. Bấm Cập nhật.

Xem trước mẫu tin nhắn

1. Ở ô Các tham số, nhập giá trị thử cho các biến dưới dạng JSON, ví dụ:

   {
        "vocative": "anh",
        "displayName": "Nguyễn Văn A",
        "deliveryOrderCodes": "7712345678n7712345679",
        "totalWeight": "2.5",
        "shippingRate": "30,000 VND",
        "totalShippingCost": "75,000 VND"
      }
   

2. Bấm Xem trước ở phía trên ô nội dung để xem tin nhắn sau khi chèn biến. Bấm Trình soạn thảo để quay lại sửa.

Tạo mẫu mới

1. Ở trang Các mẫu, bấm Thêm mới.
2. Điền các ô:

   Ô	Mẫu cột Excel cho đại lý	Mẫu tin nhắn OA
   Tên mẫu	Tên mới, chưa trùng, ví dụ agency_hn_delivery_order_code	Đúng tên hệ thống cần, ví dụ new_customer_message
   Kiểu	EXPORTABLE_DATA_FIELDS	OA_RESPONSE_MESSAGE
   Kiểu tiêu đề và nội dung	JSON	Văn bản thường, hoặc THYMELEAF nếu cần vòng lặp
   Tiêu đề	Tên dễ nhận biết, ví dụ Mã vận đơn - Đại lý Hà Nội	Tên dễ nhận biết
   Nội dung	Mảng JSON các cột	Nội dung tin nhắn

   Ô	Mẫu cột Excel cho đại lý	Mẫu tin nhắn OA
   Tên mẫu	Tên mới, chưa trùng, ví dụ agency_hn_delivery_order_code	Đúng tên hệ thống cần, ví dụ new_customer_message
   Kiểu	EXPORTABLE_DATA_FIELDS	OA_RESPONSE_MESSAGE
   Kiểu tiêu đề và nội dung	JSON	Văn bản thường, hoặc THYMELEAF nếu cần vòng lặp
   Tiêu đề	Tên dễ nhận biết, ví dụ Mã vận đơn - Đại lý Hà Nội	Tên dễ nhận biết
   Nội dung	Mảng JSON các cột	Nội dung tin nhắn

3. Bấm Lưu.

Xóa mẫu

• Xóa mẫu mặc định: lần khởi động sau, hệ thống tạo lại mẫu với nội dung gốc. Đây cũng là cách nhanh để khôi phục mẫu mặc định sau khi sửa sai.
• Xóa mẫu đang được chọn cho đại lý: đại lý tự quay về dùng mẫu mặc định.
• Xóa new_customer_message hoặc payment_message: khách hàng sẽ không nhận được tin trả lời trong các trường hợp tương ứng.

Khi nào thay đổi có hiệu lực

• Mẫu cột Excel: được nạp khi mở trang có nút xuất. Sau khi sửa mẫu, tải lại trang Các bao hàng, Các phương tiện, Phân chia mã đơn hoặc trang vận đơn trên website đang mở, rồi xuất lại.
• Mẫu tin nhắn OA: áp dụng cho tin nhắn gửi đi tiếp theo.

Các mẫu trường dữ liệu xuất

Danh sách mẫu

Nơi xuất file

• Các bao hàng (/ezydelivery/product-packages): chọn các bao hàng rồi bấm Xuất các mã vận đơn ra Excel.
• Các phương tiện: chọn các phương tiện rồi bấm Xuất các mã vận đơn ra Excel, hoặc bấm biểu tượng Excel ở từng dòng. Khi xuất cho đúng một phương tiện, tên file được thêm tiền tố là biển số xe, ví dụ 29C12345_D-20261009-120.xlsx.
• Các đại lý → Các bao hàng của đại lý: chọn các bao hàng rồi bấm Xuất các mã vận đơn ra Excel.

Cấu trúc mẫu

[
  {
    "title": "PACKAGE CODE",
    "field": "packageLabel",
    "defaultValue": ""
  },
  {
    "title": "CREATED AT",
    "field": "createdAt",
    "defaultValue": "",
    "dateTimeFormat": "YYYY-MM-DD HH:mm:ss"
  }
]

• Cột có giá trị cố định: để field trống và đặt giá trị vào defaultValue. Ví dụ mẫu product_package mặc định có cột SHIPPING METHOD luôn là VCN.
• Cột để trống cho người dùng tự điền: để cả field và defaultValue trống. Ví dụ cột PRODUCT NAME trong mẫu delivery_order_code mặc định.
• Bỏ cột: xóa phần tử tương ứng khỏi mảng.
• Đổi tên cột: chỉ sửa title, giữ nguyên field.
• Giá trị 0 cũng được coi là trống, nên cột số lượng, trọng lượng nên có defaultValue là "0".
• Nội dung phải là JSON hợp lệ (dùng dấu nháy kép, không có dấu phẩy thừa ở phần tử cuối). Nếu JSON sai, trang chứa nút xuất sẽ bị lỗi script và không xuất được file.

Các trường thường dùng

Mẫu riêng cho từng đại lý

1. Vào EzySupport → Các mẫu và tạo mẫu mới (xem phần Tạo mẫu mới) với kiểu EXPORTABLE_DATA_FIELDS, tên mẫu khác với các tên mặc định (ví dụ agency_hn_delivery_order_code), nội dung JSON theo cấu trúc ở trên. Nên tạo 2 mẫu: một cho mã vận đơn và một cho bao hàng.
2. Vào Các đại lý → Chi tiết đại lý.
3. Ở ô Mẫu trường dữ liệu xuất mã vận đơn và Mẫu trường dữ liệu xuất bao hàng, gõ tên mẫu để tìm và chọn. Ô chỉ gợi ý các mẫu kiểu EXPORTABLE_DATA_FIELDS.
4. Bấm Lưu.

• Các đại lý → Các bao hàng của đại lý.
• Các bao hàng, khi tài khoản quản trị đang đăng nhập là thành viên của đại lý.

Tên file xuất

• có dạng YYYYMMDD, ví dụ 20261009.
• có dạng YYYYMMDD_HH_mm_ss, ví dụ 20261009_14_30_05.
• Biến đếm số mã vận đơn ở dòng đầu là (không có chữ y), khác với ở dòng cuối. Hãy gõ đúng tên biến của từng dòng.
• Đuôi .xlsx được tự động thêm vào, không cần ghi trong mẫu.

Các mẫu tin nhắn OA

Danh sách mẫu

Cú pháp nội dung

Hello  ! Below are your new delivery order codes:

The total weight is: .

<th:block th:each="shipment : ">
Tracking ID: [[]]
Current location: [[]]
Status: [[#{}]]
</th:block>

Các biến thường dùng

Kiểm tra lại

• [ ] Các mẫu EXPORTABLE_DATA_FIELDS có nội dung JSON hợp lệ, đúng thứ tự cột mong muốn.
• [ ] Các đại lý cần file riêng đã được chọn mẫu ở trang chi tiết đại lý.
• [ ] Mẫu tên tập tin trong Cài đặt dùng đúng tên biến của từng dòng.
• [ ] Đã tạo new_customer_message và payment_message nếu dùng OA.
• [ ] Các mẫu tin nhắn OA đã được dịch sang ngôn ngữ của khách hàng.