Skip to content

Описание API Федеральные субсидии

Anna Sakoyan edited this page Dec 30, 2018 · 52 revisions

Содержание

Быстрая справка

Эндпойнты

Получить субсидию по реестровому номеру
https://api.sub.clearspending.ru/v1/subsidy/{regNum}/
Например: https://api.sub.clearspending.ru/v1/subsidy/72516003001

Получить распределителя по реестровому коду
https://api.sub.clearspending.ru/v1/distributor/{code}/
Например: https://api.sub.clearspending.ru/v1/distributor/00100069

Получить получателя по реестровому коду
https://api.sub.clearspending.ru/v1/receiver/{code}/
Например: https://api.sub.clearspending.ru/v1/receiver/00100386

Субсидии

Адрес: https://api.sub.clearspending.ru/v1/subsidy/

Получить данные конкретного соглашения по реестровому номеру:
https://api.sub.clearspending.ru/v1/subsidy/{regNum}/
Например: https://api.sub.clearspending.ru/v1/subsidy/72516003001

Источник данных по субсидиям

Данные о федеральных субсидиях взяты из Реестра соглашений, публикуемого Федеральным Казначейством России в системе ЕПБС. API проекта в целом сохраняет структуру данных Реестра, однако в нее добавлены дополнительные корректирующие поля.

Фильтры для субсидий

Код Значение
121 Соглашения (договора), заключенные ГРБС о предоставлении субсидий из федерального бюджета
123 Соглашения, заключенные ГРБС о предоставлении межбюджетных трансфертов из федерального бюджета бюджетам субъектов РФ
130 Нормативно правовой акт

Также возможны операции:

Документация к структуре данных

С документацией по структуре данных и значениям полей в выдаче можно ознакомиться на сайте публикатора в Паспорте данных по субсидиям. Основная часть структуры исходных данных, а также названия исходных полей сохранены и в этом проекте.

Добавленные поля

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

Поле Значение
grbs.codeBudgetreg Код распределителя по Сводному реестру. Поле соответствует исходному атрибуту grbs.codeReestr и добавлено с целью унификации формата значений, содержащихся в исходном поле
receiver.codeBudgetreg Код получателя по Сводному реестру. Поле соответствует исходному атрибуту receiver.codeReestr и добавлено потому, что исходное поле зачастую остается незаполненным. В таких случаях корректирующее поле по возможности заполняется реестровым кодом, взятым напрямую из Сводного реестра через связку по ИНН-КПП
receiver.localAddress.regionCodeFixed Код региона получателя субсидии. Это поле корректирует значения исходного receiver.localAddress.regionCode, которое во многих случаях содержит неправильные значения. Это поле заполняется на основании анализа более корректных (но менее унифицированных) значений, указанных в поле receiver.localAddress.regionName
plansNormalized Поле, унифицирующее структуру для данных, содержащихся в исходных полях plansSubject и plans
plansNormalized.sumLastYrExec Сумма исполненного обязательства прошлых лет
plansNormalized.sumLastYrNexec Сумма неисполненного обязательства прошлых лет
plansNormalized.purpose Текстовое пояснение цели и направления расходования средств
plansNormalized.kbkCode КБК по которому предусмотрены ЛБО на предоставление субсидии
plansNormalized.byYear Детализация по годам
plansNormalized.byYear.[ГОД].total Общая сумма за год
plansNormalized.byYear.[ГОД].byMonth Детализация по месяцам

Организации

Источник данных по распределителям и получателям

Данные об организациях взяты из Реестра участников бюджетного процесса, а также юридических лиц, не являющихся участниками бюджетного процесса (Сводный реестр), публикуемого Федеральным Казначейством России в системе ЕПБС. API проекта в целом сохраняет структуру данных Реестра, однако в нее добавлены дополнительные поля.

Терминология

В контексте субсидий все организации можно разделить на те, которые распределяют субсидии (распределители), и те, которые их получают (получатели). Некоторые организации могут быть одновременно и распределителями, и получателями (например, МГУ им. Ломоносова).
В базе к получателям относятся все организации, которые получили хотя бы одну субсидию. К распределителям, соответственно, - те, которые хотя бы раз выдали субсидию.
Важно понимать разницу между терминами "Главный распорядитель бюджетных средств" (ГРБС) и "распределитель".
ГРБС - это организация, которая в текущий период времени имеет право распределять федеральные бюджетные средства. Это право фиксируется на законодательном уровне. Со временем список ГРБС может меняться.
Распределитель - это рабочий термин, который мы используем для того, чтобы обозначить организацию, которая когда-либо была ГРБС. Но не все распределители в базе обладают правами ГРБС на настоящий момент. Некоторые из них, возможно, уже больше не существуют. Иными словами, распределителей в базе заведомо больше, чем фактически действующих ГРБС.

