Гайды по интеграциям

Правовой кадастр (сведения о недвижимости) через ШЭП: как получать данные о правах и обременениях

· Автор: Команда SmartConnect

Как через ШЭП / Smart Bridge получать сведения из правового кадастра РК: зарегистрированные права, обременения (арест, ипотека), технические характеристики объекта. Архитектура запроса, ЭЦП, обработка ошибок, доступ и согласие. REST/JSON-фасад от SmartConnect.

Краткое определение. Правовой кадастр — единый государственный реестр зарегистрированных прав и обременений на недвижимое имущество РК (в составе ИС «Единый государственный кадастр недвижимости»). Сведения из него — собственник, вид права, доли, площадь, целевое назначение и обременения (арест, ипотека, запрет) — предоставляются через ШЭП / Smart Bridge по защищённому каналу с ЭЦП на запрос. SmartConnect подключает такие сервисы ШЭП «под ключ» — по той же схеме, что и другие интеграции нашего каталога, — отдавая интегратору чистый JSON вместо конвертов ШЭП.

Для кого: интеграционным и бэкенд-разработчикам банков, МФО, страховых, оценочных, нотариальных и proptech-команд, которым нужно проверять право собственности и наличие обременений на объект недвижимости.

Поисковый интент: «сведения о недвижимости через ШЭП», «правовой кадастр API», «проверка обременений объекта sb.egov.kz», «зарегистрированные права на недвижимость интеграция».

Статус сервиса в SmartConnect. Правовой кадастр — перспективный сервис нашего каталога ШЭП: он подключается по запросу под конкретный сценарий интегратора по той же архитектуре, что уже действующие адаптеры (например, Адресный регистр и сервисы КГД). Точный состав методов, формат идентификатора и лимиты фиксируются при подключении по паспорту сервиса в Smart Bridge и условиям доступа владельца данных — см. раздел «Доступ» ниже.


Зачем нужны сведения из правового кадастра

Проверка недвижимости — один из самых востребованных сценариев интеграции с госсистемами РК. Сведения о правах и обременениях нужны:

  • банкам и МФО — залоги, ипотека: подтвердить право собственности заявителя и проверить, нет ли на объекте арестов или действующих обременений перед выдачей кредита;
  • нотариату и proptech — проверка «чистоты сделки»: аресты, запреты на отчуждение, действующие обременения;
  • органам соцзащиты и операторам субсидий — справка об отсутствии недвижимости для подтверждения нуждаемости;
  • оценщикам и страховым — технические характеристики (площадь, назначение) как исходные данные.

Держатель данных — НАО «Государственная корпорация "Правительство для граждан"» (регистрирующий орган по месту нахождения недвижимости); методология и надзор — Министерство юстиции РК. Правовая база: Правила предоставления информации из правового кадастра (adilet V1200007586) и Правила ведения ИС «Единый государственный кадастр недвижимости» (adilet V2300033322).

Какие сведения можно получить

По каталогу Smart Bridge (sb.egov.kz) категория «недвижимость / правовой кадастр» опирается на государственные услуги ГК «Правительство для граждан». Ключевые типы справок:

Тип сведений Что возвращает Типовой сценарий
Зарегистрированные права и технические характеристики («расширенная» справка) Собственник(и), вид права, доли, площадь, целевое назначение, обременения Ипотека, оценка, проверка сделки
Наличие / отсутствие недвижимого имущества у лица Признак наличия объектов у физ/юрлица Соцвыплаты, субсидии, подтверждение нуждаемости
Зарегистрированные обременения и правопритязания Арест, ипотека/залог, сервитут, запреты Скоринг залога, проверка чистоты сделки

Регистрируемые права, которые могут фигурировать в ответе: право собственности, хозяйственного ведения, оперативного управления, землепользования (на срок ≥ 1 года), сервитуты (≥ 1 года).

Типичные обременения: ипотека (залог), арест, запрещение на отчуждение, сервитут, доверительное управление, аренда/имущественный наём (при регистрации).

Важно не путать услуги. «Наличие/отсутствие недвижимости» и «полная справка о правах» — это разные услуги с разным объёмом данных. При проектировании интеграции выбирайте метод под свой сценарий: для соцвыплат достаточно признака наличия, для ипотеки нужна расширенная справка с обременениями.

Как это работает через ШЭП (архитектура запроса)

Интегратор не подключается напрямую к ИС правового кадастра. Обмен идёт через государственный интеграционный шлюз (ШЭП / Smart Bridge), а SmartConnect выступает адаптером между вашей системой и ШЭП:

Ваша система → SmartConnect (шлюз) → ШЭП / Smart Bridge → ИС правового кадастра (ГК «Правительство для граждан»)
                                                        ← ответ (справка / отказ)
  1. Приём запроса. Ваш сервис вызывает REST/JSON-эндпоинт SmartConnect с идентификатором объекта или правообладателя — без знания SOAP и конвертов ШЭП.
  2. Сборка сообщения + валидация. Шлюз собирает сообщение по схеме сервиса и валидирует его на лету — класс ошибок «неверная структура» отсекается до отправки.
  3. ЭЦП. Сообщение подписывается ключом организации (хранение — HashiCorp Vault), формируется корректный ШЭП-конверт.
  4. Гарантированная доставка. Запрос уходит в ШЭП с retry, backoff и историей транзакций; ответ конвертируется обратно в JSON.
  5. Ответ. Ваш сервис получает нормализованный JSON: перечень прав, обременений и технических характеристик — либо явный признак «сведения отсутствуют».

