Перейти к содержанию
ru
en

Операции со страховыми продуктами

Поиск страховых продуктов

Поиск страховых продуктов осуществляется по Offer или Order с использованием запроса Mixvel_ServiceListRS.

Поиск по Offer:

  <Body xmlns="">
    <MessageInfo MessageId="a40858dc-9fa2-4986-a540-516611666308" TimeSent="2021-06-11T14:20:57.8705011Z"/>
    <AppData>
      <Mixvel_ServiceListRQ xmlns="https://www.mixvel.com/API/XSD/Mixvel_ServiceListRQ/1_00">
        <Request xmlns="">
          <CoreRequest>
            <OfferRequest>
              <Offer>
                <OfferID>{{Offer}}</OfferID>
              </Offer>
            </OfferRequest>
          </CoreRequest>
        </Request>
      </Mixvel_ServiceListRQ>
    </AppData>
  </Body>

Поиск по Order:

  <Body id="ID1">
        <MessageInfo MessageId="e5cc6d38-73ad-42e0-8783-06342504cdd6" TimeSent="2021-03-17T18:37:48Z"/>
        <AppData>
            <Shop:Mixvel_ServiceListRQ xmlns:Shop="https://www.mixvel.com/API/XSD/Mixvel_ServiceListRQ/1_00">
                <Request>
                    <CoreRequest>
                        <OrderRequest>
                            <MixOrder>
                                <MixOrderID>{{Order}}</MixOrderID>
                            </MixOrder>
                        </OrderRequest>
                    </CoreRequest>
                </Request>
            </Shop:Mixvel_ServiceListRQ>
        </AppData>
    </Body>

В ответном сообщении Mixvel_ServiceListRS возвращаются Offer и OfferItem для добавления в заказ, по аналогии с дополнительными услугами авиакомпаний.

Показать пример Mixvel_ServiceListRS на этой странице

            <Response>
                    <ALaCarteOffer>
                        <ALaCarteOfferItem>
                            <Eligibility>
                                <EligibilityFlightAssociations>
                                    <PaxSegmentRef>
                                        <PaxSegmentRefID>58ea2145-00e9-4a3b-a57b-561ae74aa758</PaxSegmentRefID>
                                    </PaxSegmentRef>
                                </EligibilityFlightAssociations>
                                <PaxRefID>Pax-1</PaxRefID>
                            </Eligibility>
                            <OfferItemID>12fc7c36-dfeb-471f-9669-4c151dd4c426</OfferItemID>
                            <TicketDocTypeCode>Y</TicketDocTypeCode>
                            <Service>
                                <ServiceDefinitionRefID>b882c457-a231-4ae7-b83a-c13e194915bb</ServiceDefinitionRefID>
                                <ServiceID>c08e08de-1e2e-414c-a7ef-0210dae84d16</ServiceID>
                                <ValidatingPartyRefID>5e2a151d-fee1-4ff4-b57b-6536517b7842</ValidatingPartyRefID>
                            </Service>
                            <UnitPrice>
                                <TotalAmount CurCode="RUB">200.00</TotalAmount>
                            </UnitPrice>
                        </ALaCarteOfferItem>
                        <ALaCarteOfferItem>
                            <Eligibility>
                                <EligibilityFlightAssociations>
                                    <PaxSegmentRef>
                                        <PaxSegmentRefID>58ea2145-00e9-4a3b-a57b-561ae74aa758</PaxSegmentRefID>
                                    </PaxSegmentRef>
                                </EligibilityFlightAssociations>
                                <PaxRefID>Pax-1</PaxRefID>
                            </Eligibility>
                            <OfferItemID>d5fa2a44-e842-4c40-9f31-cf679c90cb28</OfferItemID>
                            <TicketDocTypeCode>Y</TicketDocTypeCode>
                            <Service>
                                <ServiceDefinitionRefID>af38d0b2-0532-44fb-9416-146967ed601a</ServiceDefinitionRefID>
                                <ServiceID>0d9ee103-f732-492c-94bb-fc39611447a9</ServiceID>
                                <ValidatingPartyRefID>5e2a151d-fee1-4ff4-b57b-6536517b7842</ValidatingPartyRefID>
                            </Service>
                            <UnitPrice>
                                <TotalAmount CurCode="RUB">270.00</TotalAmount>
                            </UnitPrice>
                        </ALaCarteOfferItem>
                        <OfferExpirationTimeLimitDateTime>2024-03-28T07:22:16.8240702Z</OfferExpirationTimeLimitDateTime>
                        <OfferID>5af0232b-6f27-4e2b-a28b-40c2582055ff</OfferID>
                        <Name>Трэвел-услуги</Name>
                        <ServiceCategory>TS</ServiceCategory>
                        <OwnerCode Provider="SL TECH">TCH</OwnerCode>
                    </ALaCarteOffer>

