...

1. Verify the validity of access token

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

2. Verify that token is not expired

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

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

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

Headers

Наприклад:

Content-Type:application/json

...

1. if episode_of_care is presented in request as the code of resource

   1. Check episode_of_care in the request exists and is in active or closed status in DB

      1. in case of error return - 422 (Episode is canceled)

   2. Check if resource from granted_to = 'employee':

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

2. if diagnostic_report is presented in request as the code of resource

   1. Check diagnostic_report block in the request exists and is in final status in DB

      1. in case of error return - 422 (Diagnostic report in \"entered_in_error\" status can not be referenced or Diagnostic report with such id is not found)

   2. Check if resource from granted_to = 'employee':

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

3. if care_plan is presented in request as the code of resource

   1. Check care_plan in the request exists in DB

      1. in case of error return - 422 (Care plan with such id is not found)

   2. Check there no other objects in request

      1. in case of error return - 422 (Approval for care plan can not contain other entities)

   3. Check if resource from granted_to = 'employee':

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

4. if encounter  is presented in request as the code of resource

   1. Check encounter in the request exists in DB

      1. in case of error return - 422 (not found)

   2. Check if resource from granted_to = 'employee':

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

   3. Check is status of episode from encounter = 'active'

      1. in case of error return - 422 ("Encounter refers to episode that is not active")

5. if procedure is presented in request as the code of resource

   1. Check procedure in the request exists in DB

      1. in case of error return - 422 (not found)

   2. Check if resource from granted_to = 'employee':

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

Validate service_request

1. If service_request block is presented in request

   1. Get Service_request details (only in active status)

   2. use Response.permitted_resources as resources for approval(could be episode or diagnostic_report).

2. If resource from granted_to = 'legal_entity':

   1. Check if status of legal_entity in (ACTIVE, SUSPENDED):

      1. in case of error return - 422 (Legal entity should be active)

Validate forbidden_group

1. if forbidden_group block is presented in request

   1. Check forbidden group in the request exists and is_active in DB

      1. in case of error return - 404 (not found)

   2. Check if resource from granted_to = 'employee':

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

Validate diagnoses_group

1. if diagnoses_group block is presented in request

   1. Check diagnoses_group in the request exists and is_active in DB

      1. in case of error return - 404 (not found)

   2. Check if resource from granted_to = 'employee':

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

Validate patient

1. if patient block is presented in request

   1. Get patient_id from URL:

      1. Check person_id from the request equal to the patient_id from URL

         1. in case of error return - 404 (“Approval for one patient can not be created in another patient’s context”)

      2. exists and is_active in DB

         1. in case of error return - 404 (Person is not found)

   2. Check if resource from granted_to = 'employee':

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

Validate block child_resource

1. if child_resource is not empty:

   1. validate that access_level == read

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

   2. check that $.child_resource.identifier.value context is equal to $.resource.identifier.value

      1. in case of error return - 422 (Child resource context id is not equal to granted resource id)

   3. validate that service_requests / forbidden_groups / diagnoses_group / patients are not filled

      1. in case of error return - 422 (schema does not allow additional properties)

   4. validate that resources max items = 1

      1. in case of error return - 422 ($.resources.expected a maximum of 1 items but got 2)

   5. Check if resource from granted_to = 'employee':

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

Validate person authentication_method

...

Validate authorize_with

The patient can pass the id of his auth_method which he wants to confirm the approval. The necessary auth method can be found by making Get person's auth methods

...

1. All the approvals in status "new" should be deleted 12 hours after creation - env. configuration parameter

2. All approvals with diagnoses_group has its own expires_at config parameter - env. configuration parameter

3. All approvals with forbidden_group has its own expires_at config parameter - env. configuration parameter

4. All approvals with care_plan has its own expires_at config parameter - env. configuration parameter

5. All approvals with patient has its own expires_at config parameter - env. configuration parameter

6. Approvals with child_resources will be created ON entity which is context of this child_resources

7. For approvals on child_resource with resource and on service_request:

   1. set child resource to block reason

   2. set service_request to block reason

8. If resource from granted_to = employee:
   Check if for granted_resource and\or for reason there are forbidden groups:

   1. if there are items from forbidden group

      1. check type of authentication_method for patient

         1. If type = 'OTP' send SMS (Код <code> для доступу до даних про ВІЛ/РПП https://bit.ly/nszu1677f )

   2. if there NO forbidden group items and diagnoses_group block is presented in request

      1. if diagnoses_group type is ICD10:

         1. check type of authentication_method for patient

            1. If type = 'OTP' send SMS (Код <code>: доступ на групу діагнозів {diagnoses_group_code} http://bit.ly/nszu1677b )

      2. if diagnoses_group type is ICPC2:

         1. check type of authentication_method for patient

            1. If type = 'OTP' send SMS (Код <code> доступ на групу діагнозів {diagnoses_group_code} http://bit.ly/nszu1677e )

   3. else if there NO forbidden group items

      1. check type of authentication_method for patient

         1. If type = 'OTP' send SMS (Код авторизації дій в системі eHealth: <code>')

9. If resource from granted_to = legal_entity:

   1. check type of authentication_method for patient

      1. If type = 'OTP' send SMS (Код <code>: згода на обробку персональних даних eZdorovya )

Response structure

See on Apiary

...