Устаревшие функции в релизе 1.5.0¶

Изменения в схемах, которые могут затронуть текущий функционал.

Мы стремимся развивать и делать наш продукт удобным и понятным для наших агентов. В связи с этим информируем, что на конец января 2026 года запланирован релиз 1.5.0, содержащий изменения, которые нарушают обратную совместимость и вносят существенные изменения в процесс бронирования, выписки билетов и дополнительных услуг.

Просим внимательно ознакомиться с планируемыми изменениями и предусмотреть необходимые доработки на вашей стороне для бесшовного перехода на использование версии 1.5.0. За получением дополнительной информации, консультацией необходимо обращаться на support@mixvel.com.

Общие изменения¶

Отображение кода города/порта в LocationCode¶

В релизе 1.5.0 удаляется параметр <IATA_LocationCode>. Изменение затрагивает структуры запросов AirShoppingRQ, OrderReshopRQ, AvailabilityRQ, AirlineProfileRQ, а также в ответных сообщениях AirShoppingRS, OfferPriceRS, OrderViewRS, OrderReshopRS, AvailabilityRS, AirlineProfileRS, SeatAvailabilityRS и ServiceListRS. Атрибут Standart для указания владельца кода города/порта также удаляется.

Параметр удаляется в схеме запросов:

.../OriginDestCriteria/DestArrivalCriteria/IATA_LocationCode
.../OriginDestCriteria/OriginDepCriteria/IATA_LocationCode

Параметр удаляется в схеме ответных сообщений:

.../Response/DataLists/PaxSegmentList/PaxSegment/Arrival/IATA_LocationCode
.../Response/DataLists/PaxSegmentList/PaxSegment/DatedOperatingLeg/Arrival/IATA_LocationCode
.../Response/DataLists/PaxSegmentList/PaxSegment/DatedOperatingLeg/Dep/IATA_LocationCode
.../Response/DataLists/PaxSegmentList/PaxSegment/Dep/IATA_LocationCode

Вместо него будет использоваться параметр <LocationCode> с атрибутом Standard владельца кода города/порта - IATA или TCH.

Обновленные структуры доступны в MixVel API с релиза 1.4.6.

Пример структур после релиза 1.5.0¶

Пример Mixvel_AirShoppingRQ:

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

<?xml version="1.0"?>
<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body>
        <MessageInfo MessageId="0a5a977c-bfc6-4464-96b6-8dda03141592" TimeSent="2025-10-24T19:53:14Z"/>
        <AppData>
            <shop:Mixvel_AirShoppingRQ xmlns:shop="https://www.mixvel.com/API/XSD/Mixvel_AirShoppingRQ/1_01">
                <Request xmlns="">
                    <FlightRequest>
                        <FlightRequestOriginDestinationsCriteria>
                            <OriginDestCriteria>
                                <CabinType>
                                    <CabinTypeCode>Economy</CabinTypeCode>
                                    <PrefLevel>
                                        <PrefLevelCode>Required</PrefLevelCode>
                                    </PrefLevel>
                                </CabinType>
                                <DestArrivalCriteria>
                                    <LocationCode Standard="IATA">MOW</LocationCode>
                                </DestArrivalCriteria>
                                <OriginDepCriteria>
                                    <Date>2025-12-25</Date>
                                    <LocationCode Standard="TCH">СПТ</LocationCode>
                                </OriginDepCriteria>
                            </OriginDestCriteria>
                        </FlightRequestOriginDestinationsCriteria>
                    </FlightRequest>
                    <Paxs>
                        <Pax>
                            <PaxID>Pax-1</PaxID>
                            <PTC>ADT</PTC>
                        </Pax>
                    </Paxs>
                </Request>
            </shop:Mixvel_AirShoppingRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

Пример Mixvel_OrderReshopRQ:

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

