Изменения

Интеграция со сторонними системами АПИ

63 451 байт добавлено, 18:43, 29 января 2015

→‎API Выгрузки статистики продаж через API

см. результаты бронирования.

==~~API~~ Выгрузки статистики продаж через API== === Общие положения === Агрегация - слияние массива объектов с данными в один объект(в идеале) или в несколько объектов(если в объектах есть св-ва неподдающиеся агрегации).Агрегации обычно поддаются свойства объектов с количественными значениями (кол-во времени, кол-во денег и т.д.). Объекты с такими свойствами будут автоматически агрегироваться при получении статистики. Если в этих объектах есть свойство, обозначающее количество чего-нибудь, то в соответствующее свойство конечного объекта запишется сумма свойств исходных объектов.Если в этих объектах есть свойство, обозначающее максимальное кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется максимальное значение из свойств исходных объектов.Если в этих объектах есть свойство, обозначающее минимальное кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется минимальное значение из свойств исходных объектов.Если в этих объектах есть свойство, обозначающее среднее кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется усреднённое значение свойств исходных объектов. Многие свойства не всегда поддаются агрегации (например названия или идентификаторы чего-нибудь), их нельзя просуммировать, или взять среднее, максимальное или минимальное значение. Такие свойства аггрегируются только, когда у них одинаковые значения; в свойство конечного объекта запишется это самое значение.Объекты с такими свойствами не агрегируются, даже если в этих объектах есть свойства, поддающиеся агрегации.Однако если нам всё же необходимо проагрегировать объекты с неагрегируемыми свойстами, то следует явно указать эти свойства.При агрегации таких объектов все неагрегируемые свойства, указанные нами в результатирующем объекте останутся без значений. === Методы получения статистики ===---- ==== Общее о методах получения статистики. ====Во всех запросах получения статистики присутствуют следующие параметры:* '''DateStart''' - Дата начала временного промежутка получения статистики в формате dd.mm.yyyy. Тип данных - строка.* '''DateEnd''' - Дата окончания временного промежутка получения статистики в формате dd.mm.yyyy. Тип данных - строка.Эти две даты по сути являются временным промежутком по которому получается статистика.* '''GroupBy''' - Временная единица, по которой следует группировать данные. Например, если выбран параметр группировки по дням, то записи статистики из одного дня будут агрегироваться с другими записями из этого же дня и в результате будут возвращены эти проагрегированные записи. Тип данных - перечисление. Возможные значения:** Hour - По часам.** Day - По дням.** Week - По неделям.** Month - По месяцам.** Year - По годам. ==== Получение статистики поисков. ========= Запрос =====* '''DateStart'''* '''DateEnd'''* '''GroupBy'''* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''AggregateBy''' - Агрегировать данные. тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):** None - Не агрегировать** Agencies (1) по агентствам** SubAgencies (2) по субагентствам** Users (4) по пользователям** Requisites (8) по реквизитам** SuppliersAndRequisites (24) по поставщикам и реквизитам* '''SortParams''' - Параметры сортировки результатов статистики. Можно указать до двух параметров. Тип данных - массив элементов SortParam.* '''SortParams.SortParam''' - Параметр сортировки элементов. Тип данных - сложный.* '''SortParams.SortParam.SortValue''' - Поле, по которому элементы будут сортироваться. Тип данных - перечисление. Возможные значения:** DateTime (0) по дате** SearchCount (1) по количеству поисков* '''SortParams.SortParam.OrderBy''' - Порядок сортировки. Тип данных - перечисление. Возможные значения (может быть пустым):** Asc (0) по возрастанию** Desc (1) по убыванию* '''Top''' - Ограничение сверху количества элементов в результате. тип данных - целое 32-битное число. ===== Пример запроса (XML)===== <code> <GetSearchStatistics> <request> <RequestBody> <DateStart>04.08.2014</DateStart> <DateEnd>12.08.2014</DateEnd> <GroupBy>Week</GroupBy>  <SubAgenciesIDs>  <ID>2</ID> </SubAgenciesIDs>  <AgencyID>2</AgencyID>  <AggregateBy>SuppliersAndRequisites</AggregateBy>  <SortParams>  <SortParam> <SortValue>DateTime</SortValue> <OrderBy>Desc</OrderBy> </SortParam> <SortParam> <SortValue>SearchCount</SortValue> <OrderBy>Asc</OrderBy> </SortParam> </SortParams>  <Top>2</Top> </RequestBody> </request> </GetSearchStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов SearchStatsItem.* '''StatisticsItems.SearchStatsItem''' - Объект статистики поисков. Тип данных - сложный.* '''StatisticsItems.SearchStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения:** Avia (0) авиа услуга (перелёт)** Hotel (1) отель** Rail (2) ж/д услуга** Other (33) прочие услуги неизвестного типа* '''StatisticsItems.SearchStatsItem.DateTime''' - Время начала периода сбора статистики.* '''StatisticsItems.SearchStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchStatsItem.Supplier''' - Поставщик. Тип данных - перечисление. Возможные значения:* '''StatisticsItems.SearchStatsItem.SearchRequisites''' - Поисковые реквизиты. Тип данных - строка.* '''StatisticsItems.SearchStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.SearchWithErrorCount''' - Число поисков с ошибками. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.EmptySearchCount''' - Число поисков без результатов. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.AvgResultsCount''' - Среднее кол-во результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.MinResultsCount''' - Минимальное кол-во результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.MaxResultsCount''' - Максимальное кол-во результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.AvgSearchDuration''' - Средняя продолжительность поиска. Тип данных - TimeSpan.* '''StatisticsItems.SearchStatsItem.MinSearchDuration''' - Минимальная продолжительность поиска. Тип данных - TimeSpan.* '''StatisticsItems.SearchStatsItem.MaxSearchDuration''' - Максимальная продолжительность поиска. Тип данных - TimeSpan.* '''StatisticsItems.SearchStatsItem.Supplier''' - Название поставщика. Тип данных - строка.* '''StatisticsItems.SearchStatsItem.SearchRequisites''' - Поисковые реквизиты. Тип данных - строка.* '''StatisticsItems.SearchStatsItem.GDSScans''' - Число запросов к ГДС во время поиска. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.CacheSearchCount''' - Число поисков в кэше. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchStatsItem.AvgGDSSearchDuration''' - Средняя продолжительность поиска в ГДС. Тип данных - TimeSpan.* '''StatisticsItems.SearchStatsItem.MinGDSSearchDuration''' - Минимальная продолжительность поиск в ГДС. Тип данных - TimeSpan.* '''StatisticsItems.SearchStatsItem.MaxGDSSearchDuration''' - Максимальная продолжительность поиска в ГДС. Тип данных - TimeSpan.===== Пример ответа (XML)===== <code> <GetSearchStatisticsResponse> <GetSearchStatisticsResult> <RequestID>62393</RequestID> <ResponseBody> <StatisticsItems> <SearchStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-11T00:00:00</DateTime> <UserID>2</UserID> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <Supplier nil="true"/> <SearchRequisites nil="true"/> <SearchCount>20575</SearchCount> <SearchWithErrorCount>0</SearchWithErrorCount> <EmptySearchCount>924</EmptySearchCount> <GDSScans>468</GDSScans> <CacheSearchCount>746</CacheSearchCount> <AvgResultsCount>9</AvgResultsCount> <MinResultsCount>1</MinResultsCount> <MaxResultsCount>19</MaxResultsCount> <AvgSearchDuration>PT0.4400852S</AvgSearchDuration> <MinSearchDuration>PT0.001S</MinSearchDuration> <MaxSearchDuration>PT4.2582435S</MaxSearchDuration> <AvgGDSSearchDuration>PT0S</AvgGDSSearchDuration> <MinGDSSearchDuration>PT0S</MinGDSSearchDuration> <MaxGDSSearchDuration>PT0S</MaxGDSSearchDuration> </SearchStatsItem> <SearchStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-04T00:00:00</DateTime> <UserID>2</UserID> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <Supplier nil="true"/> <SearchRequisites nil="true"/> <SearchCount>341322</SearchCount> <SearchWithErrorCount>0</SearchWithErrorCount> <EmptySearchCount>17804</EmptySearchCount> <GDSScans>7572</GDSScans> <CacheSearchCount>11434</CacheSearchCount> <AvgResultsCount>9</AvgResultsCount> <MinResultsCount>1</MinResultsCount> <MaxResultsCount>19</MaxResultsCount> <AvgSearchDuration>PT0.5500934S</AvgSearchDuration> <MinSearchDuration>PT0.001S</MinSearchDuration> <MaxSearchDuration>PT3.5072006S</MaxSearchDuration> <AvgGDSSearchDuration>PT0S</AvgGDSSearchDuration> <MinGDSSearchDuration>PT0S</MinGDSSearchDuration> <MaxGDSSearchDuration>PT0S</MaxGDSSearchDuration> </SearchStatsItem> </StatisticsItems> </ResponseBody> </GetSearchStatisticsResult> </GetSearchStatisticsResponse></code> === Получение количества поисков. (Облегчённый вариант запроса на получение статистики поисков) ======== Запрос ========== Пример запроса (XML)===== <code> <GetSearchCountStatistics> <request> <RequestBody> <DateStart>01.08.2014</DateStart> <DateEnd>13.08.2014</DateEnd> <GroupBy>Month</GroupBy> <SubAgencyId>4</SubAgencyId> </RequestBody> </request> </GetSearchCountStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов SearchCountItem.* '''StatisticsItems.SearchCountItem''' - Объект статистики количества поисков. Тип данных - сложный.* '''StatisticsItems.SearchCountItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.* '''StatisticsItems.SearchCountItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].* '''StatisticsItems.SearchCountItem.Supplier''' - Поставщик. Тип данных - строка.* '''StatisticsItems.SearchCountItem.SearchRequisites''' - Реквизиты поиска. Тип данных - строка.* '''StatisticsItems.SearchCountItem.GDSScans''' - Количество поисковых запросов к ГДС. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchCountItem.CacheSearchCount''' - Количество поисков в кеше (поиски без обращений к ГДС). Тип данных - целое 32-битное число. * '''StatisticsItems.SearchCountItem.SearchCount''' - Общее количество поисков. Тип данных - целое 32-битное число.===== Пример ответа (XML)===== <code> <GetSearchCountStatisticsResponse> <GetSearchCountStatisticsResult> <RequestID>5969455</RequestID> <ResponseBody> <StatisticsItems> <SearchCountItem> <DateTime>2014-08-01T00:00:00</DateTime> <ServiceType>Avia</ServiceType> <Supplier>Sabre</Supplier> <SearchRequisites>FJ9F</SearchRequisites> <GDSScans>0</GDSScans> <CacheSearchCount>4</CacheSearchCount> <SearchCount>4</SearchCount> </SearchCountItem> </StatisticsItems> </ResponseBody> </GetSearchCountStatisticsResult> </GetSearchCountStatisticsResponse></code> ==== Получение статистики направлений ========= Запрос =====* '''DateStart'''* '''DateEnd'''* '''GroupBy'''* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''AggregateBy''' - По каким полям следует агрегировать объекты статистики. Тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):** None (0) не аггрегировать объекты с неагрегируемыми свойствами** Agencies (1) по агенствам** SupAgencies (2) по субагенствам** Users (4) по пользователям.** RequisitesPackages (8) по пакетам реквизитов** Suppliers (16) по поставщикам** DestTypes (32) по типам направлений** BookingPlaces (64) по местам бронирования** DepPoints (128) по пунктам отправления** ArrPoints (256) по пунктам прибытия* '''SortParams''' - Параметры сортировки результатов статистики. Тип данных - массив элементов SortParam. Аналогичен параметру '''''SortParams''''' из [[#Запрос|запроса на получение статистики поисков]].* '''Top''' - Ограничение сверху количества элементов в результате. тип данных - целое 32-битное число. ===== Пример запроса (XML)===== <code> <GetDestinationsStatistics> <request> <RequestBody> <DateStart>10.08.2014</DateStart> <DateEnd>14.08.2014</DateEnd> <GroupBy>Day</GroupBy>  <SubAgenciesIDs>  <ID>2</ID> </SubAgenciesIDs>  <AgencyID>2</AgencyID>  <AggregateBy>RequisitesPackages Suppliers DestTypes BookingPlaces DepPoints ArrPoints</AggregateBy>  <SortParams>  <SortParam> <SortValue>DateTime</SortValue> <OrderBy>Desc</OrderBy> </SortParam> <SortParam> <SortValue>SearchCount</SortValue> <OrderBy>Asc</OrderBy> </SortParam> </SortParams>  <Top>2</Top> </RequestBody> </request> </GetDestinationsStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов DestinationStatsItem.* '''StatisticsItems.DestinationStatsItem''' - Объект статистики направлений. Тип данных - сложный.* '''StatisticsItems.DestinationStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].* '''StatisticsItems.DestinationStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.* '''StatisticsItems.DestinationStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.DestinationStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.DestinationStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.DestinationStatsItem.Supplier''' - Поставщик. Тип данных - перечисление. Возможные значения аналогичны параметру* '''StatisticsItems.DestinationStatsItem.DeparturePoint''' - Пункт отправления. Тип данных - сложный.* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportPointCode''' - Код пункта. Тип данных - строка.* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportPointCodeType''' - Тип пункта. Тип данных - перечисление. Возможные значения:** IATAAirportCode (0) ИАТА код аэропорта* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportSubPointCode''' - Дополнительный код пункта, например, терминал в аэропорту. Тип данных - строка.* '''StatisticsItems.DestinationStatsItem.DeparturePoint.CityCode''' - Код города. Тип данных - строка.* '''StatisticsItems.DestinationStatsItem.ArrivalPoint''' - Пункт прибытия. Тип данных - сложный, аналогичен параметру '''''StatisticsItems.DestinationStatsItem.DeparturePoint'''''.* '''StatisticsItems.DestinationStatsItem.FlightDirectionType''' - Тип направления. Тип данных - перечисление (может быть пустым). Возможные значения:** OW (0) В одну сторону** RT (1) Туда - обратно** CT (2) Сложный маршрут** SingleOJ (3) Вылет из точки А в точку Б и возврат в точку В. Т.е. есть разрыв между ап прилета и вылета** DoubleOJ (4) Как single OJ, но есть 2 разрыва между ап прилета и вылета.** hRT (5) HalfRT, он же RT/2** mOW (6) MultiOW, он же OW+OW+* '''StatisticsItems.DestinationStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.AvgResultsCount''' - Среднее число результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.MinResultsCount''' - Минимальное число результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.MaxResultsCount''' - Максимальное число результатов в поиске. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.SuccessBooksCount''' - Количество успешно созданных броней. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.FailedBooksCount''' - Количество отменённых броней и неудачных попыток бронирования. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.MadeBooksCount''' - Количество выполненных броней (не отменённые до начала выполнения). Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения:** UNKNOWN - неизвестно.* '''StatisticsItems.DestinationStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.DestinationStatsItem.AdultPassengerCount''' - Число забронированных пассажиров - взрослых. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.ChildPassengerCount''' - Число забронированных пассажиров - детей. Тип данных - целое 32-битное число.* '''StatisticsItems.DestinationStatsItem.TotalPassengersCount''' - Общее число забронированных пассажиров. Тип данных - целое 32-битное число.===== Пример ответа (XML)===== <code> <GetDestinationsStatisticsResponse> <GetDestinationsStatisticsResult> <RequestID>62403</RequestID> <ResponseBody> <StatisticsItems> <DestinationStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-12T00:00:00</DateTime> <UserID>2</UserID> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <Supplier nil="true"/> <DeparturePoint nil="true"/> <ArrivalPoint nil="true"/> <FlightDirectionType nil="true"/> <SearchCount>291</SearchCount> <AvgResultsCount>10</AvgResultsCount> <MinResultsCount>0</MinResultsCount> <MaxResultsCount>19</MaxResultsCount> <SuccessBooksCount>0</SuccessBooksCount> <FailedBooksCount>0</FailedBooksCount> <MadeBooksCount>0</MadeBooksCount> <BookingPlace nil="true"/> <RequisitesPackageID nil="true"/> <AdultPassengerCount>0</AdultPassengerCount> <ChildPassengerCount>0</ChildPassengerCount> <TotalPassengersCount>0</TotalPassengersCount> </DestinationStatsItem> <DestinationStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-11T00:00:00</DateTime> <UserID>2</UserID> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <Supplier nil="true"/> <DeparturePoint nil="true"/> <ArrivalPoint nil="true"/> <FlightDirectionType nil="true"/> <SearchCount>923</SearchCount> <AvgResultsCount>9</AvgResultsCount> <MinResultsCount>0</MinResultsCount> <MaxResultsCount>19</MaxResultsCount> <SuccessBooksCount>0</SuccessBooksCount> <FailedBooksCount>0</FailedBooksCount> <MadeBooksCount>0</MadeBooksCount> <BookingPlace nil="true"/> <RequisitesPackageID nil="true"/> <AdultPassengerCount>0</AdultPassengerCount> <ChildPassengerCount>0</ChildPassengerCount> <TotalPassengersCount>0</TotalPassengersCount> </DestinationStatsItem> </StatisticsItems> </ResponseBody> </GetDestinationsStatisticsResult> </GetDestinationsStatisticsResponse></code> ==== Получение статистики LookToBook. ========= Запрос =====* '''DateStart'''* '''DateEnd'''* '''GroupBy'''* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''AggregateBy''' - По каким полям следует агрегировать объекты статистики. Тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):** None (0) не аггрегировать объекты с неагрегируемыми свойствами** Agencies (1) по агенствам** SupAgencies (2) по субагенствам** UserTypes (4) по типам пользователей (анонимы и зарегистрированные)** DepPoints (8) по пунктам отправления** ArrPoints (16) по пунктам прибытия** BookingPlaces (32) по местам бронирования** RequisitesPackages (64) по пакетам реквизитов ===== Пример запроса (XML)===== <code> <GetLookToBookStatistics> <request> <RequestBody> <DateStart>28.07.2014</DateStart> <DateEnd>10.08.2014</DateEnd> <GroupBy>Week</GroupBy>  <SubAgenciesIDs>  <ID>2</ID> </SubAgenciesIDs>  <AgencyID>2</AgencyID>  <AggregateBy>DepPoints ArrPoints</AggregateBy> </RequestBody> </request> </GetLookToBookStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов LookToBookStatsItem.* '''StatisticsItems.LookToBookStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру* '''StatisticsItems.LookToBookStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.* '''StatisticsItems.LookToBookStatsItem.IsAnonimUser''' - Анонимные пользователи. Тип данных - булев (может быть пустым).* '''StatisticsItems.LookToBookStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.LookToBookStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.LookToBookStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.LookToBookStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения аналогичны параметру '''StatisticsItems.DestinationStatsItem.BookingPlace''' из [[#Ответ_3|ответа на получение статистики направлений]].* '''StatisticsItems.LookToBookStatsItem.DepartureCityCode''' - Код города отправления. Тип данных - строка.* '''StatisticsItems.LookToBookStatsItem.ArrivalCityCode''' - Код города прибытия. Тип данных - строка.* '''StatisticsItems.LookToBookStatsItem.LookToBookCoef''' - Отношение поисков к броням. Рассчитывается по формуле (ЕСЛИ кол-во броней > 0, ТО кол-во поисков / кол-во броней, ИНАЧЕ кол-во поисков). Тип данных - дробное число.===== Пример ответа (XML)===== <code> <GetLookToBookStatisticsResponse> <GetLookToBookStatisticsResult> <RequestID>62429</RequestID> <ResponseBody> <StatisticsItems> <LookToBookStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-04T00:00:00</DateTime> <IsAnonimUser>false</IsAnonimUser> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <RequisitesPackageID nil="true"/> <BookingPlace nil="true"/> <DepartureCityCode nil="true"/> <ArrivalCityCode nil="true"/> <LookToBookCoef>18749</LookToBookCoef> </LookToBookStatsItem> <LookToBookStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-07-28T00:00:00</DateTime> <IsAnonimUser>false</IsAnonimUser> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <RequisitesPackageID nil="true"/> <BookingPlace nil="true"/> <DepartureCityCode nil="true"/> <ArrivalCityCode nil="true"/> <LookToBookCoef>20</LookToBookCoef> </LookToBookStatsItem> </StatisticsItems> </ResponseBody> </GetLookToBookStatisticsResult> </GetLookToBookStatisticsResponse></code> ==== Получение статистики BookToCancel. ========= Запрос =====Запрос аналогичен [[#Запрос_4|запросу на получение статистики LookToBook]]===== Пример запроса (XML)===== <code> <GetBookToCancelStatistics> <request> <RequestBody> <DateStart>12.08.2014</DateStart> <DateEnd>12.08.2014</DateEnd> <GroupBy>Day</GroupBy>  <SubAgenciesIDs>  <ID>2</ID> </SubAgenciesIDs>  <AgencyID>2</AgencyID>  <AggregateBy>DepPoints ArrPoints</AggregateBy> </RequestBody> </request> </GetBookToCancelStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов BookToCancelStatsItem.* '''StatisticsItems.BookToCancelStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру* '''StatisticsItems.BookToCancelStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.* '''StatisticsItems.BookToCancelStatsItem.IsAnonimUser''' - Анонимные пользователи. Тип данных - булев (может быть пустым).* '''StatisticsItems.BookToCancelStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.BookToCancelStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.BookToCancelStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.BookToCancelStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения аналогичны параметру '''StatisticsItems.DestinationStatsItem.BookingPlace''' из [[#Ответ_2|ответа на получение статистики направлений]].* '''StatisticsItems.BookToCancelStatsItem.DepartureCityCode''' - Код города отправления. Тип данных - строка.* '''StatisticsItems.BookToCancelStatsItem.ArrivalCityCode''' - Код города прибытия. Тип данных - строка.* '''StatisticsItems.BookToCancelStatsItem.BookToCancelCoef''' - Отношение броней к отменённым броням. Рассчитывается по формуле (ЕСЛИ кол-во броней > 0 И кол-во отменённых броней > 0, ТО кол-во броней / кол-во отменённых броней, ИНАЧЕ 0). Тип данных - дробное число. ===== Пример ответа (XML)===== <code> <GetBookToCancelStatisticsResponse> <GetBookToCancelStatisticsResult> <RequestID>62437</RequestID> <ResponseBody> <StatisticsItems> <BookToCancelStatsItem> <ServiceType>Avia</ServiceType> <DateTime>2014-08-12T00:00:00</DateTime> <IsAnonimUser>false</IsAnonimUser> <AgencyID>2</AgencyID> <SubAgencyID>2</SubAgencyID> <RequisitesPackageID nil="true"/> <BookingPlace nil="true"/> <DepartureCityCode nil="true"/> <ArrivalCityCode nil="true"/> <BookToCancelCoef>0</BookToCancelCoef> </BookToCancelStatsItem> </StatisticsItems> </ResponseBody> </GetBookToCancelStatisticsResult> </GetBookToCancelStatisticsResponse></code> ==== Получение ТОПов поисковых запросов. ====Позволяет делать выборки, отвечающие на вопросы: Какие аэропорты или страны отправления чаще всего искали? Какие аэропорты или страны прибытия чаще всего искали? У каких агентств, субагентств или пользователей больше всего поисков? ===== Запрос =====* '''DateStart'''* '''DateEnd'''* '''GroupBy'''* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).* '''ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].* '''TopBy''' - Определяет по какому параметру формируется ТОП поисковых запросов. Тип данных - перечисление. Возможные значения:** DepPoint - по точке отправления** ArrPoint - по точке прибытия** DepCountry - по стране отправления** ArrCountry - по стране прибытия** Agency - по агентствам** SubAgency - по субагентствам** User - по пользователям* '''Top''' - Ограничение количества результатов сверху. Тип данных - целое 32-битное число. ===== Пример запроса (XML)===== <code> <GetSearchTopStatistics> <request> <RequestBody> <DateStart>01.12.2014</DateStart> <DateEnd>31.12.2014</DateEnd> <GroupBy>Month</GroupBy>  <SubAgenciesIDs> <ID>5</ID> <ID>6</ID> </SubAgenciesIDs>  <AgencyID>4</AgencyID>  <!<ServiceType>Avia</ServiceType>> <TopBy>DepCountry</TopBy>  <Top>2</Top> </RequestBody> </request> </GetSearchTopStatistics></code> ===== Ответ =====* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов * '''StatisticsItems.SearchTopStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.* '''StatisticsItems.SearchTopStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchTopStatsItem.AgencyID''' - Идентификатор агентства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchTopStatsItem.SubAgencyID''' - Идентификатор субагентства. Тип данных - целое 32-битное число (может быть пустым).* '''StatisticsItems.SearchTopStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.* '''StatisticsItems.SearchTopStatsItem.DepPoint''' - Код точки отправления. Тип данных - строка.* '''StatisticsItems.SearchTopStatsItem.ArrPoint''' - Код точки прибытия. Тип дынных - строка.* '''StatisticsItems.SearchTopStatsItem.DepCountry''' - Двубуквенный код страны отправления. Тип данных - строка.* '''StatisticsItems.SearchTopStatsItem.ArrCountry''' - Двубуквенный код страны прибытия. Тип данных - строка. ===== Пример ответа (XML)===== <code> <GetSearchTopStatisticsResponse> <GetSearchTopStatisticsResult> <RequestID>22945</RequestID> <ResponseBody> <StatisticsItems> <SearchTopStatsItem> <DateTime>2014-12-01T00:00:00</DateTime> <UserID nil="true"/> <AgencyID nil="true"/> <SubAgencyID nil="true"/> <SearchCount>120</SearchCount> <DepPoint nil="true"/> <ArrPoint nil="true"/> <DepCountry>RU</DepCountry> <ArrCountry nil="true"/> </SearchTopStatsItem> <SearchTopStatsItem> <DateTime>2014-12-01T00:00:00</DateTime> <UserID nil="true"/> <AgencyID nil="true"/> <SubAgencyID nil="true"/> <SearchCount>4</SearchCount> <DepPoint nil="true"/> <ArrPoint nil="true"/> <DepCountry>EG</DepCountry> <ArrCountry nil="true"/> </SearchTopStatsItem> </StatisticsItems> </ResponseBody> </GetSearchTopStatisticsResult> </GetSearchTopStatisticsResponse></code>

==Выгрузка информации о продажах в формате Nemo XML==

==Выгрузка информации о продажах в формате СОФИ XML==

Кирилл Фимченко

1206

правок

Изменения

Интеграция со сторонними системами АПИ

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты