Структура ответа#

Детальное описание структуры ответа от /hotels/cancel_booking.

Основная структура#

ПолеТипОбязательноОписание
canceledAtUtcdatetimeДаДата и время отмены (ISO 8601, UTC)
amountsCancellationAmountsНетРазбивка сумм по отмене

Структура CancellationAmounts#

ПолеТипОписание
originalMoneyИсходная стоимость бронирования
refundedMoneyСумма возврата
penaltyMoneyСумма штрафа за отмену

Примеры ответов#

Бесплатная отмена#

 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": "Booking not found",
5    "description": "Booking not found"
6  }
7}

Типичные ошибки TAPI#

Код ошибкиПричинаРешение
BOOKING_NOT_FOUNDБронирование не найдено, не принадлежит клиенту или не является отельнымПроверьте корректность bookingId
VALIDATION_ERRORОшибка валидации запросаПроверьте обязательные поля и форматы значений

Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.

Связанные операции#