Веб-сервис получения данных об участниках финансового рынка

Веб-сервис: http://www.cbr.ru/FO_ZoomWS/FinOrg.asmx

Сервис предоставляет возможность получать актуальную информацию (по состоянию на 23:59 предыдущего дня) об участниках финансового рынка (далее - УФР) в объеме данных, предусмотренных реализованным на официальном сайте Банка России сервисом «Участники финансового рынка»:

• общие сведения об УФР (наименование, регистрационные данные, контактная информация и т.п.);
• информацию о наличии права (лицензии) на осуществление деятельности на финансовом рынке;
• сведения о подразделениях кредитных организаций.

Описание методов сервиса:

---

GetLastUpdate Получение даты последнего обновления информации в витрине данных

Аргументы:
Отсутствуют

Результат:
Дата обновления (Тип: dateTime)

---

EnumFOTypes Получение списка кодов типов УФР

Аргументы:
Отсутствуют

Результат:
XML документ, содержащий список типов УФР и их кодов:

<EnumFOTypesResult>
    <FOType>
       <Code>[Код типа УФР, string]</Code>
       <Name>[Название типа УФР, string]</Name>
    </FOType>
</EnumFOTypesResult>

---

EnumFOVids Получение списка кодов видов деятельности на финансовом рынке

Аргументы:
Отсутствуют

Результат:
XML документ, содержащий список видов деятельности и их кодов:

<EnumFOVidsResult>
    <FOVid>
        <Code>[Код вида деятельности, int]</Code>
        <Name>[Название вида деятельности, string]</Name>
        <ShortName>[Короткое название вида деятельности, string]</ShortName>
    </FOVid>
</EnumFOVidsResult>

---

EnumRegions Список субъектов РФ с кодами ОКАТО

Аргументы:
Отсутствуют

Результат:
XML документ, содержащий список субъектов РФ с кодами ОКАТО:

<EnumRegionsResult>
    <Region>
       <OKATO>[Код ОКАТО, int]</OKATO>
       <Name> [Наименование субъекта РФ, string]</Name>
    </Region>
</EnumRegionsResult>

---

GetBranchesInfoByID Получение информации о подразделении кредитной организации по идентификатору id
(id является идентификатором объекта в системе и не является регистрационным номером подразделения или УФР)

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

Аргументы:

• id внутренний идентификатор УФР, тип long
• page страница выдачи, тип int

Результат:
Xml документ, содержащий список подразделений кредитной организации с заданным id 

<GetBranchesInfoByIDResult>
    <IsSucess>[true — успешный запрос, false — ошибка]</IsSucess>
    <TotalPages>[Общее количество страниц, int]</TotalPages>
    <CurrentPage>[Текущая страница (нумерация страниц начинается с 0), int]</CurrentPage>
    <PageSize>[Размер страницы, int, константа, для данного запроса = 1000]</PageSize>
    <TotalRows>[Общее количество полученных записей в выборке, int]</TotalRows>
    <DS>
        <BranchRecord>
            <Id>[Внутренний идентификатор подразделения, long]</Id>
            <Num>[№ подразделения, присваиваемый Банком России, string]</Num>
            <Name>[Наименование подразделения, string]</Name>
            <BranchType>[Тип подразделения, string]</BranchType>
            <Address>[Адрес в пределах местонахождения, string]</Address>
            <OpenDate>[Дата открытия подразделения, dateTime]</OpenDate>
            <Affiliation>[Принадлежность (наименование родительского подразделения), string]</Affiliation>
            <HasChild>[Признак наличия дочерних подразделений у кредитной организации*, boolean]</HasChild>
        </BranchRecord>
    </DS>
</GetBranchesInfoByIDResult>

*Если признак HasChild = "true", то, используя тот же метод GetBranchesInfoByID, можно получить список дочерних подразделений, указав в поле id запроса id родительского подразделения.

---

GetFullInfoByID Получение информации об УФР по идентификатору id
(id является идентификатором объекта в системе и не является регистрационным номером подразделения или УФР)

Аргументы:

• id внутренний идентификатор УФР, тип long

GetFullInfoByINN Получение информации об УФР по ИНН

Аргументы:

• INN ИНН УФР, тип long

GetFullInfoByOGRN Получение информации об УФР по ОГРН

Аргументы:

• OGRN ОГРН УФР, тип long

Результат:
Все три метода возвращают XML документ, содержащий полную информацию об УФР:

