Перейти к основному содержимому

2026-07-29 - Автопроверка КП и спецификаций

Статус: Реализовано

Эпик: ITR-2822

Источник: Максим Марченко, Алексей (задача битрикс).

Цель​

Добавить в систему функционал правил, по которым КП и спецификации будут автоматически проверяться перед задачей согласования руководителем.

Если документ и данные заказа соответствуют настроенным правилам, система автоматически завершает задачу проверки и переводит процесс дальше. Если есть отклонения, задача остается у руководителя, а система показывает, какие именно условия не прошли проверку.

Основная идея: руководитель описывает типовые допустимые условия, а система снимает с него ручную проверку очевидно корректных документов.

Как будет работать​

Менеджер создает КП или спецификацию и отправляет документ на проверку. В этот момент система:

  1. Определяет тип документа: КП или спецификация.
  2. Проверяет, изменялся ли Google-документ после генерации.
  3. Загружает данные заказа покупателя, товары, покупателя, группу доступа покупателя, нашу организацию, ответственного и коммерческие условия.
  4. Находит все активные правила, которые подходят под этот заказ.
  5. Выполняет все проверки из найденных правил.
  6. Объединяет результаты проверок по параметрам.
  7. Если применилось хотя бы одно пользовательское правило, системная проверка документа пройдена и все итоговые проверки параметров пройдены — автоматически завершает задачу согласования.
  8. Если пользовательских правил не нашлось, есть отклонения или системная проверка не пройдена — оставляет задачу руководителю в статусе «Ожидает» и показывает результат проверки.

Автоматическое завершение не должно скрывать результат проверки. Для каждого запуска нужно сохранять, какие правила применились, какие значения были проверены и почему документ прошел или не прошел.

Системная проверка изменения документа​

Проверка изменения документа после генерации не настраивается пользователем в правилах. Это жесткая системная проверка.

После генерации КП или спецификации система сохраняет:

  • ссылку на Google-файл;
  • дату последнего изменения файла в Google Drive на момент генерации.

При отправке документа на проверку система повторно получает дату последнего изменения файла из Google Drive и сравнивает её с сохраненной датой.

Если файл был изменен после генерации, автопроверка считается не пройденной. Задача не согласовывается автоматически и остается у руководителя.

В результате проверки нужно показать причину:

Документ был изменён после генерации. Требуется ручная проверка руководителем.

Эта проверка должна отображаться в результате вместе с остальными проверками, но не должна быть доступна для редактирования в форме правил.

Системные проверки места производства (КП)​

Для КП дополнительно работают жёсткие системные проверки (не настраиваются в правилах). Подробнее: Место производства в заказе покупателя.

  1. Место производства заказа не совпадает с родной площадкой нашей организации (ЗМС → Глазов, остальные → Рязань).
  2. Включён ручной режим адреса базиса для самовывоза или 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, и в проде:

  1. Сущности правил и версий.
  2. Список и форма настройки правил для начальника менеджеров по продажам (/auto-check-rules).
  3. Backend-проверка правил при отправке КП или спецификации на согласование.
  4. Автоматическое завершение задачи согласования, если применилось хотя бы одно пользовательское правило и все проверки пройдены.
  5. Отображение результата проверки в задачах согласования КП и спецификации.
  6. История примененных правил, типов условий и фактических значений.

Не делалось (можно добавить позже при потребности):

  • черновики правил;
  • сложный приоритет правил;
  • сравнение версий в интерфейсе.