Syntax highlighting of Home

= ГосПлан =

== О проекте ==

Проект '''ГосПлан''' представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 2018м году.

Базовыми публичными сервисами проекта '''ГосПлан''' являются веб-сервисы, которые предоставляют API к документам Единой информационной системе в сфере закупок (ЕИС Закупки, [[https://zakupki.gov.ru]]). Актуальная версия до 01.07.2024  - '''ГосПлан API v1'''.
 . сайт проекта - [[https://dev.gosplan.info/]],
 . документация - [[https://quarter18.gitbook.io/gosplan/]],
 . описание API - [[https://api-doc.gosplan.info/]]

В настоящее время ведется разработка второй версии API - '''ГосПлан API v2''':
 . вики - [[https://wiki.gosplan.info]]
 . описание API 44-ФЗ - [[https://swagger-v2beta.gosplan.info/?urls.primaryName=44-ФЗ]]

Релиз API v2 запланирован на 01.07.2024

== Переход с API v1 на v2 ==

Сервис ГосПлан API v1 построен на интеграции с публичным FTP-сервером ЕИС, на котором размещаются информация и документы в машиночитаемом виде. В связи с переходом ЕИС на [[https://zakupki.gov.ru/epz/main/public/news/news_preview.html?newsId=34208 | на сервисы отдачи информации]] и последующим закрытием доступа к FTP-серверу c 01.07.2024, первая версия API потеряет возможность получать актуальные документы. При этом документы, загруженные до 01.07.2024 будут доступны. Ввиду запланированного перехода в 2025 году на вторую версию, а также высоких трудозатрат на реализацию, принято решение не дорабатывать API v1 под новые требования ЕИС. Следовательно, после '''01.07.2024''' новые документы публиковаться не будут. Через один месяц - '''01.08.2024''' - сервис будет отключен и API v1 будет недоступен.

В свою очередь, интеграция ГосПлан API v2 с ''сервисами отдачи информации'' ЕИС находится на завершающей стадии. Планируется, что до 01.07.2024 сервис будет запущен.

'''Для новых и текущих решений, использующих ГосПлан, настоятельно рекомендуется перейти на вторую версию API''' - [[https://swagger-v2beta.gosplan.info/?urls.primaryName=44-ФЗ]].


== ГосПлан API v2 ==

'''ГосПлан API v2''' находится на завершающей стадии разработки. Были учтены особенности функционирования первой версии, а также современные тенденции развития web-приложений. Помимо очевидных изменений в методах доступа к ресурсам пересмотрены стек инструментов разработки, доставки и развертывания сервисов. По сути проект переписывается ''с нуля''.

Главной особенностью новой версии является явное ограничение во времени хранения документов. В первой версии Сервиса хранение документов является ''накопительным'', т.е. обозначалась дата, начиная с которой все документы,  опубликованные в ЕИС, попадают в сервис. Со временем объем хранимых документов возрастает на столько, что эффективность поиска необходимой информации значительно снижается. Исходя из вариантов использования сервиса, значительное количество запросов относится к актуальным (открытым) закупкам и контрактам, тогда как ''исторические данные'' не пользуются популярностью. В API v2 доступ будет предоставляться к ''актуальным'' документам. Это означает, что сервис гарантировано сохраняет информацию о закупках, процедурах и контрактах до тех пор, пока закупка или контракт не закрыты или отсутствуют обновления по документам. После того, как документы потеряли актуальность, хранение обеспечивается предварительно в течении '''6 месяцев'''. 

Если Вам требуются ''исторические данные'', то можно ознакомиться с [[ docs/howto-history | этой ]] страничкой в разделе документации.

Основные отличия версий:
||  || v1 || v2 ||
=======================
|| ''Хранение документов'' || Накопительное  || Актуальные данные  ||
|| ''API процедур заключения контрактов'' || Отсутствует || Реализовано ||
|| ''Закупки по ПП РФ 615'' || В группе API 44-ФЗ  || Вынесены в отдельный API  ||
|| ''Метод авторизации'' || JWT || API Key ||
|| ''API триггеров (вебхуков)'' || Имеется || '''Не планируется''' ||

== План развития ==

|| Этап || Срок реализации || Описание || Доступ к API || Глубина загрузки данных || Статус ||
====================================
|| 1 || 1кв 2024 || Реализация API для документов по 44-ФЗ || Свободный || c 01.01.2024 || '''Выполнен''' ||
|| 2 || 2кв 2024 || Реализация интеграции с сервисом отдачи информации ЕИС || Свободный || с 01.01.2024 || В РАБОТЕ ||
|| '''3''' || '''01.07.2024''' || '''Релиз ГосПлан API v2 в объеме 44-ФЗ''' || '''Свободный''' || '''6 месяцев''' ||  ||
|| 4 || 3кв 2024 || Реализация API для документов по 223-ФЗ || Свободный || 6 месяцев  ||  ||
|| 5 || 4кв 2024 || Реализация API для документов по 615-ФЗ || Свободный || 6 месяцев  ||  ||
|| 6 || 2025 || Промышленная эксплуатация || Тарифицируемый || 6 месяцев ||  ||

== Материалы проекта ==

 . [[ docs | Документация ]]
 . [[ legal | Правовые документы и реквизиты ]]

== Контакты ==

По всем вопросам работы сервисов '''ГосПлан API v2''' обращайтесь по контактным данным ниже:
 . [[mailto:apiv2@gosplan.info | apiv2@gosplan.info]]