Спецификация API для передачи данных из ЕИСЖС в ИС уполномоченных банков
(с учетом изменений в 214-ФЗ)
Спецификация API для передачи данных из ЕИСЖС в ИС уполномоченных банков 1
1. Используемые термины и сокращения 3
2. Общая информация 3
3. Описание сценариев и операций 4
3.1 Сценарии 4
3.1.1 Запрос пакета информации от уполномоченного Банка 4
3.1.2 Изменение пакета информации по застройщику 7
3.1.3 Передача информации о нецелевом использовании средств 8
3.1.4 Передача информации о регистрации права собственности 13
4. Состав данных 16
4.1 Объекты 16
4.1.1 Застройщик 16
4.1.2 Реквизиты банка 16
4.1.3 Проект строительства 17
4.1.4 Пакет документов 17
4.1.5 Информация о нецелевом использовании средств 18
4.1.6 Список статусов запроса 20
4.1.7 Коды ошибок 20
4.2 Сообщения 20
4.2.1 Сообщение «Запрос пакета информации» 20
4.2.2 Сообщение «Пакет информации подготовлен» 21
4.2.3 Сообщение «Пакет информации изменен» 21
4.2.4 Сообщение «Нецелевое использование средств с расчетного счета» 22
4.2.5 Сообщение «Подтверждение получения информации о нецелевом использовании средств с расчетного счета» 22
4.2.6 Сообщение «Подтверждение передачи КО информации о нецелевом использовании средств» 23
4.2.7 Сообщение «Регистрация права собственности по проекту строительства» 23
4.2.8 Сообщение об ошибке 24
4.2.9 Список запросов 24
4.2.10 Идентификатор (GUID) запроса 25
5. Интерфейс 26
6. Безопасность 29
Приложение 1. XSD-схема 30
Используемые термины и сокращения
Термин | Описание |
ЕИСЖС | Единая информационная система жилищного строительства |
ПД | Проектная декларация/ Проект строительства |
УБ | Уполномоченный банк |
ИС | Информационная система |
ЛКЗ | Личный кабинет застройщика |
КО | Контролирующий орган |
ЧТЗ | Частное техническое задание |
REST API | (англ. Representational State Transfer Application Programming Interface) Программные интерфейсы взаимодействия информационных систем с использованием архитектурного стиля REST |
Нецелевое использование | Под случаями «нецелевого использования средств понимаются случаи указания Застройщиком в распоряжении информации, не соответствующей требованиям статьи 18 Федерального закона -ФЗ «Об участии в долевом строительстве многоквартирных домов и иных объектов недвижимости и о внесении изменений в некоторые законодательные акты Российской Федерации». |
Текущий документ содержит требования к реализации API для организации автоматизированного информационного обмена между ЕИСЖС и информационными системами уполномоченных банков.
Текущий документ не содержит детальное описание требований к обработке на стороне ЕИСЖС входящих сообщений и исходящих сообщений, данная информация будет отражена в ЧТЗ, в том числе:
Требования к управлению расчетного счетами застройщиков; Требования к управлению пакетами информации по застройщику; Требования к определению события регистрации права собственности; Требования к передаче информации нецелевом использовании средств средств в Фонд защиты дольщиков и КО; Прочие детали реализации, не оказывающие непосредственное влияние на API для взаимодействия ЕИСЖС и УБ. Описание сценариев и операций СценарииСценарий представляет собой последовательность действия со стороны ЕИСЖС и УБ. Одна или несколько операций составляют сценарий.
Запрос пакета информации от уполномоченного БанкаТаблица 1 – Сценарий «Запрос пакета информации от уполномоченного Банка»
№ | Участник | Действие | Описание/ Комментарии | Пример |
1 | УБ | ИС Банка передает в ЕИСЖС запрос на предоставление пакета информации по разрешению на строительство | Спецификация сообщения «Запрос пакета информации» представлена в 4.2.1. Запрос создается с помощью метода post /request (Таблица 22). | <?xml version="1.0" encoding="utf-8"?> <msgInfoPackageRequest xmlns="http://eisgs. ahml. ru/ab/model"> <constructionProject> <buildPermitNumber>62-29-154-2016</buildPermitNumber> <buildPermitDate>2016-11-12T10:20:30</buildPermitDate> <commercialName>ЖК Ромашка</commercialName> </constructionProject> <bankDetails> <bic>044525225</bic> <bankName>"АЙТИ БАНК" (ПАО)</bankName> </bankDetails> <packageVersionNumber>1</packageVersionNumber> </msgInfoPackageRequest> |
2 | ЕИСЖС | ЕИСЖС передает УБ GUID запроса | В ответ на запрос пакета информации УБ получает идентификатор (guid) запроса. Спецификация сообщения «Идентификатор (GUID) запроса» представлена в 4.2.10. | <?xml version="1.0" encoding="utf-8"?> <msgRequestId xmlns="http://eisgs. ahml. ru/ab/model"> <guid>079cb9f4-c7cb-46fb-a00d-567866c66f33</guid> </msgRequestId> |
3 | ЕИСЖС | Валидация полученного от ЕИСЖС запроса запрос на предоставление пакета информации | Валидация на соответствие xsd-схеме. Если валидация пройдена успешно – переход на Шаг 4, иначе при проверке статуса запроса УБ возвращается сообщение об ошибке (Шаг 6). | - |
4 | ЕИСЖС | ЕИСЖС проверяет корректность данных по разрешению на строительство, указанную УБ | На стороне ЕИСЖС проверяется, что в ЕИСЖС зарегистрировано соответствующее разрешение на строительство. Если по переданным реквизитам разрешения на строительство не найден застройщик или не идентифицирован проект строительства (найдено несколько проектных деклараций), то при проверке статуса запроса УБ возвращается сообщение об ошибке (Шаг 6). Если проверка пройдена успешно, то переход на Шаг 5, иначе дальнейшая обработка прекращается, возвращается сообщение об ошибке проверки (Шаг 6). Спецификация сообщения об ошибке представлена в 4.2.8. | - |
5 | ЕИСЖС | ЕИСЖС формирует пакет документов | Если в сообщении «Запрос пакета информации» атрибут «Номер версии пакета» заполнен, то предоставляется указанная версия. Если указанная версия пакета не найдена в ЕИСЖС, то при проверке статуса запроса УБ возвращается сообщение об ошибке (Шаг 6). Спецификация сообщения об ошибке представлена в 4.2.8. Если атрибут «Номер версии пакета» не заполнен, то предоставляется самая последняя сформированная версия. | - |
6 | УБ | Банк с определенной периодичностью производит опрос – проверку статуса по guid запроса, полученном на Шаге 2 | Проверка статуса производится с помощью метода /request/{GUID} (Таблица 22). В ответ могут быть получены статусы:
202 (IN_PROGRESS) – запрос еще обрабатывается, опрос статуса запроса должен продолжаться.
Спецификация сообщения об ошибке представлена в 4.2.8. | <?xml version="1.0" encoding="utf-8"?> <msgInfoPackageReady xmlns="http://eisgs. ahml. ru/ab/model"> <constructionProject> <buildPermitNumber>62-29-154-2016</buildPermitNumber> <buildPermitDate>2016-11-12T10:20:30</buildPermitDate> <commercialName>ЖК Ромашка</commercialName> </constructionProject> <documentPackage> <packageVersionNumber>2</packageVersionNumber> <packageVersionDate>2018-04-22T01:01:01</packageVersionDate> <packageGuid>d8ba1783-c104-4bf5-85bd-094337c6c263</packageGuid> <packageChanges>Обновлена ПД</packageChanges> </documentPackage> </msgInfoPackageReady> |
7 | УБ | Банк получает пакет информации. Банк проверяет полученный пакет информации | На основе guid пакета документов в DocStore Банк имеет доступ к архиву с документами с помощью метода get /getDocumentPackage/{package_guid} (Таблица 22). | - |
8 | ЕИСЖС | Факт запроса информации фиксируется | В БД ЕИСЖС фиксируется информация о факте запроса пакета информации и дата запроса информации. | - |
Изменение пакета информации по застройщику
Таблица 2- Сценарий «Изменение пакета информации по застройщику»
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 |
