XML - результаты поиска/Поиск туров — различия между версиями

Материал из TourClient - Руководство пользователя
Перейти к: навигация, поиск
 
(не показана 141 промежуточная версия 4 участников)
Строка 1: Строка 1:
== Сервис Поиск туров ==
 
  
=== Запрос к сервису ===  
+
== Назначение сервиса ==
<source lang="xml">
+
=== Импорт данных в систему клиента ===
 +
Импорт данных в систему клиента может производиться для получения каких-то статистических показателей. Например расчета минимальных по каким-то параметрам. Или же организации каких-то своих сервисов.
  
<?xml version="1.0" encoding="UTF-8"?>
+
В этом случае используется [[XML_-_результаты_поиска/Поиск_туров/Тип_поиска_-_БД|Тип поиска - БД]].
<root>
+
    <TourSearchRequest>
+
        <dataOffset>0</dataOffset>
+
        <dataLimit>50</dataLimit>
+
  
        <seatStatus>3</seatStatus>
+
=== Организация поиска на сайте клиента ===
 +
Используется для организации сервиса подобного нашему модулю [[Поиск туров - результаты поиска]], когда клиент хочет самостоятельно управлять его работой. Позволяет получить результат в текущий момент наиболее соответствующий данным в системах туроператоров.
  
        <cityId>1000</cityId>
+
В этом случае используется [[XML_-_результаты_поиска/Поиск туров/Тип_поиска_-_Комбинированный|Тип поиска - комбинированный]].
        <countryId>12</countryId>
+
        <roomSizeId>14</roomSizeId>
+
  
        <adults>2</adults>
 
        <children>0</children>
 
  
        <childAge1>0</childAge1>
+
В зависимости от выбранного клиентом способа использования сервиса, администрацией TourClient выставляется соответствующая настройка сервиса - '''тип поиска'''. Клиенту изменение данной настройки недоступно.
        <childAge2>0</childAge2>
+
 
 +
Тип поиска определяет поведение сервиса и предоставляемые им данные.
  
        <durationFrom>7</durationFrom>
+
<br>
        <durationTill>14</durationTill>
+
  
        <departureFrom>2014-07-25</departureFrom>
+
== Описание интерфейсов ==
        <departureTill>2014-08-10</departureTill>
+
  
        <ticket>1</ticket>
+
* [[XML_-_результаты_поиска/Поиск_туров/Интерфейс_-_Результаты_поиска|Результаты поиска]]
 +
* [[XML_-_результаты_поиска/Поиск_туров/Интерфейс_-_Статус_поиска|Статус поиска]]
 +
* [[XML_-_результаты_поиска/Поиск_туров/Интерфейс_-_Результаты_поиска_по_отелю|Результаты поиска по отелю]]
 +
* [[XML_-_результаты_поиска/Поиск_туров/Интерфейс_-_Сводный_прайс_по_ночам|Сводный прайс по ночам]]
  
        <priceFrom>500</priceFrom>
 
        <priceTill>50000</priceTill>
 
        <currency>3</currency>
 
  
        <operatorIds>
+
Результаты возвращаемые сервисом содержат общие для системы объекты, описанные в
            <id>111</id>
+
* [[XML_экспорт/Описание_объектов|Описании объектов]]
            <id>222</id>
+
            <id>333</id>
+
        </operatorIds>
+
  
        <resortIds>
+
<br>
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </resortIds>
+
  
        <resortPlaceIds>
+
== Дополнительная информация ==
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </resortPlaceIds>
+
  
        <allocCatId>7</allocCatId>
+
* [[XML_-_результаты_поиска/Поиск_туров/Буфер_поиска|Буфер поиска]]
        <allocRate>3.56</allocRate>
+
* [[XML_-_результаты_поиска/Поиск_туров/Тип_поиска_-_БД|Тип поиска - БД]]
 +
* [[XML_-_результаты_поиска/Поиск туров/Тип_поиска_-_Комбинированный|Тип поиска - комбинированный]]
  
        <allocationIds>
+
<br>
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </allocationIds>
+
 
+
        <mealIds>
+
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </mealIds>
+
 
+
        <roomViewIds>
+
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </roomViewIds>
+
 
+
        <roomTypeIds>
+
            <id>111</id>
+
            <id>222</id>
+
            <id>333</id>
+
        </roomTypeIds>
+
 
+
    </TourSearchRequest>
+
</root>
+
 
+
</source>
+
 
+
=== Ответ сервиса ===
+
Сервис возвращает ответ, содержащий массив объектов Тур (Tours) и объект Статус поиска (SearchStatus)
+
 
+
<source lang="xml">
+
 
+
<?xml version="1.0" encoding="UTF-8"?>
+
<root>
+
    <Tours>
+
        <Tour>...</Tour>
+
        <Tour>...</Tour>
+
        <Tour>...</Tour>
+
        ...
+
    </Tours>
+
    <SearchStatus>
+
      ...
+
    </SearchStatus>
+
</root>
+
 
+
</source>
+
 
+
 
+
=== Сервис Статус поиска ===
+
 
+
 
+
 
+
 
+
 
+
 
+
=== Статус поиска ===
+
Сервис возвращает ответ, содержащий массив объектов Тур (Tours) и объект Статус поиска (SearchStatus)
+
 
