Собственные схемы
Когда вам нужно извлечь что-то из документа, что нет в системных схемах, вы определяете свою собственную.
Когда это имеет смысл
- Документ от одного поставщика с нестандартным макетом.
- Отраслевые особенности: весовые накладные, протоколы испытаний, топливные карты.
- Поля, которые вам нужны в вашей системе и нигде больше не встречаются.
Имейте в виду, что документ из собственной схемы нельзя отправить в бухгалтерию или
экспортировать в бухгалтерские форматы — те читают фиксированные поля счета. Остаются JSON, XML,
YAML, CSV, Excel и PDF. В отчеты учитывается только документ, у которого есть числовое поле
TotalAmount.
Как определяется
Редактором на вкладке Схемы. Пишется в формате JSON Schema — объект с properties,
у каждого поля type и description, списки как array с items. Кто знает стандарт,
не будет удивлен; кто нет, начнет с шаблона (счет, счет с НДС, чек,
товарная накладная, минимальный) или с копии системной схемы.
Ссылки, allOf, oneOf, условия и подобные конструкции редактор не пропустит; схема
должна быть плоским деревом полей. Копия системной схемы также содержит её задания
для модели, поэтому распознает так же хорошо, как и образец; нажатием кнопки Отключить
она превратится в обычную собственную схему.
Описание поля — это инструкция для модели
Это самая важная вещь на всей странице. description служит не только человеку,
но и модели. Разница между «номер заказа» и «номер заказа, начинается с Z- и имеет
шесть цифр, обычно находится в правом верхнем углу у штрих-кода» колоссальна
по успешности.
Ограничения
Количество полей определяется тарифом: 80 на Free и Starter, 160 на Business, 240 на Scale. Считаются также вложенные поля и поля элементов. Названия и описания отправляются модели у каждого документа, поэтому более длинная схема означает более дорогое обработка.
Тестирование
Редактор проверяет синтаксис непрерывно и не позволит сохранение, пока схема не будет корректной. Попробовать её можно только на реальном документе: загрузите его с выбранной схемой или у готового документа выберите Обработать снова. Оба варианта стоят кредитов, как обычная обработка.
Изменения и удаление
Измененная схема применяется к дальнейшей обработке. Документы, которые уже прошли, сохраняют данные так, как они были созданы. Схему, по которой был распознан хотя бы один документ, удалить нельзя — документы потеряют форму контроля.