Один страховой продукт оформляется на все сегменты на одного пассажира.

Типы страховых продуктов можно увидеть в ServiceDefinitionList:

<ServiceDefinition>
                  <BookingInstructions>
                      <MethodText>API</MethodText>
              </BookingInstructions>
                <Desc>
                    <DescText>Комплексное страхование путешествующих и их имущества на время перелета</DescText>
                         </Desc>
                                <Name>СТРАХОВАНИЕ</Name>
                                <OwnerCode Provider="SL TECH">TCH</OwnerCode>
                                <RFIC>D</RFIC>
                                <RFISC>0BG</RFISC>
                                <ServiceGroup>TS</ServiceGroup>
                                <ServiceDefinitionID>b882c457-a231-4ae7-b83a-c13e194915bb</ServiceDefinitionID>
                            </ServiceDefinition>
                            <ServiceDefinition>
                                <BookingInstructions>
                                    <MethodText>API</MethodText>
                                </BookingInstructions>
                                <Desc>
                                    <DescText>Комплексное страхование путешествующих и их имущества на время перелета и страхование задержки и отмены рейса</DescText>
                                </Desc>
                                <Name>СТРАХОВАНИЕ</Name>
                                <OwnerCode Provider="SL TECH">TCH</OwnerCode>
                                <RFIC>D</RFIC>
                                <RFISC>0BG</RFISC>
                                <ServiceGroup>TS</ServiceGroup>
                                <ServiceDefinitionID>af38d0b2-0532-44fb-9416-146967ed601a</ServiceDefinitionID>
                            </ServiceDefinition>

На данный момент реализованы следующие виды страховых программ для следующего вида транспорта:

Программа Наименование в DescText Транспорт
1 АВИА багаж+НС Комплексное страхование путешествующих и их имущества на время перелета. АВИА
2 АВИА багаж+НС+Рейс (задержка, отмена) Комплексное страхование путешествующих и их имущества на время перелета и страхование задержки и отмены рейса АВИА
3 АВИА НС+Рейс Комплексное страхование путешествующих  и страхование отмены рейса АВИА
4 Автобусы НС Комплексное страхование путешествующих на время поездки Автобусы
5 Автобусы НС+Рейс Комплексное страхование путешествующих на время поездки и страхование задержки и отмены рейса Автобусы
6 Стыковки+НС+Отмена поездки Комплексное страхование путешествующих и страхование риска срыва стыковки и отмены поездки Любой транспорт

Бронирование страховых продуктов

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

Бронирование может осуществляться двумя методами:

1) При бронировании Offer на перевозку с помощью Mixvel_OrderCreateRQ:

Показать пример Mixvel_OrderCreateRQ на этой странице

<MixEnv:Envelope xmlns:MixEnv="https://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="{{$randomUUID}}" TimeSent="{{$isoTimestamp}}"/>
        <AppData>
            <m:Mixvel_OrderCreateRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderCreateRQ/1_01">
                <Request>
                    <CreateOrder>
                        <SelectedOffer>
                            <OfferRefID>{{Offer 1}}</OfferRefID>
                            <SelectedOfferItem>
                                <OfferItemRefID>{{OfferItem 1 1}}</OfferItemRefID>
                                <PaxRefID>Pax-1</PaxRefID>
                            </SelectedOfferItem>
                        </SelectedOffer>
                        <SelectedOffer> - указывается Offer и OfferItem по аналогии с бронированием дополнительной услуги!    
                            <OfferRefID>{{ALaCarteOffer 1}}</OfferRefID>
                            <SelectedOfferItem>
                                <OfferItemRefID>{{ALaCarteOfferItem 1 2}}</OfferItemRefID>
                                <PaxRefID>Pax-1</PaxRefID>
                            </SelectedOfferItem>
                        </SelectedOffer>
                    </CreateOrder>
                    <DataLists>
                        <ContactInfoList>
                            <ContactInfo>
                                <ContactInfoID>Contact-1</ContactInfoID>
                                <EmailAddress>
                                    <ContactTypeText>personal</ContactTypeText>
                                    <EmailAddressText>d.y.ivanov@gmail.com</EmailAddressText>
                                </EmailAddress>
                                <Phone>
                                    <ContactTypeText>personal</ContactTypeText>
                                    <PhoneNumber>+79202457834</PhoneNumber>
                                </Phone>
                            </ContactInfo>
                        </ContactInfoList>
                        <PaxList>
                            <Pax>
                                <AgeMeasure>30</AgeMeasure>
                                <ContactInfoRefID>Contact-1</ContactInfoRefID>
                                <IdentityDoc>
                                    <ExpiryDate>2030-04-12</ExpiryDate>
                                    <IdentityDocID>7001451111</IdentityDocID>
                                    <IdentityDocTypeCode>PS</IdentityDocTypeCode>
                                    <IssueDate>2020-04-12</IssueDate>
                                    <IssuingCountryCode>RU</IssuingCountryCode>
                                    <Surname>Ivanova</Surname>
                                </IdentityDoc>
                                <Individual>
                                    <Birthdate>1991-04-12</Birthdate>
                                    <GenderCode>F</GenderCode>
                                    <GivenName>Alina</GivenName>
                                    <MiddleName>Iurevna</MiddleName>
                                    <Surname>Ivanova</Surname>
                                    <PrefixName>Ms</PrefixName>
                                </Individual>
                                <PaxID>Pax-1</PaxID>
                                <PTC>ADT</PTC>
                            </Pax>
                        </PaxList>
                    </DataLists>
                    <PaymentFunctions>
                        <PaymentProcessingDetails>
                            <PaymentProcessingDetailsPaymentMethod>
                                <OtherPaymentMethod />
                            </PaymentProcessingDetailsPaymentMethod>
                        </PaymentProcessingDetails>
                    </PaymentFunctions>
                </Request>
            </m:Mixvel_OrderCreateRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

