Skip to content

Рассчитать checkout перед созданием записи

Request

Возвращает цену, фактически выбранного исполнителя и выбранный интервал для экрана подтверждения записи. Для услуги индивидуального мастера исполнитель определяется владельцем услуги. Для услуги салона master_user_id можно не передавать — тогда сервер случайно выбирает одного из назначенных на услугу мастеров, свободных на точный интервал. Если свободного исполнителя нет, возвращается 409 conflict.

executor.master_user_id необходимо передать в POST /api/record. Checkout не резервирует слот, поэтому создание записи повторно проверяет его доступность под блокировкой.

Для салонной услуги alternative_executors содержит остальных назначенных на услугу мастеров, свободных на запрошенный интервал. Выбранный executor в этом массиве не дублируется. Для салонной услуги без других доступных мастеров возвращается пустой массив, а для услуги индивидуального мастера — null.

price.items содержит упорядоченную историю изменения цены. Первый элемент всегда содержит базовую цену. Если действует акция, следующим элементом возвращается цена после скидки услуги и акции слота. Их проценты складываются (не более 100%). Эта публичная цена также доступна в price.service_price. После неё применяется не более одной реферальной скидки: выбирается наибольший процент между скидкой приглашённого бизнеса, купоном и постоянной скидкой за приглашения. При равенстве купон уступает постоянной скидке.

price.personal_discount описывает лучший личный купон либо постоянную скидку за приглашения. potential_amount показывает возможную экономию от service_price, а applied_amount — фактически применённую. При активной привязке клиента к этому мастеру либо к салону, оказывающему услугу, личная скидка не применяется: статус BLOCKED_BY_BUSINESS_BINDING, applied_amount: 0, final_price не уменьшается за её счёт. Привязка к другому бизнесу не блокирует скидку. Скидка услуги и акция слота продолжают действовать. Если выбрана большая скидка приглашённого бизнеса, личная скидка получает статус NOT_APPLIED_BETTER_DISCOUNT. При отсутствии личной скидки статус NOT_AVAILABLE.

Поле type предназначено для логики интерфейса, а description — для отображения причины изменения цены. Заблокированная личная скидка не добавляется в price.items. Расчёт не расходует купон и не создаёт запись. При создании записи скидки и привязка проверяются заново.

Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
service_idinteger, (int64), >= 1required
master_user_idinteger or null, (int64), >= 1

ID мастера салона. Передаётся только при записи на услугу салона.

startstring, (date-time)required

Время начала бронирования в формате ISO-8601. Должно быть раньше end.

Example:"2026-03-11T10:00:00Z"
endstring, (date-time)required

Время конца бронирования в формате ISO-8601. Максимальная длительность интервала - 24 часа.

Example:"2026-03-11T11:00:00Z"
client_commentstring or null, <= 1000 characters

Необязательный комментарий клиента. Сохраняется при создании записи и не может быть изменён.

Example:"Френч, короткие ногти"
curl -i -X POST \
  https://felmee.com/api/record/checkout \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "service_id": 20,
    "start": "2026-08-04T10:00:00Z",
    "end": "2026-08-04T11:00:00Z"
  }'

Responses

Checkout успешно рассчитан

Bodyapplication/json
codeErrorstring or nullrequired

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

successbooleanrequired

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

messagestringrequired

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

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"
dataobject or null(CheckoutData)required

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

Response
{ "success": true, "message": "Checkout successfully calculated", "codeError": null, "error_code": null, "data": { "price": { … }, "service": { … }, "executor": { … }, "alternative_executors": [ … ], "slot": { … } } }