<?xml version="1.0"?>
<MixEnv:Envelop xmlns:MixEnv="http://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="703423d1-595c-49f5-98c2-5dcabe950276" TimeSent="2025-10-12T12:17:51Z"/>
        <AppData>
            <m:Mixvel_OrderReshopRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderReshopRQ/1_00">
                <Request xmlns="">
                    <MixOrder>
                        <MixOrderID>01138-251028-MTY2774</MixOrderID>
                    </MixOrder>
                    <UpdateOrder>
                        <ReshopOrder>
                            <ReshopOrderChoice>
                                <ServiceOrder>
                                    <AddOfferItems>
                                        <OriginDestCriteria>
                                            <CabinType>
                                                <CabinTypeCode>Economy</CabinTypeCode>
                                            </CabinType>
                                            <DestArrivalCriteria>
                                                <LocationCode Standard="TCH">СПТ</LocationCode>
                                            </DestArrivalCriteria>
                                            <OriginDepCriteria>
                                                <Date>2025-11-13</Date>
                                                <LocationCode Standard="IATA">MOW</LocationCode>
                                            </OriginDepCriteria>
                                        </OriginDestCriteria>
                                        <PaxSegmentRefID>0f1d410f-a1b0-4157-8d6b-dcb10e8fcab5</PaxSegmentRefID>
                                    </AddOfferItems>
                                    <OrderRefID>01138-251028-OTY2775</OrderRefID>
                                </ServiceOrder>
                            </ReshopOrderChoice>
                        </ReshopOrder>
                    </UpdateOrder>
                    <PaymentFunctions>
                        <PaymentProcessingDetails>
                            <PaymentProcessingDetailsPaymentMethod>
                                <OtherPaymentMethod/>
                            </PaymentProcessingDetailsPaymentMethod>
                        </PaymentProcessingDetails>
                    </PaymentFunctions>
                </Request>
            </m:Mixvel_OrderReshopRQ>
        </AppData>
    </Body>
</MixEnv:Envelop>

Пример Mixvel_AvailabilityRQ:

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

<?xml version="1.0"?>
<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="e5cc6d38-73ad-42e0-8783-06342504cdd7" TimeSent="2025-10-23T14:11:00Z"/>
        <AppData>
            <Shop:Mixvel_AvailabilityRQ xmlns:Shop="https://www.mixvel.com/API/XSD/Mixvel_AvailabilityRQ/1_00">
                <Request>
                    <FlightRequest>
                        <OriginDestCriteria>
                            <CarrierPrefRefID>Carrier-0</CarrierPrefRefID>
                            <DestArrivalCriteria>
                                <LocationCode Standard="IATA">MOW</LocationCode>
                            </DestArrivalCriteria>
                            <OriginDepCriteria>
                                <Date>2025-11-08</Date>
                                <LocationCode Standard="IATA">LED</LocationCode>
                            </OriginDepCriteria>
                        </OriginDestCriteria>
                    </FlightRequest>
                    <ShoppingCriteria>
                        <CarrierCriteria>
                            <Carrier>
                                <AirlineDesigCode>SU</AirlineDesigCode>
                            </Carrier>
                            <CarrierPrefID>Carrier-0</CarrierPrefID>
                        </CarrierCriteria>
                        <FlightCriteria>
                            <RBD>
                                <RBD_Code>R</RBD_Code>
                            </RBD>
                        </FlightCriteria>
                        <SegmentStatusCriteria>
                            <Open>true</Open>
                            <Request>true</Request>
                            <Waitlist>true</Waitlist>
                        </SegmentStatusCriteria>
                    </ShoppingCriteria>
                </Request>
            </Shop:Mixvel_AvailabilityRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

Пример Mixvel_AirlineProfileRQ:

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

<?xml version="1.0"?>
<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body>
        <MessageInfo MessageId="0295a18c-6cf4-4415-8a18-4dfb863abefb" TimeSent="2025-10-22T06:01:00Z"/>
        <AppData>
            <m:Mixvel_AirlineProfileRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_AirlineProfileRQ/1_01">
                <Request xmlns="">
                    <AirScheduleFilterCriteria>
                        <ScheduleRequest>
                            <OriginDestCriteria>
                                <DestArrivalCriteria>
                                    <LocationCode Standard="IATA">LED</LocationCode>
                                </DestArrivalCriteria>
                                <OriginDepCriteria>
                                    <DateRangeStart>2025-11-25</DateRangeStart>
                                    <DateRangeEnd>2025-11-27</DateRangeEnd>
                                    <LocationCode Standard="IATA">MOW</LocationCode>
                                </OriginDepCriteria>
                            </OriginDestCriteria>
                        </ScheduleRequest>
                    </AirScheduleFilterCriteria>
                </Request>
            </m:Mixvel_AirlineProfileRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

Пример структуры PaxSegment с новыми параметрами в ответных сообщениях:

<PaxSegment>
    <Arrival>
        <ScheduledDateTime>2025-12-25T19:45:00</ScheduledDateTime>
        <DateShift>0</DateShift>
        <LocationCode Standard="IATA">VKO</LocationCode>
        <StationName>Москва(Внуково)</StationName>
        <TerminalName>A</TerminalName>
    </Arrival>
    <DatedOperatingLeg>
        <Arrival>
            <ScheduledDateTime>2025-12-25T19:45:00</ScheduledDateTime>
            <LocationCode Standard="IATA">VKO</LocationCode>
            <StationName>Москва(Внуково)</StationName>
            <TerminalName>A</TerminalName>
        </Arrival>
        <CarrierType>
            <CarrierTypeCode>SU9</CarrierTypeCode>
        </CarrierType>
        <DatedOperatingLegID>e5a29d8d-3629-4c98-98db-1d2c21dc60b5</DatedOperatingLegID>
        <Dep>
            <ScheduledDateTime>2025-12-25T18:00:00</ScheduledDateTime>
            <LocationCode Standard="IATA">LED</LocationCode>
            <StationName>Санкт-Петербург(Пулково)</StationName>
            <TerminalName>1</TerminalName>
        </Dep>
    </DatedOperatingLeg>
    <Dep>
        <ScheduledDateTime>2025-12-25T18:00:00</ScheduledDateTime>
        <DateShift>0</DateShift>
        <LocationCode Standard="IATA">LED</LocationCode>
        <StationName>Санкт-Петербург(Пулково)</StationName>
        <TerminalName>1</TerminalName>
    </Dep>
    <Duration>PT1H45M</Duration>
    <Distance UnitCode="Mileage">390</Distance>
    <FranchiseCarrierInfo>
        <CarrierDesigCode>FV</CarrierDesigCode>
        <FranchiseCarrierFlightNumberText>6179</FranchiseCarrierFlightNumberText>
    </FranchiseCarrierInfo>
    <MarketingCarrierInfo>
        <CarrierDesigCode>SU</CarrierDesigCode>
        <MarketingCarrierFlightNumberText>6179</MarketingCarrierFlightNumberText>
    </MarketingCarrierInfo>
    <SegmentType>Aircraft</SegmentType>
    <PaxSegmentID>39e35f1e-6eb6-4674-b581-56a15903d339</PaxSegmentID>
</PaxSegment>

Опциональность параметра ScheduledDateTime¶

В ответных сообщениях AirShoppingRS, OfferPriceRS, OrderViewRS, OrderReshopRS, AvailabilityRS, AirlineProfileRS, SeatAvailabilityRS и ServiceListRS параметр ScheduledDateTime становится необязательным:

Изменение применяется в схеме ответных сообщений:

.../Response/DataLists/PaxSegmentList/PaxSegment/Arrival/ScheduledDateTime
.../Response/DataLists/PaxSegmentList/PaxSegment/DatedOperatingLeg/Arrival/ScheduledDateTime
.../Response/DataLists/PaxSegmentList/PaxSegment/DatedOperatingLeg/Dep/ScheduledDateTime
.../Response/DataLists/PaxSegmentList/PaxSegment/Dep/ScheduledDateTime

Коды базового и примененного тарифов¶

Коды базового и примененного тарифов передаются в структуре:

.../FareDetail/FareComponent, в которой:

.../FareComponent/FareBasisAppCode - код примененного тарифа

.../FareComponent/FareBasisCode - код базового тарифа

Типы ремарок¶

В методах Mixvel_OrderCreateRQ и Mixvel_OrderChangeRQ параметр Type заполняется только в верхнем регистре в структуре:

.../PaxSegmentRemarkList/PaxSegmentRemark/Type

Пример передачи ремарки в запросе:

<PaxSegmentRemarkList>
    <PaxSegmentRemark>
        <OfferRefID>070d9e96-b59e-43c0-b00e-6d7feaaabe2e</OfferRefID>
        <Type>OTHS</Type>
        <Text>OTHER REMARK</Text>
    </PaxSegmentRemark>
</PaxSegmentRemarkList>

Изменения в методах¶

Запрос направлений и расписания¶

Endpoint: /api/Order/AirlineProfile

Удаление элемента TravelWithin¶

В структуре AirlineProfileDataItem удаляется элемент TravelWithin:

Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/TravelWithin

Удаление элементов массива GeographicFilterCriteriaType¶

В структуре GeographicFilterCriteriaType удаляются элементы:

Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/GeographicFilterCriteriaType/AreaCodeText
Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/GeographicFilterCriteriaType/CoordRadiusMeasure
Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/GeographicFilterCriteriaType/CountryCode
Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/GeographicFilterCriteriaType/CountrySubDivisionCode
Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/GeographicFilterCriteriaType/GeospatialLocation

Изменение параметра Direction¶

Элемент Direction становится опциональным в структуре:

Mixvel_AirlineProfile/Response/AirlineProfile/AirlineProfileDataItem/Direction

Впоследствии элемент будет заполняться признаком многоплечевого рейса.

Оплата заказа/бронирования¶

Endpoint: /api/Order/Change

