Skip to content

Описание API Контракты

Anna Sakoyan edited this page Mar 27, 2018 · 7 revisions

Получение полного контракта по идентификатору (get)

Описание

Поля, которые можно использовать для поиска: "regnum" и "id".
regnum - основное поле, которое используется в большинстве случаев, за исключением контрактов, в которых оно отсутствует;
id - в случае отсутствия regnum у контракта.

Примеры

http://openapi.clearspending.ru/restapi/v3/contracts/get/?regnum=0173100000414000011
http://openapi.clearspending.ru/restapi/v3/contracts/get/?id=979bf153-27d6-4a9b-9d95-4ddc1e2ec91f

Полнотекстовый поиск по контрактам (search)

Описание

URL без параметров: http://openapi.clearspending.ru/restapi/v3/contracts/search/
Искусственное ограничение на выдачу: 500.

productsearch - полнотекстовый поиск по всем предметам в контракте;
productsearchlist - полнотекстовый поиск по набору предметов в контракте;
regnum - выборка контракта по его регистрационному номеру (аналог get);
customerinn - поиск всех контрактов, у которых заказчик с заданным ИНН;
customerkpp - поиск всех контрактов, у которых заказчик с заданным КПП;
supplierinn - поиск всех контрактов, у которых поставщик с заданным ИНН;
supplierkpp - поиск всех контрактов, у которых поставщик с заданным КПП;
okdp_okpd - поиск по коду ОКДП или ОКПД в контракте;
budgetlevel - поиск по уровню бюджета;
customerregion - поиск по региону заказчика (используются числовые коды регионов);
currentstage - состояние контракта;
daterange - дата подписания контракта (dd.mm.yyyy-dd.mm.yyyy);
pricerange - диапазон цен контракта (minFloat-maxFloat);
placing - тип размещения контракта (TODO: добавить пример);
fz - номер федерального закона.

Специальные поля:
total - найдено записей;
page - страница в выдаче;
perpage - количество записей в одном запросе (max - 50).

Допускается сортировка выдачи по:
price - сортировка по цене с параметрами [1, -1];
signDate - сортировка по дате с параметрами [1, -1].

Для параметра currentstage используются следующие коды:

Код Значение
E Исполнение
EC Исполнение завершено
ET Исполнение прекращено
IN Аннулирован

Примеры полнотекстового поиска по контрактам

Поиск по диапазону цен:
http://openapi.clearspending.ru/restapi/v3/contracts/search/?pricerange=10000-50000
Поиск в диапазоне цены с убыванием по цене:
http://openapi.clearspending.ru/restapi/v3/contracts/search/?customerregion=05&sort=-price

Выборка по контрактам (select)

Описание

Используется для выборки контрактов.

regnum - выборка контракта по его регистрационному номеру (аналог get);
customerinn - поиск всех контрактов, у которых заказчик с заданным ИНН;
customerkpp - поиск всех контрактов, у которых заказчик с заданным КПП;
supplierinn - поиск всех контрактов, у которых поставщик с заданным ИНН;
supplierkpp - поиск всех контрактов, у которых поставщик с заданным КПП;
okdp - поиск по коду ОКДП в контракте;
okpd - поиск по коду ОКПД в контракте;
budgetlevel - поиск по уровню бюджета;
customerregion - поиск по региону заказчика (используются числовые коды регионов);
industrial - отрасль экономики (использовать букву раздела в запросе);
currentstage - состояние контракта;
daterange - дата подписания контракта (dd.mm.yyyy-dd.mm.yyyy);
pricerange - диапазон цен контракта (minFloat-maxFloat);
placing - типе размещения контракта;
fz - номер федерального закона.

Специальные поля:
total - найдено записей;
page - страница в выдаче;
perpage - количество записей в одном запросе (max - 50).

Допускается сортировка выдачи по:
price - сортировка по цене с параметрами [1, -1];
signDate - сортировка по дате с параметрами [1, -1].

Для параметра currentstage используются следующие коды:

Код Значение
E Исполнение
EC Исполнение завершено
ET Исполнение прекращено
IN Аннулирован

Поиск выборки по контрактам

Выборка всех контрактов в экономическом секторе "Сельское хозяйство, охота и лесоводство", заключенных в соответствии с 94-ФЗ:
http://openapi.clearspending.ru/restapi/v3/contracts/select/?fz=94&industrial=A
Поиск в диапазоне цены с убыванием по цене:
http://openapi.clearspending.ru/restapi/v3/contracts/select/?pricerange=10000-50000&sort=-price