Общая информация

Обучающее видео "ВИМИС. Отправка документов"

Отправка документа

Что значит "успешная отправка"?

Документ считается успешно отправленном, если федеральный сервис принял документ и вернул колбек со статусом 4.

Отправили документ в ИЕМКа, но в в Eventlog документ не появился. Почему?

Следует проверить следующие моменты:

• в кейсе был передан ClinicMainDiagnosis c MkbCode соответствующий справочникам
  • 1.2.643.2.69.1.1.1.165 "ВИМИС АКиНЕО. Диагнозы МКБ-10"
  • 1.2.643.2.69.1.1.1.167 "ВИМИС ОНКО. Диагнозы МКБ-10"
  • 1.2.643.2.69.1.1.1.168 "ВИМИС ССЗ. Диагнозы МКБ-10 "
  • 1.2.643.2.69.1.1.1.229 "ВИМИС Профилактическая медицина. Диагнозы МКБ-10"
• в документе IdMedDocumentType соответствует справочнику 1.2.643.2.69.1.1.1.195 "Виды электронных медицинских документов"
• если в документе присутствует вложение Attachment c типом text/xml
• у пациента не завершен Контроль ВИМИС

Как понять по справочнику 1.2.643.2.69.1.1.1.195 какой документ нам следует выгружать?

В данном справочнике для ВИМИС есть 2 ключевых поля "vimis_code" и "Версия типа документа"

• vimis_code должен быть заполнен номером смс, которую необходимо выгрузить.
  • По федеральному регламенту "Протокол информационного взаимодействия", данное поле соответствует полю "Тип СЭМД beta-версии (тег «docType» в теле SOAP пакета)"
• "Версия типа документа" должна соответствовать версии отправляемого документа
  • По федеральному регламенту "Протокол информационного взаимодействия", данное поле соответствует полю "Версия типа СЭМД beta-версии (тег «docTypeVersion» в теле SOAP пакета)"

Контроль ВИМИС

В какой момент проставляется контроль ВИМИС?

Контроль ВИМИС проставляется при любой отправке документа в сервис ВИМИС.

Для нозологии АКиНЕО важно, чтобы даты открытия / закрытия случая (OpenDate и CloseDate) были текущим годом.

В какой момент снимается контроль ВИМИС?

Контроль ВИМИС для нозологии АКиНЕО снимается по истечении 365 дней со дня простановки контроля.

Для всех нозологий контроль снимается в случае успешной отправки документа "Медицинское свидетельство о смерти" на пациента, либо Медицинское свидетельство о пренатальной смерти.

Ошибки FLK (статус 5)

Ошибка "FLK-003 Не удалось выполнить проверку идентификаторов структурных подразделений"?

Ошибка возникает из-за отсутствия в справочнике НСИ - "ФРМО. Справочник структурных подразделений" структурного подразделения. Следует проверить было ли передано структурное подразделение, а не отделение. Для добавления значений в справочник "ФРМО.

Ошибка "FLK-005 Не удалось выполнить проверку медицинских работников "?

Ошибка возникает из-за отсутствия медицинских работников в ФРМР.

Ошибка "FLK-005 Не удалось выполнить проверку медицинских работников. PostCode: 58 Должность отсутствует в списке должностей мед. работника на указанную в СЭМД"?

Ошибка возникает, так как в ФРМР отсутствует передаваемая должность у оказанного мед.работника. Следует откорректировать должности у мед.работника или указать корректную дату отправки.

Ошибки сборки (статус 2)

Ошибка "Object reference not set to an instance of an object."?

Ошибка возникает из-за отсутствия обязательного витального параметра. Просьба написать в ОТРС о такой ошибке, так как мы стараемся все ошибки сделать читабельными для пользователя.

Ошибка вида "The JSON value could not be converted to System.Nullable`1[System.Int32]. Path: $[0].Type | LineNumber: 1 | BytePositionInLine: 53."?

Ошибка возникает из-за некорректно переданного значения в json. Необходимо обратиться к ОИП и удостоверится, что данные переданы в соответствии с необходимым типом.

Ошибка "Value cannot be null. (Parameter 'source')"?

Ошибка возникает из-за того, что не удалось считать данные из витального параметра. Необходимо проверить верно ли указан тип витального параметра

Ошибка вида "JsonToken EndArray is not valid for closing JsonType Object. Path '[0]', line 1, position 176."

Проверьте json на наличие закрывающейся скобки } или ]

В данном разделе описаны методы взаимодействия с региональной МИС посредством REST (Postman) для МИС

