В последние годы обмен государственными данными в России всё активнее переходит в электронную форму․ Одной из ключевых технологий, обеспечивающих надёжную и безопасную передачу информации между ведомствами, является Система межведомственного электронного взаимодействия (СМЭВ)․ В статье мы подробно разберём, как формировать и отправлять запросы в ЗАГС через СМЭВ, какие особенности имеют специальные очереди, как работать с nodeId, какие версии адаптеров существуют и как контролировать статус сообщения․
Содержание
- Что такое СМЭВ?
- ЗАГС в рамках СМЭВ
- Архитектура обмена: узлы, очереди, nodeId
- Типы запросов к ЗАГС
- Пошаговое формирование СМЭВ‑запроса
- SQL‑запросы в СМЭВ 4
- Мониторинг и отладка сообщений
- Типичные ошибки и способы их устранения
Что такое СМЭВ?
СМЭВ (Система межведомственного электронного взаимодействия) – это единая инфраструктура, позволяющая государственным органам, муниципалитетам и уполномоченным организациям обмениваться данными в автоматическом режиме․ На текущий момент функционируют три версии:
- СМЭВ 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 г․