Как мы внедряли CDA-документ «Заключение о поствакцинальном осложнении» (Редакция 2): опыт и полный технический разбор

Привет, коллеги! На связи команда внедрения медицинских информационных систем. Сегодня — пошаговое руководство по СЭМД «Заключение об установлении факта поствакцинального осложнения» (Редакция 2). Если ваша МИС отправляет данные в РЭМД, этот документ обязателен. Разбираем все требования, OID и «подводные камни».

1. Зачем нужен этот СЭМД и кому он обязателен?

Согласно Приказу Минздрава РФ № 972н («О порядке выдачи справок и заключений»), каждое поствакцинальное осложнение (ПВО) должно фиксироваться в машиночитаемом виде. Документ создаётся на третьем уровне HL7 CDA Release 2 (полностью структурированное тело).

📌 Важно: шаблон — закрытый. Нельзя добавлять элементы и секции, не описанные в спецификации.
🔑 OID шаблона: 1.2.643.5.1.13.13.15.64.2 (берётся из справочника руководств по реализации).

Целевая аудитория: разработчики МИС, интеграторы, специалисты по обмену с РЭМД.

2. Ключевые изменения Редакции 2 → Редакции 1 (быстрое сравнение)

Что изменилось	Подробности
Код типа документа	Теперь два варианта + обязательный `<translation>` по OID `1.2.643.5.1.13.13.99.2.1079`
Справочник осложнений	Вместо старого «Поствакцинальные осложнения» → «Осложнения лечения онкологических заболеваний» (OID `1.2.643.5.1.13.13.11.1485`)
Структурное подразделение	В `providerOrganization` добавлен `<identity:Dept>` (наименование отделения)
Срок действия полиса	Уточнены правила для `identity:high` — допускается `nullFlavor="NAV"` для старого образца/временного свидетельства
Связанные документы	В секции `LINKDOCS` можно ссылаться на другие СЭМД (OID `1.2.643.5.1.13.13.99.2.1079`)
Человекочитаемая часть	Убраны обязательные `<title>` и `<text>` внутри секций (только машинная обработка)

3. Заголовок CDA-документа: что обязательно заполнить (уровень 1)

Ниже — минимальный обязательный набор элементов заголовка. Пропуск любого приведёт к отклонению документа в РЭМД.

3.1. Корневой элемент и пространства имён

<ClinicalDocument xmlns="urn:h17-org:v3"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:identity="urn:h17-ru:identity"
  xmlns:address="urn:h17-ru:address"
  xmlns:fias="urn:h17-ru:fias">

3.2. Обязательные элементы (краткий чек-лист)

Элемент	Значение / правило	OID / пример
`<realmCode>`	`code="RU"`	—
`<typeId>`	`root="2.16.840.1.113883.1.3"` `extension="POCD_MT000040"`	—
`<templateId>`	`root="1.2.643.5.1.13.13.15.64.2"`	справочник 1.2.643.5.1.13.13.99.2.638
`<id>`	`root` = `OID_мед_орг.100.НомерМИС.НомерЭкзМИС.51` `extension` = уникальный ID документа в МИС	пример: `1.2.643.5.1.13.13.12.2.70.7232.100.1.1.51`
`<code>`	Вид мед.документа + `<translation>`	см. ниже
`<title>`	строго: «Заключение об установлении факта поствакцинального осложнения»	—
`<effectiveTime>`	дата создания (можно `nullFlavor`)	`value="202501151430+0300"`
`<confidentialityCode>`	из справочника 1.2.643.5.1.13.13.99.2.285 (обычно `N`)	`code="N"`
`<languageCode>`	`code="ru-RU"`	—
`<setId>`	`root` = `...50`, `extension` = идентификатор набора версий	—
`<versionNumber>`	`value="1"` (или 2,3…)	—

3.3. Как правильно указать `<code>` с переводом (пример)

