Мониторинг поставщика
Эндпоинт “Мониторинг поставщика” позволяет получить информацию о контрактах для конкретного поставщика, идентифицированного по его ИНН (Идентификационный номер налогоплательщика).
Эндпоинт
Заголовок раздела «Эндпоинт»GET https://api-v2.multitender.ru/contract/monitor-supplier44Параметры запроса
Заголовок раздела «Параметры запроса»| Название параметра | Обязательный | Описание |
|---|---|---|
supplierINN | Да | ИНН поставщика |
apikey | Да | Ваш apikey |
format | Нет | Формат ответа (xml или json). По умолчанию: xml |
skip | Нет | Запись с которой показывать результат (по умолчанию: 0) |
limit | Нет | Какое кол-во записей возвращать в ответе (по умолчанию: 100, максимальное: 200) |
Примеры вызова
Заголовок раздела «Примеры вызова»100 контрактов компании
Заголовок раздела «100 контрактов компании»https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=.....&apikey=.....Контракты с 200-го по 400-й
Заголовок раздела «Контракты с 200-го по 400-й»https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=....&skip=200&limit=200&apikey=.....Контракты с 400-го по 600-й
Заголовок раздела «Контракты с 400-го по 600-й»https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=....&skip=400&limit=200&apikey=.....Структура ответа
Заголовок раздела «Структура ответа»Ответ содержит информацию о поставщике и список контрактов. Структура немного отличается между форматами XML и JSON.
<response> <supplierINN>2360000401</supplierINN> <supplierIName>ООО "НОВОСТРОЙ"</supplierIName> <totalcount>79</totalcount> <skip>0</skip> <limit>200</limit> <contracts> <contract> <regNum>3234401380524000020</regNum> <purchaseNumber>0818600012224000291</purchaseNumber> <purchaseCode>243234401380523440100100220014329244</purchaseCode> <purchaseObjectInfo>Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской</purchaseObjectInfo> <notificationPrice>772465.68</notificationPrice> <deliveryTerm>2024-12-03+03:00</deliveryTerm> <customerInn>2344013805</customerInn> <customerName>АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА</customerName> <contractPrice>562851.86</contractPrice> <signDate>2024-08-27</signDate> <endDate>2024-12-03</endDate> <contractStage>EC</contractStage> <fulfilmentSum>551100</fulfilmentSum> <paid> <total>551100</total> </paid> <advanceInPercents>25.49</advanceInPercents> <penaltiesTotal>10354.14</penaltiesTotal> <penaltiesPayments>10354.14</penaltiesPayments> <ContractStages>1</ContractStages> <updateDate>2018-11-01</updateDate> <subContractors>true</subContractors> <subContractorsSum>1056640.80</subContractorsSum> <purchaseContractGuarantee>176106.8</purchaseContractGuarantee> <contractGuarantee>187854.1</contractGuarantee> <bankSupportContractRequired>false</bankSupportContractRequired> <treasurySupportContractRequired>false</treasurySupportContractRequired> <budgetName>Бюджет Фонда социального страхования Российской Федерации</budgetName> <OKTMO>04701000-город Красноярск</OKTMO> <products> <product> <code>85.11.16.211</code> <sum>481320</sum> </product> </products> <terminationBoth>false</terminationBoth> <terminationSupplier>false</terminationSupplier> <terminationCostomer>true</terminationCostomer> <terminationJudge>true</terminationJudge> <terminationCourt>false</terminationCourt> <bankGuaranteePayments> <bankGuaranteePayment> <paymentAmountRUR>502405.39</paymentAmountRUR> <publishDate>2015-10-14</publishDate> <requirementsDate>2015-09-24</requirementsDate> <improperExecInfo>Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта</improperExecInfo> </bankGuaranteePayment> </bankGuaranteePayments> </contract> </contracts></response>{ "supplierINN": "2360000401", "supplierIName": "ООО \"НОВОСТРОЙ\"", "totalcount": 79, "skip": 0, "limit": 200, "contracts": [ { "regNum": "3234401380524000020", "purchaseNumber": "0818600012224000291", "purchaseCode": "243234401380523440100100220014329244", "purchaseObjectInfo": "Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской", "notificationPrice": 772465.68, "deliveryTerm": "2024-12-03+03:00", "customerInn": "2344013805", "customerName": "АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА", "contractPrice": 562851.86, "signDate": "2024-08-27", "endDate": "2024-12-03", "contractStage": "EC", "fulfilmentSum": 551100, "paid": { "total": 551100 }, "advanceInPercents": 25.49, "penaltiesTotal": 10354.14, "penaltiesPayments": 10354.14, "ContractStages": 1, "updateDate": "2018-11-01", "subContractors": true, "subContractorsSum": 1056640.80, "purchaseContractGuarantee": 176106.8, "contractGuarantee": 187854.1, "bankSupportContractRequired": false, "treasurySupportContractRequired": false, "budgetName": "Бюджет Фонда социального страхования Российской Федерации", "OKTMO": "04701000-город Красноярск", "products": [ { "code": "85.11.16.211", "sum": 481320 } ], "terminationBoth": false, "terminationSupplier": false, "terminationCostomer": true, "terminationJudge": true, "terminationCourt": false, "bankGuaranteePayments": [ { "paymentAmountRUR": 502405.39, "publishDate": "2015-10-14", "requirementsDate": "2015-09-24", "improperExecInfo": "Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта" } ] } ]}Поля ответа
Заголовок раздела «Поля ответа»Поля корневого уровня
Заголовок раздела «Поля корневого уровня»| Поле | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
supplierINN | string | да | ИНН Поставщика | 2360000401 |
supplierIName | string | да | Наименование Поставщика | ООО "НОВОСТРОЙ" |
totalcount | int | да | Всего контрактов найдено | 79 |
skip | int | да | C какого контракта выводим информацию | 0 |
limit | int | да | Кол-во выводимых контрактов | 200 |
contracts | массив | да | Контракты (возможно пустое значение) | - |
Поля контракта
Заголовок раздела «Поля контракта»| Поле | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
regNum | string | да | Номер контракта, ссылка в ЕИС | 3234401380524000020 |
purchaseNumber | string | возможно пустое значение | Номер закупки, ссылка в ЕИС | 0818600012224000291 |
purchaseCode | string | возможно пустое значение | Идентификационный код закупки (ИКЗ) | 243234401380523440100100220014329244 |
purchaseObjectInfo | string | возможно пустое значение | Предмет контракта/ Объект закупки | Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской |
notificationPrice | float | возможно пустое значение | НМЦК, руб | 772465.68 |
deliveryTerm | string | возможно пустое значение | Срок исполнения контракта | 2024-12-03+03:00 |
customerInn | string | да | ИНН заказчика | 2344013805 |
customerName | string | да | Наименование заказчика | АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА |
contractPrice | float | возможно пустое значение | Цена контракта, руб | 562851.86 |
signDate | date (YYYY-MM-DD) | да | Дата заключения контракта | 2024-08-27 |
endDate | date (YYYY-MM-DD) | возможно пустое значение | Дата окончание исполнения контракта | 2024-12-03 |
contractStage | string | да | Статус контракта. Возможные значения: EC (исполнение завершено), ET (исполнение прервано), E (на исполнении), IN (Реестровая запись аннулирована) | EC |
fulfilmentSum | float | возможно пустое значение | Стоимость исполненных обязательств, руб | 551100 |
paid.total | float | возможно пустое значение | Фактически оплачено, руб | 551100 |
advanceInPercents | float | возможно пустое значение | Аванс, % | 25.49 |
penaltiesTotal | float | возможно пустое значение | Неустойки, руб | 10354.14 |
penaltiesPayments | float | возможно пустое значение | Оплата неустойки, руб | 10354.14 |
ContractStages | int | да | Количество этапов | 1 |
updateDate | date (YYYY-MM-DD) | да | Последнее изменение | 2018-11-01 |
subContractors | boolean | да | Привлечение к исполнению контракта субподрядчиков | true |
subContractorsSum | float | да | Объем привлечения субподрядчиков, руб | 1056640.80 |
purchaseContractGuarantee | float | возможно пустое значение | Размер обеспечение исполнения из закупки, руб | 176106.8 |
contractGuarantee | float | возможно пустое значение | Размер обеспечения исполнения из контракта, руб | 187854.1 |
bankSupportContractRequired | boolean | да | Банковское сопровождение | false |
treasurySupportContractRequired | boolean | да | Казначейское сопровождение | false |
budgetName | string | возможно пустое значение | Бюджет | Бюджет Фонда социального страхования Российской Федерации |
OKTMO | string | возможно пустое значение | Код территории | 04701000-город Красноярск |
products | массив | возможно пустое значение | Предметы контракта | - |
products[].code | string | возможно пустое значение | Позиции по КТРУ, ОКПД2 | 85.11.16.211 |
products[].sum | float | возможно пустое значение | Сумма позиции | 481320 |
terminationBoth | boolean | да | Расторгнутые контракты по соглашению Сторон, руб. | false |
terminationSupplier | boolean | да | Расторгнутые контракты Односторонний отказ Поставщика, руб. | false |
terminationCostomer | boolean | да | Расторгнутые контракты Односторонний отказ Заказчика, руб. | true |
terminationJudge | boolean | да | Расторгнутые контракты Решение суда, руб. | true |
terminationCourt | boolean | да | Расторгнутые контракты Причина неизвестна, руб. | false |
bankGuaranteePayments | массив | возможно пустое значение | Предъявления | - |
bankGuaranteePayments[].paymentAmountRUR | float | возможно пустое значение | Сумма требования, руб. | 502405.39 |
bankGuaranteePayments[].publishDate | date (YYYY-MM-DD) | возможно пустое значение | Дата публикации требования | 2015-10-14 |
bankGuaranteePayments[].requirementsDate | date (YYYY-MM-DD) | возможно пустое значение | Дата требования | 2015-09-24 |
bankGuaranteePayments[].improperExecInfo | string | возможно пустое значение | Основание требования | Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта |
Коды ошибок
Заголовок раздела «Коды ошибок»Код мы всегда передаем 200, код не 200 при фатальных ошибках сервера (например 404).
При неверном apikey
Заголовок раздела «При неверном apikey»Код ошибки: 401
Ответ сервера: Некорректный API_KEY.
При превышении кол-во отдаваемых контрактов (параметр limit)
Заголовок раздела «При превышении кол-во отдаваемых контрактов (параметр limit)»Код ошибки: 400
Ответ сервера: Превышен лимит контрактов ... Разрешено ... макс.
Эта ошибка возникает, когда параметр limit превышает максимально допустимое значение 200.
При ошибках сервера при обработке данных
Заголовок раздела «При ошибках сервера при обработке данных»Формат XML:
<data> <error>server error</error></data>Формат JSON:
{ "error": "server error"}Пустые значения
Заголовок раздела «Пустые значения»В зависимости от формата ответа, в случае XML пустое поле будет как закрытый тэг, например <paidTotal/>.
В формате JSON: "paidTotal": null