Веб-служба возврата авиабилетов

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску

Информация

Процесс возврата билетов осуществляется в два этапа:
1. Получение суммы к возврату на каждого пассажира, выполняется запросом GetRefundData.
Ответ на запрос содержит идентификатор заявки, статус заявки и сумму к возврату на всех пассажиров.
2. Возврат билетов выполняется запросом RefundTicket.
В ответе приходит информация о сегментах, тарифах, пассажирах и оплате.

Общий формат запроса / ответа получения информации по возврату

В данном запросе необходимо указать номер заказа, идентификаторы пассажиров, для которых выполняется возврат, тип возврата (вынужденный/добровольный) и сегменты к возврату.
WSDL: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=GetRefundData

Запрос

 1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DGetRefundData">
 2    <soapenv:Header/>
 3    <soapenv:Body>
 4       <ver:GetRefundData>
 5          <RequestBin>
 6             <Request>
 7                <GetRefundData>
 8                   <BookID>?</BookID>
 9                   <!--BookID — Id заказа в системе nemo.travel-->
10                   <Passengers>
11                      <!--Zero or more repetitions:-->
12                      <Id>?</Id>
13                      <!--Id — Id пассажира, для которого производится возврат. Нумерация начинается с 0, возможно указать 
14                      несколько пассажиров.-->
15                   </Passengers>
16                   <Segments>
17                      <!--Zero or more repetitions:-->
18                      <Id>?</Id>
19                      <!--Id — Id сегмента к возврату. Нумерация начинается с 0, возможно указать несколько сегментов.-->
20                   </Segments>
21                   <IsCompelled>?</IsCompelled>
22                   <!--IsCompelled — тип возврата (вынужденные/добровольный), значения: true / false-->
23                </GetRefundData>
24             </Request>
25             <Source>
26                <ClientId>?</ClientId>
27                <!--ClientId — ID клиента в системе nemo.travel. Можно посмотреть/добавить в разделе
28                «Настройки системы» → «Интеграция» → «Nemo 1.0 (SOAP API)».-->
29                <APIKey>?</APIKey>
30                <!--APIKey — секретный ключ доступа к API nemo.travel. Можно посмотреть/добавить в разделе
31                «Настройки системы» → «Интеграция» → «Nemo 1.0 (SOAP API)».-->
32                <Language>?</Language>
33                <!--Language — язык, например: RU-->
34                <Currency>?</Currency>
35                <!-- Currency — валюта, например: RUB, EUR-->
36                <ShowNames>?</ShowNames>
37                <!-- ShowNames — отображение названий аэропортов, авиакомпаний и воздушных судов: true - отображать,
38                false - не отображать. Возвращает значение на том языке, который был указан в запросе. 
39                Для RU - русский вариант, для UKR, EN, ES - латинский вариант. Опциональный элемент.  -->
40                <EndUserData>
41                   <EndUserIP>?</EndUserIP>
42                   <EndUserBrowserAgent>?</EndUserBrowserAgent>
43                   <RequestOrigin>?</RequestOrigin>
44                </EndUserData>
45             </Source>
46          </RequestBin>
47       </ver:GetRefundData>
48    </soapenv:Body>
49 </soapenv:Envelope>

Ответ

 1 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DGetRefundData" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 2    <SOAP-ENV:Body>
 3       <ns1:GetRefundDataResponse>
 4          <ResponseBin>
 5             <Response>
 6                <RefundData>
 7                   <ClaimID>?</ClaimID>
 8                   <!--ClaimID — Id заявки на возврат в системе nemo.travel-->
 9                   <Status>?</Status>
10                   <!--Status — статус заявки, значения: all_data_saved - запрос успешно выполнен, можно переходить ко второму
11                   этапу, cancelled - в результате выполнения запроса произошла ошибка, сообщение об ошибке указано в параметре
12                   <Errors>. -->
13                   <RefundMoney Currency="?">?</RefundMoney>
14                   <!--RefundMoney Currency — сумма к возврату за всех пассажиров-->
15                </RefundData>
16                <Requisites/>
17                <RequestType xsi:nil="true"/>
18                <UserID xsi:nil="true"/>
19                <Errors/>
20             </Response>
21          </ResponseBin>
22       </ns1:GetRefundDataResponse>
23    </SOAP-ENV:Body>
24 </SOAP-ENV:Envelope>