Bắt đầu
Điền các trường
Hãy đọc mẫu trước: các trường và nhóm trên endpoint mẫu là toàn bộ hợp đồng cho values. Sau đó gửi values dưới dạng đối tượng được đánh khóa theo khóa trường.
- Khóa là khóa của các trường đúng như được trả về, không bao giờ là câu chữ của nhãn hay văn bản đang được điền (nhãn vẫn được chấp nhận, cho các bên gọi viết trước khi có khóa). Một trường dùng ở nhiều chỗ trong tài liệu được điền tất cả cùng lúc.
- Khóa bạn bỏ qua giữ giá trị mặc định của mẫu. Chuỗi rỗng xóa trống một trường.
- Trường select chấp nhận chính xác một trong các tùy chọn của nó, hoặc chuỗi rỗng.
- Trường số chấp nhận chuỗi số như 1234.56 theo bất kỳ quy ước thập phân nào; máy chủ viết lại theo định dạng mẫu khai báo, nên 1234.56 sẽ thành 1,234.56 ở nơi định dạng quy định.
- Trường ngày không được viết lại: hãy gửi ngày đã viết đúng như định dạng của nó thể hiện. Định dạng là ngày tham chiếu 27 tháng 8 năm 2026 viết theo cách mong đợi, nên định dạng 08/27/2026 cần 10/15/2026.
- Các trường đánh dấu auto do PaperClerk điền khi tạo, là ngày hôm nay hoặc số tự động kế tiếp, và bất cứ gì bạn gửi cho chúng đều bị bỏ qua.
- Nhóm lặp nhận một mảng đối tượng bản ghi được đánh khóa theo khóa trường của nhóm; hàng của mẫu được nhân bản một lần cho mỗi bản ghi. Nhóm bị bỏ qua giữ hàng duy nhất đã soạn; mảng rỗng xóa phần đó. Giá trị trường được kiểm tra đúng như các trường cấp cao nhất.
- Khi một trường có description, đó là văn bản trợ giúp của tác giả mẫu về giá trị mong đợi, chẳng hạn định dạng hoặc nội dung cần có. Nó không được in vào tài liệu.
Một đối tượng values cho mẫu hóa đơn
JSON
{
"client_name": "Maple & Fern Ltd.",
"payment_terms": "Net 15",
"due_date": "10/15/2026",
"line_items": [
{ "item": "Brand identity system", "quantity": "1", "amount": "4800" },
{ "item": "Brand guidelines document", "quantity": "1", "amount": "1200" }
]
}