<code code="232" 
      codeSystem="1.2.643.5.1.13.13.11.1520" 
      codeSystemVersion="12.13" 
      codeSystemName="Электронные медицинские документы" 
      displayName="Заключение об установлении факта поствакцинального осложнения (CDA) Редакция 2">
  <translation code="64" 
               codeSystem="1.2.643.5.1.13.13.99.2.1079" 
               codeSystemName="Виды структурированных электронных медицинских документов" 
               displayName="Заключение об установлении факта поствакцинального осложнения" 
               codeSystemVersion="1.18"/>
</code>

4. Участники документа (recordTarget, author, legalAuthenticator)

4.1. Пациент (`<recordTarget>`)

СНИЛС — обязателен (root="1.2.643.100.3").
Паспортные данные (identity:IdentityDoc) — серия, номер, кем выдан, код подразделения, дата выдачи.
Полис ОМС (identity:InsurancePolicy) — тип полиса (справочник 1.2.643.5.1.13.13.11.1035), номер.
Адрес — два элемента <addr> (постоянной регистрации и фактический). Каждый адрес обязан содержать:
текстовую строку streetAddressLine
код субъекта РФ (справочник 1.2.643.5.1.13.13.99.2.206)
почтовый индекс
GUID ФИАС (fias:AOGUID + fias:HOUSEGUID)

⚠️ Без ФИАС-идентификаторов документ не пройдёт валидацию. Если адрес неизвестен — используйте nullFlavor="NI".

4.2. Автор документа (`<author>`)

time → только nullFlavor="NI"
Уникальный ID автора в МИС (root = ...70)
СНИЛС автора — обязателен
Должность (справочник 1.2.643.5.1.13.13.11.1002)

4.3. Лицо, придавшее юридическую силу (`<legalAuthenticator>`)

time и signatureCode → только nullFlavor="NI"
Должность и СНИЛС — обязательны

5. Тело документа: секции DOCINFO и LINKDOCS (уровни 2 и 3 CDA)

Тело CDA-документа содержит структурированное наполнение для машинной обработки. Используются только две секции (обязательная и опциональная).

5.1. Секция «Сведения о документе» (DOCINFO) — обязательная

Каждый блок информации оформляется отдельным <entry>.

№	Поле	Код (`<code>`)	Тип данных / справочник	Обязательность
1	Номер документа	`11003`	`ST` (простая строка)	0..1
2	Введение иммунобиологического препарата	тип препарата: OID `1.2.643.5.1.13.13.99.2.848` дата введения код препарата: OID `1.2.643.5.1.13.13.11.1078`	`<substanceAdministration>`	0..*
3	Поствакцинальное осложнение	`8014`	`CD` со справочником `1.2.643.5.1.13.13.11.1485`	1..*
4	Заключение	`837`	фиксированный `code="44"` из справочника `1.2.643.5.1.13.13.99.2.725`	1..1
5	Комментарий	`10000`	`ST`	0..1

📌 Пример заполнения осложнения (если кода нет)

<value xsi:type="CD" nullFlavor="OTH">
  <originalText>Атипичная реакция на БЦЖ</originalText>
</value>

5.2. Секция «Связанные документы» (LINKDOCS) — опциональная

Служит для привязки документа-основания (например, протокола врачебной комиссии).

Обязательные элементы внутри <act>:

<code> — вид документа (справочник СЭМД или видов мед.документации)
<effectiveTime> — дата формирования документа
<reference> — ссылка на внешний документ с идентификаторами:
в МИС (root по правилу ...51)
в РЭМД (root="1.2.643.5.1.13.13.17.1.1", формат extension: XX.XX.XXX.XXXXXXXXX или XXX.XX.XX.XX.XXXXXXXXX)

Опционально: серия, номер, кем выдан, форма документа (бумажная/электронная).

6. Работа с nullFlavor: когда и как использовать

В Редакции 2 чётко разделено:

«ОБЯЗАН» → nullFlavor запрещён, значение должно быть.
«ДОЛЖЕН» → nullFlavor разрешён, но нужно указать причину из справочника 1.2.643.5.1.13.13.99.2.286.

Самые частые коды nullFlavor для ПВО:

Код	Расшифровка
`NI`	Нет информации
`NAV`	Временно недоступно
`ASKU`	Запрошено, но неизвестно
`NASK`	Не запрашивалось
`OTH`	Другое (требуется `originalText`)

