Веб-служба возврата авиабилетов: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
Строка 1: Строка 1:
 +
[[Категория:Интеграция]]
 +
<!-- -->
 +
== Информация ==
 +
 
Процесс возврата билетов осуществляется в два этапа:<br>
 
Процесс возврата билетов осуществляется в два этапа:<br>
 
1. Получение суммы к возврату на каждого пассажира, выполняется запросом '''GetRefundData'''. <br>
 
1. Получение суммы к возврату на каждого пассажира, выполняется запросом '''GetRefundData'''. <br>
Строка 4: Строка 8:
 
2. Возврат билетов выполняется запросом '''RefundTicket'''. <br>
 
2. Возврат билетов выполняется запросом '''RefundTicket'''. <br>
 
В ответе приходит информация о сегментах, тарифах, пассажирах и оплате.<br>
 
В ответе приходит информация о сегментах, тарифах, пассажирах и оплате.<br>
 +
 +
== Общий формат запроса / ответа получения информации по возврату ==
 +
В данном запросе необходимо указать номер заказа, идентификаторы пассажиров, для которых выполняется возврат, тип возврата (вынужденный/добровольный) и сегменты к возврату. <br>
 +
WSDL: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=GetRefundData <br>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 +
==== Запрос ====
 +
<div class="mw-collapsible-content">
 +
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DGetRefundData">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <ver:GetRefundData>
 +
        <RequestBin>
 +
            <Request>
 +
              <GetRefundData>
 +
                  <BookID>?</BookID>
 +
                  <!--BookID — Id заказа в системе nemo.travel-->
 +
                  <Passengers>
 +
                    <!--Zero or more repetitions:-->
 +
                    <Id>?</Id>
 +
                    <!--Id — Id пассажира, для которого производится возврат. Нумерация начинается с 0, возможно указать
 +
                    несколько пассажиров.-->
 +
                  </Passengers>
 +
                  <Segments>
 +
                    <!--Zero or more repetitions:-->
 +
                    <Id>?</Id>
 +
                    <!--Id — Id сегмента к возврату. Нумерация начинается с 0, возможно указать несколько сегментов.-->
 +
                  </Segments>
 +
                  <IsCompelled>?</IsCompelled>
 +
                  <!--IsCompelled — тип возврата (вынужденные/добровольный), значения: true / false-->
 +
              </GetRefundData>
 +
            </Request>
 +
            <Source>
 +
              <ClientId>?</ClientId>
 +
              <!--ClientId — ID клиента в системе nemo.travel. Можно посмотреть/добавить в разделе
 +
              «Настройки системы» → «Интеграция» → «Nemo 1.0 (SOAP API)».-->
 +
              <APIKey>?</APIKey>
 +
              <!--APIKey — секретный ключ доступа к API nemo.travel. Можно посмотреть/добавить в разделе
 +
              «Настройки системы» → «Интеграция» → «Nemo 1.0 (SOAP API)».-->
 +
              <Language>?</Language>
 +
              <!--Language — язык, например: RU-->
 +
              <Currency>?</Currency>
 +
              <!-- Currency — валюта, например: RUB, EUR-->
 +
              <ShowNames>?</ShowNames>
 +
              <!-- ShowNames — отображение названий аэропортов, авиакомпаний и воздушных судов: true - отображать,
 +
              false - не отображать. Возвращает значение на том языке, который был указан в запросе.
 +
              Для RU - русский вариант, для UKR, EN, ES - латинский вариант. Опциональный элемент.  -->
 +
              <EndUserData>
 +
                  <EndUserIP>?</EndUserIP>
 +
                  <EndUserBrowserAgent>?</EndUserBrowserAgent>
 +
                  <RequestOrigin>?</RequestOrigin>
 +
              </EndUserData>
 +
            </Source>
 +
        </RequestBin>
 +
      </ver:GetRefundData>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
 +
 +
==== Ответ ====
 +
<div class="mw-collapsible-content">
 +
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
<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">
 +
  <SOAP-ENV:Body>
 +
      <ns1:GetRefundDataResponse>
 +
        <ResponseBin>
 +
            <Response>
 +
              <RefundData>
 +
                  <ClaimID>?</ClaimID>
 +
                  <!--ClaimID — Id заявки на возврат в системе nemo.travel-->
 +
                  <Status>?</Status>
 +
                  <!--Status — статус заявки, значения: all_data_saved - запрос успешно выполнен, можно переходить ко второму
 +
                  этапу, cancelled - в результате выполнения запроса произошла ошибка, сообщение об ошибке указано в параметре
 +
                  <Errors>. -->
 +
                  <RefundMoney Currency="?">?</RefundMoney>
 +
                  <!--RefundMoney Currency — сумма к возврату за всех пассажиров-->
 +
              </RefundData>
 +
              <Requisites/>
 +
              <RequestType xsi:nil="true"/>
 +
              <UserID xsi:nil="true"/>
 +
              <Errors/>
 +
            </Response>
 +
        </ResponseBin>
 +
      </ns1:GetRefundDataResponse>
 +
  </SOAP-ENV:Body>
 +
</SOAP-ENV:Envelope>
 +
</syntaxhighlight>
 +
</div>
 +
</div>

Версия 12:04, 23 июня 2016

Информация

Процесс возврата билетов осуществляется в два этапа:
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>