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

Руководство к использованию стандарта FHIR в ЦИСЗ
0.1.1660 - ci-build

Руководство к использованию стандарта FHIR в ЦИСЗ - Local Development build (v0.1.1660) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Метод предназначен для проверки пакета медицинских данных без его непосредственного импорта (сохранения) в ЦИСЗ.

Этот метод можно использовать во время проектирования и разработки для проверки ресурсов на соответствие профилям.

Этот метод возвращает 200 ОК при условии, что было возможно выполнить проверку, независимо от того, были ли обнаружены проблемы с проверкой. Однако возможно, что определенные ошибки в контенте (например, неверный набор символов, неверный JSON и т. д.) могут привести к сбою всей операции проверки с ответом серии 4xx или 5xx.

Метод проверяет входящий пакет медицинских данных на соответствие профилю пакета медицинских данных.

Вызов метода осуществляется с помощью HTTP POST команды:

POST [base]/fhir/Bundle/$validate

Входящие параметры метода:

Название	Профиль	Описание
bundle	пакет медицинских данных	Пакет медицинских данных, сформированный локальной или облачной медицинской информационной системой

Исходящие параметры метода:

Название	Профиль	Описание
result	documents	В случае успешной проверки пакета медицинских данных возвращается тип данных OperationOutcome со статусом success. В случае возникновения ошибки при проведении проверки пакета медицинских данных возвращается тип данных OperationOutcome со статусом error с детализацией ошибок по результатам пройденной проверки.

ЦИСЗ может принимать Bundle соответствующий профилю MedicationDocument и только типа document

Входящий профиль ресурса Bundle типа document представляет собой набор медицинских данных о пациенте, включая сведения о медицинском наблюдении за пациентом и услугах, предоставленных пациенту (данные о медицинских осмотрах пациента, проведенных исследованиях и лечении пациента, а также рекомендациях, выданных пациенту).

Входящий ресурс Bundle типа document должен содержать:

• Composition в качестве первого ресурса;

• ресурсы, на которые ссылается Composition (должны содержать сведения о пациенте, состоянии здоровья пациента и виде оказанной медицинской помощи пациенту, в том числе сведения о медицинском работнике и организации, ответственных за подготовку, утверждение и хранение документа);

• вспомогательные ресурсы, которые представляют дополнительные сведения о документе, и ссылки на них;

• идентификатор документа с системой или значением;

• дату создания документа (информацию о том, когда документ был создан в локальной или облачной медицинской информационной системе);

• дату составления документа (информацию о том, когда медицинский работник составил документ в локальной или облачной медицинской информационной системе).

Более подробно о ресурсе Bundle типа document можно ознакомиться по следующей ссылке - documents.

Пример запроса на проверку пакета медицинских данных без его непосредственного сохранения.

{
  "resourceType": "Bundle",
  "meta": {
    "profile": [
      "https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument"
    ]
  },
  "identifier": {
    "system": "urn:ietf:rfc:3986",
    "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0"
  },
  "timestamp": "2013-05-28T22:12:21Z",
  "type": "document",
  "entry": [
    {
      "fullUrl": "Composition/1",
      "resource": {
        "resourceType": "Composition",
        "meta": {
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/clinicaldocument"
          ]
        },

        "status": "final",
        "type": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "28655-9"
            }
          ],
          "text": "Discharge Summary from Responsible Clinician"
        },
        "subject": [
          {
            "reference": "Patient/b218cee9-019d-47a4-b161-e97c0fd6f736",
            "display": "Eve Everywoman"
          }
        ],
        "author": [
          {
            "reference": "Practitioner/36a6e15b-7345-42ae-8a59-7a35059ebb47",
            "display": "Doctor Dave"
          }
        ],
        "date": "2013-02-01T12:30:02Z",

        "title": "Discharge Summary"
      }
    },
    {
      "fullUrl": "Patient/b218cee9-019d-47a4-b161-e97c0fd6f736",
      "resource": {
        "resourceType": "Patient",
        "id": "AnonymousPatient01",
        "meta": {
          "profile": [
            "https://fhir.by/StructureDefinition/AnonymousPatientBy"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "system": "http://fhir.by/CodeSystem/DocNumbersBySystem",
                  "code": "ANO"
                }
              ]
            },
            "value": "331121990999000",
            "period": {
              "start": "2024-12-31"
            },
            "assigner": {
              "reference": "Organization/ecc51621-0af3-3b35-ac3e-8b1e34022e92"
            }
          }
        ],
        "active": true,
        "name": [
          {
            "use": "anonymous",
            "family": "Иванов",
            "given": [
              "Петр",
              "Сидорович"
            ]
          }
        ],
        "telecom": [
          {
            "system": "phone",
            "value": "89001234567"
          }
        ],
        "birthDate": "1990-12-31",
        "deceasedBoolean": false
      }
    },
    {
      "fullUrl": "Practitioner/36a6e15b-7345-42ae-8a59-7a35059ebb47",
      "resource": {
        "resourceType": "Practitioner",
        "meta": {
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Practitioner"
          ]
        },
        "name": [
          {
            "family": "Иванов",
            "given": [ "Иван" ]
          }
        ]
      }
    },
    {
            "fullUrl": "Organization/ecc51621-0af3-3b35-ac3e-8b1e34022e92",
            "resource": {
                "resourceType": "Organization",
                "active": true,
                "name": "SAINT ANNE'S HOSPITAL"
            }
        }
  ]
}

Пример ответа в случае успешной проверки пакета медицинских данных.

{
    "resourceType": "OperationOutcome",
    "id": "cb97a66a-c6a5-4445-8cde-09f4d97d3950",
    "meta": {
        "lastUpdated": "2024-05-10T09:20:30.9466591+00:00"
    },
    "issue": [
        {
            "severity": "success",
            "code": "informational"
        }
    ]
}

Пример ответа в случае возникновения ошибки при проведении проверки пакета медицинских данных.

{
    "resourceType": "OperationOutcome",
    "id": "cb97a66a-c6a5-4445-8cde-09f4d97d3950",
    "meta": {
        "lastUpdated": "2024-05-10T09:20:30.9466591+00:00"
    },
    "issue": [
        {
            "severity": "error",
            "code": "invariant",
            "details": {
                "coding": [
                    {
                        "system": "http://hl7.org/fhir/dotnet-api-operation-outcome",
                        "code": "1012"
                    },
                    {
                        "system": "http://fire.ly/dotnet-sdk-operation-outcome-structdef-reference",
                        "code": "Bundle(https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument)"
                    }
                ],
                "text": "Instance failed constraint bdl-11 \"A document must have a Composition as the first resource\""
            },
            "expression": [
                "Bundle, element Bundle(https://fhir.by/AbstractArea/StructureDefenition/Bundle/MedicationDocument)"
            ]
        },
    ]
}

Пример в виде postman коллекций

Ссылка	Описание
Скачать	Переменные ЦИСЗ
Скачать	Коллекция “Проверка пакета медицинских данных без импорта информации”.