Skip to content

Отменить запись

Request

Отменяет существующую запись без физического удаления. Сервер переводит запись в статус 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
Security
bearerAuth or jwtCookie
Path
idinteger, (int64), >= 1required

Идентификатор записи.

Example:101
Bodyapplication/jsonrequired
commentstring or null, [ 1 .. 500 ] characters.*\S.*

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

released_slot_actionstring(ReleasedSlotAction)
Default:"NONE"
Enum:"NONE""BLOCK""ACTION"
released_slot_action_percentinteger or null, [ 1 .. 99 ]

Процент акции для освободившегося слота. Обязателен при released_slot_action=ACTION; при других значениях передавать его нельзя.

Example:20
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"
  }'

Responses

Запись успешно отменена

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

Example:null
successbooleanrequired

Флаг успешного выполнения запроса

Example:true
messagestringrequired

Человекочитаемое описание результата

Example:"OK"
error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Example:null
dataany or nullrequired

Полезная нагрузка. Может быть объектом, массивом или null.

Example:null
Response
{ "success": true, "message": "Record canceled successfully", "codeError": null, "error_code": null, "data": null }