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

Отмена импорта пакета медицинских данных

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

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

Программные интерфейсы ЦИСЗ защищены сервером авторизации с использованием технологии OAuth 2.0 (см. вкладку “Авторизация в ЦИСЗ”). При каждом вызове метода клиентское приложение (МИС) должно передавать токен доступа (токен медицинского работника) в заголовке запроса.

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

POST [FHIR_BASE]/Bundle/<bundle_id>/$cancel

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

Название Профиль Описание
bundle_id Логический идентификатор пакета медицинских данных Получить bundle_id можно из ответа метода импорта пакета медицинских данных о пациенте в ЦИСЗ

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

Название Профиль Описание
Parameters Parameters В случае, если пакет с переданным bundle_id существует, то возвращается ответ типа Parameters
Outcome Operation Outcome В случае, если произошла ошибка, будет возвращён ответ типа OperationOutcome, содержащий описание ошибки

Ресурс Parameters состоит из следующих параметров:

Название Тип Описание
ProcessingStatus valueString Статус обработки добавления пакета медицинских данных
OperationStatusReference valueReference Ссылка на статус операции, по которой можно получить статус обработки пакета медицинских данных
ResourceId valueString Идентификатор ресурса, по которому можно получить статус операции, проводящейся с данным ресурсом
ResourceType valueString Тип ресурса
StatusDescription Operation Outcome Описание ошибки при обработке пакета

Поле ProcessingStatus может принимать одно из пяти значений:

Название Описание
Pending Система получила и сохранила пакет медицинских данных, но этот пакет ещё не находится в обработке
InProgress Произошла декомпозиция пакета медицинских данных и каждая декомпозиованная часть отправилась на обработку в соответствующий обработчик
Successed Все обработчики успешно завершили обработку данных
Failed Как минимум один обработчик завершил обработку с ошибкой. В таком случае обработка всего пакета отменяется
Cancelled Сохранение пакета медицинских данных было отменено

Метод возвращает:

  • HTTP статус 202 (Accepted) - пакет найден, запрос на отмену импорта пакета принят в обработку, но обработка запроса еще не завершена;

  • HTTP статус 404 (Not Found) - пакет не найден;

  • HTTP статус 400 (BadRequest) - пакет, импорт которого нужно отменить, не был успешно импортирован.

Пример запроса на отмену импорта пакета медицинских данных:

POST [FHIR_BASE]/Bundle/1308b431-5f8a-11ef-b9ba-aa5a4c1203ff/$cancel

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

{ "resourceType": "Parameters", "parameter": [ { "name": "ProcessingStatus", "valueString": "Pending" }, { "name": "OperationStatusReference", "valueReference": { "reference": "http://cisz.by/api/fhir/Bundle/1308b431-5f8a-11ef-b9ba-aa5a4c1203ff/$status" } }, { "name": "ResourceId", "valueString": "1308b431-5f8a-11ef-b9ba-aa5a4c1203ff" }, { "name": "ResourceType", "valueString": "Bundle" } ] }

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

{ "resourceType": "OperationOutcome", "id": "f181ea71-02a8-4db7-a062-9f0093e093e9", "meta": { "lastUpdated": "2024-08-21T07:09:28.8948429+00:00" }, "issue": [ { "severity": "error", "code": "not-found", "diagnostics": "Resource type Bundle with id 2222b431-5f8a-11ef-b9ba-aa5a4c1203ff couldnot be found." } ] }

Пример ответа в случае, если пакет медицинских данных, импорт которого нужно отменить, не был успешно импортирован:

{ "resourceType": "OperationOutcome", "id": "81887805-382b-4000-933d-a243c6b0894a", "meta": { "lastUpdated": "2024-08-21T07:40:00.7382735+00:00" }, "issue": [ { "severity": "error", "code": "invalid", "diagnostics": "Bundle will be cancelled only if the import operation with this bundle has been successful." } ] }
▲ Вверх