Методы ЕСЛИ

Кейсы

Интеграционный сценарий: ЛИС ↔ ЦИСЗ

Получение образца материала

Цель: получить образец биоматериала по идентификатору в контекте организации.

FHIR-запрос:

GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&identifier={identifier}

Получение информации о направлении

Цель: получить направление в контексте организации.

FHIR-запрос:

GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}

Обновление статуса направления (принято)

Цель: обновить статус направления на “принято” (draft), что означает, что направление получено лабораторией. Обновление статуса направления доступно в контексте организации.

FHIR-операция:

POST [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status

Подробнее: Операция изменения статуса ресурса ServiceRequest.

Обновление статуса направления (в работе)

Цель: обновить статус направления на “в работе” (on-hold), что означает, что направление находится в процессе выполнения. Обновление статуса направления доступно в контексте организации.

FHIR-операция:

POST [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status

Подробнее: Операция изменения статуса ресурса ServiceRequest.

Примечание:

• compartmentType — тип контекста (Organization);
• compartmentResourceId — идентификатор контекста;
• {id} — идентификатор направления.

Отправка результатов исследований

Цель: передать результаты исследований в ЦИСЗ.

FHIR-метод:

POST [FHIR_BASE]/Bundle/$import

Тело запроса: Bundle profile = MedicationDocument с ресурсами ObservationLabTest/ObservationLabMicroorganism, DiagnosticReportLab, DocumentReference

Интеграционный сценарий МИС ↔ ЦИСЗ

Сопоставление полей ServiceRequest

Цель: корректно заполнить направление на лабораторное исследование.

Подробнее: Сопоставление полей направления на лабораторное исследование ServiceRequest.

Сопоставление полей Specimen

Цель: корректно заполнить образец биоматериала для лабораторного исследования.

Подробнее: Сопоставление полей образца биоматериала для лабораторного исследования Specimen.

Получение идентификатора образца материала для лабораторного исследования

Цель: получить идентификатор образца материала для лабораторного исследования, который должен быть передан в ЦИСЗ.

FHIR-операция:

POST [FHIR_BASE]/$get-specimen-id/[count=n]

Подробнее: Операция получения идентификатора образца материала для лабораторного исследования.

Передача сформированного пакета медицинских данных

Цель: выполнить импорт направления и/или образца на лабораторное исследование.

FHIR-метод:

POST [FHIR_BASE]/Bundle/$import

Тело запроса: Bundle profile = MedicationDocument с ресурсами ServiceRequestLab, SpecimenLab

Получение результатов Observation и DiagnosticReport

Цель: получить результаты исследований, выполненных в лаборатории.

Получение Observation:

GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&based-on=ServiceRequest/{id}

Получение DiagnosticReport:

GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/DiagnosticReport?_profile=https://fhir.by/StructureDefinition/DiagnosticReportLab&based-on=ServiceRequest/{Id}

Примечание:

• compartmentType — тип контекста (Patient или Organization);
• compartmentResourceId — идентификатор контекста;
• {id} — идентификатор направления.

Диаграмма последовательности

Диаграмма взаимодействия МИС ↔ ЦИСЗ

sequenceDiagram

  autonumber
  actor doc as Лечащий врач
  actor nurse as Процедурная сестра
  participant mis as МИС
  participant fhir as ЦИСЗ
  
  %% doc ->> mis: Дай мне информацию о пациенте
  %% mis ->> fhir: GET [FHIR BASE]/Patient?name=[полное_ФИО]&birthdate=[дата_рождения]
  %% fhir -->> mis: 200 OK/Bundle/[Patient]
  %% mis -->> doc: Представление информации о пациенте
  doc ->> doc: Осмотр пациента
  doc ->> mis: Покажи мне форму направления на лабораторное исследование
  mis ->> mis: Создание формы направления
Note right of mis: identifier
status
intent
subject
encounter
authordeOn
requester
  mis -->> doc: Представление формы направления на лабораторное исследование

alt Забор биоматериала будет выполняться в том же УЗ
  doc ->> mis: Заполняет форму
Note right of doc: priority
code
orderDetail
accurence
reason
note
  %% nurse ->> mis: Дай мне информацию о пациенте
  %% mis ->> fhir: GET [FHIR BASE]/Patient?name=[полное_ФИО]&birthdate=[дата_рождения]
  %% fhir -->> mis: 200 OK/Bundle/[Patient]
  %% mis -->> nurse: Представление информации о пациенте
  nurse ->> mis: Покажи мне направление на лабораторное исследование пациента
  mis -->> nurse: Представляет предзаполненную форму направления, сохраненного в МИС
  nurse ->> mis: Добавляет информацию о лаборатории, в которую будет направлен материал
Note right of nurse: performer
location  
  nurse ->> nurse: Забор биоматериала
  nurse ->> mis: Покажи мне форму образца метериала для лабораторного исследования

  mis->>mis: Проверка наличия невыданных идентификаторов в БД
alt Идентификаторы отсутствуют
    mis->>fhir: POST [FHIR BASE]/$get-specimen-id/[count=n]
    fhir->>fhir: Create identifiers
    fhir-->>mis: 200 OK/[Parameters]
    mis->>mis: Сохранение идентификаторов в БД
    else Идентификаторы найдены
    
Note right of mis: Нет необходимости обращения в ЦИСЗ 
за получением новых идентификаторов
end
mis->>mis: Извлечение невыданного идентификатора из БД

  mis -->> nurse: Форма образца материала для лабораторного исследования с предзаполненным выданным идентификатором
  nurse ->> mis: Заполняет форму "Образец метериала для лабораторного исследования"
  nurse ->> mis: Отправляет сведения в ЦИСЗ и распечатывает штрихкод
  mis ->> mis: Create ServiceRequestLab
  mis ->> mis: Create SpecimenLab
  mis ->> fhir: POST [FHIR_BASE]/Bundle/$import [MedicationDocument + ServiceRequestLab + SpecimenLab]
  fhir ->> fhir: Проверка контрольной суммы идентификатора
  fhir ->> fhir: Проверка уникальности идентификатора
  fhir -->> mis: 200 OK/Bundle status 'Successed'
  mis -->> nurse: Печать штрихкода
  nurse ->> nurse: Наклеивает штрихкод на пробирку
else Забор биоматериала и исследование будут выполняться в другом УЗ
  doc ->> mis: Заполняет форму
Note right of doc: performer
location
priority
code
orderDetail
accurence
reason
note
  doc ->> mis: Отправляет в ЦИСЗ
  mis ->> mis: Create ServiceRequestLab
  mis ->> fhir: POST [FHIR_BASE]/Bundle/$import [MedicationDocument + ServiceRequestLab]
  fhir -->> mis: 200 OK/Bundle status 'Successed'
  nurse ->> mis: Покажи мне направление на лабораторное исследование пациента
  mis ->> fhir: GET [FHIR BASE]/Patient/[patietnId]/ServiceRequest?{search-params}
  fhir -->> mis: 200 OK/Bundle/[ServiceRequestLab]
  mis -->> nurse: Представляет направление на исследование пациента
  nurse ->> nurse: Забор биоматериала
  nurse ->> mis: Покажи мне форму образца материала для лабораторного исследования
  mis->>mis: Проверка наличия невыданных идентификаторов в БД
alt Идентификаторы отсутствуют
    mis->>fhir: POST [FHIR BASE]/$get-specimen-id/[count=n]
    fhir->>fhir: Create identifiers
    fhir-->>mis: 200 OK/[Parameters]
    mis->>mis: Сохранение идентификаторов в БД
    else Идентификаторы найдены
    
Note right of mis: Нет необходимости обращения в ЦИСЗ 
за получением новых идентификаторов
end
mis->>mis: Извлечение невыданного идентификатора из БД
  mis -->> nurse: Форма образца материала для лабораторного исследования с предзаполненным выданным идентификатором
  nurse ->> mis: Заполняет форму "Образец метериала для лабораторного исследования"
  nurse ->> mis: Отправляет сведения в ЦИСЗ и распечатывает штрихкод
  mis ->> mis: Create SpecimenLab
  mis ->> fhir: POST [FHIR_BASE]/Bundle/$import [MedicationDocument + SpecimenLab]
  fhir ->> fhir: Проверка контрольной суммы идентификатора
  fhir ->> fhir: Проверка уникальности идентификатора
  fhir -->> mis: 200 OK/Bundle status 'Successed'
  mis -->> nurse: Печать штрихкода
  nurse ->> nurse: Наклеивает штрихкод на пробирку
  end

Описание процесса создания направления и образца для лабораторного исследования.

1. Медицинский работник осматривает пациента и принимает решение о назначении лабораторных исследований.
2. Медицинский работник запрашивает в МИС форму для формирования направления на лабораторное исследование.
3. МИС формирует форму направления, при этом автоматически заполняются следующие элементы:
   • identifier;
   • status;
   • intent;
   • subject;
   • encounter;
   • authoredOn;
   • requester.
4. МИС представляет форму направления медицинскому работнику.
5. Если забор биологического материала будет проводиться в том же УЗ, медицинский работник вносит в форму направления значения следующих элементов:
   • priority;
   • code;
   • orderDetail;
   • occurrence;
   • reason;
   • note.
6. В процедурном кабинете медицинская сестра запрашивает в МИС направление на лабораторное исследование пациента.
7. МИС представляет предзаполненную и сохраненную форму направления.
8. Процедурная медицинская сестра добавляет в форму направления сведения о лаборатории, в которую будет направлен материал.
9. Процедурная медицинская сестра выполняет забор биологического материала.
10. Процедурная медицинская сестра запрашивает в МИС форму образца материала для лабораторного исследования.
11. МИС выполняет проверку в своей  БД: существуют ли невыданные идентификаторы для образцов лабораторных исследований.
12. В случае, если идентификаторы отсутствуют - МИС отправляет запрос в ЦИСЗ на получение идентификаторов для образцов биологического материала.
13. ЦИСЗ генерирует новые уникальные идентификаторы для образцов биологического материала.
14. МИС получает массив идентификаторов.
15. МИС сохраняет полученный массив идентификаторов в своей БД.
16. В случае, если идентификаторы найдены - МИС извлекает невыданный идентификатор из БД.
17. МИС представляет форму образца материала с уже предзаполненным значением идентификатора.
18. Процедурная медицинская сестра заполняет форму.
19. Процедурная медицинская сестра проверяет внесенные данные и оправляет сведения в ЦИСЗ.
20. МИС формирует ресурс ServiceRequestLab.
21. МИС формирует ресурс SpecimenLab.
22. Импорт пакета медицинских данных в ЦИСЗ.
23. Проверка контрольной суммы идентификатора.
24. Проверка уникальности идентификатора.
25. Получение статуса успешного импорта.
26. Печать штрихкода.
27. Процедурная медицинская сестра наклеивает штрихкод на пробирку с биологическим материалом.
28. Если забор биологического материала и исследование будут проводиться в другом УЗ, медицинский работник вносит значения следующих элементов:
    • performer;
    • location;
    • priority;
    • code;
    • orderDetail;
    • accurence;
    • reason;
    • note.
29. Медицинский работник проверяет внесенные данные и отправляет сведения в ЦИСЗ.
30. МИС формирует ресурс ServiceRequestLab.
31. Импорт пакета медицинских данных в ЦИСЗ.
32. Получение статуса успешного импорта.
33. Процедурная медицинская сестра запрашивает в МИС направление на лабораторное исследование пациента.
34. МИС отправляет запрос в ЦИСЗ на получение направления.
35. Получение направления.
36. МИС представляет направление процедурной сестре.
37. Процедурная медицинская сестра выполняет забор биологического материала.
38. Процедурная медицинская сестра запрашивает в МИС форму образца материала для лабораторного исследования.
39. МИС выполняет проверку в своей  БД: существуют ли невыданные идентификаторы для образцов лабораторных исследований.
40. В случае, если идентификаторы отсутствуют - МИС отправляет запрос в ЦИСЗ на получение идентификаторов для образцов биологического материала.
41. ЦИСЗ генерирует новые уникальные идентификаторы для образцов биологического материала.
42. МИС получает массив идентификаторов.
43. МИС сохраняет полученный массив идентификаторов в своей БД.
44. В случае, если идентификаторы найдены - МИС извлекает невыданный идентификатор из БД.
45. МИС представляет форму образца материала с уже предзаполненным значением идентификатора.
46. Процедурная медицинская сестра заполняет форму.
47. Процедурная медицинская сестра проверяет внесенные данные и оправляет сведения в ЦИСЗ.
48. МИС формирует ресурс SpecimenLab.
49. Импорт пакета медицинских данных в ЦИСЗ.
50. Проверка контрольной суммы идентификатора.
51. Проверка уникальности идентификатора.
52. Получение статуса успешного импорта.
53. Печать штрихкода.
54. Процедурная медицинская сестра наклеивает шрихкод на пробирку с биологическим материалом.

Диаграмма взаимодействия ЛИС ↔ ЦИСЗ

sequenceDiagram
  autonumber
  participant lis as ЛИС
  participant fhir as ЦИСЗ
  Note over lis,fhir: Приём, сортировка, регистрация образцов
  lis ->> lis: Сканирует штрихкод на пробирке
  lis ->> fhir: GET [FHIR_BASE]/Organization/[organization-id]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&identifier={identifier}
  fhir -->> lis: 200 OK/total=n/[SpecimenLab]
  lis ->> fhir: GET [FHIR_BASE]/Organization/[organization-id]/ServiceRequest/[serviceRequest-id]
  fhir -->> lis: 200 OK/total=n/[ServiceRequestLab]
Note right of lis: Получено ЛИС  
  lis ->> lis: ServiceRequestLab.status -> 'draft'
  Note over lis,fhir:  Выполнение исследования, валидация результатов 
  lis ->> lis: Сканирует штрихкод на пробирке
  lis ->> fhir: GET [FHIR_BASE]/Organization/[organization-id]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&identifier={identifier}
  fhir -->> lis: 200 OK/total=n/[SpecimenLab]
  lis ->> fhir: GET [FHIR_BASE]/Organization/[organization-id]/ServiceRequest/[serviceRequest-id]
  fhir -->> lis: 200 OK/total=n/[ServiceRequestLab]
Note right of lis: В работе
  lis ->> lis: ServiceRequestLab.status -> 'on-hold'
  lis ->> lis: Create ObservationLabTest, ObservationLabMicroorganism
  lis ->> lis: Create DiagnosticReportLab
  lis ->> fhir: POST [FHIR_BASE]/Bundle/$import [MedicationDocument + ObservationLabTest/ObservationLabMicroorganism + DiagnosticReportLab]
  fhir ->> fhir: ServiveRequestLab.status -> 'completed'
  fhir ->> fhir: SpecimenLab.status -> 'unavailable'
  fhir -->> lis: 200 OK/Bundle status -> 'Successed'

Описание процесса получения ЛИС сведений о биологическом материале и формировании сведений о результатах лабораторных исследований.

1. Сотрудник лаборатории в сортировочном отделе сканирует штрихкод, размещенный на пробирке с биологическим материалом.
2. Запрос на получение в контексте организации ресурса SpecimenLab по уникальному идентификатору биологического материала.
3. Получение ресурса SpecimenLab.
4. Запрос на получение ресурса ServiceRequestLab по id.
5. Получение ресурса ServiceRequestLab.
6. Материал получен, статус ресурса ServiceRequestLab изменен на ‘draft’.
7. Сотрудник лаборатории в отделе проведения исследований  сканирует штрихкод, размещенный на пробирке с биологическим материалом.
8. Запрос на получение в контексте организации ресурса SpecimenLab по уникальному идентификатору биологического материала.
9. Получение ресурса SpecimenLab.
10. Запрос на получение ресурса ServiceRequestLab по id.
11. Получение ресурса ServiceRequestLab.
12. Материал взят в работу, статус ресурса ServiceRequestLab изменен на ‘on-hold’.
13. После проведения исследования формируются ресурсы ObservationLabTest, ObservationLabMicroorganism.
14. И DiagnosticReportLab.
15. Импорт пакета медицинских данных в ЦИСЗ.
16. Изменение статусов ресурсов ServiceRequestLab.
17. Изменение статусов ресурсов SpesimenLab.
18. Получение статуса успешного импорта медицинской информации.

Примеры в формате JSON

Операция получения идентификатора образца материала для лабораторного исследования

Метод: POST 
URL: [FHIR_BASE]/$get-specimen-id/[count=n]  
Авторизация: Bearer <access_token>

Описание: Операция предназначена для получения идентификатора образца материала для лабораторного исследования, который должен быть передан в ЦИСЗ.

Тело запроса передаётся в виде ресурса Parameters. Входные данные:

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

{
"resourceType": "Parameters",
    "parameter": [
        {
            "name": "count",
            "valuePositiveInt": 10
        }
    ]
    }

Тело ответа передаётся в виде ресурса Parameters. Выходные данные:

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

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "identifier",
            "valueString": "000000000001219"
        },
        {
            "name": "identifier",
            "valueString": "000000000002322"
        },
        {
            "name": "identifier",
            "valueString": "000000000003157"
        },
        {
            "name": "identifier",
            "valueString": "000000000004931"
        },
        {
            "name": "identifier",
            "valueString": "000000000005172"
        },
        {
            "name": "identifier",
            "valueString": "000000000006909"
        },
        {
            "name": "identifier",
            "valueString": "000000000007090"
        },
        {
            "name": "identifier",
            "valueString": "000000000008722"
        },
        {
            "name": "identifier",
            "valueString": "000000000009805"
        },
        {
            "name": "identifier",
            "valueString": "000000000010901"
        }
    ]
    }

