Syntax highlighting of
Home
= ГосПлан =
== О проекте ==
Проект '''ГосПлан''' представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 2018м году. Базовыми публичными сервисами проекта '''ГосПлан''' являются веб-сервисы, которые предоставляют API к документам Единой информационной системе в сфере закупок (ЕИС Закупки, [[https://zakupki.gov.ru]]).
=== API v1 ===
'''API v1''' - публичный интерфейс к государственным закупкам, получающий данные через синхронизацию с FTP-сервером [[ ftp.zakupki.gov.ru ]] ЕИС.
. сайт проекта - [[https://dev.gosplan.info/]],
. документация - [[https://quarter18.gitbook.io/gosplan/]],
. описание API - [[https://api-doc.gosplan.info/]].
{{{#!wiki caution
'''ВНИМАНИЕ'''
С 01.07.2024 '''API v1''' считается устаревшим. Сервис продолжит работу до 01.01.2025.
}}}
=== API v2 ===
'''API v2''' - новый публичный интерфейс к государственным закупкам, получающий данные через т.н. ''сервисы отдачи информации''.
. вики - [[https://wiki.gosplan.info]]
. описание API 44-ФЗ - [[https://swagger.gosplan.info/?urls.primaryName=44-ФЗ]]
. описание API 223-ФЗ - ''в разработке''
. описание API ПП РФ 615 - ''в разработке''
== Переход с API v1 на v2 ==
Сервис ГосПлан API v1 построен на интеграции с публичным FTP-сервером ЕИС, на котором размещаются информация и документы в машиночитаемом виде.
В связи с [[https://zakupki.gov.ru/epz/main/public/news/news_preview.html?newsId=34208|изменением формата публикации документов]] и последующим закрытием доступа к FTP-серверу c [[https://zakupki.gov.ru/epz/main/public/news/news_preview.html?newsId=34565|01.01.2025]], сервис ГосПлан API v1 потеряет возможность получать актуальные документы. Ввиду запланированного перехода в 2025 году на вторую версию, принято решение не дорабатывать API v1 под новые требования ЕИС. После '''01.01.2025''' новые документы публиковаться не будут. Через один месяц - '''01.02.2025'' - сервис будет отключен и API v1 будет недоступен.
Перспективный сервис ГосПлан API v2 [[https://wiki.gosplan.info]] находится на завершающей стадии интеграции с сервисами отдачи информации ЕИС. 01.07.2024 будет запущен API v2 для 44-ФЗ. Далее, до конца года, будут реализован функционал для 223-ФЗ и 615 ПП РФ. Планируется, что до 01.01.2025 API v2 будет запущен в production режиме.
'''Для новых и текущих решений, использующих ГосПлан, настоятельно рекомендуется перейти на вторую версию API''' - [[https://swagger-v2beta.gosplan.info/?urls.primaryName=44-ФЗ]].
== ГосПлан API v2 ==
'''ГосПлан API v2''' находится на завершающей стадии разработки. Были учтены особенности функционирования первой версии, а также современные тенденции развития web-приложений. Помимо очевидных изменений в методах доступа к ресурсам пересмотрены стек инструментов разработки, доставки и развертывания сервисов. По сути проект переписывается ''с нуля''.
Главной особенностью новой версии является явное ограничение во времени хранения документов. В первой версии Сервиса хранение документов является ''накопительным'', т.е. обозначалась дата, начиная с которой все документы, опубликованные в ЕИС, попадают в сервис. Со временем объем хранимых документов возрастает на столько, что эффективность поиска необходимой информации значительно снижается. Исходя из вариантов использования сервиса, значительное количество запросов относится к актуальным (открытым) закупкам и контрактам, тогда как ''исторические данные'' не пользуются популярностью.
В API v2 доступ будет предоставляться к ''актуальным'' документам. Это означает, что сервис сохраняет информацию о закупках, процедурах и контрактах до тех пор, пока закупка или контракт не закрыты или отсутствуют обновления по документам. После того, как документы потеряли актуальность, хранение обеспечивается предварительно в течении '''6 месяцев'''.
Данные по закупкам выгружаются из ЕИС начиная с '''01.01.2024''' года и далее будут удаляться по мере потери актуальности.
Если Вам требуются ''исторические данные'', то можно ознакомиться с [[ docs/howto-history | этой ]] страничкой в разделе документации.
Основные отличия версий:
|| || v1 || v2 ||
=======================
|| ''Хранение документов'' || Накопительное || Актуальные данные ||
|| ''API процедур заключения контрактов'' || Отсутствует || Реализовано ||
|| ''Закупки по ПП РФ 615'' || В группе API 44-ФЗ || Вынесены в отдельный API ||
|| ''Метод авторизации'' || JWT || API Key ||
|| ''API триггеров (вебхуков)'' || Имеется || '''Не планируется''' ||
== План развития ==
|| Этап || Срок реализации || Описание || Доступ к API || Статус ||
====================================
|| 1 || 1кв 2024 || Реализация API для документов по 44-ФЗ || Свободный || '''Выполнен''' ||
|| 2 || 2кв 2024 || Реализация интеграции с сервисом отдачи информации ЕИС || Свободный || '''Выполнен''' ||
|| || '''01.07.2024''' || '''Релиз ГосПлан API v2 в объеме 44-ФЗ''' || || '''Выполнен''' ||
|| 3 || 3кв 2024 || Реализация API для документов по 223-ФЗ || Свободный || В работе ||
|| 4 || 4кв 2024 || Реализация API для документов по 615-ФЗ || Свободный || ||
|| 5 || 2025 || Промышленная эксплуатация || Тарифицируемый || ||
== Материалы проекта ==
. [[ docs | Документация ]]
. [[ legal | Правовые документы и реквизиты ]]
== Контакты ==
По всем вопросам работы сервисов '''ГосПлан API v2''' обращайтесь по контактным данным ниже:
. [[mailto:apiv2@gosplan.info | apiv2@gosplan.info]]