Документация на сайте источника

С документацией по структуре данных и значениям полей в выдаче можно ознакомиться на сайте публикатора в Паспорте данных по Сводному реестру. Основная часть структуры исходных данных, а также названия исходных полей сохранены и в этом проекте. Также к ним добавлены некоторые вспомогательные поля. Эти добавленные вспомогательные поля одинаковы для всех организаций.

Добавленные поля

Поле Значение
subsReceivedTotalCount Количество субсидидий, полученных организацией
subsDistributedTotalCount Количество субсидидий, распределенных организацией
subsDistributedTotalSum Сумма субсидидий, распределенных организацией
isGrbs Это поле заполняется на основании признаков того, что организация в настоящий момент обладает правами ГРБС. Возможные значения: true (есть признаки ГРБС), false (есть признаки, что это не ГРБС), null (неизвестно).
subsReceivers Информация о получателях субсидий, распределенных организацией
subsReceivers.codeReestr Реестровый код получателя
subsReceivers.fullName Наименование получателя
subsReceivers.inn ИНН получателя
subsReceivers.kpp КПП получателя
subsReceivers.subsCount Количество соглашений о субсидях, заключенных с получателем
subsDistributors Информация о распределителях, от которых организация получала субсидии
subsDistributors.codeReestr Реестровый код распределителя
subsDistributors.fullName Наименование распределителя
subsDistributors.inn ИНН распределителя
subsDistributors.kpp КПП распределителя
subsDistributors.subsCount Количество субсидий, полученных от распределителя

Фильтры для распределителей

Адрес: https://api.sub.clearspending.ru/v1/distributor/
Получить данные о конкретном распределителе по реестровому коду: https://api.sub.clearspending.ru/v1/distributor/{code}/
Например: https://api.sub.clearspending.ru/v1/distributor/00100069

Код Значение
01 Федеральный орган государственной власти, федеральный государственный орган, орган государственной власти субъекта Российской Федерации, государственный орган субъекта Российской Федерации, орган местного самоуправления, в том числе его территориальные органы
02 Орган управления государственным внебюджетным фондом
03 Учреждение
05 Унитарное предприятие
09 Государственная корпорация, государственная компания
20 Иные юридические лица, иные неучастники бюджетного процесса
22 Центральный банк Российской Федерации (Банк России)

Также возможны операции:

  • search Полнотекстовый поиск по наименованию, ИНН или реестровому коду распределителя. Пример: https://api.sub.clearspending.ru/v1/distributor/?search=минфин
  • sort Сортировка по количеству и сумме распределенных и полученных субсидий. По умолчанию сортировка производится по возрастанию. Для сортировки по убыванию необходимо добавить в запрос параметр desc=True.
Поле сортировки Значение
subsDistributedTotalCount Количество распределенных субсидий
subsDistributedTotalSum Сумма распределенных субсидий
subsReceivedTotalCount Количество полученных субсидий

Примеры сортировки:
https://api.sub.clearspending.ru/v1/distributor/?orgTypeCode=03&sort=subsDistributedTotalCount
https://api.sub.clearspending.ru/v1/distributor/?orgTypeCode=03&sort=subsDistributedTotalCount&desc=True

Фильтры для получателей

Адрес: https://api.sub.clearspending.ru/v1/receiver/
Получить данные о конкретном получателе по реестровому коду: https://api.sub.clearspending.ru/v1/receiver/{code}/
Например: https://api.sub.clearspending.ru/v1/receiver/00100386

Код Значение
01 Федеральный орган государственной власти, федеральный государственный орган, орган государственной власти субъекта Российской Федерации, государственный орган субъекта Российской Федерации, орган местного самоуправления, в том числе его территориальные органы
02 Орган управления государственным внебюджетным фондом
03 Учреждение
05 Унитарное предприятие
09 Государственная корпорация, государственная компания
20 Иные юридические лица, иные неучастники бюджетного процесса
22 Центральный банк Российской Федерации (Банк России)

Также возможны операции:

Специальные поля

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

  • total Количество записей, найденных по запросу.
  • count Число записей на странице.
  • page Номер страницы.
You can’t perform that action at this time.