2) При добавлении дополнительной услуги запросом Mixvel_OrderChangeRQ в уже забронированный или оплаченный заказ:

Показать пример Mixvel_OrderChangeRQ на этой странице

<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="2021-03-17T18:37:48Z"/>
        <AppData>
            <m:Mixvel_OrderChangeRQ
                xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderChangeRQ/1_00">
                <Request
                    xmlns="">
                    <ChangeOrder>
                        <UpdateOrderItem>
                            <AcceptOffer>
                                <SelectedOffer>
                                    <OfferRefID>6c2f6459-cd69-42a0-853f-754d6e6abbe9</OfferRefID>
                                    <SelectedOfferItem>
                                        <OfferItemRefID>051e24ab-9cae-491d-9a6b-64dff2a60763</OfferItemRefID>
                                        <PaxRefID>Pax-3</PaxRefID>
                                    </SelectedOfferItem>
                                </SelectedOffer>
                            </AcceptOffer>
                        </UpdateOrderItem>
                    </ChangeOrder>
                    <DataLists>
                        <ContactInfoList>
                            <ContactInfo>
---
                            </ContactInfo>
                        </ContactInfoList>
                        <PaxList>
---
                        </PaxList>
                    </DataLists>
                    <MixOrder>
                        <MixOrderID>09461-240213-MYH8250</MixOrderID>
                    </MixOrder>
                </Request>
            </m:Mixvel_OrderChangeRQ>
        </AppData>
    </Body>
</MixEnv:Envelope>

В ответном сообщении возвращается информация о забронированном заказе, в котором будет один MixOrder, бронирование по авиа/автобусному заказу будет иметь отдельный Order, по страхованию – отдельный Order, например:

Показать пример Mixvel_OrderViewRS на этой странице

...
<Order>
    <BookingRef>
        <BookingEntity>
            <Carrier>
                <AirlineDesigCode>Я4</AirlineDesigCode>
            </Carrier>
        </BookingEntity>
        <BookingID>150931</BookingID>
    </BookingRef>
    <OrderID>09461-240328-OYH8748</OrderID>
    <OrderItem>
        <OrderItemID>a8ad9807-8295-4b65-b0ba-73f19983d5fb</OrderItemID>
        <OwnerCode Provider="SL TECH">TCH</OwnerCode>
        <Price>
            <BaseAmount CurCode="RUB">270.00</BaseAmount>
            <EquivAmount CurCode="RUB">270.00</EquivAmount>
            <TotalAmount CurCode="RUB">270.00</TotalAmount>
        </Price>
        <Service>
            <PaxRefID>Pax-1</PaxRefID>
            <ValidatingPartyRefID>11262d06-9058-43bc-9524-1987df9ef57b</ValidatingPartyRefID>
            <ServiceAssociations>
                <ServiceDefinitionRef>
                    <ServiceDefinitionRefFlightAssociations>
                        <PaxSegmentRef>
                            <PaxSegmentRefID>09101d68-8b42-49d4-aad3-f42b7c7fbc8e</PaxSegmentRefID>
                        </PaxSegmentRef>
                    </ServiceDefinitionRefFlightAssociations>
                    <ServiceDefinitionRefID>dc2ec4ee-c25d-441a-b8d8-65afaa21fc89</ServiceDefinitionRefID>
                </ServiceDefinitionRef>
            </ServiceAssociations>
            <ServiceID>922e5253-a378-49e5-a9ab-568751071a5f</ServiceID>
            <StatusCode>HD</StatusCode>
        </Service>
    </OrderItem>
    <OriginDestRefID>accbc1cc-3973-477d-b67c-095fdc7320e0</OriginDestRefID>
    <OwnerCode Provider="SL TECH">TCH</OwnerCode>
    <RelevanceDateTime>2024-03-28T06:53:11.8668528Z</RelevanceDateTime>
    <StatusCode>OPENED</StatusCode>
    <TotalPrice>
        <BaseAmount CurCode="RUB">270.00</BaseAmount>
        <EquivAmount CurCode="RUB">270.00</EquivAmount>
        <TotalAmount CurCode="RUB">270.00</TotalAmount>
    </TotalPrice>
