Services/2.0/Generic.svc/GetCompaniesWithParamsByParameters?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}&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}&PartialSize={PartialSize}&ParamsForView={ParamsForView}&TimeGroupFin={TimeGroupFin}&ParamTypesList={ParamTypesList}&YearBegin={YearBegin}&YearEnd={YearEnd}&LimitFrom={LimitFrom}&LimitSize={LimitSize}


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

Внимание! Данная версия метода является архивной и не рекомендуется к использованию. Используйте последнюю версию метода или его англоязычный синоним.

Список компаний по параметрам с параметрами (базовая версия)

HTTP метод: GET

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

https://ws.1prime.ru/GetCompaniesByParameters?Regions=19&YearFrom=2008&YearTo=2009

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

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

Параметры URL

  • Метод не должен содержать дублей параметров
  • Должен быть задан хотя бы один параметр
  • Необходимо задать один из обязательных параметров: ParamTypesList, ParamsForView
  • Необходимо задать один из обязательных параметров: 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
  • Если задан один из параметров, RegDateFrom или RegDateTo, то должен быть задан и другой
ИмяОписаниеТипДополнительная информация
Address

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

string

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

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

 string

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

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

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

 string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

string

Значение должно быть числом включающим в себя от 1 до 10 цифр, регулярное выражение: ^[0-9]{1,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 включительно

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

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

 string

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

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

string

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

Код ИНН.
Можно задать только один код ИНН.

string

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

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

string

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

Первая запись в выборке

string

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

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

string

Значение должно быть числом от 1 до 999, регулярное выражение: ^(?!0)\d{1,3}?$
MainBranch

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

 string

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

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

string

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

Код ОГРН.
Можно задать только один код ОГРН.

string

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

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

string

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

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

string

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

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

string

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

Код ОКПО.
Можно задать только один код ОКПО.

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

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

Список идентификаторов бухгалтерских и рассчетных показателей

string

 
ParamsOper

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

string

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

Критерий отображения всех показателей из определенной группы (типа показателя)

string

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

Элементы списка должны состоять из цифр 2 ,4 и передаваться через точку с запятой без пробелов., регулярное выражение: (\d+[2,4]*)(;\d+[2,4]*)*(;)*$
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.

string

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

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

string

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

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

 string

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

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

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

 string

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

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

string

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

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

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

 string

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

Периодичность значений показателей

string

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

Год начала периода

string

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

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

Год окончания периода

string

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

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

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

 string

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

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

string

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

Ответ

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

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

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

Идентификатор компании в системе БИР-аналитик

integer

 
ParamId

Идентификатор показателя бухгалтерской отчетности

integer

 
Year

Год в формате yyyy.

integer

 
Section

Периодичность отображения информации:
-Ежеквартально (значение поля «i квартал», где i – номер квартала);
-Ежегодно(значение поля «01-12»)

string

 
AValue

Значение показателя

decimal number