Mẫu tùy chỉnh

Khi bạn cần đọc dữ liệu từ tài liệu mà không có trong các mẫu hệ thống, hãy định nghĩa mẫu của riêng bạn.

Khi nào là ý nghĩa

• Tài liệu từ một nhà cung cấp có cấu trúc không chuẩn.
• Đặc thù ngành nghề: biên lai cân, biên bản thử nghiệm, thẻ nhiên liệu.
• Các trường mà bạn cần cho hệ thống của mình nhưng không xuất hiện ở nơi nào khác.

Hãy nhớ rằng tài liệu từ mẫu tùy chỉnh không thể gửi vào kế toán hay xuất sang định dạng kế toán — những định dạng này chỉ đọc các trường cố định của hóa đơn. Chỉ còn JSON, XML, YAML, CSV, Excel và PDF. Trong báo cáo chỉ tính đến tài liệu có trường số TotalAmount.

Cách định nghĩa

Bằng trình soạn thảo trong tab Mẫu. Viết theo JSON Schema — đối tượng với properties, mỗi trường có type và description, danh sách như array với items. Ai đã biết tiêu chuẩn sẽ không thấy bất ngờ; ai chưa, hãy bắt đầu từ mẫu (hóa đơn, hóa đơn có VAT, biên lai, phiếu giao hàng, tối thiểu) hoặc từ bản sao của mẫu hệ thống.

Các liên kết, allOf, oneOf, điều kiện và các cấu trúc tương tự không được phép trong trình soạn thảo; mẫu phải là cây phẳng của các trường. Bản sao của mẫu hệ thống cũng mang theo thông số cho mô hình, vì vậy nó nhận diện giống như mẫu; nút Ngắt kết nối khiến nó trở thành mẫu tùy chỉnh đơn giản.

Mô tả trường là hướng dẫn cho mô hình

Đây là điều quan trọng nhất trong toàn bộ trang. description không chỉ phục vụ cho con người, mà mô hình cũng đọc nó. Sự khác biệt giữa "số đơn hàng" và "số đơn hàng, bắt đầu bằng Z- và có sáu chữ số, thường ở góc trên bên phải của mã vạch" là rất lớn về mức độ thành công.

Giới hạn

Số lượng trường tùy thuộc vào gói: 80 cho Free và Starter, 160 cho Business, 240 cho Scale. Cũng tính đến các trường lồng và trường mục. Tên và mô tả được gửi đến mô hình với mỗi tài liệu, vì vậy mẫu dài hơn có nghĩa là xử lý tốn kém hơn.

Thử nghiệm

Trình soạn thảo liên tục kiểm tra cú pháp và không cho phép lưu nếu mẫu không khớp. Bạn chỉ có thể thử nghiệm trên tài liệu thực tế: tải lên với mẫu đã chọn, hoặc với tài liệu đã hoàn thành chọn Xử lý lại. Cả hai đều tốn tín dụng như xử lý thông thường.

Thay đổi và xóa

Mẫu đã chỉnh sửa sẽ áp dụng cho các xử lý tiếp theo. Các tài liệu đã qua xử lý giữ lại dữ liệu như đã tạo ra. Mẫu mà ít nhất một tài liệu đã được nhận diện không thể bị xóa — các tài liệu sẽ mất đi mẫu kiểm tra.