</Order>
<TotalAmount CurCode="RUB">2283.00</TotalAmount>
</MixOrder>

Сумма всего заказа отображается в MixOrder/TotalAmount. Для дальнейшей оплаты необходимо использовать данные, полученные в PaymentFunctions. Обратите внимание, PaymentFunctions формируется на каждый Order, для авиа/автобусной перевозки и для страхования.

                    <PaymentFunctions>
                        <OrderAssociation>
                            <OrderRefID>09461-240328-OYH8747</OrderRefID>
                        </OrderAssociation>
                        <PaymentProcessingSummary>
                            <Amount CurCode="RUB">2013.00</Amount>
                            <PaymentID>7cc82f47-2a6a-4420-a024-82ca20f9e251</PaymentID>
                            <PaymentProcessingDetailsPaymentMethod>
                                <OtherPaymentMethod />
                            </PaymentProcessingDetailsPaymentMethod>
                        </PaymentProcessingSummary>
                    </PaymentFunctions>
                    <PaymentFunctions>
                        <OrderAssociation>
                            <OrderRefID>09461-240328-OYH8748</OrderRefID>
                        </OrderAssociation>
                        <PaymentProcessingSummary>
                            <Amount CurCode="RUB">270.00</Amount>
                            <PaymentID>d31a55bb-f533-4f1b-b683-d28555abcc82</PaymentID>
                            <PaymentProcessingDetailsPaymentMethod>
                                <OtherPaymentMethod />
                            </PaymentProcessingDetailsPaymentMethod>
                        </PaymentProcessingSummary>
                    </PaymentFunctions>

Проведение оплаты страховок

Процесс оплаты страховых продуктов происходит только по данным, полученным из API Mixvel Gate. Просьба на этапе тестирования проверять корректность суммы списания денежных средств по TotalAmount всего MixOrder!

Пример запроса, аналогичен оплате заказа MixOrder, с формой оплаты – наличные:

<Body id="ID1">
        <MessageInfo MessageId="{{$randomUUID}}" TimeSent="{{$isoTimestamp}}"/>
        <AppData>
            <m:Mixvel_OrderChangeRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderChangeRQ/1_00">
                <Request>
                    <MixOrder>
                        <MixOrderID>{{MixOrder}}</MixOrderID>
                    </MixOrder>
                    <PaymentFunctions>
                        <PaymentProcessingDetails>
                            <Amount CurCode="RUB">{{TotalAmount}}</Amount>
                        <PaymentProcessingDetailsPaymentMethod>
                            <OtherPaymentMethod/>
                        </PaymentProcessingDetailsPaymentMethod>
                    </PaymentProcessingDetails>
                </PaymentFunctions>
            </Request>
        </m:Mixvel_OrderChangeRQ>
    </AppData>
</Body>

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

1) Информация по страховому полису и его pdf-версия в TicketReceipt/URL.

Показать пример Mixvel_OrderViewRS на этой странице

