Get Medication request by Pharmacy User

Purpose

This WS is designed to return medication request details by Pharmacy 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_pharm')

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

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 relates to requested parameters

      1. Return 404 ('Not found') 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