Services/2.0/Generic.svc/GetCompaniesByParameters?SubjectID={SubjectID}&OKPO={OKPO}&INN={INN}&OGRN={OGRN}&KPP={KPP}&OKTMO={OKTMO}&FSFR={FSFR}&Ticker={Ticker}&Name={Name}&Chief={Chief}&ChiefINN={ChiefINN}&Address={Address}&RegDateFrom={RegDateFrom}&RegDateTo={RegDateTo}&Phone={Phone}&Fax={Fax}&OKFS={OKFS}&OKOGU={OKOGU}&OKOPF={OKOPF}&Founder={Founder}&FounderINN={FounderINN}&FounderOKPO={FounderOKPO}&FounderPartAmountFrom={FounderPartAmountFrom}&FounderPartAmountTo={FounderPartAmountTo}&FounderPartPercentFrom={FounderPartPercentFrom}&FounderPartPercentTo={FounderPartPercentTo}&FounderAddress={FounderAddress}&FounderSource={FounderSource}&Regions={Regions}&RegionsOper={RegionsOper}&Branches={Branches}&BranchesOper={BranchesOper}&MainBranch={MainBranch}&Params={Params}&ParamsOper={ParamsOper}&YearFrom={YearFrom}&YearTo={YearTo}&Quarter={Quarter}&OnlyYearValues={OnlyYearValues}&OnlyActive={OnlyActive}&HeadCompanies={HeadCompanies}&CompanyBranches={CompanyBranches}&RecordCount={RecordCount}&LimitFrom={LimitFrom}&LimitSize={LimitSize}&PartialSize={PartialSize}


Версия метода: 1.

Список компаний по параметрам

HTTP метод: GET

Пример запроса

https://ws.1prime.ru/Services/2.0/Generic.svcGetCompaniesByParameters?Regions=45;19&Params=(129505,6859)>1000;(129525,6864)<5000&YearFrom=2008&YearTo=2012&LimitSize=10&RecordCount=false

Тестирование метода

Сформированный URL: https://ws.1prime.ru/Services/2.0/Generic.svc/GetCompaniesByParameters
Параметры запроса
Формат данных:
Название:
Значение:
Http код ответа:
Идентификатор запроса:
Результат выполнения:

Параметры URL

  • Метод не должен содержать дублей параметров
  • Должен быть задан хотя бы один параметр
  • Должен быть задан хотя бы один параметр: SubjectID, OKPO, INN, OGRN, KPP, OKTMO, FSFR, Ticker, Name, Chief, ChiefINN, Address, RegDateFrom, RegDateTo, Phone, Fax, OKFS, OKOGU, OKOPF, Founder, FounderINN, FounderOKPO, FounderPartAmountFrom, FounderPartAmountTo, FounderPartPercentFrom, FounderPartPercentTo, FounderAddress, Regions, Branches
ИмяОписаниеТипДополнительная информация
Address

Адрес. Адрес задается либо полностью, либо частично. Пробелы интерпретируются как любое количество пропущенных знаков.

string

Максимальная длина: 255
Branches

Список кодов ОКВЭД компаний. Элементы списка передаются через точку с запятой.
Значение параметра берется из справочника ОКВЭД, поля BranchId.
Результат выдается с учетом иерархии классификатора.

 string

Максимальная длина: 100

Элементы списка должны состоять из цифр с символом точки (.) и передаваться через точку с запятой без пробелов., регулярное выражение: (\d+[\.\d]*)(;\d+[\.\d]*)*(;)*$
BranchesOper

Способ объединения элементов списка параметра Branches.
Используется вместе с параметром Branches.
Допустимые значения:
1 – И;
2 – ИЛИ (по умолчанию);
3 – КРОМЕ.

 string

Значение должно быть 1, 2 или 3, регулярное выражение: ^[1-3]{1}$
Chief

Руководитель: ФИО и должность в компании. Руководитель задается либо полностью, либо частично. Пробелы интерпретируются как любое количество пропущенных знаков.

string

Максимальная длина: 500
ChiefINN

ИНН руководителя компании. ИНН задается полностью, либо частично. Поиск осущеcтвляется по вхождению.

string

Значение должно быть числом и должно состоять максимум из 12 цифр, регулярное выражение: ^[0-9]{1,12}$
CompanyBranches

Признак учета филиалов.
По умолчанию – true, т.е. поиск только филиалов.

string

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
Fax

Номер факса. Номер задается либо полностью, либо частично. Пробелы интерпретируются как любое количество пропущенных знаков.

string

Максимальная длина: 100
Founder

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

string

Максимальная длина: 255
FounderAddress

Адрес. Адрес задается либо полностью, либо частично. Пробелы должны интерпретироваться как любое количество пропущенных знаков.