Авторизация в сервисе и адрес сервиса

Адрес сервиса - Адрес Модуля приема документов от МИС (Cda-gen)

Пример:

В зависимости от типа запроса, в адресную строку запроса добавляется эндпоинт:

• IsControl - для получения статуса "Контроль ВИМИС"
• clinrecList - для получения списка клинических рекомендаций
• clinrec/id - для получения клинической рекомендации
• ompList - для получения списка ОМП
• omp/id - для получения ОМП
• KAS - для получения идентификатора КАС
• checkstatus - для получения статуса выгрузки ВИМИС в региональную ВИМИС;

Авторизация осуществляется посредством передачи авторизационного ключа, значение которого соответствует значению авторизационного ключа Сервиса ИЭМК. Ключ выдается администратором интеграционной платформы. Авторизационные данные  указывается в заголовке REST-сообщения в следующем формате:

Пример передачи Авторизационного ключа

Получение статуса "Контроль ВИМИС"

Данный метод предназначен для получения статуса "Контроль ВИМИС" по пациенту. Статус "Контроль ВИМИС" устанавливается пациенту, если данные по его СМО были успешно переданы в федеральный сервис ВИМИС. В настоящее время поддерживается передача данных в ВИМИС "АкиНео", "Онкология", "ССЗ", "Профилактическая медицина". Статус "Контроль ВИМИС" можно получить как по всем ВИМИС одновременно, так и только в разрезе выбранной нозологии, например, "ССЗ".

Метод реализуется контроллером Vimis, входящего в состав компонента CDA Generator сервиса Региональная ИЭМКа.

Метод

Запрос на проверку осуществляется с помощью метода POST, в качестве адреса указывается URL в формате [base]/api/Vimis/$IsControl

Параметры вызова

Для получения статуса "Контроль ВИМИС" необходимо отправить запрос со следующими параметрами:

Описание параметров тела запроса

Описание параметров тела ответа

Пример запроса

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "idPerson",
            "valueString": "aa58b7ae-362f-4f4b-aeeb-f550806382b1, f4bd6b85-1400-4375-ba79-08854f2acf5b"
        }
    ]
}

Пример ответа

[{
  "idPerson": "f4bd6b85-1400-4375-ba79-08854f2acf5b",
  "startDate": "2018-07-17T21:00:00.000Z",
  "idRecipientSystem": 2,
  "Description": "Онкология",
  "confirmed": false
},
{
  "idPerson": "aa58b7ae-362f-4f4b-aeeb-f550806382b1",
  "startDate": "2018-07-17T21:00:00.000Z",
  "idRecipientSystem": 1,
  "Description": "Акинео"
  "confirmed": false
}]

Метод работает следующим образом:

1. Получение массива карт пациента.
2. Проверка принадлежность всех карт к 1 пациенту.
   1. В случае отсутствия карт в системе, вернется статус 400 "Отсутствуют данные о пациенте".
   2. В случае отсутствия данных по пациенту, вернется статус 200 "По указанным параметрам ничего не найдено"
3. Отбор записей в БД по заданным параметрам.

Примечание. Соответствие кода и названия ВИМИС (idRecipientSystem):

1. АкиНео
2. Онкология
3. ССЗ
4. Профилактическая медицина

Получение клинических рекомендаций

Ниже приведен пример добавления случая медицинского обслуживания методом AddCase с необходимыми витальными параметрами для дальнейшего формирования СМС 5 АКиНЕО

Клинические рекомендации хранятся в сервисе «Региональная ИЭМК» и передаются в МИС МО по запросу к компоненту REST API CDA Generator. Ниже указзаны методы, использующиеся в запросе.

Метод clinrecList

Запрос на получение списка клинических рекомендаций осуществляется с помощью метода GET, в качестве адреса указывается URL в формате [base]/api/Vimis/clinrecList

Параметры вызова

Для получения получения списка клинических рекомендаций используется метод ClinrecList без указания дополнительных параметров.

Описание параметров тела ответа

Пример ответа

[
 {
  "id": 366,
  "name": "Клинические рекомендации "Хроническая сердечная недостаточность"",
  "mkb10": "I50.9,I50.1,I50.0",
  "age_group": "0",
  "revision_id": 604,
  "revision_begin_date": "2020-01-01",
  "revision_end_date": "null"
  }
]

В ответе возрващется массив рекомендаций с уникальным идентификатором id.

Метод clinrec

