Получение информации о заказе
Возвращает информацию о заказе по идентификатору.
Формат запроса
GET https://whitelabel.travel.yandex-net.ru/hotels/booking/orders/{order_id}
Параметры запроса
Параметр |
Тип |
Описание |
|
string |
Идентификатор заказа. |
* Обязательный параметр
Пример запроса
https://whitelabel.travel.yandex-net.ru/hotels/booking/orders/3aa8c5b7-aedf-448f-ae6c-55c76b690cfb
Формат ответа
{
"id": "(string)",
"number": "(string)",
"comment": "(string)",
"offer": {
"booking_token": "(string)",
"hotel": {
"hotel_id": "(string)",
"name": "(string)",
"location": {
"country_name": "(string)",
"settlement": {
"type": "(string)",
"name": "(string)"
},
"address": "(string)",
"lon": (double),
"lat": (double),
},
"phone": "(string)",
"stars": (integer),
"rating": (double),
"working_hours": "(string)",
"check_in": {
"from": "(string)",
"until": "(string)"
},
"check_out": {
"from": "(string)",
"until": "(string)"
},
"stay_instructions": ["(array of string)"],
"images": [
[
{
"href": "(string)",
"size": "(string)"
}
],
],
}
"room": {
"name": "(string)",
"descriptions": {
"overview": "(string)"
},
"amenities": [
{
"id": "(string)",
"name": "(string)"
}
],
"images": [
[
{
"href": "(string)",
"size": "(string)"
}
],
],
},
"bed_groups": [
{
"id": "(string)",
"description": "(string)"
}
],
"booking_request": {
"checkin_date": "(date)",
"checkout_date": "(date)",
"adults": (integer),
"children_ages": [(array of integer)],
},
"rate": {
"hotel_charges": {
"nightly": [
{
"base": {
"value": "(string)",
"currency": "(string)"
}
}
],
"daily": [],
"totals": {
"base": {
"value": "(string)",
"currency": "(string)"
},
"taxes_and_fees": {
"value": "(string)",
"currency": "(string)"
},
"discount": {
"value": "(string)",
"currency": "(string)"
},
"strike_through": {
"value": "(string)",
"currency": "(string)"
},
"grand": {
"value": "(string)",
"currency": "(string)"
}
}
},
"extra_charges": [
{
"type": "DEPOSIT",
"payable": {
"value": "(string)",
"currency": "(string)"
}
}
]
},
"meal_type": {
"id": "(string)",
"name": "(string)"
},
"cancellation": {
"refund_type": "(string)",
"refund_rules": [
{
"type": "(string)",
"penalty": {
"value": "(string)",
"currency": "(string)"
},
"starts_at": "(string)",
"ends_at": "(string)"
},
]
},
"legal": {
"hotel": {
"name": "(string)",
"ogrn": "(string)",
"actual_address": "(string)",
"legal_address": "(string)",
"working_hours": "(string)"
},
"yandex": {
"name": "(string)",
"ogrn": "(string)",
"actual_address": "(string)",
"legal_address": "(string)",
"working_hours": "(string)"
},
},
"deferred_payment_schedule": {
"initial_payment": {
"amount": {
"value": "(string)",
"currency": "(string)"
},
},
"deferred_payments": {
"zero_first_payment": (boolean),
"initial_payment": {
"amount": {
"value": "(string)",
"currency": "(string)"
}
},
"deferred_payments": [
{
"amount": {
"value": "(string)",
"currency": "(string)"
},
"deadline": "(string)",
"penalty_if_unpaid": {
"value": "(string)",
"currency": "(string)"
}
}
],
},
"all_guests_required": (boolean),
"latin_letters_required": (boolean),
"can_send_comment_to_hotel": (boolean)
},
"customer_email": "(string)",
"customer_phone": "(string)",
"guests": [
{
"first_name": "(string)",
"last_name": "(string)",
"age": (integer),
"is_child": (boolean)
}
],
"status": "(string)",
"cancellation_reason": "(string)",
"payments": [
{
"type": "(string)",
"state": "(string)",
"amount": {
"value": "(string)",
"currency": "(string)"
},
"url": "(string)",
"receipt": "(string)",
"deadline": "(string)",
"closed_at": "(string)"
}
],
"refunds": [
{
"receipt":
}
],
"price": {
"initial": {
"value": "(string)",
"currency": "(string)"
},
"final": {
"value": "(string)",
"currency": "(string)"
},
"discount": {
"amount": {
"value": "(string)",
"currency": "(string)"
}
}
},
"promo_code_application_results": [
{
"code": "(string)",
"status": "(string)",
"discount": {
"amount": {
"value": "(string)",
"currency": "(string)"
}
}
}
]
}
Параметры ответа
Параметр |
Тип |
Описание |
|
string |
Идентификатор заказа. |
|
string |
Номер заказа, который видит пользователь. Может использоваться для общения с техподдержкой или при заселении в отель. |
|
string |
Комментарий к заказу. |
|
object |
Информация по заказу. |
|
string |
Электронная почта клиента. |
|
string |
Телефон клиента. |
|
object |
Информация о гостях. |
|
string |
Статус заказа. Возможные значения:
|
|
string |
Причина отмены заказа. Возможные значения:
|
|
object |
Платежи. |
|
object |
Возвраты. |
|
object |
Стоимость заказа. |
offer object |
||
|
string |
Токен резервирования, который вернулся в ответе метода |
|
object |
Информация об отеле. |
|
object |
Информация о номере. |
|
object |
Возможные конфигурации кроватей в номере. |
|
object |
Информация о запросе на бронирование. |
|
object |
Информация о тарифах на номер. |
|
object |
Питание в отеле. |
|
object |
Правила отмены брони. |
|
object |
Юридическая информация — реквизиты сторон, участвующих в заказе. |
|
object |
График отложенных платежей — по предложению возможна рассрочка в соответствии с указанным графиком. Параметр может отсутствовать. |
|
boolean |
Требование указать всех гостей при бронировании. |
|
boolean |
Необходимость заполнять информацию о гостях латинскими буквами. |
|
boolean |
Есть возможность передать отелю комментарий при заказе. |
guests object |
||
|
string |
Имя. |
|
string |
Фамилия. |
|
string |
Возраст (только для детей). |
|
boolean |
Является ли ребенком. Возможные значения:
|
payments object |
||
|
string |
Тип платежа. Возможные значения:
|
|
string |
Состояние платежа. Возможные значения:
|
|
object |
Сумма оплаты. |
|
string |
Ссылка, по которой должен перейти пользователь для оплаты заказа. Параметр отсутствует, если платеж не был запущен. |
|
string |
Чек. Присутствует для оплаченных платежей. |
|
string |
Дата и время, до которых необходимо внести платеж, иначе заказ будет отменен. Указывается в формате UTC (стандарт ISO 8601): |
|
string |
Дата и время, когда платеж был оплачен или отменен, в формате UTC (стандарт ISO 8601): |
refunds object |
||
|
string |
Чек возврата. |
price object |
||
|
object |
Начальная стоимость заказа. |
|
object |
Итоговая стоимость заказа. |
|
object |
Размер скидки. |
|
object |
Результаты применения промокодов при создании заказа. |
hotel object |
||
|
string |
Идентификатор отеля. |
|
string |
Название отеля. |
|
object |
Географическое расположение отеля. |
|
string |
Телефон отеля. |
|
integer |
Количество звезд. Принимает значение от 1 до 5 или может отсутствовать. |
|
double |
Рейтинг отеля. Принимает значение от 1 до 5 в формате: дробное число, один знак после запятой, или может отсутствовать. |
|
string |
Информация о времени работы. |
|
object |
Время заезда в отель. |
|
object |
Время выезда из отеля. |
|
array |
Дополнительная информация, инструкции гостю на время пребывания в отеле. |
|
object |
Список изображений отеля. |
room object |
||
|
string |
Название номера. |
|
object |
Описание номера. |
|
object |
Удобства в номере и в отеле, связанные с номером. |
|
object |
Список изображений номера. |
bed_groups object |
||
|
string |
Идентификатор конфигурации кроватей в номере. |
|
string |
Описание конфигурации кроватей в номере. |
booking_request object |
||
|
date |
Дата заезда. |
|
date |
Дата выезда. |
|
integer |
Количество взрослых гостей. |
|
array |
Список возрастов детей. |
rate object |
||
|
object |
Информация о тарифах на номер. |
|
object |
Местные налоги и сборы, которые нужно оплатить в отеле. |
meal_type object |
||
|
string |
Код типа питания. Возможные значения:
|
|
string |
Название типа питания. |
cancellation object |
||
|
string |
Тип отмены брони. Возможные значения:
|
|
object |
Подробные правила отмены брони. |
legal object |
||
|
object |
Юридическая информация об отеле. |
|
object |
Юридическая информация о Яндексе. |
deferred_payment_schedule object |
||
|
boolean |
Начальный платеж (при заказе). |
|
object |
Данные о начальном платеже (при заказе). |
|
object |
Отложенные платежи. |
discount object |
||
|
object |
Сумма скидки. |
promo_code_application_results object |
||
|
string |
Промокод. |
|
string |
Статус применения промокода. Возможные значения:
|
|
string |
Сумма скидки. |
location object |
||
|
string |
Страна. |
|
object |
Населенный пункт. Параметр может отсутствовать для загородного отеля. |
|
string |
Адрес отеля. |
|
double |
Долгота координат отеля. |
|
double |
Широта координат отеля. |
check_in object |
||
|
string |
Время, начиная с которого возможно заселение в номер, в формате |
|
string |
Окончание заселения в формате |
check_out object |
||
|
string |
Время, начиная с которого можно сдать номер, в формате |
|
string |
Время, до которого необходимо сдать номер, в формате |
images object |
||
|
string |
Ссылка на изображение. |
|
string |
Сравнительный размер изображения. Возможные значения по возрастанию количества пикселей — |
descriptions object |
||
|
string |
Общее описание номера. |
amenities object |
||
|
string |
Идентификатор удобства (передается для целей отладки, персистентность не гарантируется). |
|
string |
Название удобства. |
hotel_charges object |
||
|
array |
Тип разбивки тарифа — по ночам, (если принцип ценообразования отеля «за ночь»). |
|
array |
Тип разбивки тарифа — по дням, (если принцип ценообразования отеля «за день»). |
|
object |
Итоговая цена за номер. |
extra_charges object |
||
|
string |
Тип сбора. Возможные значения:
|
|
object |
Сумма сбора. |
refund_rules object |
||
|
string |
Тип отмены брони. Возможные значения:
|
|
object |
Сумма, которая будет потеряна при отказе от брони в период действия правила.
Если тип отмены брони отличается от |
|
string |
Дата и время начала действия правила в формате UTC (стандарт ISO 8601): |
|
string |
Дата и время окончания действия правила в формате UTC (стандарт ISO 8601): |
hotel / yandex object |
||
|
string |
Название организации. |
|
string |
ОГРН. |
|
string |
Фактический адрес организации. |
|
string |
Юридический адрес организации. |
|
string |
Время работы. |
initial_payment object |
||
|
object |
Сумма платежа. |
deferred_payments object |
||
|
object |
Сумма платежа. |
|
string |
Дата и время, до которых необходимо внести платеж, иначе заказ будет отменен. Указывается в формате UTC (стандарт ISO 8601): |
|
object |
Штраф — будет вычтен из уже внесенной платы в случае отмены заказа при просрочке платежа. |
discount object |
||
|
object |
Сумма скидки. |
settlement object |
||
|
string |
Тип населенного пункта. Возможные значения:
|
|
string |
Название населенного пункта. |
nightly / daily object |
||
|
object |
Тариф. |
totals object |
||
|
object |
Базовая цена до налогов и дополнительных начислений. |
|
object |
Сумма включенных налогов и сборов. Параметр может отсутствовать. |
|
object |
Скидка. Параметр может отсутствовать, если скидок нет. |
|
object |
Цена до скидки (зачеркнутая цена). Параметр может отсутствовать, если скидок нет. |
|
object |
Окончательная сумма к оплате. |
base / taxes_and_fees_sum / discount / strike_through / grand / payable / penalty / amount / penalty_if_unpaid / initial object |
||
|
string |
Сумма. |
|
string |
Валюта. Возможное значение — |
Пример ответа
{
"id": "9065b145-79b9-4cd2-bb51-d1cfdf9f221b",
"number": "YA-7854-4868-0135",
"comment": "Был у вас в отеле. Пожалуйста, только не номер 123.",
"offer": {
"booking_token": "5DKLZ6eubchxwF...LilabAVGhtqSt7s96Ys",
"hotel": {
"hotel_id": "1019057204",
"name": "Марриотт Москва Гранд Отель",
"location": {
"country_name": "Россия",
"settlement": {
"type": "CITY",
"name": "Москва"
},
"address": "Москва, Тверская улица, 26/1",
"lon": 37.599343,
"lat": 55.768301
},
"phone": "+74959370000",
"stars": 5,
"rating": 4.9,
"working_hours": "ежедневно, круглосуточно",
"check_in": {
"from": "14:00",
"until": null,
},
"check_out": {
"from": null,
"until": "12:00",
},
"stay_instructions": ["В стоимость включены следующие услуги:\n - Посещение бассейна и фитнес-центра"],
"images": [
[
{
"href": "https://avatars.mds.yandex.net/get-altay/200322/2a0000015b0b6a243dc584f534df710b4480/S",
"size": "S"
},
{
"href": "https://avatars.mds.yandex.net/get-altay/200322/2a0000015b0b6a243dc584f534df710b4480/M",
"size": "M"
},
{
"href": "https://avatars.mds.yandex.net/get-altay/200322/2a0000015b0b6a243dc584f534df710b4480/L",
"size": "L"
}
],
]
},
"room": {
"name": "Делюкс, с двумя раздельными кроватями",
"descriptions": {
"overview": "Номер категории Делюкс это комфортный номер в классическом стиле площадью 31- 33 кв. м.\n\nВ номере вы найдете все необходимое для вашего проживания в отеле — удобное рабочее место, две больших кровати (135x190).\n\nВ номерах Делюкс есть набор для приготовления чая и кофе, мини-бар (за дополнительную плату) и телевизор размером 32 дюйма.\n\nВанная комната оборудована ванной, встроенной удобной раковиной, косметическим зеркалом и феном.\n\nВ каждом номере есть тапочки и халат, а также утюг с гладильной доской.\n\n- Обслуживание в номере, круглосуточно\n- Бесплатная бутылка воды для каждого гостя - обновляется по мере необходимости.\n- Максимальная вместимость номера - 3 гостя (стоимость указана за двухместное размещение, стоимость дополнительного спального места - 1500 руб.)\n- Есть смежные номера- предоставляется по запросу."
},
"amenities": [
{
"id": "44",
"name": "кабельное телевидение"
},
{
"id": "49",
"name": "унитаз"
},
{
"id": "36",
"name": "общественный бассейн"
},
],
"images": [
[
{
"href": "https://www.travelline.ru/resource/images/rt/170478/638070678517684700-f3d012f2-0039-4f2a-9feb-df7607585bb6",
"size": "S"
},
{
"href": "https://www.travelline.ru/resource/images/rt/170478/638070678517684700-f3d012f2-0039-4f2a-9feb-df7607585bb6",
"size": "M"
},
{
"href":"https://www.travelline.ru/resource/images/rt/170478/ 638070678517684700-f3d012f2-0039-4f2a-9feb-df7607585bb6",
"size": "L"
}
],
[
{
"href": "https://www.travelline.ru/resource/images/rt/170478/638070678626123082-f20fcfa5-1d37-46b4-92f5-43bd0bd07b1b",
"size": "S"
},
{
"href": "https://www.travelline.ru/resource/images/rt/170478/638070678626123082-f20fcfa5-1d37-46b4-92f5-43bd0bd07b1b",
"size": "M"
},
{
"href": "https://www.travelline.ru/resource/images/rt/170478/638070678626123082-f20fcfa5-1d37-46b4-92f5-43bd0bd07b1b",
"size": "L"
}
]
],
},
"bed_groups": [
{
"id": "0",
"description": "две двуспальные кровати"
}
],
"booking_request": {
"checkin_date": "2023-03-01",
"checkout_date": "2023-03-08",
"adults": 2,
"children_ages": [3,5],
},
"rate": {
"hotel_charges": {
"nightly": [
{
"base": {
"value": "7500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "7500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "7500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "6500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "6500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "6500.00",
"currency": "RUB"
}
},
{
"base": {
"value": "6500.00",
"currency": "RUB"
}
}
],
"daily": [],
"totals": {
"base": {
"value": "48500",
"currency": "RUB"
},
"taxes_and_fees_sum": {
"value": "0.00",
"currency": "RUB"
},
"discount": {
"value": "3500.00",
"currency": "RUB"
},
"strike_through": {
"value": "45000.00",
"currency": "RUB"
},
"grand": {
"value": "45000.00",
"currency": "RUB"
},
}
},
"extra_charges": [
{
"type": "DEPOSIT",
"payable": {
"value": "10000.00",
"currency": "RUB"
}
}
]
},
"meal_type": {
"id": "RO",
"name": "Без питания"
},
"cancellation": {
"refund_type": "FULLY_REFUNDABLE",
"refund_rules": [
{
"type": "FULLY_REFUNDABLE",
"penalty": null,
"starts_at": null,
"ends_at": "2023-02-28T11:00:00Z"
},
{
"type": "REFUNDABLE_WITH_PENALTY",
"penalty": {
"value": "7500.00",
"currency": "RUB"
},
"starts_at": "2023-02-28T11:00:00Z",
"ends_at": "2023-03-01T11:00:00Z"
},
{
"type": "NON_REFUNDABLE",
"penalty": null,
"starts_at": "2023-03-01T11:00:00Z",
"ends_at":
}
]
},
"legal": {
"hotel": {
"name": "АО \"ГРАНДЪ-ОТЕЛЬ\"",
"ogrn": "1027700465352",
"actual_address": "Москва, Тверская улица, 26/1",
"legal_address": "125009, Москва, Тверская улица, 26/1",
"working_hours": "ежедневно, круглосуточно"
},
"yandex": {
"name": "Сервис предоставляет ООО «Яндекс»",
"ogrn": "1027700229193",
"actual_address": null,
"legal_address": "119021, г. Москва, ул. Льва Толстого, д. 16",
"working_hours": "пн-пт: с 9:00 до 20:00 по местному времени, сб и вс: выходной"
}
},
"deferred_payment_schedule": {
"zero_first_payment": true,
"initial_payment": {
"amount": {
"value": "0.00",
"currency": "RUB"
},
},
"deferred_payments": [
{
"amount": {
"value": "48500.00",
"currency": "RUB"
},
"deadline": "2023-02-27T11:00:00Z",
"penalty_if_unpaid": {
"value": "0.00",
"currency": "RUB"
}
}
],
},
"all_guests_required": false,
"latin_letters_required": false,
"can_send_comment_to_hotel": true
},
"customer_email": "upalinski@yandex-team.ru",
"customer_phone": "+375447266562",
"guests": [
{
"first_name": "Иван",
"last_name": "Иванов",
"age": null,
"is_child": false
},
{
"first_name": "Екатерина",
"last_name": "Иванова",
"age": null,
"is_child": false
}
],
"status": "CONFIRMED",
"cancellation_reason": "MONEY_ACQUIRE_ERROR",
"payments": [
{
"type": "INITIAL",
"state": "PENDING",
"amount": {
"value": "12160.00",
"currency": "RUB"
},
"url": "https://trust-test.yandex.ru/web/payment?purchase_token=4fde2d1c3323ac9a3475d21b54c310f7",
"receipt": "https://trust-test.yandex.ru/checks/4fde2d1c3323ac9a3475d21b54c310f7/receipts/4fde2d1c3323ac9a3475d21b54c310f7?mode=mobile",
"deadline": "2023-02-24T20:59:00Z",
"closed_at": "2023-02-24T20:59:00Z",
}
],
"refunds": [
{
"receipt": "https://trust-test.yandex.ru/checks/4fde2d1c3323ac9a3475d21b54c310f7/receipts/4fde2d1c3323ac9a3475d21b54c310f7?mode=mobile",
}
],
"price": {
"initial": {
"value": "24320.00",
"currency": "RUB"
},
"final": {
"value": "23320.00",
"currency": "RUB"
},
"discount": {
"amount": {
"value": "1000.00",
"currency": "RUB"
}
},
},
"promo_code_application_results": [
{
"code": "EMAILDEC2O22I",
"status": "SUCCESS",
"discount": {
"amount": {
"value": "3500.00",
"currency": "RUB"
}
}
}
]
}
Идентификатор заказа.