Sơ đồ tùy chỉnh

Khi bạn cần đọc thông tin từ tài liệu mà không có trong các sơ đồ hệ thống, bạn sẽ định nghĩa một sơ đồ riêng.

Khi nào điều này có ý nghĩa

• Tài liệu từ một nhà cung cấp với bố cục không chuẩn.
• Đặc điểm ngành: vé cân, biên bản thử nghiệm, thẻ nhiên liệu.
• Trường mà bạn cần trong hệ thống của mình và không xuất hiện ở nơi khác.

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

Cách định nghĩa

Bằng trình biên tập trong tab Sơ đồ. Viết bằng JSON Schema — một đối tượng với properties, mỗi trường có type và description, danh sách được thể hiện dưới dạng array với items. Những ai biết về tiêu chuẩn sẽ không bị bất ngờ; những ai không biết có thể bắt đầu từ mẫu (hóa đơn, hóa đơn VAT, biên lai, phiếu giao hàng, tối thiểu) hoặc từ bản sao của sơ đồ hệ thống. Các trường trong mẫu có tên bằng tiếng Anh giống như sơ đồ hệ thống, vì vậy biểu mẫu kiểm tra sẽ tìm thấy mô tả; mô tả các trường bằng ngôn ngữ giao diện và có thể được ghi đè.

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 trình biên tập cho phép; sơ đồ phải là một cây phẳng các trường. Bản sao của sơ đồ hệ thống cũng mang theo yêu cầu của nó cho mẫu, do đó nhận diện cũng tốt như mẫu; nhấn nút Ngắt kết nối và nó trở thành sơ đồ tùy chỉnh thông thường.

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

Đây là điều quan trọng nhất trên toàn trang. description không chỉ phục vụ cho con người, mà mẫu 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 nằm ở góc trên bên phải gần mã vạch" là rất lớn trong khả năng thành công.

Giới hạn

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

Thử nghiệm

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

Thay đổi và xóa bỏ

Sơ đồ đã chỉnh sửa có hiệu lực cho các xử lý tiếp theo. Các tài liệu đã qua xử lý sẽ giữ dữ liệu như đã được tạo ra. Sơ đồ mà theo đó í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 biểu mẫu kiểm tra.