Заказчики

Данные о заказчиках

Получение данных о заказчиков с применением желаемых фильтров.

GET запрос на filtered-customers/

Список параметров запроса:

Название параметра	Значение
apikey	API ключ для запроса
sort	Принимает название поля, по которому нужно сортировать (например, ogrn, для сортировки по убыванию передается -ogrn).
page	Порядковый номер страницы результатов (для последующих запросов).
page_size	Число записей на странице результатов, можно указать любое целое число от 1 до 50
inn	ИНН заказчика
kpp	КПП заказчика
region_code	Код региона заказчика
ogrn	ОГРН заказчика
search	Ключевое слово для поиска заказчиков, например, «молоко».

Пример запроса: filtered_customers?apikey=<apikey>&search=молоко&page=1&page_size=20

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null.

{
  "count": 1,
  "page_size": 20,
  "total_pages": 1,
  "page": 1,
  "data": [
    {
      "full_name": "УНИТАРНОЕ МУНИЦИПАЛЬНОЕ ПРЕДПРИЯТИЕ \"КРАСНОЯРСКОЕ МОЛОКО\"",
      "inn": "3019009436",
      "kpp": "301901001",
      "ogrn": "1133019003435",
      "okpo": "10402484",
      "opf_code": "65243",
      "opf_name": "Муниципальные унитарные предприятия",
      "opf_version": "okopf",
      "post_address": "Российская Федерация, 416150, Астраханская обл, Красноярский р-н, Красный Яр с, УЛ. СОВЕТСКАЯ, Д. 65М",
      "region_code": "30",
      "region_name": "Астраханская область",
      "short_name": null,
      "contracts223_count": 0,
      "contracts44_count": 7,
      "contracts_count": 7,
      "contracts223_sum": 0,
      "contracts44_sum": 8896449.87,
      "contracts_sum": 8896449.87
    }
  ]
}

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	int	Количество контрактов в ответе
page_size	int	Число записей результатов ответа
total_pages	int	Число страниц результатов ответа
page	int	Порядковый номер страницы результатов
data	list	Список результатов запроса

count: на количество записей в ответе установлен лимит в 500. Для того, чтобы получить больше записей в ответе, вы можете дробить запрос на более мелкие части, с помощью фильтров по региону и дате подписания контракта.

data

Название поля	Тип данных	Значение
full_name	str	Полное наименование заказчика
inn	str	ИНН заказчика
kpp	str	КПП заказчика
ogrn	str	ОГРН заказчика
opf_code	str	Код ОПФ
opf_name	str	Расшифровка кода ОПФ
opf_version	str	Версия ОПФ
post_address	str	Почтовый адрес заказчика
region_code	str	Код региона
region_name	str	Наименование региона
short_name	str	Краткое наименование заказчика
contracts223_count	int	Количество заключенных контрактов по 223 ФЗ
contracts44_count	int	Количество заключенных контрактов по 44 ФЗ
contracts_count	int	Общее количество заключенных контрактов
contracts223_sum	float	Сумма контрактов по 223 ФЗ
contracts44_sum	float	Сумма контрактов по 44 ФЗ
contracts_sum	float	Общая сумма всех контрактов

Топ заказчиков по убыванию суммы конрактов.

GET запрос на top-customers/

Список параметров запроса:

Название параметра	Значение
apikey	API ключ для запроса
page	Порядковый номер страницы результатов (для последующих запросов).
page_size	Число записей на странице результатов, можно указать любое целое число от 1 до 50

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null.

{
  "count": 500,
  "page_size": 20,
  "total_pages": 25,
  "page": 1,
  "data": [
    {
      "full_name": "МУНИЦИПАЛЬНОЕ БЮДЖЕТНОЕ ДОШКОЛЬНОЕ ОБРАЗОВАТЕЛЬНОЕ УЧРЕЖДЕНИЕ \"ДЕТСКИЙ САД № 25 \"КОЛОСОК\"",
      "inn": "0100000269",
      "kpp": "010001001",
      "ogrn": "1210100002507",
      "okpo": "51646072",
      "opf_code": "75403",
      "opf_name": "Муниципальные бюджетные учреждения",
      "opf_version": "okopf",
      "post_address": "Российская Федерация, 385008, Адыгея Респ, УЛ Я.КОБЛЕВА, Д. 5",
      "region_code": null,
      "region_name": null,
      "short_name": null,
      "contracts223_count": 0,
      "contracts44_count": 90,
      "contracts_count": 90,
      "contracts223_sum": 0,
      "contracts44_sum": 10790405.09,
      "contracts_sum": 10790405.09
    }

Сводную информацию о данных в ответе см. выше.

Получение сведений о заказчике

GET запрос на customers/<inn>

Список параметров запроса:

Название параметра	Значение
apikey	API ключ для запроса

Пример запроса: customers/7706107510?apikey=<apikey>

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null.

{
  "fz": "223",
  "spz_code": "67706107510997150001",
  "full_name": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"НЕФТЯНАЯ КОМПАНИЯ \"РОСНЕФТЬ\"",
  "inn": "7706107510",
  "kpp": "770601001",
  "okpo": "00044428",
  "okopf": {
    "code": null,
    "name": null
  },
  "post_address": "Россия, 115035, г. Москва, Софийская набережная, д. 26/1",
  "subordination_type_code": null,
  "subordination_type_name": null,
  "region_code": "77",
  "region_name": "Москва",
  "totals": {
    "contracts223_count": 10817,
    "contracts223_sum": 13216331512580.46,
    "contracts44_count": 0,
    "contracts44_sum": 0,
    "contracts_count": 10817,
    "contracts_sum": 13216331512580.46
  }
}

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
fz	str	Федеральный закон
spz_code	str	Реестровый номер в СПЗ
full_name	str	Полное наименование заказчика
inn	str	ИНН заказчика
kpp	str	КПП заказчика
okpo	str	ОКПО заказчика
okopf	dict	Организационно-правовая форма заказчика
post_address	str	Почтовый адрес заказчика
subordination_type_code	str	Уровень организации (код)
subordination_type_name	str	Уровень организации (расшифровка кода)
region_code	str	Код региона
region_name	str	Наименование региона
totals	dict	Агрегированная информация контрактов и сумм

okopf

Название поля	Тип данных	Значение
code	str	Код
name	str	Расшифровка кода

totals

Название поля	Тип данных	Значение
contracts223_count	int	Количество контрактов по 223 ФЗ
contracts223_sum	float	Сумма контрактов по 223 ФЗ
contracts44_count	int	Количество контрактов по 44 ФЗ
contracts44_sum	float	Сумма контрактов по 44 ФЗ
contracts_count	int	Общее количество контрактов
contracts_sum	float	Общая сумма контрактов