Get medication requests details (new - EN)

Purpose

This WS is designed to return medication request details by msp users. Receiving Medication request is possible by identifier or request_number.

Specification

Apiary

Authorization

• Verify the validity of access token

  • Return (401, 'Invalid access token') in case of validation fails

• Verify that token is not expired

  • in case of error - return (401, 'Invalid access token')

• Check user scopes in order to perform this action (scope = 'medication_request:details')

  • Return (403, 'Your scope does not allow to access this resource. Missing allowances: medication_request:details') in case of invalid scope(s)

Access to the resource is also managed by ABAC rules .

Service logic

Service returns specified Medication requests related to the patient:

1. Get Medication requests from medication_requests (OPS database)

2. Validate data consistency:

   1. Ensure that requested Medication requests relates to requested Patient (from URL)

      1. Return 403 ('Access denied') in case of error

3. Render a response according to specification

   1. Calculate medication remaining quantity:

      1. Select all Medication dispenses in status PROCESSED related to the Medication request

      2. Sum medication_qty in the filtered Medication dispenses as dispensed_qty

      3. Calculate medication_remaining_qty = medication_qty - dispensed_qty

   2. Return medication_remaining_qty in the response