Проследите одну отмену по четырём точкам: выбор в форме, принятый сервером код, сохранённое событие и строка отчёта. Если статус уже «отменено», а причина пуста, повторное открытие формы не восстановит исходный выбор. Сначала найдите место потери; не заполняйте старые отмены самой популярной причиной ради красивой статистики.
Пустое значение скрывает разные исходы
| Ситуация | Как отличать в данных |
|---|---|
| Клиент указал причину | Стабильный код из разрешённого справочника |
| Клиент отказался отвечать | Явно не указана, если это допускает продукт |
| Администратор отменил запись | Инициатор и основание административного действия |
| Система отменила по правилу | Код правила, а не выдуманный ответ клиента |
| Старая запись без истории | Причина неизвестна |
Определите, обязательна ли причина для каждого пути отмены. Требование формы может отличаться для клиента, оператора и автоматики, но серверу нужны явные правила. Нельзя назвать причиной клиента техническое истечение удержания. Также не заставляйте пользователя описывать чувствительные личные обстоятельства в свободном поле, если для задачи достаточно нейтрального пункта.
Код причины живёт дольше подписи в интерфейсе
Храните стабильный код и при необходимости версию справочника или утверждённую подпись на момент события. Переименование пункта не должно незаметно менять смысл исторического отчёта. Удалённые варианты можно закрыть для нового выбора, сохранив их читаемость для старых отмен. Это рекомендация по модели данных, а не правило конкретной CRM.
Условное событие отмены:
booking_id -> отменяемая запись
operation_id -> одна команда, включая повтор
actor_type -> клиент / оператор / система
reason_code -> допустимый код либо явное unknown
result -> переход статуса действительно сохранён
reference -> версия справочникаСохраняйте причину рядом с успешным переходом статуса. В одной базе это удобно объединять транзакцией: PostgreSQL описывает её как согласованную операцию «всё или ничего», документация 18-й версии проверена 23 октября 2026 года. Само открытие формы или отправленный HTTP-запрос ещё не означает совершённую отмену. Отчёт должен опираться на зафиксированное событие.
Повтор команды после потери ответа не должен создавать вторую отмену и менять исходную причину по новому значению по умолчанию. Если допускается исправление причины оператором, оформите его отдельным действием с историей, правами и указанием основания. Иначе невозможно отличить ошибку клиента от последующей редакторской правки.
На границе API проверьте точное имя поля и допустимость кода. Форма может отправлять подпись, сервер ждать числовой ID, а импорт использовать устаревший список. Не пропускайте неизвестный код как успешный пустой ответ: верните понятную ошибку либо сохраните предусмотренный вариант «неизвестно» с техническим признаком проблемы. Выбор зависит от согласованного контракта.
Отчёт сверяется с реальными отменами
- Выполнить клиентскую отмену с искусственной причиной.
- Повторить ту же команду и проверить единственный итог.
- Отменить другую запись оператором и автоматическим правилом.
- Переименовать тестовый пункт и открыть старое событие.
- Сверить количество отмен и распределение причин за один период.
В отчёте отдельно показывайте долю неизвестных причин. Если аналитика исключает их из знаменателя, доли известных вариантов выглядят завышенными. Согласуйте также единицу подсчёта: отменённая запись, событие перехода или отдельная услуга составного визита. Несколько строк истории одной записи не должны случайно считаться несколькими потерянными визитами.
Для поиска ошибки подготовьте обезличенные форму запроса, сохранённое событие и одну строку отчёта с ожидаемым кодом. Исправление предотвращает новые потери; восстановление прошлых причин возможно лишь по достоверной истории. Если такой истории нет, честное «неизвестно» полезнее выдуманного объяснения, на котором потом строятся продуктовые решения.