Обоснуй цены из контрактов

Эндпоинт “Обоснуй цены из контрактов” позволяет получить информацию о ценах из контрактов путем поиска по предмету контракта, фильтрации по регионам, кодам ОКПД2/КТРУ, диапазонам дат и количествам.

Эндпоинт

GET https://api-v2.dev.multitender.ru/contract/price-info

Параметры запроса

Название параметра	Обязательный	Описание
`name`	Нет	Наименование для поиска по предмету контракта, ищет по словоформам. Например: мясо
`regions`	Нет	Код региона. Можно передавать несколько значений, делитель `\|`. Есть справочник регионов, можем возвращать в MCP
`okpd`	Нет	Код ОКПД2, КТРУ. Можно передавать несколько значений, делитель `\|`. Например: `21.20.23.110-00004011\|21.20.23.110-00003620`
`date`	Нет	Диапазон дат подписания. Формат: `DD.MM.YYYY-DD.MM.YYYY`. Например: `08.12.2024-17.12.2024`
`limit`	Нет	Кол-во отдаваемых данных записей
`quantityFrom`	Нет	Количество от
`quantityTo`	Нет	Количество до
`sort`	Нет	Поля для сортировки: `priceRUR`, `signDate`
`order`	Нет	Направление сортировки: `asc` или `desc`. По умолчанию: `asc`
`apikey`	Да	Ваш apikey

Примечание: Все параметры, кроме apikey, не обязательные. Можно передавать несколько значений для regions и okpd, делитель \|.

Примеры вызова

Поиск по наименованию, регионам, ОКПД и диапазону дат

https://api-v2.dev.multitender.ru/contract/price-info?name=Масло&regions=02|23&okpd=19.20.29.120&date=08.12.2024-17.12.2024&limit=2&apikey=ВАШ_API_КЛЮЧ

Поиск с сортировкой по цене

https://api-v2.dev.multitender.ru/contract/price-info?name=мясо&sort=priceRUR&order=desc&limit=10&apikey=ВАШ_API_КЛЮЧ

Поиск с диапазоном количества

https://api-v2.dev.multitender.ru/contract/price-info?okpd=19.20.29.120&quantityFrom=100&quantityTo=500&apikey=ВАШ_API_КЛЮЧ

Структура ответа

Ответ содержит информацию о ценах из контрактов, соответствующих критериям поиска. Структура немного отличается между форматами XML и JSON.

XML
JSON

<response>
  <totalcount>2</totalcount>
  <limit>2</limit>
  <items>
    <item>
      <regNum>3234401380524000020</regNum>
      <purchaseNumber>0818600012224000291</purchaseNumber>
      <purchaseObjectInfo>Масло подсолнечное рафинированное дезодорированное</purchaseObjectInfo>
      <okpd>19.20.29.120</okpd>
      <region>02</region>
      <regionName>Республика Башкортостан</regionName>
      <signDate>2024-12-10</signDate>
      <priceRUR>1250.50</priceRUR>
      <quantity>200</quantity>
      <unit>кг</unit>
      <customerName>АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ</customerName>
      <customerInn>2344013805</customerInn>
      <supplierName>ООО "ПОСТАВЩИК"</supplierName>
      <supplierInn>1234567890</supplierInn>
    </item>
    <item>
      <regNum>3234401380524000021</regNum>
      <purchaseNumber>0818600012224000292</purchaseNumber>
      <purchaseObjectInfo>Масло подсолнечное</purchaseObjectInfo>
      <okpd>19.20.29.120</okpd>
      <region>23</region>
      <regionName>Краснодарский край</regionName>
      <signDate>2024-12-15</signDate>
      <priceRUR>1180.75</priceRUR>
      <quantity>150</quantity>
      <unit>кг</unit>
      <customerName>АДМИНИСТРАЦИЯ КРАСНОДАРСКОГО КРАЯ</customerName>
      <customerInn>2344013806</customerInn>
      <supplierName>ООО "ПОСТАВЩИК 2"</supplierName>
      <supplierInn>1234567891</supplierInn>
    </item>
  </items>
</response>

{
  "totalcount": 2,
  "limit": 2,
  "items": [
    {
      "regNum": "3234401380524000020",
      "purchaseNumber": "0818600012224000291",
      "purchaseObjectInfo": "Масло подсолнечное рафинированное дезодорированное",
      "okpd": "19.20.29.120",
      "region": "02",
      "regionName": "Республика Башкортостан",
      "signDate": "2024-12-10",
      "priceRUR": 1250.50,
      "quantity": 200,
      "unit": "кг",
      "customerName": "АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ",
      "customerInn": "2344013805",
      "supplierName": "ООО \"ПОСТАВЩИК\"",
      "supplierInn": "1234567890"
    },
    {
      "regNum": "3234401380524000021",
      "purchaseNumber": "0818600012224000292",
      "purchaseObjectInfo": "Масло подсолнечное",
      "okpd": "19.20.29.120",
      "region": "23",
      "regionName": "Краснодарский край",
      "signDate": "2024-12-15",
      "priceRUR": 1180.75,
      "quantity": 150,
      "unit": "кг",
      "customerName": "АДМИНИСТРАЦИЯ КРАСНОДАРСКОГО КРАЯ",
      "customerInn": "2344013806",
      "supplierName": "ООО \"ПОСТАВЩИК 2\"",
      "supplierInn": "1234567891"
    }
  ]
}

Поля ответа

Поля корневого уровня

Поле	Тип	Обязательность	Описание	Пример
`totalcount`	int	да	Всего записей найдено	`2`
`limit`	int	да	Кол-во выводимых записей	`2`
`items`	массив	да	Список информации о ценах (возможно пустое значение)	-

Поля элемента

Поле	Тип	Обязательность	Описание	Пример
`regNum`	string	да	Номер контракта, ссылка в ЕИС	`3234401380524000020`
`purchaseNumber`	string	возможно пустое значение	Номер закупки, ссылка в ЕИС	`0818600012224000291`
`purchaseObjectInfo`	string	возможно пустое значение	Предмет контракта/ Объект закупки	`Масло подсолнечное рафинированное дезодорированное`
`okpd`	string	возможно пустое значение	Код ОКПД2/КТРУ	`19.20.29.120`
`region`	string	возможно пустое значение	Код региона	`02`
`regionName`	string	возможно пустое значение	Наименование региона	`Республика Башкортостан`
`signDate`	date (YYYY-MM-DD)	да	Дата заключения контракта	`2024-12-10`
`priceRUR`	float	возможно пустое значение	Цена в российских рублях	`1250.50`
`quantity`	float	возможно пустое значение	Количество	`200`
`unit`	string	возможно пустое значение	Единица измерения	`кг`
`customerName`	string	да	Наименование заказчика	`АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ`
`customerInn`	string	да	ИНН заказчика	`2344013805`
`supplierName`	string	возможно пустое значение	Наименование поставщика	`ООО "ПОСТАВЩИК"`
`supplierInn`	string	возможно пустое значение	ИНН поставщика	`1234567890`

Коды ошибок

Код мы всегда передаем 200, код не 200 при фатальных ошибках сервера (например 404).

При неверном apikey

Код ошибки: 401

Ответ сервера: Некорректный API_KEY.

При ошибках сервера при обработке данных

Формат XML:

<data>
  <error>server error</error>
</data>

Формат JSON:

{
  "error": "server error"
}

Пустые значения

В зависимости от формата ответа, в случае XML пустое поле будет как закрытый тэг, например <supplierName/>.

В формате JSON: "supplierName": null

Multitender.ru