Интеграция с ГИС ЭП «Электронная путёвка»: SOAP 1.1, аттестация ФСТЭК и регламент Минэкономразвития v4.1

Крупный речной оператор — туризм и госинтеграции. Интеграция с ГИС ЭП «Электронная путёвка» по SOAP 1.1 + регламент v4.1 Минэкономразвития, аттестация АРМ ФСТЭК. Запуск в проде 30.08.2024 — за полтора года до остановки развития системы. Сохранена реестровая аккредитация туроператора.

Важная терминология. ГИС ЭП «Электронная путёвка» — Государственная Информационная Система учёта электронных путёвок туроператоров. Регулятор — Минэкономразвития России (не Ростуризм/Росстат, не Минтранс). Регламент взаимодействия ГИС ЭП v4.1 (Минэкономразвития, 2025). Транспорт — SOAP 1.1. Production-endpoints: prod.eisep.ru:40001/EPInputWS (отправка путёвок) + prod.eisep.ru:40000/EPMessageExchangeWS (обмен сообщениями). Подпись — квалифицированные УКЭП от аккредитованных Минцифрой УЦ. Подключение требует аттестации АРМ туроператора силами лицензиатов ФСТЭК + ФСБ. НЕ путать с ЕГИС ОТБ (отдельный кейс) — другая система Минтранса (АЦБПДП, ПП 1208) для антитеррора пассажиров на транспорте.

Контекст 2026. В начале февраля 2026 стало известно (Tadviser, ev.economy.gov.ru), что Минэкономразвития фактически прекратило развитие ГИС ЭП — последний контракт на сопровождение платформы заключён в мае 2025 года и завершён в декабре 2025-го, новых тендеров с тех пор не объявлено. Это контекстный нюанс кейса: мы успели запустить интеграцию в проде за полтора года до остановки развития (30.08.2024), теперь система продолжает работать в режиме maintenance. Кому интегрироваться сейчас — не получают ни support, ни обновлений.

Туристические путёвки в ГИС ЭП через SOAP 1.1 — звучит как стандартная интеграция. На практике — несколько месяцев reverse engineering неочевидной документации Минэкономразвития, обход неполноценного WSDL, аттестация АРМ силами лицензиатов ФСТЭК+ФСБ и работа с реестровой аккредитацией. Запустили в проде 30 августа 2024 — за полтора года до того, как Минэкономразвития фактически прекратило развитие системы.

Контекст

Туроператоры обязаны передавать каждую сформированную путёвку в ГИС ЭП — с изменением статуса (аннуляция, возврат) в режиме реального времени. Без аттестованного АРМ с 1 ноября 2024 — автоматическое отключение от системы, что на практике означает потерю реестровой аккредитации и блокировку продаж туров.

Клиент — крупный речной круизный оператор с десятками тысяч туристических путёвок в сезон. Состояние стека до проекта: legacy-система формировала пакеты данных частично, но не доставляла их надёжно в ГИС; квитанции не парсились; статусы путёвок (создана / аннулирована / возвращена) не синхронизировались. Каждый случай аннуляции тура требовал ручного вмешательства в личный кабинет гос-системы — до 1–2 часов в день на одного менеджера в пик сезона.

Дополнительный риск: реестровая аккредитация туроператора в Минэкономразвития — живой статус, который может быть приостановлен. Отправлять путёвки имеет право только аккредитованный оператор; ни одна интеграция не должна этот факт игнорировать.

Какие вызовы решены

Как обойти неполноценный SOAP WSDL? Auto-gen TypeScript-клиента из WSDL не работал — часть типов и операций описана только в PDF-регламенте v4.1 и комментариях к WSDL, а не в самом WSDL-файле. Это стало неожиданностью: стандартный workflow wsdl → codegen → готовый клиент здесь не применим. Решение: кастомный слой над npm-пакетом soap + ручные TS-типы по XSD-схемам + эмпирический разбор реальных ответов prod-сервиса на prod.eisep.ru.

Как разобраться в запутанной документации Минэкономразвития? Регламент v4.1 (2025) рассыпан между PDF-приложениями, XSD-схемами, отдельными примерами на порталах ev.economy.gov.ru и eisep.ru. Без систематизации — несколько месяцев разбора с повторными прохождениями по одним и тем же вопросам. Решение: построили внутренний markdown-справочник в репо с реверс-инжинирингом полей, кодов ошибок и edge-case’ов реальных ответов системы. Онбординг нового разработчика сократился с недели до одного дня.

Как пройти аттестацию АРМ туроператора? Подключение к ГИС ЭП требует аттестованного автоматизированного рабочего места согласно требованиям Оператора системы. Аттестацию проводят лицензиаты ФСТЭК (на ТЗКИ — техническую защиту конфиденциальной информации) и ФСБ (на криптосредства). Без аттестата с 1 ноября 2024 — автоматическое отключение от системы. Подобрали лицензиата, провели аттестацию, привели АРМ в соответствие требованиям, получили аттестат.