Эти возможности (транспорт ШЭП, подпись, ретраи с backoff, dead-letter, журнал транзакций) — базовый функционал шлюза SmartConnect, общий для всех сервисов каталога. Под конкретный сервис правового кадастра остаётся только сопоставить его паспорт (методы, схему запроса/ответа) и условия доступа.

Как обрабатывать ошибки

Единого «универсального» справочника кодов у сервисов правового кадастра нет: каждый сервис описывает свой набор результатов в паспорте (WSDL/XSD). С точки зрения интеграции ответы укладываются в устойчивые категории, и адаптер должен обрабатывать именно их:

Категория ответа Что означает Рекомендуемая обработка
Успех + данные найдены Объект/право найдены, данные возвращены Нормализовать в JSON, отдать потребителю
Успех + данные отсутствуют Запрос корректен, но записи по объекту/лицу нет Это не ошибка — отдать явный «пустой» результат, не ретраить
Объект не идентифицирован Неточный адрес/РКА без кадастрового номера, объект не сопоставлен Не ретраить: вернуть 4xx, попросить уточнить идентификатор
Отказ по правам/согласию Нет прав ИС на сервис или отсутствует согласие субъекта на персональные сведения Не ретраить: эскалация на владельца доступа / сбор согласия
Ошибка источника Внутренняя ошибка сервиса-источника Ограниченный retry с backoff; при устойчивом сбое — в DLQ + алерт
Транспорт ШЭП недоступен / регламентные работы ШЭП или сервис на профилактике Retry с backoff по очереди, идемпотентность по ключу запроса
Таймаут / SOAP fault Нет ответа в срок либо ошибка конверта Retry с backoff; логировать корреляционный ID транзакции

Практический принцип: отделяйте «нет данных» от «ошибки», а восстанавливаемые ошибки (источник/транспорт/таймаут) — от невосстанавливаемых (идентификация/права/согласие). Ретраить имеет смысл только первые. SmartConnect реализует эту логику из коробки: очередь с retry/backoff, dead-letter для устойчивых сбоев и журнал транзакций с корреляционными ID.

Частые ошибки и подводные камни

  • Объект не идентифицирован. Если передан неточный адрес без кадастрового номера / РКА — сервис вернёт пустой результат или ошибку сопоставления. Рекомендация: сначала нормализовать адрес через Адресный регистр, затем запрашивать правовой кадастр по РКА / кадастровому номеру.
  • Согласие субъекта. Персональные сведения о правах конкретного лица могут требовать согласия или иного законного основания доступа — это регулируется на уровне доступа к сервису.
  • Расхождение технических характеристик между правовым, градостроительным и земельным кадастрами — источники разные. Для юридически значимых прав опирайтесь именно на правовой кадастр.

Доступ: что нужно уточнить при подключении

Правовой кадастр — сервис с данными о правах и персональными сведениями, поэтому доступ строже, чем к справочным сервисам. При подключении фиксируются:

  • Основание доступа. Договор/соглашение с владельцем данных (ГК «Правительство для граждан») и права вашей ИС на конкретный сервис в Smart Bridge. Состав методов и точные коды сервиса берутся из его паспорта в каталоге sb.egov.kz.
  • Формат идентификатора. Запрос строится по идентификатору объекта (кадастровый номер / РКА адреса) либо по ИИН/БИН правообладателя — в зависимости от выбранной услуги. Обязательные комбинации определяются схемой конкретного сервиса.
  • Согласие субъекта. Для персональных сведений о правах физлица может требоваться подтверждение согласия; без него сервис вернёт отказ по правам/согласию.
  • Лимиты и SLA. Ограничения по частоте запросов и время ответа регулируются регламентом сервиса и условиями владельца данных; их значения уточняются на этапе подключения по паспорту сервиса.

SmartConnect помогает пройти этот путь: подбираем нужные методы по паспорту, настраиваем авторизацию и ротацию ключей в шлюзе, закрываем транспорт ШЭП, подпись и обработку ошибок.

Запросить подключение к правовому кадастру — обсудим сценарий, подберём методы по паспорту сервиса и подключим к шлюзу.


FAQ

Правовой кадастр уже доступен через SmartConnect? Это перспективный сервис нашего каталога: он подключается по запросу под конкретный сценарий по той же архитектуре, что уже действующие адаптеры ШЭП. Состав методов и лимиты фиксируются при подключении.

По какому идентификатору идёт запрос? По идентификатору объекта (кадастровый номер / РКА) или по ИИН/БИН правообладателя — в зависимости от услуги. Обязательные комбинации задаёт схема конкретного сервиса.

Нужно ли согласие субъекта? Для персональных сведений о правах физлица — как правило да; без законного основания сервис вернёт отказ по правам/согласию.

Чем «наличие/отсутствие недвижимости» отличается от полной справки? Это разные услуги с разным объёмом данных: первая даёт признак наличия объектов, вторая — расширенные сведения о правах, долях и обременениях.

Кто владелец данных? НАО «Государственная корпорация "Правительство для граждан"»; методология и надзор — Министерство юстиции РК. Каталог и паспорт сервиса — на sb.egov.kz.


Источники: каталог sb.egov.kz (Smart Bridge), паспорта услуг регистрации недвижимости на egov.kz, adilet.zan.kz (Правила предоставления информации из правового кадастра V1200007586, Правила ведения ЕГКН V2300033322). Технические детали приведены по открытым источникам; состав методов, форматы идентификатора, коды ошибок, лимиты и SLA уточняются по паспорту сервиса и условиям доступа владельца данных при подключении.

Похожие статьи в рубрике «Гайды по интеграциям»