Skip to content

Создать запрос на перенос записи

Request

Создаёт запрос на перенос существующей записи.

Перед созданием сервер проверяет:

  • корректность тела запроса
  • что запись с таким record_id существует
  • что текущий пользователь является исполнителем записи: индивидуальным мастером, владельцем салона или админом салона с правом RECORD_MANAGE
  • администратор с RECORD_MANAGE может указать released_slot_action=ACTION
  • что запись находится в статусе BOOKED
  • что до начала записи осталось не менее 1 часа
  • что для пары record_id + sender_id еще не существует запроса на перенос в статусе WAITING_APPROVE; для салона sender_id = salon_id
  • для selection_mode = FIXED — наличие new_start и new_end, корректность интервала и доступность выбранного слота; для салонной услуги также требуется master_user_id

Если selection_mode отсутствует, используется CLIENT_CHOICE. В этом режиме new_start, new_end и master_user_id при создании запроса передавать нельзя. Отсутствующий, равный null или 0 percent_compensation означает перенос без компенсации.

Запрос истекает в момент начала исходной записи. Оставшееся время в секундах возвращается в поле expires_in_seconds у request-сообщения и элемента списка заявок.

После создания в Messenger отправляется request-сообщение:

  • action = RESCHEDULE
  • source_request_id = reschedule_record_request.id
  • payload соответствует RescheduleRequestPayload

Требования:

  • требуется JWT
Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
record_idinteger, (int64), >= 1required

Идентификатор записи, для которой создается запрос на перенос.

Example:101
percent_compensationinteger or null, [ 0 .. 99 ]

Процент компенсации при переносе записи. Отсутствие, null или 0 означает отсутствие компенсации.

Example:15
selection_modestring or null

Режим выбора нового времени. При отсутствии поля или null используется CLIENT_CHOICE.

Enum:"CLIENT_CHOICE""FIXED"
new_startstring, (date-time)

Предложенное начало; обязательно только для FIXED.

new_endstring, (date-time)

Предложенное окончание; обязательно только для FIXED и должно быть позже new_start.

master_user_idinteger, (int64), >= 1

Исполнитель салонной услуги; обязателен только для FIXED с салонной услугой.

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

Percent action for the released slot. Allowed only when released_slot_action is ACTION.

Example:20
curl -i -X POST \
  https://felmee.com/api/record/reschedule \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "record_id": 101,
    "selection_mode": "CLIENT_CHOICE",
    "percent_compensation": 15,
    "released_slot_action": "ACTION",
    "released_slot_action_percent": 20
  }'

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": "Reschedule request created successfully", "codeError": null, "error_code": null, "data": null }