EventLog API

Подготовка к работе и авторизация

Сервис Eventlog разработан для предоставления доступа к результатам выгрузки случаев обслуживания пациентов и возможности поставить в очередь на перевыгрузку отдельных документов. Сервис позволяет отобразить  количество случаев, которое находится в каждой из очередей по СЭМД и РЭМД. 

Отдельные очереди есть для:

    1. РЭМД: ОДЛИ, ОДИИ, Телемедицина, ИЭМК, ОНКО, АКИНЕО, ССЗ
    2. СЭМД: ОДЛИ, ИЭМК, Cda-gen

Eventlog авторизация производится в n3manager через заголовок Authorization: N3 <token>. Так же существует разграничение прав доступа в разрезе ЛПУ и МИС, с помощью которого отображаются только те ЭМД, которые соответствуют привязанному IdLpu (одно или несколько): 

При информационном взаимодействии используются следующие обязательные параметры:

  1. GUID – авторизационный токен. Выдается разработчику МИС администратором Интеграционной платформы;

  2. IdLPU – идентификатор МО. Используется значение поля code регионального справочника МО (urn:oid:1.2.643.2.69.1.1.1.64).

Авторизация через заголовок Authorization: N3 <token>

Описание API Eventlog: http://b2b-demo.n3health.ru/n3h-eventlog-api/swagger/index.html

Что бы авторизоваться жмём кнопку «Authorize» и указываем авторизационные данные в следующем формате: N3 <token>.
После авторизации появляется возможность посмотреть все методы, выполнить запросы, и посмотреть на результаты.

Параметр 
Фильтр
Описание
header: «OID ЛПУ»  filterField: «Organization»  
header: «Идентификатор в МИС/ЛИС»  filterField: «IdCaseMis»  
header: «Идентификатор в рег. шине»  filterField: «IdCase»  
header: «Идентификатор документа в рег. шине»   filterField: «IdSource»  
header: «Источник» filterField: «IdDataSource»  
header: «ЛПУ»   filterField: «IdLpu»  
header: «МИС»  filterField: «SystemOid»  
header: «Сообщение» filterField: «Message»  
header: «Статус» filterField: «Status»

1 — Первичная валидация ЭМД пройдена успешно
2 — Ошибка при формировании ЭМД
3 — Ошибка первичной валидации ЭМД
4 — ЭМД успешно принят сервисом ЕГИСЗ
5 — Вторичная валидация ЭМД не пройдена 
6 — ЭМД успешно сформирован
7 — В федеральном сервисе РЭМД зарегистрирован связанный документ
8 — ЭМД получен от РЭМД
header: «Тип ЭМД»   filterField: «EmdTypeId»  
header: remd «Идентификатор запроса к РЭМД» : «Идентификатор запроса к СЭМД» filterField: «IdFedRequest»  
header: remd «Номер ЭМД в РЭМД» : «Номер ЭМД в CЭМД»  filterField: «RemdRegNumber»  

 

 
 
 
Поле
Тип данных
Функция
Кратность 
Описание
DateBegin public DateTime   get; set;  [0..1] Дата начала периода выборки
DateEnd public DateTime get; set; [0..1] Дата окончания периода выборки
IdCaseMis  public string get; set; [1] Идентификатор случая обслуживания в МИС направляющей МО
IdCase public integer get; set; [1] Идентификатор СМО в БД ИЭМК
IdSource public string get; set; [1] Идентификатор документа в рег. шине
Organization public string get; set; [1]

Идентификатор МО. Значение поля «Code» из справочника с OID 1.2.643.2.69.1.1.1.64
IdFedRequest public string get; set; [1] Идентификатор запроса к РЭМД
RemdRegNumber public string get; set; [1] Номер ЭМД в РЭМД
IdDataSource public integer get; set; [1] Источник
Organization public string get; set; [1] Идентификатор медицинской организации из справочника медицинских организаций сервиса терминологии. Соответствует колонке organization таблицы lpu
SystemOid  public string get; set; [1] SystemOid
IdLpu  public string get; set; [1] IdLpu — отправителя СМО
EmdTypeId  public integer get; set; [1] Тип ЭМД
Status  public integer get; set; [1] Статус выгрузки ЭМД
Message  public string get; set; [1] Результат выгрузки ЭМД
GlobalFilter  public string get; set; [1]  
StartRow  public integer get; set; [1] Пропустить первые N записей (pagination)
EndRow  public integer get; set; [1] Ограничить результат N-ой записью (pagination)
extendedFilters      

Расширенные фильтры:

type: «empty», «notEmpty», «startsWith», «contains», «notContains», «endsWith», «equals», «notEquals».

value: значение для фильтра

column: поле по которому

В параметры запроса добавлены расширенные фильтры:

{
  "dateBegin": "2022-10-10",
  "dateEnd": "2022-10-10",
  "idCaseMis": "string",
  "idDocumentMis": "string",
  "idCase": 0,
  "idSource": "string",
  "organization": "string",
  "idFedRequest": "string",
  "remdRegNumber": "string",
  "idDataSource": [
    0
  ],
  "systemOid": [
    "string"
  ],
  "idLpu": [
    "string"
  ],
  "emdTypeId": [
    0
  ],
  "status": [
    0
  ],
  "message": "string",
  "globalFilter": "string",
  "startRow": 0,
  "endRow": 0,


  "extendedFilters": [
    {
      "type": "string",
      "value": "string",
      "column": "string"
    }
  ],


  "sortBy": [
    {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ]
}

Допустимые значения параметра type: «empty», «notEmpty», «startsWith», «contains», «notContains», «endsWith», «equals», «notEquals».
Использование расширенных фильтров может быть не оптимально с точки зрения производительности. Т.е. не рекомендуется создавать большую нагрузку с использованием расширенных фильтров.

Дата передается в формате ISO 8601
[1] — Обязательный реквизит, только один экземпляр
[0..1] — Необязательный реквизит, максимальное количество экземпляров 1

 

Описание методов

EventLog  — Информация о выгрузках РЭМД

Наименование метода Описание
/EventLog/GetEvents Получить данные по выгрузкам по фильтру
/EventLog/GetEventsCount Получить кол-во событий по фильтру
/EventLog/GetErrorReport Получить сводные данные по наиболее частым ошибкам
/EventLog/GetConsolidatedErrorReport Получить сводный отчет по количеству выгруженных документов по статусам
/EventLog/ExportToXls Сохранить данные по выгрузкам в xlsx файл
/EventLog/ExportToXlsConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в xlsx файл
/EventLog/ExportToCsv Сохранить данные по выгрузкам в csv файл
/EventLog/ExportToCsvConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в csv файл
/EventLog/ReloadCase Перевыгрузка случая обслуживания
/EventLog/ReloadAll Перевыгрузка случаев обслуживания

EventLogSemd  -Информация о выгрузках СЭМД

Наименование метода Описание
/EventLogSemd/GetEvents Получить данные по выгрузкам по фильтру
/EventLogSemd/GetEventsCount Получить кол-во событий по фильтру
/EventLogSemd/GetErrorReport Получить сводные данные по наиболее частым ошибкам
/EventLogSemd/GetConsolidatedErrorReport Получить сводный отчет по количеству выгруженных документов по статусам
/EventLogSemd/ExportToXls Сохранить данные по выгрузкам в xlsx файл
/EventLogSemd/ExportToXlsConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в xlsx файл
/EventLogSemd/ExportToCsv Сохранить данные по выгрузкам в csv файл
/EventLogSemd/ExportToCsvConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в csv файл
/EventLogSemd/ReloadCase Перевыгрузка случая обслуживания
/EventLogSemd/ReloadAll Перевыгрузка случаев обслуживания

SmsAkineo — Информация о выгрузках ВИМИС АКИНЕО

Наименование метода Описание
/SmsAkineo/GetEvents Получить данные по выгрузкам по фильтру
/SmsAkineo/GetEventsCount Получить кол-во событий по фильтру
/SmsAkineo/GetErrorReport Получить сводные данные по наиболее частым ошибкам
/SmsAkineo/GetConsolidatedErrorReport Получить сводный отчет по количеству выгруженных документов по статусам
/SmsAkineo/ExportToXls Сохранить данные по выгрузкам в xlsx файл
/SmsAkineo/ExportToXlsConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в xlsx файл
/SmsAkineo/ExportToCsv Сохранить данные по выгрузкам в csv файл
/SmsAkineo/ExportToCsvConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в csv файл
/SmsAkineo/ReloadCase Перевыгрузка случая обслуживания
/SmsAkineo/ReloadAll Перевыгрузка случаев обслуживания

SmsOnko — Информация о выгрузках ВИМИС ОНКО

Наименование метода Описание
/SmsOnko/GetEvents Получить данные по выгрузкам по фильтру
/SmsOnko/GetEventsCount Получить кол-во событий по фильтру
/SmsOnko/GetErrorReport Получить сводные данные по наиболее частым ошибкам
/SmsOnko/GetConsolidatedErrorReport Получить сводный отчет по количеству выгруженных документов по статусам
/SmsOnko/ExportToXls Сохранить данные по выгрузкам в xlsx файл
/SmsOnko/ExportToXlsConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в xlsx файл
/SmsOnko/ExportToCsv Сохранить данные по выгрузкам в csv файл
/SmsOnko/ExportToCsvConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в csv файл
/SmsOnko/ReloadCase Перевыгрузка случая обслуживания
/SmsOnko/ReloadAll Перевыгрузка случаев обслуживания

SmsSsz — Информация о выгрузках ВИМИС ССЗ

Наименование метода Описание
/SmsSsz/GetEvents Получить данные по выгрузкам по фильтру
/SmsSsz/GetEventsCount Получить кол-во событий по фильтру
/SmsSsz/GetErrorReport Получить сводные данные по наиболее частым ошибкам
/SmsSsz/GetConsolidatedErrorReport Получить сводный отчет по количеству выгруженных документов по статусам
/SmsSsz/ExportToXls Сохранить данные по выгрузкам в xlsx файл
/SmsSsz/ExportToXlsConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в xlsx файл
/SmsSsz/ExportToCsv Сохранить данные по выгрузкам в csv файл
/SmsSsz/ExportToCsvConsolidatedReport Сохранить сводный отчет по количеству выгруженных документов в csv файл
/SmsSsz/ReloadCase Перевыгрузка случая обслуживания
/SmsSsz/ReloadAll Перевыгрузка случаев обслуживания

 

NSI

/Nsi/GetUserRights Принадлежность к МИС или ЛПУ
/Nsi/Lpu Список МО
/Nsi/System Список информационных систем
/Nsi/Status Статусы результатов выгрузки
/Nsi/DataSource Список сервисов
/Nsi/EmdTypesRemd Типы документов РЭМД
/Nsi/EmdTypesSemd Типы документов СЭМД
/Nsi/SmsTypes Типы документов ВИМИС (СМС)
/Nsi/SmsStatus Статусы выгрузки в ВИМИС
/Nsi/SmsVTypes Версии типов СМС
/Nsi/LegalNames Список МО со справочника 1.2.643.2.69.1.1.1.64