Как использовать квалифицированную УКЭП? ГИС ЭП принимает только сертификаты от аккредитованных Минцифрой удостоверяющих центров. Подпись XML-сообщений выполняется по стандарту XAdES-T — с прикреплённой временной меткой, что гарантирует доказуемость момента подписания. КриптоПро CSP используется совместно со стеком ЕГИС ОТБ (см. связанный кейс), однако сертификаты УКЭП для двух систем строго раздельные.

Как работать с реестровой аккредитацией туроператора? Перед каждой отправкой путёвки — проверка актуального статуса аккредитации туроператора в реестре Минэкономразвития. Если аккредитация приостановлена — отправка блокируется автоматически, менеджер получает alert в Telegram. Кэш состояния реестра: 24 часа с принудительным обновлением при возникновении ошибки валидации.

Как обрабатывать НСИ (нормативно-справочную информацию)? ГИС ЭП предоставляет отдельный SOAP-сервис для нормативных справочников: страны, виды документов, типы туристических услуг, классификаторы. Синхронизация — раз в сутки плюс on-demand при первом обращении. Справочники хранятся локально в Postgres, что исключает зависимость основного пайплайна передачи путёвок от доступности вспомогательных сервисов ГИС.

Как синхронизировать статусы при аннуляции и возврате? Outbox-pattern: любое изменение статуса путёвки в Supabase создаёт запись в таблице gis_ep_outbox, которую worker обрабатывает с retry/backoff. При ошибке — переход в DLQ с alert. Особенность регламента v4.1: аннуляция и возврат — два разных типа событий, каждый со своим идемпотентным ключом. Объединять их в один тип событий — ошибка, которую не видно в тестовом контуре, но которая приводит к штрафу на prod.

Подход

1. Reverse engineering регламента v4.1 + WSDL/XSD + примеров на ev.economy.gov.ru → внутренний markdown-справочник в репо как единый источник правды по полям, кодам ошибок и поведению системы
2. Аттестация АРМ с привлечением лицензиата ФСТЭК+ФСБ — обязательное предусловие для получения доступа к prod-контуру ГИС ЭП; проведена до начала технической интеграции
3. Кастомный SOAP 1.1 клиент на базе npm soap + ручные TS-типы (auto-gen из WSDL не справился — часть контракта описана только в PDF-регламенте)
4. XAdES-T подпись через КриптоПро CSP с квалифицированными УКЭП от аккредитованных Минцифрой УЦ
5. Outbox-pattern: Supabase + worker + retry/backoff + DLQ для надёжной отправки в оба endpoint-а (EPInputWS / EPMessageExchangeWS) с гарантией доставки и идемпотентности
6. Кэширование НСИ-справочников локально в Postgres + ежесуточная синхронизация, on-demand при first-use
7. Разделение ответственности с ЕГИС ОТБ — два независимых пайплайна, общий только Supabase Vault для хранения криптосредств; разные сертификаты УКЭП для каждой системы

Результат

• Запуск в проде 30.08.2024 — за полтора года до фактической остановки развития системы Минэкономразвития
• 100% синхронизация жизненного цикла путёвок: создание, аннуляция, возврат
• Внутренний markdown-справочник сократил онбординг нового разработчика с недели до одного дня
• Аттестат АРМ туроператора получен и поддерживается в актуальном состоянии

Эффект для бизнеса

• Сохранена реестровая аккредитация туроператора — с 01.11.2024 без аттестованного АРМ происходит автоматическое отключение от ГИС ЭП, что равнозначно блокировке продаж туров
• Предотвращены штрафы за непередачу путёвок (до 200 тыс ₽ за каждую) и за несинхронизацию статусов при аннуляциях и возвратах
• Автоматизация убрала ручной труд — до внедрения менеджер тратил 1–2 часа в день на ручное обновление статусов путёвок через личный кабинет гос-системы
• Запас прочности — даже после того, как Минэкономразвития фактически прекратило развитие ГИС ЭП, наша интеграция продолжает работать в maintenance-режиме без необходимости постоянных доработок; система стабильна

Что использовали

SOAP 1.1 по регламенту взаимодействия ГИС ЭП v4.1 Минэкономразвития (2025), WSDL+XSD-схемы с патчами на стороне клиента, кастомный TypeScript SOAP-клиент на npm soap с ручными типами, XAdES-T подпись через КриптоПро CSP с квалифицированными УКЭП, аттестация АРМ силами лицензиата ФСТЭК+ФСБ, Supabase Edge Functions + outbox-pattern (retry/backoff/DLQ), Postgres-кэш НСИ-справочников, Supabase Vault для хранения криптосредств и сертификатов.

Что мы можем сделать у вас

Если вашему туроператору нужна интеграция с ГИС ЭП — мы прошли reverse engineering регламента v4.1 и аттестацию АРМ силами ФСТЭК+ФСБ, можем интегрировать вас за 4–8 недель. Учитывая контекст 2026 (Минэкономразвития прекратило развитие системы), новые подключения становятся сложнее — support и обновления платформы отсутствуют, но рабочая интеграция по-прежнему нужна для соответствия требованиям закона. Оптимальный момент — сейчас, пока система работает в штатном режиме. Написать нам