Порядок работы с API¶

На изображении представлен алгоритм работы с API контур Реестро. Детальное описание методов представлено ниже.

ДО - документооборот

Подсказка

Если вы интегрируетесь для отправки запросов на получение сведений из ЕГРН (выписки) - вас интересуют только пункты «Авторизация», «Создание документооборота», «Актуализация состояния документооборота», «Обработка результатов».

Авторизация¶

Для работы с методами API необходима Авторизация.

В случае успешной авторизации пользователь может инициировать создание ДО, иначе необходимо авторизоваться заново.

Создание документооборота¶

Создание документооборота инициализирует процесс работы API Котнур.Реестро с документооборотом. Получение ДО API Котнур.Реестро не отождествляется с его отправкой в Росреестр.

После создания ДО API Контур.Реестро на основании полученных данных проверяет наличие требований (requirements) к данному ДО.

в случае их отсутствия ДО становится в очередь на отправку (HTTP возврата 200);

если они определены, то пользователю возвращаются Requirements к документообороту (HTTP возврата 201).

Подписание¶

Если после того, как вы создали ДО, он переходит в статус suspend -> ДО присвоено требование signature.

signature - требование (Requirements) подписать заявления участниками документооборота.

Примечание

Данное требование возникает до момента отправки ДО в Росреестр, в связи c необходимостью создания электронной версии заявления на регистрационное действие.

Для обработки данного требования необходимо осуществить Добавление подписи на каждый файл. Когда все документы будут подписаны, можно переходить к отправке ДО.

Отправка документооборота¶

После подписания заявлений участниками документооборота, необходимо использовать метод Отправка документооборота.

При получении запроса на отправку, он помещается в очередь проверки количества приложенных подписей для каждого документа и их верификации.

Предупреждение

В случае, если подписей недостаточно либо они не корректны, то будет сгенерировано событие, содержащее описание соответствующей ошибки.

Актуализация состояния документооборота¶

После создания документооборота, его состояние может измениться в связи с его обработкой API Реестро, затем Росреестром. Документообороту могут быть присвоены следующие статусы:

queued: ожидает отправки

sent: отправлен в Росреестр

suspended: требуются дополнительные действия

completed: исполнено

error: ошибка обработки

Для получения информации о событиях по документообороту необходимо периодически:

использовать метод Вычитывание новостей;

использовать метод Запрос описания документооборота.

Оплата пошлины¶

После успешной отправки ДО запрос поступает в обработку системой Росреестра. Начисление гос. пошлин для заявки происходит до инициализации обработки заявки сотрудником Росреестра.

Подсказка

Государственная пошлина начисляется за каждое регистрационное действие, которое предусматривает оплату каждому участнику документооборота индивидуально, учитывая льготы.

В случае, необходимости оплаты гос. пошлины, документооборот переходит в состояние suspend и формируется требование (Requirements) payment, содержащее УИН и сумму для оплаты.

Для продолжения работы с заявкой - необходимо оплатить все начисленные гос. пошлины для данной заявки. Информация об оплате государственной пошлины поступает в Росреестр автоматически в течении суток с момента оплаты.

Обработка результатов¶

После выполнения всех требований (если они были), необходимо продолжить процесс актуализации документооборота до получения статуса completed. Если документооборот в состоянии completed, то ответ будет содержать результат обработки документооборота (Result).

Чтобы получить результирующие документы, необходимо выполнить Запрос содержимого файла.

Примечание

Для каждого типа запроса результат будет содержать индивидуальный набор файлов.