RC_Block Medication request by Pharmacy User (CR-522)

Specification

Apiary

Validations

Validate request

• Validate request using JSON schema

  • in case of error - return 422

Validate Medication request

• Get Medication request identifier from the URL. Check Medication request exists in OPS DB

  • in case of error - return 404 (“Medication request does not exist")

Validate user

Medication Request blocking is allowed for user if he has active and approved employee with employee_type = ‘PHARMACIST’

• in case of error - return 409 ("Only pharmacist can block medication request")

Validation transition

• Get Medication request by $.id in OPS DB. Check that Medication request status = ‘ACTIVE’

  • in case of error - return 409 ("Medication request must be in active status")

• Get Medication request by $.id in OPS DB. Check that Medication request is not blocked, i.e. is_blocked = false

  • in case of error - return 409 ("Medication request is already blocked")

Validate block reason code

• Validate $.block_reason_code is a value from MEDICATION_REQUEST_BLOCK_REASON dictionary

  • in case of error - return 422 ("value is not allowed in enum")

• Check that $.block_reason_code is present in PHARMACIST_MEDICATION_REQUEST_BLOCK_REASON_CODES chart parameter for validated user

  • in case of error - return 422 ("Block reason code is not allowed for PHARMACIST")

Validate blocked_to

• Validate $.blocked_to > now()

  • in case of error - return 422 ("Blocked_to date should be equal to or greater than the current date")

• Validate $.blocked_to <= $.medication_request.dispense_valid_to

  • in case of error - return 422 ("Blocked_to date should be equal to or less than the dispense validity end date")

Service logic

1. Update Medication request in OPS DB:

   1. set is_blocked = true

   2. set blocked_to = $.blocked_to OR $.medication_request.dispense_valid_to date + 23:59 time (in case blocked_to is absent in request)

   3. set blocked_by_legal_entity_id = legal_entity_id (client_id) from token

   4. set block_reason_code = $.block_reason_code

   5. set block_reason = $.block_reason

   6. set updated_by = user_id

   7. set updated_at = now()

2. Send SMS for person

   1. If Medication request has program with medical program setting medication_request_notification_disabled = true, then don't send SMS.

      Else:

      1. Get authentication_method of person from MPI

      2. If authentication_method == OTP, then send SMS to a person from Medication request:

         1. Generate SMS text

            1. get template from block_template_sms parameter

            2. enrich template with data from Medication request

         2. Send SMS to a person

3. Return Medication request data with trimmed information about legal entity, division and employee

4. Add new record in Event manager: