Структура ответа#
Детальное описание структуры ответа от /hotels/cancel_booking.
Основная структура#
| Поле | Тип | Обязательно | Описание |
|---|
canceledAtUtc | datetime | Да | Дата и время отмены (ISO 8601, UTC) |
amounts | CancellationAmounts | Нет | Разбивка сумм по отмене |
Структура CancellationAmounts#
| Поле | Тип | Описание |
|---|
original | Money | Исходная стоимость бронирования |
refunded | Money | Сумма возврата |
penalty | Money | Сумма штрафа за отмену |
Примеры ответов#
Бесплатная отмена#
1{
2 "canceledAtUtc": "2025-11-25T14:30:00+00:00",
3 "amounts": {
4 "original": {
5 "amount": 15000.00,
6 "currency": "RUB"
7 },
8 "refunded": {
9 "amount": 15000.00,
10 "currency": "RUB"
11 }
12 }
13}
Отмена со штрафом#
1{
2 "canceledAtUtc": "2025-12-14T10:00:00+00:00",
3 "amounts": {
4 "original": {
5 "amount": 15000.00,
6 "currency": "RUB"
7 },
8 "refunded": {
9 "amount": 10000.00,
10 "currency": "RUB"
11 },
12 "penalty": {
13 "amount": 5000.00,
14 "currency": "RUB"
15 }
16 }
17}
Невозвратная отмена#
1{
2 "canceledAtUtc": "2025-12-15T08:00:00+00:00",
3 "amounts": {
4 "original": {
5 "amount": 15000.00,
6 "currency": "RUB"
7 },
8 "penalty": {
9 "amount": 15000.00,
10 "currency": "RUB"
11 }
12 }
13}
Ответ с ошибкой#
1{
2 "error": {
3 "code": "BOOKING_NOT_FOUND",
4 "message": "Бронирование не найдено",
5 "description": "Бронирование с указанным идентификатором не найдено",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|
BOOKING_NOT_FOUND | Бронирование не найдено или не принадлежит клиенту | Проверьте корректность bookingId |
VALIDATION_FAILED | Ошибка валидации запроса | Проверьте обязательные поля |
CANCEL_FAILED | Поставщик не смог отменить бронирование | Повторите запрос позже |
CANCELLATION_FAILED | Отмена отклонена поставщиком | Повторите запрос позже или обратитесь в поддержку |
SUPPLIER_ERROR | Поставщик вернул ошибку | Повторите запрос позже |
TIMEOUT | Превышено время ожидания ответа от поставщика | Повторите запрос позже |
INTERNAL_ERROR | Внутренняя ошибка сервера | Обратитесь в поддержку |
Связанные операции#