RC_1_PSYHO_Get Medication request Requests in care plan context_EN

Specification

Get Medication request Requests in care plan context

Purpose

This WS is designed to search (get list) Requests for Medication request in the care plan context. If the user has approval of the care plan, he will receive a list of Medication request requests regardless of the legal entity which are created on the basis of this care plan.

Input parameters (filters)

• employee_id (optional)

• person_id (optional)

• encounter_id (optional)

• status (optional)

• intent (optional)

• page (optional)

• page_size (optional)

Logic WS

1. Verify the validity of access token

   1. Return 401 in case validation fails

2. Check user scopes in order to perform this action (scope = 'medication_request_request:read')

   1. Return 403 in case invalid scope(s)

3. Get party_id  from $.context.user_id

4. Get list from $.prm.employees for this party_id

5. Get care_plan_id from url

6. Check $.approvals for user's employees (granted_to) on care_plan_id (granted_resources) and $.medication_request_requests.person_id (granted_by)

7. Search Medication request requests by filters: care_plan_id.

   1. limit (limit response size - quantity of innm objects). By default returned 50 objects.

   2. starting_after (cursor to fetch next page)

   3. ending_before (cursor to fetch previous page)

Response (output)

1. If according to filters requests are not found, WS returns empty data array.

   1. WS also returns pagination data - for technical info.