7. Справочники (реестры НСИ) — актуальные OID

Все справочники должны использоваться в последней версии (если не указано иное).

Справочник	OID	Для чего используется
Должности мед.работников	`1.2.643.5.1.13.13.11.1002`	автор, legalAuthenticator, performer
Виды полиса ОМС	`1.2.643.5.1.13.13.11.1035`	полис пациента, источник оплаты
Источники оплаты	`1.2.643.5.1.13.13.11.1039`	participant `@typeCode="IND"`
Пол пациента	`1.2.643.5.1.13.13.11.1040`	административный пол
Иммунобиологические препараты	`1.2.643.5.1.13.13.11.1078`	consumable
Реестр мед.организаций	`1.2.643.5.1.13.13.11.1461`	providerOrganization, custodian
Осложнения лечения (!!)	`1.2.643.5.1.13.13.11.1485`	поствакцинальное осложнение
Тип адреса пациента	`1.2.643.5.1.13.13.11.1504`	addr/@use
Электронные мед.документы	`1.2.643.5.1.13.13.11.1520`	code
Виды мед.документации	`1.2.643.5.1.13.13.11.1522`	code, связанные документы
Субъекты РФ	`1.2.643.5.1.13.13.99.2.206`	address:stateCode
NullFlavor	`1.2.643.5.1.13.13.99.2.286`	причины отсутствия данных
Роли сотрудников при подписании	`1.2.643.5.1.13.13.99.2.368`	functionCode в performer
Виды СЭМД	`1.2.643.5.1.13.13.99.2.1079`	translation, связанные документы

8. FAQ по внедрению (самые частые ошибки)

❓ Вопрос 1: Почему мой документ не проходит валидацию по ФИАС?

Ответ: Проверьте, что каждый адрес содержит оба элемента: fias:AOGUID (идентификатор улицы/населённого пункта) и fias:HOUSEGUID (идентификатор дома). Без HOUSEGUID — ошибка.

❓ Вопрос 2: Можно ли указать несколько поствакцинальных осложнений в одном документе?

Ответ: Да, секция DOCINFO допускает 1..* элементов entry с code="8014". Каждое осложнение — в отдельном <entry>.

❓ Вопрос 3: Что делать, если в справочнике 1.2.643.5.1.13.13.11.1485 нет нужного осложнения?

Ответ: Используйте nullFlavor="OTH" и обязательно добавьте <originalText> с текстовым описанием.

❓ Вопрос 4: Обязательно ли указывать СНИЛС для автора и пациента?

Ответ: Да, и для автора, и для пациента СНИЛС — обязателен (если пациент — гражданин РФ). Исключение — только при наличии nullFlavor с обоснованием.

❓ Вопрос 5: Как версионировать исправленный документ?

Ответ: Создайте новый <id> (новый extension), оставьте тот же <setId>, увеличьте <versionNumber> на 1. Это стандарт CDA R2.

9. Заключение: что нужно сделать прямо сейчас

Обновить МИС — добавить поддержку справочника осложнений 1.2.643.5.1.13.13.11.1485.
Реализовать формирование ФИАС-GUID для адресов пациента и организации.
Проверить генерацию translation в элементе <code>.
Настроить версионность (setId / versionNumber).
Скачать актуальный пакет спецификации (XSD, Schematron, пример XML) с портала Минздрава или из реестра НСИ.

📢 Важно: шаблон закрытый, поэтому любые «левые» элементы приведут к неприятию документа РЭМД. Строго следуйте таблицам и OID из руководства.

На этом всё. Внедряйте, тестируйте, пишите в комментариях — помогу разобраться с конкретными кейсами.

Автор: практикующий архитектор МИС, эксперт по CDA R2 и интеграции с РЭМД. Специально для adminmed.ru.

🔗 Полезные ссылки (по теме):

Приказ Минздрава РФ № 972н
Реестр НСИ: https://nsi.rosminzdrav.ru
HL7 CDA Release 2.0 Specification
ФИАС: https://fias.nalog.ru