Справочники Платформы MixVel Отели¶

Общие положения¶

Для взаимодействия с MixVel API агент использует пространство имен кодификаторов и справочников MixVel Отели.

Для поддержания корректного взаимодействия с MixVel агент загружает их к себе и актуализирует их с некоторой периодичностью, определяемой регламентом взаимодействия с веб-сервисами MixVel.

Для доставки агенту справочников не выделяется отдельного внешнего API, то есть в общее API добавляются соответствующие методы.

Описания методов приведены в XSD схеме Mixvel_Dictionaries_1_00.xsd

Запросы передаются из внешнего API в Подсистему управления справочниками MixVel Отели.

При вызове методов получения справочников требуется авторизация.

Методы получения данных справочников¶

Все методы DictionaryHotel* позволяют получить:

полные данные справочника, актуальные на момент совершения запроса;
измененные объекты справочника, начиная с определенной даты в актуальном состоянии на момент совершения запроса.

Пример запроса справочника отельных стран:

<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body>
        <MessageInfo MessageId="703423d1-595c-49f5-98c2-5dcabe950276" ReplyTo="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2025-10-10T13:37:48Z"/>
        <AppData>
            <a:GetDictionaryHotelCountriesRQ xmlns:a="https://www.mixvel.com/API/XSD/mixvel_dictionaries/1_00"/>
        </AppData>
    </Body>
</MixEnv:Envelope>

Справочники по отелям, доступные агенту¶

Справочник отелей (/api/get/Dictionary/Hotels).
Справочник отельных стран (/api/get/Dictionary/Hotel/Countries).
Справочник отельных городов (/api/get/Dictionary/Hotel/Cities).

Настраиваемые параметры справочников¶

Справочник отелей (/api/get/Dictionary/Hotels) и справочник отельных городов (/api/get/Dictionary/Hotel/Cities) поддерживают настраиваемые, но необязательные параметры.

Например, необязательный атрибут FromDate используется для получения только изменений справочника, начиная с указанной даты. Его отсутствие означает, что будет запрошен полный набор данных справочника.

Описание всех параметров приведено ниже.

XPath параметра	Описание
IsActive	Индикатор активной записи страны.
FromDate	Параметр для получения только изменений справочника с определенной даты. Для получения полных данных справочника поле не указывается.
CountryID	Идентификатор страны, к которой относится город.
CityID	Идентификатор города, к которому относится отель. Применяется только для справочника Dictionary/Hotels.

Пример GetDictionaryHotelsRQ:

Показать пример запроса

<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body>
        <MessageInfo MessageId="703423d1-595c-49f5-98c2-5dcabe950276" ReplyTo="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2025-10-10T13:37:48Z"/>
        <AppData>
            <a:GetDictionaryHotelsRQ xmlns:a="https://www.mixvel.com/API/XSD/mixvel_dictionaries/1_00">
                <IsActive>true</IsActive>
                <FromDate>2025-10-10</FromDate>
                <CityID>070f89a1-8a7b-4013-af9a-5de019806427</CityID>
                <CountryID>070f89a1-8a7b-4013-af9a-5de019806427</CountryID>
            </a:GetDictionaryHotelsRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>