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

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

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

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

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

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

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

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

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

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

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

Тип запроса определяется необязательным атрибутом FromDate.

Его отсутствие означает запрос полных данных справочника.

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

<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="703423d1-595c-49f5-98c2-5dcabe950276" TimeSent="2025-01-01T00:00:00Z"/>
        <AppData>
            <GetDictionaryCarriersRQ FromDate="2025-01-01" xmlns="https://www.mixvel.com/API/XSD/mixvel_dictionaries/1_00"/>
        </AppData>
    </Body>
</MixEnv:Envelope>

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

Справочники без параметров¶

Справочник перевозчиков (/api/get/Dictionary/carriers).
Справочник городов (/api/get/Dictionary/cities).
Справочник стран (/api/get/Dictionary/countries).
Справочник форм оплаты (/api/get/Dictionary/formsofpayment).
Справочник платежных систем (/api/get/Dictionary/paymentsystems).
Справочник станций (/api/get/Dictionary/stations).
Справочник бланков ТКП (/api/get/Dictionary/tchblanks).
Справочник типов воздушных судов (/api/get/Dictionary/aircrafts).
Справочник документов пассажира (/api/get/Dictionary/passenger-documents).

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

Справочник курсов валют (/api/get/Dictionary/currency-rates).¶

В запросе справочника курсов валют требуется минимально передать коды валюты для конвертации (CurrencyFrom и CurrencyTo). Описание всех параметров приведено ниже.

XPath параметра	Описание
CurrencyFrom/CurCode	Код исходной валюты конвертации
CurrencyTo/CurCode	Код конечной валюты конвертации
Amount	Величина, которую необходимо сконвертировать (опционально)
CurrencyConversionSource	Источник конвертации: IATA_IROE, IATA_ICER, Airline или Agency (опционально). Если не указан, поиск производится для всех источников
AirlineDesigCode	Код авиакомпании. Указывается только при CurrencyConversionSource= Airline

Пример GetDictionaryCurrencyRatesRQ:

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

<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="703423d1-595c-49f5-98c2-5dcabe950276" TimeSent="2025-04-17T19:37:48Z"/>
        <AppData>
            <m:GetDictionaryCurrencyRatesRQ xmlns:m="https://www.mixvel.com/API/XSD/mixvel_dictionaries/1_00">
                <CurrencyFrom>
                    <CurCode>USD</CurCode>
                </CurrencyFrom>
                <CurrencyTo>
                    <CurCode>RUB</CurCode>
                </CurrencyTo>
                <Amount>10</Amount>
                <CurrencyConversionSource>IATA_IROE</CurrencyConversionSource>
            </m:GetDictionaryCurrencyRatesRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>