2026-07-29 - Автопроверка КП и спецификаций
Статус: Реализовано
Эпик: ITR-2822
Источник: Максим Марченко, Алексей (задача битрикс).
Цель
Добавить в систему функционал правил, по которым КП и спецификации будут автоматически проверяться перед задачей согласования руководителем.
Если документ и данные заказа соответствуют настроенным правилам, система автоматически завершает задачу проверки и переводит процесс дальше. Если есть отклонения, задача остается у руководителя, а система показывает, какие именно условия не прошли проверку.
Основная идея: руководитель описывает типовые допустимые условия, а система снимает с него ручную проверку очевидно корректных документов.
Как будет работать
Менеджер создает КП или спецификацию и отправляет документ на проверку. В этот момент система:
- Определяет тип документа: КП или спецификация.
- Проверяет, изменялся ли Google-документ после генерации.
- Загружает данные заказа покупателя, товары, покупателя, группу доступа покупателя, нашу организацию, ответственного и коммерческие условия.
- Находит все активные правила, которые подходят под этот заказ.
- Выполняет все проверки из найденных правил.
- Объединяет результаты проверок по параметрам.
- Если применилось хотя бы одно пользовательское правило, системная проверка документа пройдена и все итоговые проверки параметров пройдены — автоматически завершает задачу согласования.
- Если пользовательских правил не нашлось, есть отклонения или системная проверка не пройдена — оставляет задачу руководителю в статусе «Ожидает» и показывает результат проверки.
Автоматическое завершение не должно скрывать результат проверки. Для каждого запуска нужно сохранять, какие правила применились, какие значения были проверены и почему документ прошел или не прошел.
Системная проверка изменения документа
Проверка изменения документа после генерации не настраивается пользователем в правилах. Это жесткая системная проверка.
После генерации КП или спецификации система сохраняет:
- ссылку на Google-файл;
- дату последнего изменения файла в Google Drive на момент генерации.
При отправке документа на проверку система повторно получает дату последнего изменения файла из Google Drive и сравнивает её с сохраненной датой.
Если файл был изменен после генерации, автопроверка считается не пройденной. Задача не согласовывается автоматически и остается у руководителя.
В результате проверки нужно показать причину:
Документ был изменён после генерации. Требуется ручная проверка руководителем.
Эта проверка должна отображаться в результате вместе с остальными проверками, но не должна быть доступна для редактирования в форме правил.
Системные проверки места производства (КП)
Для КП дополнительно работают жёсткие системные проверки (не настраиваются в правилах). Подробнее: Место производства в заказе покупателя.
- Место производства заказа не совпадает с родной площадкой нашей организации (ЗМС → Глазов, остальные → Рязань).
- Включён ручной режим адреса базиса для самовывоза или FCA ДЛ.
При срабатывании любой из них автосогласование КП блокируется; причина видна в результате проверки.
Правила дополняют друг друга
Правила не выбираются по принципу "нашли одно самое подходящее и применили только его". Они работают как набор ограничений, которые дополняют друг друга.
Например:
- правило для всех заказов: предоплата должна быть не меньше 30%;
- правило для выбранного покупателя: отсрочка финального платежа не больше 10 дней;
- правило для изделий выбранного типа: скидка по товару не больше 7%.
Если заказ подходит под все три правила, система применит все три проверки одновременно.
Итог считается не только по каждому правилу отдельно, а по проверяемым параметрам. Для этого у каждой проверки внутри правила есть тип условия:
- разрешающее условие;
- запрещающее условие.
Так не нужно определять, какое правило специфичнее. Общие и частные правила применяются вместе, а итог по одинаковым параметрам считается по понятному правилу объединения.
Разрешающие и запрещающие условия
Тип условия задается у каждой проверки внутри правила.
Разрешающее условие
Если по этому параметру есть несколько подходящих условий, достаточно пройти хотя бы одно из них.
Пример:
- общее правило: скидка по товару не больше 10%;
- правило для выбранного покупателя: скидка по товару не больше 15%.
Если заказ подходит под оба правила, а скидка по товару 12%, итоговая проверка скидки проходит: одно из разрешающих условий выполнено.
Запрещающее условие
Если по этому параметру есть несколько подходящих условий, необходимо пройти каждое из них.
Пример:
- одно правило требует доставку за наш счет = нет;
- другое правило также проверяет доставку или связанные условия.
Если по параметру есть несколько запрещающих условий, каждое из них должно быть выполнено.
Если по одному параметру есть и разрешающие, и запрещающие условия, итог считается так:
1. Все запрещающие условия должны быть пройдены.
2. Если есть разрешающие условия, должно быть пройдено хотя бы одно из них.
То есть:
- разрешающие условия объединяются как
ИЛИ; - запрещающие условия объединяются как
И; - системная проверка изменения документа всегда работает как обязательное условие и не может быть расширена пользовательскими правилами.
Параметры группируются по:
- проверяемому параметру;
- области проверки: заказ или товар;
- товару, если проверка товарная.
Например, скидка по двум разным товарам считается отдельно для каждого товара.
Фильтры применения правила
Фильтры определяют, подходит ли правило к заказу и документу.
Тип документа
значения: КП / Спецификация
Покупатели
значения: все / выбранные покупатели
Исключить покупателей
значения: выбранные покупатели
используется только если основной фильтр Покупатели установлен в значение все
Группа доступа покупателя
значения: все / выбранные группы доступа
правило применяется по группе доступа покупателя заказа: BuyerOrder.ContactPerson.Partner.AccessGroupId
Товар
значения: все / выбранные категории / выбранные типы складских единиц
правило применяется, если в заказе есть хотя бы один товар указанной категории или типа (товарные проверки выполняются по этим подходящим товарам)
Наши организации
значения: все / выбранные организации
Наличие КД
значения: все / есть / нет
есть - КД есть у всех изделий заказа
нет - хотя бы у одного изделия заказа КД нет
Наличие модификации
значения: все / есть / нет
есть - хотя бы у одного товара заказа есть модификация
нет - ни у одного товара заказа нет модификации
Ответственный
значения: все / выбранные сотрудники
Исключения на первом этапе нужны только для покупателей. Покупателей много, поэтому сценарий “для всех, кроме выбранных” будет удобен. Для ответственных, наших организаций, категорий и типов товаров исключения не добавляются: в этих фильтрах проще явно выбрать нужные значения.
Валюту, сумму заказа как фильтр и дополнительные признаки модификации можно добавить позже, если появится понятный сценарий использования.
Для одинаковых проверяемых параметров не выбирается "более точное" правило. Итог определяется типом условия: разрешающие условия расширяют допустимые варианты, запрещающие условия задают обязательные ограничения.
Проверяемые параметры заказа
Предоплата %
источник: BuyerOrder.OrderPayment.AdvancePaymentPercent
тип: число / процент
операторы: =, >=, <=, between
пример: предоплата должна быть не меньше 30%
Оплата перед отгрузкой %
источник: BuyerOrder.OrderPayment.PaymentBeforeShipmentPercent
тип: число / процент
операторы: =, >=, <=, between
пример: перед отгрузкой должно быть не меньше 50%
Постоплата, %
источник: остаток оплаты после предоплаты и оплаты перед отгрузкой (100 − Advance − BeforeShipment)
тип: число / процент
операторы: =, >=, <=, between
пример: постоплата не должна быть больше 20%
Отсрочка финального платежа, дней
источник: BuyerOrder.OrderPayment.DelayInDays
тип: число / дни
операторы: =, >=, <=, between
пример: отсрочка финального платежа не должна быть больше 30 дней
Сумма заказа
источник: BuyerOrder.Goods.Sum(g => g.FinalPrice * g.Count) по неархивным товарам
тип: число / деньги
операторы: =, >=, <=, between
пример: сумма заказа должна быть не меньше 100 000
Общая скидка по заказу
источник: вычисляемое значение: 1 - сумма заказа / сумма РРЦ товаров
тип: число / процент
операторы: =, >=, <=, between
пример: общая скидка по заказу не должна быть больше 15%
Доставка за наш счет
источник: BuyerOrder.OrderPayment.DeliveryOurExpense
тип: boolean
операторы: =
пример: доставка за наш счет запрещена
Доставка включена в цену
источник: BuyerOrder.OrderPayment.ShippingIncludedInPrice
тип: boolean
операторы: =
пример: доставка должна быть включена в цену
НДС
источник: BuyerOrder.OrderPayment.ValueAddedTax
тип: число / процент
операторы: =, in
пример: НДС должен быть 20%
Срок изготовления
источник: BuyerOrder.OrderShipment.ManufactureTimeInDays
тип: число / дни
операторы: =, >=, <=, between
пример: срок изготовления без КД должен быть не меньше 20 рабочих дней
Проверяемые параметры товара
Проверки по товарам выполняются не по всем товарам заказа, а по тем товарам, которые подходят под товарные фильтры правила.
Скидка % по товару
источник: вычисляемое значение: 1 - Good.Price / (Good.RecommendedRetailPrice ?? Good.StockKeepingUnit.RecommendedRetailPrice)
тип: число / процент
операторы: =, >=, <=, between
пример: скидка по товару не должна быть больше 10%
Цена товара
источник: BuyerOrder.Goods[].Price
тип: число / деньги
операторы: =, >=, <=, between
пример: цена товара должна быть не ниже 5 000
Сумма товара
источник: BuyerOrder.Goods[].FinalPrice * BuyerOrder.Goods[].Count
тип: число / деньги
операторы: =, >=, <=, between
пример: сумма по позиции должна быть не меньше 20 000
Для скидки по товару важно использовать цену без распределенной доставки. Если доставка включена в цену, FinalPrice может отличаться от Price, поэтому скидку лучше считать от Good.Price.
Версионность правил
Версионность правил нужна, чтобы результат проверки оставался понятным после изменения настроек.
Предлагаемая модель:
- правило хранит признак активности;
- при создании правила создается первая версия;
- при изменении правила создается новая версия;
- актуальная версия определяется как последняя неархивная версия правила;
- старые версии остаются в истории;
- черновики не нужны: если запрос на изменение пришел на backend, правило считается обновленным.
При каждом запуске автопроверки нужно сохранять:
- версию правила;
- название правила на момент проверки;
- проверяемый параметр;
- тип условия: разрешающее или запрещающее;
- ожидаемое значение;
- фактическое значение;
- результат проверки;
- текст причины, если проверка не пройдена.
Это позволит открыть задачу согласования и увидеть не просто "автопроверка не пройдена", а конкретные отклонения.
Интерфейс настройки правил
Настройку правил стоит сделать простой и предсказуемой.
В списке правил пользователь видит:
- название;
- активность;
- тип документа;
- краткое описание фильтров;
- краткое описание проверок;
- дату последнего изменения;
- автора последнего изменения.
В форме правила пользователь заполняет:
- название;
- активность;
- фильтры применения;
- список проверок.
Проверку лучше добавлять строками:
Параметр: Скидка % по товару
Тип условия: Разрешающее
Оператор: <=
Значение: 10
По умолчанию новая проверка создается как разрешающее условие.
Подсказки в форме:
Разрешающее- если по этому параметру есть несколько подходящих условий, достаточно пройти хотя бы одно из них.Запрещающее- если по этому параметру есть несколько подходящих условий, необходимо пройти каждое из них.
Для boolean-параметров поле значения должно быть переключателем, для числовых параметров - числовым вводом, для between - двумя числовыми полями.
Результат проверки в задаче
Если проверка прошла успешно и задача завершилась автоматически, в истории задачи нужно показать, что документ прошел автопроверку.
Если проверка не прошла, руководитель должен видеть итог по параметрам и список отклонений.
Верх блока:
Автопроверка: не пройдена
Проверено параметров: 12
Пройдено: 10
Требует проверки: 2
Для каждого параметра нужно показывать:
- параметр;
- тип итогового результата;
- ожидаемое значение;
- фактическое значение;
- товар, если проверка товарная;
- комментарий системы.
В раскрытии параметра нужно показывать проверки из правил, которые повлияли на итог:
- правило;
- тип условия: разрешающее или запрещающее;
- ожидаемое значение;
- фактическое значение;
- результат проверки;
- комментарий системы.
Пример:
Параметр: Скидка % по товару
Итог: пройдена
Фактически: 12%
Комментарий: пройдено одно из разрешающих условий
Правило: Магнитные системы
Тип условия: Разрешающее
Параметр: Скидка % по товару
Ожидалось: <= 10%
Фактически: 12%
Результат: не пройдена
Правило: Исключение для выбранных покупателей
Тип условия: Разрешающее
Параметр: Скидка % по товару
Ожидалось: <= 15%
Фактически: 12%
Результат: пройдена
Если документ был изменен после генерации, это должно быть видно отдельной системной строкой результата:
Правило: Системная проверка документа
Параметр: Изменение документа после генерации
Итог: не пройдена
Комментарий: Документ был изменён после генерации. Требуется ручная проверка руководителем.
Минимальный первый этап
Первый этап реализован и на stage, и в проде:
- Сущности правил и версий.
- Список и форма настройки правил для начальника менеджеров по продажам (
/auto-check-rules). - Backend-проверка правил при отправке КП или спецификации на согласование.
- Автоматическое завершение задачи согласования, если применилось хотя бы одно пользовательское правило и все проверки пройдены.
- Отображение результата проверки в задачах согласования КП и спецификации.
- История примененных правил, типов условий и фактических значений.
Не делалось (можно добавить позже при потребности):
- черновики правил;
- сложный приоритет правил;
- сравнение версий в интерфейсе.