Skip to content

Changes

Page history
Update Контракты authored by Anna Sakoyan's avatar Anna Sakoyan
Hide whitespace changes
Inline Side-by-side
Контракты.md
View page @ 1b3343fb
В разработке
\ No newline at end of file
Описание API Контракты
======================
Для контрактов доступны следующие методы:
* get - выборка по параметрам regnum или id. Возвращают одну запись
* search - полнотекстовый поиск с учётом форм слов. Ограничен по количеству выдаваемых записей.
* select - поиск по точному совпадению. Не ограничен.
## Получение информации по контракту
### Вызов
URL без параметров: https://api.spending.gov.ru/v1/contracts/get/?<параметр>
Ограничение на выдачу: 1.
### Входные параметры
Список входных параметров:
* **regnum** - получение контракта по его регистрационному номеру <https://api.spending.gov.ru/v1/contracts/get/?regnum=0334300088411000009>
* **id** - получение контракта по его идентификатору в случае отсутствия regnum у контракта. Пример <https://api.spending.gov.ru/v1/contracts/get/?id=979bf153-27d6-4a9b-9d95-4ddc1e2ec91f>
## Полнотекстовый поиск контракта
### Вызов
URL без параметров: https://api.spending.gov.ru/v1/contracts/search/?<параметр>
Ограничение на выдачу: 500.
### Входные параметры
Список входных параметров:
* **productsearch** - полнотекстовый поиск по всем предметам в контракте. Пример: [https://api.spending.gov.ru/v1/contracts/search/?productsearch=электроэнергия](https://api.spending.gov.ru/v1/contracts/search/?productsearch=%D1%8D%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D1%8D%D0%BD%D0%B5%D1%80%D0%B3%D0%B8%D1%8F)
* **productsearchlist** - полнотекстовый поиск по набору предметов в контракте. Пример: [https://api.spending.gov.ru/v1/contracts/search/?productsearchlist=автобус,троллейбус,трамвай](https://api.spending.gov.ru/v1/contracts/search/?productsearchlist=%D0%B0%D0%B2%D1%82%D0%BE%D0%B1%D1%83%D1%81,%D1%82%D1%80%D0%BE%D0%BB%D0%BB%D0%B5%D0%B9%D0%B1%D1%83%D1%81,%D1%82%D1%80%D0%B0%D0%BC%D0%B2%D0%B0%D0%B9)
* **regnum** - выборка контракта по его регистрационному номеру (используется в большинстве случаев, за исключением контрактов, в которых оно отсутствует). Пример: <https://api.spending.gov.ru/v1/contracts/search/?regnum=0172200001513000013> (можно воспользоваться следующим видом <https://api.spending.gov.ru/v1/contracts/search/0172200001513000013>)
* **customerinn** - поиск всех контрактов, у которых заказчик с заданным ИНН. Пример: <https://api.spending.gov.ru/v1/contracts/search/?customerinn=7702388027>
* **customerkpp** - поиск всех контрактов, у которых заказчик с заданным КПП. Пример: <https://api.spending.gov.ru/v1/contracts/search/?customerkpp=770501001>
* **supplierinn** - поиск всех контрактов, у которых поставщик с заданным ИНН. Пример: <https://api.spending.gov.ru/v1/contracts/search/?supplierinn=7702388027>
* **supplierkpp** - поиск всех контрактов, у которых поставщик с заданным КПП. Пример: <https://api.spending.gov.ru/v1/contracts/search/?supplierkpp=770501001>
* **okdp_okpd** - поиск по коду ОКПД, ОКДП или ОКПД2 в контракте. Пример: <https://api.spending.gov.ru/v1/contracts/search/?okdp_okpd=6210010>
* **budgetlevel** - поиск по уровню бюджета, список значений приведён в конце документа [^1]. Пример: <https://api.spending.gov.ru/v1/contracts/search/?budgetlevel=06>
* **customerregion** - поиск по региону заказчика *(используются числовые коды регионов)*. Пример: <https://api.spending.gov.ru/v1/contracts/search/?customerregion=05>
* **currentstage** - состояние контракта, список значений приведён в конце документа [^2]. Пример: <https://api.spending.gov.ru/v1/contracts/search/?currentstage=EC>
* **daterange** - дата **подписания** контракта `(dd.mm.yyyy-dd.mm.yyyy)`. Пример: <https://api.spending.gov.ru/v1/contracts/search/?daterange=01.01.2019-01.10.2019>
* **pricerange** - диапазон цен контракта `(minFloat-maxFloat)`. Пример: <https://api.spending.gov.ru/v1/contracts/search/?pricerange=10000-50000>
* **placing** - тип размещения контракта, список значений приведён в конце документа [^3]. Пример: <https://api.spending.gov.ru/v1/contracts/search/?placing=OKU44>
* **fz** - номер федерального закона. Пример: <https://api.spending.gov.ru/v1/contracts/search/?fz=94>
Допускается сортировка выдачи по:
* **price** - сортировка по цене по возрастанию. Пример: <https://api.spending.gov.ru/v1/contracts/search/?pricerange=10000-50000&sort=price> сортировка по цене по возрастанию
* **signDate** - сортировка по дате. Пример: <https://api.spending.gov.ru/v1/contracts/search/?pricerange=10000-50000&sort=-signDate> сортировка по дате по убыванию
Специальные поля для постраничной навигации:
* **total** - найдено записей;
* **page** - страница в выдаче;
* **perpage** - количество записей в одном запросе (max - 50).
## Поиск по точному значению
### Описание
URL без параметров: https://api.spending.gov.ru/v1/contracts/select/?<параметр>
### Входные параметры
Используется для выборки контрактов.
* **regnum** - выборка контракта по его регистрационному номеру (аналог get). Пример <https://api.spending.gov.ru/v1/contracts/select/?regnum=57453251679190000010000>
* **customerinn** - поиск всех контрактов, у которых заказчик с заданным ИНН. Пример: <https://api.spending.gov.ru/v1/contracts/select/?customerinn=7453251679>
* **customerkpp** - поиск всех контрактов, у которых заказчик с заданным КПП. Пример: <https://api.spending.gov.ru/v1/contracts/select/?customerkpp=502901001>
* **supplierinn** - поиск всех контрактов, у которых поставщик с заданным ИНН. Пример: <https://api.spending.gov.ru/v1/contracts/select/?supplierinn=3904044590>
* **supplierkpp** - поиск всех контрактов, у которых поставщик с заданным КПП. Пример: <https://api.spending.gov.ru/v1/contracts/select/?supplierkpp=784102001>
* **okdp_okpd** - поиск по коду ОКПД, ОКДП или ОКПД2 в контракте. Пример: <https://api.spending.gov.ru/v1/contracts/select/?okdp_okpd=4520000>
* **budgetlevel** - поиск по уровню бюджета, список значений приведён в конце документа [^1]. Пример: <https://api.spending.gov.ru/v1/contracts/select/?budgetlevel=04>
* **customerregion** - поиск по региону заказчика *(используются числовые коды регионов)*. Пример: <https://api.spending.gov.ru/v1/contracts/select/?customerregion=05>
* **currentstage** - состояние контракта, список значений приведён в конце документа [^2]. Пример: <https://api.spending.gov.ru/v1/contracts/select/?currentstage=E>
* **daterange** - дата **подписания** контракта *(dd.mm.yyyy-dd.mm.yyyy)*. Пример: <https://api.spending.gov.ru/v1/contracts/select/?daterange=01.01.2019-01.10.2019>
* **pricerange** - диапазон цен контракта *(minFloat-maxFloat)*. Пример: <https://api.spending.gov.ru/v1/contracts/select/?pricerange=100000-150000>
* **placing** - тип размещения контракта, список значений приведён в конце документа [^3]. Пример: <https://api.spending.gov.ru/v1/contracts/select/?placing=SZ>
* **fz** - номер федерального закона. Пример: <https://api.spending.gov.ru/v1/contracts/search/?fz=94>
Допускается сортировка выдачи по:
* **price** - сортировка по цене. Пример: <https://api.spending.gov.ru/v1/contracts/select/?daterange=01.01.2019-01.10.2019&sort=-price> сортировка по цене по убыванию.
* **signDate** - сортировка по дате. Пример: <https://api.spending.gov.ru/v1/contracts/select/?pricerange=10000-50000&sort=signDate> сортировка по дате по возрастанию.
Специальные поля:
* **total** - найдено записей;
* **page** - страница в выдаче;
* **perpage** - количество записей в одном запросе (max - 50).
### Примеры поиска выборки по контрактам
Выборка всех контрактов 44-ФЗ, где регион заказчика - Ростовская область:
<https://api.spending.gov.ru/v1/contracts/select/?fz=44&customerregion=61>
Поиск в диапазоне цены с убыванием по цене:
<https://api.spending.gov.ru/v1/contracts/select/?pricerange=10000-50000&sort=-price>
[^1]: Для параметра **budgetlevel** используются следующие коды:
<table>
<thead>
<tr class="header">
<th>Код</th>
<th>Значение</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>1</td>
<td>Федеральный бюджет</td>
</tr>
<tr class="even">
<td>2</td>
<td>Бюджет субъекта Российской Федерации</td>
</tr>
<tr class="odd">
<td>3</td>
<td>Местный бюджет</td>
</tr>
<tr class="even">
<td>4</td>
<td>Бюджет Пенсионного фонда Российской Федерации</td>
</tr>
<tr class="odd">
<td>5</td>
<td>Бюджет Фонда социального страхования Российской Федерации</td>
</tr>
<tr class="even">
<td>6</td>
<td>Бюджет Федерального фонда обязательного медицинского страхования</td>
</tr>
<tr class="odd">
<td>7</td>
<td>Бюджет территориального государственного внебюджетного фонда</td>
</tr>
</tbody>
</table>
[^2]: Для параметра **currentstage** используются следующие коды:
<table>
<thead>
<tr class="header">
<th>Код</th>
<th>Значение</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>E</td>
<td>Исполнение</td>
</tr>
<tr class="even">
<td>EC</td>
<td>Исполнение завершено</td>
</tr>
<tr class="odd">
<td>ET</td>
<td>Исполнение прекращено</td>
</tr>
<tr class="even">
<td>IN</td>
<td>Аннулирован</td>
</tr>
</tbody>
</table>
[^3]: Для параметра **placing** используются следующие коды:
<table>
<thead>
<tr class="header">
<th>Код</th>
<th>Значение</th>
</tr>
</thead>
<tbody>
<td>EA44</td>
<td>Электронный аукцион</td>
</tr>
<tr class="odd">
<td>EK44</td>
<td>Конкурс для заключения энергосервисного контракта</td>
</tr>
<tr class="even">
<td>EP44</td>
<td>Закупка у единственного поставщика (подрядчика, исполнителя)</td>
</tr>
<tr class="odd">
<td>OK44</td>
<td>Открытый конкурс</td>
</tr>
<tr class="even">
<td>OKA44</td>
<td>Открытый конкурс для заключения договора на проведение аудита бухгалтерской (финансовой) отчетности (согласно ч. 4 ст. 5 Федерального закона от 30.12.2008г. № 307-ФЗ)</td>
</tr>
<tr class="odd">
<td>OKD44</td>
<td>Двухэтапный конкурс</td>
</tr>
<tr class="even">
<td>OKU44</td>
<td>Конкурс с ограниченным участием</td>
</tr>
<tr class="odd">
<td>PK44</td>
<td>Повторный конкурс</td>
</tr>
<tr class="even">
<td>PO44</td>
<td>Предварительный отбор</td>
</tr>
<tr class="odd">
<td>POKU44</td>
<td>Повторный конкурс с ограниченным участием</td>
</tr>
<tr class="even">
<td>ZK44</td>
<td>Запрос котировок</td>
</tr>
<tr class="odd">
<td>ZKB44</td>
<td>Запрос котировок без размещения извещения</td>
</tr>
<tr class="even">
<td>ZKBGP44</td>
<td>Запрос котировок в целях оказания гуманитарной помощи либо ликвидации последствий чрезвычайной ситуации природного или техногенного характера (в соответствии со Статьей 82 Федерального закона № 44-ФЗ)</td>
</tr>
<tr class="odd">
<td>ZKE44</td>
<td>Запрос котировок для заключения энергосервисного контракта</td>
</tr>
<tr class="even">
<td>ZKOO44</td>
<td>Запрос котировок на выполнение работ по строительству, реконструкции, капитальному ремонту, а также проектных, изыскательских работ в отношении олимпийских объектов и строительству домов взамен земельных участков и объектов недвижимого имущества, изымаемых в целях размещения олимпийских объектов (часть 15 статьи 112 Федерального закона №44-ФЗ)</td>
</tr>
<tr class="odd">
<td>ZKOP44</td>
<td>Запрос котировок для оказания скорой, в том числе скорой специализированной, медицинской помощи в экстренной или неотложной форме и нормального жизнеобеспечения граждан (в соответствии со Статьей 76 Федерального закона № 44-ФЗ)</td>
</tr>
<tr class="even">
<td>ZP44</td>
<td>Запрос предложений</td>
</tr>
<tr class="odd">
<td>EF</td>
<td>Открытый аукцион в электронной форме</td>
</tr>
<tr class="even">
<td>ESZ</td>
<td>Открытый аукцион в электронной форме на размещение заказа на энергосервис для нужд заказчиков (гл. 7.1 Федерального закона №94-ФЗ)</td>
</tr>
<tr class="odd">
<td>OK</td>
<td>Открытый конкурс</td>
</tr>
<tr class="even">
<td>OKE</td>
<td>Открытый конкурс на размещение заказа на энергосервис для нужд заказчиков (гл. 7.1 Федерального закона №94-ФЗ)</td>
</tr>
<tr class="odd">
<td>OKF</td>
<td>Открытый конкурс (финансирование проката или показа национального фильма)</td>
</tr>
<tr class="even">
<td>OKL</td>
<td>Открытый конкурс (создание произведения литературы или искусства, исполнения)</td>
</tr>
<tr class="odd">
<td>OKN</td>
<td>Открытый конкурс (научно-исследовательская, опытно-конструкторская или технологическая работа)</td>
</tr>
<tr class="even">
<td>OKS</td>
<td>Открытый конкурс (размещение заказа на поставку технических средств реабилитации инвалидов, оказание услуг в сфере образования, услуг по санаторно-курортному лечению), PO - Предварительный отбор</td>
</tr>
<tr class="odd">
<td>SZ</td>
<td>Сообщение о заинтересованности в проведении открытого конкурса</td>
</tr>
<tr class="odd">
<td>ZK</td>
<td>Запрос котировок</td>
</tr>
<tr class="even">
<td>ZKE</td>
<td>Размещение заказа путем запроса котировок на энергосервис для нужд заказчиков (гл. 7.1 Федерального закона №94-ФЗ)</td>
</tr>
<tr class="odd">
<td>ZKI</td>
<td>Размещение заказа путем запроса котировок цен товаров, работ, услуг, соответственно производство, выполнение, оказание которых осуществляется не по конкретным заявкам заказчика и для которых есть функционирующий рынок, для обеспечения своей деятельности на территории иностранного государства, на которой находится заказчик, у иностранных поставщиков (исполнителей, подрядчиков) (ч. 5 ст. 42 Федерального закона №94-ФЗ)</td>
</tr>
<tr class="even">
<td>ZKM</td>
<td>Размещение заказа путем проведения запроса котировок на поставку продовольствия, средств, необходимых для оказания скорой или неотложной медицинской помощи, лекарственных средств, топлива, которые необходимы для нормального жизнеобеспечения граждан и отсутствие которых приведет к нарушению их нормального жизнеобеспечения в случаях, указанных в ч. 6 ст. 42 Федерального закона №94-ФЗ</td>
</tr>
<tr class="odd">
<td>ZKS</td>
<td>Заказ на выполнение проектных, изыскательских работ, работ по строительству, реконструкции, капитальному ремонту объектов капитального строительства, относящихся в соответствии с Федеральным законом от 1 декабря 2007 года № 310-ФЗ к олимпийским объектам федерального значения, олимпийским объектам краевого значения или олимпийским объектам муниципального значения (ч.34 ст.65 Федерального закона №94-ФЗ), размещаемый путем проведения запроса котировок"
</tr>
</tbody>
</table>