Отмена возврата не всегда означает «вернуть заказ в прежний статус». Если деньги уже ушли клиенту или товар принят на склад, простой откат поля order.status создаст ещё большую ошибку. Сначала нужно понять, на каком шаге остановился процесс.

Возьмите один заказ и разложите его на четыре независимых состояния: заявка клиента, движение товара, платёж и документы. Только после этого становится видно, какой статус заказа действительно возможен.

Одна отмена — три разных ситуации

Момент отменыЧто уже произошлоОжидаемое действие
До одобренияНет движения денег и товараЗакрыть заявку, заказ оставить завершённым
После одобрения, до выплатыТовар мог быть зарезервирован к приёмкеСнять резерв и отменить refund intent
После выплатыДеньги возвращеныНе откатывать историю; нужен отдельный корректирующий процесс

Эта таблица должна быть бизнес-правилом, а не догадкой обработчика интерфейса. Если отмена разрешена только до определённой точки, кнопка и API обязаны применять одно условие.

Найдите первое событие, которое система проигнорировала

Соберите timeline по return_id и order_id. Нужны время, предыдущий и новый статус, инициатор, idempotency key и результат обработчика. Полезнее найти первое расхождение, чем смотреть на последнюю ошибку в очереди.

10:02 return.requested
10:05 return.approved
10:07 refund.created
10:08 return.cancel_requested
10:08 refund.cancelled
10:09 order.recalculate_state  <-- отсутствует или завершился ошибкой

Если событие есть в брокере, но нет записи обработчика, проверьте routing key и consumer group. Если запись есть, но order.version не изменилась, вероятен конфликт оптимистической блокировки. Если заказ обновился, но интерфейс показывает старое, ищите кеш или read model.

Не делайте статус заказа копией статуса заявки

У заявки на возврат может быть состояние cancelled, у платежа — succeeded, у товарной позиции — received. Уместить такую комбинацию в одно поле заказа невозможно без потери смысла. Заказу лучше показывать вычисляемый сводный статус, а исходные факты хранить отдельно и неизменяемо.

  • Return request отвечает за решение и причину отмены.
  • Refund отвечает за реальное движение денег у провайдера.
  • Inventory movement отвечает за приёмку и возврат товара в остатки.
  • Order projection собирает понятное пользователю представление из этих фактов.

Как исправлять старые заказы

Не запускайте массовый UPDATE по одному статусу. Сначала подготовьте dry-run: order_id, четыре исходных состояния, вычисленный итог и причина изменения. Отдельно выделите заказы, где платёж уже завершён или документы выпущены — их нельзя автоматически вернуть в обычное состояние.

Корректор должен быть идемпотентным: повторный запуск не создаёт новый refund, складское движение или письмо. После обработки сохраните отчёт с количеством изменённых и пропущенных записей.

Четыре теста перед выпуском

  1. Отмена до одобрения закрывает только заявку.
  2. Отмена после создания, но до выполнения refund корректно отменяет намерение.
  3. Поздняя отмена возвращает понятный отказ и не переписывает историю.
  4. Повтор одного и того же события не меняет заказ второй раз.

Если статусы уже разошлись, для технического разбора нужны обезличенный timeline, правила допустимых переходов и ответы платёжного провайдера. Этого достаточно, чтобы найти разрыв без ручного редактирования production-заказа.