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

OperationDefinition: Операция получения списка пациентов в очереди

Официальный URL: https://fhir.by/OperationDefinition/find-queue
Unknown as of 2026-06-25 Имя: find-queue

Операция получения списка пациентов в очереди

Операция позволяет получить информацию об очереди и перечень пациентов состоящих в ней.

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

Для авторизации используется двусторонний метод (Client Credentials) - в этом случае клиентское приложение использует свои учетные данные для получения токена доступа. Токен доступа, полученный по этой схеме, считается токеном организации.

Перед выполнением операции необходимо получить guid интересующей очереди методом search.

Для вызова операции используется GET запрос: GET [FHIR_BASE]/Organization/[organization-id]/HealthcareService/[HealthcareServiceOrganizationQueue_id]/$find-queue

В случае успешного выполнения операции система возвращает ресурс Bundle типа searchset содержащий набор ресурсов HealthcareServiceOrganizationQueue и EncounterPatientQueue.

HTTP code 200 OK

Bundle
total = [count_n+1]
entry 
    HealthcareServiceOrganizationQueue[HealthcareServiceOrganizationQueue_id]
    EncounterPatientQueue_1
    EncounterPatientQueue_2
    EncounterPatientQueue_3
    ...
    EncounterPatientQueue_[count_n]

В случае, если в Очереди нет пациентов, вернется Bundle типа searchset содержащий ресурс HealthcareServiceOrganizationQueue.

HTTP code 200 OK

Bundle
total = 1
entry 
  HealthcareServiceOrganizationQueue[HealthcareServiceOrganizationQueue_id]

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

Доступные коды: planned (пациент поставлен в очередь), completed (выполнено), cancelled (отменено)

Для вызова операции используется GET запрос: GET [FHIR_BASE]/Organization/[organization-id]/HealthcareService/[HealthcareServiceOrganizationQueue_id]/$find-queue?status=[status_code]

В случае успешного выполнения операции система возвращает ресурс Bundle типа searchset содержащий набор ресурсов HealthcareServiceOrganizationQueue и EncounterPatientQueue только со статусами подходящими параметрам запроса.

HTTP code 200 OK


Bundle
total = [count_n+1]
entry 
    HealthcareServiceOrganizationQueue[HealthcareServiceOrganizationQueue_id]
    EncounterPatientQueue_1 (status=[status_code])
    EncounterPatientQueue_2 (status=[status_code])
    EncounterPatientQueue_3 (status=[status_code])
    ...
    EncounterPatientQueue_[count_n] (status=[status_code])

Если искомый ресурс HealthcareServiceOrganizationQueue не найден, возвращается Bundle типа searchset содержащий ресурс OperationOutcome :

HTTP code 200 OK


Bundle
total = 0
entry
  OperationOutcome 
    issue
      severity : warning
      code  : incomplete

      details 
        text = "Ресурс {HealthcareServiceOrganizationQueue_id} не найден."

Если токен организации не соответствует правам, по которым возможно получение информации об очереди:

HTTP code 403 forbidden

issue
    severity = error
    code = forbidden 

    details 
        text = "Нет прав на получение информации о {HealthcareServiceOrganizationQueue_id}."

URL: [base]/$find-queue

Параметры

ИспользоватьНаименованиеСфера действияКардинальностьТипПривязкаДокументация
INstatus0..2code

Код статуса ресурсов Encounter которые необходимо вернуть в ответе. При незаполненном поле возвращает ресурсы EncounterPatientQueue со всеми статусами, если требуется выбрать определенные статусы возможно использовать коды статусов доступных для Encounter: planned (пациент поставлен в очередь), completed (выполнено), cancelled (отменено)

OUTsearchset1..1Bundle

Ресурс Bundle типа searchSet содержащий набор ресурсов HealthcareServiceOrganizationQueue и EncounterPatientQueue

Необходимо добавить дополнительную информацию!!!!!!

Для добавления дополнительной информации нужно добавить файл input/intro-notes/OperationDefinition-find-queue-notes.md