<GetFullInfoByIDResult [GetFullInfoByINNResult, GetFullInfoByOGRNResult]>
    <ID>[Внутренний идентификатор УФР, long]</ID>
    <OGRN>[ОГРН, long]</OGRN>
    <INN>[ИНН, string]</INN>
    <ShortName>[Краткое (фирменное) наименование, string]</ShortName>
    <Name>[Полное (фирменное) наименование, string]</Name>
    <EngName>[Фирменное наименование на английском языке, string]</EngName>
    <Address>[Адрес в пределах местонахождения, string]</Address>
    <Phones>[Телефоны, string]</Phones>
    <Email>[Email, string]</Email>
    <OKATO>[Коды ОКАТО] (справочник EnumRegions)</OKATO>
    <Reg>[Субъект РФ, string]</Reg>
    <FOTypes> - Коды типов УФР (справочник EnumFOTypes)
              <string>[Код типа УФР, string]</string>
          </FOTypes>
    <Status>[Статус УФР: Any / Active / NotActive, FoStatus]</Status>
    <IsSroMember>[Членство в СРО, boolean]</IsSroMember>
    <IsRss>[Участие в системе страхования вкладов, boolean]</IsRss>
    <NPO_FLG>[Участие в системе гарантирования прав участников НПФ по негосударственному пенсионному обеспечению (НПО), boolean]</NPO_FLG>
    <ASV_FLG>[Участие в системе гарантирования прав застрахованных лиц, boolean]</ASV_FLG>
    <PaySystem>[Наименование платежной системы, string, может отсутствовать]</PaySystem>
    <REGNUM>[Регистрационный номер (для кредитных организаций), int]</REGNUM>
    <BIC>[БИК (для кредитных организаций), string]</BIC>
    <Fund> — Информация об уставе (выводится только для кредитных организаций)
        <APPROVAL_DATE>[Дата согласования последней редакции устава **, dateTime]</APPROVAL_DATE>
        <CHANGE_DATE>[Дата согласования последних изменений в устав **, dateTime]</CHANGE_DATE>
        <CHANGE_NUM>[Номер изменений устава **, int]</CHANGE_NUM>
        <APPROVAL_REG_DATE>[Дата регистрации в уполномоченном органе **, dateTime]</APPROVAL_REG_DATE>
        <CHANGE_REG_DATE>[Дата регистрации изменений устава в уполномоченном органе **, dateTime]</CHANGE_REG_DATE>
        <FUND_VALUE>[Уставный капитал, string]</FUND_VALUE>
        <FUND_CHANGE_DATE>[Дата изменения величины уставного капитала **, dateTime]</FUND_CHANGE_DATE>
    </Fund>
    <LicList> — Информация о наличии права (лицензии) на осуществление деятельности на финансовом рынке (может быть несколько элементов <LicInfo>)
        <LicInfo>
            <VidID>[Код вида деятельности (справочник EnumFOVids), int]</VidID>
            <VidD>[Наименование вида деятельности на финансовом рынке, string]</VidD>
            <LIC_Number>[Учетный номер (номер лицензии, номер записи в реестре), string]</LIC_Number>
            <LIC_Name>[Наименование лицензии, string]</LIC_Name>
            <LIC_DTStart>[Дата начала действия права (лицензии), dateTime]</LIC_DTStart>
            <LIC_DTEnd>[Дата прекращения действия права (лицензии)**, dateTime]</LIC_DTEnd>
            <FinServices> [Виды финансовых услуг]
                <FinService>[Наименование, string]</FinService>
           </FinServices>
        </LicInfo>
    </LicList>
 <PaymentSystems> [Платежные системы]
    <PaymentSystem>
      <Name>[Название платежной системы, string]</Name>
      <DateStart>[Дата начала участия, dateTime]</DateStart>
      <DateFinish>[Дата исключения, dateTime]</DateFinish>
      <PayTypes>
        <PayType> [Типы платежной системы]
          <Name>[Тип значимости, string]</Name>
          <DateBegin>[Дата признания значимости, dateTime]</DateBegin>
          <DateEnd>["Дата признания утраты значимости, dateTime]</DateEnd>
        </PayType>      
      </PayTypes>
    </PaymentSystem>
  </PaymentSystems>
    <WebSites> — Интернет-ресурсы УФР (может содержать несколько элементов <string>)
        <string>[Адрес сайта, string]</string>
    </WebSites>
    <HasBranches>[Признак наличия дочерних подразделений у кредитной организации, boolean]</HasBranches>
<Error>[Текст ошибки, string]</Error>
<BnkStatus>[Статус кредитной организации, string]</BnkStatus>
<RegistrationDate>[Дата регистрации Банком России, dateTime]</RegistrationDate>
</GetFullInfoByIDResult [GetFullInfoByINNResult, GetFullInfoByOGRNResult]>

**при отсутствии данных в поле устанавливается атрибут xsi:nil="true"

Комментарий:
<Address> не выводится для УФР, являющихся физическими лицами
<FOTypes> отображает, в том числе, архивные коды УФР
<LIC_Number> пристутсвует не по всем видам деятельности

---

SearchByINNs, SearchByOGRNs Получение информации об УФР по их ИНН, ОГРН 

Аргументы:

• INNs Массив кодов ИНН, тип Int64[] (для SearchByINNs)
• или OGRNs Массив кодов ОГРН, тип Int64[] (для SearchByOGRNs) 

Результат:
Xml документ

<RecordSetEx>
     <DS>
       <Record>
          <Id>[Внутренний идентификатор УФР, long]</Id>
          <OGRN>[ОГРН, long]</OGRN>
          <INN>[ИНН, string]</INN>
          <Name>[Полное (фирменное) наименование, string]</Name>
          <Status>[Статус организации: Действует - 1 /Не действует - 2]</Status>
          <ErrorText>[Текст ошибки, string]</ErrorText>
       </Record>
      </DS>
      <Error>[Текст ошибки, string]</Error>
     <IsSucess>[Успешная обработка, bool]</IsSucess>
</RecordSetEx>

---

Search Поиск УФР по параметрам

Аргументы:

• Name подстрока для поиска по наименованию УФР, используется точное вхождение подстроки в краткое или полное наименование, тип string
• Addr подстрока для поиска по адресу, используется точное вхождение подстроки в адрес УФР, тип string
• Status статус УФР: Any (все) / Active (действует) / NotActive (не действует)
• FoType код типа УФР, тип string (справочник EnumFOTypes)
• VidID код вида деятельности УФР, тип int, −1 — нет ограничений (справочник EnumFOVids)
• OKATO код субъекта РФ по ОКАТО, тип int, −1 — нет ограничений (справочник EnumRegions)
• page страница выдачи, тип int, нумерация страниц начинается с 0

SearchByLicNum Поиск УФР по учетному номеру (номеру лицензии, номеру записи в реестре). В соответствии с требованиями нормативных актов Банка России присвоение учетного номера предусмотрено не по всем видам деятельности.

Аргументы:

• licNumber учетный номер (номер лицензии, номер записи в реестре), тип string
• FoType код типа УФР, тип string (справочник EnumFOTypes)
• VidID код вида деятельности УФР, тип int, −1 — нет ограничений (справочник EnumFOVids)
• OKATO код субъекта РФ по ОКАТО, тип int, −1 — нет ограничений (справочник EnumRegions)
• page страница выдачи, тип int, нумерация страниц начинается с 0

SearchByLicDate Поиск УФР по датам деятельности на финансовом рынке

Аргументы:

• qType режим поиска, может иметь значения:
  • «Q1» - поиск УФР, у которых дата начала действия права (лицензии) меньше или равна
    указанной в параметре FromDate, а дата прекращения действия права (лицензии) больше указанной в параметре FromDate или отсутствует. Параметр ToDate игнорируется.
  • «Q2» - поиск УФР, у которых дата начала действия права (лицензии) больше или равна
    указанной в параметре FromDate, а дата прекращения действия права (лицензии) отсутствует. Параметр ToDate игнорируется.
  • «Q3» - поиск УФР, у которых дата начала действия права (лицензии) меньше 
    указанной в параметре FromDate, а дата прекращения действия права (лицензии) больше указанной в параметре ToDate или отсутствует.
  • «Q4» - поиск УФР, у которых дата прекращения действия права (лицензии) больше или равна
    указанной в параметре ToDate, параметр FromDate игнорируется.
• FromDate начальная дата диапазона, тип dateTime***
• ToDate конечная дата диапазона, тип dateTime***
• FoType код типа УФР, тип string (справочник EnumFOTypes)
• VidID код вида деятельности УФР, тип int, −1 — нет ограничений (справочник EnumFOVids)
• OKATO код субъекта РФ по ОКАТО, тип int, −1 — нет ограничений (справочник EnumRegions)
• page страница выдачи, тип int, нумерация страниц начинается с 0

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

Результат:
Методы Search, SearchByLicNum и SearchByLicDate возвращают Xml документ,
содержащий список краткой информации о найденных УФР

<SearchResult [SearchByLicNumResult, SearchByLicDateResult]>
    <IsSucess>[true — успешный запрос, false — ошибка]</IsSucess>
    <TotalPages>[Общее количество страниц, int]</TotalPages>
    <CurrentPage>[Текущая страница (нумерация страниц начинается с 0), int]</CurrentPage>
    <PageSize>[Размер страницы, int, константа, для данного запроса = 1000]</PageSize>
    <TotalRows>[Общее количество полученных записей в выборке, int]</TotalRows>
        <RequestParams> - Параметры запроса, массив <ReqParam>
            <ReqParam>
               <Name>[Название параметра запроса, string]</Name>
               <Value>[Значение параметра запроса, string]</Value>
            </ReqParam>
        </RequestParams>
    <DS> - Результат запроса, массив <Record>
        <Record>
            <Id>[внутренний идентификатор УФР, long]</Id>
            <OGRN>[ОГРН, long]</OGRN>
            <INN>[ИНН, string]</INN>
            <Name>[Краткое (фирменное) наименование, string]</Name>
            <Status>[Статус УФР: Any / Active / NotActive, FoStatus]</Status>
        </Record>
    </DS>
</SearchResult [SearchByLicNumResult, SearchByLicDateResult]>

Комментарий:
Методы Search и SearchByLicNum при отсутствии фильтрации по виду деятельности и/или типу УФР могут выдавать дублирующие записи в связи с тем, что один и тот же УФР может иметь несколько действующих лицензий разных видов и принадлежать к нескольким типам УФР.
Метод Search, SearchByLicNum и SearchByLicDate показывает статус УФР (Status) актуальный на дату последнего обновления информации в витрине данных.