Параметры запроса

Mon, 01 Jan 0001 00:00:00 +0000

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/cancel_booking.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`bookingId`	guid	Да	Идентификатор бронирования для отмены (формат UUID)
`language`	string	Да	Язык ответа (например `ru`, `en`)

Примеры запросов#

curl

1curl -X POST https://test.travel-api.ru/hotels/cancel_booking \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
6 "language": "ru"
7 }'

 1var request = new CancelBookingRequest
 2{
 3 BookingId = Guid.Parse("019a0c82-5d2b-7a5e-84fe-56357a57df66"),
 4 Language = "ru"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8 "https://test.travel-api.ru/hotels/cancel_booking",
 9 request
10);
11
12var result = await response.Content.ReadFromJsonAsync<CancelBookingResponse>();

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

Mon, 01 Jan 0001 00:00:00 +0000

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

Детальное описание структуры ответа от /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`	Внутренняя ошибка сервера	Обратитесь в поддержку

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

Просмотр бронирования — проверка условий отмены до отмены
Поиск бронирований — поиск бронирований по статусу

Отмена бронирования on Travel API - Документация

Параметры запроса

Параметры запроса#

Параметры запроса#

Примеры запросов#

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

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

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

Структура CancellationAmounts#

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

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

Отмена со штрафом#

Невозвратная отмена#

Ответ с ошибкой#

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

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