<TicketDocInfo>
    <BookingRef>
        <BookingEntity>
            <Carrier>
                <AirlineDesigCode>Я4</AirlineDesigCode>
            </Carrier>
        </BookingEntity>
        <BookingID>150931</BookingID>
    </BookingRef>
    <FareDetail>
        <FarePriceType>
            <Price>
                <BaseAmount CurCode="RUB">270.00</BaseAmount>
                <EquivAmount CurCode="RUB">270.00</EquivAmount>
                <TotalAmount CurCode="RUB">270.00</TotalAmount>
            </Price>
        </FarePriceType>
    </FareDetail>
    <OrderRef>
        <OrderID>09461-240328-OYH8748</OrderID>
        <OwnerCode>TCH</OwnerCode>
    </OrderRef>
    <IssueDateTime>2024-03-28T06:57:51.770683+00:00</IssueDateTime>
    <PaxRefID>Pax-1</PaxRefID>
    <ServicingAgency>
        <AgencyID>TCH</AgencyID>
    </ServicingAgency>
    <Ticket>
        <Coupon>
            <CouponNumber>1</CouponNumber>
            <CouponStatusCode>O</CouponStatusCode>
            <RFIC>D</RFIC>
            <RFISC>0BG</RFISC>
        </Coupon>
        <TicketReceipt>
            <URL>https://minio.d-dev.sl-tech.ru/printer-dev/d5f2d0248de34bcd91b42a887913136d.pdf</URL>
        </TicketReceipt>
        <ReportingTypeCode>Not applicable</ReportingTypeCode>
        <TicketDocTypeCode>Y</TicketDocTypeCode>
        <TicketNumber>001-TKP-U1.007507</TicketNumber>
    </Ticket>
</TicketDocInfo>

2) Информация о выписанном EMD в стоке ТКП с ссылкой на pdf-версию EMD в TicketReceipt/URL и данными для его самостоятельного формирования.

Показать пример Mixvel_OrderViewRS на этой странице

<TicketDocInfo>
    <BookingRef>
        <BookingEntity>
            <Carrier>
                <AirlineDesigCode>Я4</AirlineDesigCode>
            </Carrier>
        </BookingEntity>
        <BookingID>150931</BookingID>
    </BookingRef>
    <FareDetail>
        <FarePriceType>
            <Price>
                <BaseAmount CurCode="RUB">270.00</BaseAmount>
                <EquivAmount CurCode="RUB">270.00</EquivAmount>
                <TotalAmount CurCode="RUB">270.00</TotalAmount>
            </Price>
        </FarePriceType>
    </FareDetail>
    <OrderRef>
        <OrderID>09461-240328-OYH8748</OrderID>
        <OwnerCode>TCH</OwnerCode>
    </OrderRef>
    <IssueDateTime>2024-03-28T06:57:51.770683+00:00</IssueDateTime>
    <PaxRefID>Pax-1</PaxRefID>
    <ServicingAgency>
        <AgencyID>09461</AgencyID>
    </ServicingAgency>
    <Ticket>
        <ConnectedDocNumber>001-TKP-U1.007507</ConnectedDocNumber>
        <Coupon>
            <CouponNumber>1</CouponNumber>
            <CouponStatusCode>O</CouponStatusCode>
            <RFIC>D</RFIC>
            <RFISC>0BG</RFISC>
        </Coupon>
        <TicketReceipt>
            <URL>https://s3.sirena-research.ru/itinerary.receipts/09461-240328-OYH8748.42K1000544702.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&amp;X-Amz-Credential=minio%2F20240328%2Fus-east-1%2Fs3%2Faws4_request&amp;X-Amz-Date=20240328T065758Z&amp;X-Amz-Expires=604800&amp;X-Amz-SignedHeaders=host&amp;response-content-type=application%2Fpdf&amp;X-Amz-Signature=46fbadca1d38f2e8d89c6e140ab3fdbfdc0a12cfc5342b45d95efaaa52779cfc</URL>
        </TicketReceipt>
        <TicketReceiptData>
            <EMDForm>
                <IssuePlace>
                    <AgencyCodeSession>99ГРС ТКП</AgencyCodeSession>
                    <AgencyName>ЗАО СИРЕНА-ТРЭВЕЛ</AgencyName>
                    <CityCountry>МОСКВА РФ</CityCountry>
                    <POS_CodeOperatorCodeCalculationMethod>92190744     3002 0</POS_CodeOperatorCodeCalculationMethod>
                </IssuePlace>
                <OrgIssued>ООО СЛ ТЕХНОЛОГИИ</OrgIssued>
                <EMDNumber>42K1000544702</EMDNumber>
                <IssueDate>28МАР24</IssueDate>
                <TourCodeType>Я4/02</TourCodeType>
                <EndorsType>
                    <EndorType>КВИТАНЦИЯ ЯВЛЯЕТСЯ УВЕДОМЛЕНИЕМ ОБ ОФОРМЛЕННОЙ УСЛУГЕ</EndorType>
                </EndorsType>
                <IndividualName>IVANOVA/ALINA I MS</IndividualName>
                <IdentityDocType>ПС7001451111</IdentityDocType>
                <PTAInfo>20 ДОП. УСЛУГИ</PTAInfo>
                <RFISCType>D 0BG</RFISCType>
                <RFISCText>СТРАХОВАНИЕ</RFISCText>
                <SummaryText>ДВЕСТИ СЕМЬДЕСЯТ</SummaryText>
                <CurCode>РУБ</CurCode>
                <Summary>270</Summary>
                <TotalAmount>270РУБ</TotalAmount>
                <PaymentProcessingSummary>НАЛ</PaymentProcessingSummary>
                <BookingData>00070X/1K 150931/Я4</BookingData>
                <RemarkText>ДАТА ОКАЗАНИЯ УСЛУГИ: 10.04.2024
