Актуализация предложения¶
Общие положения¶
Endpoint: /api/HotelOfferPrice
Для получения полной детализации предложения, уточнения доступности и актуальной стоимости перед бронированием используется метод Mixvel_HotelOfferPriceRQ. Этот шаг не является обязательным, но рекомендуется для перепроверки доступности оффера перед бронированием. После получения подходящего оффера в ответе Mixvel_HotelPageRS можно сразу переходить к бронированию, однако пропуск шага Mixvel_HotelOfferPriceRQ не рекомендован.
Примечание: Метод Mixvel_HotelOfferPriceRQ отличается от метода Mixvel_OfferPriceRQ.
Структура запроса¶
Входные данные запроса должны соответствовать схеме Mixvel_HotelOfferPriceRQ.xsd и содержать следующие основные параметры (полные параметры доступны в XSD-схеме или в XML-примерах конкретного сообщения):
| XPath параметра | Пример заполнения | Описание | Комментарии |
|---|---|---|---|
| Mixvel_HotelOfferPriceRQ/ PayloadAttributes/ PrimaryLangID | RU | Язык, на котором возвращаются данные из справочников | В MixVel сейчас доступны ответы только на русском языке. |
| Mixvel_HotelOfferPriceRQ/ Request/ SelectedHotelOffer/ OfferRefID | 3ad4ef0e-e6ed-4404-bbb0-95b58330226e | Ссылка на идентификатор интересующего оффера |
Пример запроса Mixvel_HotelOfferPriceRQ:
Показать пример запроса
<MixEnv:Envelop xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelop/1_06">
<Header/>
<Body>
<MessageInfo MessageId="79b67a26-6fc3-41e3-0ac4-14e0ac0245c8" TimeSent="2025-09-18T03:04:38.6129323Z"/>
<AppData>
<Mixvel_HotelOfferPriceRQ xmlns="https://www.mixvel.com/API/XSD/Mixvel_HotelOfferPriceRQ/1_00">
<Request>
<SelectedHotelOffer>
<OfferRefID>3ad4ef0e-e6ed-4404-bbb0-95b58330226e</OfferRefID>
</SelectedHotelOffer>
</Request>
</Mixvel_HotelOfferPriceRQ>
</AppData>
</Body>
</MixEnv:Envelop>
Структура ответа¶
Основная часть информации по конкретному офферу в Mixvel_HotelOfferPriceRS дублирует данные из Mixvel_HotelPageRS. Ответ системы соответствует схеме Mixvel_HotelOfferPriceRS.xsd и содержит основные данные (в таблице ниже приведены ключевые параметры сообщения; полный список доступен в XSD-схеме или XML-примерах).
В блоке Hotel ответа Mixvel_HotelOfferPriceRS повторяется информация об отеле, ранее полученная в Mixvel_HotelPageRS. Основные сведения по офферу также дублируются из Mixvel_HotelPageRS в структуре:
- Mixvel_HotelOfferPriceRS/Response/OfferPage/Provider/Offer
В таблице ниже перечислены поля, уникальные для Mixvel_HotelOfferPriceRS, которые отсутствуют в Mixvel_HotelPageRS.
| XPath параметра | Пример заполнения | Описание | Комментарии |
|---|---|---|---|
| Mixvel_HotelOfferPriceRS/ Response/ OfferPage/ Provider/ Offer/ OfferChangesAvailable/OfferChange | NUMBER_OF_GUESTS | Список доступных к изменению полей | Передаются текстом. |
| Mixvel_HotelOfferPriceRS/ Response/ OfferPage/ Provider/ Offer/ OfferPolicies/ MarkUp | complex | Возможность изменений тарифа | Структура, см. ниже. |
| …/ CanUseSellingPrice | true | Флаг, что отель может поменять (в большую или меньшую сторону) предложенный тариф | |
| …/ IsMarkupAllowed | false | Флаг, указывающий, разрешена ли наценка на стороне продавца | |
| …/ MaximumSellingPrice | 15000 | Максимальная цена продажи, выше которой Агент выставлять не имеет права | Атрибут CurCode обозначает валюту. Для отелей - только RUB. |
| …/ MinimumSellingPrice | 10000 | Минимальная цена продажи, дешевле которой Агент выставлять не имеет права | Атрибут CurCode обозначает валюту. Для отелей - только RUB. |
Пример ответа Mixvel_HotelOfferPriceRS:
Показать пример ответа
<?xml version="1.0" encoding="utf-8"?>
<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
<Header />
<Body>
<MessageInfo MessageId="879b6b3a-33f5-4f3a-af4b-6521757aa17a" ReplyTo="79b67a26-6fc3-41e3-0ac4-14e0ac0245c8" TimeSent="2025-09-20T01:41:50.5126037Z" />
<AppData>
<Op:Mixvel_HotelOfferPriceRS xmlns:Op="https://www.mixvel.com/API/XSD/Mixvel_HotelOfferPriceRS/1_00">
<Response>
<OfferPage>
<Hotel>
<ProviderGeneralInfo>
<CheckInCheckOutTime>
<CheckInTime>14:00</CheckInTime>
<CheckOutTime>12:00</CheckOutTime>
</CheckInCheckOutTime>
<BasicInfo>
<ChildrenInfo>Разрешается проживание детей любого возраста.</ChildrenInfo>
<HotelDescription> К вашим услугам современные комфортабельные номера, оформленные в разных стилях, где всегда царит атмосфера домашнего уюта. Внимательный персонал круглосуточно заботится о беззаботном проживании гостей, а невысокие цены приятно удивляют в течение всего года. Одно из преимуществ гостиницы Мастер-Отель Первомайская– это удобное расположение рядом со станцией метро Первомайская, от которой всего 15 минут до центра столицы. Гостиница Мастер-Отель отлично подходит для отдыха и работы, для проживания в одиночестве или всей семьей. В ней уютно себя чувствуют молодые люди и родители с маленькими детьми, пенсионеры и бизнесмены. Как и другие недорогие гостиницы Москвы, отель Мастер-Отель предоставляет на выбор сто номеров разных категорий. Интерьеры всех номеров, холлов и ресторанных залов выполнены в соответствии с высокими европейскими требованиями и оснащены качественной современной мебелью. В недорогие гостиницы Москвы приезжают люди с самыми разными вкусами, поэтому в отеле Мастер-Отель можно найти и строгую классику, и современный модерн, и колоритный фольклорный стиль. Каждый номер предоставляет максимум удобств проживающим, в том числе отлично оснащенный санузел, холодильник, телевизор, телефон и фен. Не все дешевые гостиницы Москвы, как Мастер-Отель, могут предложить своим постояльцам услуги доступа к сети Интернет, факс. </HotelDescription>
<HotelTypeName>Городского типа</HotelTypeName>
<StarCategoryName>-</StarCategoryName>
</BasicInfo>
<HotelDirectContacts>
<Phone>7(906)068-11-44, +7(906)068-11-33</Phone>
<Website>http://master-hotel.ru/</Website>
</HotelDirectContacts>
<HotelFacility>
<HotelFacilityName>Салон красоты</HotelFacilityName>
<HotelFacilityName>Обслуживание в номерах</HotelFacilityName>
<HotelFacilityName>Сауна</HotelFacilityName>
<HotelFacilityName>Допускается размещение домашних животных (условия могут измениться)</HotelFacilityName>
<HotelFacilityName>Вызов такси</HotelFacilityName>
<HotelFacilityName>Ресторан</HotelFacilityName>
<HotelFacilityName>Круглосуточная регистрация</HotelFacilityName>
<HotelFacilityName>Номера для некурящих</HotelFacilityName>
<HotelFacilityName>Бар</HotelFacilityName>
<HotelFacilityName>Места для курения</HotelFacilityName>
<HotelFacilityName>Wi-Fi</HotelFacilityName>
<HotelFacilityName>Курение запрещено на всей территории</HotelFacilityName>
</HotelFacility>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626923.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=38170d0bd060ca68b9631e1af6e128579343dd3c74262092354a657e79008cc2</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626927.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=5be6c0e21910ed9b3da6c6e3ba55f952dbbfcb3f5dbf870798aaa30b9c7dc868</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626929.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=d4dbf34de0e937078f58060c30ff1e925887bf02e41d3c91cea3c1c71b62e5a8</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626930.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=7258f87a6264ce899648f730159c837c67944efddb635da1d78e28111a4241a2</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626931.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=e017390b5f27f7a877a72da486708f62381b33d59f6e6201a9ec048605791916</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626932.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=8ad1563015021a24215ddeada7592e0c6fee2450ea6f1a0a9a3119376c9f2271</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626933.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=9c988aec82cfaadc073f49741c6edac0ea641d297860adbd5b28aec216003b9a</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626934.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=c5b84e1c4a27bdea71220d7413c245c4524d135c4005ed00efe78b45ca0edbaf</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626935.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=dff705487d957321ea3f4237fd82405d069229e5e69ce0125caabbaf5d76c9c4</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626936.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=74ac13c8d03f146df6c300d5eb01b5ac0928a2693266cea1dc273cea0e011b9e</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626937.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=d739e167f3eec9cbe9c6dfceeb2f1e5283579ea15b857aa6aa5daee289eb4f46</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626938.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=039b75fcc0144cbdefe14c4ac5865c67408945e5a76a4b009830fef46b216e10</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626939.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=5f23b305a56a09ee2760dfe3e5c99ca72ec0b3311223139de1d3ceeb480d5fdc</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626940.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=db59c1e41b58b66e33fb6502f16517ae27fc3fdc58d66d2e50476afb1c2a3087</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626941.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=d9d2dd01fc7a0062d4f05c798844cbc233bc5b0b35b11008befd583003730d95</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626942.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=af5f2dfa6ca818dafda14217695b004330354472ab1f40072088f0ed18d92d08</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626943.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=90f9ed5a1a92eadbf93c90bfd23eb022f664991825a359a35c8a3df3ba47c5f1</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>false</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/37626944.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=242311595734f4c8d9eae373b2e5d8f09608cd3a1bbc83f7f33f1acb261174f4</URL>
</PhotoUrl>
</Photo>
<Photo>
<IsMain>true</IsMain>
<PhotoUrl>
<URL>https://storage.yandexcloud.net/mediaprocessor.test/hbp/131687/mxvl_main?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEEuCxe6jZsPkGJbry-3Kx%2F20250920%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250920T013549Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=3eda53a985704e08174621e0b1dc7ee5ef7a6918bb33cf8a935ee5ab4e5c2e09</URL>
</PhotoUrl>
</Photo>
</ProviderGeneralInfo>
<HotelID>ef22b7ac-a176-46b4-b530-03384f817af8</HotelID>
<HotelName>Мастер-Отель Первомайская</HotelName>
<ProviderHotelName>Мастер-Отель Первомайская</ProviderHotelName>
<ProviderLocationDetails>
<CityName>Москва</CityName>
<Coordinates>
<Latitude>55.7974554701</Latitude>
<Longitude>37.8003654722</Longitude>
</Coordinates>
<CountryName>Россия</CountryName>
<HotelAddress>105264, Россия, г. Москва, Измайловский бульвар, д. 49</HotelAddress>
</ProviderLocationDetails>
<Updated>2024-12-10T13:33:10Z</Updated>
</Hotel>
<Provider>
<Offer>
<ExtraInformation>
<TextBody><p>Внимание! Отель ДЛЯ ТЕСТОВ! Он не существует!</p></TextBody>
</ExtraInformation>
<OfferChangesAvailable>
<OfferChange>CHECK_IN</OfferChange>
<OfferChange>CHECK_OUT</OfferChange>
<OfferChange>GUESTS_NAMES</OfferChange>
<OfferChange>NUMBER_OF_GUESTS</OfferChange>
</OfferChangesAvailable>
<OfferExpirationTimeLimitDateTime>2025-09-20T02:41:50.5007749Z</OfferExpirationTimeLimitDateTime>
<OfferID>e9c0991f-ed00-4990-a198-e6d3cc0bdd96</OfferID>
<OfferPolicies>
<MarkUp>
<CanUseSellingPrice>true</CanUseSellingPrice>
<IsMarkupAllowed>true</IsMarkupAllowed>
<MaximumSellingPrice CurCode="RUB">288.00</MaximumSellingPrice>
<MinimumSellingPrice CurCode="RUB">181.00</MinimumSellingPrice>
</MarkUp>
</OfferPolicies>
<PriceDetails>
<AgentComission CurCode="RUB">30.00</AgentComission>
<TotalAmount CurCode="RUB">210.00</TotalAmount>
</PriceDetails>
<OwnerCode Provider="HotelBookPro">HBP</OwnerCode>
<RoomList>
<Room>
<Paxes>
<AdultsAmount>1</AdultsAmount>
</Paxes>
<ProviderMealName>Завтрак Шведский стол</ProviderMealName>
<RoomFeatures>
<InfoText>
<TextBody>Номер тестовый, отеля не существует!</TextBody>
</InfoText>
<RoomName>Эконом Double (тестовый номер!)</RoomName>
<RoomBedTypes>
<IsExtraBed>false</IsExtraBed>
<BedName>Трехместная кровать</BedName>
<BedsAmount>1</BedsAmount>
</RoomBedTypes>
<RoomBedTypes>
<IsExtraBed>false</IsExtraBed>
<BedName>autobedtype1522792861848</BedName>
<BedsAmount>1</BedsAmount>
</RoomBedTypes>
<RoomBedTypes>
<IsExtraBed>false</IsExtraBed>
<BedName>autobedtype1523224955372</BedName>
<BedsAmount>1</BedsAmount>
</RoomBedTypes>
</RoomFeatures>
<RoomID>f52bf451-de93-415f-b989-7e3c05f9b13a</RoomID>
</Room>
</RoomList>
<SubProviderName>HBPro</SubProviderName>
</Offer>
</Provider>
</OfferPage>
</Response>
</Op:Mixvel_HotelOfferPriceRS>
</AppData>
</Body>
</MixEnv:Envelope>