Offer update request¶
General terms¶
Endpoint: /api/HotelOfferPrice
To obtain full offer details, clarify availability, and current cost before booking, the Mixvel_HotelOfferPriceRQ method is used. This request is optional but is recommended to re-verify offer availability before booking. After receiving a suitable offer in the Mixvel_HotelPageRS response, you can proceed directly to booking; however, skipping the Mixvel_HotelOfferPriceRQ is not recommended.
Note: The Mixvel_HotelOfferPriceRQ method differs from the Mixvel_OfferPriceRQ method.
Request structure¶
The request input data must satisfy the Mixvel_HotelOfferPriceRQ.xsd scheme and contain the following main parameters (full parameters are available in the XSD schema or in XML examples of a specific message):
| Parameter XPath | Filling example | Description | Comments |
|---|---|---|---|
| Mixvel_HotelOfferPriceRQ/ PayloadAttributes/ PrimaryLangID | RU | Language in which data is returned from directories | MixVel currently only provides responses in Russian. |
| Mixvel_HotelOfferPriceRQ/ Request/ SelectedHotelOffer/ OfferRefID | 3ad4ef0e-e6ed-4404-bbb0-95b58330226e | Link to the identifier of the chosen offer |
Example of the Mixvel_HotelOfferPriceRQ request:
Show request example
<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>
Response structure¶
The main part of the information for a specific offer in Mixvel_HotelOfferPriceRS duplicates data from Mixvel_HotelPageRS. The system's response conforms to the Mixvel_HotelOfferPriceRS.xsd schema and contains core data (the table below lists the key message parameters; the full list is available in the XSD schema or XML examples)..
In the Hotel block of the Mixvel_HotelOfferPriceRS response, information about the hotel previously received in Mixvel_HotelPageRS is repeated. The main offer details are also duplicated from Mixvel_HotelPageRS in the structure:
- Mixvel_HotelOfferPriceRS/Response/OfferPage/Provider/Offer
The table below lists the fields unique to Mixvel_HotelOfferPriceRS that are not present in Mixvel_HotelPageRS.
| Parameter XPath | Filling example | Description | Comments |
|---|---|---|---|
| Mixvel_HotelOfferPriceRS/ Response/ OfferPage/ Provider/ Offer/ OfferChangesAvailable/OfferChange | NUMBER_OF_GUESTS | List of fields available for change | Transmitted as text. |
| Mixvel_HotelOfferPriceRS/ Response/ OfferPage/ Provider/ Offer/ OfferPolicies/ MarkUp | complex | Possibility of tariff changes | Structure, see below. |
| …/ CanUseSellingPrice | true | Flag indicating that the hotel can change (up or down) the proposed tariff | |
| …/ IsMarkupAllowed | false | Flag indicating whether markup is allowed on the seller's side | |
| …/ MaximumSellingPrice | 15000 | Maximum selling price, above which the Agent is not allowed to sell | The CurCode attribute denotes the currency. For hotels - only RUB. |
| …/ MinimumSellingPrice | 10000 | Minimum selling price, below which the Agent is not allowed to sell | The CurCode attribute denotes the currency. For hotels - only RUB. |
Example of the Mixvel_HotelOfferPriceRS response:
Show response example
<?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>