СТРАХОВАЯ КОМПАНИЯ: ПАО "ГРУППА РЕНЕССАНС СТРАХОВАНИЕ"
СТРАХОВОЙ ПОЛИС: 001-TKP-U1.007507
СТРАХОВАНИЕ ПАССАЖИРА АВИАТРАНСПОРТА</RemarkText>
            </EMDForm>
        </TicketReceiptData>
        <ReportingTypeCode>TCH ETS</ReportingTypeCode>
        <TicketDocTypeCode>Y</TicketDocTypeCode>
        <TicketNumber>42K1000544702</TicketNumber>
    </Ticket>
</TicketDocInfo>

Вторичные операции

Вторичные операции, разрешенные со страховыми продуктами: 1) Mixvel_OrderCancelRQ – аннулирование страхового полиса и EMD. 2) Mixvel_OrderReshopRQ + Mixvel_OrderChangeRQ - возврат страхового полиса и EMD.

Аннулирование страхового полиса

Аннулирование страхового полиса может осуществляться одновременно с заказом или отдельно от заказа на перевозку (до момента оплаты или уже после).

Если необходимо аннулировать весь заказ MixOrder, в котором также есть страховой продукт, направляется запрос:

<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="2021-03-17T19:37:48Z"/>
    <AppData>
      <m:Mixvel_OrderCancelRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderCancelRQ/1_01">
        <Request>
          <MixOrder>
            <MixOrderID>09461-240213-MYH8222</MixOrderID>
          </MixOrder>
        </Request>
      </m:Mixvel_OrderCancelRQ>
    </AppData>
  </Body>
</MixEnv:Envelope>

Если необходимо аннулировать отдельно страховой полис или же наоборот, только заказ на перевозку, то в запросе Mixvel_OrderCancelRQ указывается тот Order, который подлежит аннулированию, например:

<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="2021-03-17T19:37:48Z"/>
    <AppData>
      <m:Mixvel_OrderCancelRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderCancelRQ/1_01">
        <Request>
          <MixOrder>
            <MixOrderID>09461-240213-MYH8222</MixOrderID>
            <Order>
                <OrderID>{{Order}}</OrderID>
            </Order>
          </MixOrder>
        </Request>
      </m:Mixvel_OrderCancelRQ>
    </AppData>
  </Body>
</MixEnv:Envelope>

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

Возврат страхового полиса

Возврат страхового полиса может быть осуществлен отдельно, со всем заказом целиком, либо возможен возврат заказа, в котором есть страховой полис, без возврата самого полиса.

Возврат происходит в два этапа:

1) Расчет суммы к возврату запросом Mixvel_OrderReshopRQ:

Показать пример Mixvel_OrderReshopRQ на этой странице

<MixEnv:Envelop xmlns:MixEnv="http://www.mixvel.com/API/XSD/mixvel_envelope/1_06">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="{{$randomUUID}}" TimeSent="{{$isoTimestamp}}"/>
        <AppData>
            <m:Mixvel_OrderReshopRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderReshopRQ/1_00">
                <Request>
                    <MixOrder>
                        <MixOrderID>{{MixOrder}}</MixOrderID>
                    </MixOrder>
                    <ResponseParameters>
                        <PricingParameter>
                            <AutoExchInd>true</AutoExchInd>
                        </PricingParameter>
                        <ReasonCode>Voluntary</ReasonCode>
                    </ResponseParameters>
                    <UpdateOrder>
                        <RefundOrder>
                            <OrderRefID>{{Order 1}}</OrderRefID>
                        </RefundOrder>
                        <RefundOrder>
                            <OrderRefID>{{Order 2}}</OrderRefID>
                        </RefundOrder>
                    </UpdateOrder>
                </Request>
            </m:Mixvel_OrderReshopRQ>
        </AppData>
    </Body>
</MixEnv:Envelop>