Запрос на получение клинических рекомендаций осуществляется с помощью метода GET, в качестве адреса указывается URL в формате [base]/api/Vimis/clinrec/id

Параметры вызова

Для получения структурированной информации по документу клинических рекомендаций используется метод clinrec с идентификатором документа клинических рекомендаций id.

• id – идентификатор документа клинических рекомендаций, полученный в методе clinrecList 

Пример ответа

[{
  "clinrec": "декодированное сообщение в base64"
}]

В ответе возвращаются сообщение, зашифрованное в Base64, содержащее клинические рекомендации.

Метод ompList

Запрос на получение списка документов порядков ОМП осуществляется с помощью метода GET, в качестве адреса указывается URL в формате [base]/api/Vimis/ompList

Параметры вызова

Для получения списка документов порядков ОМП используется метод ompList без указания дополнительных параметров.

Описание параметров тела ответа

Пример ответа

[{
  "id": 393,
   "name": "Приказ Министерства здравоохранения Российской Федерации от 20 октября 2020 г. N 1130н "Об утверждении Порядка оказания медицинской помощи по профилю "акушерство и гинекология",   
   "profile" : "2",   
   "revision_id" : 604,   
   "revision_begin_date" : "2020-01-01",   
   "revision_end_date" : "null"   
}]

В ответе возвращается массив порядков ОМП с уникальным идентификатором id.

Метод omp

Запрос на получение структурированной информации порядка ОМП осуществляется с помощью метода GET, в качестве адреса указывается URL в формате [base]/api/Vimis/omp/id

Параметры вызова

Для получения структурированной информации по порядку ОМП используется метод omp с идентификатором порядка ОМП id.

• id – идентификатор документа клинических рекомендаций, полученный в методе ompList 

Пример ответа

[{
  "clinrec": "декодированное сообщение в base64"
}]

В ответе возвращается сообщение, зашифрованное в Base64, содержащее порядок OMP.

Получение КАС для смс 22 "Извещение о критическом акушерском состоянии"

Критическое акушерское состояние – заболевания, синдромы и симптомы, требующие проведения мероприятий по реанимации и интенсивной терапии женщин в период беременности и в течение 42 дней после ее окончания.

Метод

Для получения идентификатора КАС необходимо выполнить POST запрос в cdagen. В качестве адреса указывается URL в формате [base]/api/Vimis/KAS

Описание параметров тела запроса

Описание параметров тела ответа

Параметры вызова

{
  "mo_oid": "1.2.643.5.1.13.13.12.2.23.104004",
  "year": 2022,
  "region": "23"
}

Пример ответа

{
    "data": {
        "number": "22-23-00659"
    },
    "is_success": true,
    "errors": []
}

Метод получения статуса документа

Данный метод предназначен для получения статусов документов из региональной ВИМИС.

Метод реализуется контроллером Vimis, входящего в состав компонента CDA Generator сервиса Региональная ИЭМКа.

ВАЖНО!

Метод работает только с одним набором параметров. Следует передавать msg_id или связку IdDocumentMis + IdLpu(это идентификатор МО) + IdMedDocumentType. Если будут переданы все параметры, то поиск будет осуществляться по msg_id.

Метод

Запрос предоставление номера осуществляется с помощью метода POST, в качестве адреса указывается URL в формате [base]/api/Vimis/checkstatus

Описание параметров тела запроса

Описание параметров тела ответа

Пример тела запроса

{ "MsgId": ["01636143-600e-42ac-927c-6cda4f45dd39"] }

ИЛИ

{
    "IdMedDocumentType": 159,
    "Organization": "e87fb003-9c57-4637-99e2-0e0accb9d229",
    "IdDocumentMis": "2536_1417602",
    "Take": "all"
} 

Пример ответа

[{    
"RegisterDate":"2023-01-11 14:12:12.878 +0300",
"CallbackDeliveryDate":"2023-01-11 14:12:20.539 +0300",
"IdMedDocumentType":"159",
"IdCondition":"5"  ,
"condition": "Прием (осмотр) врача-специалиста",
"IdDocumentMis": "2536_1417602",
"RecipientSystem": "ССЗ",
"Status": "4",
"description": "Запись в базу данных выполнена успешно"
}] 

Коллекция Postman

В данной коллекции содержатся все методы, описанные выше

	Файл	Изменено
	Файл N3Med for public.postman_collection.json	17.01.2023 by Кристина Селедкова
	Метки Нет меток Редактировать метки Preview Свойства Удалить

Перетащите для загрузки или обзор файлов

Загрузить файл

Описание файла