Удаление параметра SingleTicket¶

Удаляется параметр для передачи флага о печати билета на одном бланке SingleTicket:

Mixvel_OrderChangeRQ/Request/ResponseParameters/SingleTicket

Данный параметр передается на этапе создания заказа CreateOrderRQ, при оплате его передавать не нужно в связи с наследованием элемента.

Запрос карты мест¶

Endpoint: /api/Order/SeatAvailability

Изменение массива Offer¶

В запросе SeatAvailabilityRQ изменено допустимое количество вхождений элементов Offer в структуре:

Mixvel_SeatAvailabilityRQ/Request/Offer

Теперь можно указать только один элемент.

Запрос условий применения тарифов¶

Endpoint: /api/Order/OrderRules

Изменение массивов OfferItem и OrderItem¶

В запросе OrderRulesRQ изменено допустимое количество вхождений элементов OfferItem в структуре:

Mixvel_OrderRulesRQ/Request/RulesCoreRequest/OfferRequest/OfferItem

В запросе OrderRulesRQ изменено допустимое количество вхождений элементов OrderItem в структуре:

Mixvel_OrderRulesRQ/Request/RulesCoreRequest/OrderRequest/OrderItem

Допускается только одно вхождение элемента.

Структура сообщения OrderViewRS¶

Изменение отображения данных о НДС¶

В ответе Mixvel_OrderViewRS удаляется повторное отображение данных о НДС в структуре:

Mixvel_OrderViewRS/Response/TicketDocInfo/FareDetail/FarePriceType/Price/TaxSummary/Tax

Информация о НДС теперь будет передаваться только в структуре:

Mixvel_OrderViewRS/Response/MixOrder/Order/OrderItem/FareDetail/Price/TaxSummary/Tax

Удаление структуры FareComponеnt¶

Перестает заполняться структура, содержащая информацию о тарифной составляющей:

Mixvel_OrderViewRS/Response/TicketDocInfo/FareDetail/FareComponеnt

Данная информация продолжает отображаться в структуре:

Mixvel_OrderViewRS/Response/MixOrder/Order/OrderItem/FareDetail/FareComponent

Обязательность элемента OrderID¶

В ответных сообщениях параметр OrderID становится обязательным:

Mixvel_OrderViewRS/Response/TicketDocInfo/OrderRef/OrderID

Формирование блока для страховых услуг¶

Начиная с релиза 1.5.0, изменен порядок формирования блока для страховых услуг, оформляемых через SlTech:

Mixvel_OrderViewRS/Response/TicketDocInfo

Ранее для одной страховой услуги создавались два блока — отдельный документ на страховой полис и маршрут-квитанция (МК) с информацией о EMD. Такая схема приводила к дублированию данных, поскольку страховая услуга является одной позицией в заказе, и оба документа содержали одну и ту же тарификационную информацию.

Теперь для страховой услуги формируется один блок, объединяющий данные полиса и EMD. Это устраняет дублирование информации и соответствует общей логике MixVel: одна страховая услуга (OrderItem) соответствует одному блоку.

Отображение типа ремарки¶

Значение параметра Type (типа ремарки) теперь приводится к верхнему регистру в структуре:

Mixvel_OrderViewRS/Response/DataLists/RemarkList/Remark/Type

Пример отображения в структуре:

<Remark>
    <PaxSegmentRefID>4965a44f-388e-493a-aeab-6eff6d25ef56</PaxSegmentRefID>
    <PaxRefID>Pax-1</PaxRefID>
    <RemarkID>1ceff375-eeac-435c-bc95-bb5437fca143</RemarkID>
    <Type>OTHS</Type>
    <Text>SSR REMARK</Text>
    <StatusCode>HK</StatusCode>
    <OrderRefID>82477-250912-OET6958</OrderRefID>
</Remark>

Удаление структуры Remark из блока MixOrder¶

Из ответных сообщений OrderViewRS удаляется структура:

Mixvel_OrderViewRS/Response/MixOrder/Order/OrderItem/Remark

Информация будет отображаться только в структуре:

Mixvel_OrderViewRS/Response/DataLists/RemarkList/Remark

Новая структура заполняется, начиная с релиза 1.4.7.

Удаление элемента Qty¶

В ответных сообщениях Mixvel_OrderViewRS параметр отображения количества дополнительных услуг <Qty> удаляется из структуры:

Mixvel_OrderViewRS/Response/DataLists/ServiceDefinitionList/ServiceDefinition/Qty

Параметр переносится и будет отображаться в структуре:

Mixvel_OrderViewRS/Response/MixOrder/Order/OrderItem/Service/Qty