+
 
+
== Описание объектов ==
+
=== Объект Тур ===
+
<source lang="xml">
+
 
+
<Tour>
+
    <id>3145968261@511</id>
+
    <operatorId>308</operatorId>
+
 
+
    <cityId>1000</cityId>
+
    <countryId>12</countryId>
+
    <roomSizeId>14</roomSizeId>
+
 
+
    <departure>2014-07-10</departure>
+
    <arrival>2014-07-17</arrival>
+
    <duration>7</duration>
+
    <ticket>1</ticket>
+
    <directFlight>false</directFlight>
+
 
+
    <price>18000</price>
+
    <currency>2</currency>
+
    <priceIsApprox>true</priceIsApprox>
+
 
+
    <priceOrig>500</priceOrig>
+
    <currencyOrig>1</currencyOrig>
+
 
+
    <prevPriceOrig>0</prevPriceOrig>
+
    <priceDiffPercent>0</priceDiffPercent>
+
 
+
    <ch1From>0</ch1From>
+
    <ch1Till>0</ch1Till>
+
    <ch2From>0</ch2From>
+
    <ch2Till>0</ch2Till>
+
 
+
    <resortId>4</resortId>
+
    <resortPlaceId>2392</resortPlaceId>
+
    <allocationId>12395</allocationId>
+
    <allocCatId>7</allocCatId>
+
    <mealId>2</mealId>
+
    <roomTypeId>4</roomTypeId>
+
    <roomViewId>22</roomViewId>
+
 
+
    <isStop>false</isStop>
+
    <isStopAllocation>false</isStopAllocation>
+
    <isStopFlight>false</isStopFlight>
+
 
+
    <OnlineSeatsState>
+
        <allocation>1</allocation>
+
        <flightThereEco>1</flightThereEco>
+
        <flightBackEco>1</flightBackEco>
+
        <flightThereBus>2</flightThereBus>
+
        <flightBackBus>2</flightBackBus>
+
        <isStopFlight>false</isStopFlight>
+
        <isStopAllocation>false</isStopAllocation>
+
    </OnlineSeatsState>
+
 
+
    <ExtraCharges>
+
        <visa>
+
            <min>25</min>
+
            <max>25</max>
+
            <currency>1</currency>
+
        </visa>
+
        <feeFuel>
+
            <min>0</min>
+
            <max>40</max>
+
            <currency>1</currency>
+
        </feeFuel>
+
    </ExtraCharges>
+
 
+
 
+
    <City>
+
        <id>1000</id>
+
        <name>Москва</name>
+
    </City>
+
 
+
    <Country>
+
        <id>12</id>
+
        <name>Египет</name>
+
    </Country>
+
 
+
    <Operator>
+
        <id>308</id>
+
        <name>Troyka</name>
+
    </Operator>
+
 
+
    <RoomSize>
+
        <id>14</id>
+
        <name>DBL</name>
+
        <description>2-е взрослых</description>
+
        <adults>2</adults>
+
        <children>0</children>
+
    </RoomSize>
+
 
+
    <Resort>
+
        <id>4</id>
+
        <name>Хургада</name>
+
    </Resort>
+
 
+
    <ResortPlace>
+
        <id>2392</id>
+
        <name>Эль-Дахар</name>
+
    </ResortPlace>
+
 
+
    <Allocation>
+
        <id>12395</id>
+
        <name>Sea View</name>
+
        <rate>2.5</rate>
+
    </Allocation>
+
 
+
    <AllocCat>
+
        <id>7</id>
+
        <name>2*</name>
+
    </AllocCat>
+
 
+
    <Meal>
+
        <id>1</id>
+
        <name>AI</name>
+
        <description>питание+напитки местного производства</description>
+
    </Meal>
+
 
+
    <RoomType>
+
        <id>13</id>
+
        <name>Executive</name>
+
        <description>улучш. номер "Executive"</description>
+
    </RoomType>
+
 
+
    <RoomView>
+
        <id>22</id>
+
        <name>ROH</name>
+
        <description>без опред. вида из номера</description>
+
    </RoomView>
+
 
+
</Tour>
+
 
+
</source>
+
 
+
===Объект Статус поиска===
+

Текущая версия на 16:54, 22 июня 2017

Назначение сервиса

Импорт данных в систему клиента

Импорт данных в систему клиента может производиться для получения каких-то статистических показателей. Например расчета минимальных по каким-то параметрам. Или же организации каких-то своих сервисов.

В этом случае используется Тип поиска - БД.

Организация поиска на сайте клиента

Используется для организации сервиса подобного нашему модулю Поиск туров - результаты поиска, когда клиент хочет самостоятельно управлять его работой. Позволяет получить результат в текущий момент наиболее соответствующий данным в системах туроператоров.

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


В зависимости от выбранного клиентом способа использования сервиса, администрацией TourClient выставляется соответствующая настройка сервиса - тип поиска. Клиенту изменение данной настройки недоступно.

Тип поиска определяет поведение сервиса и предоставляемые им данные.


Описание интерфейсов


Результаты возвращаемые сервисом содержат общие для системы объекты, описанные в


Дополнительная информация