Chuẩn bị
Để bạn dễ làm quen với Tembuilder, chúng tôi sẽ hướng dẫn bạn tạo file PDF đầu tiên từ một mẫu hóa đơn có sẵn. Bạn sẽ thử chỉnh nội dung, thay dữ liệu và xem kết quả trước khi xuất PDF — tất cả ngay trong ứng dụng.
Trước khi bắt đầu, hãy đăng nhập và vào dashboard của Templates. Bạn có thể thêm mẫu vào project bằng một trong hai cách dưới đây.
1. Chọn và mở mẫu
Bạn có thể dùng file ZIP có sẵn hoặc chọn mẫu trong Gallery.
Cách 1: Import file ZIP
Tải mẫu hóa đơn (.zip), bấm Import trong Templates và chọn file vừa tải. Nhập tên và slug cho mẫu, rồi chờ import hoàn tất.
Cách 2: Chọn mẫu từ Gallery
Mở Gallery, chọn một mẫu hóa đơn và xem trước thiết kế. Thêm mẫu vào project, nhập tên và slug, rồi chờ hoàn tất.
Mở mẫu trong editor
Sau khi thêm mẫu bằng một trong hai cách trên, mở mẫu trong Templates để bắt đầu chỉnh sửa.
Trong editor, chọn một section ở Structure. Các tab HTML, CSS, Props và Config tùy thuộc phần đang chọn. Thử đổi một nhãn trong Props nếu có field tương ứng, rồi xem thay đổi trên preview.
2. Thử dữ liệu và xem trước
Mở Parameters → Schema để xem tên trường và giá trị mặc định. Giữ nguyên tên field. Layout cho thấy các thay đổi thiết kế đang chỉnh.
Save mẫu trước khi mở tab PDF. PDF preview dùng nội dung mẫu đã lưu và dữ liệu parameter của editor, ban đầu lấy từ Default. Sau lần lưu tiếp theo, tạo lại PDF preview để xem thay đổi; bản PDF cũ không tự cập nhật. Preview không tính quota render.
Dữ liệu nhập trong Run tách riêng với PDF preview. Để thử giá trị mới ở Run, tạo PDF rồi mở kết quả của lần chạy đó ở bước 3–4.
Dữ liệu JSON mẫu dùng các field invoiceNumber, seller, customer, lineItems, khớp với ZIP ở trên. Với mẫu khác, xem Parameters của chính mẫu đó. Khi gọi API, đặt object dữ liệu vào parameters.
3. Lưu, publish và tạo PDF
- Lưu thay đổi, chọn đúng version và publish version đó.
- Tạo API key trong project với quyền
template:rendernếu chưa có. - Mở Run, chọn key, version, variant và điền dữ liệu.
- Bấm Render, đợi công việc hoàn tất.
Render thật cần version đã publish. Mỗi lần render thành công tính quota; xem được preview chưa có nghĩa mẫu đã sẵn sàng để render.
4. Tải và kiểm tra kết quả
Khi trạng thái thành công, mở kết quả và tải PDF. Có thể tìm lại lần chạy trong Renders. Kiểm tra trang đầu, trang cuối và các dòng dữ liệu trong file tải về.
Nếu thất bại, mở chi tiết lỗi trước khi thử lại. Mỗi lần bấm Render có thể tạo một công việc mới. Xem cách xử lý lỗi thường gặp nếu chưa xác định được nguyên nhân.