Операция изменения статуса ресурса ServiceRequest

Метод: POST  
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status  
Авторизация: Bearer <access_token>  

Описание: Операция позволяет изменить статус ресурса ServiceRequestLab. Может выполняться в контексте организации. Только организация в которой создали направление или организация назначенная исполнителем в направлении имеет право изменять статус ресурса.

Допустимые переходы статусов

Для направляющей организации:

Для организации-лаборатории:

Входные параметры:

Body:

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "status",
      "valueCode": "[status_code]"
    }
  ]
}

Выходные данные:

Результат выполнения:

• В случае успешного выполнения операции система возвращает ресурс ServiceRequestLab с информацией об успешном выполнении изменения статуса направления HTTP-code 200 OK.
• В случае ошибки возвращается ресурс OperationOutcome с информацией об ошибке.

Пример успешного выполнения изменения статуса:

{
"resourceType": "OperationOutcome",
"issue": [
  {
    "severity": "success",
    "code": "success",
    "details": {
      "text": "Статус ресурса {ServiceRequset_Id} успешно изменен на {status_code}" 
      }
    }
  ]
}

Пример изменения статуса с информацией об ошибке:

{
"resourceType": "OperationOutcome", 
"issue": [
  {
    "severity": "error",
    "code": "not-found", 
    "details": {
      "text": "Ресурс {ServiceRequset_Id} не найден." 
        },
        "diagnostics": "Ресурс {ServiceRequset_Id} не найден."
        }
    ]
}

