Резерв мест¶

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

Endpoint: /api/Order/Inv-Guarantee

Метод Mixvel_InvGuaranteeRQ используется для запроса гарантированных ресурсов мест в рамках Offer’a, с последующим их преобразованием в выполненный/оплаченный и/или оформленный заказ.

Метод Mixvel_InvGuaranteeRS возвращает ответ с ID номером резерва (гарантии) вместе с указанием срока действия этого резерва. Гарантированный тайм-лимит не может превышать тайм-лимит офферов, после которого будут генерироваться новые предложения.

Возможные допустимые варианты ответов при запросе резерва мест:

«Inventory Guarantee Identifier» для каждого предложения и/или идентификатора услуги продукта.
Отсутствие возможности установить резерв - с указанием причин или указанием того, что Offer «не резервируется».
Предложение «не резервируется».

Структура запроса¶

XPath параметра	Пример заполнения	Описание
Mixvel_InvGuaranteeRQ/Request/SelectedOffer/OfferRefID	4b33414c-5503-4275-9416-7c98a7f5dd1a	Идентификатор коммерческого предложения

Структура ответа¶

XPath параметра	Пример заполнения	Описание
Mixvel_InvGuaranteeRS / Response / InventoryGuarantee / OfferID	77939f37-7743-4463-a0f7-313da505a315	Уникальный идентификатор коммерческого предложения. Используется при создании заказа / бронирования
Mixvel_InvGuaranteeRS / Response / InventoryGuarantee / InventoryGuaranteeTimeLimitDateTime	2025-02-20T13:40:00	Информация в данном поле содержит дату и время, до которого будет действовать предварительная бронь мест

Сценарий использования и примеры сообщений¶

Mixvel_InvGuaranteeRQ:

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

<?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="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2025-01-07T17:37:47Z"/>
        <AppData>
            <m:Mixvel_InvGuaranteeRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_InvGuaranteeRQ/1_00">
                <Request>
                    <SelectedOffer>
                        <OfferRefID>25283a93-f691-4cd2-956b-9f9a0bf03355</OfferRefID>
                    </SelectedOffer>
                </Request>
            </m:Mixvel_InvGuaranteeRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

В рамках InvGuaranteeRQ не создаются новые предложения, а лишь модифицируются уже существующие.

Mixvel_InvGuaranteeRS:

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

<?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="019af860-cddd-74af-9957-57c7f10fbcbe" ReplyTo="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2025-12-07T10:34:45.6789345Z" />
        <AppData>
            <InvGuarantee:Mixvel_InvGuaranteeRS xmlns:InvGuarantee="https://www.mixvel.com/API/XSD/Mixvel_InvGuaranteeRS/1_00">
                <Response>
                    <InventoryGuarantee>
                        <OfferID>25283a93-f691-4cd2-956b-9f9a0bf03355</OfferID>
                        <InventoryGuaranteeTimeLimitDateTime>2025-12-07T10:50:00Z</InventoryGuaranteeTimeLimitDateTime>
                    </InventoryGuarantee>
                </Response>
            </InvGuarantee:Mixvel_InvGuaranteeRS>
        </AppData>
    </Body>
</MixEnv:Envelope>

При успешном выполнении метода InvGuaranteeRS приходит:

InventoryGuaranteeTimeLimitDateTime - в формате даты и времени окончания брони;
OfferID, который может быть применен при последующем бронировании мест.

Для последующего бронирования зарезервированных мест используется метод Mixvel_OrderCreateRQ.

Снятие зарезервированных мест¶

Endpoint: /api/Order/inv-guarantee-release

Метод Mixvel_InvReleaseNotifRQ возвращает в систему незапрошенное уведомление о зарезервированных местах по методу InvGuaranteeRQ/RS. В случае отмены удаляется модифицированный OfferId.

Mixvel_InvReleaseNotifRQ:

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

<?xml version="1.0" encoding="UTF-8"?>
<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_05">
    <Header/>
    <Body>
        <MessageInfo MessageId="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2021-03-17T17:37:47Z"/>
        <AppData>
            <m:Mixvel_InvReleaseNotifRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_InvReleaseNotifRQ/1_00">
                <Request>
                    <SelectedOffer>
                        <OfferRefID>25283a93-f691-4cd2-956b-9f9a0bf03355</OfferRefID>
                    </SelectedOffer>
                </Request>
            </m:Mixvel_InvReleaseNotifRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

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

В ответ приходит код методом Mixvel_Acknowledgement:

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

<?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="019af862-7135-75fc-a9b8-b2834b525f3e" ReplyTo="79b67a26-6fc3-41e3-8ac4-14e0ac0245c8" TimeSent="2025-12-07T10:36:32.6803415Z" />
        <AppData>
            <Ack:Mixvel_Acknowledgement xmlns:Ack="https://www.mixvel.com/API/XSD/Mixvel_Acknowledgement/1_00">
                <Response>
                    <StatusCode>OK</StatusCode>
                    <StatusMessageText>XX</StatusMessageText>
                </Response>
            </Ack:Mixvel_Acknowledgement>
        </AppData>
    </Body>
</MixEnv:Envelope>

При успешной отмене зарезервированных мест в ответ приходит код – XX.

Бронирование ранее зарезервированных мест будет происходить по запросу Mixvel_OrderCreateRQ.