Мастер-Тур(15):API для разработки онлайн поиска и бронирования — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Поиск туров (Tour))
 
(не показано 78 промежуточных версий 5 участников)
Строка 257: Строка 257:
 
** GET .../TourSearchOwin/CurrencyRates
 
** GET .../TourSearchOwin/CurrencyRates
 
* Принимаемые параметры:
 
* Принимаемые параметры:
** нет принимаемых параметров
+
** '''dateFrom''' – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
 +
** '''dateTo''' – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
 
* Возвращаемый результат:
 
* Возвращаемый результат:
 
** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6)
 
** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6)
 
** '''currencyId''' – идентификатор валюты, курс которой приводится
 
** '''currencyId''' – идентификатор валюты, курс которой приводится
 
** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''')
 
** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''')
 +
** '''date''' – дата, на которую был зарегистрирован выводимый курс валюты
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 268: Строка 270:
 
Вызов метода CurrencyRates
 
Вызов метода CurrencyRates
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/CurrencyRates
+
http://localhost:9000/TourSearchOwin/CurrencyRates?dateFrom=18.09.2024&dateTo=19.09.2024
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Возвращаемый результат метода CurrencyRates (в формате JSON)
 
Возвращаемый результат метода CurrencyRates (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
{
+
[
  "version": "1.08",
+
    {
  "currencyRates":   [
+
        "BaseCurrencyId": 14,
            {
+
        "CurrencyId": 1,
        "baseCurrencyId": 2,
+
        "Rate": 91.429200,
        "currencyId": 1,
+
        "Date": "18.09.2024"
        "rate": 65.256054
+
    },
      },
+
    {
            {
+
        "BaseCurrencyId": 14,
        "baseCurrencyId": 2,
+
        "CurrencyId": 2,
        "currencyId": 3,
+
        "Rate": 101.505700,
        "rate": 71.168955
+
        "Date": "18.09.2024"
      }
+
    },
  ]
+
    {
}
+
        "BaseCurrencyId": 14,
 +
        "CurrencyId": 1,
 +
        "Rate": 91.671200,
 +
        "Date": "19.09.2024"
 +
    },
 +
    {
 +
        "BaseCurrencyId": 14,
 +
        "CurrencyId": 2,
 +
        "Rate": 102.039000,
 +
        "Date": "19.09.2024"
 +
    }
 +
]
  
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 503: Строка 516:
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
 
** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']])
 
** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']])
 +
** '''type''' – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
 
** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
* Возвращаемый результат:
 
* Возвращаемый результат:
 
** '''Name''' – название страны
 
** '''Name''' – название страны
 
** '''Key''' – идентификатор страны
 
** '''Key''' – идентификатор страны
** '''DestinationType''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
 +
** '''IsExist''' – не используется
 +
** '''Data''' – массив данных для контекстного поиска
 +
*** '''CityKey''' – код города
 +
*** '''CityName''' – Название
 +
*** '''HotelKey''' – код отеля
 +
*** '''HotelName''' – название отеля
 +
*** '''ResortKey''' – код курорта
 +
*** '''ResortName''' – название курорта
 +
 
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 514: Строка 537:
 
Вызов метода Destination
 
Вызов метода Destination
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 +
 
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1
 
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 520: Строка 544:
 
[
 
[
 
       {
 
       {
       "Name": "Болгария",
+
       "Data": null,
       "Key": 359,
+
      "DestinationType": 1,
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 90,
 +
       "Name": "Австрия"
 +
   
 +
   
 
   },
 
   },
 
       {
 
       {
       "Name": "Индия",
+
       "Data": null,
       "Key": 26,
+
      "DestinationType": 1,
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 53,
 +
       "Name": "Тайланд"
 +
     
 +
     
 
   },
 
   },
 
       {
 
       {
       "Name": "Финляндия",
+
       "Data": null,
       "Key": 64,
+
      "DestinationType": 1,
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 460,
 +
       "Name": "Россия"
 +
     
 +
     
 
   }
 
   }
 +
]
 +
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1&type=1
 +
</syntaxhighlight>
 +
Возвращаемый результат метода Destination (в формате JSON) с включенной настройкой easySearchFilter
 +
<syntaxhighlight lang="java" enclose="div">
 +
[
 +
{
 +
  "Name": "Австрия",
 +
  "Key": 90,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
        {
 +
          "CityKey": 35,
 +
          "CityName": "Вена",
 +
          "HotelKey": 178,
 +
          "HotelName": "Ananas, 5+++*",
 +
          "ResortKey": 232,
 +
          "ResortName": "Малина"
 +
        },
 +
        {
 +
          "CityKey": 35,
 +
          "CityName": "Вена",
 +
          "HotelKey": 20748,
 +
          "HotelName": "Dev, 1-4*Boutique",
 +
          "ResortKey": 0,
 +
          "ResortName": ""
 +
        },
 +
      ],
 +
}
 +
{
 +
  "Name": "Тайланд",
 +
  "Key": 53,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
            "CityKey": 415,
 +
            "CityName": "Пхукет",
 +
            "HotelKey": 5263,
 +
            "HotelName": "7Q Hotel, HV",
 +
            "ResortKey": 123,
 +
            "ResortName": "Пхукет"
 +
          }
 +
        ],
 +
},
 +
{
 +
  "Name": "Россия",
 +
  "Key": 460,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
            "CityKey": 295,
 +
            "CityName": "Санкт-Петербург",
 +
            "HotelKey": 20365,
 +
            "HotelName": "Бристоль, 3*",
 +
            "ResortKey": 0,
 +
            "ResortName": ""
 +
          }
 +
        ],
 +
},
 +
{
 +
  "Name": "ОАЭ",
 +
  "Key": 2,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
          "CityKey": 12,
 +
          "CityName": "ДУБАЙ",
 +
          "HotelKey": 1257,
 +
          "HotelName": "Avari, APTH3",
 +
          "ResortKey": 0,
 +
          "ResortName": ""
 +
          },
 +
      ],
 +
}
 
]
 
]
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 585: Строка 703:
 
** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 
** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
Строка 591: Строка 709:
 
** '''Key''' – идентификатор типа тура
 
** '''Key''' – идентификатор типа тура
 
** '''Name''' – название типа тура
 
** '''Name''' – название типа тура
** '''ParentId''' – идентификатор группы, к которой относится данный типа тура (если тип тура не относится к группе, то возвращается ''null'')
+
** '''ParentId''' – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается ''null'')
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 631: Строка 749:
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
* Возвращаемый результат:
 
* Возвращаемый результат:
Строка 667: Строка 785:
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 
** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 
** '''tourTypes *''' – идентификатор типа(ов) тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
** '''tourTypes *''' – идентификатор типа(ов) тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
Строка 706: Строка 824:
 
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
 
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true)
+
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых
Строка 719: Строка 837:
 
** '''Groups''' – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
 
** '''Groups''' – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
 
** '''HotelScheme''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:  
 
** '''HotelScheme''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:  
*** '''TemplateId''' – идентификатор шаблона услуги,  
+
*** '''TemplateId''' – идентификатор шаблона услуги (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Key->TemplateId),  
*** '''DurationInNight''' – продолжительность отеля в ночах,  
+
*** '''DurationInNight''' – продолжительность отеля в ночах (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->DurationInNight),  
*** '''Code''' – ключ отеля,  
+
*** '''Code''' – ключ отеля (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->Code),  
*** '''PacketKey''' – ключ пакета,  
+
*** '''PacketKey''' – ключ пакета (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PacketId),
*** '''PartnerKey''' – ключ партнера
+
*** '''PartnerKey''' – ключ партнера (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PartnerId),
*** '''GDSProviderId''' – ключ провайдера из внешней системы
+
*** '''GDSProviderId''' – ключ провайдера из внешней системы (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->GDSProviderId),
*** '''TotalTourDuration''' – общая продолжительность тура в днях
+
*** '''TotalTourDuration''' – общая продолжительность тура в днях (этот параметр можно взять из контроллера Tour->Result->Duration)
 
** '''BusTransferPointKeys''' – данный признак проставляется в ''true'' в том случае, когда происходит запрос вариантов проживания (кнопка ''Варианты'') в автобусных переездах
 
** '''BusTransferPointKeys''' – данный признак проставляется в ''true'' в том случае, когда происходит запрос вариантов проживания (кнопка ''Варианты'') в автобусных переездах
 
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
 
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
Строка 820: Строка 938:
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''QuotaStatus''' – информация о квоте
 
***** '''QuotaStatus''' – информация о квоте
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 851: Строка 969:
 
***** '''Key''' – ключ города
 
***** '''Key''' – ключ города
 
***** '''Value''' – название города
 
***** '''Value''' – название города
**** '''Country''' – ключ страны
+
**** '''Country''' – объект страна
 +
***** '''Key''' – ключ страны
 +
***** '''Value''' – название страны
 
**** '''Code''' – объект код услуги
 
**** '''Code''' – объект код услуги
 
***** '''Key''' – ключ услуги
 
***** '''Key''' – ключ услуги
Строка 867: Строка 987:
 
***** '''Cost''' – цена
 
***** '''Cost''' – цена
 
***** '''QuotaStatus''' – объект информация по квотам
 
***** '''QuotaStatus''' – объект информация по квотам
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 1007: Строка 1127:
 
****** '''settings''' –
 
****** '''settings''' –
 
****** '''enabled''' –
 
****** '''enabled''' –
**** '''XmlSettings''' – строка xml для актуальных фильтров
 
 
**** '''Type''' – тип справочника (используется для внутренних целей)
 
**** '''Type''' – тип справочника (используется для внутренних целей)
 
*** '''TourDurations''' – продолжительность тура
 
*** '''TourDurations''' – продолжительность тура
Строка 1313: Строка 1432:
 
               "ServiceName": "страховка",
 
               "ServiceName": "страховка",
 
               "City": null,
 
               "City": null,
               "Country": 6245,
+
               "Country":               {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
              },
 
               "Code":                {
 
               "Code":                {
 
                   "Key": 297,
 
                   "Key": 297,
Строка 1366: Строка 1488:
 
                   "Value": "Санто-Доминго"
 
                   "Value": "Санто-Доминго"
 
               },
 
               },
               "Country": 6245,
+
               "Country":               {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
              },
 
               "Code":                {
 
               "Code":                {
 
                   "Key": 743,
 
                   "Key": 743,
Строка 1569: Строка 1694:
 
               }
 
               }
 
             },
 
             },
            "XmlSettings": "информация о туре в формате xml",
 
 
             "Type": "TourProgram"
 
             "Type": "TourProgram"
 
         }
 
         }
Строка 2020: Строка 2144:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка транспортного плана (TransportPlan)===
+
===Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно===
 
Метод производит выгрузку транспортного плана.
 
Метод производит выгрузку транспортного плана.
 
* Формат запроса:
 
* Формат запроса:
Строка 2108: Строка 2232:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка первоначального варианта в корзину для бронирования (Tour)===
+
===Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8===
Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
+
Метод производит выгрузку транспортного плана.
 
* Формат запроса:
 
* Формат запроса:
** GET .../TourSearchOwin/Tour?
+
** GET .../TourSearchOwin/TransportPlan?
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+
** '''code''' – код услуги
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''dateBegin''' – дата услуги
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+
** '''serviceType''' – тип услуги
** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+
** '''transportKey''' – ключ справочника транспорт
** '''Durations *''' – массив продолжительностей (полученные из метода ''.../TourSearchOwin/Duration?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+
 
** '''AdultCount *''' – количество взрослых
+
* Возвращаемый результат:
** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+
** '''VehiclePlans''' – массив параметров зон плана
** '''CurrencyName *''' – код валюты
+
*** '''Key''' – ключ зоны
** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
*** '''TransportKey''' – ключ из справочника транспорт
** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
*** '''Row''' – количество рядов
** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
*** '''AreaNumber''' – номер уровня
** '''HotelScheme *''' – объект схемы отеля
+
*** '''Name''' – название уровня
*** '''TemplateId''' – идентификатор шаблона услуги
+
*** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная)
*** '''DurationInNight''' – продолжительность отеля в ночах
+
*** '''Column''' – количество столбцов
*** '''Code''' – ключ отеля
+
*** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является)
*** '''PacketKey''' – ключ пакета
+
*** '''Type''' – не используется
*** '''PartnerKey''' – ключ партнера
+
** '''Seats''' – массив параметров посадочного места
*** '''GDSProviderId''' – ключ провайдера из внешней системы
+
*** '''Key''' – ключ места
*** '''TotalTourDuration''' – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра ''TotalTourDuration'' для HotelScheme можно из свойства ''Duration'', пришедшего для данной цены в ответе метода поиск туров (''Tour'')
+
*** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
+
*** '''Index''' – индекс места
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
+
*** '''Number''' – название ячейки с местом
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
+
*** '''Type''' – тип "место"
** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (true/false)
+
*** '''VPKey''' – ключ зоны
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
+
*** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
+
 
** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода TransportPlan
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/TransportPlan?code=1776&dateBegin=28.03.2022&serviceType=14&transportKey=35
 +
</syntaxhighlight>
 +
Возвращаемый результат метода TransportPlan (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
"VehiclePlans":
 +
[
 +
  {
 +
    "Key": 291,
 +
    "TransportKey": 35,
 +
    "Row": 2,
 +
    "AreaNumber": 1,
 +
    "Name": "Зона 1",
 +
    "PlanOrientation": false,
 +
    "Column": 3,
 +
    "IsAirCraft": false,
 +
    "Type": "VehiclePlans"
 +
  },
 +
  {
 +
    "Key": 292,
 +
    "TransportKey": 35,
 +
    "Row": 3,
 +
    "AreaNumber": 2,
 +
    "Name": "Зона 2",
 +
    "PlanOrientation": true,
 +
    "Column": 2,
 +
    "IsAirCraft": false,
 +
    "Type": "VehiclePlans"
 +
  }
 +
],
 +
"Seats":
 +
[
 +
  {
 +
    "Key": 332522,
 +
    "SeatType": 1,
 +
    "Index": 0,
 +
    "Number": "1",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "2002"
 +
  },
 +
  {
 +
    "Key": 332523,
 +
    "SeatType": 1,
 +
    "Index": 1,
 +
    "Number": "2",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "2100"
 +
  },
 +
  {
 +
    "Key": 332524,
 +
    "SeatType": 2,
 +
    "Index": 2,
 +
    "Number": "П",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "2201"
 +
  },
 +
  {
 +
    "Key": 332525,
 +
    "SeatType": 1,
 +
    "Index": 3,
 +
    "Number": "3",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "0022"
 +
  },
 +
  {
 +
    "Key": 332526,
 +
    "SeatType": 1,
 +
    "Index": 4,
 +
    "Number": "4",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "0120"
 +
  },
 +
  {
 +
    "Key": 332527,
 +
    "SeatType": 1,
 +
    "Index": 5,
 +
    "Number": "5",
 +
    "Type": "Seat",
 +
    "VPKey": 291,
 +
    "Border": "0221"
 +
  },
 +
  {
 +
    "Key": 332528,
 +
    "SeatType": 1,
 +
    "Index": 0,
 +
    "Number": "1",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "2002"
 +
  },
 +
  {
 +
    "Key": 332529,
 +
    "SeatType": 1,
 +
    "Index": 1,
 +
    "Number": "2",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "2200"
 +
  },
 +
  {
 +
    "Key": 332530,
 +
    "SeatType": 1,
 +
    "Index": 2,
 +
    "Number": "3",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "0012"
 +
  },
 +
  {
 +
    "Key": 332531,
 +
    "SeatType": 1,
 +
    "Index": 3,
 +
    "Number": "4",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "0210"
 +
  },
 +
  {
 +
    "Key": 332532,
 +
    "SeatType": 1,
 +
    "Index": 4,
 +
    "Number": "5",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "1000"
 +
  },
 +
  {
 +
    "Key": 332533,
 +
    "SeatType": 1,
 +
    "Index": 5,
 +
    "Number": "6",
 +
    "Type": "Seat",
 +
    "VPKey": 292,
 +
    "Border": "1000"
 +
  }
 +
],
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Получение дат заезда по турпрограмме===
 +
Работает начиная с релиза 15.8.
 +
Метод возвращает даты заезда по ключу турпрограммы.
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/TransportPlan?
 +
* Принимаемые параметры ( '''*''' – обязательный):
 +
** '''tourProgramKey *''' – ключ турпрограммы
  
 
* Возвращаемый результат:
 
* Возвращаемый результат:
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
+
** '''Массив дат заезда по туру'''
** '''Message''' – сообщение об ошибке
+
 
*** '''Key''' – код ошибки
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
*** '''Value''' – сообщение об ошибке
+
<div class="mw-collapsible-content">
** '''Result''' – результаты поиска
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
*** '''Key''' – идентификатор программы тура
+
Вызов метода
*** '''Name''' – название программы тура
+
<syntaxhighlight lang="java" enclose="div">
*** '''TourUrl''' – ссылка на программу тура
+
GET http://localhost:9000/TourSearchOwin/TransportPlan?tourProgramKey=100001277
*** '''BookingConditions''' – условия бронирования программы туров
+
</syntaxhighlight>
*** '''StartDate''' – дата начала тура
+
Возвращаемый результат метода (в формате JSON)
*** '''Duration''' – продолжительность тура (в днях)
+
<syntaxhighlight lang="java" enclose="div">
*** '''DurationInNight''' – продолжительность проживания (в ночах)
+
[
*** '''Types''' – идентификатор типа туров
+
    "2022-02-21T00:00:00Z",
*** '''Cost''' – цена тура
+
    "2022-02-22T00:00:00Z",
*** '''Rate''' – код валюты тура
+
    "2022-02-23T00:00:00Z",
*** '''CityDepature''' – город отправления
+
    "2022-02-24T00:00:00Z",
**** '''Key''' – идентификатор города отправления
+
    "2022-02-25T00:00:00Z",
**** '''Value''' – название города отправления
+
    "2022-02-26T00:00:00Z",
*** '''CountryId''' – всегда возвращается ключ 0
+
]
*** '''Services''' – услуги в туре
+
</syntaxhighlight>
**** '''DepartureCity''' – город отправления
+
</TD></TR></TABLE>
***** '''Key''' – идентификатор
+
</div></div><br />
***** '''Value''' – название
+
 
**** '''DepartureCountry''' – страна отправления
+
===Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги===
***** '''Key''' – идентификатор
+
Работает начиная с релиза 15.8.
***** '''Value''' – название
+
Метод возвращает даты заезда по ключу турпрограммы и дате услуги.
**** '''ArrivalCity''' – город прибытия
+
* Формат запроса:
***** '''Key''' – идентификатор
+
** GET .../TourSearchOwin/TransportPlan?
***** '''Value''' – название
+
* Принимаемые параметры ( '''*''' – обязательный):
**** '''ArrivalCountry''' – страна прибытия
+
** '''tourProgramKey *''' – ключ турпрограммы
***** '''Key''' – идентификатор
+
** '''dateBegin *''' – дата услуги
***** '''Value''' – название
+
** '''serviceType *''' – тип услуги
**** '''DepartureAirport''' – аэропорт отправления
+
 
***** '''Key''' – идентификатор
+
* Возвращаемый результат:
***** '''Value''' – название
+
* '''plan''' – массив данных план
**** '''ArrivalAirport''' – аэропорт прибытия
+
** '''VehiclePlans''' – массив параметров зон плана
***** '''Key''' – идентификатор
+
*** '''Key''' – ключ зоны
***** '''Value''' – название
+
*** '''TransportKey''' – ключ из справочника транспорт
**** '''Airline''' – авиакомпания
+
*** '''Row''' – количество рядов
 +
*** '''AreaNumber''' – номер уровня
 +
*** '''Name''' – название уровня
 +
*** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная)
 +
*** '''Column''' – количество столбцов
 +
*** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является)
 +
*** '''Dates''' – не используется
 +
*** '''Type''' – не используется
 +
** '''Seats''' – массив параметров посадочного места
 +
*** '''Key''' – ключ места
 +
*** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
 +
*** '''Index''' – индекс места
 +
*** '''Number''' – название ячейки с местом
 +
*** '''Type''' – тип "место"
 +
*** '''VPKey''' – ключ зоны
 +
*** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
 +
* '''routeCity''' – направление автобусного переезда
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/TransportPlan?tourProgramKey=100001221&dateBegin=06.09.2023&serviceType=14
 +
</syntaxhighlight>
 +
Возвращаемый результат метода (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
    "plan": {
 +
        "VehiclePlans": [
 +
            {
 +
                "Key": 10,
 +
                "TransportKey": 24,
 +
                "Row": 10,
 +
                "AreaNumber": 1,
 +
                "Name": "12345678901234567890",
 +
                "PlanOrientation": true,
 +
                "Column": 5,
 +
                "IsAirCraft": false,
 +
                "Dates": null,
 +
                "Type": "VehiclePlans"
 +
            }
 +
        ],
 +
        "Seats": [
 +
            {
 +
                "Key": 406,
 +
                "SeatType": 1,
 +
                "Index": 0,
 +
                "Number": "1",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 407,
 +
                "SeatType": 1,
 +
                "Index": 1,
 +
                "Number": "2",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 408,
 +
                "SeatType": 0,
 +
                "Index": 2,
 +
                "Number": "",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 409,
 +
                "SeatType": 1,
 +
                "Index": 3,
 +
                "Number": "3",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 410,
 +
                "SeatType": 1,
 +
                "Index": 4,
 +
                "Number": "4",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 411,
 +
                "SeatType": 1,
 +
                "Index": 5,
 +
                "Number": "5",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 412,
 +
                "SeatType": 1,
 +
                "Index": 6,
 +
                "Number": "6",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            }
 +
        ]
 +
    },
 +
    "routeCity": "Москва - Казань"
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка первоначального варианта в корзину для бронирования (Tour)===
 +
Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/Tour?
 +
* Принимаемые параметры ( '''*''' – обязательный):
 +
** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 +
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 +
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 +
** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 +
** '''Durations *''' – массив продолжительностей (полученные из метода ''.../TourSearchOwin/Duration?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 +
** '''AdultCount *''' – количество взрослых
 +
** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 +
** '''CurrencyName *''' – код валюты
 +
** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
 +
** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
 +
** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
 +
** '''HotelScheme *''' – объект схемы отеля
 +
*** '''TemplateId''' – идентификатор шаблона услуги
 +
*** '''DurationInNight''' – продолжительность отеля в ночах
 +
*** '''Code''' – ключ отеля
 +
*** '''PacketKey''' – ключ пакета
 +
*** '''PartnerKey''' – ключ партнера
 +
*** '''GDSProviderId''' – ключ провайдера из внешней системы
 +
*** '''TotalTourDuration''' – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра ''TotalTourDuration'' для HotelScheme можно из свойства ''Duration'', пришедшего для данной цены в ответе метода поиск туров (''Tour'')
 +
** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
 +
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
 +
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
 +
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
 +
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
 +
** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
 +
** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
 +
 
 +
* Возвращаемый результат:
 +
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
 +
** '''Message''' – сообщение об ошибке
 +
*** '''Key''' – код ошибки
 +
*** '''Value''' – сообщение об ошибке
 +
** '''Result''' – результаты поиска
 +
*** '''Key''' – идентификатор программы тура
 +
*** '''Name''' – название программы тура
 +
*** '''TourUrl''' – ссылка на программу тура
 +
*** '''BookingConditions''' – условия бронирования программы туров
 +
*** '''StartDate''' – дата начала тура
 +
*** '''Duration''' – продолжительность тура (в днях)
 +
*** '''DurationInNight''' – продолжительность проживания (в ночах)
 +
*** '''Types''' – идентификатор типа туров
 +
*** '''Cost''' – цена тура
 +
*** '''Rate''' – код валюты тура
 +
*** '''CityDepature''' – город отправления
 +
**** '''Key''' – идентификатор города отправления
 +
**** '''Value''' – название города отправления
 +
*** '''CountryId''' – всегда возвращается ключ 0
 +
*** '''Services''' – услуги в туре
 +
**** '''DepartureCity''' – город отправления
 
***** '''Key''' – идентификатор
 
***** '''Key''' – идентификатор
 
***** '''Value''' – название
 
***** '''Value''' – название
**** '''Aircraft''' – воздушное судно
+
**** '''DepartureCountry''' – страна отправления
 
***** '''Key''' – идентификатор
 
***** '''Key''' – идентификатор
 
***** '''Value''' – название
 
***** '''Value''' – название
**** '''Flight''' – рейс
+
**** '''ArrivalCity''' – город прибытия
 
***** '''Key''' – идентификатор
 
***** '''Key''' – идентификатор
 
***** '''Value''' – название
 
***** '''Value''' – название
**** '''DepartureTime''' – время вылета
+
**** '''ArrivalCountry''' – страна прибытия
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''DepartureAirport''' – аэропорт отправления
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''ArrivalAirport''' – аэропорт прибытия
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''Airline''' – авиакомпания
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''Aircraft''' – воздушное судно
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''Flight''' – рейс
 +
***** '''Key''' – идентификатор
 +
***** '''Value''' – название
 +
**** '''DepartureTime''' – время вылета
 
**** '''ArrivalTime''' – время прилета
 
**** '''ArrivalTime''' – время прилета
 
**** '''EndDateTime''' – дата и время прилета
 
**** '''EndDateTime''' – дата и время прилета
Строка 2198: Строка 2664:
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''QuotaStatus''' – информация о квоте
 
***** '''QuotaStatus''' – информация о квоте
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 2229: Строка 2695:
 
***** '''Key''' – ключ города
 
***** '''Key''' – ключ города
 
***** '''Value''' – название города
 
***** '''Value''' – название города
**** '''Country''' – ключ страны
+
**** '''Country''' – объект страна
 +
***** '''Key''' – ключ страны
 +
***** '''Value''' – название страны
 
**** '''Code''' – объект код услуги
 
**** '''Code''' – объект код услуги
 
***** '''Key''' – ключ услуги
 
***** '''Key''' – ключ услуги
Строка 2245: Строка 2713:
 
***** '''Cost''' – цена
 
***** '''Cost''' – цена
 
***** '''QuotaStatus''' – объект информация по квотам
 
***** '''QuotaStatus''' – объект информация по квотам
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 2809: Строка 3277:
 
**** '''IsRequired''' – признак обязательности заполнения поля
 
**** '''IsRequired''' – признак обязательности заполнения поля
 
**** '''IsVisible''' – видимость поля (видимое)
 
**** '''IsVisible''' – видимость поля (видимое)
**** '''IsDisabled''' – видимость поля (невидимое)
+
**** '''IsDisabled''' – служебный внутренний параметр. При работе с API не используется
 
**** '''Translit''' – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)  
 
**** '''Translit''' – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)  
 
**** '''LetterCase''' – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
 
**** '''LetterCase''' – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
Строка 3162: Строка 3630:
 
**** '''ByPax''' – цена за человека
 
**** '''ByPax''' – цена за человека
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3205: Строка 3673:
 
*** '''ServiceName''' – название услуги
 
*** '''ServiceName''' – название услуги
 
*** '''City''' – объект город
 
*** '''City''' – объект город
*** '''Country''' – ключ страны
+
*** '''Country''' – объект страна
 +
**** '''Key''' – ключ страны
 +
**** '''Value''' – название страны
 
*** '''Code''' – объект код услуги
 
*** '''Code''' – объект код услуги
 
**** '''Key''' – ключ услуги
 
**** '''Key''' – ключ услуги
Строка 3221: Строка 3691:
 
**** '''Cost''' – цена
 
**** '''Cost''' – цена
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3400: Строка 3870:
 
"ServiceName": "Доплаты к авиаперелетам",
 
"ServiceName": "Доплаты к авиаперелетам",
 
"City": null,
 
"City": null,
"Country": 90,
+
        "Country":                {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
},
 
"Code": {
 
"Code": {
 
"Key": 357,
 
"Key": 357,
Строка 3490: Строка 3963:
 
**** '''ByPax''' – цена за человека
 
**** '''ByPax''' – цена за человека
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3572: Строка 4045:
 
**** '''Cost''' – цена
 
**** '''Cost''' – цена
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3741: Строка 4214:
 
"ServiceName": "Доплаты к отелям",
 
"ServiceName": "Доплаты к отелям",
 
"City": null,
 
"City": null,
"Country": 90,
+
                "Country":                {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
},
 
"Code": {
 
"Code": {
 
"Key": 364,
 
"Key": 364,
Строка 3947: Строка 4423:
  
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 +
<font style="color:red">''Внимание!''</font> Если в туре используется перелет из GDS, то в параметр '''flightSettings''' передается ответ из секции '''flightGDSRequest''' метода API [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Актуализация тура (ActualizeTour)|ActualizeTour]]. Далее для получения цены выполняем методы [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)|RebuidFlights]] и [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Расчет путевки (CalculateReservation)|CalculateReservation]]. <br />
 
** '''flightSettings''' – информация о шаблоне услуги авиаперелета
 
** '''flightSettings''' – информация о шаблоне услуги авиаперелета
 
*** '''templateId''' – идентификатор шаблона услуги
 
*** '''templateId''' – идентификатор шаблона услуги
Строка 4203: Строка 4680:
 
     "key": 0,
 
     "key": 0,
 
     "tourDurationByDays": "11",
 
     "tourDurationByDays": "11",
     "langueCode": "ru"
+
     "langueCode": "ru",
 +
    "isCanary": "false"
 
}
 
}
  
Строка 4659: Строка 5137:
  
 
===Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)===
 
===Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)===
 +
<font style="color:red">''Внимание!''</font> Если в туре используется перелет из GDS, то перед этим методом вызывается [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Поиск рейсов из внешней системы (GetGDSFlights)|GetGDSFlights]] в принимаемые параметры которого передается ответ из секции flightGDSRequest метода API [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Актуализация тура (ActualizeTour)|ActualizeTour]]. Далее текущий метод [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)|RebuidFlights]] и далее [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Расчет путевки (CalculateReservation)|CalculateReservation]]. <br />
 
Метод возвращает информацию по выбранному перелету от внешнего поставщика.  
 
Метод возвращает информацию по выбранному перелету от внешнего поставщика.  
 
* Формат запроса:
 
* Формат запроса:
Строка 4909: Строка 5388:
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''QuotaStatus''' – информация о квоте
 
***** '''QuotaStatus''' – информация о квоте
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 5823: Строка 6302:
  
 
* Принимаемые параметры POST запроса:
 
* Принимаемые параметры POST запроса:
** '''TourProgramId''' – ключ турпрограммы
+
** '''TourProgramId *''' – ключ турпрограммы
** '''BeginDate''' – дата начала тура
+
** '''BeginDate *''' – дата начала тура
** '''Duration''' – продолжительность тура
+
** '''Duration *''' – продолжительность тура
** '''Currency''' – код валюты
+
** '''Currency *''' – код валюты
** '''initialPrice''' – объект изначальная цена
+
** '''initialPrice *''' – объект изначальная цена
*** '''price''' – цена
+
*** '''price *''' – цена
*** '''currency''' – код валюты
+
*** '''currency *''' – код валюты
** '''Services''' – массив услуг
+
** '''Services *''' – массив услуг
*** '''Service''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
+
*** '''Service *''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
**** '''ServiceType''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
+
**** '''ServiceType *''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
**** '''Code''' – код услуги
+
**** '''Code *''' – код услуги
**** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
+
**** '''SubCode1 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
**** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
+
**** '''SubCode2 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
**** '''Packet''' – ключ пакета услуги
+
**** '''Packet *''' – ключ пакета услуги
**** '''Partner''' – ключ партнера услуги
+
**** '''Partner *''' – ключ партнера услуги
**** '''Day''' – день предоставления услуги
+
**** '''Day *''' – день предоставления услуги
**** '''DurationInNight''' – продолжительность услуги в ночах
+
**** '''DurationInNight *''' – продолжительность услуги в ночах
**** '''City''' – ключ города
+
**** '''City *''' – ключ города
**** '''Country''' – страна услуги
+
**** '''Country *''' – страна услуги
**** '''Attributes''' – битовая маска атрибутов услуг
+
**** '''Attributes *''' – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:
**** '''IsRemovable''' – (не обрабатывается)
+
None              = 0,если услуга удаляемая, эта настройка находится в программе туров,</br>
**** '''Type''' – тип услуги в путевке (базовая дополнительная)
+
Delete            = 1,</br>
**** '''IsHooded''' – признак скрытая услуга
+
CodeEdit          = 2,</br>
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+
SubCode1Edit      = 4,</br>
**** '''BeginDateTimeString''' – дата и время начала услуги
+
CityEdit          = 8,</br>
**** '''EndDateTimeString''' – дата и время окончания услуги
+
PartnerEdit      = 16,</br>
**** '''TemplateId''' – шаблон услуги
+
BadCheck          = 32,</br>
**** '''Cost''' – цена услуги
+
Invisible        = 64, отображаемая</br>
**** '''ByPax''' – цена за человека
+
DurationEdit      = 128,</br>
**** '''QuotaStatus''' – объект статус квотирования
+
FullEdit          = Delete | CodeEdit | SubCode1Edit | SubCode2Edit | CityEdit | PartnerEdit | DurationEdit,</br>
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
Host              = 256,</br>
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
HostChangeCode2  = Host | 512,</br>
***** '''IsFewPlaces''' выполнены ли условия, заданные в настройке "Мало": '''true''' если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
HostChangeCode1  = Host | 1024,</br>
**** '''Index''' – индекс услуги
+
HostChangeCode    = Host | 2048,</br>
**** '''IsRoute''' – признак маршрутная услуга
+
HostChangePartner = Host | 4096,</br>
**** '''ServiceTemplateIndex''' – индекс шаблона услуги
+
HostChangePacket  = Host | 8192,</br>
**** '''RemoteId''' – информация об услуге во внешней системе
+
Depended          = 16384,</br>
**** '''IsCommission''' – признак, комиссионная ли услуга
+
DependedCode2    = Depended | 512,</br>
**** '''BaseFlightsParams''' – параметры рассчитанных авиаперелетов
+
DependedCode1    = Depended | 1024,</br>
***** '''CityArrival''' – ключ города прибытия прямого перелета
+
DependedCode      = Depended | 2048,</br>
***** '''FlightCode''' – ключ прямого авиаперелета
+
DependedCity      = Depended | 4096,</br>
***** '''TariffKey''' – ключ тарифа прямого авиаперелета
+
DependedCountry  = Depended | 8192,</br>
***** '''PartnerId''' – ключ партнера прямого авиаперелета
+
FullDepended      = Depended | DependedCode2 | DependedCode1 | DependedCode | DependedCity | DependedCountry,</br>
***** '''CityArrival''' – ключ города прибытия обратного перелета
+
NotCalculate      = 32768,не рассчитываемая,</br>
***** '''FlightCode''' – ключ обратного авиаперелета
+
SubCode2Edit      = 65536,</br>
***** '''TariffKey''' – ключ тарифа обратного авиаперелета
+
GDSService        = 131072, от внешней системы)</br>
***** '''PartnerId''' – ключ партнера обратного авиаперелета
+
**** ''' *IsRemovable''' – (не обрабатывается)
*** '''TouristNumbersList''' – массив туристов, привязанных к услуге
+
**** ''' *Type''' – тип услуги в путевке. Может принимать значения:
** '''Tourists''' – массив туристов
+
None (0) – не установлено,</br>
*** '''IsMain''' – главный турист
+
Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.</br>
*** '''Number''' – порядковый номер туриста
+
Optional (2) Дополнительная услуга,</br>
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
NYDinner (4) – Новогодний ужин,</br>
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
FlightAdditionalPayment (8) Доплата на перелет,</br>
*** '''FirstName''' – имя (лат)
+
TourWebDifference (16) Разница в СПО,</br>
*** '''LastName''' – фамилия (лат)
+
AddedByCalculator (32) – Добавленная при рассчете путевки,</br>
*** '''Patronymic''' – отчество (лат)
+
AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,</br>
*** '''FirstNameRus''' – имя (рус)
+
BaseChanged (128) – базовая измененная услуга,</br>
*** '''LastNameRus''' – фамилия (рус)
+
HotelAdditionalPayment (256) – доплата на отель</br>
*** '''PatronymicRus''' – отчество (рус)
+
**** '''IsHooded *''' – признак скрытая услуга
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
**** '''BeginDateTimeString *''' – дата и время начала услуги
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
**** '''EndDateTimeString *''' – дата и время окончания услуги
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
+
**** '''TemplateId *''' – порядок расположения шаблона услуги в внутри самой услуги в программе тура
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
[[Файл: Ea_491.png|600px|индекс шаблона услуги]]</br>
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
+
**** '''Cost *''' – цена услуги
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
**** '''ByPax *''' – цена за человека
*** '''PassportSeries''' – серия паспорта
+
**** '''QuotaStatus *''' – объект статус квотирования
*** '''PassportNumber''' – номер паспорта
+
***** '''PlacesStatus *''' – статус по квотам (есть места / нет мест / под запрос)
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
+
***** '''FreePlaces *''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
*** '''PassportDateOfIssueString''' – дата выдачи паспорта  строковом формате (DD.MM.YYYY)
+
***** '''IsFewPlaces *''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
*** '''PassportByWhom''' – кем выдан паспорт
+
**** '''Index *''' – индекс услуги
*** '''Citizenship''' – название страны
+
**** '''IsRoute *''' – признак маршрутная услуга (Перелет, автобусный переезд, жд переезд, трансфер, экскурсия)
*** '''Phone''' – телефон
+
**** '''ServiceTemplateIndex *''' – индекс шаблона услуги (Порядок расположения услуги в программе тура. Не отображается в программе туров,это просто порядковый номер услуги в путевке)
*** '''Email''' – e-mail
+
[[Файл: Ea_490.png|600px|индекс шаблона услуги]]</br>
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
**** '''RemoteId *''' – информация об услуге во внешней системе
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
**** '''IsCommission *''' – признак, комиссионная ли услуга
*** '''BirthPlace''' – место рождения
+
**** '''BaseFlightsParams *''' – параметры рассчитанных авиаперелетов ''Обязательный параметр, если в путевке есть услуга авиаперелета''
*** '''CitizenID''' – гражданство
+
***** '''CityArrival *''' – ключ города прибытия прямого перелета
*** '''Age''' – количество полных лет на момент окончания тура
+
***** '''FlightCode *''' – ключ прямого авиаперелета
** '''Day''' – день (перевод)
+
***** '''TariffKey *''' – ключ тарифа прямого авиаперелета
** '''Day2''' – дня (перевод)
+
***** '''PartnerId *''' – ключ партнера прямого авиаперелета
** '''Days''' – дней (перевод)
+
***** '''CityArrival *''' – ключ города прибытия обратного перелета
** '''Night''' – ночь (перевод)
+
***** '''FlightCode *''' – ключ обратного авиаперелета
** '''Night2''' – ночи (перевод)
+
***** '''TariffKey *''' – ключ тарифа обратного авиаперелета
** '''Nights''' – ночей (перевод)
+
***** '''PartnerId *''' – ключ партнера обратного авиаперелета
** '''adultsCountOverServiceLimit''' – Количество взрослых туристов превышает лимит услуги (перевод)
+
*** '''TouristNumbersList *''' – массив туристов, привязанных к услуге
** '''at''' – на (перевод)
+
** '''Tourists *''' – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка настройки отображения полей по туристам (TouristDataSettings)|TouristDataSettings]] по определенной стране. В каждом объекте есть поле '''IsRequired''', которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
** '''incorrectChildrenInf''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)
+
*** '''IsMain *''' – главный турист
 
+
*** '''Number *''' – порядковый номер туриста
* Возвращаемый результат:
+
*** '''AgeType *''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
** '''IsValid''' – признак валидности путевки
+
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 – женский)
** '''ErrorMessage''' – сообщение об ошибке, если есть
+
*** '''FirstName *''' – имя (лат)
** '''CalculatedReservation''' – объект рассчитанной путевки  
+
*** '''LastName *''' – фамилия (лат)
*** '''TourKey''' – ключ тура  
+
*** '''Patronymic *''' – отчество (лат)
*** '''BeginDate''' – дата начала тура
+
*** '''FirstNameRus *''' – имя (рус)
*** '''Duration''' – продолжительность путевки в днях
+
*** '''LastNameRus *''' – фамилия (рус)
*** '''Currency''' – код валюты тура  
+
*** '''PatronymicRus *''' – отчество (рус)
*** '''CalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура  
+
*** '''InternationalPassportSeries *''' – серия загранпаспорта
*** '''ChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг
+
*** '''InternationalPassportNumber *''' – номер загранпаспорта
*** '''Price''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
+
*** '''InternationalPassportDateOfIssue *''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''TotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
+
*** '''InternationalPassportDateOfIssueString *''' – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
*** '''IsDiscountIsPercent''' – признак, в процентах ли дается партнерская комиссия или в y.e.
+
*** '''InternationalPassportDateOfExpiry *''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''NationalChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг (в национальной валюте)
+
*** '''InternationalPassportDateOfExpiryString *''' – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
*** '''NationalTotalDiscount''' – партнерская комиссия агентству (в национальной валюте)  
+
*** '''internationalPassportByWhom *''' – кем выдан загранпаспорт
*** '''NationalTotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)  
+
*** '''PassportSeries *''' – серия паспорта
*** '''NatinoalCalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура (в национальной валюте)   
+
*** '''PassportNumber *''' – номер паспорта
*** '''NationalPrice''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
+
*** '''PassportDateOfIssue *''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
*** '''Discount''' – партнерская комиссия агентству (в процентах или y.e.)
+
*** '''PassportDateOfIssueString *''' – дата выдачи паспорта  строковом формате (DD.MM.YYYY)
*** '''TotalDiscount''' – партнерская комиссия агентству (в валюте тура)
+
*** '''PassportByWhom *''' – кем выдан паспорт
 +
*** '''Citizenship *''' – название страны
 +
*** '''Phone *''' – телефон
 +
*** '''Email *''' – e-mail
 +
*** '''BirthDay *''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
 +
*** '''BirthDayString *''' – дата рождения в строковом формате (DD.MM.YYYY)
 +
*** '''BirthPlace *''' – место рождения
 +
*** '''CitizenID *''' – гражданство
 +
*** '''Age *''' – количество полных лет на момент окончания тура
 +
** '''Day *''' – день (перевод) ''Может быть с пустым значением''
 +
** '''Day2 *''' – дня (перевод) ''Может быть с пустым значением''
 +
** '''Days *''' – дней (перевод) ''Может быть с пустым значением''
 +
** '''Night *''' – ночь (перевод) ''Может быть с пустым значением''
 +
** '''Night2 *''' – ночи (перевод) ''Может быть с пустым значением''
 +
** '''Nights *''' – ночей (перевод) ''Может быть с пустым значением''
 +
** '''adultsCountOverServiceLimit *''' – Количество взрослых туристов превышает лимит услуги (перевод) ''Может быть с пустым значением''
 +
** '''at *''' – на (перевод) ''Может быть с пустым значением''
 +
** '''incorrectChildrenInf *''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) ''Может быть с пустым значением''
 +
 
 +
* Возвращаемый результат:
 +
** '''IsValid''' – признак валидности путевки
 +
** '''ErrorMessage''' – сообщение об ошибке, если есть
 +
** '''CalculatedReservation''' – объект рассчитанной путевки  
 +
*** '''TourKey''' – ключ тура  
 +
*** '''BeginDate''' – дата начала тура
 +
*** '''Duration''' – продолжительность путевки в днях
 +
*** '''Currency''' – код валюты тура  
 +
*** '''CalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура  
 +
*** '''ChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг
 +
*** '''Price''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
 +
*** '''TotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
 +
*** '''IsDiscountIsPercent''' – признак, в процентах ли дается партнерская комиссия или в y.e.
 +
*** '''NationalChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг (в национальной валюте)
 +
*** '''NationalTotalDiscount''' – партнерская комиссия агентству (в национальной валюте)  
 +
*** '''NationalTotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)  
 +
*** '''NatinoalCalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура (в национальной валюте)   
 +
*** '''NationalPrice''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
 +
*** '''Discount''' – партнерская комиссия агентству (в процентах или y.e.)
 +
*** '''TotalDiscount''' – партнерская комиссия агентству (в валюте тура)
 
*** '''ServiceTourists''' – массив услуг, входящих в тур  
 
*** '''ServiceTourists''' – массив услуг, входящих в тур  
 
**** '''ServiceType''' – тип услуги
 
**** '''ServiceType''' – тип услуги
Строка 6215: Строка 6732:
  
 
* Принимаемые параметры PUT запроса:
 
* Принимаемые параметры PUT запроса:
** '''TourProgramId''' – ключ турпрограммы
+
** '''TourProgramId *''' – ключ турпрограммы
** '''BeginDate''' – дата начала тура (YYYY-MM-DDThh:mm:ss)
+
** '''BeginDate *''' – дата начала тура (YYYY-MM-DDThh:mm:ss)
** '''Duration''' – продолжительность тура
+
** '''Duration *''' – продолжительность тура
** '''Currency''' – код валюты
+
** '''Currency *''' – код валюты
** '''Services''' – массив услуг
+
** '''Services *''' – массив услуг
*** '''Service''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
+
*** '''Service *''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
**** '''ServiceType''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
+
**** '''ServiceType *''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
**** '''Code''' – код услуги
+
**** '''Code *''' – код услуги
**** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
+
**** '''SubCode1 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
**** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
+
**** '''SubCode2 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
**** '''Packet''' – ключ пакета услуги
+
**** '''Packet *''' – ключ пакета услуги
**** '''Partner''' – ключ партнера услуги
+
**** '''Partner *''' – ключ партнера услуги
**** '''Day''' – день предоставления услуги
+
**** '''Day *''' – день предоставления услуги
**** '''DurationInNight''' – продолжительность услуги в ночах
+
**** '''DurationInNight *''' – продолжительность услуги в ночах
**** '''City''' – ключ города
+
**** '''City *''' – ключ города
**** '''Country''' – страна услуги
+
**** '''Country *''' – страна услуги
**** '''Attributes''' – битовая маска атрибутов услуг
+
**** '''Attributes *''' – битовая маска атрибутов услуг
**** '''IsRemovable''' – (не обрабатывается)
+
**** '''IsRemovable *''' – (не обрабатывается)
**** '''Type''' – тип услуги в путевке (базовая дополнительная)
+
**** '''Type *''' – тип услуги в путевке (базовая дополнительная)
**** '''IsHooded''' – признак скрытая услуга
+
**** '''IsHooded *''' – признак скрытая услуга
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+
**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
**** '''BeginDateTimeString''' – дата и время начала услуги
+
**** '''BeginDateTimeString *''' – дата и время начала услуги
**** '''EndDateTimeString''' – дата и время окончания услуги
+
**** '''EndDateTimeString *''' – дата и время окончания услуги
**** '''TemplateId''' – шаблон услуги
+
**** '''TemplateId *''' – шаблон услуги
**** '''Cost''' – цена услуги
+
**** '''Cost *''' – цена услуги
**** '''ByPax''' – цена за человека
+
**** '''ByPax *''' – цена за человека
**** '''QuotaStatus''' – объект статус квотирования
+
**** '''QuotaStatus *''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus *''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
***** '''FreePlaces *''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
***** '''IsFewPlaces *''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
**** '''Index''' – индекс услуги
+
**** '''Index *''' – индекс услуги
**** '''IsRoute''' – признак маршрутная услуга
+
**** '''IsRoute *''' – признак маршрутная услуга
**** '''ServiceTemplateIndex''' – индекс шаблона услуги
+
**** '''ServiceTemplateIndex *''' – индекс шаблона услуги
**** '''RemoteId''' – информация об услуге во внешний системе
+
**** '''RemoteId *''' – информация об услуге во внешний системе
**** '''IsCommission''' – признак, комиссионная ли услуга
+
**** '''IsCommission *''' – признак, комиссионная ли услуга
**** '''BaseFlightsParams''' – параметры рассчитанных авиаперелетов
+
**** '''BaseFlightsParams *''' – параметры рассчитанных авиаперелетов ''Обязательный параметр, если в путевке есть услуга авиаперелета''
***** '''CityArrival''' – ключ города прибытия прямого перелета
+
***** '''CityArrival *''' – ключ города прибытия прямого перелета
***** '''FlightCode''' – ключ прямого авиаперелета
+
***** '''FlightCode *''' – ключ прямого авиаперелета
***** '''TariffKey''' – ключ тарифа прямого авиаперелета
+
***** '''TariffKey *''' – ключ тарифа прямого авиаперелета
***** '''PartnerId''' – ключ партнера прямого авиаперелета
+
***** '''PartnerId *''' – ключ партнера прямого авиаперелета
***** '''CityArrival''' – ключ города прибытия обратного перелета
+
***** '''CityArrival *''' – ключ города прибытия обратного перелета
***** '''FlightCode''' – ключ обратного авиаперелета
+
***** '''FlightCode *''' – ключ обратного авиаперелета
***** '''TariffKey''' – ключ тарифа обратного авиаперелета
+
***** '''TariffKey *''' – ключ тарифа обратного авиаперелета
***** '''PartnerId''' – ключ партнера обратного авиаперелета
+
***** '''PartnerId *''' – ключ партнера обратного авиаперелета
*** '''TouristNumbersList''' – массив туристов, привязанных к услуге
+
*** '''TouristNumbersList *''' – массив туристов, привязанных к услуге
** '''Tourists''' – массив туристов
+
** '''Tourists *''' – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка настройки отображения полей по туристам (TouristDataSettings)|TouristDataSettings]] по определенной стране. В каждом объекте есть поле '''IsRequired''', которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
*** '''IsMain''' – главный турист
+
*** '''IsMain *''' – главный турист
*** '''Number''' – порядковый номер туриста
+
*** '''Number *''' – порядковый номер туриста
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
*** '''AgeType *''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 – женский)
*** '''FirstName''' – имя (лат)
+
*** '''FirstName *''' – имя (лат)
*** '''LastName''' – фамилия (лат)
+
*** '''LastName *''' – фамилия (лат)
*** '''Patronymic''' – отчество (лат)
+
*** '''Patronymic *''' – отчество (лат)
*** '''FirstNameRus''' – имя (рус)
+
*** '''FirstNameRus *''' – имя (рус)
*** '''LastNameRus''' – фамилия (рус)
+
*** '''LastNameRus *''' – фамилия (рус)
*** '''PatronymicRus''' – отчество (рус)
+
*** '''PatronymicRus *''' – отчество (рус)
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
*** '''InternationalPassportSeries *''' – серия загранпаспорта
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
*** '''InternationalPassportNumber *''' – номер загранпаспорта
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''InternationalPassportDateOfIssue *''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
+
*** '''InternationalPassportDateOfIssueString *''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''InternationalPassportDateOfExpiry *''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
+
*** '''InternationalPassportDateOfExpiryString *''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
*** '''internationalPassportByWhom *''' – кем выдан загранпаспорт
*** '''PassportSeries''' – серия паспорта
+
*** '''PassportSeries *''' – серия паспорта
*** '''PassportNumber''' – номер паспорта
+
*** '''PassportNumber *''' – номер паспорта
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''PassportDateOfIssue *''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
+
*** '''PassportDateOfIssueString *''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
*** '''PassportByWhom''' – кем выдан паспорт
+
*** '''PassportByWhom *''' – кем выдан паспорт
*** '''Citizenship''' – название страны
+
*** '''Citizenship *''' – название страны
*** '''Phone''' – телефон
+
*** '''Phone *''' – телефон
*** '''Email''' – e-mail
+
*** '''Email *''' – e-mail
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
*** '''BirthDay *''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
*** '''BirthDayString *''' – дата рождения в строковом формате (DD.MM.YYYY)
*** '''BirthPlace''' – место рождения
+
*** '''BirthPlace *''' – место рождения
*** '''CitizenID''' – ID туриста (задается в карточке постоянного клиента)
+
*** '''CitizenID *''' – ID туриста (задается в карточке постоянного клиента)
*** '''Age''' – количество полных лет на момент окончания тура
+
*** '''Age *''' – количество полных лет на момент окончания тура
** '''BranchId''' – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур.
+
** '''BranchId *''' – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур. ''Может быть с пустым значением''
** '''OwnerId''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
+
** '''OwnerId *''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура. ''Может быть с пустым значением''
** '''Day''' – день (перевод)
+
** '''Day *''' – день (перевод) ''Может быть с пустым значением''
** '''Day2''' – дня (перевод)
+
** '''Day2 *''' – дня (перевод) ''Может быть с пустым значением''
** '''Days''' – дней (перевод)
+
** '''Days *''' – дней (перевод) ''Может быть с пустым значением''
** '''Night''' – ночь (перевод)
+
** '''Night *''' – ночь (перевод) ''Может быть с пустым значением''
** '''Night2''' – ночи (перевод)
+
** '''Night2 *''' – ночи (перевод) ''Может быть с пустым значением''
** '''Nights''' – ночей (перевод)
+
** '''Nights *''' – ночей (перевод) ''Может быть с пустым значением''
** '''adultsCountOverServiceLimit''' – Количество взрослых туристов превышает лимит услуги (перевод)
+
** '''adultsCountOverServiceLimit *''' – Количество взрослых туристов превышает лимит услуги (перевод) ''Может быть с пустым значением''
** '''incorrectChildrenInf''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)  
+
** '''incorrectChildrenInf *''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) ''Может быть с пустым значением''
 
+
** '''OrderInfoUrl''' – Адрес окна путевки в личном кабинете
* Возвращаемый результат:
+
** '''DogovorComment''' – Комментарий к путевке (сохраняется как сообщения в истории путевки) ''Может быть с пустым значением''
** '''Reservation''' – объект путевки
+
 
 +
 
 +
* Возвращаемый результат:
 +
** '''Reservation''' – объект путевки
 
*** '''$id''' – внутренний идентификатор для установки связей между сущностями,
 
*** '''$id''' – внутренний идентификатор для установки связей между сущностями,
 
*** '''Code''' – код путевки
 
*** '''Code''' – код путевки
Строка 6322: Строка 6842:
 
*** '''Discount''' – величина скидки на одного человека
 
*** '''Discount''' – величина скидки на одного человека
 
*** '''DiscountSum''' – абсолютная величина скидки
 
*** '''DiscountSum''' – абсолютная величина скидки
*** '''SORCode''' – ключ статус путевки
+
*** '''SORCode''' – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
 
*** '''CrDate''' – дата и время создания путевки
 
*** '''CrDate''' – дата и время создания путевки
 
*** '''Rate''' – код валюты путевки
 
*** '''Rate''' – код валюты путевки
Строка 6649: Строка 7169:
 
             "Phone": "",
 
             "Phone": "",
 
             "Email": "",
 
             "Email": "",
             "BirthDay": "1979-12-31T21:00:00.000Z",
+
             "BirthDay": "1980-01-01T00:00:00.000Z",
 
             "BirthDayString": "01.01.1980",
 
             "BirthDayString": "01.01.1980",
 
             "BirthPlace": "Москва",
 
             "BirthPlace": "Москва",
Строка 6680: Строка 7200:
 
             "Phone": "",
 
             "Phone": "",
 
             "Email": "",
 
             "Email": "",
             "BirthDay": "1980-12-31T21:00:00.000Z",
+
             "BirthDay": "1981-01-01T00:00:00.000Z",
 
             "BirthDayString": "01.01.1981",
 
             "BirthDayString": "01.01.1981",
 
             "BirthPlace": "Москва",
 
             "BirthPlace": "Москва",
Строка 6697: Строка 7217:
 
     "Nights": "ночей",
 
     "Nights": "ночей",
 
     "adultsCountOverServiceLimit": "Количество взрослых туристов превышает лимит услуги",
 
     "adultsCountOverServiceLimit": "Количество взрослых туристов превышает лимит услуги",
     "incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)"
+
     "incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)",
 +
    "OrderInfoUrl": "http://localhost/MasterWeb/OrderInfo.aspx",
 +
    "DogovorComment": ""
 +
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 7117: Строка 7640:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка информации о путевке (GetReservation)===
+
===Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)===
Метод выводит информацию о бронированной путевке.
+
Метод производит бронирование путевки с упрощенными входными параметрами. <br />
 +
При бронировании проверяется корректность заполнения обязательных полей туристов. В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.
  
* Формат запроса:
+
*Формат запроса:
** GET .../TourSearchOwin/GetReservation?
+
** PUT .../TourSearchOwin/CreateReservationExternalSystem/1?
  
* Принимаемые параметры headers ( '''*''' – обязательный):
+
*Принимаемые параметры headers ('''*''' – обязательный):
 
** '''Content-Type *''' – application/json
 
** '''Content-Type *''' – application/json
** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)  
+
** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
+
*Принимаемые параметры PUT запроса:
** '''dgCode *''' – номер путевки:
+
** '''BeginDate *''' – дата начала тура (YYYY-MM-DDThh:mm)
 
+
** '''Duration *''' – продолжительность тура в днях
* Возвращаемый результат:
+
** '''Currency *''' – код валюты
** '''$id''' – внутренний идентификатор для установки связей между сущностями,
+
** '''TourProgramId''' – идентификатор турпрограммы (необязательный, по умолчанию 0)
** '''Code''' – код путевки
+
** '''Services *''' – массив услуг, в данном случае будет содержать только услугу отель
** '''TurDate''' – дата заезда
+
*** '''Code *''' – идентификатор отеля во внешней системе, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
** '''TRKey''' – ключ тура
+
*** '''Cost *''' – стоимость проживания за весь период
** '''CNKey''' – ключ страны
+
*** '''Packet *''' – идентификатор пакета, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
** '''CTKey''' – ключ города
+
*** '''SubCode1 *''' – идентификатор типа номера, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
** '''NMen''' – количество туристов по путевке
+
** '''Tourists *''' – массив туристов
** '''Price''' – стоимость путевки за вычетом скидки (комиссии)
+
*** '''FirstName *''' – имя туриста
** '''Payed''' – оплаченная сумма по путевке
+
*** '''LastName *''' – фамилия туриста
** '''NDay''' – продолжительность тура в днях
+
*** '''Patronymic *''' – отчество туриста
** '''MainMan''' – ФИО лица, заключившего договор
+
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 женский)
** '''MainManPhone''' – номер телефона лица, заключившего договор
+
*** '''AgeType *''' – тип туриста (0 взрослый, 1 ребенок, 2 инфант)
** '''MainManAddress''' – адрес лица, заключившего договор
+
*** '''Age *''' – количество полных лет на момент окончания тура
** '''MainManPassport''' – паспортные данные лица, заключившего договор
+
*** '''Phone *''' – телефон (обязателен для первого туриста)
** '''PartnerKey''' – ключ партнера, оформившего договор
+
*** '''Email *''' – e-mail (обязателен для первого туриста)
** '''Operator''' – ФИО создателя договора
+
** '''DogovorComment *''' – комментарий к путевке (ограничение 254 символа, при превышении разбивается на части)
** '''Discount''' – величина скидки на одного человека
+
[[Файл:Am 063.png|left]]<br />
** '''DiscountSum''' – абсолютная величина скидки
+
1. В случае, если в теле запроса указываются ID несинхронизированных отелей, пакета, типа номера, то создаются фиктивные данные, которые необходимо изменить в услуге экрана ''Путевка'' (пример: Отель ApiHotel, пакет ApiPacket, тип номера ApiRoom(ApiRoomCategory),ApiAccmdmen)<br />
** '''SORCode''' – ключ статус путевки
+
2. Тип питания всегда будет создаваться фиктивный и его необходимо изменить в услуге экрана ''Путевка'' (пример: Тип питания ApiPansion)<br /><br /><br />
** '''CrDate''' – дата и время создания путевки
+
*Возвращаемый результат:
** '''Rate''' – код валюты путевки
+
** '''Reservation''' – объект путевки
** '''Advertise''' – ключ источника рекламы
+
*** '''$id''' – внутренний идентификатор для установки связей между сущностями,
** '''Locked''' – блокировка путевки: ''1'' – если заблокирована
+
*** '''Code''' – код путевки
** '''CauseDisc''' – ключ основания для скидки
 
** '''PPaymentDate''' – максимальная дата внесения предоплаты
 
** '''PaymentDate''' – максимальная дата полной оплаты
 
** '''Procent''' – информация о предоплате: ''1'' – предоплата в %; ''0'' предоплата в у.е.
 
** '''TurDateBfrAnnul''' значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
 
** '''ARKey''' – ключ причины аннуляции путевки
 
** '''Key''' – ключ договора
 
** '''CodePartner''' значение ключевого поля из таблицы партнеров
 
** '''FilialKey''' ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
 
** '''IsOutDoc''' статус выдачи документов
 
** '''Notes''' – сообщение поставщику
 
** '''DiscSumBfrAnn''' – числовое значение скидки перед аннуляцией путевки
 
** '''PriceBfrAnn''' – стоимость путевки перед ее аннуляцией
 
** '''RazmerP''' – размер предоплаты
 
** '''LeadDepartment''' – ключ отдела, ведущего данный тур
 
** '''MainManEmail''' – адрес е-mail из данных лица, заключившего договор
 
** '''MainManComment''' – примечание из данных лица, заключившего договор
 
** '''DupUserKey''' – ключ представителя партнера, которым был оформлен договор
 
** '''BTKey''' – ключ системы бронирования, из которой был оформлен договор
 
** '''ConfirmedDate''' – дата подтверждения путевки покупателю
 
** '''PrtDogKey''' – договор партнера, по которому оформлена путевка
 
** '''CTDepartureKey''' – ключ города начала поездки
 
** '''PDTType''' – тип договора, по которому оформлена путевка
 
** '''NationalCurrencyPrice''' – стоимость путевки в национальной валюте
 
** '''NationalCurrencyDiscountSum''' – значение скидки в национальной валюте
 
** '''NationalCurrencyPayed''' – сумма платежей по путевке, зафиксированная в национальной валюте
 
** '''CurrencyKey''' ключ национальной валюты путевки
 
** '''CurrencyRate''' – курс национальной валюты путевки
 
** '''ClientKey''' – ключ частника, которым был оформлен договор
 
** '''Partner''' информация о партнере покупателе, привязанным к путевке
 
*** '''$id''' – внутренний идентификатор для установки связей между сущностями
 
*** '''Key''' – ключ партнера покумателя
 
*** '''FullName''' – полное имя партнера
 
*** '''Name''' – имя партнера
 
** '''Services''' – коллекция услуг в данной путевке
 
*** '''$id''' – внутренний идентификатор для установки связей между сущностями
 
*** '''DGCod''' – номер путевки
 
 
*** '''TurDate''' – дата начала тура
 
*** '''TurDate''' – дата начала тура
*** '''Key''' – ключ услуги
+
*** '''TRKey''' – идентификатор тура
*** '''PaketKey''' – ключ пакета
+
*** '''CNKey''' – идентификатор страны
*** '''TRKey''' – клют тура
+
*** '''CTKey''' – идентификатор города
*** '''SVKey''' – ключ типа услуги
+
*** '''NMen''' – количество туристов
*** '''Name''' – наименование услуги
+
*** '''Price''' – стоимость путевки
*** '''Day''' – порядковый номер дня тура, в который предоставляется услуга
+
*** '''Payed''' – оплаченная сумма
*** '''Code''' – ключ кода услуги
+
*** '''NDay''' – продолжительность тура в днях
*** '''SubCode1''' – ключ доп.описания 1 услуги
+
*** '''MainMan''' – контактное лицо
*** '''SubCode2''' – ключ доп.описания 2 услуги
+
*** '''MainManPhone''' – телефон контактного лица
*** '''Men''' – количество человек, пользующихся услугой по путевке
+
*** '''MainManAddress''' – адрес лица, заключившего договор
*** '''Days''' – количество дней услуги
+
*** '''MainManPassport''' – паспортные данные контактного лица
*** '''CNKey''' – ключ страны услуги
+
*** '''PartnerKey''' – идентификатор партнера
*** '''CTKey''' – ключ города услуги
+
*** '''Operator''' – оператор, оформивший путевку
*** '''PartnerKey''' – ключ партнера, предоставляющего услугу
+
*** '''Discount''' – размер скидки
*** '''Brutto''' – стоимость услуги брутто
+
*** '''DiscountSum''' – сумма скидки
*** '''Wait''' – признак услуги ''Снимать квоту при бронировании''
+
*** '''SORCode''' – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
*** '''Warning''' – неиспользуемое поле
+
*** '''CrDate''' – дата создания путевки
*** '''TimeBeg''' – поле используется для сортировки услуг в путевке
+
*** '''Rate''' – код валюты путевки
*** '''Control''' – ключ статуса услуги (ссылка на таблицу Controls),
+
*** '''Advertise''' – идентификатор рекламного источника
*** '''Attribute''' – атрибут услуги
+
*** '''Locked''' – статус блокировки путевки
*** '''DateBeg''' – дата начала действия услуги
+
*** '''CauseDisc''' – код основания скидки
*** '''DateEnd''' – дата окончания действия услуги
+
*** '''PPaymentDate''' – дата предоплаты
*** '''Discount''' – размер скидки по услуге
+
*** '''PaymentDate''' – максимальная дата полной оплаты
*** '''Comment''' – комментарий к услуге
+
*** '''Procent''' – предоплата в %
*** '''DGKey''' – ключ договора,
+
*** '''TurDateBfrAnnul''' – дата начала тура до аннуляции
*** '''Blocked''' – признак блокировки услуги (''0'' – не блокирована, ''1'' – блокирована)
+
*** '''ARKey''' – идентификатор причины аннуляции
*** '''NameLat''' – наименование услуги (латинский)
+
*** '''Key''' – идентификатор договора
*** '''Long''' – продолжительность тура в днях
+
*** '''CodePartner''' – идентификатор партнера
*** '''TRFId''' – ключ тарифа
+
*** '''FilialKey''' – идентификатор филиала
*** '''CreateDate''' – дата создания услуги в путевке
+
*** '''IsOutDoc''' – статус выдачи документов
*** '''CalculatePriceDate''' – дата расчета цены
+
*** '''Notes''' – примечания
*** '''ShowOrder''' – порядок при сортировке
+
*** '''DiscSumBfrAnn''' – сумма скидки перед аннуляцией
*** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
+
*** '''PriceBfrAnn''' – цена путевки перед аннуляцией
**** '''$ref''' – связь с внутренним идентификатором ''$id''
+
*** '''RazmerP''' – размер предоплаты
** '''Turists''' – коллекция туристов в данной путевке
+
*** '''LeadDepartment''' – идентификатор ведущего отдела
*** '''$id''' – внутренний идентификатор для установки связей между сущностями
+
*** '''MainManEmail''' – e-mail контактного лица
*** '''DGCod''' – номер путевки, к которому привязан турист
+
*** '''MainManComment''' – комментарий контактного лица
*** '''Key''' – ключ туриста
+
*** '''DupUserKey''' – идентификатор представителя агента
*** '''TurDate''' – дата начала тура
+
*** '''BTKey''' – идентификатор системы бронирования
*** '''NameRus''' – фамилия туриста (русское)
+
*** '''ConfirmedDate''' – дата подтверждения путевки
*** '''NameLat''' – фамилия туриста (латинское)
+
*** '''PrtDogKey''' – идентификатор договора партнера
*** '''ShortName''' – имя и отчество туриста в формате ''И.О.''
+
*** '''CTDepartureKey''' – идентификатор города отправления
*** '''Sex''' – пол туриста (признак): ''Null'' или ''0'' – Муж; ''1'' – Жен; ''2'' – Child (ребенок); ''3'' – Infant (младенец)
+
*** '''PDTType''' – тип договора путевки
*** '''FNameRus''' – имя туриста (русское)
+
*** '''NationalCurrencyPrice''' – цена в национальной валюте
*** '''FNameLat''' – имя туриста (латинское)
+
*** '''NationalCurrencyDiscountSum''' – сумма скидки в национальной валюте
*** '''SNameRus''' – отчество туриста (русское)
+
*** '''NationalCurrencyPayed''' – оплаченная сумма в национальной валюте
*** '''SNameLat''' – отчество туриста (латинское)
+
*** '''CurrencyKey''' – идентификатор валюты
*** '''BirthDay''' – дата рождения туриста
+
*** '''CurrencyRate''' – курс валюты
*** '''BirthCountry''' – страна рождения туриста
+
*** '''ClientKey''' – идентификатор клиента
*** '''BirthCity''' – город рождения туриста
+
*** '''AgencyPrice''' – цена для агентства
*** '''Citizen''' – гражданство туриста
+
*** '''Partner''' – информация о партнере
*** '''PostIndex''' – почтовый индекс
+
**** '''$id''' – идентификатор записи
*** '''PostCity''' – адрес проживания туриста (город)
+
**** '''Key''' – идентификатор партнера
*** '''PostStreet''' – адрес проживания туриста (улица)
+
**** '''FullName''' – полное название партнера
*** '''PostBild''' – адрес проживания туриста (номер дома)
+
**** '''Name''' – краткое название партнера
*** '''PostFlat''' – адрес проживания туриста (номер квартиры)
+
*** '''Services''' – список услуг
*** '''Phone''' – номер телефона туриста
+
**** '''$id''' – внутренний идентификатор для установки связей между сущностями
*** '''PhoneCode''' – код телефона туриста
+
**** '''DGCod''' – номер путевки
*** '''PasportType''' – серия заграничного паспорта
+
**** '''TurDate''' – дата начала тура
*** '''PasportNum''' – номер заграничного паспорта
+
**** '''Key''' – ключ услуги
*** '''PasportDate''' – дата выдачи заграничного паспорта
+
**** '''PaketKey''' – ключ пакета
*** '''PasportDateEnd''' – дата окончания срока действия заграничного паспорта
+
**** '''TRKey''' – клют тура
*** '''PasportByWhom''' – кем выдан заграничный паспорт
+
**** '''SVKey''' – ключ типа услуги
*** '''Place''' – место рождения
+
**** '''Name''' – наименование услуги
*** '''IsAnketa''' – выдавалась ли анкета
+
**** '''Day''' – порядковый номер дня тура, в который предоставляется услуга
*** '''PaspRuser''' – серия общегражданского паспорта
+
**** '''Code''' – ключ кода услуги
*** '''PaspRuNum''' – номер общегражданского паспорта
+
**** '''SubCode1''' – ключ доп.описания 1 услуги
*** '''PaspRuDate''' – дата выдачи общегражданского паспорта
+
**** '''SubCode2''' – ключ доп.описания 2 услуги
*** '''PaspRuByWhom''' – кем выдан общегражданский паспорт
+
**** '''Men''' – количество человек, пользующихся услугой по путевке
*** '''ClientId''' – ключ в таблице клиентов
+
**** '''Days''' – количество дней услуги
*** '''IsMain''' – признак главного туриста по путевке
+
**** '''CNKey''' – ключ страны услуги
*** '''DGKey''' – ключ кутевки
+
**** '''CTKey''' – ключ города услуги
*** '''RealSex''' – реальный пол туриста: ''Null'' или ''0'' – Муж; ''1'' – Жен
+
**** '''PartnerKey''' – ключ партнера, предоставляющего услугу
*** '''Email''' – е-mail туриста
+
**** '''Brutto''' – стоимость услуги брутто
*** '''EnableSmsNotifications''' – согласен получать уведомления по СМС
+
**** '''Wait''' – признак услуги ''Снимать квоту при бронировании''
*** '''CitizenId''' – идентификатор туриста
+
**** '''Warning''' – неиспользуемое поле
*** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
+
**** '''TimeBeg''' – поле используется для сортировки услуг в путевке
**** '''$ref''' – связь с внутренним идентификатором ''$id''
+
**** '''Control''' – ключ статуса услуги (ссылка на таблицу Controls),
** '''TuristServices''' – коллекция связей туриста с услугой
+
**** '''Attribute''' – атрибут услуги
*** '''$id''' – внутренний идентификатор для установки связей между сущностями
+
**** '''DateBeg''' – дата начала действия услуги
*** '''TUKey''' – ключ туриста
+
**** '''DateEnd''' – дата окончания действия услуги
*** '''DLKey''' – ключ услуги
+
**** '''Discount''' – размер скидки по услуге
*** '''NumDoc''' – номер документа (авиабилета)
+
**** '''Comment''' – комментарий к услуге
*** '''NumRoom''' – номер комнаты (каюты)
+
**** '''DGKey''' – ключ договора,
*** '''Seat''' – номер места (в номере отеля, каюты) или место в транспорте
+
**** '''Blocked''' – признак блокировки услуги (''0'' – не блокирована, ''1'' – блокирована)
*** '''Area''' – зона (палуба) в отеле, круизе
+
**** '''NameLat''' – наименование услуги (латинский)
*** '''DocDate''' – дата документа (авиабелета)
+
**** '''Long''' – продолжительность тура в днях
*** '''Key''' – первичный ключ связки
+
**** '''TRFId''' – ключ тарифа
*** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
+
**** '''CreateDate''' – дата создания услуги в путевке
**** '''$ref''' – связь с внутренним идентификатором ''$id''
+
**** '''CalculatePriceDate''' – дата расчета цены
** '''DogovorMessages''' – сообщение по путевке покупателю
+
**** '''ShowOrder''' – порядок при сортировке
*** '''id''' – внутренний идентификатор для установки связей между сущностями
+
**** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
*** '''Date''' – дата создание сообщения
+
***** '''$ref''' – связь с внутренним идентификатором ''$id''
*** '''Text''' – текст сообщения
+
*** '''Turists''' – список туристов
*** '''Remark''' – код сообщения
+
**** '''$id''' – внутренний идентификатор для установки связей между сущностями
*** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
+
**** '''DGCod''' – номер путевки, к которому привязан турист
**** '''$ref''' – связь с внутренним идентификатором ''$id''  
+
**** '''Key''' – ключ туриста
 +
**** '''TurDate''' – дата начала тура
 +
**** '''NameRus''' – фамилия туриста (русское)
 +
**** '''NameLat''' – фамилия туриста (латинское)
 +
**** '''ShortName''' – имя и отчество туриста в формате ''И.О.''
 +
**** '''Sex''' – пол туриста (признак): ''Null'' или ''0'' – Муж; ''1'' – Жен; ''2'' – Child (ребенок); ''3'' – Infant (младенец)
 +
**** '''FNameRus''' – имя туриста (русское)
 +
**** '''FNameLat''' – имя туриста (латинское)
 +
**** '''SNameRus''' – отчество туриста (русское)
 +
**** '''SNameLat''' – отчество туриста (латинское)
 +
**** '''BirthDay''' – дата рождения туриста
 +
**** '''BirthCountry''' – страна рождения туриста
 +
**** '''BirthCity''' – город рождения туриста
 +
**** '''Citizen''' – гражданство туриста
 +
**** '''PostIndex''' – почтовый индекс
 +
**** '''PostCity''' – адрес проживания туриста (город)
 +
**** '''PostStreet''' – адрес проживания туриста (улица)
 +
**** '''PostBild''' – адрес проживания туриста (номер дома)
 +
**** '''PostFlat''' – адрес проживания туриста (номер квартиры)
 +
**** '''Phone''' – номер телефона туриста
 +
**** '''PhoneCode''' – код телефона туриста
 +
**** '''PasportType''' – серия заграничного паспорта
 +
**** '''PasportNum''' – номер заграничного паспорта
 +
**** '''PasportDate''' – дата выдачи заграничного паспорта
 +
**** '''PasportDateEnd''' – дата окончания срока действия заграничного паспорта
 +
**** '''PasportByWhom''' – кем выдан заграничный паспорт
 +
**** '''Place''' – место рождения
 +
**** '''IsAnketa''' – выдавалась ли анкета
 +
**** '''PaspRuser''' – серия общегражданского паспорта
 +
**** '''PaspRuNum''' – номер общегражданского паспорта
 +
**** '''PaspRuDate''' – дата выдачи общегражданского паспорта
 +
**** '''PaspRuByWhom''' – кем выдан общегражданский паспорт
 +
**** '''ClientId''' – ключ в таблице клиентов
 +
**** '''IsMain''' – признак главного туриста по путевке
 +
**** '''DGKey''' – ключ кутевки
 +
**** '''RealSex''' – реальный пол туриста: ''Null'' или ''0'' – Муж; ''1'' – Жен
 +
**** '''Email''' – е-mail туриста
 +
**** '''EnableSmsNotifications''' – согласен получать уведомления по СМС
 +
**** '''CitizenId''' – идентификатор туриста
 +
**** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
 +
***** '''$ref''' – связь с внутренним идентификатором ''$id''
 +
*** '''TuristServices''' – коллекция связей туриста с услугой
 +
**** '''$id''' – внутренний идентификатор для установки связей между сущностями
 +
**** '''TUKey''' – ключ туриста
 +
**** '''DLKey''' – ключ услуги
 +
**** '''NumDoc''' – номер документа (авиабилета)
 +
**** '''NumRoom''' – номер комнаты (каюты)
 +
**** '''Seat''' – номер места (в номере отеля, каюты) или место в транспорте
 +
**** '''Area''' – зона (палуба) в отеле, круизе
 +
**** '''DocDate''' – дата документа (авиабелета)
 +
**** '''Key''' – первичный ключ связки
 +
**** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
 +
***** '''$ref''' – связь с внутренним идентификатором ''$id''
 +
*** '''DogovorMessages''' – сообщение по путевке покупателю
 +
**** '''id''' – внутренний идентификатор для установки связей между сущностями
 +
**** '''Date''' – дата создание сообщения
 +
**** '''Text''' – текст сообщения
 +
**** '''Remark''' – код сообщения
 +
**** '''Connections''' – коллекция связей с сущностями через внутренний идентификатор ''$id''
 +
***** '''$ref''' – связь с внутренним идентификатором ''$id''
 +
** '''ValidationResultSummary''' – объект статус результата бронирования
 +
*** '''ValidationResult''' – объект с ошибками и флагом валидности путевки
 +
**** '''Errors''' – массив ошибок бронирования
 +
**** '''IsValid''' – признак валидности бронирования
 +
*** '''ValidationResultAttributes''' – атрибут результата бронирования
 +
 
  
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px">Пример запроса
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода CostOfferDescriptions
+
Вызов метода CreateReservationExternalSystem
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
GET http://localhost:9000/TourSearchOwin/GetReservation?dgCode=AU10101003
+
PUT http://localhost:9000/TourSearchOwin/CreateReservationExternalSystem/1?
 
Content-Type: application/json
 
Content-Type: application/json
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAdsCC8X7m9E-2bg0-uS0VfgAAAAAAAAADZgAAwAAAA-
+
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAObjhnb1q7EOpYmBFLH9T4AAAAAACAAAAAAAQZgAAAAEAACAAAACi2OgeCgKM2UVjnd-_y7WK9Tp90D7uiyDzOpQNy2PUrQAAAAAOgAAAAAIAACAAAABBwMz7N-
EqAAAAAASAAACgAAAAEAAAAO4S-VrqBhQuhqliqrAKKfIgAQAAn-gfgP-rYjk-Krr1Ck2A-IGCw6FBhamUOzFxgTtk1hR-
+
lZMFS0R9BqYXrNkVEL0ORSd2IpZ95J78cBHDABAABoZQCpqlwdHPASxLfQj-sRBv1S-kkGRC3g6wMlF_UjzI4PGIv_x5SdDwdIqoveXSyxshY88VidzcMRZjk2HJFjUJrcG_e8FfKpzUZUuFvq1dASzSm83JNgdqNaPjnjqSpffBEfD-zA1L77wMgN9_d70lVTh8PlxXkx_fxQI3D0Dcymqz-Q7ymsWM9HMDlmQ2BllmjBisc8UaYLT3VvmAvI1uDL08FFT1Rx9LFMi2B36OGZQgUoona0KuY48x5Xhbx5yeLAKdvqqEDViG35z7H8_gVU8T5TR08PDJvxvAe24lV1rBGidGNZqPL4meuSrh1hUl9j2vmFfhdGIyBhz7B9Z1Q2iDNfL6j-YfNEcuj8SGTMm5pfObAdcjH5CKI4T-
GLMryFIH8VK5GmHdHubZWj4S7XcazGL1Kn5-VlbiYdW2ZVWpYlk638aV-XS2kpZ9YrKgViiM_x8RH5TPo4-
+
QWcvE6HUfRs0UzAf2eF1bXQAAAAGMNV8S-M1ckRYpUCIVNPCLWi4g9HR0oIIJIRCMpu3hAJPM1xlNSaaYabu-il-PwoOthHujA2PZXtXj9-o3wpEA
9LhE7V-SjiB_CP_qs58DRKcyohq3Tz9QaiFgH1Ko7O2XKjTBG7SHyQPDPYjaqg9kDxmzq0UcIT6Fm4YkDxmm9-
+
{
CW7u3cEFWcpiqKOc2VvZFKPPHc07uDOO4w9FXPhpXZwOqrJBxzhbr73RuhzPs_e-hgxKaIlsMaK5b0v5ReAMy1kuY0ebXA
+
    "BeginDate": "2024-12-16T14:00",
 +
    "Duration": 4,
 +
    "Currency": "рб",
 +
    "TourProgramId": 0,
 +
    "Services": [
 +
        {
 +
            "Code": "8746",
 +
            "Cost": 9900,
 +
            "Packet": "359679",
 +
            "SubCode1": "356847"
 +
        }
 +
    ],
 +
    "Tourists": [
 +
        {
 +
            "FirstName": "Иван",
 +
            "LastName": "Иванов",
 +
            "Patronymic": "Иванович",
 +
            "MaleFemaleSex": 0,
 +
            "AgeType": 0,
 +
            "Age": 18,
 +
            "Phone": "79876543232",
 +
            "Email": "emailqwerty123@example.com"
 +
        },
 +
        {
 +
            "FirstName": "Петр",
 +
            "LastName": "Петров",
 +
            "Patronymic": "Петрович",
 +
            "MaleFemaleSex": 0,
 +
            "AgeType": 0,
 +
            "Age": 18
 +
        }
 +
    ],
 +
    "DogovorComment": "Это тестовая путевка. Клиент указывает детали отеля и размещения."
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода GetReservation (в формате JSON)
+
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px">Пример ответа
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Возвращаемый результат метода CreateReservationExternalSystem (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
    "$id": 1,
+
    "Reservation": {
    "Code": "AU10101003",
+
        "$id": 1,
    "TurDate": "2021-01-01T00:00:00",
+
        "Code": "RU27010037",
    "TRKey": 100000038,
+
        "TurDate": "2025-01-27T12:00:00",
    "CNKey": 90,
+
        "TRKey": 0,
    "CTKey": 35,
+
        "CNKey": 460,
    "NMen": 2,
+
        "CTKey": 1,
    "Price": 877,
+
        "NMen": 2,
    "Payed": 0,
+
        "Price": 9900.0,
    "NDay": 9,
+
        "Payed": 0.0,
    "MainMan": "",
+
        "NDay": 4,
    "MainManPhone": "",
+
        "MainMan": "Тестовый Представитель",
    "MainManAddress": "",
+
        "MainManPhone": "+79139992222",
    "MainManPassport": "",
+
        "MainManAddress": "",
    "PartnerKey": 10762,
+
        "MainManPassport": "11111 2222222222222",
    "Operator": "Megatec ",
+
        "PartnerKey": 12667,
    "Discount": 40,
+
        "Operator": "Allservises A.A.",
    "DiscountSum": 80,
+
        "Discount": 17.0,
    "SORCode": 3,
+
        "DiscountSum": 0.0,
    "CrDate": "2020-10-12T15:02:29.013",
+
        "SORCode": 0,
    "Rate": "$",
+
        "CrDate": "2025-01-24T17:26:17.25",
    "Advertise": 0,
+
        "Rate": "рб",
    "Locked": null,
+
        "Advertise": 0,
    "CauseDisc": null,
+
        "Locked": null,
    "PPaymentDate": null,
+
        "CauseDisc": 0,
    "PaymentDate": "2020-10-14T00:00:00",
+
        "PPaymentDate": null,
    "Procent": 1,
+
        "PaymentDate": "2025-01-26T00:00:00",
    "TurDateBfrAnnul": null,
+
        "Procent": 1,
    "ARKey": 0,
+
        "TurDateBfrAnnul": null,
    "Key": 40335,
+
        "ARKey": 0,
    "CodePartner": null,
+
        "Key": 54010,
    "FilialKey": 1,
+
        "CodePartner": null,
    "IsOutDoc": 0,
+
        "FilialKey": 12850,
    "Notes": null,
+
        "IsOutDoc": 0,
    "DiscSumBfrAnn": null,
+
        "Notes": null,
    "PriceBfrAnn": null,
+
        "DiscSumBfrAnn": null,
    "RazmerP": 0,
+
        "PriceBfrAnn": null,
    "LeadDepartment": 0,
+
        "RazmerP": 10.0,
    "MainManEmail": "test@megatec.ru",
+
        "LeadDepartment": 0,
    "MainManComment": "",
+
        "MainManEmail": "test@megatec.ru",
    "DupUserKey": 6,
+
        "MainManComment": "",
    "BTKey": 1,
+
        "DupUserKey": 333,
    "ConfirmedDate": null,
+
        "BTKey": 1,
    "PrtDogKey": 11,
+
        "ConfirmedDate": null,
    "CTDepartureKey": 1,
+
        "PrtDogKey": 1335,
    "PDTType": 0,
+
        "CTDepartureKey": 0,
    "NationalCurrencyPrice": null,
+
        "PDTType": 0,
    "NationalCurrencyDiscountSum": null,
+
        "NationalCurrencyPrice": null,
    "NationalCurrencyPayed": null,
+
        "NationalCurrencyDiscountSum": null,
    "CurrencyKey": null,
+
        "NationalCurrencyPayed": null,
    "CurrencyRate": null,
+
        "CurrencyKey": null,
    "ClientKey": null,
+
        "CurrencyRate": null,
    "Partner": {
+
        "ClientKey": null,
        "$id": 2,
+
        "AgencyPrice": 0.0,
        "Key": 10762,
+
        "Partner": {
        "FullName": "Агентство",
+
            "$id": 2,
        "Name": "Агентство"
+
            "Key": 12667,
    },
+
            "FullName": "Партнер-покупатель (полное название)",
    "Services": [{
+
            "Name": "Партнер-покупатель122"
            "$id": 3,
+
        },
            "DGCod": "AU10101003",
+
        "Services": [
            "TurDate": "2021-01-01T00:00:00",
+
            {
            "Key": 202463,
+
                "$id": 3,
            "PaketKey": 209,
+
                "DGCod": "RU27010037",
            "TRKey": 100000038,
+
                "TurDate": "2025-01-27T12:00:00",
            "SVKey": 1,
+
                "Key": 250570,
            "Name": "А_П::Москва/Вена/00444, DME-VIE, 14:00-16:30/C Бизнес класс",
+
                "PaketKey": 2043,
            "Day": 1,
+
                "TRKey": 0,
            "Code": 570,
+
                "SVKey": 3,
            "SubCode1": 67,
+
                "Name": "HOTEL::Москва/ApiHotel-,3 ночи/ApiRoom(ApiRoomCategory),ApiAccmdmen/ApiPansion ApiPansion",
            "SubCode2": 1,
+
                "Day": 1,
            "Men": 2,
+
                "Code": 341264,
            "Days": 0,
+
                "SubCode1": 1552918,
            "CNKey": 90,
+
                "SubCode2": 1812,
            "CTKey": 35,
+
                "Men": 2,
            "PartnerKey": 10760,
+
                "Days": 3,
            "Brutto": 162.2,
+
                "CNKey": 460,
            "Wait": null,
+
                "CTKey": 1,
            "Warning": 0,
+
                "PartnerKey": 0,
            "TimeBeg": "
+
                "Brutto": 9900.0,
 +
                "Wait": null,
 +
                "Warning": 0,
 +
                "TimeBeg": "1899-01-01T00:00:00",
 +
                "Control": 1,
 +
                "Attribute": 65695,
 +
                "DateBeg": "2025-01-27T00:00:00",
 +
                "DateEnd": "2025-01-29T00:00:00",
 +
                "Discount": 0.0,
 +
                "Comment": null,
 +
                "DGKey": 54010,
 +
                "Blocked": null,
 +
                "NameLat": "HOTEL:
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода Client
+
Вызов метода CostOfferDescriptions
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/Client?clientId=7314
+
GET http://localhost:9000/TourSearchOwin/CostOfferDescriptions?COKeysString=15143
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода Client (в формате JSON)
+
Возвращаемый результат метода CostOfferDescriptions (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
[
 +
      {
 +
      "CostOfferImageInfo":    {
 +
          "IdCostOffer": 15143,
 +
          "InfoText": "СПО до 01.01.2020"
 +
  },
 +
  }
 +
]
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
 
 +
===Получение капчи (GetCaptcha)===
 +
Метод возвращает капчу (используется при регистрации частного лица).
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/GetCaptcha?
 +
* Принимаемые параметры ( * – обязательный):
 +
** '''sessionId''' * – Id сессии
 +
* Возвращаемый результат:
 +
** '''FileContents''' – файл капчи в бинарном виде
 +
** '''ContentType''' – расширение файла (image/jpeg)
 +
** '''FileDownloadName''' – имя файла
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода GetCaptcha
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/GetCaptcha?sessionId=cd5yr3wftltmorphuzwx0krh
 +
</syntaxhighlight>
 +
Возвращаемый результат метода GetCaptcha (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
     "$id": "1",
+
     "FileContents": "iVBORw0KGgoAAAANSUhEUgAAALQAAAAyCAYAAAD1JPH3AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAA
     "CL_KEY": 7314,
+
     xiSURBVHhe7Z1NyE1tF8eNZMZEyUBGEikDAwNFKRSFMsCEMkDyOUG+Hgw8UkiPvHjLq1uRdBsgMVEGxERGGHGPmBkantdvd9Z51n3tdX3ts/c+5+Bfq/ucfa7Ptf5rXWtf1z
    "CL_OPERUPDATE": 106,
+
     7nntLpdFb8lL+qyqtXry4/f/78H+szLanlYjI+Pv6fsbGx/1qfjZJMTEz8ff369f/x1/q8LfkVdKkFQvOiEt69e9eZMmVKIQ8fPuxeLcNX7vv374WEQN3Xr18Xr58+fdpr58aNG8
    "CL_DATEUPDATE": "2021-01-21T11:56:41.287",
+
     W1UQXzOnXqVG9ug8CLFy8KXd66dat7JR8/fvwo2kFitqTs+/fvOx8+fOheqR/JhLYGDjmFYNeuXSuuWfCVw6iID5rAKJ0xbNmypXgPGdqEdqxRg2/cd+/eLXR56dKl4n2V+UFObI
    "CL_PFKEY": 2,
+
     GEbAkuXrzYs+f9+/e7V+tFMqF9A4dokBSyhZBaToOyKPvcuXM9J+IvY/j8+XPxvg24jjVKCEVh9Cu6DZXLhc/59+7d29Pjhg0bulfrRV8px+8Cy7FGBW4U9iG1XAwh5//69Wvn6N
    "CL_NAMERUS": "Test888",
+
     GjnbVr13Y+fvzYvVov/hC6BdSRrhBBc1Y3gY7CIaSWi2HQzt84oZnUqEW1fuDOt450hXrUhyQaKSQf5dy/ChonNArVOfevjpcvXxYiqCNiUc+9b/CRXGNQuf8gnehPytEH3GgM2n
    "CL_NAMELAT": "Test888",
+
     Jgi+RcI08VtL3809/58+cH4kSCkSJ03Z6PkfU2ZC7aIm9q/gyBILmAOm0QWcBO2LFjxzqrV6/u7Nu3r9W+BY0R2iIeE6w6ySaWT8gIAfpxEtqAcFVv2mJISS0ERGs9F/b/NcH7wa,
    "CL_SHORTNAME": "T.",
+
     "ContentType": "image/jpeg",
    "CL_SEX": 0,
+
     "FileDownloadName": ""
    "CL_FNAMERUS": "Test888",
+
}
    "CL_FNAMELAT": "Test888",
+
</syntaxhighlight>
    "CL_SNAMERUS": "",
+
</TD></TR></TABLE>
    "CL_SNAMELAT": "",
+
</div></div><br />
    "CL_BIRTHDAY": null,
+
 
    "CL_BIRTHCOUNTRY": "",
+
===Проверка капчи (CheckCaptcha)===
    "CL_BIRTHCITY": "",
+
Метод проверяет введенную капчу (используется при регистрации частного лица).
    "CL_CITIZEN": "Spain",
+
* Формат запроса:
    "CL_ADDRESS": ", г., ул., д., кв.",
+
** GET .../TourSearchOwin/CheckCaptcha?
    "CL_POSTINDEX": "",
 
    "CL_POSTCITY": "",
 
    "CL_POSTSTREET": "",
 
    "CL_POSTBILD": "",
 
    "CL_POSTFLAT": "",
 
    "CL_PHONE": "65465465",
 
    "CL_PASPORTSER": "",
 
    "CL_PASPORTNUM": "",
 
    "CL_PASPORTDATE": null,
 
    "CL_PASPORTDATEEND": null,
 
    "CL_PASPORTBYWHOM": "",
 
    "CL_PASPRUSER": "",
 
    "CL_PASPRUNUM": "",
 
    "CL_PASPRUDATE": null,
 
    "CL_PASPRUBYWHOM": "",
 
    "CL_ISMARK": 7,
 
    "CL_TYPE": 6,
 
    "CL_IMPRESSNOTE": "7",
 
    "CL_NOTE": "5",
 
     "CL_REMARK": "6",
 
     "CL_IMPRESSKEY": 3,
 
     "CL_TITLE1": "1",
 
     "CL_TITLE2": "2",
 
     "CL_TITLE3": "3",
 
    "CL_TITLE4": "4",
 
    "CL_FUTURE": "8",
 
    "CL_LASTSTAT": null,
 
    "CL_SUMMA": null,
 
    "CL_NMENWITH": null,
 
    "CL_SUMDOGOVOR": null,
 
    "CL_NTRIP": null,
 
    "ROWID": "AAAAAAJBNbw=",
 
    "cl_fax": "",
 
    "cl_mail": "test888@mail.ru",
 
     "CL_MINCOST": null,
 
    "CL_MAXCOST": null,
 
    "CL_RealSex": 0,
 
    "CL_EnableSmsNotifications": 0,
 
    "CL_CHECKED": false,
 
    "CL_Creator": 106,
 
    "CL_CreateDate": "2018-03-06T14:10:27.687",
 
    "CL_Login": "test888@mail.ru",
 
    "CL_Password": "/wjpKpaXhmuTtSaG6xIUtQ==",
 
     "CL_IsOnlineUser": true,
 
    "CL_CitizenID": "",
 
    "CARDS": []
 
}
 
</syntaxhighlight>
 
</TD></TR></TABLE>
 
</div></div><br />
 
 
 
===Выгрузка описаний ценовых блоков (CostOfferDescriptions)===
 
Метод выгружает описания ценовых блоков.
 
* Формат запроса:
 
** GET .../TourSearchOwin/CostOfferDescriptions?
 
 
* Принимаемые параметры ( * – обязательный):
 
* Принимаемые параметры ( * – обязательный):
** '''COKeysString *''' – ключи ценовых блоков
+
** '''captchaText''' * – текст капчи
 +
** '''sessionId''' * Id сессии
 
* Возвращаемый результат:
 
* Возвращаемый результат:
** '''IdCostOffer''' – Id ценового блока
+
** '''true/false''' – результат проверки (false – капча или Id сессии неверные, true капча верна)
** '''InfoText''' описание ценового блока
 
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода CostOfferDescriptions
+
Вызов метода CheckCaptcha
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/CostOfferDescriptions?COKeysString=16834,16828
+
GET http://localhost:9000/TourSearchOwin/CheckCaptcha?captchaText=vf8an&sessionId=cd5yr3wftltmorphuzwx0krh
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода CostOfferDescriptions (в формате JSON)
+
Возвращаемый результат метода CheckCaptcha (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
     "costOffersImageInformation": [
+
     true
        {
 
            "IdCostOffer": 16834,
 
            "InfoText": "Информация для онлайна 2"
 
        },
 
        {
 
            "IdCostOffer": 16828,
 
            "InfoText": "Информация для онлайна"
 
        },
 
    ]
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 8148: Строка 8858:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка описания по стране (CountryInfo)===
+
===Проверка e-mail (CheckMail)===
Метод выгружает описание по стране.
+
Метод проверяет e-mail при регистрации частного лица на существование такого же e-mail в базе данных.
 
* Формат запроса:
 
* Формат запроса:
** GET .../TourSearchOwin/CountryInfo?
+
** GET .../TourSearchOwin/CheckMail?
 
* Принимаемые параметры ( * – обязательный):
 
* Принимаемые параметры ( * – обязательный):
** '''countryKey *''' – ключ страны
+
** '''mail''' * e-mail пользователя
 
* Возвращаемый результат:
 
* Возвращаемый результат:
** '''информация по выбранной стране'''
+
** '''true/false''' – результат проверки (false – пользователь с таким e-mail уже существует, true – пользователь с таким e-mail нет в базе данных)
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода CountryInfo
+
Вызов метода CheckMail
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/CountryInfo?countryKey=90
+
GET http://localhost:9000/TourSearchOwin/CheckMail?mail=test@megatec.ru
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода CountryInfo (в формате JSON)
+
Возвращаемый результат метода CheckMail (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
"<p>Информация о стране</p>\n"
+
    true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 8173: Строка 8883:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка картинки по отелю (HotelImages)===
+
===Проверка туриста (checkTourist)===
Метод выгружает картинку по отелю.
+
Метод служит для получения информации о путевке по номеру путевки и номеру паспорта туриста.
 
* Формат запроса:
 
* Формат запроса:
** GET .../TourSearchOwin/HotelImages?
+
** GET .../TourSearchOwin/checkTourist?
 
* Принимаемые параметры ( * – обязательный):
 
* Принимаемые параметры ( * – обязательный):
** '''hotelKeys *''' – ключ отеля (можно передать несколько ключей отеля, каждый раз указывая параметр ''hotelKeys''), в этом случае возвращается информация о главном фото отеля
+
** '''dogovorNumber *''' – номер путевки.
* либо
+
** '''passport *''' – номер паспорта туриста (заграничного или общегражданского).
** '''hotelKey *''' – либо ключ отеля, в этом случае возвращается полная информация о всех фотографиях в отеле
+
* Возвращаемый результат:
* Возвращаемый результат (если передан ''hotelKeys''):
+
** '''isDogovor''' – '''true''', если путевка найдена по номеру путевки, '''false''', если не найдена.
** '''Name''' – название файла
+
** '''isAnnulated''' – '''true''', если путевка аннулирована, '''false''', если не аннулирована.
** '''HotelKey''' – ключ отеля
+
** '''dogovorStatus''' – статус путевки
** '''InfoExists''' – есть ли информация
+
** '''isPay''' – '''true''', если путевка полностью оплачена, '''false''', если не оплачена или оплачена частично.
** '''ImagesCount''' – общее количество картинок по отелю
+
** '''dogovorDateBegin''' – дата начала заезда.
* либо (если передан ''hotelKey'')
+
** '''dogovorDateEnd''' – дата окончания заезда.
** '''Images''' – объект картинок
+
** '''dogovorDateCreate''' – дата создания путевки.
*** '''Key''' – ключ картинки
+
** '''isTouristDogovorCreate''' – '''true''', если турист (по номеру паспорта) является главным туристом в путевке.
*** '''Description''' – описание картинки
+
** '''services''' – набор услуг в путевке.
*** '''Priority''' – приоритет
+
*** '''svKey''' – код класса услуги.
*** '''Name''' – название файла
+
*** '''code''' – код услуги.
*** '''HotelKey''' – ключ отеля
+
*** '''subCode1''' – код доп. описания 1 услуги.
*** '''InfoExists''' – есть ли информация
+
*** '''subCode2''' – код доп. описания 2 услуги.
** '''Country''' – страна отеля
+
*** '''name''' – название услуги.
** '''City''' – город отеля
+
** '''touristInfo''' – информация о главном туристе.
** '''Name''' – название отеля
+
*** '''lastname''' – фамилия туриста (рус).
** '''HotelCategoryName''' – категория отеля
+
*** '''firstname''' – имя туриста (рус).
** '''Address''' – адрес отеля
+
*** '''surname''' – отчество туриста.
** '''Phone''' – телефон
+
*** '''address''' – адрес (индекс, город, улица, дом, квартира).
** '''Email''' – e-mail
+
*** '''postcode''' – индекс.
** '''Http''' – адрес сайта
+
*** '''city''' – город.
** '''Description''' – описание отеля
+
*** '''street''' – улица.
** '''InfrastructureHotel''' – инфраструктура отеля
+
*** '''home''' – дом.
** '''RecreationSport''' – развлечения и спорт
+
*** '''roomNumber''' – квартира.
** '''Beach''' – информация о пляже
 
** '''Healing''' – лечение
 
** '''Excursion''' – экскурсии
 
** '''AdditionalService''' – дополнительные услуги
 
** '''ForChildren''' – для детей
 
** '''AddCost''' – доплаты
 
** '''CheckoutTimeFrom''' – заезд в отель
 
** '''CheckoutTimeTo''' – выезд из отеля
 
** '''Latitude''' – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
 
** '''Longitude''' – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
 
  
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример краткой информации отеля
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода HotelImages
+
Вызов метода checkTourist
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/HotelImages?hotelKeys=8660&hotelKeys=178
+
http://localhost:9000/TourSearchOwin/checkTourist?dogovorNumber=AU25120001&passport=1234567
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода HotelImages (в формате JSON)
+
Возвращаемый результат метода checkTourist (в формате JSON)
<syntaxhighlight lang="java" enclose="div">
 
[
 
    {
 
        "Name": "Dubai_Emirates_UAE_Skyscrapers_Megapolis_From_564495_2560x1599.jpg",
 
        "HotelKey": 8660,
 
        "InfoExists": true
 
    },
 
    {
 
        "Name": "Spain_Resorts_Houses_Tenerife_Canary_Islands_Pools_527022_1280x853.jpg",
 
        "HotelKey": 178,
 
        "InfoExists": true
 
    }
 
]
 
</syntaxhighlight>
 
</TD></TR></TABLE>
 
</div></div><br />
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример детальной информации отеля
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
Вызов метода HotelImages
 
<syntaxhighlight lang="java" enclose="div">
 
http://localhost:9000/TourSearchOwin/HotelImages?hotelKey=178
 
</syntaxhighlight>
 
Возвращаемый результат метода HotelImages (в формате JSON)
 
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
    "Images": [
+
  "isDogovor": true,
        {
+
  "isAnnulated": false,
            "Key": 2619,
+
  "dogovorStatus": "ОК",
            "Description": "",
+
  "isPay": true,
            "Priority": 1,
+
  "dogovorDateBegin": "05.02.2018",  
            "Name": "Spain_Resorts_Houses_Tenerife_Canary_Islands_Pools_527022_1280x853.jpg",
+
  "dogovorDateEnd": "12.02.2018",
            "HotelKey": 178,
+
  "dogovorDateCreate": "01.02.2018",
            "InfoExists": false
+
  "isTouristDogovorCreate": true,
        },
+
  "services":   [
        {
+
             {
            "Key": 2620,
+
        "svKey": "1",
            "Description": "",
+
        "code": "1088",
            "Priority": 2,
+
        "subCode1": "147",
             "Name": "stock-photo-luxury-bedrooms-with-flare-light-559774297.jpg",
+
        "subCode2": "35",
            "HotelKey": 178,
+
        "name": "А_П::Вена/Москва/SU2353, VIE-SVO, 18:05-22:40/NSU Экономический класс"
            "InfoExists": false
+
      },
        },
+
            {
        {
+
        "svKey": "3",
            "Key": 2621,
+
        "code": "698",
            "Description": "",
+
        "subCode1": "46200",
            "Priority": 3,
+
        "subCode2": "1",
            "Name": "USA_Houses_Skyscrapers_Evening_Manhattan_New_York_562768_2560x1440.jpg",
+
        "name": "HOTEL::Вена/Graben-1*,5 ночей/DBL(Standart ),2Ad/FB Полный пансион"
            "HotelKey": 178,
+
      },
            "InfoExists": false
+
            {
        },
+
        "svKey": "1",
        {
+
        "code": "1087",
            "Key": 2622,
+
        "subCode1": "147",
            "Description": "",
+
        "subCode2": "1",
            "Priority": 4,
+
        "name": "А_П::Москва/Вена/SU2352, SVO-VIE, 16:20-17:05/NSU Экономический класс"
            "Name": "Winter_Mountains_Forests_Slovakia_Tatra_mountains_555815_6000x4000.jpg",
+
      }
            "HotelKey": 178,
+
  ],
            "InfoExists": false
+
  "touristInfo":   {
        }
+
      "lastname": "Ivanov",
    ],
+
      "firstname": "Ivan",
    "Country": "Австрия",
+
      "surname": "Ivanovich",
    "City": "Вена",
+
      "address": "123456, г. Москва, ул. Ленина, д. 1, кв. 15",
    "Name": "Ananas",
+
      "postcode": "123456",
    "HotelCategoryName": "5+++*",
+
      "city": "Москва",
    "Address": "Вена, Австрия",
+
      "street": "Ленина",
    "Phone": "(+43/1) 54620043",
+
      "home": "1",
    "Email": "",
+
      "roomNumber": "15"
    "Http": "https://www.booking.com/hotel/ru/dd1-2ddegd1-2ddegn.ru.html?aid=318615;label=New_Russian_RU_UK_21458017585-iiDMr3ISp%2AxxmWbPbGNx0QS99511367185%3Apl%3Ata%3Ap1%3Ap2%3Aac%3Aap%3Aneg%3Afi2132702086%3Atidsa-302962658775%3Alp9061012%3Ali%3Adec%3Adm;sid=fc5ecc",
+
  }
    "Description": "<p>Расположен на улице Рихте Вензел ВВВ93-95 (р-он №5). В отеле 537 номеров, отель имеет свой гараж, сауну, тренажерный зал, кабельное телевидение. В каждом номере: телевизор, телефон, душ, туалет.</p>",
 
    "InfrastructureHotel": "<p>Ифраструктура отеля</p>",
 
    "RecreationSport": "<p>Развлечение и спорт</p>",
 
    "Beach": "<p>Ифраструктура отеля</p>",
 
    "Healing": "<p>Лечение</p>",
 
    "Excursion": "<p>Экскурсии</p>",
 
    "AdditionalService": "<p>Дополнительные услуги</p>",
 
    "ForChildren": "<p>Для детей</p>",
 
    "AddCost": "<p>Доплата</p>",
 
    "CheckoutTimeFrom": "12:00",
 
    "CheckoutTimeTo": "14:30",
 
    "Latitude": "12.788397°",
 
    "Longitude": "36.348986°"
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 8311: Строка 8973:
 
</div></div><br />
 
</div></div><br />
  
===Выгрузка картинки по туру (TourImages) начиная с релиза 15.7===
+
===Список значений параметра гражданства (Citizenships)===
Метод выгружает картинки по туру.
+
Метод служит для получения списка значений параметра гражданства.
 
* Формат запроса:
 
* Формат запроса:
** GET .../TourSearchOwin/TourImages?
+
** GET .../TourSearchOwin/Citizenships?
 
* Принимаемые параметры ( * – обязательный):
 
* Принимаемые параметры ( * – обязательный):
** '''tourKeys *''' – ключ тура (можно передать несколько ключей тура, каждый раз указывая параметр ''tourKeys'')
+
** '''pageSize *''' – размер выдачи
 
+
** '''pageNumber *''' – порядковый номер страницы выдачи
 +
** '''term *''' – подстрочный фильтр для отбора (пустой по умолчанию)
 
* Возвращаемый результат:
 
* Возвращаемый результат:
** '''Images''' – объект картинок
+
** '''Key''' – ключ страны
*** '''Key''' – ключ картинки
+
** '''Name''' – название гражданства
*** '''Description''' – описание картинки
 
*** '''Priority''' – приоритет
 
*** '''Name''' – название файла
 
*** '''TourKey''' – ключ тура
 
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода TourImages
+
Вызов метода Citizenships
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/TourImages?tourKey=100001132
+
http://localhost:9000/TourSearchOwin/Citizenships?pageSize=50&pageNumber=1&term=
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода TourImages (в формате JSON)
+
Возвращаемый результат метода Citizenships (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
     "Images": [
+
     {
         {
+
         "Key": 90,
            "Key": 52,
+
        "Name": "Австрия"
            "Description": "Московский планетарий",
+
    },
            "Priority": 1,
+
    {
            "Name": "Планетарий.jpg",
+
        "Key": 222,
            "TourKey": 100001132
+
        "Name": "Англия"
        },
+
    },
        {
+
    {
            "Key": 51,
+
        "Key": 376,
            "Description": "Виз из космоса",
+
        "Name": "Андорра"
            "Priority": 2,
+
    },
            "Name": "Вид из космоса.jpg",
+
    {
            "TourKey": 100001132
+
        "Key": 375,
         }
+
        "Name": "Беларусь"
     ]
+
    },
 +
    {
 +
        "Key": 3,
 +
         "Name": "Бельгия"
 +
     }
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 8357: Строка 9020:
 
</div></div><br />
 
</div></div><br />
  
===Регистрация частного лица (PersonalRegistration)===
+
===Выгрузка постоянного клиента (Client)===
Метод производит регистрацию частного лица.
+
Метод выгружает постоянного клиента при авторизации частного лица.
 
* Формат запроса:
 
* Формат запроса:
** GET .../TourSearchOwin/PersonalRegistration?
+
** GET .../TourSearchOwin/Client?
 
* Принимаемые параметры ( * – обязательный):
 
* Принимаемые параметры ( * – обязательный):
** '''name *''' – имя
+
** '''clientId *''' – Id постоянного клиента
** '''surname *''' – фамилия
 
** '''phone *''' – телефон
 
** '''login *''' – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка e-mail (CheckMail)|CheckMail]]
 
** '''password *''' – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
 
** '''citizen *''' – гражданство (возможна передача пустого значения)
 
** '''country *''' – страна (возможна передача пустого значения)
 
** '''city *''' – город (возможна передача пустого значения)
 
** '''address *''' – адрес (возможна передача пустого значения)
 
** '''comment *''' – комментарий (возможна передача пустого значения)
 
** '''captchaText *''' – текст капчи. Предварительно нужно вызывать метод получения капчи [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Получение капчи (GetCaptcha)|GetCaptcha]]
 
** '''sessionId *''' – Id сессии (возможна передача произвольного значения)
 
 
 
 
* Возвращаемый результат:
 
* Возвращаемый результат:
** '''SxotpFhg''' – сформированный (при упрощенной регистрации) или заданный пользователем пароль
+
** '''$id''' – внутренний порядковый идентификатор
 
+
** '''CL_KEY''' – ключ справочника постоянные клиенты
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
** '''CL_OPERUPDATE''' – ключ менеджера, который последний обновил постоянного клиента
<div class="mw-collapsible-content">
+
** '''CL_OPERUPDATE''' – дата обновления постоянного клиента
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
** '''CL_PFKEY''' – внутренний ключ
Вызов метода PersonalRegistration
+
** '''CL_NAMERUS''' – имя (на русском)
<syntaxhighlight lang="java" enclose="div">
+
** '''CL_NAMELAT''' – имя (на латинице)
http://localhost:9000/TourSearchOwin/PersonalRegistration?name=Иван&surname=Иванов&phone=+79991234568&login=test1222@mail.ru
+
** '''CL_SHORTNAME''' – инициалы
&citizen=&country=&city=&address=&comment=&captchaText=v7jnj&sessionId=43angzdfbc5h2wud1lp1301j
+
** '''CL_SEX''' – пол
</syntaxhighlight>
+
** '''CL_FNAMERUS''' – фамилия (на русском)
Возвращаемый результат метода PersonalRegistration (в формате JSON)
+
** '''CL_FNAMELAT''' – фамилия (на латинице)
<syntaxhighlight lang="java" enclose="div">
+
** '''CL_SNAMERUS''' – отчество (на русском)
{
+
** '''CL_SNAMELAT''' – отчество (на латинице)
"SxotpFhg"
+
** '''CL_BIRTHDAY''' – дата рождения
}
+
** '''CL_BIRTHCOUNTRY''' – страна рождения
</syntaxhighlight>
+
** '''CL_BIRTHCITY''' – место рождения (город)
</TD></TR></TABLE>
+
** '''CL_CITIZEN''' – гражданство
</div></div><br />
+
** '''CL_ADDRESS''' – полный адрес
 
+
** '''CL_POSTINDEX''' – почтовый индекс
===Выгрузка плана рассадки (TransportPlan)===
+
** '''CL_POSTCITY''' – город
Метод выгружает план рассадки транспортного средства.
+
** '''CL_POSTSTREET''' – улица
* Формат запроса:
+
** '''CL_POSTBILD''' – дом
** GET .../TourSearchOwin/TransportPlan?
+
** '''CL_POSTFLAT''' – квартира
* Принимаемые параметры ( * – обязательный):
+
** '''CL_PHONE''' – телефон
** '''code *''' – код услуги
+
** '''CL_PASPORTSER''' – серия загранпаспорта
** '''dateBegin *''' – дата начала услуги
+
** '''CL_PASPORTNUM''' – номер загранпаспорта
** '''serviceType *''' – класс услуги
+
** '''CL_PASPORTDATE''' – дата выдачи загранпаспорта
** '''transportKey *''' – ключ транспорта
+
** '''CL_PASPORTDATEEND''' – срок действия загранпаспорта
 
+
** '''CL_PASPORTBYWHOM''' кем выдан загранпаспорт
* Возвращаемый результат:
+
** '''CL_PASPRUSER''' – серия общегражданского паспорта
** '''TransportKey''' – ключ транспорта
+
** '''CL_PASPRUNUM''' – номер общегражданского паспорта
** '''Title''' – название
+
** '''CL_PASPRUDATE''' – дата выдачи общегражданского паспорта
** '''AreasCount''' – количество зон (уровней)
+
** '''CL_PASPRUBYWHOM''' – кем выдан общегражданский паспорт
** '''RowsCount''' – количество рядов
+
** '''CL_ISMARK''' – профессия
** '''ColumnsCount''' – количество колонок
+
** '''CL_TYPE''' – примечания
** '''BusySeats''' – информация о занятых местах
+
** '''CL_IMPRESSNOTE''' – общие впечатления
** '''Cells''' – блок не заполняется
+
** '''CL_NOTE''' – особые отметки
*** '''Row''' – ряд
+
** '''CL_REMARK''' – примечания
*** '''Column''' – колонка
+
** '''CL_IMPRESSKEY''' – ключ выбранного впечатления
*** '''Area''' – уровень
+
** '''CL_TITLE1''' – служебные отметки, заголовок 1
*** '''Type''' – тип места (1 - свободно, 5 - занято)
+
** '''CL_TITLE2''' – служебные отметки, заголовок 2
*** '''Name''' – номер места
+
** '''CL_TITLE3''' – служебные отметки, заголовок 3
** '''UserSeats''' – блок не заполняется
+
** '''CL_TITLE4''' – служебные отметки, заголовок 4
** '''BlockSeat''' – блок не заполняется
+
** '''CL_FUTURE''' – пожелания
 +
** '''CL_LASTSTAT''' – информация о статистике
 +
** '''CL_SUMMA''' – сумма по клиенту
 +
** '''CL_NMENWITH''' – число спутников
 +
** '''CL_SUMDOGOVOR''' – сумма по путевкам
 +
** '''CL_NTRIP''' – число поездок
 +
** '''ROWID''' – внутренний идентификатор
 +
** '''cl_fax''' – факс
 +
** '''cl_mail:''' – e-mail
 +
** '''CL_MINCOST''' – минимальная стоимость поездки
 +
** '''CL_MAXCOST''' – максимальная стоимость поездки
 +
** '''CL_RealSex''' – пол
 +
** '''CL_EnableSmsNotifications''' – признак согласен получать sms-уведомление
 +
** '''CL_CHECKED''' – оповещения
 +
** '''CL_Creator''' – создатель постоянного клиента
 +
** '''CL_CreateDate''' – дата создания постоянного клиента
 +
** '''CL_Login''' – логин
 +
** '''CL_Password''' – пароль
 +
** '''CL_IsOnlineUser''' – является ли постоянный клиент онлайн пользователем
 +
** '''CL_CitizenID''' – ID гражданства
 +
** '''CARDS''' – информация о дисконтной карте
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода TransportPlan
+
Вызов метода Client
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/TransportPlan?code=1527&dateBegin=07.03.2021&serviceType=14&transportKey=31
+
http://localhost:9000/TourSearchOwin/Client?clientId=7314
&citizen=&country=&city=&address=&comment=&captchaText=v7jnj&sessionId=43angzdfbc5h2wud1lp1301j
 
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода TransportPlan (в формате JSON)
+
Возвращаемый результат метода Client (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
     "TransportKey": 31,
+
     "$id": "1",
     "Title": "",
+
    "CL_KEY": 7314,
     "AreasCount": 1,
+
    "CL_OPERUPDATE": 106,
     "RowsCount": 10,
+
    "CL_DATEUPDATE": "2021-01-21T11:56:41.287",
     "ColumnsCount": 2,
+
    "CL_PFKEY": 2,
     "BusySeats": [],
+
    "CL_NAMERUS": "Test888",
     "Cells": [
+
    "CL_NAMELAT": "Test888",
        {
+
    "CL_SHORTNAME": "T.",
            "Row": 4,
+
    "CL_SEX": 0,
            "Column": 0,
+
     "CL_FNAMERUS": "Test888",
            "Area": 0,
+
     "CL_FNAMELAT": "Test888",
            "Type": 1,
+
    "CL_SNAMERUS": "",
            "Name": "9"
+
    "CL_SNAMELAT": "",
        },
+
    "CL_BIRTHDAY": null,
        {
+
    "CL_BIRTHCOUNTRY": "",
            "Row": 4,
+
    "CL_BIRTHCITY": "",
            "Column": 1,
+
    "CL_CITIZEN": "Spain",
            "Area": 0,
+
    "CL_ADDRESS": ", г., ул., д., кв.",
            "Type": 1,
+
    "CL_POSTINDEX": "",
            "Name": "10"
+
    "CL_POSTCITY": "",
        },
+
    "CL_POSTSTREET": "",
        {
+
    "CL_POSTBILD": "",
            "Row": 1,
+
    "CL_POSTFLAT": "",
            "Column": 0,
+
    "CL_PHONE": "65465465",
            "Area": 0,
+
    "CL_PASPORTSER": "",
            "Type": 5,
+
    "CL_PASPORTNUM": "",
            "Name": "3"
+
    "CL_PASPORTDATE": null,
        },
+
    "CL_PASPORTDATEEND": null,
        {
+
    "CL_PASPORTBYWHOM": "",
            "Row": 1,
+
    "CL_PASPRUSER": "",
            "Column": 1,
+
    "CL_PASPRUNUM": "",
            "Area": 0,
+
     "CL_PASPRUDATE": null,
             "Type": 5,
+
     "CL_PASPRUBYWHOM": "",
             "Name": "4"
+
     "CL_ISMARK": 7,
 +
     "CL_TYPE": 6,
 +
    "CL_IMPRESSNOTE": "7",
 +
    "CL_NOTE": "5",
 +
    "CL_REMARK": "6",
 +
    "CL_IMPRESSKEY": 3,
 +
    "CL_TITLE1": "1",
 +
    "CL_TITLE2": "2",
 +
    "CL_TITLE3": "3",
 +
    "CL_TITLE4": "4",
 +
    "CL_FUTURE": "8",
 +
    "CL_LASTSTAT": null,
 +
    "CL_SUMMA": null,
 +
    "CL_NMENWITH": null,
 +
    "CL_SUMDOGOVOR": null,
 +
    "CL_NTRIP": null,
 +
    "ROWID": "AAAAAAJBNbw=",
 +
    "cl_fax": "",
 +
    "cl_mail": "test888@mail.ru",
 +
    "CL_MINCOST": null,
 +
    "CL_MAXCOST": null,
 +
    "CL_RealSex": 0,
 +
    "CL_EnableSmsNotifications": 0,
 +
    "CL_CHECKED": false,
 +
    "CL_Creator": 106,
 +
    "CL_CreateDate": "2018-03-06T14:10:27.687",
 +
    "CL_Login": "test888@mail.ru",
 +
    "CL_Password": "/wjpKpaXhmuTtSaG6xIUtQ==",
 +
    "CL_IsOnlineUser": true,
 +
    "CL_CitizenID": "",
 +
    "CARDS": []
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка описаний ценовых блоков (CostOfferDescriptions)===
 +
Метод выгружает описания ценовых блоков.
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/CostOfferDescriptions?
 +
* Принимаемые параметры ( * – обязательный):
 +
** '''COKeysString *''' – ключи ценовых блоков
 +
* Возвращаемый результат:
 +
** '''IdCostOffer''' – Id ценового блока
 +
** '''InfoText''' – описание ценового блока
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода CostOfferDescriptions
 +
<syntaxhighlight lang="java" enclose="div">
 +
http://localhost:9000/TourSearchOwin/CostOfferDescriptions?COKeysString=16834,16828
 +
</syntaxhighlight>
 +
Возвращаемый результат метода CostOfferDescriptions (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
    "costOffersImageInformation": [
 +
        {
 +
             "IdCostOffer": 16834,
 +
             "InfoText": "Информация для онлайна 2"
 
         },
 
         },
 
         {
 
         {
             "Row": 8,
+
             "IdCostOffer": 16828,
             "Column": 0,
+
             "InfoText": "Информация для онлайна"
            "Area": 0,
 
            "Type": 1,
 
            "Name": "17"
 
 
         },
 
         },
        {
+
    ]
            "Row": 8,
+
}
            "Column": 1,
+
</syntaxhighlight>
            "Area": 0,
+
</TD></TR></TABLE>
            "Type": 1,
+
</div></div><br />
            "Name": "18"
+
 
        },
+
===Выгрузка описания по стране (CountryInfo)===
        {
+
Метод выгружает описание по стране.
            "Row": 5,
+
* Формат запроса:
            "Column": 0,
+
** GET .../TourSearchOwin/CountryInfo?
            "Area": 0,
+
* Принимаемые параметры ( * – обязательный):
            "Type": 1,
+
** '''countryKey *''' – ключ страны
            "Name": "11"
+
* Возвращаемый результат:
        },
+
** '''информация по выбранной стране'''
        {
+
 
            "Row": 5,
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
            "Column": 1,
+
<div class="mw-collapsible-content">
            "Area": 0,
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
            "Type": 1,
+
Вызов метода CountryInfo
            "Name": "12"
+
<syntaxhighlight lang="java" enclose="div">
        },
+
http://localhost:9000/TourSearchOwin/CountryInfo?countryKey=90
        {
+
</syntaxhighlight>
            "Row": 2,
+
Возвращаемый результат метода CountryInfo (в формате JSON)
            "Column": 0,
+
<syntaxhighlight lang="java" enclose="div">
            "Area": 0,
+
{
            "Type": 1,
+
"<p>Информация о стране</p>\n"
            "Name": "5"
+
}
        },
+
</syntaxhighlight>
        {
+
</TD></TR></TABLE>
            "Row": 2,
+
</div></div><br />
            "Column": 1,
+
 
            "Area": 0,
+
===Выгрузка картинки по отелю (HotelImages)===
            "Type": 1,
+
Метод выгружает картинку по отелю.
            "Name": "6"
+
* Формат запроса:
        },
+
** GET .../TourSearchOwin/HotelImages?
        {
+
* Принимаемые параметры ( * – обязательный):
            "Row": 9,
+
** '''hotelKeys *''' – ключ отеля (можно передать несколько ключей отеля, каждый раз указывая параметр ''hotelKeys''), в этом случае возвращается информация о главном фото отеля
            "Column": 0,
+
* либо
            "Area": 0,
+
** '''hotelKey *''' – либо ключ отеля, в этом случае возвращается полная информация о всех фотографиях в отеле
            "Type": 1,
+
* Возвращаемый результат (если передан ''hotelKeys''):
            "Name": "19"
+
** '''Name''' – название файла
        },
+
** '''HotelKey''' – ключ отеля
        {
+
** '''InfoExists''' – есть ли информация
            "Row": 9,
+
** '''ImagesCount''' – общее количество картинок по отелю
            "Column": 1,
+
* либо (если передан ''hotelKey'')
            "Area": 0,
+
** '''Images''' – объект картинок
            "Type": 1,
+
*** '''Key''' – ключ картинки
            "Name": "20"
+
*** '''Description''' – описание картинки
        },
+
*** '''Priority''' – приоритет
        {
+
*** '''Name''' – название файла
            "Row": 6,
+
*** '''HotelKey''' – ключ отеля
            "Column": 0,
+
*** '''InfoExists''' – есть ли информация
            "Area": 0,
+
** '''Country''' – страна отеля
            "Type": 1,
+
** '''City''' – город отеля
            "Name": "13"
+
** '''Name''' – название отеля
        },
+
** '''HotelCategoryName''' – категория отеля
        {
+
** '''Address''' – адрес отеля
            "Row": 6,
+
** '''Phone''' – телефон
            "Column": 1,
+
** '''Email''' – e-mail
            "Area": 0,
+
** '''Http''' – адрес сайта
            "Type": 1,
+
** '''Description''' – описание отеля
            "Name": "14"
+
** '''InfrastructureHotel''' – инфраструктура отеля
        },
+
** '''RecreationSport''' – развлечения и спорт
        {
+
** '''Beach''' – информация о пляже
            "Row": 3,
+
** '''Healing''' – лечение
            "Column": 0,
+
** '''Excursion''' – экскурсии
            "Area": 0,
+
** '''AdditionalService''' – дополнительные услуги
            "Type": 1,
+
** '''ForChildren''' – для детей
            "Name": "7"
+
** '''AddCost''' – доплаты
        },
+
** '''CheckoutTimeFrom''' – заезд в отель
        {
+
** '''CheckoutTimeTo''' – выезд из отеля
            "Row": 3,
+
** '''Latitude''' – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
            "Column": 1,
+
** '''Longitude''' – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
            "Area": 0,
 
            "Type": 1,
 
            "Name": "8"
 
        },
 
        {
 
            "Row": 0,
 
            "Column": 0,
 
            "Area": 0,
 
            "Type": 1,
 
            "Name": "1"
 
        },
 
        {
 
            "Row": 0,
 
            "Column": 1,
 
            "Area": 0,
 
            "Type": 1,
 
            "Name": "2"
 
        },
 
        {
 
            "Row": 7,
 
            "Column": 0,
 
            "Area": 0,
 
            "Type": 1,
 
            "Name": "15"
 
        },
 
        {
 
            "Row": 7,
 
            "Column": 1,
 
            "Area": 0,
 
            "Type": 1,
 
            "Name": "16"
 
        }
 
    ],
 
    "UserSeats": {},
 
    "BlockSeat": {}
 
}
 
</syntaxhighlight>
 
</TD></TR></TABLE>
 
</div></div><br />
 
  
===Выгрузка списка всех стран (Countries)===
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример краткой информации отеля
Метод производит выгрузку всех стран (используется для регистрации частного лица).
 
* Формат запроса:
 
** GET .../TourSearchOwin/Countries?
 
* Принимаемые параметры ( * – обязательный):
 
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
 
 
* Возвращаемый результат:
 
** '''Key''' – ключ страны
 
** '''Name''' – название
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода Countries
+
Вызов метода HotelImages
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/Countries?term=
+
http://localhost:9000/TourSearchOwin/HotelImages?hotelKeys=8660&hotelKeys=178
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода Countries (в формате JSON)
+
Возвращаемый результат метода HotelImages (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
[
 
     {
 
     {
         "Key": 6283,
+
         "Name": "Dubai_Emirates_UAE_Skyscrapers_Megapolis_From_564495_2560x1599.jpg",
         "Name": " Азербайджан"
+
         "HotelKey": 8660,
 +
        "InfoExists": true
 
     },
 
     },
 
     {
 
     {
        "Key": 90,
+
         "Name": "Spain_Resorts_Houses_Tenerife_Canary_Islands_Pools_527022_1280x853.jpg",
         "Name": "Австрия"
+
         "HotelKey": 178,
    },
+
         "InfoExists": true
    {
+
     }
         "Key": 222,
+
]
         "Name": "Англия"
+
</syntaxhighlight>
     },
+
</TD></TR></TABLE>
    {
+
</div></div><br />
        "Key": 376,
+
 
        "Name": "Андорра"
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример детальной информации отеля
    },
+
<div class="mw-collapsible-content">
    {
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
        "Key": 375,
+
Вызов метода HotelImages
        "Name": "Беларусь"
+
<syntaxhighlight lang="java" enclose="div">
    },
+
http://localhost:9000/TourSearchOwin/HotelImages?hotelKey=178
    {
+
</syntaxhighlight>
        "Key": 6305,
+
Возвращаемый результат метода HotelImages (в формате JSON)
        "Name": "Бельгия"
+
<syntaxhighlight lang="java" enclose="div">
    },
+
{
    {
+
     "Images": [
        "Key": 359,
+
        {
        "Name": "Болгария"
+
            "Key": 2619,
    },
+
            "Description": "",
    {
+
            "Priority": 1,
        "Key": 6235,
+
            "Name": "Spain_Resorts_Houses_Tenerife_Canary_Islands_Pools_527022_1280x853.jpg",
        "Name": "Вьетнам"
+
            "HotelKey": 178,
     },
+
            "InfoExists": false
    {
+
        },
        "Key": 40,
+
        {
        "Name": "Германия"
+
            "Key": 2620,
    },
+
            "Description": "",
    {
+
            "Priority": 2,
        "Key": 1,
+
            "Name": "stock-photo-luxury-bedrooms-with-flare-light-559774297.jpg",
        "Name": "Голландия"
+
            "HotelKey": 178,
    },
+
            "InfoExists": false
    {
+
        },
        "Key": 852,
+
        {
        "Name": "Гонконг"
+
            "Key": 2621,
    },
+
            "Description": "",
    {
+
            "Priority": 3,
        "Key": 29,
+
            "Name": "USA_Houses_Skyscrapers_Evening_Manhattan_New_York_562768_2560x1440.jpg",
        "Name": "Греция"
+
            "HotelKey": 178,
    },
+
            "InfoExists": false
    {
+
        },
        "Key": 6251,
+
        {
        "Name": "Грузия"
+
            "Key": 2622,
    },
+
            "Description": "",
    {
+
            "Priority": 4,
        "Key": 6224,
+
            "Name": "Winter_Mountains_Forests_Slovakia_Tatra_mountains_555815_6000x4000.jpg",
        "Name": "Дания"
+
            "HotelKey": 178,
    },
+
            "InfoExists": false
    {
+
        }
        "Key": 6245,
+
     ],
        "Name": "Доминиканская Республика"
+
    "Country": "Австрия",
    },
+
     "City": "Вена",
    {
+
    "Name": "Ananas",
        "Key": 9,
+
     "HotelCategoryName": "5+++*",
        "Name": "Египет"
+
    "Address": "Вена, Австрия",
    },
+
     "Phone": "(+43/1) 54620043",
    {
+
    "Email": "",
        "Key": 729,
+
     "Http": "https://www.booking.com/hotel/ru/dd1-2ddegd1-2ddegn.ru.html?aid=318615;label=New_Russian_RU_UK_21458017585-iiDMr3ISp%2AxxmWbPbGNx0QS99511367185%3Apl%3Ata%3Ap1%3Ap2%3Aac%3Aap%3Aneg%3Afi2132702086%3Atidsa-302962658775%3Alp9061012%3Ali%3Adec%3Adm;sid=fc5ecc",
        "Name": "Израиль"
+
    "Description": "<p>Расположен на улице Рихте Вензел ВВВ93-95 (р-он №5). В отеле 537 номеров, отель имеет свой гараж, сауну, тренажерный зал, кабельное телевидение. В каждом номере: телевизор, телефон, душ, туалет.</p>",
    },
+
     "InfrastructureHotel": "<p>Ифраструктура отеля</p>",
    {
+
    "RecreationSport": "<p>Развлечение и спорт</p>",
        "Key": 26,
+
     "Beach": "<p>Ифраструктура отеля</p>",
        "Name": "Индия"
+
    "Healing": "<p>Лечение</p>",
    },
+
     "Excursion": "<p>Экскурсии</p>",
    {
+
     "AdditionalService": "<p>Дополнительные услуги</p>",
        "Key": 6221,
+
    "ForChildren": "<p>Для детей</p>",
        "Name": "Индонезия"
+
     "AddCost": "<p>Доплата</p>",
    },
+
    "CheckoutTimeFrom": "12:00",
     {
+
     "CheckoutTimeTo": "14:30",
        "Key": 6244,
+
    "Latitude": "12.788397°",
        "Name": "Иордания"
+
     "Longitude": "36.348986°"
    },
+
}
     {
+
</syntaxhighlight>
        "Key": 6288,
+
</TD></TR></TABLE>
        "Name": "Ирландия"
+
</div></div><br />
    },
+
 
     {
+
====Отображение картинки в браузере (GetImage)====
        "Key": 84,
+
Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка картинки по отелю (HotelImages)|HotelImages]].
        "Name": "Испания"
+
* Формат запроса:
    },
+
** http://localhost/Canary/Image/GetImage?
     {
+
 
        "Key": 80,
+
* Принимаемые параметры ( * – обязательный):
        "Name": "Италия"
+
** '''code *''' – ключ отеля
    },
+
** '''type *''' – размер картинки (возможные значения: ''small1'', ''small160x90'', ''medium'', ''big'')
     {
+
** '''name *''' – название файла (берется из метода [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка картинки по отелю (HotelImages)|HotelImages]])
        "Key": 3272,
+
** '''imageType *''' – тип картинки (возможные значения: ''hotels'', ''tours'')
        "Name": "Казахстан"
+
 
    },
+
* Возвращаемый результат:
    {
+
** изображение картинки отеля
        "Key": 6240,
+
 
        "Name": "Камбоджа"
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример картинки отеля
    },
+
<div class="mw-collapsible-content">
     {
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
        "Key": 10,
+
Вызов метода GetImage
        "Name": "Кипр"
+
<syntaxhighlight lang="java" enclose="div">
     },
+
http://localhost/Canary/Image/GetImage?code=134049&type=small160x90&name=PalaceResort.webp&imageType=hotels
    {
+
 
        "Key": 6237,
+
</syntaxhighlight>
        "Name": "Китай"
+
Возвращаемый результат метода GetImage и виде картинки
    },
+
</TD></TR></TABLE>
     {
+
</div></div><br />
        "Key": 6254,
+
 
        "Name": "Круизы"
+
===Выгрузка картинки по туру (TourImages)===
    },
+
Метод выгружает картинки по туру.
     {
+
* Формат запроса:
        "Key": 6243,
+
** GET .../TourSearchOwin/TourImages?
        "Name": "Куба"
+
* Принимаемые параметры ( * – обязательный):
    },
+
** '''tourKeys *''' – ключ тура (можно передать несколько ключей тура, каждый раз указывая параметр ''tourKeys'')
     {
+
 
        "Key": 6241,
+
* Возвращаемый результат:
        "Name": "Лаос"
+
** '''Images''' – объект картинок
    },
+
*** '''Key''' – ключ картинки
     {
+
*** '''Description''' – описание картинки
        "Key": 6261,
+
*** '''Priority''' – приоритет
        "Name": "Маврикий"
+
*** '''Name''' – название файла
    },
+
*** '''TourKey''' – ключ тура
     {
+
 
        "Key": 603,
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
        "Name": "Малайзия"
+
<div class="mw-collapsible-content">
    },
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
    {
+
Вызов метода TourImages
        "Key": 960,
+
<syntaxhighlight lang="java" enclose="div">
        "Name": "Мальдивы"
+
http://localhost:9000/TourSearchOwin/TourImages?tourKey=100001132
    },
+
</syntaxhighlight>
    {
+
Возвращаемый результат метода TourImages (в формате JSON)
        "Key": 535,
+
<syntaxhighlight lang="java" enclose="div">
        "Name": "Мальта"
+
{
    },
+
    "Images": [
    {
+
         {
        "Key": 77,
+
            "Key": 52,
        "Name": "Мексика"
+
            "Description": "Московский планетарий",
    },
+
            "Priority": 1,
    {
+
            "Name": "Планетарий.jpg",
        "Key": 6252,
+
            "TourKey": 100001132
        "Name": "Молдавия"
+
        },
    },
+
        {
    {
+
            "Key": 51,
        "Key": 6242,
+
            "Description": "Вид из космоса",
        "Name": "Мьянма"
+
            "Priority": 2,
    },
+
            "Name": "Вид из космоса.jpg",
    {
+
            "TourKey": 100001132
        "Key": 6249,
+
         }
        "Name": "Непал"
+
     ]
    },
+
}
    {
+
</syntaxhighlight>
        "Key": 6222,
+
</TD></TR></TABLE>
        "Name": "Норвегия"
+
</div></div><br />
    },
+
 
    {
+
====Отображение картинки в браузере (GetImage)====
        "Key": 2,
+
Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка картинки по туру (TourImages)|TourImages]].
        "Name": "ОАЭ"
+
* Формат запроса:
    },
+
** http://localhost/Canary/Image/GetImage?
    {
+
 
        "Key": 6275,
+
* Принимаемые параметры ( * – обязательный):
        "Name": "Оман"
+
** '''code *''' – ключ тура
    },
+
** '''type *''' – размер картинки (возможные значения: ''small1'', ''small160x90'', ''medium'', ''big'')
    {
+
** '''name *''' – название файла (берется из метода [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка картинки по туру (TourImages)|TourImages]])
        "Key": 6246,
+
** '''imageType *''' – тип картинки (возможные значения: ''hotels'', ''tours'')
        "Name": "Польша"
+
 
    },
+
* Возвращаемый результат:
    {
+
** изображение картинки отеля
        "Key": 22,
+
 
        "Name": "Португалия"
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример картинки отеля
    },
+
<div class="mw-collapsible-content">
    {
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
        "Key": 460,
+
Вызов метода GetImage
        "Name": "Россия"
+
<syntaxhighlight lang="java" enclose="div">
    },
+
http://localhost/Canary/Image/GetImage?code=005485049&type=small160x90&name=TheBestTour.webp&imageType=tours
    {
+
</syntaxhighlight>
        "Key": 6265,
+
Возвращаемый результат метода GetImage и виде картинки
        "Name": "Сейшелы"
+
</TD></TR></TABLE>
    },
+
</div></div><br />
    {
+
 
        "Key": 6309,
+
===Регистрация частного лица (PersonalRegistration)===
        "Name": "Сербия"
+
Метод производит регистрацию частного лица.
    },
+
* Формат запроса:
    {
+
** GET .../TourSearchOwin/PersonalRegistration?
        "Key": 665,
+
* Принимаемые параметры ( * – обязательный):
        "Name": "Сингапур"
+
** '''name *''' – имя
    },
+
** '''surname *''' – фамилия
    {
+
** '''phone *''' – телефон
        "Key": 6274,
+
** '''login *''' – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка e-mail (CheckMail)|CheckMail]]
        "Name": "Словения"
+
** '''password *''' – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
    },
+
** '''citizen *''' – гражданство (возможна передача пустого значения)
    {
+
** '''country *''' – страна (возможна передача пустого значения)
        "Key": 7,
+
** '''city *''' – город (возможна передача пустого значения)
        "Name": "США"
+
** '''address *''' – адрес (возможна передача пустого значения)
    },
+
** '''comment *''' – комментарий (возможна передача пустого значения)
    {
+
** '''captchaText *''' – текст капчи. Предварительно нужно вызывать метод получения капчи [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Получение капчи (GetCaptcha)|GetCaptcha]]. Полученный ''FileContents'' преобразовать с помощью json в картинку, текст из которой вставить как значение ''captchaText''.
        "Key": 6253,
+
** '''sessionId *''' – Id сессии (возможна передача произвольного значения)
        "Name": "Таджикистан"
+
 
    },
+
* Возвращаемый результат:
    {
+
** '''SxotpFhg''' – сформированный (при упрощенной регистрации) или заданный пользователем пароль
        "Key": 6236,
+
 
        "Name": "Тайвань"
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
    },
+
<div class="mw-collapsible-content">
    {
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
        "Key": 53,
+
Вызов метода PersonalRegistration
        "Name": "Тайланд"
+
<syntaxhighlight lang="java" enclose="div">
    },
+
http://localhost:9000/TourSearchOwin/PersonalRegistration?name=Иван&surname=Иванов&phone=+79991234568&login=test1222@mail.ru
    {
+
&citizen=&country=&city=&address=&comment=&captchaText=v7jnj&sessionId=43angzdfbc5h2wud1lp1301j
        "Key": 6313,
+
</syntaxhighlight>
         "Name": "Танзания"
+
Возвращаемый результат метода PersonalRegistration (в формате JSON)
    },
+
<syntaxhighlight lang="java" enclose="div">
    {
+
{
        "Key": 97,
+
"SxotpFhg"
        "Name": "Тунис"
+
}
    },
+
</syntaxhighlight>
    {
+
</TD></TR></TABLE>
        "Key": 86,
+
</div></div><br />
        "Name": "Турция"
+
 
    },
+
===Выгрузка плана рассадки (TransportPlan)===
    {
+
Метод выгружает план рассадки транспортного средства.
        "Key": 5,
+
* Формат запроса:
        "Name": "Украина"
+
** GET .../TourSearchOwin/TransportPlan?
    },
+
* Принимаемые параметры ( * – обязательный):
    {
+
** '''code *''' – код услуги
        "Key": 6250,
+
** '''dateBegin *''' – дата начала услуги
         "Name": "Филиппины"
+
** '''serviceType *''' – класс услуги
     },
+
** '''transportKey *''' – ключ транспорта
    {
+
 
        "Key": 64,
+
* Возвращаемый результат:
        "Name": "Финляндия"
+
** '''TransportKey''' – ключ транспорта
    },
+
** '''Title''' – название
    {
+
** '''AreasCount''' – количество зон (уровней)
        "Key": 30,
+
** '''RowsCount''' – количество рядов
        "Name": "Франция"
+
** '''ColumnsCount''' – количество колонок
    },
+
** '''BusySeats''' – информация о занятых местах
    {
+
** '''Cells''' – блок не заполняется
        "Key": 38,
+
*** '''Row''' – ряд
        "Name": "Хорватия"
+
*** '''Column''' – колонка
    },
+
*** '''Area''' – уровень
    {
+
*** '''Type''' – тип места (1 - свободно, 5 - занято)
        "Key": 6314,
+
*** '''Name''' – номер места
        "Name": "Черногория "
+
** '''UserSeats''' – блок не заполняется
    },
+
** '''BlockSeat''' – блок не заполняется
    {
+
 
        "Key": 15,
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
        "Name": "Чехия"
+
<div class="mw-collapsible-content">
    },
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
    {
+
Вызов метода TransportPlan
        "Key": 76,
+
<syntaxhighlight lang="java" enclose="div">
        "Name": "Швейцария"
+
http://localhost:9000/TourSearchOwin/TransportPlan?code=1527&dateBegin=07.03.2021&serviceType=14&transportKey=31
    },
+
&citizen=&country=&city=&address=&comment=&captchaText=v7jnj&sessionId=43angzdfbc5h2wud1lp1301j
    {
+
</syntaxhighlight>
        "Key": 6223,
+
Возвращаемый результат метода TransportPlan (в формате JSON)
        "Name": "Швеция"
+
<syntaxhighlight lang="java" enclose="div">
    },
+
{
    {
+
    "TransportKey": 31,
        "Key": 941,
+
    "Title": "",
        "Name": "Шри Ланка"
+
    "AreasCount": 1,
    },
+
    "RowsCount": 10,
    {
+
    "ColumnsCount": 2,
        "Key": 372,
+
    "BusySeats": [],
        "Name": "Эстония"
+
    "Cells": [
    },
+
        {
    {
+
            "Row": 4,
        "Key": 6247,
+
            "Column": 0,
        "Name": "Южная Корея"
+
            "Area": 0,
    },
+
            "Type": 1,
    {
+
            "Name": "9"
        "Key": 6248,
+
        },
        "Name": "Япония"
+
        {
    }
+
            "Row": 4,
]
+
            "Column": 1,
</syntaxhighlight>
+
            "Area": 0,
</TD></TR></TABLE>
+
            "Type": 1,
</div></div><br />
+
            "Name": "10"
 
+
        },
 
+
        {
===Выгрузка списка всех городов (Cities)===
+
            "Row": 1,
Метод производит выгрузку всех городов (используется для регистрации частного лица).
+
            "Column": 0,
* Формат запроса:
+
            "Area": 0,
** GET .../TourSearchOwin/Cities?
+
            "Type": 5,
* Принимаемые параметры ( * – обязательный):
+
            "Name": "3"
** '''countryKey *''' – ключ страны, по которой выгружать города (при значении ''-1'' выгружаются все города)
+
        },
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
+
        {
 
+
            "Row": 1,
* Возвращаемый результат:
+
            "Column": 1,
** '''Key''' – ключ города
+
            "Area": 0,
** '''Name''' – название
+
            "Type": 5,
 
+
            "Name": "4"
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
        },
<div class="mw-collapsible-content">
+
        {
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
            "Row": 8,
Вызов метода Cities
+
            "Column": 0,
<syntaxhighlight lang="java" enclose="div">
+
            "Area": 0,
http://localhost:9000/TourSearchOwin/Cities?countryKey=460&term=
+
            "Type": 1,
</syntaxhighlight>
+
            "Name": "17"
Возвращаемый результат метода Cities (в формате JSON)
+
        },
<syntaxhighlight lang="java" enclose="div">
+
        {
[
+
            "Row": 8,
    {
+
            "Column": 1,
        "Key": 1309,
+
            "Area": 0,
        "Name": "Алушта"
+
            "Type": 1,
    },
+
            "Name": "18"
    {
+
        },
        "Key": 564,
+
        {
        "Name": "Анапа"
+
            "Row": 5,
    },
+
            "Column": 0,
    {
+
            "Area": 0,
        "Key": 299,
+
            "Type": 1,
        "Name": "Архангельск"
+
            "Name": "11"
    },
+
        },
    {
+
        {
        "Key": 312,
+
            "Row": 5,
        "Name": "Астрахань"
+
            "Column": 1,
    },
+
            "Area": 0,
    {
+
            "Type": 1,
        "Key": 265,
+
            "Name": "12"
        "Name": "Белгород"
+
        },
    },
+
        {
    {
+
            "Row": 2,
        "Key": 329,
+
            "Column": 0,
        "Name": "Владивосток"
+
            "Area": 0,
    },
+
            "Type": 1,
    {
+
            "Name": "5"
        "Key": 258,
+
        },
        "Name": "Владикавказ"
+
        {
    },
+
            "Row": 2,
    {
+
            "Column": 1,
        "Key": 236,
+
            "Area": 0,
        "Name": "Владимир"
+
            "Type": 1,
    },
+
            "Name": "6"
    {
+
        },
        "Key": 358,
+
        {
        "Name": "Волгоград"
+
            "Row": 9,
    },
+
            "Column": 0,
    {
+
            "Area": 0,
        "Key": 1089,
+
            "Type": 1,
        "Name": "Воркута"
+
            "Name": "19"
    },
+
        },
     {
+
        {
         "Key": 1312,
+
            "Row": 9,
         "Name": "Воронеж"
+
            "Column": 1,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "20"
 +
        },
 +
        {
 +
            "Row": 6,
 +
            "Column": 0,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "13"
 +
        },
 +
        {
 +
            "Row": 6,
 +
            "Column": 1,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "14"
 +
        },
 +
        {
 +
            "Row": 3,
 +
            "Column": 0,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "7"
 +
        },
 +
        {
 +
            "Row": 3,
 +
            "Column": 1,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "8"
 +
        },
 +
        {
 +
            "Row": 0,
 +
            "Column": 0,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "1"
 +
        },
 +
        {
 +
            "Row": 0,
 +
            "Column": 1,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "2"
 +
        },
 +
        {
 +
            "Row": 7,
 +
            "Column": 0,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "15"
 +
        },
 +
        {
 +
            "Row": 7,
 +
            "Column": 1,
 +
            "Area": 0,
 +
            "Type": 1,
 +
            "Name": "16"
 +
        }
 +
    ],
 +
    "UserSeats": {},
 +
    "BlockSeat": {}
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка списка всех стран (Countries)===
 +
Метод производит выгрузку всех стран (используется для регистрации частного лица).
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/Countries?
 +
* Принимаемые параметры ( * – обязательный):
 +
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 +
 
 +
* Возвращаемый результат:
 +
** '''Key''' – ключ страны
 +
** '''Name''' – название
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода Countries
 +
<syntaxhighlight lang="java" enclose="div">
 +
http://localhost:9000/TourSearchOwin/Countries?term=
 +
</syntaxhighlight>
 +
Возвращаемый результат метода Countries (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
[
 +
     {
 +
         "Key": 6283,
 +
         "Name": " Азербайджан"
 
     },
 
     },
 
     {
 
     {
         "Key": 266,
+
         "Key": 90,
         "Name": "Екатеринбург"
+
         "Name": "Австрия"
 
     },
 
     },
 
     {
 
     {
         "Key": 254,
+
         "Key": 222,
         "Name": "Иваново"
+
         "Name": "Англия"
 
     },
 
     },
 
     {
 
     {
         "Key": 350,
+
         "Key": 376,
         "Name": "Иркутск"
+
         "Name": "Андорра"
 
     },
 
     },
 
     {
 
     {
         "Key": 238,
+
         "Key": 375,
         "Name": "Казань"
+
         "Name": "Беларусь"
 
     },
 
     },
 
     {
 
     {
         "Key": 306,
+
         "Key": 6305,
         "Name": "Калининград"
+
         "Name": "Бельгия"
 
     },
 
     },
 
     {
 
     {
         "Key": 1308,
+
         "Key": 359,
         "Name": "Коктебель"
+
         "Name": "Болгария"
 
     },
 
     },
 
     {
 
     {
         "Key": 313,
+
         "Key": 6235,
         "Name": "Краснодар"
+
         "Name": "Вьетнам"
 
     },
 
     },
 
     {
 
     {
         "Key": 269,
+
         "Key": 40,
         "Name": "Красноярск"
+
         "Name": "Германия"
    },
 
    {
 
        "Key": 1311,
 
        "Name": "Крым"
 
 
     },
 
     },
 
     {
 
     {
 
         "Key": 1,
 
         "Key": 1,
         "Name": "Москва"
+
         "Name": "Голландия"
 
     },
 
     },
 
     {
 
     {
         "Key": 259,
+
         "Key": 852,
         "Name": "Мурманск"
+
         "Name": "Гонконг"
 
     },
 
     },
 
     {
 
     {
         "Key": 234,
+
         "Key": 29,
         "Name": "Нижний Новгород"
+
         "Name": "Греция"
 
     },
 
     },
 
     {
 
     {
         "Key": 1097,
+
         "Key": 6251,
         "Name": "Новая Купавна"
+
         "Name": "Грузия"
 
     },
 
     },
 
     {
 
     {
         "Key": 324,
+
         "Key": 6224,
         "Name": "Новосибирск"
+
         "Name": "Дания"
 
     },
 
     },
 
     {
 
     {
         "Key": 1043,
+
         "Key": 6245,
         "Name": "Омск"
+
         "Name": "Доминиканская Республика"
 
     },
 
     },
 
     {
 
     {
         "Key": 345,
+
         "Key": 9,
         "Name": "Оренбург"
+
         "Name": "Египет"
 
     },
 
     },
 
     {
 
     {
         "Key": 308,
+
         "Key": 729,
         "Name": "Пенза"
+
         "Name": "Израиль"
 
     },
 
     },
 
     {
 
     {
         "Key": 263,
+
         "Key": 26,
         "Name": "Пермь"
+
         "Name": "Индия"
 
     },
 
     },
 
     {
 
     {
         "Key": 478,
+
         "Key": 6221,
         "Name": "Петропавловск-Камчатский"
+
         "Name": "Индонезия"
 
     },
 
     },
 
     {
 
     {
         "Key": 271,
+
         "Key": 6244,
         "Name": "Псков"
+
         "Name": "Иордания"
 
     },
 
     },
 
     {
 
     {
         "Key": 1100,
+
         "Key": 6288,
         "Name": "Пушкино"
+
         "Name": "Ирландия"
 
     },
 
     },
 
     {
 
     {
         "Key": 260,
+
         "Key": 84,
         "Name": "Ростов-на-Дону"
+
         "Name": "Испания"
 
     },
 
     },
 
     {
 
     {
         "Key": 235,
+
         "Key": 80,
         "Name": "Рязань"
+
         "Name": "Италия"
 
     },
 
     },
 
     {
 
     {
         "Key": 232,
+
         "Key": 3272,
         "Name": "Самара"
+
         "Name": "Казахстан"
 
     },
 
     },
 
     {
 
     {
         "Key": 295,
+
         "Key": 6240,
         "Name": "Санкт-Петербург"
+
         "Name": "Камбоджа"
 
     },
 
     },
 
     {
 
     {
         "Key": 1099,
+
         "Key": 10,
         "Name": "Симферополь"
+
         "Name": "Кипр"
 
     },
 
     },
 
     {
 
     {
         "Key": 244,
+
         "Key": 6237,
         "Name": "Смоленск"
+
         "Name": "Китай"
 
     },
 
     },
 
     {
 
     {
         "Key": 1084,
+
         "Key": 6254,
         "Name": "Снегири"
+
         "Name": "Круизы"
 
     },
 
     },
 
     {
 
     {
         "Key": 454,
+
         "Key": 6243,
         "Name": "Сочи"
+
         "Name": "Куба"
 
     },
 
     },
 
     {
 
     {
         "Key": 1310,
+
         "Key": 6241,
         "Name": "Судак"
+
         "Name": "Лаос"
 
     },
 
     },
 
     {
 
     {
         "Key": 1102,
+
         "Key": 6261,
         "Name": "Тверь"
+
         "Name": "Маврикий"
 
     },
 
     },
 
     {
 
     {
         "Key": 1198,
+
         "Key": 603,
         "Name": "Тестовый город"
+
         "Name": "Малайзия"
 
     },
 
     },
 
     {
 
     {
         "Key": 307,
+
         "Key": 960,
         "Name": "Томск"
+
         "Name": "Мальдивы"
 
     },
 
     },
 
     {
 
     {
         "Key": 246,
+
         "Key": 535,
         "Name": "Тула"
+
         "Name": "Мальта"
 
     },
 
     },
 
     {
 
     {
         "Key": 334,
+
         "Key": 77,
         "Name": "Хабаровск"
+
         "Name": "Мексика"
 
     },
 
     },
 
     {
 
     {
         "Key": 336,
+
         "Key": 6252,
         "Name": "Якутск"
+
         "Name": "Молдавия"
 
     },
 
     },
 
     {
 
     {
         "Key": 1098,
+
         "Key": 6242,
         "Name": "Ялта"
+
         "Name": "Мьянма"
 
     },
 
     },
 
     {
 
     {
         "Key": 231,
+
         "Key": 6249,
         "Name": "Ярославль"
+
         "Name": "Непал"
 
     },
 
     },
 
     {
 
     {
         "Key": 1082,
+
         "Key": 6222,
         "Name": "Ясный"
+
         "Name": "Норвегия"
     }
+
     },
]
+
    {
</syntaxhighlight>
+
        "Key": 2,
</TD></TR></TABLE>
+
        "Name": "ОАЭ"
</div></div><br />
+
    },
 
+
    {
 
+
        "Key": 6275,
===Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)===
+
        "Name": "Оман"
Метод производит выгрузку городов отправления в оформлении клиентов.
+
    },
* Формат запроса:
 
** GET .../TourSearchOwin/RegistrationClientsDepartureCities?
 
* Принимаемые параметры ( * – обязательный):
 
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''withoutFlight''' – перевод для ключа ''-1'' (Без перелета)
 
 
 
* Возвращаемый результат:
 
** '''Key''' – ключ города
 
** '''Name''' – название
 
** '''IsExist''' – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
Вызов метода RegistrationClientsDepartureCities
 
<syntaxhighlight lang="java" enclose="div">
 
http://localhost:9000/TourSearchOwin/RegistrationClientsDepartureCities?term=&withoutFlight=Без перелета
 
</syntaxhighlight>
 
Возвращаемый результат метода RegistrationClientsDepartureCities (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
 
     {
 
     {
         "Key": -1,
+
         "Key": 6246,
         "Name": "Без перелета",
+
         "Name": "Польша"
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
         "Key": 1080,
+
         "Key": 22,
         "Name": "Prime travel",
+
         "Name": "Португалия"
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
         "Key": 1079,
+
         "Key": 460,
         "Name": "Азимут",
+
         "Name": "Россия"
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
         "Key": 1309,
+
         "Key": 6265,
         "Name": "Алушта",
+
         "Name": "Сейшелы"
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
         "Key": 56,
+
         "Key": 6309,
         "Name": "Москва"
+
         "Name": "Сербия"
        "IsExist": true
+
     },
     }
+
    {
]
+
        "Key": 665,
</syntaxhighlight>
+
        "Name": "Сингапур"
</TD></TR></TABLE>
+
    },
</div></div><br />
+
    {
 
+
        "Key": 6274,
 
+
        "Name": "Словения"
===Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)===
+
    },
Метод производит выгрузку стран в оформлении клиентов.
+
    {
* Формат запроса:
+
        "Key": 7,
** GET .../TourSearchOwin/RegistrationClientsDestination?
+
        "Name": "США"
* Принимаемые параметры ( * – обязательный):
+
    },
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
 
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
 
 
* Возвращаемый результат:
 
** '''Name''' – название
 
** '''Key''' – ключ страны
 
** '''DestinationType''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
 
** '''IsExist''' – информация о том, есть ли в этой стране актуальные программы туров (true/false)
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
Вызов метода RegistrationClientsDestination
 
<syntaxhighlight lang="java" enclose="div">
 
http://localhost:9000/TourSearchOwin/RegistrationClientsDestination?departureCity=1&term=
 
</syntaxhighlight>
 
Возвращаемый результат метода RegistrationClientsDestination (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
 
     {
 
     {
        "Name": "Австрия",
+
         "Key": 6253,
         "Key": 90,
+
         "Name": "Таджикистан"
         "DestinationType": 1,
 
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
        "Name": "Англия",
+
         "Key": 6236,
         "Key": 222,
+
         "Name": "Тайвань"
         "DestinationType": 1,
 
        "IsExist": true
 
 
     },
 
     },
 
     {
 
     {
         "Name": "Беларусь",
+
        "Key": 53,
         "Key": 375,
+
         "Name": "Тайланд"
         "DestinationType": 1,
+
    },
        "IsExist": true
+
    {
     }
+
         "Key": 6313,
]
+
         "Name": "Танзания"
</syntaxhighlight>
+
     },
</TD></TR></TABLE>
+
    {
</div></div><br />
+
        "Key": 97,
 
+
        "Name": "Тунис"
 
+
    },
===Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)===
+
    {
Метод производит выгрузку турпрограмм в оформлении клиентов.
+
        "Key": 86,
* Формат запроса:
+
        "Name": "Турция"
** GET .../TourSearchOwin/RegistrationClientsTourPrograms?
+
    },
* Принимаемые параметры ( * – обязательный):
+
    {
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
+
        "Key": 5,
** '''destination *''' – ключ страны (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
+
        "Name": "Украина"
** '''destinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
    },
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''individualTitle ''' – перевод для программы тура с ключом 0 (Индивидуально)
 
 
 
* Возвращаемый результат:
 
** '''Key''' – ключ программы туров
 
** '''Name''' – название программы туров
 
** '''Rate''' – валюта тура
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
Вызов метода RegistrationClientsTourPrograms
 
<syntaxhighlight lang="java" enclose="div">
 
http://localhost:9000/TourSearchOwin/RegistrationClientsTourPrograms?departureCity=1&destination=90&destinationType=1&individualTitle=Индивидуально&term=
 
</syntaxhighlight>
 
Возвращаемый результат метода RegistrationClientsTourPrograms (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
 
     {
 
     {
         "Key": 0,
+
         "Key": 6250,
         "Name": "Индивидуально",
+
         "Name": "Филиппины"
        "Rate": ""
 
 
     },
 
     },
 
     {
 
     {
         "Key": 100003415,
+
         "Key": 64,
         "Name": "Aviabooking",
+
         "Name": "Финляндия"
        "Rate": "EU"
 
 
     },
 
     },
 
     {
 
     {
         "Key": 100003416,
+
         "Key": 30,
         "Name": "Общая проверка системы",
+
         "Name": "Франция"
         "Rate": "EU"
+
    },
     }
+
    {
]
+
        "Key": 38,
</syntaxhighlight>
+
        "Name": "Хорватия"
</TD></TR></TABLE>
+
    },
</div></div><br />
+
    {
 
+
        "Key": 6314,
 
+
         "Name": "Черногория "
===Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)===
+
    },
Метод производит выгрузку дат заезда в оформлении клиентов.
+
    {
* Формат запроса:
+
        "Key": 15,
** GET .../TourSearchOwin/RegistrationClientsTourDate?
+
        "Name": "Чехия"
* Принимаемые параметры ( * – обязательный):
+
    },
** '''tourKey *''' – ключ программы тура
+
    {
 
+
        "Key": 76,
* Возвращаемый результат:
+
        "Name": "Швейцария"
** массив дат
+
    },
 +
    {
 +
        "Key": 6223,
 +
        "Name": "Швеция"
 +
    },
 +
    {
 +
        "Key": 941,
 +
        "Name": "Шри Ланка"
 +
    },
 +
    {
 +
        "Key": 372,
 +
        "Name": "Эстония"
 +
    },
 +
    {
 +
        "Key": 6247,
 +
        "Name": "Южная Корея"
 +
    },
 +
    {
 +
        "Key": 6248,
 +
        "Name": "Япония"
 +
     }
 +
]
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
 
 +
===Выгрузка списка всех городов (Cities)===
 +
Метод производит выгрузку всех городов (используется для регистрации частного лица).
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/Cities?
 +
* Принимаемые параметры ( * – обязательный):
 +
** '''countryKey *''' – ключ страны, по которой выгружать города (при значении ''-1'' выгружаются все города)
 +
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 +
 
 +
* Возвращаемый результат:
 +
** '''Key''' – ключ города
 +
** '''Name''' – название
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
Вызов метода RegistrationClientsTourDate
+
Вызов метода Cities
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
http://localhost:9000/TourSearchOwin/RegistrationClientsTourDate?tourKey=100006755
+
http://localhost:9000/TourSearchOwin/Cities?countryKey=460&term=
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода RegistrationClientsTourDate (в формате JSON)
+
Возвращаемый результат метода Cities (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
[
     "06.05.2021",
+
     {
    "07.05.2021",
+
        "Key": 1309,
     "08.05.2021",
+
        "Name": "Алушта"
    "09.05.2021",
+
    },
     "10.05.2021",
+
     {
     "11.05.2021",
+
        "Key": 564,
    "12.05.2021",
+
        "Name": "Анапа"
     "13.05.2021",
+
     },
    "14.05.2021",
+
     {
     "15.05.2021"
+
        "Key": 299,
]
+
        "Name": "Архангельск"
</syntaxhighlight>
+
    },
</TD></TR></TABLE>
+
     {
</div></div><br />
+
        "Key": 312,
 
+
        "Name": "Астрахань"
===Поиск туров в оформлении клиентов (Search)===
+
    },
Метод возвращает наиболее дешевое предложения по определенному туру.
+
     {
* Формат запроса:
+
        "Key": 265,
** GET .../TourSearchOwin/RegistrationClient/Search?
+
        "Name": "Белгород"
* Принимаемые параметры ( '''*''' – обязательный):
+
    },
** '''DepartureCityKeys *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
+
    {
** '''Dates *''' – дата заезда (из контроллера [[#Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)|''.../TourSearchOwin/RegistrationClientsTourDate?'']])
+
        "Key": 329,
** '''Durations *''' – продолжительность
+
        "Name": "Владивосток"
** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
+
    },
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
+
    {
** '''isFromBasket *''' – всегда false
+
        "Key": 258,
** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true)
+
        "Name": "Владикавказ"
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
    },
** '''DestinationKey *''' – идентификатор страны прибытия (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
+
    {
** '''AdultCount *''' – количество взрослых
+
        "Key": 236,
** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+
        "Name": "Владимир"
** '''IsRegistrationClients''' – по умолчанию всегда приходит false
+
    },
** '''CurrencyName *''' – код валюты
+
    {
** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
        "Key": 358,
** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
        "Name": "Волгоград"
** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+
    },
** '''HotelScheme''' – пустой по умолчанию
+
    {
** '''TimeDepartureFrom''' – время отправления с (по умолчанию возвращается 00:00)
+
        "Key": 1089,
** '''TimeDepartureTo''' – время отправления по (по умолчанию возвращается 23:59)
+
        "Name": "Воркута"
** '''TimeArrivalFrom''' – время прибытия с (по умолчанию возвращается 00:00)
+
    },
** '''TimeArrivalTo''' – время прибытия по (по умолчанию возвращается 23:59)
+
    {
** '''ArrivalFlightNoTransfer''' – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
+
        "Key": 1312,
** '''DepartureFlightNoTransfer''' – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
+
        "Name": "Воронеж"
** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
+
    },
** '''Tour''' – ключ программы тура
+
    {
 
+
        "Key": 266,
* Возвращаемый результат:
+
        "Name": "Екатеринбург"
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
+
    },
** '''Message''' – сообщение об ошибке
+
    {
*** '''Key''' – код ошибки
+
        "Key": 254,
*** '''Value''' – сообщение об ошибке
+
        "Name": "Иваново"
** '''Result''' – результаты поиска
+
    },
*** '''Key''' – идентификатов программы тура
+
    {
*** '''Name''' – название программы тура
+
        "Key": 350,
*** '''TourUrl''' – ссылка на программу тура
+
        "Name": "Иркутск"
*** '''BookingConditions''' – условия бронирования программы туров
+
    },
*** '''StartDate''' – дата начала тура
+
    {
*** '''Duration''' – продолжительность тура (в днях)
+
        "Key": 238,
*** '''DurationInNight''' – продолжительность проживания (в ночах)
+
        "Name": "Казань"
*** '''Types''' – идентификатор типа туров
+
    },
*** '''Cost''' – цена тура
+
    {
*** '''Rate''' – код валюты тура
+
        "Key": 306,
*** '''CityDepature''' – город отправления
+
        "Name": "Калининград"
**** '''Key''' – идентификатор города отправления
+
    },
**** '''Value''' – название города отправления
+
    {
*** '''CountryId''' – всегда возвращается ключ 0
+
        "Key": 1308,
*** '''Services''' – услуги в туре
+
        "Name": "Коктебель"
**** '''DepartureCity''' – город отправления
+
    },
***** '''Key''' – идентификатор
+
    {
***** '''Value''' – название
+
        "Key": 313,
**** '''DepartureCountry''' – страна отправления
+
        "Name": "Краснодар"
***** '''Key''' – идентификатор
+
    },
***** '''Value''' – название
+
    {
**** '''ArrivalCity''' – город прибытия
+
        "Key": 269,
***** '''Key''' – идентификатор
+
        "Name": "Красноярск"
***** '''Value''' – название
+
    },
**** '''ArrivalCountry''' – страна прибытия
+
    {
***** '''Key''' – идентификатор
+
        "Key": 1311,
***** '''Value''' – название
+
        "Name": "Крым"
**** '''DepartureAirport''' – аэропорт отправления
+
    },
***** '''Key''' – идентификатор
+
    {
***** '''Value''' – название
+
        "Key": 1,
**** '''ArrivalAirport''' – аэропорт прибытия
+
        "Name": "Москва"
***** '''Key''' – идентификатор
+
    },
***** '''Value''' – название
+
    {
**** '''Airline''' – авиакомпания
+
        "Key": 259,
***** '''Key''' – идентификатор
+
        "Name": "Мурманск"
***** '''Value''' – название
+
    },
**** '''Aircraft''' – воздушное судно
+
    {
***** '''Key''' – идентификатор
+
        "Key": 234,
***** '''Value''' – название
+
        "Name": "Нижний Новгород"
**** '''Flight''' – рейс
+
    },
***** '''Key''' – идентификатор
+
    {
***** '''Value''' – название
+
        "Key": 1097,
**** '''DepartureTime''' – время вылета
+
        "Name": "Новая Купавна"
**** '''ArrivalTime''' – время прилета
+
    },
**** '''EndDateTime''' – дата и время прилета
+
    {
**** '''FlightDetails''' – информация об авиаперелете
+
        "Key": 324,
***** '''Tariff''' – информация о тарифе перелета
+
        "Name": "Новосибирск"
****** '''Key''' – идентификатор
+
    },
****** '''Code''' – код тарифа
+
    {
****** '''Name''' – название тарифа
+
        "Key": 1043,
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
+
        "Name": "Омск"
***** '''QuotaStatus''' – информация о квоте
+
    },
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
    {
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
        "Key": 345,
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
        "Name": "Оренбург"
***** '''PartnerId''' – ключ партнера
+
    },
***** '''ByPax''' – цена за человека (true/false)
+
    {
***** '''Partner''' – информация о партнере
+
        "Key": 308,
****** '''Key''' – идентификатор
+
        "Name": "Пенза"
****** '''Value''' – название
+
    },
**** '''FlightSetting''' – внутренняя информация о перелете из программы туров
+
    {
***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
+
        "Key": 263,
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
+
        "Name": "Пермь"
***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров)
+
    },
**** '''FlightSourceMode''' – локальный или внешний перелет (внутренняя информация из программы туров)
+
    {
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
+
        "Key": 478,
**** '''SvKey''' – ключ типа услуги
+
        "Name": "Петропавловск-Камчатский"
**** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
+
    },
**** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
+
    {
**** '''IsPartnerBasedOn''' – признак услуга с приоритетным подбором поставщика
+
        "Key": 271,
**** '''Day''' – день предоставления услуги
+
        "Name": "Псков"
**** '''DurationInNight''' – продолжительность услуги в ночах
+
    },
**** '''BeginDateTime''' – дата предоставления услуги
+
    {
**** '''IsHooded''' – признак скрытая услуга
+
        "Key": 1100,
**** '''IsDeleted''' – признак удаляемая услуга
+
        "Name": "Пушкино"
**** '''IsNotCalculate''' – признак не рассчитываемая услуга
+
    },
**** '''PacketId''' – ключ пакета
+
    {
**** '''Index''' – порядковый номер услуги
+
        "Key": 260,
*** '''NotRouteServices''' – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
+
        "Name": "Ростов-на-Дону"
**** '''ServiceName''' – название типа услуги
+
    },
**** '''City''' – объект город
+
    {
***** '''Key''' – ключ города
+
        "Key": 235,
***** '''Value''' – название города
+
        "Name": "Рязань"
**** '''Country''' – ключ страны
+
    },
**** '''Code''' – объект код услуги
+
    {
***** '''Key''' ключ услуги
+
        "Key": 232,
***** '''Value''' – название услуги
+
        "Name": "Самара"
**** '''ByScheduler''' – флаг услуга по расписанию или нет
+
    },
**** '''Details''' – объект детализация услуги
+
    {
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
        "Key": 295,
****** '''Key''' – ключ доп. описания 1
+
        "Name": "Санкт-Петербург"
****** '''Value''' – название доп. описания 1
+
    },
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
    {
****** '''Key''' – ключ доп. описания 2
+
        "Key": 1099,
****** '''Value''' – название доп. описания 2
+
        "Name": "Симферополь"
***** '''Date''' – дата услуги
+
    },
***** '''IsShowTransportPlan''' – признак показывать ли план рассадки (для автобусов)
+
    {
***** '''Cost''' – цена
+
        "Key": 244,
***** '''QuotaStatus''' – объект информация по квотам
+
        "Name": "Смоленск"
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
    },
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
    {
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
        "Key": 1084,
***** '''PartnerId''' – идентификатор партнера
+
        "Name": "Снегири"
***** '''ByPax''' – признак цены за человека
+
    },
***** '''Partner''' – объект партнер (не заполняется)
+
    {
****** '''Key''' – ключ (не заполняется)
+
        "Key": 454,
****** '''Value''' – название (не заполняется)
+
        "Name": "Сочи"
**** '''ParentId''' – идентификатор родительской услуги (для вложенных услуг)
+
    },
**** '''PartnerBasedOnServiceTemplateId''' – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
+
    {
**** '''Id''' – идентификатор услуги
+
        "Key": 1310,
**** '''SvKey''' – ключ типа услуги
+
        "Name": "Судак"
**** '''IsSubCode1''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
+
    },
**** '''IsSubCode2''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
+
    {
**** '''IsPartnerBasedOn''' – услуга с подбором приоритетного поставщика услуги
+
        "Key": 1102,
**** '''Day''' – день предоставления услуги
+
        "Name": "Тверь"
**** '''DurationInNight''' – продолжительность услуги в ночах
+
    },
**** '''BeginDateTime''' – дата предоставления услуги
+
    {
**** '''EndDateTime''' – дата окончания услуги
+
        "Key": 1198,
**** '''IsHooded''' – скрытая ли услуга
+
        "Name": "Тестовый город"
**** '''IsDeleted''' – удаляемая ли услуга
+
    },
**** '''IsNotCalculate''' – не рассчитываемая ли услуга
+
    {
**** '''PacketId''' – пакет услуги
+
        "Key": 307,
**** '''Index''' – индекс услуги
+
        "Name": "Томск"
*** '''MinCostServicesComposition''' – массив состав услуг минимальной цены
+
    },
**** '''Key''' – ключ
+
    {
***** '''TemplateId''' – идентификатор шаблона
+
        "Key": 246,
***** '''PatternId''' – идентификатор вкладки
+
        "Name": "Тула"
***** '''SettingId''' – идентификатор услуги
+
    },
**** '''Value''' – значение
+
    {
***** '''ServiceType''' – тип услуги
+
        "Key": 334,
***** '''Code''' – ключ услуги
+
        "Name": "Хабаровск"
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
    },
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
    {
***** '''PacketId''' – пакет услуги
+
        "Key": 336,
***** '''PartnerId''' – партнер услуги
+
        "Name": "Якутск"
***** '''CountryId''' – страна услуги
+
    },
***** '''CityId''' – город услуги
+
    {
***** '''Day''' – день предоставления услуги
+
        "Key": 1098,
***** '''DurationInNight''' – продолжительность услуги в ночах
+
        "Name": "Ялта"
**** '''COAndSpecialsInfo''' – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
+
    },
***** '''AppliedCostOffersKeys''' – коллекция идентификаторов всех применённых ценовых блоков к одной цене             
+
    {
***** '''AppliedSpeciasInfo''' – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
+
        "Key": 231,
****** '''SpecialKey''' – ключ акции
+
        "Name": "Ярославль"
****** '''SpecialName''' – название акции
+
    },
****** '''SpecialType''' – тип акции
+
    {
****** '''NewPrice''' – цена после применения акции
+
        "Key": 1082,
****** '''OldPrice''' – цена до применения акции
+
        "Name": "Ясный"
****** '''ShowOnline''' – нужно ли показывать акцию в поиске
+
    }
****** '''UntilDate''' – акция действует при совершении покупки до указанной даты
+
]
****** '''Condition''' – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
+
</syntaxhighlight>
******* ''NightsFrom'' (для типа ''PayStay'') – ночей от
+
</TD></TR></TABLE>
******* ''NightsTo'' (для типа ''PayStay'') – ночей до
+
</div></div><br />
******* ''NightValue'' (для типа ''PayStay'') – значение ночи, которое соответствует заданному периоду
+
 
******* ''OperationType'' (для типа ''PayStay'') – тип действия
+
 
******* ''SpecialNightType'' (для типа ''PayStay'') – тип бесплатной ночи
+
===Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)===
******* ''DurationFrom'' (для типа ''KickBack'') – ночей от
+
Метод производит выгрузку городов отправления в оформлении клиентов.
******* ''DurationTo'' (для типа ''KickBack'') – ночей до
+
* Формат запроса:
******* ''Value'' (для типа ''KickBack'') – значение продолжительности, равное заданному периоду
+
** GET .../TourSearchOwin/RegistrationClientsDepartureCities?
******* ''OperationType'' (для типа ''KickBack'') – тип действия
+
* Принимаемые параметры ( * – обязательный):
******* ''NightsFrom'' (для типа ''EarlyBird'') – ночей от
+
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
******* ''NightsTo'' (для типа ''EarlyBird'') – ночей до
+
** '''withoutFlight''' – перевод для ключа ''-1'' (Без перелета)
******* ''Discount'' (для типа ''EarlyBird'') – размер скидки
+
 
******* ''OperationType'' (для типа ''EarlyBird'') – тип действия
+
* Возвращаемый результат:
**** '''COBySubCode''' – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
+
** '''Key''' – ключ города
**** '''SpecialsBySubCode''' –  список применённых акций по SubCode1 и SubCode2
+
** '''Name''' – название
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
** '''IsExist''' – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]             
+
 
*** '''FlightWeight''' –
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
*** '''LinkingFlightsRules''' – объект правил связывания
+
<div class="mw-collapsible-content">
**** '''notCombineDifferentAirlineRule''' – объект не скрещивать авиакомпании
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
***** '''airlines''' – авиакомпании
+
Вызов метода RegistrationClientsDepartureCities
***** '''flightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
<syntaxhighlight lang="java" enclose="div">
***** '''enabled''' – флаг включен/выключен
+
http://localhost:9000/TourSearchOwin/RegistrationClientsDepartureCities?term=&withoutFlight=Без перелета
**** '''checkPlusMinus1CharterRule''' – объект Отличие номера рейса на 1
+
</syntaxhighlight>
***** '''FlightSettingPairs''' – массив чартеров, для которых это правило будет выполняться
+
Возвращаемый результат метода RegistrationClientsDepartureCities (в формате JSON)
***** '''enabled''' – флаг включен/выключен
+
<syntaxhighlight lang="java" enclose="div">
**** '''notCombineDifferentTariffGroupRule''' – объект не комбинировать рейсы от разных классов перелетов
+
[
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
    {
***** '''enabled''' – флаг включен/выключен
+
        "Key": -1,
**** '''notCombineDifferentPartnerRule''' – объект не комбинировать рейсы от разных партнеров
+
        "Name": "Без перелета",
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
        "IsExist": true
***** '''enabled''' – флаг включен/выключен
+
    },
**** '''departureCityEqualsArrivalCityRule''' – объект Город вылета = городу прилета
+
    {
***** '''FlightSettingPairs''' – чартеры, для которых это будет выполняться
+
        "Key": 1080,
***** '''enabled''' – флаг включен/выключен
+
        "Name": "Prime travel",
**** '''combineOnlySpecificChartersRule''' – объект не комбинировать различные классы перелетов
+
        "IsExist": true
***** '''settings''' – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
+
    },
***** '''enabled''' – флаг включен/выключен
+
    {
*** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
+
        "Key": 1079,
** '''SecondaryFiltersResult''' – результаты доп. фильтров
+
        "Name": "Азимут",
*** '''TourTypes''' – типы тура
+
        "IsExist": true
**** '''Id''' – ключ типа тура
+
    },
**** '''Name''' – название типа тура
+
    {
**** '''ParentId''' – родительский элемент типа тура (если есть)
+
        "Key": 1309,
**** '''Type''' – тип справочника (используется для внутренних целей)
+
        "Name": "Алушта",
*** '''TourPrograms''' – информация по каждой турпрограмме
+
        "IsExist": true
**** '''Key''' – ключ турпрограммы
+
    },
**** '''Name''' – название турпрограммы
+
    {
**** '''TourUrl''' – ссылка на тур
+
        "Key": 56,
**** '''BookingConditions''' – условия бронирования
+
        "Name": "Москва"
**** '''IsLandOnly''' – признак только наземное обслуживание
+
        "IsExist": true
**** '''IsRestrictMultiHotels''' – ограничивать ли расчёт многоотельных туров категориями отелей
+
    }
**** '''IsHotelTemplates''' – есть ли вообще отели в данной турпрограмме
+
]
**** '''IsRouteServices''' – есть ли маршрутные услуги
+
</syntaxhighlight>
**** '''MultiHotelDelta''' – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
+
</TD></TR></TABLE>
**** '''Rate''' – валюта тура
+
</div></div><br />
**** '''DateStart''' – нижняя граница дат заезда по программе тура
+
 
**** '''DateEnd''' – верхняя граница дат заеда по программе тура
+
 
**** '''Status''' – статус турпрограммы
+
===Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)===
***** '''Key''' – ключ
+
Метод производит выгрузку стран в оформлении клиентов.
***** '''Value''' – значение
+
* Формат запроса:
**** '''Templates''' – шаблоны услуг
+
** GET .../TourSearchOwin/RegistrationClientsDestination?
***** '''$id''' – шаблон 1
+
* Принимаемые параметры ( * – обязательный):
***** '''$id''' – шаблон 2
+
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
**** '''Types''' – типы тура
+
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
***** '''Id''' – ключ типа тура
+
 
***** '''Name''' – название типа тура
+
* Возвращаемый результат:
***** '''ParentId''' – родительский элемент типа тура (если есть)
+
** '''Name''' – название
***** '''Type''' – тип справочника (используется для внутренних целей)
+
** '''Key''' – ключ страны
**** '''LinkingFlightsRules''' – правила связывания перелетов
+
** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
***** '''notCombineDifferentAirlineRule''' –
+
** '''IsExist''' – информация о том, есть ли в этой стране актуальные программы туров (true/false)
****** '''airlines''' –
+
 
****** '''flightSettings''' –
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
****** '''enabled''' –
+
<div class="mw-collapsible-content">
***** '''checkPlusMinus1CharterRule''' –
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
****** '''FlightSettingPairs''' –
+
Вызов метода RegistrationClientsDestination
****** '''enabled''' –
+
<syntaxhighlight lang="java" enclose="div">
***** '''notCombineDifferentTariffGroupRule''' –
+
http://localhost:9000/TourSearchOwin/RegistrationClientsDestination?departureCity=1&term=
****** '''FlightSettings''' –
+
</syntaxhighlight>
****** '''enabled''' –
+
Возвращаемый результат метода RegistrationClientsDestination (в формате JSON)
***** '''notCombineDifferentPartnerRule''' –
+
<syntaxhighlight lang="java" enclose="div">
****** '''FlightSettings''' –
+
[
****** '''enabled''' –
+
    {
***** '''departureCityEqualsArrivalCityRule''' –
+
        "Name": "Австрия",
****** '''FlightSettingPairs''' –
+
        "Key": 90,
****** '''enabled''' –
+
        "DestinationType": 1,
***** '''combineOnlySpecificChartersRule''' –
+
        "IsExist": true
****** '''settings''' –
+
    },
****** '''enabled''' –
+
    {
**** '''XmlSettings''' – строка xml для актуальных фильтров
+
        "Name": "Англия",
**** '''Type''' – тип справочника (используется для внутренних целей)
+
        "Key": 222,
*** '''TourDurations''' – продолжительность тура
+
        "DestinationType": 1,
*** '''TourDates''' – список дат заездов в турпрограмме
+
        "IsExist": true
**** '''HotelCities''' – город в дополнительных фильтрах
+
    },
***** '''''' –
+
    {
**** '''HotelResorts''' – курорты в дополнительных фильтрах
+
        "Name": "Беларусь",
***** '''''' –
+
        "Key": 375,
**** '''HotelCategories''' – категории отеля в дополнительных фильтрах
+
        "DestinationType": 1,
***** '''''' –
+
        "IsExist": true
**** '''Hotels''' – отели в дополнительных фильтрах
+
    }
***** '''''' –
+
]
**** '''Pansions''' – питания в дополнительных фильтрах
+
</syntaxhighlight>
***** '''''' –
+
</TD></TR></TABLE>
**** '''Airlines''' – авиакомпании в дополнительных фильтрах
+
</div></div><br />
***** '''''' –
+
 
**** '''FlightTariffs''' – класс перелета в дополнительных фильтрах
 
***** '''''' –
 
**** '''DepartureCities''' – города вылета в дополнительных фильтрах
 
***** '''''' –
 
**** '''DepartureAirports''' – аэропорты вылета в дополнительных фильтрах
 
***** '''''' –
 
**** '''ArrivalCities''' – города прибытия в дополнительных фильтрах
 
***** '''''' –
 
**** '''ArrivalAirports''' – аэропорты прибытия в дополнительных фильтрах
 
***** '''''' –
 
**** '''HotelTypes''' – признаки отелей в дополнительных фильтрах
 
***** '''''' –
 
  
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
===Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)===
<div class="mw-collapsible-content">
+
Метод производит выгрузку турпрограмм в оформлении клиентов.
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
* Формат запроса:
Вызов метода RegistrationClient/Search
+
** GET .../TourSearchOwin/RegistrationClientsTourPrograms?
<syntaxhighlight lang="java" enclose="div">
+
* Принимаемые параметры ( * – обязательный):
GET http://localhost:9000/TourSearchOwin/RegistrationClient/Search?DepartureCityKeys=1&Dates=12.02.2021&Durations=9
+
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
&PageNumber=1&PageSize=20&isFromBasket=false&isFillSecondaryFilters=true&DestinationType=1&DestinationKey=90
+
** '''destination *''' – ключ страны (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
&AdultCount=2&IsRegistrationClients=false&CurrencyName=EU&AviaQuota=7&HotelQuota=7&BusTransferQuota=7
+
** '''destinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
&TimeArrivalFrom=00:00&TimeArrivalTo=23:59&TimeDepartureFrom=00:00&TimeDepartureTo=23:59
+
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
&ArrivalFlightNoTransfer=false&Tour=100006755&TourDuration=&DepartureFlightNoTransfer=false&HotelScheme=
+
** '''individualTitle ''' – перевод для программы тура с ключом 0 (Индивидуально)
 +
 
 +
* Возвращаемый результат:
 +
** '''Key''' – ключ программы туров
 +
** '''Name''' – название программы туров
 +
** '''Rate''' – валюта тура
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода RegistrationClientsTourPrograms
 +
<syntaxhighlight lang="java" enclose="div">
 +
http://localhost:9000/TourSearchOwin/RegistrationClientsTourPrograms?departureCity=1&destination=90&destinationType=1&individualTitle=Индивидуально&term=
 
</syntaxhighlight>
 
</syntaxhighlight>
Возвращаемый результат метода RegistrationClient/Search (в формате JSON)
+
Возвращаемый результат метода RegistrationClientsTourPrograms (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
{
+
[
  "CheckMessages": null,
+
    {
  "Message":   {
+
        "Key": 0,
      "Key": 0,
+
        "Name": "Индивидуально",
      "Value": null
+
        "Rate": ""
  },
+
    },
  "Result":   [
+
    {
            {
+
        "Key": 100003415,
        "Key": 100000004,
+
        "Name": "Aviabooking",
        "Name": "Общая проверка системы",
+
        "Rate": "EU"
        "TourUrl": "www.megatec.ru",
+
    },
        "BookingConditions": "<p>Условия бронирования тура.<\/p>",
+
    {
        "StartDate": "2018-02-25T00:00:00",
+
        "Key": 100003416,
        "Duration": 4,
+
        "Name": "Общая проверка системы",
        "DurationInNight": 3,
+
        "Rate": "EU"
        "Types": [2],
+
    }
        "Cost": 260,
+
]
        "Rate": "EU",
+
</syntaxhighlight>
        "CityDepature":          {
+
</TD></TR></TABLE>
            "Key": 1,
+
</div></div><br />
            "Value": "Москва"
+
 
        },
+
 
        "CountryId": 0,
+
===Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)===
        "Services":          [
+
Метод производит выгрузку дат заезда в оформлении клиентов.
                        {
+
* Формат запроса:
              "DepartureCity":                {
+
** GET .../TourSearchOwin/RegistrationClientsTourDate?
                  "Key": 1,
+
* Принимаемые параметры ( * – обязательный):
                  "Value": "Москва"
+
** '''tourKey *''' – ключ программы тура
              },
+
 
              "DepartureCountry":                {
+
* Возвращаемый результат:
                  "Key": 460,
+
** массив дат
                  "Value": "Россия"
+
 
              },
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
              "ArrivalCity":                {
+
<div class="mw-collapsible-content">
                  "Key": 35,
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
                  "Value": "Вена"
+
Вызов метода RegistrationClientsTourDate
              },
+
<syntaxhighlight lang="java" enclose="div">
              "ArrivalCountry":                {
+
http://localhost:9000/TourSearchOwin/RegistrationClientsTourDate?tourKey=100006755
                  "Key": 90,
+
</syntaxhighlight>
                  "Value": "Австрия"
+
Возвращаемый результат метода RegistrationClientsTourDate (в формате JSON)
              },
+
<syntaxhighlight lang="java" enclose="div">
              "DepartureAirport":               {
+
[
                  "Key": "SVO4",
+
    "06.05.2021",
                  "Value": "Шереметьево-24"
+
    "07.05.2021",
              },
+
    "08.05.2021",
              "ArrivalAirport":                {
+
    "09.05.2021",
                  "Key": "VIE1",
+
    "10.05.2021",
                  "Value": "Vena1"
+
    "11.05.2021",
              },
+
    "12.05.2021",
              "Airline":                {
+
    "13.05.2021",
                  "Key": "BA7",
+
    "14.05.2021",
                  "Value": "BRITISH  AIRWAYS"
+
    "15.05.2021"
              },
+
]
              "Aircraft":                {
+
</syntaxhighlight>
                  "Key": "319",
+
</TD></TR></TABLE>
                  "Value": "AIRBUS "
+
</div></div><br />
              },
+
 
              "Flight":                {
+
===Поиск туров в оформлении клиентов (Search)===
                  "Key": 882,
+
Метод возвращает наиболее дешевое предложения по определенному туру.
                  "Value": "4444"
+
* Формат запроса:
              },
+
** GET .../TourSearchOwin/RegistrationClient/Search?
              "DepartureTime": "10:00:00",
+
* Принимаемые параметры ( '''*''' – обязательный):
              "ArrivalTime": "12:00:00",
+
** '''DepartureCityKeys *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
              "EndDateTime": "2018-02-25T12:00:00",
+
** '''Dates *''' – дата заезда (из контроллера [[#Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)|''.../TourSearchOwin/RegistrationClientsTourDate?'']])
              "FlightDetails": [              {
+
** '''Durations *''' – продолжительность
                  "Tariff":                  {
+
** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
                    "Key": 89,
+
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
                    "Code": "Y",
+
** '''isFromBasket *''' – всегда false
                    "Name": "Экономический класс"
+
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
                  },
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
                  "Cost": 10,
+
** '''DestinationKey *''' – идентификатор страны прибытия (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
                  "QuotaStatus":                  {
+
** '''AdultCount *''' – количество взрослых
                    "PlacesStatus": 4,
+
** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
                    "FreePlaces": 0,
+
** '''IsRegistrationClients''' – по умолчанию всегда приходит false
                    "IsFewPlaces": false
+
** '''CurrencyName *''' – код валюты
                  },
+
** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
                  "PartnerId": 12668,
+
** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
                  "ByPax": true,
+
** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
                  "Partner":                  {
+
** '''HotelScheme''' – пустой по умолчанию
                    "Key": 0,
+
** '''TimeDepartureFrom''' – время отправления с (по умолчанию возвращается 00:00)
                    "Value": null
+
** '''TimeDepartureTo''' – время отправления по (по умолчанию возвращается 23:59)
                  }
+
** '''TimeArrivalFrom''' – время прибытия с (по умолчанию возвращается 00:00)
              }],
+
** '''TimeArrivalTo''' – время прибытия по (по умолчанию возвращается 23:59)
              "FlightSetting":                {
+
** '''ArrivalFlightNoTransfer''' – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
                  "ServiceId": 3,
+
** '''DepartureFlightNoTransfer''' – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
                  "PatternId": 13,
+
** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
                  "FlightId": 13
+
** '''Tour''' – ключ программы тура
              },
+
 
              "FlightSourceMode": 1,
+
* Возвращаемый результат:
              "Id": 3,
+
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
              "SvKey": 1,
+
** '''Message''' – сообщение об ошибке
              "IsSubCode1": true,
+
*** '''Key''' – код ошибки
              "IsSubCode2": false,
+
*** '''Value''' – сообщение об ошибке
              "IsPartnerBasedOn": false,
+
** '''Result''' – результаты поиска
              "Day": 1,
+
*** '''Key''' – идентификатов программы тура
              "DurationInNight": 0,
+
*** '''Name''' – название программы тура
              "BeginDateTime": "2018-02-25T10:00:00",
+
*** '''TourUrl''' – ссылка на программу тура
              "IsHooded": false,
+
*** '''BookingConditions''' – условия бронирования программы туров
              "IsDeleted": false,
+
*** '''StartDate''' – дата начала тура
              "IsNotCalculate": false,
+
*** '''Duration''' – продолжительность тура (в днях)
              "PacketId": 779,
+
*** '''DurationInNight''' – продолжительность проживания (в ночах)
              "Index": 0
+
*** '''Types''' – идентификатор типа туров
            },
+
*** '''Cost''' – цена тура
                        {
+
*** '''Rate''' – код валюты тура
              "Hotel":                {
+
*** '''CityDepature''' – город отправления
                  "Key": 709,
+
**** '''Key''' – идентификатор города отправления
                  "Value": "Am Brilliantengrund"
+
**** '''Value''' – название города отправления
              },
+
*** '''CountryId''' – всегда возвращается ключ 0
              "City":                {
+
*** '''Services''' – услуги в туре
                  "Key": 35,
+
**** '''DepartureCity''' – город отправления
                  "Value": "Вена"
+
***** '''Key''' – идентификатор
              },
+
***** '''Value''' – название
              "Stars":               {
+
**** '''DepartureCountry''' – страна отправления
                  "Key": -1,
+
***** '''Key''' – идентификатор
                  "Value": null
+
***** '''Value''' – название
              },
+
**** '''ArrivalCity''' – город прибытия
              "Resort":                {
+
***** '''Key''' – идентификатор
                  "Key": -1,
+
***** '''Value''' – название
                  "Value": null
+
**** '''ArrivalCountry''' – страна прибытия
              },
+
***** '''Key''' – идентификатор
              "ImageURL": "",
+
***** '''Value''' – название
              "Http": null,
+
**** '''DepartureAirport''' – аэропорт отправления
              "Description": "",
+
***** '''Key''' – идентификатор
              "Country":                {
+
***** '''Value''' – название
                  "Key": 90,
+
**** '''ArrivalAirport''' – аэропорт прибытия
                  "Value": "Австрия"
+
***** '''Key''' – идентификатор
              },
+
***** '''Value''' – название
              "HotelDetails": [              {
+
**** '''Airline''' – авиакомпания
                  "HotelRoom": 46463,
+
***** '''Key''' – идентификатор
                  "Room":                  {
+
***** '''Value''' – название
                    "Key": 129,
+
**** '''Aircraft''' – воздушное судно
                    "Value": "DBL"
+
***** '''Key''' – идентификатор
                  },
+
***** '''Value''' – название
                  "RoomCategory":                  {
+
**** '''Flight''' – рейс
                    "Key": 3493,
+
***** '''Key''' – идентификатор
                    "Value": "Cosy"
+
***** '''Value''' – название
                  },
+
**** '''DepartureTime''' – время вылета
                  "AccomodationType":                  {
+
**** '''ArrivalTime''' – время прилета
                    "Key": 1256,
+
**** '''EndDateTime''' – дата и время прилета
                    "Value": "2+1_K",
+
**** '''FlightDetails''' – информация об авиаперелете
                    "AdultCount": 2,
+
***** '''Tariff''' – информация о тарифе перелета
                    "ChildCount": 1
+
****** '''Key''' – идентификатор
                  },
+
****** '''Code''' – код тарифа
                  "Pansion":                  {
+
****** '''Name''' – название тарифа
                    "Key": 4,
+
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
                    "Value": "Завтрак"
+
***** '''QuotaStatus''' – информация о квоте
                  },
+
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
                  "Cost": 19.47,
+
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
                  "QuotaStatus":                  {
+
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
                    "PlacesStatus": 4,
+
***** '''PartnerId''' – ключ партнера
                    "FreePlaces": 0,
+
***** '''ByPax''' – цена за человека (true/false)
                    "IsFewPlaces": false
+
***** '''Partner''' – информация о партнере
                  },
+
****** '''Key''' – идентификатор
                  "PartnerId": 12667,
+
****** '''Value''' – название
                  "ByPax": false,
+
**** '''FlightSetting''' – внутренняя информация о перелете из программы туров
                  "Partner":                  {
+
***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
                    "Key": 12667,
+
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
                    "Value": "Партнер-покупатель1"
+
***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров)
                  }
+
**** '''FlightSourceMode''' – локальный или внешний перелет (внутренняя информация из программы туров)
              }],
+
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
              "HotelTypes": [              {
+
**** '''SvKey''' – ключ типа услуги
                  "Key": 5,
+
**** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
                  "Value": "Рекомендуемые"
+
**** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
              }],
+
**** '''IsPartnerBasedOn''' – признак услуга с приоритетным подбором поставщика
              "Id": 1,
+
**** '''Day''' – день предоставления услуги
              "SvKey": 3,
+
**** '''DurationInNight''' – продолжительность услуги в ночах
              "IsSubCode1": true,
+
**** '''BeginDateTime''' – дата предоставления услуги
              "IsSubCode2": true,
+
**** '''IsHooded''' – признак скрытая услуга
              "IsPartnerBasedOn": false,
+
**** '''IsDeleted''' – признак удаляемая услуга
              "Day": 1,
+
**** '''IsNotCalculate''' – признак не рассчитываемая услуга
              "DurationInNight": 3,
+
**** '''PacketId''' – ключ пакета
              "BeginDateTime": "2018-02-25T12:00:00",
+
**** '''Index''' – порядковый номер услуги
              "EndDateTime": "2018-02-28T12:00:00",
+
*** '''NotRouteServices''' – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
              "IsHooded": false,
+
**** '''ServiceName''' – название типа услуги
              "IsDeleted": false,
+
**** '''City''' – объект город
              "IsNotCalculate": false,
+
***** '''Key''' – ключ города
              "PacketId": 779,
+
***** '''Value''' – название города
              "Index": 1
+
**** '''Country''' – объект страна
            },
+
***** '''Key''' – ключ страны
                        {
+
***** '''Value''' – название страны
              "DepartureCity":                {
+
**** '''Code''' – объект код услуги
                  "Key": 35,
+
***** '''Key''' – ключ услуги
                  "Value": "Вена"
+
***** '''Value''' – название услуги
              },
+
**** '''ByScheduler''' – флаг услуга по расписанию или нет
              "DepartureCountry":               {
+
**** '''Details''' – объект детализация услуги
                  "Key": 90,
+
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
                  "Value": "Австрия"
+
****** '''Key''' – ключ доп. описания 1
              },
+
****** '''Value''' – название доп. описания 1
              "ArrivalCity":                {
+
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
                  "Key": 1,
+
****** '''Key''' – ключ доп. описания 2
                  "Value": "Москва"
+
****** '''Value''' – название доп. описания 2
              },
+
***** '''Date''' – дата услуги
              "ArrivalCountry":                {
+
***** '''IsShowTransportPlan''' – признак показывать ли план рассадки (для автобусов)
                  "Key": 460,
+
***** '''Cost''' – цена
                  "Value": "Россия"
+
***** '''QuotaStatus''' – объект информация по квотам
              },
+
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
              "DepartureAirport":                {
+
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
                  "Key": "VIE1",
+
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
                  "Value": "Vena1"
+
***** '''PartnerId''' – идентификатор партнера
              },
+
***** '''ByPax''' – признак цены за человека
              "ArrivalAirport":                {
+
***** '''Partner''' – объект партнер (не заполняется)
                  "Key": "DME",
+
****** '''Key''' – ключ (не заполняется)
                  "Value": "Домодедово"
+
****** '''Value''' – название (не заполняется)
              },
+
**** '''ParentId''' – идентификатор родительской услуги (для вложенных услуг)
              "Airline":                {
+
**** '''PartnerBasedOnServiceTemplateId''' – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
                  "Key": "7U",
+
**** '''Id''' – идентификатор услуги
                  "Value": "Авиаэнерго"
+
**** '''SvKey''' – ключ типа услуги
              },
+
**** '''IsSubCode1''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
              "Aircraft":                {
+
**** '''IsSubCode2''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
                  "Key": "727",
+
**** '''IsPartnerBasedOn''' – услуга с подбором приоритетного поставщика услуги
                  "Value": "Boeing"
+
**** '''Day''' – день предоставления услуги
              },
+
**** '''DurationInNight''' – продолжительность услуги в ночах
              "Flight":                {
+
**** '''BeginDateTime''' – дата предоставления услуги
                  "Key": 774,
+
**** '''EndDateTime''' – дата окончания услуги
                  "Value": "222"
+
**** '''IsHooded''' – скрытая ли услуга
              },
+
**** '''IsDeleted''' – удаляемая ли услуга
              "DepartureTime": "00:00:00",
+
**** '''IsNotCalculate''' – не рассчитываемая ли услуга
              "ArrivalTime": "00:00:00",
+
**** '''PacketId''' – пакет услуги
              "EndDateTime": "2018-02-28T00:00:00",
+
**** '''Index''' – индекс услуги
              "FlightDetails": [              {
+
*** '''MinCostServicesComposition''' – массив состав услуг минимальной цены
                  "Tariff":                  {
+
**** '''Key''' – ключ
                    "Key": 89,
+
***** '''TemplateId''' – идентификатор шаблона
                    "Code": "Y",
+
***** '''PatternId''' – идентификатор вкладки
                    "Name": "Экономический класс"
+
***** '''SettingId''' – идентификатор услуги
                  },
+
**** '''Value''' – значение
                  "Cost": 0,
+
***** '''ServiceType''' – тип услуги
                  "QuotaStatus":                  {
+
***** '''Code''' – ключ услуги
                    "PlacesStatus": 4,
+
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
                    "FreePlaces": 0,
+
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
                    "IsFewPlaces": false
+
***** '''PacketId''' – пакет услуги
                  },
+
***** '''PartnerId''' – партнер услуги
                  "PartnerId": 10760,
+
***** '''CountryId''' – страна услуги
                  "ByPax": true,
+
***** '''CityId''' – город услуги
                  "Partner":                  {
+
***** '''Day''' – день предоставления услуги
                    "Key": 0,
+
***** '''DurationInNight''' – продолжительность услуги в ночах
                    "Value": null
+
**** '''COAndSpecialsInfo''' – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
                  }
+
***** '''AppliedCostOffersKeys''' – коллекция идентификаторов всех применённых ценовых блоков к одной цене             
              }],
+
***** '''AppliedSpeciasInfo''' – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
              "FlightSetting":                {
+
****** '''SpecialKey''' – ключ акции
                  "ServiceId": 4,
+
****** '''SpecialName''' – название акции
                  "PatternId": 5,
+
****** '''SpecialType''' – тип акции
                  "FlightId": 4
+
****** '''NewPrice''' – цена после применения акции
              },
+
****** '''OldPrice''' – цена до применения акции
              "FlightSourceMode": 1,
+
****** '''ShowOnline''' – нужно ли показывать акцию в поиске
              "Id": 4,
+
****** '''UntilDate''' – акция действует при совершении покупки до указанной даты
              "SvKey": 1,
+
****** '''Condition''' – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              "IsSubCode1": true,
+
******* ''NightsFrom'' (для типа ''PayStay'') – ночей от
              "IsSubCode2": false,
+
******* ''NightsTo'' (для типа ''PayStay'') – ночей до
              "IsPartnerBasedOn": false,
+
******* ''NightValue'' (для типа ''PayStay'') – значение ночи, которое соответствует заданному периоду
              "Day": 4,
+
******* ''OperationType'' (для типа ''PayStay'') – тип действия
              "DurationInNight": 0,
+
******* ''SpecialNightType'' (для типа ''PayStay'') – тип бесплатной ночи
              "BeginDateTime": "2018-02-28T00:00:00",
+
******* ''DurationFrom'' (для типа ''KickBack'') – ночей от
              "IsHooded": false,
+
******* ''DurationTo'' (для типа ''KickBack'') – ночей до
              "IsDeleted": false,
+
******* ''Value'' (для типа ''KickBack'') – значение продолжительности, равное заданному периоду
              "IsNotCalculate": false,
+
******* ''OperationType'' (для типа ''KickBack'') – тип действия
              "PacketId": 779,
+
******* ''NightsFrom'' (для типа ''EarlyBird'') – ночей от
              "Index": 4
+
******* ''NightsTo'' (для типа ''EarlyBird'') – ночей до
            }
+
******* ''Discount'' (для типа ''EarlyBird'') – размер скидки
        ],
+
******* ''OperationType'' (для типа ''EarlyBird'') – тип действия
        "NotRouteServices":          [
+
**** '''COBySubCode''' – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
            [            {
+
**** '''SpecialsBySubCode''' –  список применённых акций по SubCode1 и SubCode2
              "ServiceName": "страховка",
+
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
              "City": null,
+
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]             
              "Country": 6245,
+
*** '''FlightWeight''' –
              "Code":                {
+
*** '''LinkingFlightsRules''' – объект правил связывания
                  "Key": 297,
+
**** '''notCombineDifferentAirlineRule''' – объект не скрещивать авиакомпании
                  "Value": "Страховка от несчастного случая"
+
***** '''airlines''' – авиакомпании
              },
+
***** '''flightSettings''' – массив ключей ServiceId, PatternId, FlightId
              "ByScheduler": false,
+
***** '''enabled''' – флаг включен/выключен
              "Details": [              {
+
**** '''checkPlusMinus1CharterRule''' – объект Отличие номера рейса на 1
                  "SubCode1":                  {
+
***** '''FlightSettingPairs''' – массив чартеров, для которых это правило будет выполняться
                    "Key": 18,
+
***** '''enabled''' – флаг включен/выключен
                    "Value": "2"
+
**** '''notCombineDifferentTariffGroupRule''' – объект не комбинировать рейсы от разных классов перелетов
                  },
+
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
                  "SubCode2":                   {
+
***** '''enabled''' – флаг включен/выключен
                    "Key": null,
+
**** '''notCombineDifferentPartnerRule''' – объект не комбинировать рейсы от разных партнеров
                    "Value": ""
+
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
                  },
+
***** '''enabled''' – флаг включен/выключен
                  "Date": null,
+
**** '''departureCityEqualsArrivalCityRule''' – объект Город вылета = городу прилета
                  "IsShowTransportPlan": true,
+
***** '''FlightSettingPairs''' – чартеры, для которых это будет выполняться
                  "Cost": 16,
+
***** '''enabled''' – флаг включен/выключен
                  "QuotaStatus":                   {
+
**** '''combineOnlySpecificChartersRule''' – объект не комбинировать различные классы перелетов
                    "PlacesStatus": 1,
+
***** '''settings''' – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
                    "FreePlaces": 0,
+
***** '''enabled''' – флаг включен/выключен
                    "IsFewPlaces": false
+
*** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
                  },
+
** '''SecondaryFiltersResult''' – результаты доп. фильтров
                  "PartnerId": 12668,
+
*** '''TourTypes''' – типы тура
                  "ByPax": true,
+
**** '''Id''' – ключ типа тура
                  "Partner":                   {
+
**** '''Name''' – название типа тура
                    "Key": 0,
+
**** '''ParentId''' – родительский элемент типа тура (если есть)
                    "Value": null
+
**** '''Type''' – тип справочника (используется для внутренних целей)
                  }
+
*** '''TourPrograms''' – информация по каждой турпрограмме
              }],
+
**** '''Key''' – ключ турпрограммы
              "ParentId": null,
+
**** '''Name''' – название турпрограммы
              "PartnerBasedOnServiceTemplateId": null,
+
**** '''TourUrl''' – ссылка на тур
              "Id": 10,
+
**** '''BookingConditions''' – условия бронирования
              "SvKey": 6,
+
**** '''IsLandOnly''' – признак только наземное обслуживание
              "IsSubCode1": true,
+
**** '''IsRestrictMultiHotels''' – ограничивать ли расчёт многоотельных туров категориями отелей
              "IsSubCode2": true,
+
**** '''IsHotelTemplates''' – есть ли вообще отели в данной турпрограмме
              "IsPartnerBasedOn": false,
+
**** '''IsRouteServices''' – есть ли маршрутные услуги
              "Day": 1,
+
**** '''MultiHotelDelta''' – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
              "DurationInNight": 3,
+
**** '''Rate''' – валюта тура
              "BeginDateTime": "2018-02-25T00:00:00",
+
**** '''DateStart''' – нижняя граница дат заезда по программе тура
              "EndDateTime": "2018-02-28T00:00:00",
+
**** '''DateEnd''' – верхняя граница дат заеда по программе тура
              "IsHooded": false,
+
**** '''Status''' – статус турпрограммы
              "IsDeleted": true,
+
***** '''Key''' – ключ
              "IsNotCalculate": true,
+
***** '''Value''' – значение
              "PacketId": 882,
+
**** '''Templates''' – шаблоны услуг
              "Index": 2
+
***** '''$id''' – шаблон 1
            }],
+
***** '''$id''' – шаблон 2
            [            {
+
**** '''Types''' – типы тура
              "ServiceName": "экскурсия",
+
***** '''Id''' – ключ типа тура
              "City":                {
+
***** '''Name''' – название типа тура
                  "Key": 1046,
+
***** '''ParentId''' – родительский элемент типа тура (если есть)
                  "Value": "Санто-Доминго"
+
***** '''Type''' – тип справочника (используется для внутренних целей)
              },
+
**** '''LinkingFlightsRules''' – правила связывания перелетов
              "Country": 6245,
+
***** '''notCombineDifferentAirlineRule''' –
              "Code":                {
+
****** '''airlines''' –
                  "Key": 743,
+
****** '''flightSettings''' –
                  "Value": "4"
+
****** '''enabled''' –
              },
+
***** '''checkPlusMinus1CharterRule''' –
              "ByScheduler": false,
+
****** '''FlightSettingPairs''' –
              "Details": [              {
+
****** '''enabled''' –
                  "SubCode1":                  {
+
***** '''notCombineDifferentTariffGroupRule''' –
                    "Key": 37,
+
****** '''FlightSettings''' –
                    "Value": "Мини-автобус 10 чел."
+
****** '''enabled''' –
                  },
+
***** '''notCombineDifferentPartnerRule''' –
                  "SubCode2":                  {
+
****** '''FlightSettings''' –
                    "Key": null,
+
****** '''enabled''' –
                    "Value": ""
+
***** '''departureCityEqualsArrivalCityRule''' –
                  },
+
****** '''FlightSettingPairs''' –
                  "Date": null,
+
****** '''enabled''' –
                  "IsShowTransportPlan": false,
+
***** '''combineOnlySpecificChartersRule''' –
                  "Cost": 85.22,
+
****** '''settings''' –
                  "QuotaStatus":                  {
+
****** '''enabled''' –
                    "PlacesStatus": 1,
+
**** '''Type''' – тип справочника (используется для внутренних целей)
                    "FreePlaces": 0,
+
*** '''TourDurations''' – продолжительность тура
                    "IsFewPlaces": false
+
*** '''TourDates''' – список дат заездов в турпрограмме
                  },
+
**** '''HotelCities''' – город в дополнительных фильтрах
                  "PartnerId": 12667,
+
***** '''''' –
                  "ByPax": true,
+
**** '''HotelResorts''' – курорты в дополнительных фильтрах
                  "Partner":                  {
+
***** '''''' –
                    "Key": 0,
+
**** '''HotelCategories''' – категории отеля в дополнительных фильтрах
                    "Value": null
+
***** '''''' –
                  }
+
**** '''Hotels''' – отели в дополнительных фильтрах
              }],
+
***** '''''' –
              "ParentId": null,
+
**** '''Pansions''' – питания в дополнительных фильтрах
              "PartnerBasedOnServiceTemplateId": null,
+
***** '''''' –
              "Id": 7,
+
**** '''Airlines''' – авиакомпании в дополнительных фильтрах
              "SvKey": 4,
+
***** '''''' –
              "IsSubCode1": true,
+
**** '''FlightTariffs''' – класс перелета в дополнительных фильтрах
              "IsSubCode2": false,
+
***** '''''' –
              "IsPartnerBasedOn": true,
+
**** '''DepartureCities''' – города вылета в дополнительных фильтрах
              "Day": 1,
+
***** '''''' –
              "DurationInNight": 0,
+
**** '''DepartureAirports''' – аэропорты вылета в дополнительных фильтрах
              "BeginDateTime": "2018-02-25T00:00:00",
+
***** '''''' –
              "EndDateTime": "2018-02-26T00:00:00",
+
**** '''ArrivalCities''' – города прибытия в дополнительных фильтрах
              "IsHooded": false,
+
***** '''''' –
              "IsDeleted": true,
+
**** '''ArrivalAirports''' – аэропорты прибытия в дополнительных фильтрах
              "IsNotCalculate": true,
+
***** '''''' –
              "PacketId": 779,
+
**** '''HotelTypes''' – признаки отелей в дополнительных фильтрах
              "Index": 3
+
***** '''''' –
            }]
+
 
        ],
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
         "MinCostServicesComposition":          [
+
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода RegistrationClient/Search
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/RegistrationClient/Search?DepartureCityKeys=1&Dates=12.02.2021&Durations=9
 +
&PageNumber=1&PageSize=20&isFromBasket=false&isFillSecondaryFilters=true&DestinationType=1&DestinationKey=90
 +
&AdultCount=2&IsRegistrationClients=false&CurrencyName=EU&AviaQuota=7&HotelQuota=7&BusTransferQuota=7
 +
&TimeArrivalFrom=00:00&TimeArrivalTo=23:59&TimeDepartureFrom=00:00&TimeDepartureTo=23:59
 +
&ArrivalFlightNoTransfer=false&Tour=100006755&TourDuration=&DepartureFlightNoTransfer=false&HotelScheme=
 +
</syntaxhighlight>
 +
Возвращаемый результат метода RegistrationClient/Search (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
  "CheckMessages": null,
 +
  "Message":   {
 +
      "Key": 0,
 +
      "Value": null
 +
  },
 +
  "Result":   [
 +
            {
 +
        "Key": 100000004,
 +
        "Name": "Общая проверка системы",
 +
        "TourUrl": "www.megatec.ru",
 +
        "BookingConditions": "<p>Условия бронирования тура.<\/p>",
 +
        "StartDate": "2018-02-25T00:00:00",
 +
        "Duration": 4,
 +
        "DurationInNight": 3,
 +
        "Types": [2],
 +
        "Cost": 260,
 +
        "Rate": "EU",
 +
        "CityDepature":         {
 +
            "Key": 1,
 +
            "Value": "Москва"
 +
        },
 +
        "Country":               {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
},
 +
         "Services":          [
 
                         {
 
                         {
               "Key":                {
+
               "DepartureCity":                {
                   "TemplateId": 3,
+
                   "Key": 1,
                   "PatternId": 13,
+
                  "Value": "Москва"
                   "SettingId": 13
+
              },
 +
              "DepartureCountry":                {
 +
                   "Key": 460,
 +
                   "Value": "Россия"
 
               },
 
               },
               "Value":                {
+
               "ArrivalCity":                {
                   "ServiceType": 1,
+
                   "Key": 35,
                  "Code": 882,
+
                   "Value": "Вена"
                  "SubCode1": 89,
 
                  "SubCode2": 1,
 
                  "PacketId": 779,
 
                  "PartnerId": 12668,
 
                  "CountryId": 90,
 
                  "CityId": 35,
 
                   "Day": 1,
 
                  "DurationInNight": 0
 
              }
 
            },
 
                        {
 
              "Key":                {
 
                  "TemplateId": 1,
 
                  "PatternId": 0,
 
                  "SettingId": 0
 
 
               },
 
               },
               "Value":                {
+
               "ArrivalCountry":                {
                   "ServiceType": 3,
+
                  "Key": 90,
                   "Code": 709,
+
                  "Value": "Австрия"
                   "SubCode1": 46463,
+
              },
                   "SubCode2": 4,
+
              "DepartureAirport":                {
                   "PacketId": 779,
+
                   "Key": "SVO4",
                   "PartnerId": 12667,
+
                  "Value": "Шереметьево-24"
                   "CountryId": 90,
+
              },
                   "CityId": 35,
+
              "ArrivalAirport":               {
                   "Day": 1,
+
                  "Key": "VIE1",
                  "DurationInNight": 3
+
                  "Value": "Vena1"
               }
+
              },
 +
              "Airline":                {
 +
                  "Key": "BA7",
 +
                  "Value": "BRITISH  AIRWAYS"
 +
              },
 +
              "Aircraft":                {
 +
                  "Key": "319",
 +
                  "Value": "AIRBUS "
 +
              },
 +
              "Flight":                {
 +
                  "Key": 882,
 +
                   "Value": "4444"
 +
              },
 +
              "DepartureTime": "10:00:00",
 +
              "ArrivalTime": "12:00:00",
 +
              "EndDateTime": "2018-02-25T12:00:00",
 +
              "FlightDetails": [              {
 +
                  "Tariff":                  {
 +
                    "Key": 89,
 +
                    "Code": "Y",
 +
                    "Name": "Экономический класс"
 +
                  },
 +
                   "Cost": 10,
 +
                   "QuotaStatus":                  {
 +
                    "PlacesStatus": 4,
 +
                    "FreePlaces": 0,
 +
                    "IsFewPlaces": false
 +
                  },
 +
                   "PartnerId": 12668,
 +
                  "ByPax": true,
 +
                   "Partner":                  {
 +
                    "Key": 0,
 +
                    "Value": null
 +
                  }
 +
              }],
 +
              "FlightSetting":                {
 +
                   "ServiceId": 3,
 +
                   "PatternId": 13,
 +
                   "FlightId": 13
 +
              },
 +
              "FlightSourceMode": 1,
 +
              "Id": 3,
 +
              "SvKey": 1,
 +
              "IsSubCode1": true,
 +
              "IsSubCode2": false,
 +
              "IsPartnerBasedOn": false,
 +
              "Day": 1,
 +
              "DurationInNight": 0,
 +
              "BeginDateTime": "2018-02-25T10:00:00",
 +
              "IsHooded": false,
 +
              "IsDeleted": false,
 +
              "IsNotCalculate": false,
 +
              "PacketId": 779,
 +
               "Index": 0
 
             },
 
             },
 
                         {
 
                         {
               "Key":                {
+
               "Hotel":                {
                   "TemplateId": 4,
+
                  "Key": 709,
                   "PatternId": 5,
+
                  "Value": "Am Brilliantengrund"
                   "SettingId": 4
+
              },
 +
              "City":                {
 +
                  "Key": 35,
 +
                  "Value": "Вена"
 +
              },
 +
              "Stars":                {
 +
                  "Key": -1,
 +
                  "Value": null
 +
              },
 +
              "Resort":                {
 +
                   "Key": -1,
 +
                   "Value": null
 +
              },
 +
              "ImageURL": "",
 +
              "Http": null,
 +
              "Description": "",
 +
              "Country":                {
 +
                   "Key": 90,
 +
                  "Value": "Австрия"
 
               },
 
               },
               "Value":               {
+
               "HotelDetails": [              {
                   "ServiceType": 1,
+
                   "HotelRoom": 46463,
                   "Code": 774,
+
                   "Room":                  {
                   "SubCode1": 89,
+
                    "Key": 129,
                   "SubCode2": 35,
+
                    "Value": "DBL"
                  "PacketId": 779,
+
                  },
                   "PartnerId": 10760,
+
                   "RoomCategory":                   {
                  "CountryId": 460,
+
                    "Key": 3493,
                   "CityId": 1,
+
                    "Value": "Cosy"
                   "Day": 4,
+
                  },
                  "DurationInNight": 0
+
                   "AccomodationType":                   {
              }
+
                    "Key": 1256,
            }
+
                    "Value": "2+1_K",
        ],
+
                    "AdultCount": 2,
        "FlightWeight": 2,
+
                    "ChildCount": 1
        "LinkingFlightsRules":         {
+
                  },
            "notCombineDifferentAirlineRule":             {
+
                   "Pansion":                  {
              "airlines": ["AY2"],
+
                    "Key": 4,
               "flightSettings": [],
+
                    "Value": "Завтрак"
               "enabled": true
+
                  },
            },
+
                   "Cost": 19.47,
            "checkPlusMinus1CharterRule":             {
+
                   "QuotaStatus":                  {
               "FlightSettingPairs": [],
+
                    "PlacesStatus": 4,
               "enabled": false
+
                    "FreePlaces": 0,
            },
+
                    "IsFewPlaces": false
            "notCombineDifferentTariffGroupRule":             {
+
                  },
               "FlightSettings": [],
+
                  "PartnerId": 12667,
               "enabled": true
+
                  "ByPax": false,
            },
+
                  "Partner":                   {
            "notCombineDifferentPartnerRule":             {
+
                    "Key": 12667,
               "FlightSettings": [],
+
                    "Value": "Партнер-покупатель1"
               "enabled": false
+
                  }
 +
              }],
 +
               "HotelTypes": [               {
 +
                  "Key": 5,
 +
                  "Value": "Рекомендуемые"
 +
              }],
 +
               "Id": 1,
 +
              "SvKey": 3,
 +
              "IsSubCode1": true,
 +
               "IsSubCode2": true,
 +
               "IsPartnerBasedOn": false,
 +
              "Day": 1,
 +
              "DurationInNight": 3,
 +
              "BeginDateTime": "2018-02-25T12:00:00",
 +
               "EndDateTime": "2018-02-28T12:00:00",
 +
               "IsHooded": false,
 +
              "IsDeleted": false,
 +
              "IsNotCalculate": false,
 +
               "PacketId": 779,
 +
               "Index": 1
 
             },
 
             },
            "departureCityEqualsArrivalCityRule":            {
+
                        {
               "FlightSettingPairs": [],
+
               "DepartureCity":                {
               "enabled": false
+
                  "Key": 35,
            },
+
                  "Value": "Вена"
            "combineOnlySpecificChartersRule":            {
+
              },
              "settings": [],
+
              "DepartureCountry":               {
              "enabled": false
+
                  "Key": 90,
            }
+
                  "Value": "Австрия"
        },
+
               },
        "RouteSubVariants": []
+
               "ArrivalCity":                {
      }
+
                  "Key": 1,
  ],
+
                  "Value": "Москва"
  "SecondaryFiltersResult":   {
+
               },
      "TourTypes": [      {
+
               "ArrivalCountry":                {
        "Id": 2,
+
                   "Key": 460,
        "Name": "Стандартный тур",
+
                   "Value": "Россия"
        "ParentId": null,
 
        "Type": "TourType"
 
      }],
 
      "TourPrograms":      [
 
                      {
 
            "Key": 100000004,
 
            "Name": "Общая проверка системы",
 
            "TourUrl": "www.megatec.ru",
 
            "BookingConditions": "<p>Условия бронирования тура.<\/p>",
 
            "IsLandOnly": false,
 
            "IsRestrictMultiHotels": false,
 
            "IsHotelTemplates": true,
 
            "IsRouteServices": true,
 
            "MultiHotelDelta": 0,
 
            "Rate": "EU",
 
            "DateStart": "2018-01-30T00:00:00Z",
 
            "DateEnd": "2018-02-27T00:00:00Z",
 
            "Status":            {
 
              "Key": 3,
 
              "Value": "Доступен для продажи"
 
            },
 
            "Templates":            [
 
               {"$id": "5"},
 
               {"$id": "6"},
 
               {"$id": "7"},
 
              {"$id": "8"},
 
              {"$id": "9"}
 
            ],
 
            "Types": [            {
 
              "Id": 2,
 
               "Name": "Стандартный тур",
 
              "ParentId": null,
 
              "Type": "TourType"
 
            }],
 
            "LinkingFlightsRules":            {
 
               "notCombineDifferentAirlineRule":                {
 
                   "airlines": ["AY2"],
 
                   "flightSettings": [],
 
                  "enabled": true
 
 
               },
 
               },
               "checkPlusMinus1CharterRule":                {
+
               "DepartureAirport":                {
                   "FlightSettingPairs": [],
+
                   "Key": "VIE1",
                   "enabled": false
+
                   "Value": "Vena1"
 
               },
 
               },
               "notCombineDifferentTariffGroupRule":                {
+
               "ArrivalAirport":                {
                   "FlightSettings": [],
+
                   "Key": "DME",
                   "enabled": true
+
                   "Value": "Домодедово"
 
               },
 
               },
               "notCombineDifferentPartnerRule":                {
+
               "Airline":                {
                   "FlightSettings": [],
+
                   "Key": "7U",
                   "enabled": false
+
                   "Value": "Авиаэнерго"
 
               },
 
               },
               "departureCityEqualsArrivalCityRule":                {
+
               "Aircraft":                {
                   "FlightSettingPairs": [],
+
                   "Key": "727",
                   "enabled": false
+
                  "Value": "Boeing"
 +
              },
 +
              "Flight":                {
 +
                  "Key": 774,
 +
                  "Value": "222"
 +
              },
 +
              "DepartureTime": "00:00:00",
 +
              "ArrivalTime": "00:00:00",
 +
              "EndDateTime": "2018-02-28T00:00:00",
 +
              "FlightDetails": [               {
 +
                  "Tariff":                  {
 +
                    "Key": 89,
 +
                    "Code": "Y",
 +
                    "Name": "Экономический класс"
 +
                  },
 +
                  "Cost": 0,
 +
                  "QuotaStatus":                  {
 +
                    "PlacesStatus": 4,
 +
                    "FreePlaces": 0,
 +
                    "IsFewPlaces": false
 +
                  },
 +
                  "PartnerId": 10760,
 +
                  "ByPax": true,
 +
                  "Partner":                  {
 +
                    "Key": 0,
 +
                    "Value": null
 +
                  }
 +
              }],
 +
              "FlightSetting":                {
 +
                  "ServiceId": 4,
 +
                   "PatternId": 5,
 +
                  "FlightId": 4
 +
              },
 +
              "FlightSourceMode": 1,
 +
              "Id": 4,
 +
              "SvKey": 1,
 +
              "IsSubCode1": true,
 +
              "IsSubCode2": false,
 +
              "IsPartnerBasedOn": false,
 +
              "Day": 4,
 +
              "DurationInNight": 0,
 +
              "BeginDateTime": "2018-02-28T00:00:00",
 +
              "IsHooded": false,
 +
              "IsDeleted": false,
 +
              "IsNotCalculate": false,
 +
              "PacketId": 779,
 +
              "Index": 4
 +
            }
 +
        ],
 +
        "NotRouteServices":          [
 +
            [            {
 +
              "ServiceName": "страховка",
 +
              "City": null,
 +
              "Country": 6245,
 +
              "Code":                {
 +
                  "Key": 297,
 +
                  "Value": "Страховка от несчастного случая"
 +
              },
 +
              "ByScheduler": false,
 +
              "Details": [              {
 +
                  "SubCode1":                  {
 +
                    "Key": 18,
 +
                    "Value": "2"
 +
                  },
 +
                  "SubCode2":                  {
 +
                    "Key": null,
 +
                    "Value": ""
 +
                  },
 +
                  "Date": null,
 +
                  "IsShowTransportPlan": true,
 +
                  "Cost": 16,
 +
                  "QuotaStatus":                  {
 +
                    "PlacesStatus": 1,
 +
                    "FreePlaces": 0,
 +
                    "IsFewPlaces": false
 +
                  },
 +
                  "PartnerId": 12668,
 +
                  "ByPax": true,
 +
                  "Partner":                  {
 +
                    "Key": 0,
 +
                    "Value": null
 +
                  }
 +
              }],
 +
              "ParentId": null,
 +
              "PartnerBasedOnServiceTemplateId": null,
 +
              "Id": 10,
 +
              "SvKey": 6,
 +
              "IsSubCode1": true,
 +
              "IsSubCode2": true,
 +
              "IsPartnerBasedOn": false,
 +
              "Day": 1,
 +
              "DurationInNight": 3,
 +
              "BeginDateTime": "2018-02-25T00:00:00",
 +
              "EndDateTime": "2018-02-28T00:00:00",
 +
              "IsHooded": false,
 +
              "IsDeleted": true,
 +
              "IsNotCalculate": true,
 +
              "PacketId": 882,
 +
              "Index": 2
 +
            }],
 +
            [            {
 +
              "ServiceName": "экскурсия",
 +
              "City":                {
 +
                  "Key": 1046,
 +
                  "Value": "Санто-Доминго"
 
               },
 
               },
              "combineOnlySpecificChartersRule":                {
 
                  "settings": [],
 
                  "enabled": false
 
              }
 
            },
 
            "XmlSettings": "информация о туре в формате xml",
 
            "Type": "TourProgram"
 
        }
 
      ],
 
      "TourDurations": [4],
 
      "TourDates": ["2018-02-25T00:00:00"],
 
      "HotelCities": [      {
 
        "key": 35,
 
        "Country":          {
 
            "key": 90,
 
            "name": "Австрия",
 
            "Code": "AUS",
 
            "CitizenName": "Австрия",
 
            "CitizenNameLat": "AUSTRIA",
 
            "PassportMinDurCheckFrom": 0,
 
            "CheckINN": false,
 
            "PassportMinDur": null,
 
            "INNName": "ИНН",
 
            "Web": 1,
 
            "WebImage": "/pics/animate/austria.gif",
 
            "WebHTTP": "",
 
            "AnkLang": 0,
 
            "Type": "Country"
 
        },
 
        "name": "Вена",
 
        "Code": "VIE",
 
        "Web": 0,
 
        "RSKey": 0,
 
        "WebImage": null,
 
        "IsDeparture": 1,
 
        "Type": "City"
 
      }],
 
      "HotelResorts": [      {
 
        "Key": -1,
 
        "CountryKey": 0,
 
        "Name": "Не указан",
 
        "NameLat": null,
 
        "Type": "Resort"
 
      }],
 
      "HotelCategories":      [
 
                  {
 
            "Key": 23,
 
            "Name": "1*",
 
            "PrintNumber": 1,
 
            "Type": "HotelCatigory"
 
        },
 
                  {
 
            "Key": 56,
 
            "Name": "2*",
 
            "PrintNumber": 2,
 
            "Type": "HotelCatigory"
 
        },
 
                  {
 
            "Key": 66,
 
            "Name": "4*Boutique",
 
            "PrintNumber": null,
 
            "Type": "HotelCatigory"
 
        }
 
      ],
 
      "Hotels":      [
 
                  {
 
            "Key": 705,
 
            "Country":            {
 
              "key": 90,
 
              "name": "Австрия",
 
              "Code": "AUS",
 
              "CitizenName": "Австрия",
 
              "CitizenNameLat": "AUSTRIA",
 
              "PassportMinDurCheckFrom": 0,
 
              "CheckINN": false,
 
              "PassportMinDur": null,
 
              "INNName": "ИНН",
 
              "Web": 1,
 
              "WebImage": "/pics/animate/austria.gif",
 
              "WebHTTP": "",
 
              "AnkLang": 0,
 
              "Type": "Country"
 
            },
 
            "City":            {
 
              "key": 35,
 
 
               "Country":                {
 
               "Country":                {
                   "key": 90,
+
                   "Key": 6245,
                   "name": "Австрия",
+
                   "Value": "Испания"
                  "Code": "AUS",
+
},
                  "CitizenName": "Австрия",
+
              "Code":               {
                  "CitizenNameLat": "AUSTRIA",
+
                   "Key": 743,
                  "PassportMinDurCheckFrom": 0,
+
                   "Value": "4"
                  "CheckINN": false,
 
                  "PassportMinDur": null,
 
                  "INNName": "ИНН",
 
                  "Web": 1,
 
                  "WebImage": "/pics/animate/austria.gif",
 
                  "WebHTTP": "",
 
                   "AnkLang": 0,
 
                   "Type": "Country"
 
 
               },
 
               },
               "name": "Вена",
+
               "ByScheduler": false,
               "Code": "VIE",
+
              "Details": [              {
               "Web": 0,
+
                  "SubCode1":                  {
               "RSKey": 0,
+
                    "Key": 37,
               "WebImage": null,
+
                    "Value": "Мини-автобус 10 чел."
               "IsDeparture": 1,
+
                  },
              "Type": "City"
+
                  "SubCode2":                  {
 +
                    "Key": null,
 +
                    "Value": ""
 +
                  },
 +
                  "Date": null,
 +
                  "IsShowTransportPlan": false,
 +
                  "Cost": 85.22,
 +
                  "QuotaStatus":                  {
 +
                    "PlacesStatus": 1,
 +
                    "FreePlaces": 0,
 +
                    "IsFewPlaces": false
 +
                  },
 +
                  "PartnerId": 12667,
 +
                  "ByPax": true,
 +
                  "Partner":                  {
 +
                    "Key": 0,
 +
                    "Value": null
 +
                  }
 +
              }],
 +
               "ParentId": null,
 +
              "PartnerBasedOnServiceTemplateId": null,
 +
              "Id": 7,
 +
              "SvKey": 4,
 +
              "IsSubCode1": true,
 +
              "IsSubCode2": false,
 +
              "IsPartnerBasedOn": true,
 +
               "Day": 1,
 +
              "DurationInNight": 0,
 +
               "BeginDateTime": "2018-02-25T00:00:00",
 +
              "EndDateTime": "2018-02-26T00:00:00",
 +
              "IsHooded": false,
 +
              "IsDeleted": true,
 +
              "IsNotCalculate": true,
 +
              "PacketId": 779,
 +
              "Index": 3
 +
            }]
 +
        ],
 +
        "MinCostServicesComposition":          [
 +
                        {
 +
              "Key":               {
 +
                  "TemplateId": 3,
 +
                  "PatternId": 13,
 +
                  "SettingId": 13
 +
              },
 +
               "Value":                {
 +
                  "ServiceType": 1,
 +
                  "Code": 882,
 +
                  "SubCode1": 89,
 +
                  "SubCode2": 1,
 +
                  "PacketId": 779,
 +
                  "PartnerId": 12668,
 +
                  "CountryId": 90,
 +
                  "CityId": 35,
 +
                  "Day": 1,
 +
                  "DurationInNight": 0
 +
              }
 
             },
 
             },
            "Resort": null,
+
                        {
            "Name": "Continental",
+
              "Key":                {
            "Category":             {
+
                  "TemplateId": 1,
              "Key": 23,
+
                  "PatternId": 0,
              "Name": "1*",
+
                  "SettingId": 0
              "PrintNumber": 1,
+
              },
              "Type": "HotelCatigory"
+
              "Value":               {
 +
                  "ServiceType": 3,
 +
                  "Code": 709,
 +
                  "SubCode1": 46463,
 +
                  "SubCode2": 4,
 +
                  "PacketId": 779,
 +
                  "PartnerId": 12667,
 +
                  "CountryId": 90,
 +
                  "CityId": 35,
 +
                  "Day": 1,
 +
                  "DurationInNight": 3
 +
              }
 
             },
 
             },
            "TimeFrom": null,
+
                        {
            "TimeTo": null,
+
              "Key":               {
            "HTTP": null,
+
                  "TemplateId": 4,
            "Stars": "1*",
+
                  "PatternId": 5,
            "TimeIsEmpty": true,
+
                  "SettingId": 4
            "NameLat": "Continental",
+
              },
            "Address": null,
+
              "Value":               {
            "IsCruise": 0,
+
                  "ServiceType": 1,
            "Phone": null,
+
                  "Code": 774,
            "Code": null,
+
                  "SubCode1": 89,
            "Type": "Hotel"
+
                   "SubCode2": 35,
        },
+
                  "PacketId": 779,
                   {
+
                  "PartnerId": 10760,
            "Key": 178,
+
                  "CountryId": 460,
            "Country":             {
+
                  "CityId": 1,
              "key": 90,
+
                  "Day": 4,
              "name": "Австрия",
+
                  "DurationInNight": 0
              "Code": "AUS",
+
               }
              "CitizenName": "Австрия",
+
            }
              "CitizenNameLat": "AUSTRIA",
+
        ],
              "PassportMinDurCheckFrom": 0,
+
        "FlightWeight": 2,
               "CheckINN": false,
+
        "LinkingFlightsRules":         {
              "PassportMinDur": null,
+
            "notCombineDifferentAirlineRule":             {
              "INNName": "ИНН",
+
               "airlines": ["AY2"],
              "Web": 1,
+
               "flightSettings": [],
              "WebImage": "/pics/animate/austria.gif",
+
               "enabled": true
               "WebHTTP": "",
+
             },
               "AnkLang": 0,
+
             "checkPlusMinus1CharterRule":            {
               "Type": "Country"
+
               "FlightSettingPairs": [],
             },
+
               "enabled": false
             "City":            {
+
            },
               "key": 35,
+
            "notCombineDifferentTariffGroupRule":             {
               "Country":                {
+
               "FlightSettings": [],
                  "key": 90,
+
               "enabled": true
                  "name": "Австрия",
+
            },
                  "Code": "AUS",
+
            "notCombineDifferentPartnerRule":             {
                  "CitizenName": "Австрия",
+
               "FlightSettings": [],
                  "CitizenNameLat": "AUSTRIA",
+
               "enabled": false
                  "PassportMinDurCheckFrom": 0,
 
                  "CheckINN": false,
 
                  "PassportMinDur": null,
 
                  "INNName": "ИНН",
 
                  "Web": 1,
 
                  "WebImage": "/pics/animate/austria.gif",
 
                  "WebHTTP": "",
 
                  "AnkLang": 0,
 
                  "Type": "Country"
 
              },
 
              "name": "Вена",
 
               "Code": "VIE",
 
               "Web": 0,
 
              "RSKey": 0,
 
              "WebImage": null,
 
               "IsDeparture": 1,
 
               "Type": "City"
 
 
             },
 
             },
             "Resort": null,
+
             "departureCityEqualsArrivalCityRule":            {
            "Name": "Ananas",
+
               "FlightSettingPairs": [],
            "Category":            {
+
               "enabled": false
               "Key": 56,
 
              "Name": "2*",
 
               "PrintNumber": 2,
 
              "Type": "HotelCatigory"
 
 
             },
 
             },
             "TimeFrom": "1900-01-01T11:00:00",
+
             "combineOnlySpecificChartersRule":            {
             "TimeTo": "1900-01-01T12:00:00",
+
              "settings": [],
            "HTTP": "http://booking.panteon.ru/TourPrograms/Home/Tour/?tourKey=100000007",
+
              "enabled": false
            "Stars": "2*",
+
             }
            "TimeIsEmpty": false,
 
             "NameLat": "Ananas",
 
            "Address": null,
 
            "IsCruise": 0,
 
            "Phone": "(+43/1) 546200",
 
            "Code": null,
 
            "Type": "Hotel"
 
 
         },
 
         },
                  {
+
        "RouteSubVariants": []
            "Key": 707,
+
      }
            "Country":             {
+
  ],
              "key": 90,
+
  "SecondaryFiltersResult":    {
              "name": "Австрия",
+
      "TourTypes": [      {
              "Code": "AUS",
+
        "Id": 2,
              "CitizenName": "Австрия",
+
        "Name": "Стандартный тур",
              "CitizenNameLat": "AUSTRIA",
+
        "ParentId": null,
              "PassportMinDurCheckFrom": 0,
+
        "Type": "TourType"
              "CheckINN": false,
+
      }],
              "PassportMinDur": null,
+
      "TourPrograms":       [
              "INNName": "ИНН",
+
                      {
              "Web": 1,
+
            "Key": 100000004,
              "WebImage": "/pics/animate/austria.gif",
+
            "Name": "Общая проверка системы",
              "WebHTTP": "",
+
            "TourUrl": "www.megatec.ru",
               "AnkLang": 0,
+
            "BookingConditions": "<p>Условия бронирования тура.<\/p>",
               "Type": "Country"
+
            "IsLandOnly": false,
 +
            "IsRestrictMultiHotels": false,
 +
            "IsHotelTemplates": true,
 +
            "IsRouteServices": true,
 +
            "MultiHotelDelta": 0,
 +
            "Rate": "EU",
 +
            "DateStart": "2018-01-30T00:00:00Z",
 +
            "DateEnd": "2018-02-27T00:00:00Z",
 +
            "Status":            {
 +
               "Key": 3,
 +
               "Value": "Доступен для продажи"
 
             },
 
             },
             "City":            {
+
             "Templates":            [
               "key": 35,
+
              {"$id": "5"},
               "Country":                {
+
               {"$id": "6"},
                  "key": 90,
+
               {"$id": "7"},
                  "name": "Австрия",
+
               {"$id": "8"},
                  "Code": "AUS",
+
              {"$id": "9"}
                  "CitizenName": "Австрия",
+
            ],
                   "CitizenNameLat": "AUSTRIA",
+
            "Types": [            {
                   "PassportMinDurCheckFrom": 0,
+
              "Id": 2,
                   "CheckINN": false,
+
              "Name": "Стандартный тур",
                   "PassportMinDur": null,
+
              "ParentId": null,
                   "INNName": "ИНН",
+
              "Type": "TourType"
                   "Web": 1,
+
            }],
                  "WebImage": "/pics/animate/austria.gif",
+
            "LinkingFlightsRules":            {
                   "WebHTTP": "",
+
              "notCombineDifferentAirlineRule":                {
                   "AnkLang": 0,
+
                   "airlines": ["AY2"],
                   "Type": "Country"
+
                   "flightSettings": [],
 +
                   "enabled": true
 +
              },
 +
              "checkPlusMinus1CharterRule":                {
 +
                   "FlightSettingPairs": [],
 +
                   "enabled": false
 +
              },
 +
              "notCombineDifferentTariffGroupRule":                {
 +
                  "FlightSettings": [],
 +
                   "enabled": true
 +
              },
 +
              "notCombineDifferentPartnerRule":               {
 +
                  "FlightSettings": [],
 +
                   "enabled": false
 +
              },
 +
              "departureCityEqualsArrivalCityRule":                {
 +
                   "FlightSettingPairs": [],
 +
                   "enabled": false
 
               },
 
               },
               "name": "Вена",
+
               "combineOnlySpecificChartersRule":                {
              "Code": "VIE",
+
                  "settings": [],
              "Web": 0,
+
                  "enabled": false
               "RSKey": 0,
+
               }
              "WebImage": null,
 
              "IsDeparture": 1,
 
               "Type": "City"
 
 
             },
 
             },
             "Resort": null,
+
             "Type": "TourProgram"
             "Name": "Beim Theresianum",
+
        }
             "Category":            {
+
      ],
              "Key": 66,
+
      "TourDurations": [4],
              "Name": "4*Boutique",
+
      "TourDates": ["2018-02-25T00:00:00"],
              "PrintNumber": null,
+
      "HotelCities": [      {
              "Type": "HotelCatigory"
+
        "key": 35,
             },
+
        "Country":          {
             "TimeFrom": null,
+
            "key": 90,
             "TimeTo": null,
+
             "name": "Австрия",
            "HTTP": null,
+
             "Code": "AUS",
            "Stars": "4*Boutique",
+
             "CitizenName": "Австрия",
             "TimeIsEmpty": true,
+
            "CitizenNameLat": "AUSTRIA",
             "NameLat": "Beim Theresianum",
+
            "PassportMinDurCheckFrom": 0,
             "Address": null,
+
            "CheckINN": false,
             "IsCruise": 0,
+
            "PassportMinDur": null,
             "Phone": null,
+
            "INNName": "ИНН",
             "Code": null,
+
            "Web": 1,
             "Type": "Hotel"
+
            "WebImage": "/pics/animate/austria.gif",
 +
             "WebHTTP": "",
 +
             "AnkLang": 0,
 +
             "Type": "Country"
 +
        },
 +
        "name": "Вена",
 +
        "Code": "VIE",
 +
        "Web": 0,
 +
        "RSKey": 0,
 +
        "WebImage": null,
 +
        "IsDeparture": 1,
 +
        "Type": "City"
 +
      }],
 +
      "HotelResorts": [      {
 +
        "Key": -1,
 +
        "CountryKey": 0,
 +
        "Name": "Не указан",
 +
        "NameLat": null,
 +
        "Type": "Resort"
 +
      }],
 +
      "HotelCategories":      [
 +
                  {
 +
             "Key": 23,
 +
             "Name": "1*",
 +
             "PrintNumber": 1,
 +
             "Type": "HotelCatigory"
 +
        },
 +
                  {
 +
            "Key": 56,
 +
             "Name": "2*",
 +
             "PrintNumber": 2,
 +
             "Type": "HotelCatigory"
 
         },
 
         },
 
                   {
 
                   {
             "Key": 709,
+
             "Key": 66,
 +
            "Name": "4*Boutique",
 +
            "PrintNumber": null,
 +
            "Type": "HotelCatigory"
 +
        }
 +
      ],
 +
      "Hotels":      [
 +
                  {
 +
            "Key": 705,
 
             "Country":            {
 
             "Country":            {
 
               "key": 90,
 
               "key": 90,
Строка 10 432: Строка 11 355:
 
             },
 
             },
 
             "Resort": null,
 
             "Resort": null,
             "Name": "Am Brilliantengrund",
+
             "Name": "Continental",
             "Category": null,
+
             "Category":             {
 +
              "Key": 23,
 +
              "Name": "1*",
 +
              "PrintNumber": 1,
 +
              "Type": "HotelCatigory"
 +
            },
 
             "TimeFrom": null,
 
             "TimeFrom": null,
 
             "TimeTo": null,
 
             "TimeTo": null,
 
             "HTTP": null,
 
             "HTTP": null,
             "Stars": "",
+
             "Stars": "1*",
 
             "TimeIsEmpty": true,
 
             "TimeIsEmpty": true,
             "NameLat": "Am Brilliantengrund",
+
             "NameLat": "Continental",
 
             "Address": null,
 
             "Address": null,
 
             "IsCruise": 0,
 
             "IsCruise": 0,
Строка 10 445: Строка 11 373:
 
             "Code": null,
 
             "Code": null,
 
             "Type": "Hotel"
 
             "Type": "Hotel"
        }
 
      ],
 
      "Pansions":      [
 
                  {
 
            "Key": 46,
 
            "Code": "RO",
 
            "Name": "RO",
 
            "NameLat": null,
 
            "Type": "Pansion"
 
 
         },
 
         },
 
                   {
 
                   {
             "Key": 4,
+
             "Key": 178,
             "Code": "BB2",
+
             "Country":            {
             "Name": "Завтрак",
+
              "key": 90,
             "NameLat": null,
+
              "name": "Австрия",
             "Type": "Pansion"
+
              "Code": "AUS",
 +
              "CitizenName": "Австрия",
 +
              "CitizenNameLat": "AUSTRIA",
 +
              "PassportMinDurCheckFrom": 0,
 +
              "CheckINN": false,
 +
              "PassportMinDur": null,
 +
              "INNName": "ИНН",
 +
              "Web": 1,
 +
              "WebImage": "/pics/animate/austria.gif",
 +
              "WebHTTP": "",
 +
              "AnkLang": 0,
 +
              "Type": "Country"
 +
            },
 +
             "City":            {
 +
              "key": 35,
 +
              "Country":                {
 +
                  "key": 90,
 +
                  "name": "Австрия",
 +
                  "Code": "AUS",
 +
                  "CitizenName": "Австрия",
 +
                  "CitizenNameLat": "AUSTRIA",
 +
                  "PassportMinDurCheckFrom": 0,
 +
                  "CheckINN": false,
 +
                  "PassportMinDur": null,
 +
                  "INNName": "ИНН",
 +
                  "Web": 1,
 +
                  "WebImage": "/pics/animate/austria.gif",
 +
                  "WebHTTP": "",
 +
                  "AnkLang": 0,
 +
                  "Type": "Country"
 +
              },
 +
              "name": "Вена",
 +
              "Code": "VIE",
 +
              "Web": 0,
 +
              "RSKey": 0,
 +
              "WebImage": null,
 +
              "IsDeparture": 1,
 +
              "Type": "City"
 +
            },
 +
            "Resort": null,
 +
            "Name": "Ananas",
 +
            "Category":            {
 +
              "Key": 56,
 +
              "Name": "2*",
 +
              "PrintNumber": 2,
 +
              "Type": "HotelCatigory"
 +
            },
 +
            "TimeFrom": "1900-01-01T11:00:00",
 +
            "TimeTo": "1900-01-01T12:00:00",
 +
            "HTTP": "http://booking.panteon.ru/TourPrograms/Home/Tour/?tourKey=100000007",
 +
            "Stars": "2*",
 +
            "TimeIsEmpty": false,
 +
             "NameLat": "Ananas",
 +
            "Address": null,
 +
            "IsCruise": 0,
 +
            "Phone": "(+43/1) 546200",
 +
            "Code": null,
 +
             "Type": "Hotel"
 
         },
 
         },
 
                   {
 
                   {
             "Key": 2,
+
             "Key": 707,
             "Code": "HB",
+
             "Country":            {
             "Name": "Полупансион",
+
              "key": 90,
             "NameLat": null,
+
              "name": "Австрия",
            "Type": "Pansion"
+
              "Code": "AUS",
        }
+
              "CitizenName": "Австрия",
      ],
+
              "CitizenNameLat": "AUSTRIA",
      "Airlines":       [
+
              "PassportMinDurCheckFrom": 0,
 +
              "CheckINN": false,
 +
              "PassportMinDur": null,
 +
              "INNName": "ИНН",
 +
              "Web": 1,
 +
              "WebImage": "/pics/animate/austria.gif",
 +
              "WebHTTP": "",
 +
              "AnkLang": 0,
 +
              "Type": "Country"
 +
            },
 +
            "City":            {
 +
              "key": 35,
 +
              "Country":                {
 +
                  "key": 90,
 +
                  "name": "Австрия",
 +
                  "Code": "AUS",
 +
                  "CitizenName": "Австрия",
 +
                  "CitizenNameLat": "AUSTRIA",
 +
                  "PassportMinDurCheckFrom": 0,
 +
                  "CheckINN": false,
 +
                  "PassportMinDur": null,
 +
                  "INNName": "ИНН",
 +
                  "Web": 1,
 +
                  "WebImage": "/pics/animate/austria.gif",
 +
                  "WebHTTP": "",
 +
                  "AnkLang": 0,
 +
                  "Type": "Country"
 +
              },
 +
              "name": "Вена",
 +
              "Code": "VIE",
 +
              "Web": 0,
 +
              "RSKey": 0,
 +
              "WebImage": null,
 +
              "IsDeparture": 1,
 +
              "Type": "City"
 +
            },
 +
            "Resort": null,
 +
             "Name": "Beim Theresianum",
 +
             "Category":            {
 +
              "Key": 66,
 +
              "Name": "4*Boutique",
 +
              "PrintNumber": null,
 +
              "Type": "HotelCatigory"
 +
            },
 +
            "TimeFrom": null,
 +
            "TimeTo": null,
 +
            "HTTP": null,
 +
            "Stars": "4*Boutique",
 +
            "TimeIsEmpty": true,
 +
            "NameLat": "Beim Theresianum",
 +
            "Address": null,
 +
            "IsCruise": 0,
 +
            "Phone": null,
 +
            "Code": null,
 +
            "Type": "Hotel"
 +
        },
 
                   {
 
                   {
             "Key": 8,
+
            "Key": 709,
             "Code": "BA7",
+
            "Country":            {
             "Name": "BRITISH  AIRWAYS",
+
              "key": 90,
             "NameLat": "en_BRITISH  AIRWAYS",
+
              "name": "Австрия",
             "Type": "AirLine"
+
              "Code": "AUS",
         },
+
              "CitizenName": "Австрия",
                   {
+
              "CitizenNameLat": "AUSTRIA",
             "Key": 3,
+
              "PassportMinDurCheckFrom": 0,
             "Code": "7U",
+
              "CheckINN": false,
             "Name": "Авиаэнерго",
+
              "PassportMinDur": null,
             "NameLat": "en_Авиаэнерго",
+
              "INNName": "ИНН",
             "Type": "AirLine"
+
              "Web": 1,
 +
              "WebImage": "/pics/animate/austria.gif",
 +
              "WebHTTP": "",
 +
              "AnkLang": 0,
 +
              "Type": "Country"
 +
            },
 +
            "City":            {
 +
              "key": 35,
 +
              "Country":                {
 +
                  "key": 90,
 +
                  "name": "Австрия",
 +
                  "Code": "AUS",
 +
                  "CitizenName": "Австрия",
 +
                  "CitizenNameLat": "AUSTRIA",
 +
                  "PassportMinDurCheckFrom": 0,
 +
                  "CheckINN": false,
 +
                  "PassportMinDur": null,
 +
                  "INNName": "ИНН",
 +
                  "Web": 1,
 +
                  "WebImage": "/pics/animate/austria.gif",
 +
                  "WebHTTP": "",
 +
                  "AnkLang": 0,
 +
                  "Type": "Country"
 +
              },
 +
              "name": "Вена",
 +
              "Code": "VIE",
 +
              "Web": 0,
 +
              "RSKey": 0,
 +
              "WebImage": null,
 +
              "IsDeparture": 1,
 +
              "Type": "City"
 +
            },
 +
            "Resort": null,
 +
            "Name": "Am Brilliantengrund",
 +
            "Category": null,
 +
            "TimeFrom": null,
 +
            "TimeTo": null,
 +
            "HTTP": null,
 +
            "Stars": "",
 +
            "TimeIsEmpty": true,
 +
            "NameLat": "Am Brilliantengrund",
 +
            "Address": null,
 +
            "IsCruise": 0,
 +
            "Phone": null,
 +
            "Code": null,
 +
            "Type": "Hotel"
 +
        }
 +
      ],
 +
      "Pansions":      [
 +
                  {
 +
            "Key": 46,
 +
            "Code": "RO",
 +
            "Name": "RO",
 +
            "NameLat": null,
 +
            "Type": "Pansion"
 +
        },
 +
                  {
 +
            "Key": 4,
 +
            "Code": "BB2",
 +
            "Name": "Завтрак",
 +
            "NameLat": null,
 +
            "Type": "Pansion"
 +
        },
 +
                  {
 +
            "Key": 2,
 +
            "Code": "HB",
 +
            "Name": "Полупансион",
 +
            "NameLat": null,
 +
            "Type": "Pansion"
 +
        }
 +
      ],
 +
      "Airlines":      [
 +
                  {
 +
             "Key": 8,
 +
             "Code": "BA7",
 +
             "Name": "BRITISH  AIRWAYS",
 +
             "NameLat": "en_BRITISH  AIRWAYS",
 +
             "Type": "AirLine"
 +
         },
 +
                   {
 +
             "Key": 3,
 +
             "Code": "7U",
 +
             "Name": "Авиаэнерго",
 +
             "NameLat": "en_Авиаэнерго",
 +
             "Type": "AirLine"
 
         }
 
         }
 
       ],
 
       ],
Строка 10 588: Строка 11 703:
  
 
===Поиск туров онлайн (TourForWeb)===
 
===Поиск туров онлайн (TourForWeb)===
Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены. В зависимости от параметров запроса, дополнительных фильтров формат запроса имеет отличия.
+
Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены. В зависимости от параметров запроса, дополнительных фильтров формат запроса имеет отличия. Метод используется  при работе веб-приложения Canary.
 
* Обычный формат запроса GET:
 
* Обычный формат запроса GET:
 
** GET .../TourSearchOwin/TourForWeb/search/simple?
 
** GET .../TourSearchOwin/TourForWeb/search/simple?
Строка 10 602: Строка 11 717:
 
** '''ShowToursWithoutHotels''' – показывать ли туры без проживания
 
** '''ShowToursWithoutHotels''' – показывать ли туры без проживания
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (true/false)
+
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых
Строка 10 818: Строка 11 933:
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''QuotaStatus''' – информация о квоте
 
***** '''QuotaStatus''' – информация о квоте
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 10 953: Строка 12 068:
 
***** '''settings''' – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
 
***** '''settings''' – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
 
***** '''enabled''' – флаг включен/выключен
 
***** '''enabled''' – флаг включен/выключен
**** '''XmlSettings''' – строка xml для актуальных фильтров
 
 
**** '''IsMultiHotel''' –  
 
**** '''IsMultiHotel''' –  
 
**** '''Type''' – тип справочника (используется для внутренних целей)
 
**** '''Type''' – тип справочника (используется для внутренних целей)
Строка 11 699: Строка 12 813:
 
           }
 
           }
 
         },
 
         },
        "XmlSettings": "<TourProgram xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"><Key>0</Key>
 
<TourSettingsViewModel><TourName>EFREHolland</TourName><ManagerKey>106</ManagerKey><TourTypes><int>45</int></TourTypes><DateBegin>2021-08-01T00:00:00Z
 
</DateBegin><DateEnd>2021-12-31T00:00:00Z</DateEnd><DateList /><IsLandOnly>false</IsLandOnly><IsApplyMarginAddCostToRemoteService>true<
 
/IsApplyMarginAddCostToRemoteService><IsRestrictMultiHotels>false</IsRestrictMultiHotels><MultiHotelDelta>0</MultiHotelDelta><Rate>рб
 
</Rate><IsAction>false</IsAction><TourLeadDepartment>0</TourLeadDepartment><DepartureCities><int>312</int></DepartureCities><DepartureCountries />
 
<DefaultManagers /><Branches /><DetermineTheBranchOnCity>false</DetermineTheBranchOnCity></TourSettingsViewModel><TourConsistencyViewModel>
 
<ArrivalCities><int>62</int></ArrivalCities><Countries><int>1</int></Countries><ServiceTemplates><ServiceTemplate><Id>1</Id><SvKey>1</SvKey>
 
<FlightData><FlightGroupId>31</FlightGroupId><FlightGroups><FlightGroup><Id>30</Id><Name>перелет 2</Name><FlightId>31</FlightId><Flights>
 
<Flight><Id>30</Id><Name>Рейс_0</Name><SelectedPacket><Key>1462</Key><Value>EfremovTest</Value></SelectedPacket><SelectedPartners><IntStringElement>
 
<Key>12685</Key><Value> ПКЦ</Value></IntStringElement></SelectedPartners><PartnersShowAll>false</PartnersShowAll><SelectedDepartureCountries>
 
<IntStringElement><Key>460</Key><Value>Россия</Value></IntStringElement></SelectedDepartureCountries><DepartureCountriesShowAll>false</DepartureCountriesShowAll>
 
<SelectedDepartureCities><IntStringElement><Key>312</Key><Value>Астрахань</Value></IntStringElement></SelectedDepartureCities>
 
<DepartureCitiesShowAll>false</DepartureCitiesShowAll><SelectedArrivalCountries><IntStringElement><Key>1</Key><Value>Голландия</Value>
 
</IntStringElement></SelectedArrivalCountries><ArrivalCountriesShowAll>false</ArrivalCountriesShowAll><SelectedArrivalCities><IntStringElement>
 
<Key>62</Key><Value>Амстердам</Value></IntStringElement></SelectedArrivalCities><ArrivalCitiesShowAll>false</ArrivalCitiesShowAll><SelectedAirlines>
 
<StringStringElement><Key>PS</Key><Value>МАУ</Value></StringStringElement></SelectedAirlines><AirlinesShowAll>false</AirlinesShowAll><SelectedFlights>
 
<IntStringElement><Key>2111</Key><Value>PS 9117 (ASF – EH9), 133</Value></IntStringElement></SelectedFlights><FlightsShowAll>false</FlightsShowAll>
 
<SelectedDepartureAirports><StringStringElement><Key>ASF</Key><Value>Астрахань</Value></StringStringElement></SelectedDepartureAirports>
 
<DepartureAirportsShowAll>false</DepartureAirportsShowAll><SelectedArrivalAirports><StringStringElement><Key>EH9</Key><Value>AMST</Value>
 
</StringStringElement></SelectedArrivalAirports><ArrivalAirportsShowAll>false</ArrivalAirportsShowAll><SelectedTariffs><IntStringElement>
 
<Key>339</Key><Value>14</Value></IntStringElement></SelectedTariffs><TariffsShowAll>false</TariffsShowAll><IntervalFrom xsi:nil=\"true\" />
 
<IntervalTo xsi:nil=\"true\" /><DepartureTimeFrom>00:00</DepartureTimeFrom><DepartureTimeTo>23:59</DepartureTimeTo><ArrivalTimeFrom>00:00
 
</ArrivalTimeFrom><ArrivalTimeTo>23:59</ArrivalTimeTo><FlightSourceMode>Local</FlightSourceMode></Flight></Flights><Priority>1</Priority>
 
<FlightSourceMode>Local</FlightSourceMode></FlightGroup></FlightGroups><FlightSourceMode>Local</FlightSourceMode></FlightData><IsHooded xsi:nil=\"true\" />
 
<IsDeleted xsi:nil=\"true\" /><IsNotCalculate xsi:nil=\"true\" /><IdParent xsi:nil=\"true\" /><IsCity>1</IsCity><IsRoute>1</IsRoute><IsPartnerBasedOn>0
 
</IsPartnerBasedOn></ServiceTemplate><ServiceTemplate><Id>2</Id><SvKey>1</SvKey><FlightData><FlightGroupId>2</FlightGroupId>
 
<FlightGroups><FlightGroup><Id>1</Id><Name>Группа перелетов_1</Name><FlightId>1</FlightId><Flights><Flight><Id>0</Id><Name>Рейс_0</Name>
 
<SelectedPacket><Key>1462</Key><Value>EfremovTest</Value></SelectedPacket><SelectedPartners><IntStringElement><Key>12685</Key><Value> ПКЦ</Value>
 
</IntStringElement></SelectedPartners><PartnersShowAll>false</PartnersShowAll><SelectedDepartureCountries><IntStringElement><Key>1</Key><Value>Голландия
 
</Value></IntStringElement></SelectedDepartureCountries><DepartureCountriesShowAll>false</DepartureCountriesShowAll><SelectedDepartureCities><IntStringElement>
 
<Key>62</Key><Value>Амстердам</Value></IntStringElement></SelectedDepartureCities><DepartureCitiesShowAll>false</DepartureCitiesShowAll><SelectedArrivalCountries>
 
<IntStringElement><Key>460</Key><Value>Россия</Value></IntStringElement></SelectedArrivalCountries><ArrivalCountriesShowAll>false</ArrivalCountriesShowAll>
 
<SelectedArrivalCities><IntStringElement><Key>312</Key><Value>Астрахань</Value></IntStringElement></SelectedArrivalCities><ArrivalCitiesShowAll>false</ArrivalCitiesShowAll>
 
<SelectedAirlines><StringStringElement><Key>AUF</Key><Value>АЭРОФЛОТ</Value></StringStringElement></SelectedAirlines><AirlinesShowAll>false</AirlinesShowAll>
 
<SelectedFlights><IntStringElement><Key>2080</Key><Value>AUF 9000 (EH9 – ASF), 330</Value></IntStringElement></SelectedFlights><FlightsShowAll>false</FlightsShowAll>
 
<SelectedDepartureAirports><StringStringElement><Key>EH9</Key><Value>AMST</Value></StringStringElement></SelectedDepartureAirports><DepartureAirportsShowAll>false
 
</DepartureAirportsShowAll><SelectedArrivalAirports><StringStringElement><Key>ASF</Key><Value>Астрахань</Value></StringStringElement></SelectedArrivalAirports>
 
<ArrivalAirportsShowAll>false</ArrivalAirportsShowAll><SelectedTariffs><IntStringElement><Key>339</Key><Value>14</Value></IntStringElement></SelectedTariffs>
 
<TariffsShowAll>false</TariffsShowAll><IntervalFrom xsi:nil=\"true\" /><IntervalTo xsi:nil=\"true\" /><DepartureTimeFrom>00:00</DepartureTimeFrom><DepartureTimeTo>
 
23:59</DepartureTimeTo><ArrivalTimeFrom>00:00</ArrivalTimeFrom><ArrivalTimeTo>23:59</ArrivalTimeTo><FlightSourceMode>Local</FlightSourceMode></Flight></Flights>
 
<Priority>1</Priority><FlightSourceMode>Local</FlightSourceMode></FlightGroup></FlightGroups><FlightSourceMode>Local</FlightSourceMode></FlightData><IsHooded
 
xsi:nil=\"true\" /><IsDeleted xsi:nil=\"true\" /><IsNotCalculate xsi:nil=\"true\" /><IdParent xsi:nil=\"true\" /><IsCity>1</IsCity><IsRoute>1</IsRoute><IsPartnerBasedOn>
 
0</IsPartnerBasedOn></ServiceTemplate><ServiceTemplate><Id>3</Id><SvKey>3</SvKey><HotelData><HotelGroupId>1</HotelGroupId><HotelGroups><HotelGroup><Id>0</Id><Name>
 
Проживание_0</Name><Hotel><SelectedTourDuration><unsignedByte>1</unsignedByte><unsignedByte>2</unsignedByte><unsignedByte>3</unsignedByte><unsignedByte>4</unsignedByte>
 
<unsignedByte>5</unsignedByte><unsignedByte>6</unsignedByte><unsignedByte>7</unsignedByte><unsignedByte>8</unsignedByte><unsignedByte>9</unsignedByte><unsignedByte>10
 
</unsignedByte></SelectedTourDuration><SelectedPacket><Key>1462</Key><Value>EfremovTest</Value></SelectedPacket><SelectedCountryByHotel><Key>1</Key><Value>Голландия
 
</Value></SelectedCountryByHotel><CountriesByHotelShowAll>false</CountriesByHotelShowAll><SelectedPartners><IntStringElement><Key>12685</Key><Value> ПКЦ</Value>
 
</IntStringElement></SelectedPartners><PartnersShowAll>false</PartnersShowAll><SelectedCitiesByHotel><SelectedCitiesByHotel><Key>62</Key><Value>Амстердам</Value>
 
</SelectedCitiesByHotel></SelectedCitiesByHotel><CitiesByHotelShowAll>false</CitiesByHotelShowAll><FilteredAddedHotels><HotelDetail><HotelId>238</HotelId><PartnerId>12685
 
</PartnerId><CountryId>0</CountryId><CityId>62</CityId><ResortId xsi:nil=\"true\" /></HotelDetail></FilteredAddedHotels><AllHotelInPacket>false</AllHotelInPacket>
 
</Hotel><Description>Голландия \\ Амстердам \\ </Description></HotelGroup></HotelGroups></HotelData><IsHooded xsi:nil=\"true\" /><IsDeleted xsi:nil=\"true\" />
 
<IsNotCalculate xsi:nil=\"true\" /><IdParent xsi:nil=\"true\" /><IsCity>1</IsCity><IsRoute>1</IsRoute><IsPartnerBasedOn>0</IsPartnerBasedOn></ServiceTemplate>
 
</ServiceTemplates><ServiceTemplateId>3</ServiceTemplateId></TourConsistencyViewModel><MenuViewModel><Status><Key>ForSale</Key><Value>Доступен для продажи</Value>
 
</Status></MenuViewModel><LinkingFlightsRulesViewModel><NotCombineDifferentAirlineRule><Enabled>false</Enabled><Airlines /><FlightSettings /></NotCombineDifferentAirlineRule>
 
<CheckPlusMinus1CharterRule><Enabled>false</Enabled></CheckPlusMinus1CharterRule><NotCombineDifferentTariffGroupRule><Enabled>false</Enabled></NotCombineDifferentTariffGroupRule>
 
<NotCombineDifferentPartnerRule><Enabled>false</Enabled></NotCombineDifferentPartnerRule><DepartureCityEqualsArrivalCityRule><Enabled>false</Enabled>
 
</DepartureCityEqualsArrivalCityRule><CombineOnlySpecificChartersRule><Enabled>false</Enabled><Settings /></CombineOnlySpecificChartersRule></LinkingFlightsRulesViewModel></TourProgram>",
 
 
         "IsMultiHotel": false,
 
         "IsMultiHotel": false,
 
         "Type": "TourProgram"
 
         "Type": "TourProgram"
Строка 12 157: Строка 13 214:
 
** POST .../TourSearchOwin/CheckDoubleDogovor
 
** POST .../TourSearchOwin/CheckDoubleDogovor
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
** '''TourProgramId''' – ключ турпрограммы
+
** '''TourProgramId *''' – ключ турпрограммы
** '''BeginDate''' – дата начала тура
+
** '''BeginDate *''' – дата начала тура
** '''Duration''' – продолжительность тура
+
** '''Duration *''' – продолжительность тура
** '''Currency''' – код валюты
+
** '''Currency *''' – код валюты
** '''Services''' – массив услуг авиаперелетов для получения доплат
+
** '''Services *''' – массив услуг авиаперелетов для получения доплат
*** '''Service''' – объект услуга авиаперелет
+
*** '''Service *''' – объект услуга авиаперелет
**** '''ServiceType''' – тип услуги
+
**** '''ServiceType *''' – тип услуги
**** '''Code''' – код услуги
+
**** '''Code *''' – код услуги
**** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
+
**** '''SubCode1 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
**** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
+
**** '''SubCode2 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
**** '''Packet''' – ключ пакета услуги
+
**** '''Packet *''' – ключ пакета услуги
**** '''Partner''' – ключ партнера услуги
+
**** '''Partner *''' – ключ партнера услуги
**** '''Day''' – день предоставления услуги
+
**** '''Day *''' – день предоставления услуги
**** '''DurationInNight''' – продолжительность услуги в ночах
+
**** '''DurationInNight *''' – продолжительность услуги в ночах
**** '''City''' – ключ города
+
**** '''City *''' – ключ города
**** '''Country''' – страна услуги
+
**** '''Country *''' – страна услуги
**** '''Attributes''' – битовая маска атрибутов услуг
+
**** '''Attributes *''' – битовая маска атрибутов услуг
**** '''IsRemovable''' – (не обрабатывается)
+
**** '''IsRemovable *''' – (не обрабатывается)
**** '''Type''' – тип услуги в путевке (базовая дополнительная)
+
**** '''Type *''' – тип услуги в путевке (базовая дополнительная)
**** '''IsHooded''' – признак скрытая услуга
+
**** '''IsHooded *''' – признак скрытая услуга
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+
**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
**** '''BeginDateTimeString''' – дата и время начала услуги
+
**** '''BeginDateTimeString *''' – дата и время начала услуги
**** '''EndDateTimeString''' – дата и время окончания услуги
+
**** '''EndDateTimeString *''' – дата и время окончания услуги
**** '''TemplateId''' – шаблон услуги
+
**** '''TemplateId *''' – шаблон услуги
**** '''Cost''' – цена услуги
+
**** '''Cost *''' – цена услуги
**** '''ByPax''' – цена за человека
+
**** '''ByPax *''' – цена за человека
**** '''QuotaStatus''' – объект статус квотирования
+
**** '''QuotaStatus *''' – объект статус квотирования
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus *''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
***** '''FreePlaces *''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
***** '''IsFewPlaces *''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
**** '''Index''' – индекс услуги
+
**** '''Index *''' – индекс услуги
**** '''IsRoute''' – признак маршрутная услуга
+
**** '''IsRoute *''' – признак маршрутная услуга
**** '''ServiceTemplateIndex''' – индекс шаблона услуги
+
**** '''ServiceTemplateIndex *''' – индекс шаблона услуги
**** '''RemoteId''' – информация об услуге во внешней системе
+
**** '''RemoteId *''' – информация об услуге во внешней системе
**** '''IsCommission''' – признак, комиссионная ли услуга
+
**** '''IsCommission *''' – признак, комиссионная ли услуга
**** '''BaseFlightsParams''' – параметры рассчитанных авиаперелетов
+
**** '''BaseFlightsParams *''' – параметры рассчитанных авиаперелетов
***** '''CityArrival''' – ключ города прибытия прямого перелета
+
***** '''CityArrival *''' – ключ города прибытия прямого перелета
***** '''FlightCode''' – ключ прямого авиаперелета
+
***** '''FlightCode *''' – ключ прямого авиаперелета
***** '''TariffKey''' – ключ тарифа прямого авиаперелета
+
***** '''TariffKey *''' – ключ тарифа прямого авиаперелета
***** '''PartnerId''' – ключ партнера прямого авиаперелета
+
***** '''PartnerId *''' – ключ партнера прямого авиаперелета
*** '''TouristNumbersList''' – массив туристов, привязанных к услуге
+
*** '''TouristNumbersList *''' – массив туристов, привязанных к услуге
** '''Tourists''' – массив туристов
+
** '''Tourists *''' – массив туристов
*** '''IsMain''' – главный турист
+
*** '''IsMain *''' – главный турист
*** '''Number''' – порядковый номер туриста
+
*** '''Number *''' – порядковый номер туриста
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
*** '''AgeType *''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 – женский)
*** '''FirstName''' – имя (лат)
+
*** '''FirstName *''' – имя (лат)
*** '''LastName''' – фамилия (лат)
+
*** '''LastName *''' – фамилия (лат)
*** '''Patronymic''' – отчество (лат)
+
*** '''Patronymic *''' – отчество (лат)
*** '''FirstNameRus''' – имя (рус)
+
*** '''FirstNameRus *''' – имя (рус)
*** '''LastNameRus''' – фамилия (рус)
+
*** '''LastNameRus *''' – фамилия (рус)
*** '''PatronymicRus''' – отчество (рус)
+
*** '''PatronymicRus *''' – отчество (рус)
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
*** '''InternationalPassportSeries *''' – серия загранпаспорта
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
*** '''InternationalPassportNumber *''' – номер загранпаспорта
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''InternationalPassportDateOfIssue *''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
+
*** '''InternationalPassportDateOfIssueString *''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''InternationalPassportDateOfExpiry *''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
+
*** '''InternationalPassportDateOfExpiryString *''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
*** '''internationalPassportByWhom *''' – кем выдан загранпаспорт
*** '''PassportSeries''' – серия паспорта
+
*** '''PassportSeries *''' – серия паспорта
*** '''PassportNumber''' – номер паспорта
+
*** '''PassportNumber *''' – номер паспорта
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
+
*** '''PassportDateOfIssue *''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
+
*** '''PassportDateOfIssueString *''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
*** '''PassportByWhom''' – кем выдан паспорт
+
*** '''PassportByWhom *''' – кем выдан паспорт
*** '''Citizenship''' – название страны
+
*** '''Citizenship *''' – название страны
*** '''Phone''' – телефон
+
*** '''Phone *''' – телефон
*** '''Email''' – e-mail
+
*** '''Email *''' – e-mail
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
*** '''BirthDay *''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
*** '''BirthDayString *''' – дата рождения в строковом формате (DD.MM.YYYY)
*** '''BirthPlace''' – место рождения
+
*** '''BirthPlace *''' – место рождения
*** '''CitizenID''' – ID туриста (задается в карточке постоянного клиента)
+
*** '''CitizenID *''' – ID туриста (задается в карточке постоянного клиента)
*** '''Age''' – количество полных лет на момент окончания тура
+
*** '''Age *''' – количество полных лет на момент окончания тура
** '''TechnicalProblemsDuringUpdateFlights''' – технические проблемы при обновлении рейсов
+
** '''TechnicalProblemsDuringUpdateFlights *''' – технические проблемы при обновлении рейсов
** '''TimeLimit''' – лимит времени
+
** '''TimeLimit *''' – лимит времени
** '''CountryKey''' – ключ страны
+
** '''CountryKey *''' – ключ страны
** '''OwnerId''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
+
** '''OwnerId *''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
** '''Day''' – день
+
** '''Day *''' – день ''Может быть с пустым значением''
** '''Day2''' – дня
+
** '''Day2 *''' – дня ''Может быть с пустым значением''
** '''Days''' – дней
+
** '''Days *''' – дней ''Может быть с пустым значением''
** '''Night''' – ночь
+
** '''Night *''' – ночь ''Может быть с пустым значением''
** '''Night2''' – ночи
+
** '''Night2 *''' – ночи ''Может быть с пустым значением''
** '''Nights''' – ночей
+
** '''Nights *''' – ночей ''Может быть с пустым значением''
** '''adultsCountOverServiceLimit''' – Количество взрослых туристов превышает лимит услуги
+
** '''adultsCountOverServiceLimit *''' – Количество взрослых туристов превышает лимит услуги ''Может быть с пустым значением''
** '''incorrectChildrenInf''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)
+
** '''at *''' – на (перевод) ''Может быть с пустым значением''
* Возвращаемый результат:
+
** '''incorrectChildrenInf *''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) ''Может быть с пустым значением''
** '''Errors''' – описание ошибки
+
* Возвращаемый результат:
** '''Warnings''' – предупреждение
+
** '''Errors''' – описание ошибки
** '''States''' – статус
+
** '''Warnings''' – предупреждение
** '''IsValid''' – результат проверки подключения (true/false)  
+
** '''States''' – статус
 
+
** '''IsValid''' – результат проверки подключения (true/false)  
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
 
<div class="mw-collapsible-content">
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
<div class="mw-collapsible-content">
Вызов метода CheckDoubleDogovor
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
<syntaxhighlight lang="java" enclose="div">
+
Вызов метода CheckDoubleDogovor
POST http://localhost:9000/TourSearchOwin/CheckDoubleDogovor
+
<syntaxhighlight lang="java" enclose="div">
{
+
POST http://localhost:9000/TourSearchOwin/CheckDoubleDogovor
   "TourProgramId": 100011112,
+
{
   "BeginDate": "2021-10-18T17:05:00",
+
   "TourProgramId": 100011112,
 +
   "BeginDate": "2021-10-18T17:05:00",
 
   "Duration": 6,
 
   "Duration": 6,
 
   "Currency": "рб",
 
   "Currency": "рб",
Строка 12 509: Строка 13 567:
  
 
===Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3===
 
===Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3===
Метод производит выгрузку измененных турпрограмм.
+
Метод производит выгрузку измененных турпрограмм, в которых были сделаны изменения с указанной даты и времени и повлияли на маршруты в турпрограмме. К таким изменениям относятся изменения страны и города начала поездки, страны и города по туру, типа тура. Изменения цен  по услугам не приводят к обновлению турпрограмме, такие турпрограммы в ответе не будут указаны. Турпрограммы, по которым статус ''Доступен для продажи'' сменился на другой за период, указанный в запросе, в ответе тоже не будут указаны.
 
* Формат запроса:
 
* Формат запроса:
 
** GET .../TourSearchOwin/TourProgram?
 
** GET .../TourSearchOwin/TourProgram?
 
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
 
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
** '''fromDateTime''' – дата (в формате ''dd.MM.yyyy HH:mm:ss''), начиная с которой будут выгружаться изменения
+
** '''fromDateTime''' – дата (в формате ''dd.MM.yyyy HH:mm:ss''), начиная с которой будут выгружаться изменения,
  
 
* Возвращаемый результат:
 
* Возвращаемый результат:
Строка 12 531: Строка 13 589:
 
Вызов метода TourProgram
 
Вызов метода TourProgram
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
GET http://localhost:9000/TourSearchOwin/TourProgram?
+
GET http://localhost:9000/TourSearchOwin/TourProgram?fromDateTime=20.08.2022 00:00:00
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Возвращаемый результат метода TourProgram (в формате JSON)
 
Возвращаемый результат метода TourProgram (в формате JSON)
Строка 12 576: Строка 13 634:
  
 
===Проверка построения маршрутов турпрограммы (CheckTourProgram)===
 
===Проверка построения маршрутов турпрограммы (CheckTourProgram)===
Метод производит построение маршрутов турпрограмм (вызывается из проверки тура).
+
Метод производит построение маршрутов турпрограмм (вызывается из проверки тура). Метод проверяет маршруты по турпрограммам с любым статусом (не только по статусу Доступен для подажи).
 
* Формат запроса:
 
* Формат запроса:
 
** GET .../TourSearchOwin/CheckTourProgram?
 
** GET .../TourSearchOwin/CheckTourProgram?
Строка 12 649: Строка 13 707:
  
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
** '''adapterTypeName''' – адаптер
+
** '''adapterTypeName''' – адаптер
** '''id''' – ключ адаптера
+
** '''id''' – ключ адаптера
** '''apiAddress''' – api-адрес
+
** '''apiAddress''' – api-адрес
** '''settings''' – набор настроек (у каждого адаптера индивидуальный)
+
** '''settings''' – набор настроек (у каждого адаптера индивидуальный)
*** '''Key''' – _Login
+
*** '''Key''' – _Login
*** '''Value''' – логин  
+
*** '''Value''' – логин  
*** '''Key''' – _Password
+
*** '''Key''' – _Password
*** '''Value''' – пароль  
+
*** '''Value''' – пароль  
*** '''Key''' – _UserID
+
*** '''Key''' – _UserID
*** '''Value''' – ID пользователя
+
*** '''Value''' – ID пользователя
** '''licenseDateExpiry''' – дата окончания лицензии
+
** '''licenseDateExpiry''' – дата окончания лицензии
 +
 
 +
* Возвращаемый результат:
 +
** '''Errors''' – описание ошибки
 +
** '''Warnings''' – предупреждение
 +
** '''States''' – статус
 +
** '''IsValid''' – результат проверки подключения (true/false)
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода GDSCheckConnection
 +
<syntaxhighlight lang="java" enclose="div">
 +
POST http://localhost:9000/TourSearchOwin/GDSCheckConnection? HTTP/1.1
 +
Content-Type: application/json
 +
{
 +
    "adapterTypeName": "TravelBoxAdapter",
 +
    "id": 5565,
 +
    "apiAddress": "http://dev24.desertadventur.com/",
 +
    "settings": [{
 +
            "Key": "TravelBox_Login",
 +
            "Value": "Login"
 +
        }, {
 +
            "Key": "TravelBox_Password",
 +
            "Value": "Password"
 +
        }, {
 +
            "Key": "TravelBox_UserID",
 +
            "Value": "12345"
 +
        }, {
 +
            "Key": "TravelBox_CompanyCode",
 +
            "Value": "DA_UAE"
 +
        }, {
 +
            "Key": "TravelBox_Division",
 +
            "Value": "FIT_UAE"
 +
        }, {
 +
            "Key": "TravelBox_Department",
 +
            "Value": "FIT- Local"
 +
        }, {
 +
            "Key": "TravelBox_TouroperatorCode",
 +
            "Value": "54321"
 +
        }, {
 +
            "Key": "TravelBox_MaxResponses",
 +
            "Value": "200"
 +
        }, {
 +
            "Key": "TravelBox_AvailRatesOnly",
 +
            "Value": "AvailRatesOnly"
 +
        }, {
 +
            "Key": "TravelBox_CacheTimelife",
 +
            "Value": "10"
 +
        }
 +
    ],
 +
    "licenseDateExpiry": "01.01.2022"
 +
}
 +
</syntaxhighlight>
 +
Возвращаемый результат метода GDSCheckConnection (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
[{
 +
    "Errors": [],
 +
    "Warnings": null,
 +
    "States": null,
 +
    "IsValid": true
 +
}]
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Подтверждения оплаты полиса в ЕВРОИНС===
 +
Для подтверждения оплаты метод будет обращаться к внешним службам для подтверждения платежа.<br />
 +
[[Мастер-Тур(15):Программа туров. Внешние системы. Страховая компания ЕВРОИНС|Страховая компания ЕВРОИНС]]
 +
 
 +
* Формат запроса:
 +
** POST .../TourSearchOwin/EuroinsConfirmPay
 +
 
 +
* Принимаемые параметры headers ( '''*''' – обязательный):
 +
** '''Content-Type *''' – application/json
 +
 
 +
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 +
** '''policyId *''' – ID полиса
 +
** '''code *''' – код партнера
 +
 
 +
* Возвращаемый результат:
 +
** '''success: true''' – подтверждено (''код 200'')
 +
** '''error''' – описание ошибки (''код 400'')
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода EuroinsConfirmPay
 +
 
 +
<syntaxhighlight lang="java" enclose="div">
 +
POST localhost:9000/TourSearchOwin/EuroinsConfirmPay
 +
</syntaxhighlight>
 +
Content-Type: application/json
 +
 
 +
{
 +
    "policyId": "134574",
 +
    "code": "oqxKQXlOInSJqLl"
 +
}
 +
 
 +
</syntaxhighlight>
 +
Возвращаемый результат метода EuroinsConfirmPay (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
Код 200:
 +
{
 +
"success": true
 +
}
  
* Возвращаемый результат:
+
Код 400:
** '''Errors''' – описание ошибки
 
** '''Warnings''' – предупреждение
 
** '''States''' – статус
 
** '''IsValid''' – результат проверки подключения (true/false)
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
Вызов метода GDSCheckConnection
 
<syntaxhighlight lang="java" enclose="div">
 
POST http://localhost:9000/TourSearchOwin/GDSCheckConnection? HTTP/1.1
 
Content-Type: application/json
 
 
{
 
{
    "adapterTypeName": "TravelBoxAdapter",
+
"error": "Не удалось выполнить действие"
    "id": 5565,
 
    "apiAddress": "http://dev24.desertadventur.com/",
 
    "settings": [{
 
            "Key": "TravelBox_Login",
 
            "Value": "Login"
 
        }, {
 
            "Key": "TravelBox_Password",
 
            "Value": "Password"
 
        }, {
 
            "Key": "TravelBox_UserID",
 
            "Value": "12345"
 
        }, {
 
            "Key": "TravelBox_CompanyCode",
 
            "Value": "DA_UAE"
 
        }, {
 
            "Key": "TravelBox_Division",
 
            "Value": "FIT_UAE"
 
        }, {
 
            "Key": "TravelBox_Department",
 
            "Value": "FIT- Local"
 
        }, {
 
            "Key": "TravelBox_TouroperatorCode",
 
            "Value": "54321"
 
        }, {
 
            "Key": "TravelBox_MaxResponses",
 
            "Value": "200"
 
        }, {
 
            "Key": "TravelBox_AvailRatesOnly",
 
            "Value": "AvailRatesOnly"
 
        }, {
 
            "Key": "TravelBox_CacheTimelife",
 
            "Value": "10"
 
        }
 
    ],
 
    "licenseDateExpiry": "01.01.2022"
 
 
}
 
}
</syntaxhighlight>
 
Возвращаемый результат метода GDSCheckConnection (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
[{
 
    "Errors": [],
 
    "Warnings": null,
 
    "States": null,
 
    "IsValid": true
 
}]
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
</TD></TR></TABLE>
 
</TD></TR></TABLE>

Текущая версия на 16:11, 31 марта 2025

Версия статьи от 31-03-2025.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15 версии


Содержание

 [убрать

Введение

Данный web-сервис служит для разработки собственного сайта туроператору на основе API.

Установка

Для работы с web-сервисом необходимо на отдающей стороне установить службу поиска.
После установки web-сервис будет доступен по адресу http://значение настройки "serviceAddress" в TourSearchOwin/"название метода" (пример: http://localhost:9000/TourSearchOwin/Settings)

Список методов

Последовательность вызова методов сервиса
Последовательность вызова методов сервиса

Авторизация (Token)

Метод производит получение авторизационного токена (описание стандарта).

  • Формат запроса:
    • POST .../TourSearchOwin/Token?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/x-www-form-urlencoded
  • Принимаемые параметры POST запроса ( * – обязательный):
    • grant_type * – текст password
    • username * – логин представителя партнера или частного лица
    • password * – пароль представителя партнера или частного лица
  • Возвращаемый результат:
    • access_token – токен
    • token_type – тип токена
    • expires_in – код
    • userKey – ключ пользователя
    • userType – тип пользователя (0 – представитель партнера, 1 – частное лицо)
    • .issued – дата получения
    • .expires – дата действия до
развернутьПример


Выгрузка настроек службы поиска (Settings)

Метод производит выгрузку настроек службы поиска.

  • Формат запроса:
    • GET .../TourSearchOwin/Settings?
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • ChildAgesSetting – регулируется настройкой максимальный возраст ребенка (массив возрастов, при которых турист будет считаться ребенком
    • DurationSetting – регулируется настройкой максимальная продолжительность тура (массив продолжительностей, доступных в фильтрах для поиска)
    • RoundServiceSetting – признак округления цены (количество знаков после запятой)
    • CacheReady – статус готовности службы поиска к работе (true/false)
    • EnableFiterTree – устаревшая настройка, будет убрана (по умолчанию всегда false)
    • EnableActualFilters – включены ли актуальные фильтры (true/false)
    • CorrectLicense – проверка лицензии (true/false)
    • CorrectLicenseMessage – сообщение, если проверка лицензии не прошла
    • IsCorrectUser – проверка наличия пользователя в таблице Userlist, под которым запущена служба поиска (true/false)
    • IsShowCitizenAuthTourist – настройка запрашивать гражданство при регистрации частного лица (true/false)
    • IsShowFewCountPlaces – настройка отображения числового значения оставшихся мест, когда достигнуто значение «Мало» (true/false)
    • IsShowBusTransferPlaces – использовать фильтр наличие мест на автобусный переезд в поиске (true/false)
    • UseBusSeatChecks – план рассадки автобусного переезда (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
    • UseTransferSeatChecks – план рассадки трансфера (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
    • IsShowFiltersByCity – отображать фильтр по городам на главной странице поиска (true/false)
    • CheckRealCourses – включена ли проверка курсов реальных валют при поиске (true/false)
    • CommonImagesFolderPath – путь к папке для хранения изображений
    • UseApplyFiltersButton – отображать кнопку «Применить фильтры» (true/false)
    • AutoSearchFiltersTimeout – задержка между выбором дополнительных фильтров и выводом результатов (в секундах)
    • UseFastSearchAlgoritm – использовать быстрый алгоритм поиска (true/false)
    • MaxSearchDatesCountClient – максимальное количество дат, которое будет обрабатываться в клиенте поиска
    • MaxDurationsCountClient – максимальное количество продолжительностей, которое будет обрабатываться в клиенте поиска
    • UseHotelCategoryGlobalCodeInDopFilter – использовать глобальные коды категорий отелей в поиске
    • UsePansionGlobalCodeInDopFilter – использовать глобальные коды питаний в поиске
    • CheckTouristDataInBasket – проверять корректность данных туристов
    • SimpleRegistration – упрощенная регистрация частного лица
    • ShowHotelImagesInSearch – показывать описание и изображения отелей в поиске
    • CacheReadyMessage – сообщение о готовности службы поиска или службы расчета актуальных фильтров. Варианты возвращаемых значений:
      • <add key="enableActualFilters" value="true" /> - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
      • <add key="enableActualFilters" value="false" /> - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - CacheReadyMessage: "Кеш ещё инициализирован".
развернутьПример



Выгрузка списка валют в онлайне (Currency)

Метод возвращает список используемых валют.

  • Формат запроса:
    • GET .../TourSearchOwin/Currency
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Code – код валюты
    • Name – наименование валюты
    • IsMain – признак валюты «Главная»
    • IsNational – признак валюты «Национальная»
    • IsoCode – ISO код валюты
    • IsShowInSearch – признак показывать ли валюту в поиске
    • Symbol – символ валюты (обрабатывается с 15.7)
    • Key – идентификатор валюты


развернутьПример



Выгрузка курсов валют (CurrencyRates) начиная с 15.7

Полный аналог метода Выгрузка курсов валют (GetCurrencyRates)
Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком Отображать в онлайне

  • Формат запроса:
    • GET .../TourSearchOwin/CurrencyRates
  • Принимаемые параметры:
    • dateFrom – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
    • dateTo – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
  • Возвращаемый результат:
    • baseCurrencyId – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке basketCurrency в конфигурационном файле (обрабатывается с релиза 15.6)
    • currencyId – идентификатор валюты, курс которой приводится
    • rate – курс валюты (отношение currencyId к baseCurrencyId)
    • date – дата, на которую был зарегистрирован выводимый курс валюты
развернутьПример


Выгрузка списка всех валют (getAllCurrencies)

Метод возвращает список всех валют.

  • Формат запроса:
    • GET .../TourSearchOwin/AllCurencies/getAllCurrencies
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Code – код валюты
    • Name – наименование валюты
    • IsMain – признак валюты «Главная»
    • IsNational – признак валюты «Национальная»
    • IsoCode – ISO код валюты
    • IsShowInSearch – признак показывать ли валюту в поиске
    • Symbol – символ валюты (обрабатывается с 15.7)
    • Key – идентификатор валюты
развернутьПример



Получение сконвертированных цен (convertFilterPrice)

Метод возвращает сконвертированные цен для допфильтра Цена (используется в canary)

  • Формат запроса:
    • GET .../TourSearchOwin/AllCurencies/convertFilterPrice
  • Принимаемые параметры ( * – обязательный):
    • SourceRateKey * – ключ исходной валюты конвертации
    • TargetRateKey * – ключ валюты, в которую будет произведена конвертация
    • MinPrice * – значение минимальной цены, которое будет участвовать в конвертации
    • MaxPrice * – значение максимальной цены, которое будет участвовать в конвертации
  • Возвращаемый результат:
    • m_Item1 – сконвертированная минимальная цена
    • m_Item12 – сконвертированная максимальная цена
развернутьПример


Выгрузка квотируемых услуг системы (QuotedServices)

Метод производит выгрузку услуг с признаком «Квотируемая»

  • Формат запроса:
    • GET .../TourSearchOwin/QuotedServices
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Key – идентификатор услуги
    • Code – код услуги
    • Name – наименование услуги (русский)
    • NameLat – наименование услуги (английский)
    • IsDuration – наличие продолжительности у услуги
    • IsCity – наличие города у услуги
    • IsSubCode1 – признак наличия SubCode1 у услуги
    • IsSubCode2 – признак наличия SubCode2 у услуги
    • Quoted – признак квотируемости услуги
    • CheckGeoPoint – наличие геоточек у услуги
    • IsRoute – признак маршрутной услуги
    • IsPartnerBasedOn – признак сопоставления партнера услуги в зависимости от отеля
    • Control – идентификатор статуса услуги
развернутьПример


Выгрузка актуальных городов отправления (departureCities)

Метод производит выгрузку всех доступных городов отправления для поискового запроса.

  • Формат запроса:
    • GET .../TourSearchOwin/departureCities?
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Key – идентификатор города
    • Name – название города
развернутьПример


Выгрузка актуальных стран (Destination)

Метод производит выгрузку всех доступных направлений туроператора.

  • Формат запроса:
    • GET .../TourSearchOwin/Destination?
  • Принимаемые параметры ( * – обязательный):
    • departureCities * – идентификатор города(ов) отправления (из контроллера .../TourSearchOwin/departureCities?)
    • type – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
    • term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Name – название страны
    • Key – идентификатор страны
    • DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
    • IsExist – не используется
    • Data – массив данных для контекстного поиска
      • CityKey – код города
      • CityName – Название
      • HotelKey – код отеля
      • HotelName – название отеля
      • ResortKey – код курорта
      • ResortName – название курорта


развернутьПример


Выгрузка актуальных городов (ActualizeCities)

Метод возвращает список всех доступных городов по определенному городу отправления и стране прибытия.

  • Формат запроса:
    • GET .../TourSearchOwin/ActualizeCities?
  • Принимаемые параметры ( * – обязательный):
    • cityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – идентификатор города
    • Name – название города
развернутьПример


Выгрузка актуальных типов туров (ActualizeTourType)

Метод возвращает список типов туров по определенному городу отправления, стране и городу прибытия.

  • Формат запроса:
    • GET .../TourSearchOwin/ActualizeTourType?
  • Принимаемые параметры ( * – обязательный):
    • departureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • terms – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – идентификатор типа тура
    • Name – название типа тура
    • ParentId – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается null)
развернутьПример


Выгрузка актуальных дат заездов (TourDate)

Метод производит выгрузку доступных дат заездов для поискового запроса.

  • Формат запроса:
    • GET .../TourSearchOwin/TourDate?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • tourTypes * – идентификатор типа тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
  • Возвращаемый результат:
    • массив дат
развернутьПример


Выгрузка актуальных продолжительностей (Duration)

Метод производит выгрузку доступных продолжительностей для поискового запроса.

  • Формат запроса:
    • GET .../TourSearchOwin/Duration?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • tourDate * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • tourTypes * – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
  • Возвращаемый результат:
    • массив продолжительностей (в днях)
развернутьПример


Поиск туров (Tour)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Tour?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false)
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • MinPrice * – минимальная цена (по умолчанию не задана, передается NaN)
    • MaxPrice – максимальная цена (по умолчанию не передается)
    • Groups – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
    • HotelScheme – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:
      • TemplateId – идентификатор шаблона услуги (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Key->TemplateId),
      • DurationInNight – продолжительность отеля в ночах (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->DurationInNight),
      • Code – ключ отеля (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->Code),
      • PacketKey – ключ пакета (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PacketId),
      • PartnerKey – ключ партнера (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PartnerId),
      • GDSProviderId – ключ провайдера из внешней системы (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->GDSProviderId),
      • TotalTourDuration – общая продолжительность тура в днях (этот параметр можно взять из контроллера Tour->Result->Duration)
    • BusTransferPointKeys – данный признак проставляется в true в том случае, когда происходит запрос вариантов проживания (кнопка Варианты) в автобусных переездах
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • TourType – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны. Возможна множественная передача параметров.
    • Tour – ключ программы тура (дополнительный фильтр)
    • Duration – продолжительность тура (дополнительный фильтр)
    • DateTour – дата тура (дополнительный фильтр)
    • HotelResort – ключ курорта отеля (дополнительный фильтр)
    • HotelCity – ключ города отеля (дополнительный фильтр)
    • HotelType – ключ признака отеля (дополнительный фильтр)
    • HotelStars – ключ категории отеля (дополнительный фильтр)
    • Hotel – ключ отеля (дополнительный фильтр)
    • Pansions – ключ питания (дополнительный фильтр)
    • Airline – ключ авиакомпании (дополнительный фильтр)
    • AirportDeparture – ключ аэропорта вылета (дополнительный фильтр)
    • AirportArrival – ключ аэропорта прилета (дополнительный фильтр)
    • CityIds – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны. Возможна множественная передача параметров.
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
    • DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
    • DepartureFlightNumberTransfer – наличие пересадок в прямом направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
    • ArrivalFlightNumberTransfer – наличие пересадок в обратном направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
    • Tariff – ключ класса авиаперелета (дополнительный фильтр)
    • CombineAirlines — разрешить комбинировать авиаперелеты (дополнительный фильтр). Параметр применяется только при наличии параметра airline. Обрабатывается начиная с релиза 15.3.
    • CombineTariffs — разрешить комбинировать классы перелета (дополнительный фильтр). Параметр применяется только при наличии параметра tariff. Обрабатывается начиная с релиза 15.3.
    • FlightCityDeparture – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
    • CityDeparture – ключ города начала поездки (дополнительный фильтр)
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
    • GroupGuid – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. GroupGuid=00000000-0000-0000-0000-000000000000 – при первом запросе от локальной системы. GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8 (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
    • IsGroupingTourAlreadyMerge – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. IsGroupingTourAlreadyMerge=false – полученные данные от локальной системы не объединены с данными от внешней системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. IsGroupingTourAlreadyMerge=true – полученные данные от локальной системы уже объединены с данными от внешней системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
    • SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.


  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатов программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
        • IsLandOnly – признак только наземное обслуживание
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заеда по программе тура
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
          • notCombineDifferentAirlineRule
            • airlines
            • flightSettings
            • enabled
          • checkPlusMinus1CharterRule
            • FlightSettingPairs
            • enabled
          • notCombineDifferentTariffGroupRule
            • FlightSettings
            • enabled
          • notCombineDifferentPartnerRule
            • FlightSettings
            • enabled
          • departureCityEqualsArrivalCityRule
            • FlightSettingPairs
            • enabled
          • combineOnlySpecificChartersRule
            • settings
            • enabled
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • '
        • HotelResorts – курорты в дополнительных фильтрах
          • '
        • HotelCategories – категории отеля в дополнительных фильтрах
          • '
        • Hotels – отели в дополнительных фильтрах
          • '
        • Pansions – питания в дополнительных фильтрах
          • '
        • Airlines – авиакомпании в дополнительных фильтрах
          • '
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • '
        • DepartureCities – города вылета в дополнительных фильтрах
          • '
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • '
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • '
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • '
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • '
развернутьПример


Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно

Метод производит выгрузку транспортного плана.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code – код услуги
    • dateBegin – дата услуги
    • serviceType – тип услуги
    • transportKey – ключ справочника транспорт
  • Возвращаемый результат:
    • TransportKey – ключ справочника транспорт
    • Title – описание
    • AreasCount – количество уровней
    • RowsCount – количество рядов
    • ColumnsCount – количество мест в ряду
    • BusySeats – не используется
    • Cells – массив описаний всех мест
      • Row – ряд
      • Column – место в ряду
      • Area – уровень места
      • Type – тип (None = 0, Seat = 1, Block = 4, Busy = 5)
      • Name – название/номер
    • UserSeats – не используется
    • BlockSeat – не используется
развернутьПример


Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8

Метод производит выгрузку транспортного плана.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code – код услуги
    • dateBegin – дата услуги
    • serviceType – тип услуги
    • transportKey – ключ справочника транспорт
  • Возвращаемый результат:
    • VehiclePlans – массив параметров зон плана
      • Key – ключ зоны
      • TransportKey – ключ из справочника транспорт
      • Row – количество рядов
      • AreaNumber – номер уровня
      • Name – название уровня
      • PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
      • Column – количество столбцов
      • IsAirCraft – является ли планом самолета (false - нет, true - является)
      • Type – не используется
    • Seats – массив параметров посадочного места
      • Key – ключ места
      • SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
      • Index – индекс места
      • Number – название ячейки с местом
      • Type – тип "место"
      • VPKey – ключ зоны
      • Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
развернутьПример


Получение дат заезда по турпрограмме

Работает начиная с релиза 15.8.

Метод возвращает даты заезда по ключу турпрограммы.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • tourProgramKey * – ключ турпрограммы
  • Возвращаемый результат:
    • Массив дат заезда по туру
развернутьПример


Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги

Работает начиная с релиза 15.8.

Метод возвращает даты заезда по ключу турпрограммы и дате услуги.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • tourProgramKey * – ключ турпрограммы
    • dateBegin * – дата услуги
    • serviceType * – тип услуги
  • Возвращаемый результат:
  • plan – массив данных план
    • VehiclePlans – массив параметров зон плана
      • Key – ключ зоны
      • TransportKey – ключ из справочника транспорт
      • Row – количество рядов
      • AreaNumber – номер уровня
      • Name – название уровня
      • PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
      • Column – количество столбцов
      • IsAirCraft – является ли планом самолета (false - нет, true - является)
      • Dates – не используется
      • Type – не используется
    • Seats – массив параметров посадочного места
      • Key – ключ места
      • SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
      • Index – индекс места
      • Number – название ячейки с местом
      • Type – тип "место"
      • VPKey – ключ зоны
      • Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
  • routeCity – направление автобусного переезда
развернутьПример


Выгрузка первоначального варианта в корзину для бронирования (Tour)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Tour?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • CurrencyName * – код валюты
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelScheme * – объект схемы отеля
      • TemplateId – идентификатор шаблона услуги
      • DurationInNight – продолжительность отеля в ночах
      • Code – ключ отеля
      • PacketKey – ключ пакета
      • PartnerKey – ключ партнера
      • GDSProviderId – ключ провайдера из внешней системы
      • TotalTourDuration – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра TotalTourDuration для HotelScheme можно из свойства Duration, пришедшего для данной цены в ответе метода поиск туров (Tour)
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатор программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode - список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – доп. фильтры (не используется при вызове из корзины)


развернутьПример


Выгрузка настройки отображения полей по туристам (TouristDataSettings)

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

  • Формат запроса:
    • GET .../TourSearchOwin/TouristDataSettings?
  • Принимаемые параметры ( * – обязательный):
    • countryId * – ключ страны, для которой будут выгружаться настройки
  • Возвращаемый результат:
    • TouristFieldsSettings – массив полей с информацией о туристах (из админки Мастер-Web)
      • lastname – объект фамилия туриста (лат)
        • Index – порядковый индекс элемента
        • Code – код поля
        • ApiCode – имя поля, которое будет использоваться при бронировании (например при вызове метода CreateReservation)
        • HeaderText – название поля
        • IsEdit – признак редактируемости поля
        • IsRequired – признак обязательности заполнения поля
        • IsVisible – видимость поля (видимое)
        • IsDisabled – служебный внутренний параметр. При работе с API не используется
        • Translit – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)
        • LetterCase – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
      • patronymic – объект отчество туриста (лат)
      • sex – объект пол туриста
      • firstname – объект имя туриста (лат)
      • passportbywhom – объект кем выдан заграничный паспорт
      • birthplace – объект место рождения
      • birthdate – объект дата рождения
      • patronymicrus – объект отчество (рус)
      • lastnamerus – объект фамилия туриста (рус)
      • citizenid – объект ID туриста
      • passport – объект серия и номер заграничного паспорта
      • passportrus – объект серия и номер национального паспорт а
      • ismain – объект признак главного туриста
      • passportdate – объект дата выдачи заграничного паспорта
      • firstnamerus – объект имя туриста (рус)
      • passportbywhomrus – объект кем выдан национальный паспорт
      • citizenship – объект гражданство
      • passportdaterus – объект дата выдачи национального паспорта
      • phone – объект телефон
      • number – объект порядковый номер
      • passportdateend – объект дата окончания заграничного паспорта
      • email – объект e-mail туриста
    • PassportDurationOfExpiry – объект минимальный срок действия загранпаспорта туриста
      • StartPoint – точка отсчета
      • Duration – минимальная продолжительность
    • ChildAgeSetting – максимальный возраст ребенка, когда он считается ребенком (лет)
    • InfantAgeSetting – максимальный возраст младенца (месяцев)
развернутьПример


Выгрузка услуг доплат к авиаперелетам (GetFlightsAdditionalServices)

Метод производит выгрузку услуг доплат к авиаперелетам.

  • Формат запроса:
    • POST .../TourSearchOwin/GetFlightsAdditionalServices?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ турпрограммы
    • BeginDate – дата начала тура
    • Duration – продолжительность тура
    • Currency – код валюты
    • Services – массив услуг авиаперелетов для получения доплат
      • Service – объект услуга авиаперелет
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1 услуги
        • SubCode2доп. описание 2 услуги
        • Packet – ключ пакета услуги
        • Partner – ключ партнера услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • City – ключ города
        • Country – страна услуги
        • Attributes – битовая маска атрибутов услуг
        • IsRemovable – (не обрабатывается)
        • Type – тип услуги в путевке (базовая дополнительная)
        • IsHooded – признак скрытая услуга
        • IsNotCalculated – признак не рассчитываемая услуга
        • BeginDateTimeString – дата и время начала услуги
        • EndDateTimeString – дата и время окончания услуги
        • TemplateId – шаблон услуги
        • Cost – цена услуги
        • ByPax – цена за человека
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index – индекс услуги
        • IsRoute – признак маршрутная услуга
        • ServiceTemplateIndex – индекс шаблона услуги
      • TouristNumbersList – массив туристов, привязанных к услуге
    • Tourists – массив туристов
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
  • Возвращаемый результат:
    • Массив – массив объектов доплат к авиаперелетам
      • ServiceName – название услуги
      • City – объект город
      • Country – объект страна
        • Key – ключ страны
        • Value – название страны
      • Code – объект код услуги
        • Key – ключ услуги
        • Value – название услуги
      • ByScheduler – признак по расписанию
      • Details - объект детализация
        • SubCode1 – объект доп. описание 1
          • Key – ключ
          • Value – название
        • SubCode2 – объект доп. описание 2
          • Key – ключ
          • Value – название
        • Date – дата услуги
        • IsShowTransportPlan – признак показать транспортный план (для автобусов)
        • Cost – цена
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • PartnerId – ключ партнера
        • ByPax – признак за человека
        • Partner – объект партнер (не заполняется)
          • Key – ключ (не заполняется)
          • Value – название (не заполняется)
      • ParentId – ключ родительской услуги
      • PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
      • ShowOrder – порядок при печати (сортировка) по услуге
      • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
      • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
      • Id – идентификатор услуги
      • SvKey – тип услуги
      • IsSubCode1 – признак наличия доп. описания 1
      • IsSubCode2 – признак наличия доп. описания 2
      • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • BeginDateTime – дата начала услуги
      • EndDateTime – дата окончания
      • IsHooded – признак скрытая
      • IsDeleted – признак удаляемая
      • IsNotCalculate – признак не рассчитываемая
      • PacketId – ключ пакета
      • Index – индекс шаблона услуги
развернутьПример


Выгрузка услуг доплат к отелям (GetHotelsAdditionalServices)

Метод производит выгрузку услуг доплат к отелям.

  • Формат запроса:
    • POST .../TourSearchOwin/GetHotelsAdditionalServices?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ турпрограммы
    • BeginDate – дата начала тура
    • Duration – продолжительность тура
    • Currency – код валюты
    • Services – массив услуг отелей для получения доплат
      • Service – объект услуга отель
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1 услуги
        • SubCode2доп. описание 2 услуги
        • Packet – ключ пакета услуги
        • Partner – ключ партнера услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • City – ключ города
        • Country – страна услуги
        • Attributes – битовая маска атрибутов услуг
        • IsRemovable – (не обрабатывается)
        • Type – тип услуги в путевке (базовая дополнительная)
        • IsHooded – признак скрытая услуга
        • IsNotCalculated – признак не рассчитываемая услуга
        • BeginDateTimeString – дата и время начала услуги (YYYY-MM-DDThh:mm:ss)
        • EndDateTimeString – дата и время окончания услуги (YYYY-MM-DDThh:mm:ss)
        • TemplateId – шаблон услуги
        • Cost – цена услуги
        • ByPax – цена за человека
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index – индекс услуги
        • IsRoute – признак маршрутная услуга
        • ServiceTemplateIndex – индекс шаблона услуги
        • RemoteId – (в доплатах не используется)
      • TouristNumbersList – массив туристов, привязанных к услуге
    • Tourists – массив туристов
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
  • Возвращаемый результат:
    • Массив – массив объектов связок Возраст-Отель-Доп. услуги
      • Age – возраст туриста
      • Hotel – объект отель
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1
        • SubCode2доп. описание 2
        • PacketId – ключ пакета
        • PartnerId – ключ партнера
        • Day – день предоставления услуги
        • BeginTime – время начала услуги
        • EndTime – время окончания услуги
        • DurationInNight – продолжительность услуги в ночах
        • Attributes – маска атрибутов услуги
        • CountryId – ключ страны услуги
        • CityId – ключ города
        • Type – тип услуги в путевке
        • ShowOrder – порядок при печати (сортировка) по услуге
        • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
        • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
        • IsCommission – признак, комиссионная ли услуга
        • BaseFlightsParams – параметр не обрабатывается
      • AdditionalServices – массив доплат
      • ServiceName – название услуги
      • City – объект город
      • Country – ключ страны
      • Code – объект код услуги
        • Key – ключ услуги
        • Value – название услуги
      • ByScheduler – признак по расписанию
      • Details - объект детализация
        • SubCode1 – объект доп. описание 1
          • Key – ключ
          • Value – название
        • SubCode2 – объект доп. описание 2
          • Key – ключ
          • Value – название
        • Date – дата услуги
        • IsShowTransportPlan – признак показать транспортный план (для автобусов)
        • Cost – цена
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • PartnerId – ключ партнера
        • ByPax – признак за человека
        • Partner – объект партнер (не заполняется)
          • Key – ключ (не заполняется)
          • Value – название (не заполняется)
      • ParentId – ключ родительской услуги
      • PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
      • ShowOrder – порядок при печати (сортировка) по услуге
      • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
      • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
      • Id – идентификатор услуги
      • SvKey – тип услуги
      • IsSubCode1 – признак наличия доп. описания 1
      • IsSubCode2 – признак наличия доп. описания 2
      • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • BeginDateTime – дата начала услуги
      • EndDateTime – дата окончания
      • IsHooded – признак скрытая
      • IsDeleted – признак удаляемая
      • IsNotCalculate – признак не рассчитываемая
      • PacketId – ключ пакета
      • Index – индекс шаблона услуги
развернутьПример


Расчет индивидуальных услуг (CalculateIndividualServiceCosts)

Метод производит расчет услуг с индивидуальным выбором у туристов.

  • Формат запроса:
    • POST .../TourSearchOwin/CalculateIndividualServiceCosts?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ тура
    • TourDate – дата тура
    • TourDuration – продолжительность тура
    • Currency – код валюты
    • Services – массив индивидуальных услуг
      • ServiceType – тип услуги
      • Code – код услуги
      • SubCode1доп. описание 1
      • SubCode2доп. описание 2
      • Packet – ключ пакета
      • Partner – ключ партнера
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • City – объект город
      • Country – страна услуги
      • Attributes – маска атрибутов услуги
      • Type – тип услуги
      • IsHooded – признак скрытая
      • IsNotCalculated – признак не рассчитываемая
      • BeginDateTimeString – дата начала услуги в строке
      • EndDateTimeString – дата начала услуги в строке
      • TemplateId – номер шаблона услуги
      • Cost – цена услуги
      • ByPax – цена за человека
      • QuotaStatus – объект статус квотирования
        • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
        • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
        • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
      • Index – индекс услуги
      • IsRoute – признак маршрутная услуга
      • ServiceTemplateIndex – индекс шаблона услуги
      • RemoteId – (не используется)
    • Ages – массив возрастов туристов
  • Возвращаемый результат:
    • Массив – массив связок Возраст-Услуга-Цена
      • Age – возраст
      • Service – объект услуга
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1
        • SubCode2доп. описание 2
        • PacketId – ключ пакета услуги
        • PartnerId – ключ партнера
        • Day – день предоставления услуги
        • BeginTime – время начала услуги
        • EndTime – время окончания услуги
        • DurationInNight – продолжительность услуги в ночах
        • Attributes – маска атрибутов услуги
        • CountryId – ключ страны
        • CityId – ключ города
        • Type – тип услуги
        • ShowOrder – порядковый номер
      • SimpleServiceCost – объект цена
        • Brutto – брутто
        • Discount – скидка
развернутьПример


Поиск рейсов из внешней системы (GetGDSFlights)

Метод производит поиск рейсов из внешней системы.

  • Формат запроса:
    • POST .../TourSearchOwin/GetGDSFlights?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):

Внимание! Если в туре используется перелет из GDS, то в параметр flightSettings передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее для получения цены выполняем методы RebuidFlights и CalculateReservation.

    • flightSettings – информация о шаблоне услуги авиаперелета
      • templateId – идентификатор шаблона услуги
      • patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
      • serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
    • service – информация об услуге авиаперелета
      • ServiceType – тип услуги
      • Code – ключ услуги
      • SubCode1доп. описание 1
      • SubCode2доп. описание 2
      • CountryId – страна услуги
      • CityId – город услуги
      • PacketId – пакет услуги
      • PartnerId – партнер услуги
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
    • price – стоимость перелета
    • quotaInfo – объект информация по квотам
      • status – статус по квотам (есть места / нет мест / под запрос)
      • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
      • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
    • flightDateTimeLimitationInterval
      • startLimitation – начало тайм-лимита
      • finishLimitation – объект тайм-лимита
        • dateTimeString – дата окончания тайм-лимита
        • serviceType – тип услуги
        • serviceCode – код услуги
    • flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
    • passengers – информация о пассажирах
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
    • tourDate – дата тура
    • tourCurrency – валюта тура
    • tourId – ключ программы тура
    • filterTariff – информация о тарифах
    • filterDeptime – информация о времени вылета
    • isCommission – признак комиссионной цены
    • baseFlightsParams – параметра авиаперелета
      • CityArrival – город прибытия
      • FlightCode – код авиаперелета
      • TariffKey – ключ тарифа
      • PartnerId – ключ партнера
    • isUpdated – информация об обновлении перелета
    • key – ключ запроса
    • tourDurationByDays – продолжительность перелета
    • langueCode – локализация
  • Возвращаемый результат:
    • validationResult – информация о валидации
      • Errors – ошибки
      • Warnings – предупреждения
      • States – статус
      • IsValid – информация о результате
    • flightsStartEndPointPatterns – информация о начале и окончании перелета
      • fromPoint – информация о перелете отправления
        • country – страна вылета
          • id – ключ
          • description – описание
          • code – код
        • city – город вылета
          • id – ключ
          • description – описание
          • code – код
        • airport – аэропорт вылета
          • id – ключ
          • description – описание
          • code – код
      • toPoint – информация о перелете прибытия
        • country – страна прилета
          • id – ключ
          • description – описание
          • code – код
        • city – город прилета
          • id – ключ
          • description – описание
          • code – код
        • airport – аэропорт прилета
          • id – ключ
          • description – описание
          • code – код
    • passengersAgeInfos – информация о возрасте пассажиров
      • ageType – тип пассажира
      • count – количество человек
    • flightsSequencies – информация о перелете
      • flights – массив данных о перелете из внешнего поставщика
        • – ...
      • deltaPrice – разница в цене
        • amount – стоимость
        • currency – валюта
      • timeForward – время вперед
      • timeBackward – время обратно
      • hasTariffFamily – имеется ли семейство тарифов
      • rating – рейтинг
    • airTravelAdapterFilterValues – дополнительная информация
      • LuggageFilterValue – багаж
      • ClassAirTravelFilterValue – класс перелета
      • ConnectionsFilterValue – пересадки
      • SortFilterValue – сортировка
      • AutomaticFlightSelection – подбор перелета
    • tariff – тариф
    • minFlightTimeForward – минимальное время в пути туда
    • maxFlightTimeForward – максимальное время в пути туда
    • minFlightTimeBackward – минимальное время в пути обратно
    • maxFlightTimeBackward – максимальное время в пути обратно
развернутьПример


Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)

Внимание! Если в туре используется перелет из GDS, то перед этим методом вызывается GetGDSFlights в принимаемые параметры которого передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее текущий метод RebuidFlights и далее CalculateReservation.
Метод возвращает информацию по выбранному перелету от внешнего поставщика.

  • Формат запроса:
    • POST .../TourSearchOwin/RebuildFlights
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • flights – перелеты
      • direction
      • commonPrice – общая стоимость перелета
      • remotePriceSource – данные расчета локального перелета
        • providerId – ID внешнего поставщика
        • flightId – идентификатор внешнего перелета
      • localPriceSource – данные расчета локального перелета
        • packetId – ключ пакета
        • partnerId – идентификатор партнера
      • flightsSequenceSettings – описание параметров последовательности перелетов для которых действуют замены
        • templateId – идентификатор шаблона услуги
        • patternId – идентификатор паттерна услуги
        • serviceId – идентификатор класса услуги
      • segments – сегменты авиаперелета
        • segmentNumber – номер сегмента
        • depratureCity – город отправления
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор в системе внешнего поставщика
            • code – код в системе внешнего поставщика
            • name – имя в системе внешнего поставщика
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование города и страны
          • mtItem – справочная информации локальной системы
            • id – идентификатор в локальной системе
            • code – код в локальной системе
            • name – имя в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга
            • providerId – Id провайдера
            • dictionaryId – Id справочника
            • providerDictionaryItemId – Id справочника внешнего поставщика
            • providerDictionaryItemName – обозначение справочника внешнего поставщика
            • mtDictionaryItemId – Id справочника МТ
            • mtDictionaryItemName – обозначение справочника MT
        • arrivalCity – город прибытия
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор в системе внешнего поставщика
            • code – код в системе внешнего поставщика
            • name – имя в системе внешнего поставщика
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование города и страны
          • mtItem – справочная информации локальной системы
            • id – идентификатор в локальной системе
            • code – код в локальной системе
            • name – имя в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга
            • providerId – Id провайдера
            • dictionaryId – Id справочника
            • providerDictionaryItemId – Id справочника внешнего поставщика
            • providerDictionaryItemName – обозначение справочника внешнего поставщика
            • mtDictionaryItemId – Id справочника МТ
            • mtDictionaryItemName – обозначение справочника MT
        • departureAirport – аэропорт вылета
        • arrivalAirport – аэропорт прилета
          • gdsItem –справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор аэропорта вылета
            • code – код аэропорта вылета
            • name – наименование аэропорта
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование аэропорта города страны
          • mtItem – справочная информации из локальной системы
            • id – идентификатор аэропорта в локальной системе
            • code – код аэропорта в локальной системе
            • name – имя аэропорта в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга аэропорта
            • providerId – Id провайдера аэропорта
            • dictionaryId – Id справочника аэропорта
            • providerDictionaryItemId – Id справочника аэропорта внешнего поставщика
            • providerDictionaryItemName – обозначение справочника аэропорта внешнего поставщика
            • mtDictionaryItemId – Id справочника аэропорта МТ
            • mtDictionaryItemName – обозначение справочника аэропорта MT
        • airline – авиакомпания
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор авиакомпании внешней системы
            • languageId – идентификатор языка
            • id – идентификатор авиакомпании
            • code – код авиакомпании
            • name – наименование авиакомпании
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование авиакомпании
          • mtItem – справочная информация из локальной системы
            • id – идентификатор авиакомпании в локальной системе
            • code – код авиакомпании в локальной системе
            • name – наименование авиакомпании в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование авиакомпании
          • mapping – связка
            • id – Id маппинга авиакомпании
            • providerId – Id провайдера авиакомпании
            • dictionaryId – Id справочника авиакомпании
            • providerDictionaryItemId – Id справочника авиакомпании внешнего поставщика
            • providerDictionaryItemName – обозначение справочника авиакомпании внешнего поставщика
            • mtDictionaryItemId – Id справочника авиакомпании МТ
            • mtDictionaryItemName – обозначение справочника авиакомпании MT
        • aircraft – воздушное судно
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор воздушного судна внешней системы
            • languageId – идентификатор языка
            • id – идентификатор воздушного судна
            • code – код воздушного судна
            • name – наименование воздушного судна
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование воздушного судна
          • mtItem – справочная информация из локальной системы
            • id – идентификатор воздушного судна в локальной системе
            • code – код воздушного судна в локальной системе
            • name – наименование воздушного судна в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование воздушного судна
          • mapping – связка
            • id – Id маппинга воздушного судна
            • providerId – Id провайдера воздушного судна
            • dictionaryId – Id справочника воздушного судна
            • providerDictionaryItemId – Id справочника воздушного судна внешнего поставщика
            • providerDictionaryItemName – обозначение справочника воздушного судна внешнего поставщика
            • mtDictionaryItemId – Id справочника воздушного судна МТ
            • mtDictionaryItemName – обозначение справочника воздушного судна MT
        • tariff – тариф
          • gdsItem – справочная информация внешней системы
            • id – идентификатор тарифа
            • code – код тарифа
            • name – наименование тарифа
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование тарифа
          • mtItem – справочная информация из локальной системы
          • mapping – связка
        • flightNumber – номер перелета
        • baggageRestriction – ограничение провоза багажа
        • caryyOncarry – ограничение ручной клади
        • departureDate – дата вылета
        • arrivalDate – дата прилета
        • quotaInfo – объект информация по квотам
          • status – статус по квотам (есть места / нет мест / под запрос)
          • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
    • tourDate – дата тура
  • Возвращаемый результат:
    • flights – информация о рейсах
      • remoteFlightId – идентификатор внешнего перелета
      • flightsSettings – внутренняя информация о перелете
        • templateId – идентификатор шаблона услуги
        • patternId – идентификатор паттерна услуги
        • serviceId – идентификатор класса услуги
      • flightsPlains – планы полетов
        • DepartureCity – город вылета
          • Key – ключ города
          • Value – наименование города
        • DepartureCountry – страна вылета
          • Key – ключ страны
          • Value – наименование страны
        • ArrivalCity – город прибытия
          • Key – ключ города
          • Value – наименование города
        • ArrivalCountry – страна прибытия
          • Key – ключ страны
          • Value – наименование страны
        • DepartureAirport – аэропорт вылета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • ArrivalAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • Airline – авиакомпания
          • Id – идентификатор авиакомпании
          • "Value – наименование авиакомпании
          • "Key – ключ авиакомпании
        • Aircraft – воздушное судно
          • Key – ключ воздушного судна
          • Value – наименование воздушного судна
        • Flight – рейс
          • Key – ключ рейса
          • Value – наименование рейса
        • DepartureTime – время отправления
        • ArrivalTime – время прибытия
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – детали авиаперелета
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – наименование тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – информация о шаблоне услуги авиаперелета
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор внешнего перелета
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
развернутьПример


Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)

Метод получает семейства тарифов для авиаперелетов из внешней системы.

  • Формат запроса:
    • POST .../TourSearchOwin/GetGDSFlightFareFamilies?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • flightId – ID внешнего перелета
    • providerId – ID внешнего провайдера
    • languageCode – код локализации
    • passengers – информация о пассажирах
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
    • currency – валюта
    • price – стоимость
    • param – параметры перелета
      • flightsSource – параметры перелета
        • flightSettings – информация о шаблоне услуги авиаперелета
          • templateId – идентификатор шаблона услуги
          • patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
        • service – информация об услуге авиаперелета
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • CountryId – страна услуги
          • CityId – город услуги
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • price – стоимость перелета
        • quotaInfo – объект информация по квотам
          • status – статус по квотам (есть места / нет мест / под запрос)
          • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • flightDateTimeLimitationInterval
          • startLimitation – начало тайм-лимита
          • finishLimitation – объект тайм-лимита
            • dateTimeString – дата окончания тайм-лимита
            • serviceType – тип услуги
            • serviceCode – код услуги
        • flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
      • passengers – информация о пассажирах
        • IsMain – главный турист
        • Number – порядковый номер туриста
        • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
        • MaleFemaleSex – пол (0 – мужской, 1 – женский)
        • FirstName – имя (лат)
        • LastName – фамилия (лат)
        • Patronymic – отчество (лат)
        • FirstNameRus – имя (рус)
        • LastNameRus – фамилия (рус)
        • PatronymicRus – отчество (рус)
        • InternationalPassportSeries – серия загранпаспорта
        • InternationalPassportNumber – номер загранпаспорта
        • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
        • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
        • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
        • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
        • internationalPassportByWhom – кем выдан загранпаспорт
        • PassportSeries – серия паспорта
        • PassportNumber – номер паспорта
        • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
        • PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
        • PassportByWhom – кем выдан паспорт
        • Citizenship – название страны
        • Phone – телефон
        • Email – e-mail
        • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
        • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
        • BirthPlace – место рождения
        • CitizenID – гражданство
        • Age – количество полных лет на момент окончания тура
      • tourDate – дата тура
      • tourCurrency – валюта тура
      • tourId – ключ программы тура
      • filterTariff – информация о тарифах
      • filterDeptime – информация о времени вылета
      • isCommission – признак комиссионной цены
      • baseFlightsParams – параметра авиаперелета
        • CityArrival – город прибытия
        • FlightCode – код авиаперелета
        • TariffKey – ключ тарифа
        • PartnerId – ключ партнера
      • isUpdated – информация об обновлении перелета
      • key – ключ запроса
      • tourDurationByDays – продолжительность перелета
      • langueCode – локализация
  • Возвращаемый результат:
    • validationResult – информация о валидации
      • Errors – ошибки
      • Warnings – предупреждения
      • States – статус
      • IsValid – информация о результате
    • tariffSequencies – информация тарифах
      • flightId – идентификатор перелета
      • universalParametrsSequence – параметры тарифов
        • universalParametrs – массив параметров
          • code – описание параметра тарифа
          • priority – приоритет показа
          • needToPay – нужна ли доплата
          • shortDescriptions – краткое описание
            • code – код
            • value – значение
      • price – стоимость
      • deltaPrice – разница в цене
      • timeLimit – тайм-лимит
      • segments – сегменты
      • depAirportCode – код аэропорта отправления
      • depCityCode – код города отправления
      • arrAirportCode – код аэропорта прибытия
      • arrCityCode – код города прибытия


развернутьПример


Загрузка филиалов (Branches) начиная с релиза 15.3

Метод производит выгрузку филиалов бронирования.

  • Формат запроса:
    • GET .../TourSearchOwin/Branches?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • ids – массив ключей филиалов
    • cityKey – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы)
  • Возвращаемый результат:
    • Key – ключ филиала (ключ партнера)
    • Value – название филиала (название партнера)
развернутьПример



Загрузка ведущих менеджеров (Users) начиная с релиза 15.3

Метод производит выгрузку ведущих менеджеров.

  • Формат запроса:
    • GET .../TourSearchOwin/Users?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • ids – массив ключей ведущих менеджеров
    • branchKey – ключ филиала бронирования, к которому они привязаны
  • Возвращаемый результат:
    • Key – ключ ведущего менеджера
    • Value – полное имя ведущего менеджера
развернутьПример



Расчет путевки (CalculateReservation)

Метод производит расчет стоимости путевки.

  • Формат запроса:
    • POST .../TourSearchOwin/CalculateReservation?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса:
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • initialPrice * – объект изначальная цена
      • price * – цена
      • currency * – код валюты
    • Services * – массив услуг
      • Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
        • ServiceType * – тип услуги (поле sv_key из таблицы service)
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:

None = 0,если услуга удаляемая, эта настройка находится в программе туров,
Delete = 1,
CodeEdit = 2,
SubCode1Edit = 4,
CityEdit = 8,
PartnerEdit = 16,
BadCheck = 32,
Invisible = 64, отображаемая
DurationEdit = 128,
FullEdit = Delete | CodeEdit | SubCode1Edit | SubCode2Edit | CityEdit | PartnerEdit | DurationEdit,
Host = 256,
HostChangeCode2 = Host | 512,
HostChangeCode1 = Host | 1024,
HostChangeCode = Host | 2048,
HostChangePartner = Host | 4096,
HostChangePacket = Host | 8192,
Depended = 16384,
DependedCode2 = Depended | 512,
DependedCode1 = Depended | 1024,
DependedCode = Depended | 2048,
DependedCity = Depended | 4096,
DependedCountry = Depended | 8192,
FullDepended = Depended | DependedCode2 | DependedCode1 | DependedCode | DependedCity | DependedCountry,
NotCalculate = 32768,не рассчитываемая,
SubCode2Edit = 65536,
GDSService = 131072, от внешней системы)

        • *IsRemovable – (не обрабатывается)
        • *Type – тип услуги в путевке. Может принимать значения:

None (0) – не установлено,
Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.
Optional (2) – Дополнительная услуга,
NYDinner (4) – Новогодний ужин,
FlightAdditionalPayment (8) – Доплата на перелет,
TourWebDifference (16) – Разница в СПО,
AddedByCalculator (32) – Добавленная при рассчете путевки,
AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,
BaseChanged (128) – базовая измененная услуга,
HotelAdditionalPayment (256) – доплата на отель

        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – порядок расположения шаблона услуги в внутри самой услуги в программе тура

индекс шаблона услуги

        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места / нет мест / под запрос)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга (Перелет, автобусный переезд, жд переезд, трансфер, экскурсия)
        • ServiceTemplateIndex * – индекс шаблона услуги (Порядок расположения услуги в программе тура. Не отображается в программе туров,это просто порядковый номер услуги в путевке)

индекс шаблона услуги

        • RemoteId * – информация об услуге во внешней системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
          • CityArrival * – ключ города прибытия обратного перелета
          • FlightCode * – ключ обратного авиаперелета
          • TariffKey * – ключ тарифа обратного авиаперелета
          • PartnerId * – ключ партнера обратного авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – гражданство
      • Age * – количество полных лет на момент окончания тура
    • Day * – день (перевод) Может быть с пустым значением
    • Day2 * – дня (перевод) Может быть с пустым значением
    • Days * – дней (перевод) Может быть с пустым значением
    • Night * – ночь (перевод) Может быть с пустым значением
    • Night2 * – ночи (перевод) Может быть с пустым значением
    • Nights * – ночей (перевод) Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
    • at * – на (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
  • Возвращаемый результат:
    • IsValid – признак валидности путевки
    • ErrorMessage – сообщение об ошибке, если есть
    • CalculatedReservation – объект рассчитанной путевки
      • TourKey – ключ тура
      • BeginDate – дата начала тура
      • Duration – продолжительность путевки в днях
      • Currency – код валюты тура
      • CalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура
      • ChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг
      • Price – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
      • TotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
      • IsDiscountIsPercent – признак, в процентах ли дается партнерская комиссия или в y.e.
      • NationalChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг (в национальной валюте)
      • NationalTotalDiscount – партнерская комиссия агентству (в национальной валюте)
      • NationalTotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)
      • NatinoalCalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура (в национальной валюте)
      • NationalPrice – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
      • Discount – партнерская комиссия агентству (в процентах или y.e.)
      • TotalDiscount – партнерская комиссия агентству (в валюте тура)
      • ServiceTourists – массив услуг, входящих в тур
        • ServiceType – тип услуги
        • Day – день предоставления
        • DurationInNight – продолжительность в ночах
        • Time – время начала услуги
        • Name – полное описание услуги
        • TouristCount – количество туристов на услуге
        • Attributes – битовая маска атрибутов
        • Type – тип услуги (основная/дополнительная)
        • Brutto – цена брутто
        • NationalBrutto – цена брутто в национальной валюте
        • TotalBrutto – итоговое брутто
    • TourName – название тура
    • BookingConditions – разметка условия бронирования
    • EndDate – дата окончания тура
    • DurationInNights – продолжительность тура в ночах
    • NationalCurrency – код национальной валюты
развернутьПример


Бронирование путевки (CreateReservation)

Метод производит бронирование путевки.
При бронировании проверяется корректность заполнения обязательных полей туристов (регулируется общими настройками, либо в справочнике Страны). В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.

  • Формат запроса:
    • PUT .../TourSearchOwin/CreateReservation/1?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры PUT запроса:
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура (YYYY-MM-DDThh:mm:ss)
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • Services * – массив услуг
      • Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
        • ServiceType * – тип услуги (поле sv_key из таблицы service)
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг
        • IsRemovable * – (не обрабатывается)
        • Type * – тип услуги в путевке (базовая дополнительная)
        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – шаблон услуги
        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга
        • ServiceTemplateIndex * – индекс шаблона услуги
        • RemoteId * – информация об услуге во внешний системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
          • CityArrival * – ключ города прибытия обратного перелета
          • FlightCode * – ключ обратного авиаперелета
          • TariffKey * – ключ тарифа обратного авиаперелета
          • PartnerId * – ключ партнера обратного авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – ID туриста (задается в карточке постоянного клиента)
      • Age * – количество полных лет на момент окончания тура
    • BranchId * – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур. Может быть с пустым значением
    • OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура. Может быть с пустым значением
    • Day * – день (перевод) Может быть с пустым значением
    • Day2 * – дня (перевод) Может быть с пустым значением
    • Days * – дней (перевод) Может быть с пустым значением
    • Night * – ночь (перевод) Может быть с пустым значением
    • Night2 * – ночи (перевод) Может быть с пустым значением
    • Nights * – ночей (перевод) Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
    • OrderInfoUrl – Адрес окна путевки в личном кабинете
    • DogovorComment – Комментарий к путевке (сохраняется как сообщения в истории путевки) Может быть с пустым значением


  • Возвращаемый результат:
    • Reservation – объект путевки
      • $id – внутренний идентификатор для установки связей между сущностями,
      • Code – код путевки
      • TurDate – дата заезда
      • TRKey – ключ тура
      • CNKey – ключ страны
      • CTKey – ключ города
      • NMen – количество туристов по путевке
      • Price – стоимость путевки за вычетом скидки (комиссии)
      • Payed – оплаченная сумма по путевке
      • NDay – продолжительность тура в днях
      • MainMan – ФИО лица, заключившего договор
      • MainManPhone – номер телефона лица, заключившего договор
      • MainManAddress – адрес лица, заключившего договор
      • MainManPassport – паспортные данные лица, заключившего договор
      • PartnerKey – ключ партнера, оформившего договор
      • Operator – ФИО создателя договора
      • Discount – величина скидки на одного человека
      • DiscountSum – абсолютная величина скидки
      • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
      • CrDate – дата и время создания путевки
      • Rate – код валюты путевки
      • Advertise – ключ источника рекламы
      • Locked – блокировка путевки: 1 – если заблокирована
      • CauseDisc – ключ основания для скидки
      • PPaymentDate – максимальная дата внесения предоплаты
      • PaymentDate – максимальная дата полной оплаты
      • Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
      • TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
      • ARKey – ключ причины аннуляции путевки
      • Key – ключ договора
      • CodePartner – значение ключевого поля из таблицы партнеров
      • FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
      • IsOutDoc – статус выдачи документов
      • Notes – сообщение поставщику
      • DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
      • PriceBfrAnn – стоимость путевки перед ее аннуляцией
      • RazmerP – размер предоплаты
      • LeadDepartment – ключ отдела, ведущего данный тур
      • MainManEmail – адрес е-mail из данных лица, заключившего договор
      • MainManComment – примечание из данных лица, заключившего договор
      • DupUserKey – ключ представителя партнера, которым был оформлен договор
      • BTKey – ключ системы бронирования, из которой был оформлен договор
      • ConfirmedDate – дата подтверждения путевки покупателю
      • PrtDogKey – договор партнера, по которому оформлена путевка
      • CTDepartureKey – ключ города начала поездки
      • PDTType – тип договора, по которому оформлена путевка
      • NationalCurrencyPrice – стоимость путевки в национальной валюте
      • NationalCurrencyDiscountSum – значение скидки в национальной валюте
      • NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
      • CurrencyKey – ключ национальной валюты путевки
      • CurrencyRate – курс национальной валюты путевки
      • ClientKey – ключ частника, которым был оформлен договор
      • Partner – информация о партнере покупателе, привязанным к путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • Key – ключ партнера покумателя
        • FullName – полное имя партнера
        • Name – имя партнера
      • Services – коллекция услуг в данной путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки
        • TurDate – дата начала тура
        • Key – ключ услуги
        • PaketKey – ключ пакета
        • TRKey – клют тура
        • SVKey – ключ типа услуги
        • Name – наименование услуги
        • Day – порядковый номер дня тура, в который предоставляется услуга
        • Code – ключ кода услуги
        • SubCode1 – ключ доп.описания 1 услуги
        • SubCode2 – ключ доп.описания 2 услуги
        • Men – количество человек, пользующихся услугой по путевке
        • Days – количество дней услуги
        • CNKey – ключ страны услуги
        • CTKey – ключ города услуги
        • PartnerKey – ключ партнера, предоставляющего услугу
        • Brutto – стоимость услуги брутто
        • Wait – признак услуги Снимать квоту при бронировании
        • Warning – неиспользуемое поле
        • TimeBeg – поле используется для сортировки услуг в путевке
        • Control – ключ статуса услуги (ссылка на таблицу Controls),
        • Attribute – атрибут услуги
        • DateBeg – дата начала действия услуги
        • DateEnd – дата окончания действия услуги
        • Discount – размер скидки по услуге
        • Comment – комментарий к услуге
        • DGKey – ключ договора,
        • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
        • NameLat – наименование услуги (латинский)
        • Long – продолжительность тура в днях
        • TRFId – ключ тарифа
        • CreateDate – дата создания услуги в путевке
        • CalculatePriceDate – дата расчета цены
        • ShowOrder – порядок при сортировке
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • Turists – коллекция туристов в данной путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки, к которому привязан турист
        • Key – ключ туриста
        • TurDate – дата начала тура
        • NameRus – фамилия туриста (русское)
        • NameLat – фамилия туриста (латинское)
        • ShortName – имя и отчество туриста в формате И.О.
        • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
        • FNameRus – имя туриста (русское)
        • FNameLat – имя туриста (латинское)
        • SNameRus – отчество туриста (русское)
        • SNameLat – отчество туриста (латинское)
        • BirthDay – дата рождения туриста
        • BirthCountry – страна рождения туриста
        • BirthCity – город рождения туриста
        • Citizen – гражданство туриста
        • PostIndex – почтовый индекс
        • PostCity – адрес проживания туриста (город)
        • PostStreet – адрес проживания туриста (улица)
        • PostBild – адрес проживания туриста (номер дома)
        • PostFlat – адрес проживания туриста (номер квартиры)
        • Phone – номер телефона туриста
        • PhoneCode – код телефона туриста
        • PasportType – серия заграничного паспорта
        • PasportNum – номер заграничного паспорта
        • PasportDate – дата выдачи заграничного паспорта
        • PasportDateEnd – дата окончания срока действия заграничного паспорта
        • PasportByWhom – кем выдан заграничный паспорт
        • Place – место рождения
        • IsAnketa – выдавалась ли анкета
        • PaspRuser – серия общегражданского паспорта
        • PaspRuNum – номер общегражданского паспорта
        • PaspRuDate – дата выдачи общегражданского паспорта
        • PaspRuByWhom – кем выдан общегражданский паспорт
        • ClientId – ключ в таблице клиентов
        • IsMain – признак главного туриста по путевке
        • DGKey – ключ кутевки
        • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
        • Email – е-mail туриста
        • EnableSmsNotifications – согласен получать уведомления по СМС
        • CitizenId – идентификатор туриста
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • TuristServices – коллекция связей туриста с услугой
        • $id – внутренний идентификатор для установки связей между сущностями
        • TUKey – ключ туриста
        • DLKey – ключ услуги
        • NumDoc – номер документа (авиабилета)
        • NumRoom – номер комнаты (каюты)
        • Seat – номер места (в номере отеля, каюты) или место в транспорте
        • Area – зона (палуба) в отеле, круизе
        • DocDate – дата документа (авиабелета)
        • Key – первичный ключ связки
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • DogovorMessages – сообщение по путевке покупателю
        • id – внутренний идентификатор для установки связей между сущностями
        • Date – дата создание сообщения
        • Text – текст сообщения
        • Remark – код сообщения
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
    • ValidationResultSummary – объект статус результата бронирования
      • ValidationResult – объект с ошибками и флагом валидности путевки
        • Errors – массив ошибок бронирования
        • IsValid – признак валидности бронирования
      • ValidationResultAttributes – атрибут результата бронирования
развернутьПример запроса


развернутьПример ответа


Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)

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

  • Формат запроса:
    • PUT .../TourSearchOwin/CreateReservationExternalSystem/1?
  • Принимаемые параметры headers (* – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры PUT запроса:
    • BeginDate * – дата начала тура (YYYY-MM-DDThh:mm)
    • Duration * – продолжительность тура в днях
    • Currency * – код валюты
    • TourProgramId – идентификатор турпрограммы (необязательный, по умолчанию 0)
    • Services * – массив услуг, в данном случае будет содержать только услугу отель
      • Code * – идентификатор отеля во внешней системе, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
      • Cost * – стоимость проживания за весь период
      • Packet * – идентификатор пакета, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
      • SubCode1 * – идентификатор типа номера, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
    • Tourists * – массив туристов
      • FirstName * – имя туриста
      • LastName * – фамилия туриста
      • Patronymic * – отчество туриста
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • Age * – количество полных лет на момент окончания тура
      • Phone * – телефон (обязателен для первого туриста)
      • Email * – e-mail (обязателен для первого туриста)
    • DogovorComment * – комментарий к путевке (ограничение 254 символа, при превышении разбивается на части)
Am 063.png


1. В случае, если в теле запроса указываются ID несинхронизированных отелей, пакета, типа номера, то создаются фиктивные данные, которые необходимо изменить в услуге экрана Путевка (пример: Отель – ApiHotel, пакет – ApiPacket, тип номера – ApiRoom(ApiRoomCategory),ApiAccmdmen)
2. Тип питания всегда будет создаваться фиктивный и его необходимо изменить в услуге экрана Путевка (пример: Тип питания – ApiPansion)


  • Возвращаемый результат:
    • Reservation – объект путевки
      • $id – внутренний идентификатор для установки связей между сущностями,
      • Code – код путевки
      • TurDate – дата начала тура
      • TRKey – идентификатор тура
      • CNKey – идентификатор страны
      • CTKey – идентификатор города
      • NMen – количество туристов
      • Price – стоимость путевки
      • Payed – оплаченная сумма
      • NDay – продолжительность тура в днях
      • MainMan – контактное лицо
      • MainManPhone – телефон контактного лица
      • MainManAddress – адрес лица, заключившего договор
      • MainManPassport – паспортные данные контактного лица
      • PartnerKey – идентификатор партнера
      • Operator – оператор, оформивший путевку
      • Discount – размер скидки
      • DiscountSum – сумма скидки
      • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
      • CrDate – дата создания путевки
      • Rate – код валюты путевки
      • Advertise – идентификатор рекламного источника
      • Locked – статус блокировки путевки
      • CauseDisc – код основания скидки
      • PPaymentDate – дата предоплаты
      • PaymentDate – максимальная дата полной оплаты
      • Procent – предоплата в %
      • TurDateBfrAnnul – дата начала тура до аннуляции
      • ARKey – идентификатор причины аннуляции
      • Key – идентификатор договора
      • CodePartner – идентификатор партнера
      • FilialKey – идентификатор филиала
      • IsOutDoc – статус выдачи документов
      • Notes – примечания
      • DiscSumBfrAnn – сумма скидки перед аннуляцией
      • PriceBfrAnn – цена путевки перед аннуляцией
      • RazmerP – размер предоплаты
      • LeadDepartment – идентификатор ведущего отдела
      • MainManEmail – e-mail контактного лица
      • MainManComment – комментарий контактного лица
      • DupUserKey – идентификатор представителя агента
      • BTKey – идентификатор системы бронирования
      • ConfirmedDate – дата подтверждения путевки
      • PrtDogKey – идентификатор договора партнера
      • CTDepartureKey – идентификатор города отправления
      • PDTType – тип договора путевки
      • NationalCurrencyPrice – цена в национальной валюте
      • NationalCurrencyDiscountSum – сумма скидки в национальной валюте
      • NationalCurrencyPayed – оплаченная сумма в национальной валюте
      • CurrencyKey – идентификатор валюты
      • CurrencyRate – курс валюты
      • ClientKey – идентификатор клиента
      • AgencyPrice – цена для агентства
      • Partner – информация о партнере
        • $id – идентификатор записи
        • Key – идентификатор партнера
        • FullName – полное название партнера
        • Name – краткое название партнера
      • Services – список услуг
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки
        • TurDate – дата начала тура
        • Key – ключ услуги
        • PaketKey – ключ пакета
        • TRKey – клют тура
        • SVKey – ключ типа услуги
        • Name – наименование услуги
        • Day – порядковый номер дня тура, в который предоставляется услуга
        • Code – ключ кода услуги
        • SubCode1 – ключ доп.описания 1 услуги
        • SubCode2 – ключ доп.описания 2 услуги
        • Men – количество человек, пользующихся услугой по путевке
        • Days – количество дней услуги
        • CNKey – ключ страны услуги
        • CTKey – ключ города услуги
        • PartnerKey – ключ партнера, предоставляющего услугу
        • Brutto – стоимость услуги брутто
        • Wait – признак услуги Снимать квоту при бронировании
        • Warning – неиспользуемое поле
        • TimeBeg – поле используется для сортировки услуг в путевке
        • Control – ключ статуса услуги (ссылка на таблицу Controls),
        • Attribute – атрибут услуги
        • DateBeg – дата начала действия услуги
        • DateEnd – дата окончания действия услуги
        • Discount – размер скидки по услуге
        • Comment – комментарий к услуге
        • DGKey – ключ договора,
        • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
        • NameLat – наименование услуги (латинский)
        • Long – продолжительность тура в днях
        • TRFId – ключ тарифа
        • CreateDate – дата создания услуги в путевке
        • CalculatePriceDate – дата расчета цены
        • ShowOrder – порядок при сортировке
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • Turists – список туристов
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки, к которому привязан турист
        • Key – ключ туриста
        • TurDate – дата начала тура
        • NameRus – фамилия туриста (русское)
        • NameLat – фамилия туриста (латинское)
        • ShortName – имя и отчество туриста в формате И.О.
        • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
        • FNameRus – имя туриста (русское)
        • FNameLat – имя туриста (латинское)
        • SNameRus – отчество туриста (русское)
        • SNameLat – отчество туриста (латинское)
        • BirthDay – дата рождения туриста
        • BirthCountry – страна рождения туриста
        • BirthCity – город рождения туриста
        • Citizen – гражданство туриста
        • PostIndex – почтовый индекс
        • PostCity – адрес проживания туриста (город)
        • PostStreet – адрес проживания туриста (улица)
        • PostBild – адрес проживания туриста (номер дома)
        • PostFlat – адрес проживания туриста (номер квартиры)
        • Phone – номер телефона туриста
        • PhoneCode – код телефона туриста
        • PasportType – серия заграничного паспорта
        • PasportNum – номер заграничного паспорта
        • PasportDate – дата выдачи заграничного паспорта
        • PasportDateEnd – дата окончания срока действия заграничного паспорта
        • PasportByWhom – кем выдан заграничный паспорт
        • Place – место рождения
        • IsAnketa – выдавалась ли анкета
        • PaspRuser – серия общегражданского паспорта
        • PaspRuNum – номер общегражданского паспорта
        • PaspRuDate – дата выдачи общегражданского паспорта
        • PaspRuByWhom – кем выдан общегражданский паспорт
        • ClientId – ключ в таблице клиентов
        • IsMain – признак главного туриста по путевке
        • DGKey – ключ кутевки
        • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
        • Email – е-mail туриста
        • EnableSmsNotifications – согласен получать уведомления по СМС
        • CitizenId – идентификатор туриста
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • TuristServices – коллекция связей туриста с услугой
        • $id – внутренний идентификатор для установки связей между сущностями
        • TUKey – ключ туриста
        • DLKey – ключ услуги
        • NumDoc – номер документа (авиабилета)
        • NumRoom – номер комнаты (каюты)
        • Seat – номер места (в номере отеля, каюты) или место в транспорте
        • Area – зона (палуба) в отеле, круизе
        • DocDate – дата документа (авиабелета)
        • Key – первичный ключ связки
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • DogovorMessages – сообщение по путевке покупателю
        • id – внутренний идентификатор для установки связей между сущностями
        • Date – дата создание сообщения
        • Text – текст сообщения
        • Remark – код сообщения
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
    • ValidationResultSummary – объект статус результата бронирования
      • ValidationResult – объект с ошибками и флагом валидности путевки
        • Errors – массив ошибок бронирования
        • IsValid – признак валидности бронирования
      • ValidationResultAttributes – атрибут результата бронирования


развернутьПример запроса



развернутьПример ответа


Выгрузка информации о путевке (GetReservation)

Метод выводит информацию о бронированной путевке.

  • Формат запроса:
    • GET .../TourSearchOwin/GetReservation?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры GET запроса ( * – обязательный):
    • dgCode * – номер путевки:
  • Возвращаемый результат:
    • $id – внутренний идентификатор для установки связей между сущностями,
    • Code – код путевки
    • TurDate – дата заезда
    • TRKey – ключ тура
    • CNKey – ключ страны
    • CTKey – ключ города
    • NMen – количество туристов по путевке
    • Price – стоимость путевки за вычетом скидки (комиссии)
    • Payed – оплаченная сумма по путевке
    • NDay – продолжительность тура в днях
    • MainMan – ФИО лица, заключившего договор
    • MainManPhone – номер телефона лица, заключившего договор
    • MainManAddress – адрес лица, заключившего договор
    • MainManPassport – паспортные данные лица, заключившего договор
    • PartnerKey – ключ партнера, оформившего договор
    • Operator – ФИО создателя договора
    • Discount – величина скидки на одного человека
    • DiscountSum – абсолютная величина скидки
    • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
    • CrDate – дата и время создания путевки
    • Rate – код валюты путевки
    • Advertise – ключ источника рекламы
    • Locked – блокировка путевки: 1 – если заблокирована
    • CauseDisc – ключ основания для скидки
    • PPaymentDate – максимальная дата внесения предоплаты
    • PaymentDate – максимальная дата полной оплаты
    • Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
    • TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
    • ARKey – ключ причины аннуляции путевки
    • Key – ключ договора
    • CodePartner – значение ключевого поля из таблицы партнеров
    • FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
    • IsOutDoc – статус выдачи документов
    • Notes – сообщение поставщику
    • DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
    • PriceBfrAnn – стоимость путевки перед ее аннуляцией
    • RazmerP – размер предоплаты
    • LeadDepartment – ключ отдела, ведущего данный тур
    • MainManEmail – адрес е-mail из данных лица, заключившего договор
    • MainManComment – примечание из данных лица, заключившего договор
    • DupUserKey – ключ представителя партнера, которым был оформлен договор
    • BTKey – ключ системы бронирования, из которой был оформлен договор
    • ConfirmedDate – дата подтверждения путевки покупателю
    • PrtDogKey – договор партнера, по которому оформлена путевка
    • CTDepartureKey – ключ города начала поездки
    • PDTType – тип договора, по которому оформлена путевка
    • NationalCurrencyPrice – стоимость путевки в национальной валюте
    • NationalCurrencyDiscountSum – значение скидки в национальной валюте
    • NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
    • CurrencyKey – ключ национальной валюты путевки
    • CurrencyRate – курс национальной валюты путевки
    • ClientKey – ключ частника, которым был оформлен договор
    • Partner – информация о партнере покупателе, привязанным к путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • Key – ключ партнера покумателя
      • FullName – полное имя партнера
      • Name – имя партнера
    • Services – коллекция услуг в данной путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • DGCod – номер путевки
      • TurDate – дата начала тура
      • Key – ключ услуги
      • PaketKey – ключ пакета
      • TRKey – клют тура
      • SVKey – ключ типа услуги
      • Name – наименование услуги
      • Day – порядковый номер дня тура, в который предоставляется услуга
      • Code – ключ кода услуги
      • SubCode1 – ключ доп.описания 1 услуги
      • SubCode2 – ключ доп.описания 2 услуги
      • Men – количество человек, пользующихся услугой по путевке
      • Days – количество дней услуги
      • CNKey – ключ страны услуги
      • CTKey – ключ города услуги
      • PartnerKey – ключ партнера, предоставляющего услугу
      • Brutto – стоимость услуги брутто
      • Wait – признак услуги Снимать квоту при бронировании
      • Warning – неиспользуемое поле
      • TimeBeg – поле используется для сортировки услуг в путевке
      • Control – ключ статуса услуги (ссылка на таблицу Controls),
      • Attribute – атрибут услуги
      • DateBeg – дата начала действия услуги
      • DateEnd – дата окончания действия услуги
      • Discount – размер скидки по услуге
      • Comment – комментарий к услуге
      • DGKey – ключ договора,
      • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
      • NameLat – наименование услуги (латинский)
      • Long – продолжительность тура в днях
      • TRFId – ключ тарифа
      • CreateDate – дата создания услуги в путевке
      • CalculatePriceDate – дата расчета цены
      • ShowOrder – порядок при сортировке
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • Turists – коллекция туристов в данной путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • DGCod – номер путевки, к которому привязан турист
      • Key – ключ туриста
      • TurDate – дата начала тура
      • NameRus – фамилия туриста (русское)
      • NameLat – фамилия туриста (латинское)
      • ShortName – имя и отчество туриста в формате И.О.
      • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
      • FNameRus – имя туриста (русское)
      • FNameLat – имя туриста (латинское)
      • SNameRus – отчество туриста (русское)
      • SNameLat – отчество туриста (латинское)
      • BirthDay – дата рождения туриста
      • BirthCountry – страна рождения туриста
      • BirthCity – город рождения туриста
      • Citizen – гражданство туриста
      • PostIndex – почтовый индекс
      • PostCity – адрес проживания туриста (город)
      • PostStreet – адрес проживания туриста (улица)
      • PostBild – адрес проживания туриста (номер дома)
      • PostFlat – адрес проживания туриста (номер квартиры)
      • Phone – номер телефона туриста
      • PhoneCode – код телефона туриста
      • PasportType – серия заграничного паспорта
      • PasportNum – номер заграничного паспорта
      • PasportDate – дата выдачи заграничного паспорта
      • PasportDateEnd – дата окончания срока действия заграничного паспорта
      • PasportByWhom – кем выдан заграничный паспорт
      • Place – место рождения
      • IsAnketa – выдавалась ли анкета
      • PaspRuser – серия общегражданского паспорта
      • PaspRuNum – номер общегражданского паспорта
      • PaspRuDate – дата выдачи общегражданского паспорта
      • PaspRuByWhom – кем выдан общегражданский паспорт
      • ClientId – ключ в таблице клиентов
      • IsMain – признак главного туриста по путевке
      • DGKey – ключ кутевки
      • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
      • Email – е-mail туриста
      • EnableSmsNotifications – согласен получать уведомления по СМС
      • CitizenId – идентификатор туриста
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • TuristServices – коллекция связей туриста с услугой
      • $id – внутренний идентификатор для установки связей между сущностями
      • TUKey – ключ туриста
      • DLKey – ключ услуги
      • NumDoc – номер документа (авиабилета)
      • NumRoom – номер комнаты (каюты)
      • Seat – номер места (в номере отеля, каюты) или место в транспорте
      • Area – зона (палуба) в отеле, круизе
      • DocDate – дата документа (авиабелета)
      • Key – первичный ключ связки
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • DogovorMessages – сообщение по путевке покупателю
      • id – внутренний идентификатор для установки связей между сущностями
      • Date – дата создание сообщения
      • Text – текст сообщения
      • Remark – код сообщения
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
развернутьПример


Выгрузка информации о ценовых блоках (CostOfferDescriptions)

Метод принимает на вход ключи ценовых блоков и возвращает, прикреплённое к ним описание.

  • Формат запроса:
    • GET .../TourSearchOwin/CostOfferDescriptions?
  • Принимаемые параметры ( * – обязательный):
    • COKeysString * – ключи ценовых блоков через запятую
  • Возвращаемый результат:
    • CostOfferImageInfo – коллекция объектов из двух полей:
      • IdCostOffer – ключ ценового блока
      • InfoText – описание ценового блока
развернутьПример



Получение капчи (GetCaptcha)

Метод возвращает капчу (используется при регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/GetCaptcha?
  • Принимаемые параметры ( * – обязательный):
    • sessionId * – Id сессии
  • Возвращаемый результат:
    • FileContents – файл капчи в бинарном виде
    • ContentType – расширение файла (image/jpeg)
    • FileDownloadName – имя файла
развернутьПример


Проверка капчи (CheckCaptcha)

Метод проверяет введенную капчу (используется при регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/CheckCaptcha?
  • Принимаемые параметры ( * – обязательный):
    • captchaText * – текст капчи
    • sessionId * – Id сессии
  • Возвращаемый результат:
    • true/false – результат проверки (false – капча или Id сессии неверные, true – капча верна)
развернутьПример


Проверка e-mail (CheckMail)

Метод проверяет e-mail при регистрации частного лица на существование такого же e-mail в базе данных.

  • Формат запроса:
    • GET .../TourSearchOwin/CheckMail?
  • Принимаемые параметры ( * – обязательный):
    • mail * – e-mail пользователя
  • Возвращаемый результат:
    • true/false – результат проверки (false – пользователь с таким e-mail уже существует, true – пользователь с таким e-mail нет в базе данных)
развернутьПример


Проверка туриста (checkTourist)

Метод служит для получения информации о путевке по номеру путевки и номеру паспорта туриста.

  • Формат запроса:
    • GET .../TourSearchOwin/checkTourist?
  • Принимаемые параметры ( * – обязательный):
    • dogovorNumber * – номер путевки.
    • passport * – номер паспорта туриста (заграничного или общегражданского).
  • Возвращаемый результат:
    • isDogovortrue, если путевка найдена по номеру путевки, false, если не найдена.
    • isAnnulatedtrue, если путевка аннулирована, false, если не аннулирована.
    • dogovorStatus – статус путевки
    • isPaytrue, если путевка полностью оплачена, false, если не оплачена или оплачена частично.
    • dogovorDateBegin – дата начала заезда.
    • dogovorDateEnd – дата окончания заезда.
    • dogovorDateCreate – дата создания путевки.
    • isTouristDogovorCreatetrue, если турист (по номеру паспорта) является главным туристом в путевке.
    • services – набор услуг в путевке.
      • svKey – код класса услуги.
      • code – код услуги.
      • subCode1 – код доп. описания 1 услуги.
      • subCode2 – код доп. описания 2 услуги.
      • name – название услуги.
    • touristInfo – информация о главном туристе.
      • lastname – фамилия туриста (рус).
      • firstname – имя туриста (рус).
      • surname – отчество туриста.
      • address – адрес (индекс, город, улица, дом, квартира).
      • postcode – индекс.
      • city – город.
      • street – улица.
      • home – дом.
      • roomNumber – квартира.
развернутьПример


Список значений параметра гражданства (Citizenships)

Метод служит для получения списка значений параметра гражданства.

  • Формат запроса:
    • GET .../TourSearchOwin/Citizenships?
  • Принимаемые параметры ( * – обязательный):
    • pageSize * – размер выдачи
    • pageNumber * – порядковый номер страницы выдачи
    • term * – подстрочный фильтр для отбора (пустой по умолчанию)
  • Возвращаемый результат:
    • Key – ключ страны
    • Name – название гражданства
развернутьПример


Выгрузка постоянного клиента (Client)

Метод выгружает постоянного клиента при авторизации частного лица.

  • Формат запроса:
    • GET .../TourSearchOwin/Client?
  • Принимаемые параметры ( * – обязательный):
    • clientId * – Id постоянного клиента
  • Возвращаемый результат:
    • $id – внутренний порядковый идентификатор
    • CL_KEY – ключ справочника постоянные клиенты
    • CL_OPERUPDATE – ключ менеджера, который последний обновил постоянного клиента
    • CL_OPERUPDATE – дата обновления постоянного клиента
    • CL_PFKEY – внутренний ключ
    • CL_NAMERUS – имя (на русском)
    • CL_NAMELAT – имя (на латинице)
    • CL_SHORTNAME – инициалы
    • CL_SEX – пол
    • CL_FNAMERUS – фамилия (на русском)
    • CL_FNAMELAT – фамилия (на латинице)
    • CL_SNAMERUS – отчество (на русском)
    • CL_SNAMELAT – отчество (на латинице)
    • CL_BIRTHDAY – дата рождения
    • CL_BIRTHCOUNTRY – страна рождения
    • CL_BIRTHCITY – место рождения (город)
    • CL_CITIZEN – гражданство
    • CL_ADDRESS – полный адрес
    • CL_POSTINDEX – почтовый индекс
    • CL_POSTCITY – город
    • CL_POSTSTREET – улица
    • CL_POSTBILD – дом
    • CL_POSTFLAT – квартира
    • CL_PHONE – телефон
    • CL_PASPORTSER – серия загранпаспорта
    • CL_PASPORTNUM – номер загранпаспорта
    • CL_PASPORTDATE – дата выдачи загранпаспорта
    • CL_PASPORTDATEEND – срок действия загранпаспорта
    • CL_PASPORTBYWHOM – кем выдан загранпаспорт
    • CL_PASPRUSER – серия общегражданского паспорта
    • CL_PASPRUNUM – номер общегражданского паспорта
    • CL_PASPRUDATE – дата выдачи общегражданского паспорта
    • CL_PASPRUBYWHOM – кем выдан общегражданский паспорт
    • CL_ISMARK – профессия
    • CL_TYPE – примечания
    • CL_IMPRESSNOTE – общие впечатления
    • CL_NOTE – особые отметки
    • CL_REMARK – примечания
    • CL_IMPRESSKEY – ключ выбранного впечатления
    • CL_TITLE1 – служебные отметки, заголовок 1
    • CL_TITLE2 – служебные отметки, заголовок 2
    • CL_TITLE3 – служебные отметки, заголовок 3
    • CL_TITLE4 – служебные отметки, заголовок 4
    • CL_FUTURE – пожелания
    • CL_LASTSTAT – информация о статистике
    • CL_SUMMA – сумма по клиенту
    • CL_NMENWITH – число спутников
    • CL_SUMDOGOVOR – сумма по путевкам
    • CL_NTRIP – число поездок
    • ROWID – внутренний идентификатор
    • cl_fax – факс
    • cl_mail: – e-mail
    • CL_MINCOST – минимальная стоимость поездки
    • CL_MAXCOST – максимальная стоимость поездки
    • CL_RealSex – пол
    • CL_EnableSmsNotifications – признак согласен получать sms-уведомление
    • CL_CHECKED – оповещения
    • CL_Creator – создатель постоянного клиента
    • CL_CreateDate – дата создания постоянного клиента
    • CL_Login – логин
    • CL_Password – пароль
    • CL_IsOnlineUser – является ли постоянный клиент онлайн пользователем
    • CL_CitizenID – ID гражданства
    • CARDS – информация о дисконтной карте
развернутьПример


Выгрузка описаний ценовых блоков (CostOfferDescriptions)

Метод выгружает описания ценовых блоков.

  • Формат запроса:
    • GET .../TourSearchOwin/CostOfferDescriptions?
  • Принимаемые параметры ( * – обязательный):
    • COKeysString * – ключи ценовых блоков
  • Возвращаемый результат:
    • IdCostOffer – Id ценового блока
    • InfoText – описание ценового блока
развернутьПример


Выгрузка описания по стране (CountryInfo)

Метод выгружает описание по стране.

  • Формат запроса:
    • GET .../TourSearchOwin/CountryInfo?
  • Принимаемые параметры ( * – обязательный):
    • countryKey * – ключ страны
  • Возвращаемый результат:
    • информация по выбранной стране
развернутьПример


Выгрузка картинки по отелю (HotelImages)

Метод выгружает картинку по отелю.

  • Формат запроса:
    • GET .../TourSearchOwin/HotelImages?
  • Принимаемые параметры ( * – обязательный):
    • hotelKeys * – ключ отеля (можно передать несколько ключей отеля, каждый раз указывая параметр hotelKeys), в этом случае возвращается информация о главном фото отеля
  • либо
    • hotelKey * – либо ключ отеля, в этом случае возвращается полная информация о всех фотографиях в отеле
  • Возвращаемый результат (если передан hotelKeys):
    • Name – название файла
    • HotelKey – ключ отеля
    • InfoExists – есть ли информация
    • ImagesCount – общее количество картинок по отелю
  • либо (если передан hotelKey)
    • Images – объект картинок
      • Key – ключ картинки
      • Description – описание картинки
      • Priority – приоритет
      • Name – название файла
      • HotelKey – ключ отеля
      • InfoExists – есть ли информация
    • Country – страна отеля
    • City – город отеля
    • Name – название отеля
    • HotelCategoryName – категория отеля
    • Address – адрес отеля
    • Phone – телефон
    • Email – e-mail
    • Http – адрес сайта
    • Description – описание отеля
    • InfrastructureHotel – инфраструктура отеля
    • RecreationSport – развлечения и спорт
    • Beach – информация о пляже
    • Healing – лечение
    • Excursion – экскурсии
    • AdditionalService – дополнительные услуги
    • ForChildren – для детей
    • AddCost – доплаты
    • CheckoutTimeFrom – заезд в отель
    • CheckoutTimeTo – выезд из отеля
    • Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
    • Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
развернутьПример краткой информации отеля


развернутьПример детальной информации отеля


Отображение картинки в браузере (GetImage)

Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе HotelImages.

  • Принимаемые параметры ( * – обязательный):
    • code * – ключ отеля
    • type * – размер картинки (возможные значения: small1, small160x90, medium, big)
    • name * – название файла (берется из метода HotelImages)
    • imageType * – тип картинки (возможные значения: hotels, tours)
  • Возвращаемый результат:
    • изображение картинки отеля
развернутьПример картинки отеля


Выгрузка картинки по туру (TourImages)

Метод выгружает картинки по туру.

  • Формат запроса:
    • GET .../TourSearchOwin/TourImages?
  • Принимаемые параметры ( * – обязательный):
    • tourKeys * – ключ тура (можно передать несколько ключей тура, каждый раз указывая параметр tourKeys)
  • Возвращаемый результат:
    • Images – объект картинок
      • Key – ключ картинки
      • Description – описание картинки
      • Priority – приоритет
      • Name – название файла
      • TourKey – ключ тура
развернутьПример


Отображение картинки в браузере (GetImage)

Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе TourImages.

  • Принимаемые параметры ( * – обязательный):
    • code * – ключ тура
    • type * – размер картинки (возможные значения: small1, small160x90, medium, big)
    • name * – название файла (берется из метода TourImages)
    • imageType * – тип картинки (возможные значения: hotels, tours)
  • Возвращаемый результат:
    • изображение картинки отеля
развернутьПример картинки отеля


Регистрация частного лица (PersonalRegistration)

Метод производит регистрацию частного лица.

  • Формат запроса:
    • GET .../TourSearchOwin/PersonalRegistration?
  • Принимаемые параметры ( * – обязательный):
    • name * – имя
    • surname * – фамилия
    • phone * – телефон
    • login * – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail CheckMail
    • password * – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
    • citizen * – гражданство (возможна передача пустого значения)
    • country * – страна (возможна передача пустого значения)
    • city * – город (возможна передача пустого значения)
    • address * – адрес (возможна передача пустого значения)
    • comment * – комментарий (возможна передача пустого значения)
    • captchaText * – текст капчи. Предварительно нужно вызывать метод получения капчи GetCaptcha. Полученный FileContents преобразовать с помощью json в картинку, текст из которой вставить как значение captchaText.
    • sessionId * – Id сессии (возможна передача произвольного значения)
  • Возвращаемый результат:
    • SxotpFhg – сформированный (при упрощенной регистрации) или заданный пользователем пароль
развернутьПример


Выгрузка плана рассадки (TransportPlan)

Метод выгружает план рассадки транспортного средства.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code * – код услуги
    • dateBegin * – дата начала услуги
    • serviceType * – класс услуги
    • transportKey * – ключ транспорта
  • Возвращаемый результат:
    • TransportKey – ключ транспорта
    • Title – название
    • AreasCount – количество зон (уровней)
    • RowsCount – количество рядов
    • ColumnsCount – количество колонок
    • BusySeats – информация о занятых местах
    • Cells – блок не заполняется
      • Row – ряд
      • Column – колонка
      • Area – уровень
      • Type – тип места (1 - свободно, 5 - занято)
      • Name – номер места
    • UserSeats – блок не заполняется
    • BlockSeat – блок не заполняется
развернутьПример


Выгрузка списка всех стран (Countries)

Метод производит выгрузку всех стран (используется для регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/Countries?
  • Принимаемые параметры ( * – обязательный):
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – ключ страны
    • Name – название
развернутьПример



Выгрузка списка всех городов (Cities)

Метод производит выгрузку всех городов (используется для регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/Cities?
  • Принимаемые параметры ( * – обязательный):
    • countryKey * – ключ страны, по которой выгружать города (при значении -1 выгружаются все города)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – ключ города
    • Name – название
развернутьПример



Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)

Метод производит выгрузку городов отправления в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsDepartureCities?
  • Принимаемые параметры ( * – обязательный):
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
    • withoutFlight – перевод для ключа -1 (Без перелета)
  • Возвращаемый результат:
    • Key – ключ города
    • Name – название
    • IsExist – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
развернутьПример



Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)

Метод производит выгрузку стран в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsDestination?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Name – название
    • Key – ключ страны
    • DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
    • IsExist – информация о том, есть ли в этой стране актуальные программы туров (true/false)
развернутьПример



Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)

Метод производит выгрузку турпрограмм в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsTourPrograms?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • destination * – ключ страны (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
    • destinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
    • individualTitle – перевод для программы тура с ключом 0 (Индивидуально)
  • Возвращаемый результат:
    • Key – ключ программы туров
    • Name – название программы туров
    • Rate – валюта тура
развернутьПример



Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)

Метод производит выгрузку дат заезда в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsTourDate?
  • Принимаемые параметры ( * – обязательный):
    • tourKey * – ключ программы тура
  • Возвращаемый результат:
    • массив дат
развернутьПример


Поиск туров в оформлении клиентов (Search)

Метод возвращает наиболее дешевое предложения по определенному туру.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClient/Search?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • Dates * – дата заезда (из контроллера .../TourSearchOwin/RegistrationClientsTourDate?)
    • Durations * – продолжительность
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – всегда false
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • IsRegistrationClients – по умолчанию всегда приходит false
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelScheme – пустой по умолчанию
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
    • DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • Tour – ключ программы тура
  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатов программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
        • IsLandOnly – признак только наземное обслуживание
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заеда по программе тура
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
          • notCombineDifferentAirlineRule
            • airlines
            • flightSettings
            • enabled
          • checkPlusMinus1CharterRule
            • FlightSettingPairs
            • enabled
          • notCombineDifferentTariffGroupRule
            • FlightSettings
            • enabled
          • notCombineDifferentPartnerRule
            • FlightSettings
            • enabled
          • departureCityEqualsArrivalCityRule
            • FlightSettingPairs
            • enabled
          • combineOnlySpecificChartersRule
            • settings
            • enabled
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • '
        • HotelResorts – курорты в дополнительных фильтрах
          • '
        • HotelCategories – категории отеля в дополнительных фильтрах
          • '
        • Hotels – отели в дополнительных фильтрах
          • '
        • Pansions – питания в дополнительных фильтрах
          • '
        • Airlines – авиакомпании в дополнительных фильтрах
          • '
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • '
        • DepartureCities – города вылета в дополнительных фильтрах
          • '
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • '
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • '
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • '
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • '
развернутьПример



Поиск туров онлайн (TourForWeb)

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

  • Обычный формат запроса GET:
    • GET .../TourSearchOwin/TourForWeb/search/simple?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • HotelScheme * – объект схемы отеля
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • ShowToursWithoutHotels – показывать ли туры без проживания
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • AdultCount * – количество взрослых
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • TourType – тип тура
    • CityIds – идентификатор города
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
    • MatrixAlgoritm – используется ли дополнительный фильтр «Таблица цен»
    • SearchMaxPriceAlgoritm
    • wrongLicenseFileUpperTitle – проверка файла лицензии
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
  • Возвращаемый результат:
    • Result – результаты поиска
      • Key – идентификатор программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • DefaultManagers – менеджер по-умолчанию
      • Manager – обозначение менеджера
      • Branches – филиал
      • DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – детали авиаперелета
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – наименование тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – информация о шаблоне услуги авиаперелета
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор внешнего перелета
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
        • DepartureCity – город отправления
          • Key – ключ города
          • Value – наименование города
        • DepartureCountry – страна отправления
          • Key – ключ страны
          • Value – наименование страны
        • ArrivalCity – город прибытия
          • Key – ключ города
          • Value – наименование города
        • ArrivalCountry – страна прибытия
          • Key – ключ страны
          • Value – наименование страны
        • DepartureAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • ArrivalAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • Airline – наименование авиакомпании
          • Id – идентификатор авиакомпании
          • Value – наименование авиакомпании
          • Key – ключ авиакомпании
        • Aircraft – воздушное судно
          • Key – ключ воздушного судна
          • Value – наименование воздушного судна
        • Flight – перелет
          • Key – ключ перелета
          • Value – наименование авиаперелета
        • DepartureTime – время отправления
        • ArrivalTime – время прилета
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
          • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
        • Hotel – отель
          • Key – ключ отеля
          • Value – наименование отеля
        • City – город
          • Key – ключ города
          • Value – наименование города
        • Stars – категория отеля
          • Key – ключ категории отеля
          • Value – наименование категории отеля
        • StarsGlobalCode – глобальный код категории отеля
          • Key – глобальный ключ категории отеля
          • Value – наименование категории отеля
        • Resort – курорт
          • Key – ключ курорта
          • Value – наименование курорта
        • ImageURL – ссылка на лого отеля
        • Http – ссылка на сайт отеля
        • Description – описание
        • Latitude – GPS координаты: географическая широта
        • Longitude – GPS координаты: географическая долгота
        • Country – страна
          • Key – ключ страны
          • Value – наименование страны
        • HotelDetails – массив данных отель
          • HotelRoom – категория номера
          • Room – номер
            • Key – ключ номера
            • Value – наименование номера
          • RoomCategory – тип номера
            • Key – ключ типа номера
            • Value – наименование типа номера
          • AccomodationType – тип размещения
            • Key – ключ типа размещения
            • Value – наименование типа размещения
            • AdultCount – количество взрослых
            • ChildCount – количество детей
          • Pansion – тип питания
            • Key – ключ типа питания
            • Value – наименование типа питания
          • PansionGlobalCode – глобальный код типа питания
            • Key – ключ типа питания
            • Value – наименование типа питания
          • RemoteId – не используется
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • Key – ключ
          • Value – значение
        • RemoteId – не используется
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
          • GDSProviderId – ключ провайдера из внешней системы
          • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
            • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
            • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
          • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
          • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight – общий вес перелетов маршрута
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
      • Routes – массив возможных маршрутов в данной программе туров
      • IsRemoteHotels – удаленные отели
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
      • DefaultManagers – менеджер по-умолчанию
      • Manager – обозначение менеджера
      • Branches – филиал
      • DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
        • IsLandOnly – признак только наземное обслуживание
        • IsApplyMarginAddCostToRemoteService
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • IsAviaBooking
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • RateId – идентификатор валюты тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заезда по программе тура
        • DateList – список дат заездов
        • UpdateDate – дата обновления
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • IsMultiHotel
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName – наименование поля ИНН
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • HotelResorts – курорты в дополнительных фильтрах
          • CountryKey – ключ
          • Name – наименование
          • NameLat – наименование латиницей
          • Key – ключ
          • Type – тип (курорт)
        • HotelCategories – категории отеля в дополнительных фильтрах
          • Name – наименование категории
          • PrintNumber – номер для печати
          • GlobalCode – глобальный код
          • Key – ключ
          • Type – тип (категория отеоля)
        • Hotels – отели в дополнительных фильтрах
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
        • Сity – город
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • Resort – курорт
          • ResortKey – ключ курорта
          • Name – наименование
          • Category – категория
            • Name – наименование категории
            • PrintNumber – ключ для печати
            • GlobalCode – глобальный код
            • Key – ключ
            • Type – тип (категория отеля)
          • CategoryKey – ключ категории
          • TimeFrom – время с
          • TimeTo – время по
          • HTTP": сайт
          • Stars – категория
          • TimeIsEmpty – вышло ли время
          • NameLat – наименование латиницей
          • Address – адрес
          • IsCruise – имеется круиз
          • Phone – телефон
          • Email – E-mail
          • Fax – факс
          • Code – код
          • Site – сайт
          • Descript – описание
          • PayHourNote – час оплаты
          • EarlyCheckInSurcharge – доплаты за ранний заезд
          • LateCheckOutSurcharge – доплата за поздний выезд
          • Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
          • Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
          • DescExcur
          • DescSport
          • DescHealth
          • DescService
          • Key – ключ
          • Type – тип (отель)
        • Pansions – питание
          • Code – код питания
          • Name – наименование питания
          • NameLat – наименование питания латиницей
          • GlobalCode – глобальный код
          • Key – ключ
          • Type – тип (питание)
        • Airlines – авиакомпании в дополнительных фильтрах
          • Key – ключ авиакомпании
          • Code – код авиакомпании
          • ICAO – код ИКАО
          • Name – наименование авиакомпании
          • NameLat – наименование авиакомпании латиницей
          • Type – тип (авиакомпания)
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • Key – ключ
          • Code – код
          • Name – наименование
          • NameLat – наименование латиницей
          • Group – группа
          • Type – тип (авиаперелет)
        • DepartureCities – города вылета в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • Key – ключ
          • Code – код аэропорта
          • Name – наименование аэропорта
          • NameLat – наименование аэропорта латиницей
          • CityKey – ключ города
          • CountryKey – ключ страны
          • Letter – присвоенный символд
          • Site – сайт
          • Type – тип (аэропорт)
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • Key – ключ аэропорта
          • Code – код аэропорта
          • Name – наименование аэропорта
          • NameLat – наименование аэропорта латиницей
          • CityKey – ключ города
          • CountryKey – ключ страны
          • Letter – буква аэропорта
          • Site – сайт
          • Type – тип (аэропорт)
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • key – ключ
          • name – обозначение
          • Type – тип (отель)
        • ComplexHotelIds
        • Message – сообщение
          • Key – ключ
          • Value – значение
развернутьПример


  • Формат запроса GET с таблицей цен:
    • GET .../TourSearchOwin/TourForWeb/search/matrix?
  • Принимаемые параметры ( * – обязательный):

Аналогичны стандартному запросу (simple)

  • Возвращаемый результат:
    • CellsForMatrix – ячейки таблицы
      • Key – ключ
      • StartDate – дата начала
      • Duration – продолжительность
      • DurationInNight – количество ночей
      • Cost – цена
    • CitiesWithMinimalCosts – города с минимальной ценой
      • DepartureCityKey – ключ города отправления
      • ArrivalCityKey – ключ города прибытия
      • DepartureCityName – наименование города отправления
      • ArrivalCityName – наименование города прибытия
      • RouteMinimalPrice – минимальная цена маршрута
    • TourMinimalAndMaximalCost – минимальная и максимальная цены тура
      • MinimalPrice – минимальная цена
      • MaximalPrice – максимальная цена
развернутьПример


  • Формат запроса GET с минимальной и максимальной ценой:
    • GET .../TourSearchOwin/TourForWeb/search/minMaxPrices?
  • Принимаемые параметры ( * – обязательный):

Аналогичны стандартному запросу (simple)

  • Возвращаемый результат:
    • MinimalPrice – минимальная цена
    • MaximalPrice – максимальная цена
развернутьПример


Проверка дублирующих туристов (CheckDoubleDogovor)

Метод проверяет есть ли дублирующие туристы в существующих путевках. Проверка на дублирование регулируется настройкой Предупреждать при дублировании туристов.

  • Формат запроса POST:
    • POST .../TourSearchOwin/CheckDoubleDogovor
  • Принимаемые параметры ( * – обязательный):
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • Services * – массив услуг авиаперелетов для получения доплат
      • Service * – объект услуга авиаперелет
        • ServiceType * – тип услуги
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг
        • IsRemovable * – (не обрабатывается)
        • Type * – тип услуги в путевке (базовая дополнительная)
        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – шаблон услуги
        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга
        • ServiceTemplateIndex * – индекс шаблона услуги
        • RemoteId * – информация об услуге во внешней системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – ID туриста (задается в карточке постоянного клиента)
      • Age * – количество полных лет на момент окончания тура
    • TechnicalProblemsDuringUpdateFlights * – технические проблемы при обновлении рейсов
    • TimeLimit * – лимит времени
    • CountryKey * – ключ страны
    • OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
    • Day * – день Может быть с пустым значением
    • Day2 * – дня Может быть с пустым значением
    • Days * – дней Может быть с пустым значением
    • Night * – ночь Может быть с пустым значением
    • Night2 * – ночи Может быть с пустым значением
    • Nights * – ночей Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги Может быть с пустым значением
    • at * – на (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) Может быть с пустым значением
  • Возвращаемый результат:
    • Errors – описание ошибки
    • Warnings – предупреждение
    • States – статус
    • IsValid – результат проверки подключения (true/false)
развернутьПример


Дополнительные методы

Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3

Метод производит выгрузку измененных турпрограмм, в которых были сделаны изменения с указанной даты и времени и повлияли на маршруты в турпрограмме. К таким изменениям относятся изменения страны и города начала поездки, страны и города по туру, типа тура. Изменения цен по услугам не приводят к обновлению турпрограмме, такие турпрограммы в ответе не будут указаны. Турпрограммы, по которым статус Доступен для продажи сменился на другой за период, указанный в запросе, в ответе тоже не будут указаны.

  • Формат запроса:
    • GET .../TourSearchOwin/TourProgram?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • fromDateTime – дата (в формате dd.MM.yyyy HH:mm:ss), начиная с которой будут выгружаться изменения,
  • Возвращаемый результат:
    • Key – ключ программы туров
    • Name – название программы туров
    • UpdateDate – дата последнего изменения программы туров (или связанных с ней компонентов)
    • routes – массив возможных маршрутов в данной программе туров
      • departureCountryKey – страна начала поездки (для каждой страны начала поездки в одной программе тура будет отдельный маршрут)
      • departureCityKey – город начала поездки (для каждого города начала поездки в одной программе тура будет отдельный маршрут)
      • destinationCountryKeys – страны по туру (если в туре несколько услуг класса отель и они в разных странах, то будут возвращаться все страны отелей)
      • destinationCityKeys – города по туру (если в туре отели в нескольких городах, то будут возвращаться все города отелей)
      • tourTypeKeys – типы туров для данной программы туров
развернутьПример


Проверка построения маршрутов турпрограммы (CheckTourProgram)

Метод производит построение маршрутов турпрограмм (вызывается из проверки тура). Метод проверяет маршруты по турпрограммам с любым статусом (не только по статусу Доступен для подажи).

  • Формат запроса:
    • GET .../TourSearchOwin/CheckTourProgram?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • tourKey – ключ турпрограммы
  • Возвращаемый результат:
    • Message – сообщение Начинаем строить маршрут.
    • Message – сообщение Маршрутов по данной программе тура построилось – количество
    • Message – сообщение Построено каркасов маршрутов (без конкретных отелей) – количество
развернутьПример


Получение разметки формы для новой формы быстрого поиска (GetJavascriptFile)

Метод получает разметку формы для новой формы быстрого поиска.

  • Формат запроса:
    • GET .../TourSearchOwin/GetJavascriptFile/Get?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • name – имя файла
  • Возвращаемый результат:
    • полученный файл
развернутьПример


Проверка подключения к внешним системам (GDSCheckConnection)

Метод производит проверку подключения к внешней системе.

  • Формат запроса:
    • POST .../TourSearchOwin/GDSCheckConnection?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • adapterTypeName – адаптер
    • id – ключ адаптера
    • apiAddress – api-адрес
    • settings – набор настроек (у каждого адаптера индивидуальный)
      • Key – _Login
      • Value – логин
      • Key – _Password
      • Value – пароль
      • Key – _UserID
      • Value – ID пользователя
    • licenseDateExpiry – дата окончания лицензии
  • Возвращаемый результат:
    • Errors – описание ошибки
    • Warnings – предупреждение
    • States – статус
    • IsValid – результат проверки подключения (true/false)
развернутьПример


Подтверждения оплаты полиса в ЕВРОИНС

Для подтверждения оплаты метод будет обращаться к внешним службам для подтверждения платежа.
Страховая компания ЕВРОИНС

  • Формат запроса:
    • POST .../TourSearchOwin/EuroinsConfirmPay
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • policyId * – ID полиса
    • code * – код партнера
  • Возвращаемый результат:
    • success: true – подтверждено (код 200)
    • error – описание ошибки (код 400)
развернутьПример


Приложения

Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)

Параметры ServiceType – это ключ типа услуги, Сode – ключ услуги, SubCode1 и SubCode2, возвращаемые при API-запросах – это параметры дополнительных описаний двух типов, индивидуальных для каждой услуги.

Ключ типа услуги (ServiceType) Наименование типа услуги Ключ услуги (Code) Доп. описание 1 (SubCode1) Таблица БД со значениями SubCode1 Доп. описание 2 (SubCode2) Таблица БД со значениями SubCode2
1 Авиаперелет индивидуальный ключ услуги Тариф AirService отсутствует отсутствует
2 Трансфер индивидуальный ключ услуги Вид транспорта Transport отсутствует отсутствует
3 Отель/Круиз индивидуальный ключ услуги Вид проживания (Тип номера + Категория номера + Тип размещения) HotelRooms (Rooms + RoomCategory + Accmdmentype) Тип питания Pansion
4 Экскурсия индивидуальный ключ услуги Вид транспорта Transport отсутствует отсутствует
5 Виза индивидуальный ключ услуги отсутствует отсутствует отсутствует отсутствует
6 Страховка индивидуальный ключ услуги Доп. описание 1 AddDescript1 Доп. описание 2 AddDescript2
8 Доп услуга в отеле/круизе индивидуальный ключ услуги Вид проживания (Тип номера + Категория номера + Тип размещения) HotelRooms (Rooms + RoomCategory + Accmdmentype) Доп. описание 2 AddDescript2
14 Автобусный переезд индивидуальный ключ услуги Место посадки BusTransferPoints Вид транспорта Transport
99 Любая пользовательская услуга индивидуальный ключ услуги Доп. описание 1 AddDescript1 Доп. описание 2 AddDescript2