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-ФЗ - [[https://swagger.gosplan.info/?urls.primaryName=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 || 01.11.2024 || Реализация API для документов по 223-ФЗ || Свободный || '''Выполнен''' ||
|| 4 || 31.12.2024 || Реализация API для документов по 615-ФЗ || Свободный ||  В работе ||
|| 5 || 2025 || Промышленная эксплуатация || Тарифицируемый || ||

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

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

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

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