Формирование и отправка запросов в ЗАГС через СМЭВ

Бесплатная консультация юриста

+7 (800) 301-07-30

Реклама jurik.ru

В последние годы обмен государственными данными в России всё активнее переходит в электронную форму․ Одной из ключевых технологий, обеспечивающих надёжную и безопасную передачу информации между ведомствами, является Система межведомственного электронного взаимодействия (СМЭВ)․ В статье мы подробно разберём, как формировать и отправлять запросы в ЗАГС через СМЭВ, какие особенности имеют специальные очереди, как работать с nodeId, какие версии адаптеров существуют и как контролировать статус сообщения․


Содержание

  1. Что такое СМЭВ?
  2. ЗАГС в рамках СМЭВ
  3. Архитектура обмена: узлы, очереди, nodeId
  4. Типы запросов к ЗАГС
  5. Пошаговое формирование СМЭВ‑запроса
  6. SQL‑запросы в СМЭВ 4
  7. Мониторинг и отладка сообщений
  8. Типичные ошибки и способы их устранения

Что такое СМЭВ?

СМЭВ (Система межведомственного электронного взаимодействия) – это единая инфраструктура, позволяющая государственным органам, муниципалитетам и уполномоченным организациям обмениваться данными в автоматическом режиме․ На текущий момент функционируют три версии:

  • СМЭВ 2 – устаревшая, использующая протокол SOAP․
  • СМЭВ 3 – основной вариант, обеспечивающий гарантированную доставку пакетов запросов‑ответов․
  • СМЭВ 4 – современный, поддерживает регламентированные запросы (РЗ) типа SQL и работу с «витринами» данных поставщиков․

Главная цель СМЭВ – гарантировать доставку пакетов и обеспечить их целостность, а также вести журнал всех этапов обмена (отправка, получение, обработка, ответ)․


ЗАГС в рамках СМЭВ

Служба регистрации актов гражданского состояния (ЗАГС) предоставляет сведения, известные как СИР (Сведения ЗАГС)․ Доступ к этим данным через СМЭВ позволяет:

  • Получать выписки о браке, рождении, смерти и другие актовые записи․
  • Автоматизировать проверку правомочности документов в банках, страховых компаниях и государственных сервисах․
  • Сократить время обработки запросов с дней до минут․

С 2020‑го года в СМЭВ реализованы специальные очереди, позволяющие распределять сообщения по видам сведений (например, отдельные очереди для ПФР и для ЕГР ЗАГС)․ Это упрощает работу ИС УВ (Информационная система управления) и устраняет необходимость в дополнительных модулях разбора ответов․


Архитектура обмена: узлы, очереди, nodeId

Обмен данными в СМЭВ происходит через узлы (node) и очереди (queues)․ Каждый узел имеет уникальный идентификатор nodeId․ При запросе к ЗАГС обычно задействованы два узла:

  • Первый узел – принимает ответы от ПФР (Пенсионный фонд России)․
  • Второй узел – получает ответы от ЕГР ЗАГС․

Новая версия адаптера СМЭВ позволяет работать раздельно со специальными очередями․ В результате сообщения автоматически распределяются по нужному типу сведений, а клиент получает ответ в соответствующей очереди без дополнительного парсинга․

Схема взаимодействия выглядит так:

[Клиент] --(запрос)--> [Адаптер СМЭВ] --(передача)--> [Очередь 1 (ПФР)] 
[Клиент] --(запрос)--> [Адаптер СМЭВ] --(передача)--> [Очередь 2 (ЕГР ЗАГС)]
[Ответ] <--(сообщение)--- [Очередь 2] <--(доставка)--- [Адаптер] <--(получение)--- [Клиент]

Типы запросов к ЗАГС

В СМЭВ запросы классифицируются по request_type․ Для получения сведений из ЕГР ЗАГС обязательны следующие параметры:

  • request_type = 1 – запрос выписки из реестра актов․
  • Если request_type не указан, в сервис будет передан признак отсутствия (это приводит к ошибке)․
  • Только один из атрибутов request_type может быть указан одновременно․

Пример типовых запросов:

Тип запроса Назначение Код
Выписка о браке Получить акт регистрации брака 1
Выписка о рождении Получить акт рождения ребёнка 1
Сведения о смерти Получить акт смерти 1

Пошаговое формирование СМЭВ‑запроса

Шаг 1․ Подготовка сертификатов и ключей

Для работы с СМЭВ необходимо:

  • Квалифицированный электронный сертификат (КЭП) организации․
  • Приватный ключ, соответствующий сертификату․
  • Установить доверенные корневые сертификаты СМЭВ‑Центра․

Шаг 2․ Выбор адаптера

В зависимости от версии СМЭВ выбираем адаптер:

  • СМЭВ 3 – адаптер SMEV3Adapter (SOAP‑сообщения)․
  • СМЭВ 4 – адаптер SMEV4Adapter (REST/JSON + регламентированный запрос)․

Шаг 3․ Формирование XML‑запроса

Пример XML‑запроса к ЗАГС (СМЭВ 3):

<?xml version="1․0" encoding="UTF-8"?>
<sm:Request xmlns:sm="http://www․cbr․ru/smev">
 <sm:Header>
 <sm:MessageID>123e4567-e89b-12d3-a456-426614174000</sm:MessageID>
 <sm:SenderID>urn:org:mycompany:client</sm:SenderID>
 <sm:ReceiverID>urn:org:federal:zags</sm:ReceiverID>
 <sm:Timestamp>2026-07-09T03:15:00Z</sm:Timestamp>
 </sm:Header>
 <sm:Body>
 <zags:GetActRequest>
 <zags:ActType>BRIDEGROOM</zags:ActType>
 <zags:ActNumber>2026/001234</zags:ActNumber>
 <zags:Date>2026-06-15</zags:Date>
 <zags:RequestType>1</zags:RequestType>
 </zags:GetActRequest>
 </sm:Body>