string

Максимальная длина: 255
FounderINN

ИНН учредителя

string

Параметр принимает в себя ИНН физлица или компании, число, состоящее из 10 или 12 цифр, без учета контрольной суммы
FounderOKPO

ОКПО учредителя

string

Параметр принимает в себя ОКПО физлица или компании, число, состоящее из 8 или 10 цифр, с учетом контрольной суммы
FounderPartAmountFrom

Доля (в руб.) от... Поиск должен осуществляться по условию: доля учредителя в УК компании >= указанному значению

string

Значение должно быть числом, регулярное выражение: ^[0-9]{1,19}$
FounderPartAmountTo

Доля (в руб.) до... Поиск должен осуществляться по условию: доля учредителя в УК компании <= указанному значению

string

Значение должно быть числом, регулярное выражение: ^[0-9]{1,19}$
FounderPartPercentFrom

Доля (%) от... Поиск должен осуществляться по условию: доля учредителя в УК компании >= указанному значению

string

Диапазон: между 1 и 100 включительно

Значение должно быть числом не более трех разрядов, регулярное выражение: ^[0-9]{1,3}$
FounderPartPercentTo

Доля (%) до... Поиск должен осуществляться по условию: доля учредителя в УК компании [<= указанному значению

string

Диапазон: между 1 и 100 включительно

Значение должно быть числом не более 3 разрядов, регулярное выражение: ^[0-9]{1,3}$
FounderSource

Выбор источника данных по учредителю. Используется вместе с параметром Founder. Допустимые значения:
1 – данные из ЕГРЮЛ;
2 – данные из Статрегистра;
3 - данные из ЕГРЮЛа и Статрегистра(по умолчанию).

string

Значение должно быть числом 1, 2, или 3, регулярное выражение: ^[1-3]{1}$
FSFR

Код ФСФР. Можно задать только один код ФСФР.

string

Значение должно быть числом размером от 1 до 8 цифр, регулярное выражение: ^[0-9]{1,8}$
HeadCompanies

Признак учета головных компаний.
По умолчанию – true, т.е. поиск только головных компаний.

string

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
INN

Код ИНН. Можно задать только один код ИНН. Код должен содержать 10 символов. Поиск может также осуществляться по старому значению ИНН компании (если оно изменялось).

string

Параметр принимает в себя ИНН компании, число, состоящее из 10 цифр, без учета контрольной суммы
KPP

Код КПП. Можно задать только один код КПП. Поиск возможен по части кода.

string

Значение должно быть числом, регулярное выражение: ^[0-9]{1,9}$
LimitFrom

Начальная запись в выборке

string

Диапазон: между 0 и 2147483647 включительно

Значение должно быть 32-разрядным числом., регулярное выражение: ^[0-9]*$
LimitSize

Количество записей в выборке, по умолчанию 1000

string

Диапазон: между 0 и 2147483647 включительно

Значение должно быть 32-разрядным числом., регулярное выражение: ^[0-9]*$
MainBranch

Признак поиска по основному виду деятельности.
Используется вместе с параметром Branches.
По умолчанию - true, т.е. поиск идет только по основному ОКВЭД.

 string

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
Name

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

string

Максимальная длина: 500
OGRN

Код ОГРН. Можно задать только один код ОГРН. Код должен содержать 13 символов.

string

Параметр принимает в себя ОГРН компании, число, состоящее из 13 цифр, без учета контрольной суммы
OKFS

Код из справочника ОКФС
Результат выдается с учетом иерархии классификатора.

string

Значение должно быть числом длиной 2 цифры, регулярное выражение: ^[0-9]{2}$
OKOGU

Код из справочника ОКОГУ
Результат выдается с учетом иерархии классификатора.

string

Значение должно быть числом длиной 5 или 7 цифр, регулярное выражение: ^[0-9]{5}$|^[0-9]{7}$
OKOPF

Код из справочника ОКОПФ
Результат выдается с учетом иерархии классификатора.

string

Значение должно быть числом длиной 2 или 5 цифр, регулярное выражение: ^[0-9]{2}$|^[0-9]{5}$|
OKPO

Код ОКПО. Можно задать только один код ОКПО. Код должен содержать 8 символов.

string

Параметр принимает в себя ОКПО компании, число, состоящее из 8 цифр, с учетом контрольной суммы
OKTMO

Код ОКТМО. Можно задать только один код ОКТМО. Поиск возможен по части кода.

string

Значение должно быть числом размером от 1 до 11 цифр, регулярное выражение: ^[0-9]{1,11}$
OnlyActive

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

string

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
OnlyYearValues

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

string

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
Params

Список бухгалтерских и расчетных показателей с условиями на их значения.
Элементы списка передаются через точку с запятой.
Значение параметра берется из справочника бухгалтерских и/или расчетных показателей, поля ParamId.
Формат каждого элемента:
(ParamId)[[>|<|=|<=|>]=value, где ParamId – значение из справочника;
[[>|<|=|<=|>] – допустимые операторы сравнения;
value –ограничение выбранного показателя.
Наложенные условия должны выполняться в рамках периода, заданного параметрами YearFrom и YearTo.

string

Значение должно быть вида: (129505,6859)>1000;(129525,6864)<5000, регулярное выражение: (\(([0-9]*\,{0,1}[0-9]+)*\)([<>]=?|=)[0-9]+\;?)+

Максимальная длина: 400
ParamsOper

Способ объединения выбранных в параметре Params показателей.
Используется вместе с параметром Params.
Допустимые значения [1, 2, 3]:
1 – И;
2 – ИЛИ (по умолчанию).

string

Диапазон: между 1 и 3 включительно

Значение должно быть числом, регулярное выражение: ^[0-9]{1}$
PartialSize

Количество записей в выборке

string

Внимание! Устаревший параметр, оставлен для совместимости, не рекомендуется к использованию. Use LimitSize

Диапазон: между 0 и 2147483647 включительно

Значение должно быть 32-разрядным числом., регулярное выражение: ^[0-9]*$

Устаревший параметр, оставлен для совместимости, использование его нежелательно. Используйте параметр LimitSize
Phone

Номер телефона. Номер задается либо полностью, либо частично. Пробелы интерпретируются как любое количество пропущенных знаков.

string

Максимальная длина: 100
Quarter

Квартал за выбранный год.
Задается совместно с параметром Params.
Используется вместе с параметрами YearFrom и YearTo.
Для получения данных по кварталу нужно обязательно задавать OnlyYearValues=false. По умолчанию не задан.

string

Значение должно быть 1, 2, 3 или 4., регулярное выражение: ^[1-4]{1}$
RecordCount

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

string

Внимание! Устаревший параметр, оставлен для совместимости, не рекомендуется к использованию.

Значение должно быть true или false, регулярное выражение: ^(?i)true|false*$
RegDateFrom

Условие, что компания была зарегистрирована позже указанной даты. Используется вместе с параметром RegDateTo. Дата указывается в формате yyyyMMdd.

string

В качестве параметра должна указываться валидная дата, соответствующая маске yyyyMMdd
RegDateTo

Условие, что компания была зарегистрирована до указанной даты. Используется вместе с параметром RegDateFrom. Дата указывается в формате yyyyMMdd.

string

В качестве параметра должна указываться валидная дата, соответствующая маске yyyyMMdd
Regions

Список кодов ОКАТО (регион, город, населенный пункт), в которых зарегистрированы искомые компании, см. справочник ОКАТО
Элементы списка передаются через точку с запятой.
Результат выдается с учетом иерархии классификатора.

 string

Максимальная длина: 100

Элементы списка должны состоять из цифр и передаваться через точку с запятой без пробелов., регулярное выражение: (\d+)(;\d+)*(;)*$
RegionsOper

Способ объединения выбранных в параметре Regions показателей.
Используется вместе с параметром Regions.
Допустимые значения[2, 3]: 2 – ИЛИ (по умолчанию); 3 – КРОМЕ.

 string

Диапазон: между 2 и 3 включительно

Значение должно быть числом., регулярное выражение: ^[0-9]*$

Максимальная длина: 1
SubjectID

Идентификатор компании в системе БИР-аналитик. Можно задать только один ID компании.

string

Внимание! Устаревший параметр, оставлен для совместимости, не рекомендуется к использованию.

Параметр принимает идентификатор компании в системе БИР-аналитик, идентификатор должен быть целым положительным числом
Ticker

Код Московской биржи. Можно задать только один код.

string

Максимальная длина: 400
YearFrom

Год начала периода для проверки выполнения критерия, наложенного на показатель в параметре Params.
Задается совместно с параметром Params.
Используется вместе с параметром YearTo.
По умолчанию берется предыдущий год.

 string

Значениe указывается как год в формате yyyy, регулярное выражение: ^20[0-9]{2}$
YearTo

Год окончания периода для проверки выполнения критерия, наложенного на показатель в параметре Params.
Задается совместно с параметром Params.
Используется вместе с параметром YearFrom.
По умолчанию берется предыдущий год.

string

Значениe указывается как год в формате yyyy, регулярное выражение: ^20[0-9]{2}$

Ответ

Описание модели данных

Метод возвращает список идентификаторов компаний в системе БИР-аналитик (поле SubjectID), удовлетворяющих заданным входным параметрам.

Collection of CompanyByParameters
ИмяОписаниеТипДополнительная информация
SubjectId

integer