Операция отмены ресурса ServiceRequest

Метод: POST  
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status  
Авторизация: Bearer <access_token>  

Описание: Операция предназначена для отмены ресурса ServiceRequestLab путём перевода его в статус entered-in-error. Схема выполнения операции аналогична Операции изменения статуса ресурса ServiceRequest, описанной выше. Отличие состоит в том, что при переводе ресурса в статус entered-in-error в тело запроса обязательно передаётся дополнительный параметр declineReason, указывающий причину отмены.

Body:

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "status",
      "valueCode": "entered-in-error"
    },
    {  
      "name": "declineReason",  
      "valueCode": "3"  
    }  
  ]
}

Пример изменения статуса с информацией об ошибке:

{
"resourceType": "OperationOutcome", 
"issue": [
  {
    "severity": "error",
    "code": "invalid", 
    "details": {
      "text": "При установки статуса 'entered-in-error', должен быть указан единственный name = 'declineReason'."
            },
            "diagnostics": "При обработке запроса произошла ошибка на стороне МИС."
        }
    ]
}

Операция изменения статуса ресурса Specimen

Метод: POST 
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Specimen/{id}/$set-status  
Авторизация: Bearer <access_token>  

Описание: Операция позволяет изменить статус ресурса Specimen. Операция может выполняться в контектсе организации или пациента. Только организация, в которой создали направление или организация, назначенная исполнителем в направлении, имеет право изменять статус ресурса.

Входные параметры:

Body:

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "status",
      "valueCode": "unsatisfactory"
    }
  ]
}

Результат выполнения:

• В случае успешного выполнения операции система возвращает ресурс SpecimenLab с информацией об успешном выполнении изменения статуса образца биоматериала HTTP code 200 OK.
• В случае ошибки возвращается ресурс OperationOutcome с информацией об ошибке.

Пример изменения статуса с информацией об ошибке:

{
"resourceType": "OperationOutcome", 
"issue": [
  {
    "severity": "error",
    "code": "invalid", 
    "details": {
      "text": "Неизвестное значение valueCode = 'satisfactory'."
            },
            "diagnostics": "При обработке запроса произошла ошибка на стороне МИС."
        }
    ]
}

Сопоставление полей направления на лабораторное исследование ServiceRequest

Сопоставление полей образца биоматериала для лабораторного исследования Specimen

Логические проверки