интеграция с Росреестром никогда прежде не была такой простой
Всегда на шаг впереди
Забудьте о смене форматов заявлений и
выходных документов, это мы берем на себя.
Мы предлагаем набор библиотек
которые вы можете быстро встроить в свою систему. Вот и вся интеграция - всего несколько шагов
Скачать
Скоро вы сможете скачать библиотеки SIL и документацию. к ним. Материалы распространяются совершенно бесплатно!
Встроить
Библиотеки легко встраиваются. Все интерфейсы стандартизованы. Здесь появится инструкция по встраиванию SIL.
Протестировать
Вы можете проверить взаимодействие на нашем тестовом стенде. Адрес стенда и руководство по подключению появятся на этом месте
SmartDeal Integration Library (SIL) предоставляется в виде загружаемых библиотек/модулей для популярных языков программирования - Java, Ruby, Python, .Net, Node.js, PHP.
Структурно SIL является надстройкой для бесшовного общения с REST API SmartDeal по протоколу https.

Основное предназначение - маскировка сложностей авторизации, сопровождения сессии, соблюдение допустимых пределов значений и проверка правильности формата протокола обмена данными между клиентом и сервером.

Каждая языковая реализация SIL предоставляется в прекомпилированном виде с открытым исходным кодом.
Вот что Вам потребуется для начала
Аккаунт Клиента на стороне SmartDeal
Вы должны быть зарегистрированы в качестве Клиента на стороне SmartDeal, это означает, что у вас должны быть собственные логин и пароль, которые будут использоваться при общении вашей информационной системы (ИС) с API SmartDeal.
Библиотека SIL
Вы должны загрузить соответствующую вашей среде реализацию SIL с сайта SmartDeal - это ваше средство общения с SmartDeal API. Ваша ИС инициализирует SIL с помощью регистрационных данных вашего Аккаунта Клиента, вызывает методы SIL и получает результаты работы API.
Разработчики соответствующей квалификации
Интеграция - это работа разработчика. SmartDeal Integration Library - одна из самых простых интеграций, которые ваши разработчики когда-либо увидят. Хотя время интеграции может варьироваться в зависимости от вашего бизнеса, опытный разработчик может завершить базовую интеграцию с SmartDeal менее чем за день.
Защищённый канал связи с SmartDeal
Согласно законодательству РФ канал связи между вашей ИС и SmartDeal должен быть защищён по стандартам РФ ГОСТ Р 34.11-94, ГОСТ Р 34.10-94, ГОСТ Р 34.10-2001, ГОСТ 28147-89.
Безопасность и хранение данных
Общение между вашей ИС и SmartDeal происходит в рамках защищённого канала связи и только в рамках авторизованной клиентской сессии, это означает что обмен данных изолирован в пределах вашего клиентского аккаунта и хранится только в оперативной памяти, пока сессия существует. Сессия обладает собственным циклом жизни, который прерывается либо по истечению определённого времени, либо принудительно, по инициативе вашей ИС, после чего все данные, не подлежащие хранению удаляются из памяти.

Согласно законодательству РФ SmartDeal не хранит никаких данных, которые относятся к категории персональных. Также, SmartDeal не хранит данных, которые не относятся к статусам документов в Росреестре (после отправки) и/или к регистрационным данным Клиента.
Общение SmartDeal с Росреестра происходит также по защищённому каналу связи, согласно стандартам и законодательству РФ.

Таким образом, ваша ИС ответственна за хранение всех собственных данных и идентификаторов документов и пакетов, SmartDeal используется только для обращений к сервисам Росреестра и получения результатов обращений.

Если для подписания обращений используется внешний Удостоверяющий Центр (УЦ), то в этом случае SmartDeal выступает транспортным агентом и все ключи и сертификаты хранятся в УЦ, а не на серверах SmartDeal, что исключает возможность их компрометации. Общение между SmartDeal и УЦ также идёт только по защищённому каналу.
Онлайн и оффлайн взаимодействие
На любой вызов SIL ваша ИС будет получать незамедлительный (в рамках известных пределов и сетевой задержки) ответ, содержащий статус исполнения инструкции и, в большинстве случаев, результат. Но в некоторых случаях результат не может быть получен моментально, например - при отправке обращения в Росреестр. Для таких случаев предусмотрен механизм "Webhook", который является обратным вызовом вашей ИС со стороны SmartDeal. Адресация обратных вызовов настраивается в вашем Аккаунте Клиента, непосредственно в среде исполнения её изменить/назначить невозможно. Вызов поступает когда случается какое-то событие, которое не привязано к общему сценарию взаимодействия, например, изменяется статус обращения в Росреестре.

Каждый вызов Webhook выполняется с методом POST и содержит два поля: kind (вид уведомления) и payload (зашифрованное тело уведомления).
Тело уведомления надлежит передать в экземпляр SIL, для проверки целостности и распаковки. Если пакет уведомления действителен и структурно верен, то на выходе ваша ИС получает уже распакованный объект, готовый к обработке. В ином случае будет активировано исключение обработки.

Если же ваша ИС не предусматривает внешних обращений по каким-либо причинам, то все подобные события могут быть получены через SIL, по запросу, в виде списка за определённый временной промежуток.

Подписание документов ЭП
SIL предлагает два способа подписания обращений:

- непосредственное подписание одной ЭП клиента;
- подписание одной и более ЭП с помощью сертифицированного УЦ.

В первом случае, SIL непосредственно перед отправкой обращения выгружает в вашу ИС полный документ, который подписывается силами ИС, с помощью собственной ЭП. Полученная единственная подпись отправляется в SmartDeal, где она прикрепляется к обращению и загружается в Росреестр.

Во втором случае, ваша ИС по запросу получает список доступных УЦ, затем передаёт идентификатор выбранного УЦ, идентификационные данные всех сторон подписания, при необходимости и, если УЦ поддерживает мульти -факторную/-ступенчатую авторизацию, последовательные наборы данных для каждого фактора/шага авторизации; после этого SmartDeal взаимодействует с УЦ и подписывает документ, после чего ваша ИС получает статус операции.

Также, во втором случае вы можете использовать SIL для импорта сертификатов и ключей в УЦ либо для создания новых.