Отменяет существующую запись без физического удаления. Сервер переводит запись в статус CANCELED.
Перед отменой сервер проверяет:
- корректность тела запроса
- что
idявляется положительным числом - что запись с таким
idсуществует - что запись находится в статусе
BOOKEDи текущее время строго меньше времени начала - с момента начала включительно обычная отмена запрещена для всех инициаторов этого endpoint: например, при начале в 12:00 отмена в 12:00 уже возвращает 409
- ограничение повторно проверяется под блокировкой записи перед изменениями и расчётом возврата
- что текущий пользователь имеет доступ к этой записи
- размер возврата определяется активными правилами отмены для роли инициатора и количеством полных часов до начала записи; используются правила из базы данных
Правила доступа:
- роль
USERможет отменить только свою запись - роль
MASTERможет отменить только запись, принадлежащую этому мастеру - владелец салона может отменить запись мастера своего салона
- администратор салона может отменить запись мастера своего салона с правом
RECORD_MANAGE - право
RECORD_MANAGEтакже позволяет администратору указатьreleased_slot_action=ACTION - при отмене мастером или салоном применяется одинаковое правило процента возврата для роли
MASTER; фактический процент зависит от настроенной таблицы правил. При положительной стоимости и положительной рассчитанной сумме возврата публикуетсяCancelRecordRefundEvent; наличиеpaid_atне проверяется - отдельного запрета отмены клиентом менее чем за 12 часов до начала нет; отмена возможна вплоть до момента начала, не включая сам момент начала
При отмене ожидающие запросы переноса и доплаты этой записи переводятся в EXPIRED. После коммита обновляются соответствующие request-сообщения чата, создаются результаты истечения и отправляется /user/queue/chat.update_status_request с new_status=EXPIRED. Повторная обработка не создаёт дубликатов перехода. Проверка истечения повторяется после асинхронного создания сообщения, если отмена опередила появление предложения в чате.
Требования:
- требуется JWT
Необязательный комментарий к отмене записи. Если поле передано, строка не должна быть пустой или состоять только из пробелов.
- https://felmee.comhttps://felmee.com/api/record/{id}/cancel
- http://localhost:8080http://localhost:8080/api/record/{id}/cancel
curl -i -X POST \
https://felmee.com/api/record/101/cancel \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"comment": "Client requested cancellation"
}'Запись успешно отменена
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "success": true, "message": "Record canceled successfully", "codeError": null, "error_code": null, "data": null }