Отмена/аннулирование заказа¶

Endpoint: /api/Order/Cancel

Перенос параметра OrderItemID¶

В запросе OrderCancelRQ удаляется параметр OrderItemID:

Mixvel_OrderCancelRQ/Request/MixOrder/Order/OrderItemID

Для передачи элемента OrderItemID будет использоваться структура:

Mixvel_OrderCancelRQ/Request/MixOrder/Order/OrderItem/OrderItemID

Пример запроса Mixvel_OrderCancelRQ:

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

<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-10-31T19:37:48Z"/>
        <AppData>
            <m:Mixvel_OrderCancelRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderCancelRQ/1_01">
                <Request>
                    <MixOrder>
                        <MixOrderID>96829-250124-MEO3189</MixOrderID>
                        <Order>
                            <OrderID>96829-250124-OEO3190</OrderID>
                            <OrderItem>
                                <OrderItemID>eb2ccbeb-9726-43f9-8cfb-b17291223c56</OrderItemID>
                            </OrderItem>
                        </Order>
                    </MixOrder>
                </Request>
            </m:Mixvel_OrderCancelRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

Новая структура уже доступна на всех стендах.

Импорт заказа/бронирования¶

Endpoint: /api/Order/Import

Удаление элемента ForceImport¶

Элемент <ForceImport> удаляется из запроса Mixvel_OrderImportRQ. Функциональность обновления данных заказа и пассажиров, ранее выполнявшаяся через параметр ForceImport, перенесена в метод Mixvel_OrderRetrieveRQ.

Mixvel_OrderImportRQ/Request/ExternalOrderRequest/ForceImport

Для получения актуального состояния заказа после изменений в сторонних системах теперь используется метод Mixvel_OrderRetrieveRQ без дополнительных параметров.

Возврат оплаченного заказа Mixvel_OrderReshopRQ¶

Endpoint:/api/Order/Reshop

Изменение отображения многокупонных услуг в OrderReshopRS¶

При возврате заказа с двумя и более одинаковыми дополнительными услугами (многокупонный EMD) на разных сегментах, в ответном сообщении MixVel_OrderReshopRS для всего заказа добавлено отображение ссылки на каждый отдельный сегмент PaxSegmentRefID в массиве.

MixVel_OrderReshopRS/Response/ReshopResults/ReshopOffers/Offer/AddOfferItem/ExistingOrderItem/PriceDifferential/DiffPrice/ServiceAssociations

Пример отображения:

<ExistingOrderItem>
    <OrderItemRefID>5fb68b81-ba8e-40f6-bd96-32fc3de37880</OrderItemRefID>
    <PriceDifferential>
        <DiffPrice>
            <ServiceAssociations>
                <PaxSegmentRefID>cc4240a5-85f3-4c9f-bf1b-730a81e2704c</PaxSegmentRefID>
                <PaxRefID>Pax-1</PaxRefID>
                <ServiceDefinitionRefID>3c199cf6-568b-4f9e-929c-02670bf65f45</ServiceDefinitionRefID>
            </ServiceAssociations>
            <ServiceAssociations>
                <PaxSegmentRefID>fc240d0a-da06-4841-9b66-35e25f88b315</PaxSegmentRefID>
                <PaxRefID>Pax-1</PaxRefID>
                <ServiceDefinitionRefID>3c199cf6-568b-4f9e-929c-02670b34dcxsd</ServiceDefinitionRefID>
            </ServiceAssociations>
            <Price>
                <TotalAmount CurCode="RUB">2598.00</TotalAmount>
            </Price>
        </DiffPrice>
    </PriceDifferential>
</ExistingOrderItem>

Резерв мест¶

Endpoint: /api/Order/Inv-Guarantee

Удаление элемента InventoryGuaranteeID¶

Из ответа Mixvel_InvGuaranteeRS удаляется элемент InventoryGuaranteeID

Mixvel_InvGuaranteeRS/Response/InventoryGuarantee/InventoryGuaranteeID

Ранее элемент носил информационный характер и содержал номер предварительного резервирования мест.

Сервис уведомлений MixVel¶

Изменение параметра Birthdate¶

Изменено отображение параметра в ответных сообщениях Mixvel_OrderNotifRS в структуре:

Mixvel_OrderNotifRS/Response/Notifications/ChangeGroup/ChangeOperation/DocInfo/PaxInfo/Birthdate

Пример параметра до релиза 1.5.0:

<Birthdate>1953-04-08T00:00:00+00:00</Birthdate>

Пример параметра после релиза 1.5.0:

<Birthdate>1953-04-08</Birthdate>