В ответном сообщении отображается возврат по каждому Order отдельно. Необходимо это учесть при дальнейшем указании какой именно Order необходимо вернуть.

Показать пример Mixvel_OrderReshopRS на этой странице

<?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="b53535a7-4a83-4328-9d01-e42a6e5ef482" ReplyTo="244327e5-0b55-46cd-b002-6738a8acc53d" TimeSent="2024-03-28T07:00:13.3272331Z" />
        <AppData>
            <Reshop:Mixvel_OrderReshopRS xmlns:Reshop="https://www.mixvel.com/API/XSD/Mixvel_OrderReshopRS/1_00">
                <Response>
                    <ReshopResults>
                        <ReshopOffers>
                            <Offer OrderId="09461-240328-OYH8747">
                                <DeleteOrderItem>
                                    <ExistingOrderItem>
                                        <OrderItemRefID>79296c59-5a93-445d-998d-ea99d8341706</OrderItemRefID>
                                        <PriceDifferential>
                                            <DiffPrice>
                                                <FareDetail>
                                                    <FareComponent>
                                                        <CabinType>
                                                            <CabinTypeCode>Economy</CabinTypeCode>
                                                        </CabinType>
                                                        <TicketCoupon>1</TicketCoupon>
                                                        <FareBasisCode>FOMOW</FareBasisCode>
                                                        <FareRule>
                                                            <RuleCode>0204</RuleCode>
                                                        </FareRule>
                                                        <PaxSegmentRefID>09101d68-8b42-49d4-aad3-f42b7c7fbc8e</PaxSegmentRefID>
                                                        <Price>
                                                            <BaseAmount CurCode="RUB">100.00</BaseAmount>
                                                            <BaseAmountGuaranteeTimeLimitDateTime>2024-03-28T10:23:00</BaseAmountGuaranteeTimeLimitDateTime>
                                                            <Fee>
                                                                <Amount CurCode="RUB">100.00</Amount>
                                                                <FeeCode>CP</FeeCode>
                                                            </Fee>
                                                            <TaxSummary>
                                                                <Tax>
                                                                    <Amount CurCode="RUB">1350.00</Amount>
                                                                    <QualifierCode>aircompany</QualifierCode>
                                                                    <TaxCode>YR</TaxCode>
                                                                    <TaxOperation>Refund</TaxOperation>
                                                                </Tax>
                                                                <Tax>
                                                                    <Amount CurCode="RUB">120.00</Amount>
                                                                    <QualifierCode>aircompany</QualifierCode>
                                                                    <TaxCode>RI</TaxCode>
                                                                    <TaxOperation>Refund</TaxOperation>
                                                                </Tax>
                                                                <Tax>
                                                                    <Amount CurCode="RUB">258.00</Amount>
                                                                    <QualifierCode>aircompany</QualifierCode>
                                                                    <TaxCode>RI</TaxCode>
                                                                    <TaxOperation>Refund</TaxOperation>
                                                                </Tax>
                                                                <TotalTaxAmount CurCode="RUB">1728.00</TotalTaxAmount>
                                                            </TaxSummary>
                                                            <TotalAmount CurCode="RUB">1728.00</TotalAmount>
                                                        </Price>
                                                        <RBD>
                                                            <RBD_Code>F</RBD_Code>
                                                        </RBD>
                                                        <TicketDesigCode />
                                                    </FareComponent>
                                                    <PaxRefID>Pax-1</PaxRefID>
                                                </FareDetail>
                                                <Price>
                                                    <TotalAmount CurCode="RUB">1728.00</TotalAmount>
                                                </Price>
                                            </DiffPrice>
                                        </PriceDifferential>
                                    </ExistingOrderItem>
                                </DeleteOrderItem>
                                <OfferExpirationTimeLimitDateTime>2024-03-28T07:14:13.2584223Z</OfferExpirationTimeLimitDateTime>
                                <OfferID>f7996fc4-0db9-4e23-82c3-9ab0c105612a</OfferID>
                                <OwnerCode>TCH</OwnerCode>
                                <PenaltyRefID>cc876603-54fd-400b-9aff-60ad25dbd796</PenaltyRefID>
                                <TotalPrice>
                                    <TotalAmount CurCode="RUB">1728.00</TotalAmount>
                                </TotalPrice>
                            </Offer>
                            <Offer OrderId="09461-240328-OYH8748">
                                <DeleteOrderItem>
                                    <ExistingOrderItem>
                                        <OrderItemRefID>a8ad9807-8295-4b65-b0ba-73f19983d5fb</OrderItemRefID>
                                        <PriceDifferential>
                                            <DiffPrice>
                                                <Price>
                                                    <BaseAmount CurCode="RUB">270.00</BaseAmount>
                                                    <EquivAmount CurCode="RUB">270.00</EquivAmount>
                                                    <TotalAmount CurCode="RUB">270.00</TotalAmount>
                                                </Price>
                                            </DiffPrice>
                                        </PriceDifferential>
                                    </ExistingOrderItem>
                                </DeleteOrderItem>
                                <OfferExpirationTimeLimitDateTime>2024-03-28T07:30:08.7832266Z</OfferExpirationTimeLimitDateTime>
                                <OfferID>8db0d446-0baa-4a87-abf2-bc6bae187875</OfferID>
                                <OwnerCode Provider="SL TECH">TCH</OwnerCode>
                                <TotalPrice>
                                    <TotalAmount CurCode="RUB">270.00</TotalAmount>
                                </TotalPrice>
                            </Offer>
                        </ReshopOffers>
                    </ReshopResults>
                    <DataLists>
                        <PaxList>
