RC-[NEW] Mark in error Device dispense

Purpose

This WS is designed to mark in error previously created Device dispense in case it was entered in error.

Specification

Apiary

Authorization

1. Verify the validity of access token

   • in case of error - return 401 (“Invalid access token”) in case of validation fails

2. Verify that token is not expired

   • in case of error - return 401 (“Invalid access token”)

3. Check user scopes in order to perform this action (scope = 'device_dispense:mark_in_error')

   • return 403 (“Your scope does not allow to access this resource. Missing allowances: device_dispense:mark_in_error”) in case of invalid scope(s)

Validations

Validate request

Return 422 with the list of validation errors in case validation fails

Validate legal entity

1. Extract client_id from token

   • Check that “type” in me_allowed_transactions_le_types config parameter

     • in case of error return 409 “Invalid LegalEntity type“

Validate digital signature

1. Validate request is signed

   1. in case of error - return 400 (“Invalid signed content”)

2. Check DS is valid and not expired

3. Validate that DS belongs to the user

   1. Check that DRFO from DS and party.tax_id matches

      1. in case of error - return 422 (“Does not match the signer drfo“)

Validate user

Marking in error a Device dispense is allowed for a user if he has one of the following active and approved employee that:

• is an author of the Device dispense (performer)

• is Med_Admin from legal entity where Device dispense is created (performer_legal_entity)

• check that user has an employee of DOCTOR or SPECIALIST type, which has an approval granted by the patient with access_level:write for this resource ($.approvals.granted_resources.identifier.value==$.device_dispense._id AND $.approvals.granted_to.identifier.value==PRM.employees.id AND $.approvals.access_level=‘write’)

  • return error 409  "Employee is not performer of device dispense, doesn't have approval or required employee type"

Validate transition

1. Get current device dispense status

   1. Check that status != “entered_in_error” and status != “completed”

      1. in case of error - return 409 error ('Device dispense in status <status> cannot be marked in error')

For more information look at RC-[UPD] Device dispense status modelarchived.

Validate status

The target status value must be submitted in the order of display in the signed content (media storage)

1. Validate $.status is entered-in-error

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

Validate content

Signed content must match with device dispense in DB in order to be marked in error

1. Render device dispense from DB

2. Exclude $status from signed content

3. Compare rendered device dispense and signed content

   1. In case both object doesn't match - return 422 ('Signed content doesn't match with previously created device dispense')

Service logic

1. Save signed content to media storage

2. Update device dispense status to entered-in-error (update also updated_at, updated_by)

3. Save internal information to corresponding DB

4. Send StatusChangeEvent to the Event Manager