В статье рассматривается настройка типа действия в медицинской информационной системе (МИС) для автоматического формирования структурированного электронного медицинского документа (СЭМД) — обратного талона санаторно-курортной карты (взрослый и детский варианты). Материал предназначен для специалистов по настройке МИС, медицинских информатиков и администраторов, отвечающих за интеграцию с РЭМД и санаторно-курортными организациями.
1. Общие сведения
Обратный талон санаторно-курортной карты заполняется в санаторно-курортной организации (СКО) по окончании лечения и передаётся в медицинскую организацию, выдавшую направление. Документ содержит сведения о проведённом лечении, эпикриз, результаты лечения, рекомендации, а также информацию о контактах с инфекционными больными. Для детей до 17 лет предусмотрен отдельный шаблон с указанием законного представителя.
Разработка структуры CDA выполнена в соответствии с требованиями нормативной базы. Документ имеет две редакции: для взрослых и для детей. Идентификаторы руководств по реализации (templateId) различаются.
2. Настройка идентификатора документа
Как и для других CDA, первым шагом настраивается свойство «Идентификатор документа». Для автоматической генерации уникального номера документа используется счётчик.
- Перейдите в раздел «Настройки → Счётчики».
- Добавьте новый счётчик с кодом
CDA_ID(пример настройки приведён на Рисунке 3 в оригинале). - В типе действия для свойства «Идентификатор документа» укажите созданный счётчик (Рисунок 2).
Это обеспечит автоматическое присвоение номера каждому обратному талону.
3. Секции CDA и их привязка к свойствам
Обратный талон включает несколько секций, данные для которых формируются на основании свойств типа действия. Для соотнесения используется параметр «Секция CDA».
Таблица секций (обязательные и необязательные)
| Название секции | Код секции CDA | Обязательность | Тип | Примечание |
|---|---|---|---|---|
| Контакт с пациентами, больными инфекционными заболеваниями | INF | 0 | Boolean | |
| Проведено лечение | TREATMENT | 1 | String/Text/Constructor | |
| Эпикриз | EPIC | 1 | String/Text/Constructor | |
| Результаты лечения | RESULT | 1 | Справочник | Заполняется по справочнику 1.2.643.5.1.13.13.99.2.921 (значения: «значительное улучшение», «улучшение», «без перемен», «ухудшение») |
| Наличие обострений, потребовавших отмену процедур | AGGRAV | 0 | Boolean | |
| Рекомендации по дальнейшему лечению | RECOM | 1 | String/Text/Constructor |
Важно: Для свойства RESULT необходимо настроить выбор из выпадающего списка в соответствии со значениями федерального справочника.
4. Основные атрибуты типа действия
Для корректной идентификации документа в системе и его классификации в РЭМД необходимо задать:
| Параметр | Значение |
|---|---|
| Код для отчётов | OtherDocuments |
| Идентификатор для справочника «Классификатор электронных медицинских документов. Формат Cda» | Указывается в соответствии с настройками идентификации (Рисунок 5) |
5. Различие между взрослым и детским вариантами
Система автоматически определяет возраст пациента. Для детей до 17 лет включительно используется детский вариант обратного талона.
| Параметр | Взрослый вариант | Детский вариант (до 17 лет) |
|---|---|---|
| templateId | 1.2.643.5.1.13.13.14.357.9.1 | 1.2.643.5.1.13.13.14.361.9.1 |
| Код документа (code) | 357 | 361 |
| Заголовок (title) | «Обратный талон санаторно-курортной карты» | «Обратный талон санаторно-курортной карты для детей» |
| Сведения о законном представителе | Отсутствуют | Добавляются (СНИЛС, документ, родственная связь) |
Для детского варианта в шаблоне реализована логика выбора представителя из списка родственников/опекунов с последующей подстановкой его данных и кода родственной связи (мать, отец, родственник, уполномоченное лицо).
6. Настройка справочников и внешних систем
Для успешного формирования CDA и его выгрузки в РЭМД необходимо проверить и настроить следующие элементы.
6.1. Справочник «Организации»
У текущей медицинской организации (санаторно-курортной организации) должна быть настроена идентификация по справочнику с кодом MDR308 (Рисунок 6).
6.2. Идентификация типа действия
Тип действия, связанный с CDA, должен иметь идентификацию по справочнику МИС с кодом n3.medDocumentType.Cda (Рисунок 7).
6.3. Справочник «Должности»
У исполнителя документа (лечащего врача, заполняющего талон) должна быть настроена идентификация по справочнику «Должности работников организаций здравоохранения» с OID 1.2.643.5.1.13.13.11.1002. Версия справочника: 7.6.
6.4. Справочник «Типы документов» (ДУЛ пациента)
Для документа, удостоверяющего личность пациента (и представителя — для детей), необходима двойная идентификация:
- OID
1.2.643.5.1.13.13.99.2.48— идентификатор типа документа; - OID
1.2.643.5.1.13.13.99.2.48*— наименование типа документа.
Версия справочника: 7.1.
7. Проверки заполнения обязательных полей
В шаблон печати (HTML) или бизнес-процесс следует включить проверки, аналогичные приведённым в исходном файле RETURN_TICKET_SANATOR.html. Основные контролируемые параметры:
| Проверка | Условие ошибки |
|---|---|
| СНИЛС пациента | Не заполнен |
| СНИЛС исполнителя (лечащего врача) | Не заполнен |
| Идентификация должности исполнителя | Отсутствует OID 1.2.643.5.1.13.13.11.1002 |
| Состояние документа | Не «Закончено» |
| Основной предварительный диагноз (направившей МО) | Не указан или указано более одного |
| Заключительный/основной диагноз (при выписке) | Не указан или указано более одного |
Обязательные свойства (TREATMENT, EPIC, RESULT, RECOM) | Не заполнены или содержат только пробелы |
При обнаружении ошибки пользователь увидит диалоговое окно с перечнем проблем, формирование документа прерывается.
8. Формирование регионального идентификатора пациента
Для успешной выгрузки CDA в РЭМД необходимо обеспечить наличие регионального идентификатора пациента (MPI). В шаблоне RETURN_TICKET_SANATOR.html присутствует вызов:
{: from library.Utils import forceString}
{: clientGlobalIdNetrika = readUrl("http://"+forceString(dbServerName)+"/extendedmse/api?fromtemplate=1&clientid="+forceString(client.id), timeout=50)}Этот код получает глобальный идентификатор пациента через сервис extendedmse. Убедитесь, что:
- ревизия ИЭМК не ниже требуемой;
- в глобальных настройках присутствует запись
ExtendedMseUrl; - настроен доступ к MPI и параметры
gDefaultMpiUrl,gMpiToken.
Для пациентов Санкт-Петербурга (код региона 78) идентификатор формируется по правилу {OID_MDR308[26:]}.17.1.{client.id}, для остальных — через вызов сервиса.
9. Особенности работы с детским вариантом
При формировании обратного талона для ребёнка (возраст до 17 лет) система должна:
- Определить возраст пациента (функция
isChild(client)). - Вывести диалог выбора законного представителя из списка родственников/опекунов (если их несколько).
- Для выбранного представителя подставить:
- СНИЛС (если есть);
- данные документа, удостоверяющего личность;
- код родственной связи (
FAMILY_TIES_CODE) и наименование (FAMILY_TIES_NAME) в соответствии со справочником OID1.2.643.5.1.13.13.99.2.14.
- В XML-документе заполнить секцию
<guardian>.
Внимание: Если представитель не выбран или отсутствуют необходимые данные, формирование документа должно быть заблокировано (рекомендуется добавить соответствующую проверку).
10. Практические рекомендации
- Перед настройкой убедитесь, что в МИС актуальны версии справочников: должности — 7.6, типы документов — 7.1, результаты лечения — последняя версия.
- Обязательно настройте счётчик
CDA_ID— без него номер документа не будет генерироваться. - Проверьте у текущей организации наличие OGRN, ОКПО, ОКАТО — эти данные используются в XML.
- Для детского варианта протестируйте сценарии с разным количеством представителей (один, несколько, ни одного) и убедитесь, что диалог выбора работает корректно.
- Настройте лицензионные данные организации (номер лицензии, кем выдана, дата) — они также подставляются в XML.
Настройка типа действия для CDA «Обратный талон санаторно-курортной карты (Редакция 1)» требует внимания к деталям: правильной привязки секций, настройки счётчика идентификатора, указания кода для отчётов и идентификации типа действия. Особое значение имеет разделение на взрослый и детский варианты — для детей необходимо реализовать выбор законного представителя и заполнение соответствующих полей. Выполнение всех описанных шагов гарантирует, что сформированный CDA будет соответствовать требованиям РЭМД и сможет быть передан из санаторно-курортной организации в направившую медицинскую организацию.