---
                        </PaxList>
                        <PaxSegmentList>
                            ---
                        </PaxSegmentList>
                        <PenaltyList>
                            <Penalty>
                                <PenaltyID>cc876603-54fd-400b-9aff-60ad25dbd796</PenaltyID>
                                <Price>
                                    <BaseAmount CurCode="RUB">100.00</BaseAmount>
                                </Price>
                                <TypeCode>Cancellation</TypeCode>
                            </Penalty>
                        </PenaltyList>
                    </DataLists>
                </Response>
            </Reshop:Mixvel_OrderReshopRS>
        </AppData>
    </Body>
</MixEnv:Envelope>

Далее проводится процедура возврата с использованием запроса Mixvel_OrderChangeRQ, отдельно указывая каждый OfferRefID, полученный на предыдущем этапе Mixvel_OrderReshopRS в

.../ChangeOrder/UpdateOrderItem/DeleteOrderItemList/DeleteOrderItem/OfferRefID

Показать пример Mixvel_OrderChangeRQ на этой странице

<MixEnv:Envelop
    xmlns:MixEnv="http://www.mixvel.com/API/XSD/mixvel_envelope/1_04">
    <Header/>
    <Body id="ID1">
        <MessageInfo MessageId="{{$randomUUID}}" TimeSent="{{$isoTimestamp}}"/>
        <AppData>
            <m:Mixvel_OrderChangeRQ xmlns:m="https://www.mixvel.com/API/XSD/Mixvel_OrderChangeRQ/1_00">
                <Request>
                    <ChangeOrder>
                        <UpdateOrderItem>
                            <DeleteOrderItemList>
                                <DeleteOrderItem>
                                    <OfferRefID>f7996fc4-0db9-4e23-82c3-9ab0c105612a</OfferRefID>
                                </DeleteOrderItem>
                                <DeleteOrderItem>
                                    <OfferRefID>8db0d446-0baa-4a87-abf2-bc6bae187875</OfferRefID>
                                </DeleteOrderItem>
                            </DeleteOrderItemList>
                        </UpdateOrderItem>
                    </ChangeOrder>
                    <MixOrder>
                        <MixOrderID>{{MixOrder}}</MixOrderID>
                    </MixOrder>
                </Request>
            </m:Mixvel_OrderChangeRQ>
        </AppData>
    </Body>
</MixEnv:Envelop>

В ответ по возвращаемому EMD получаем 2 документа:

  1. документ о возврате в ServiceNotice в формате pdf;
  2. справку о возврате в RefundReceipt в формате pdf и в ReceiptForm в формате для самостоятельной печати.

Важная информация

  1. Страховой полис оформляется на каждого пассажира отдельно.
  2. Страховой полис оформляется на все сегменты перевозки текущего заказа
  3. Оплата страховых полисов на данный момент доступна только в рублях.
  4. Предложение страховых полисов доступно только на сегментах, конечной или начальной точкой в котором является РФ.
  5. Возврат происходит в следующих случаях: а) при отказе от перевозки до ее начала – 100%; б) при отказе от полиса до начала перевозки без отказа от перевозки 100%; в) при отказе от полиса в течение 14 дней со дня оформления, даже если по срокам поездка начата – 100%; г) при отказе от полиса по истечении 14 дней и после даты начала перевозки – возврата нет. В системе настроены правила возврата, если возврат осуществлен по каким-то неописанным причинам, появится предупреждение о необходимости обратиться в страховую компанию
  6. При бронировании страховых продуктов необходимо передавать контактные данные пассажиров. Для ребенка будут использоваться контактные данные взрослого, если явно не указаны другие.