</sm:Request>

Для СМЭВ 4 запрос выглядит как JSON‑payload, где в поле sql указывается регламентированный запрос к витрине данных поставщика․

Шаг 4․ Подписание сообщения

С помощью КЭП подписываем XML‑документ (CMS/PKCS#7)․ В Java это делается через org․bouncycastle, в ․NET – через SignedXml․

Шаг 5․ Отправка сообщения в очередь

С помощью клиентской библиотеки (например, SMEVClient) указываем:

  • Идентификатор очереди (для ЗАГС – обычно queue_zags)․
  • nodeId получателя (в примере – nodeId=2)․
  • Таймаут ожидания ответа (рекомендовано 30–60 секунд)․

Шаг 6․ Обработка ответа

Ответ приходит в виде XML‑сообщения, где в Body находится элемент zags:GetActResponse․ Пример:

<sm:Response ․․․>
 <sm:Header ․․․>․;․</sm:Header>
 <sm:Body>
 <zags:GetActResponse>
 <zags:ActNumber>2026/001234</zags:ActNumber>
 <zags:ActDate>2026-06-15</zags:ActDate>
 <zags:Spouse1>Иванов Иван Иванович</zags:Spouse1>
 <zags:Spouse2>Петрова Мария Сергеевна</zags:Spouse2>
 <zags:Status>ЗАРЕГИСТРИРОВАНО</zags:Status>
 </zags:GetActResponse>
 </sm:Body>
</sm:Response>

Если в ответе присутствует Fault, необходимо проанализировать код ошибки (например, SMEV-0012 – неверный request_type)․


SQL‑запросы в СМЭВ 4

СМЭВ 4 поддерживает регламентированные запросы (РЗ) типа SQL․ Это удобно, когда поставщик (ЗАГС) предоставляет «витрину» данных․ Пример запроса:

{
 "requestId": "REQ-20260709-001",
 "sql": "SELECT act_number, act_date, spouse1_fio, spouse2_fio, status
 FROM zags_acts
 WHERE act_number = :actNumber",
 "parameters": {
 "actNumber": "2026/001234"
 }
}

Ответ будет в виде JSON‑массива:

{
 "requestId": "REQ-20260709-001",
 "rows": [
 { "act_number": "2026/001234",
 "act_date": "2026-06-15",
 "spouse1_fio": "Иванов Иван Иванович",
 "spouse2_fio": "Петрова Мария Сергеевна",
 "status": "ЗАРЕГИСТРИРОВАНО"
 }
 ]
}

Важно помнить, что в СМЭВ 4 каждый запрос привязан к версии ВС (вид сведений)․ При появлении новой версии необходимо подать отдельный запрос на регистрацию в качестве ответчика․


Мониторинг и отладка сообщений

Для контроля жизненного цикла сообщения в СМЭВ предусмотрены инструменты:

  • Личный кабинет УВ (Управление Взаимодействием) – позволяет просматривать статус сеанса обмена, время прохождения каждого этапа и детали ошибок․
  • Логи адаптера – в них фиксируются отправка, получение, подпись и проверка сертификатов․
  • Служба «Служебные документы Правительства Курганской области» – содержит ежедневные выгрузки сведений о всех актовых записях, что удобно для сверки․

Пример запроса статуса через ЛК УВ:

GET /api/v1/sessions/123e4567-e89b-12d3-a456-426614174000/status
Authorization: Bearer <token>

Ответ:

{
 "sessionId": "123e4567-e89b-12d3-a456-426614174000",
 "state": "COMPLETED",
 "sentAt": "2026-07-09T03:15:00Z",
 "receivedAt": "2026-07-09T03:15:12Z",
 "durationMs": 12000
}

Типичные ошибки и способы их устранения

Код ошибки Описание Решение
SMEV‑0012 Отсутствует или неверный request_type Убедитесь, что в запросе указан request_type=1 и только один атрибут указан․
SMEV‑0034 Неправильный nodeId получателя Проверьте конфигурацию адаптера: для ЕГР ЗАГС используйте nodeId=2․
SMEV‑0100 Сертификат не доверяется Обновите список доверенных корневых сертификатов СМЭВ‑Центра․
SMEV‑0201 Таймаут ожидания ответа Увеличьте параметр timeout в клиенте до 60–90 секунд․

СМЭВ‑запрос в ЗАГС – это мощный инструмент, позволяющий автоматизировать получение актовых записей и интегрировать их в бизнес‑процессы банков, страховых компаний и государственных сервисов․ Ключевые преимущества:

  • Гарантированная доставка и целостность данных․
  • Разделение потоков через специальные очереди, что упрощает обработку․
  • Поддержка как XML‑запросов (СМЭВ 3), так и SQL‑запросов (СМЭВ 4)․
  • Полный набор средств мониторинга и отладки․

Следуя описанным в статье шагам – от подготовки сертификатов до анализа ответов – вы сможете быстро внедрить обмен сведениями с ЗАГСом в своей информационной системе и обеспечить надёжную работу с государственными данными․

Помните: каждый новый релиз СМЭВ может вводить новые версии видов сведений, поэтому регулярно проверяйте актуальность конфигураций и регистрируйте свои сервисы в качестве ответчиков․


Дата публикации: 09 июля 2026 г․