...

Specification

...

Request structure

See on Apiary

Example:

{
  "resources": [
    {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "episode_of_care"
            }
          ],
          "text": ""
        },
        "value": "97d57238-ffbe-4335-92ea-28d4de117ea2"
      }
    }
  ],
  "child_resource": {
    "identifier": {
      "type": {
          "coding": [
            {
              "system": "eHealth/resources",
 
            "code": "episode_of_careprocedure"

           }
          ],
          "text": ""
        },
        "value": "97d5723821e227f9-ffbe3afc-43354938-92ea80d6-28d4de117ea28594814fbe1a"
 
    }
 
  }
  ],
  "granted_to": {
    "identifier": {
      "type": {
        "coding": [
          {
            "system": "eHealth/resources",
            "code": "employee"
          }
        ]
      },
      "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
    }
  },
  "access_level": "read",
  "authorize_with": "cc949559-5dfe-420f-ac05-065e443b2cc6"
}

...

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 access_level = 'write':

      1. Check if care_plans.managing_organization = granted_to.employees.legal_entity_id:

         1. in case of error return - 422 ('User is not allowed to write care plan from another legal_entity')

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")

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 person authentication_method

1. If resource = care_plan & care_plans.terms_of_service = 'INPATIENT'&granted_to.employees.legal_entity_id = care_plans.managing_organization:

   1. skip validation of person authentication_method

   2. set approvals.urgent = null

2. In other cases: Check patient_id:

   1. if belongs to person, then GET auth_method from MPI using {patient_id}

      1. If it's OTP:

         1. send SMS to the auth_phone via otp_verification service POST /verifications

         2. save approval to DB

         3. save authentication_method_current.type and number to DB

         4. return authentication_method_current.type = OTP

      2. If it is offline

         1. save approval to DB

         2. save authentication_method_current.type and number to DB

         3. return  authentication_method_current.type = offline

      3.  if it is null:

         1. return error 409 (Person does not have active authentication method)

   2. if belongs to preperson:

      1. save approval to DB

      2. set approval status = active

      3. set approval urgent = null 

...

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. Approvals with child_resources will be created ON entity which is context of this child_resources

9. 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

10. 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>')

11. If resource from granted_to = legal_entity:

    1. check type of authentication_method for patient

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

...

{
  "data": {
    "id": "d5a5d991-0bf7-476f-b3cf-bec73f044b2e",
    "granted_resources": [
      {
        "identifier": {
          "type": {
            "coding": [
              {
                "system": "eHealth/resources",
                "code": "episode_of_care"
              }
            ]
          },
          "value": "d5a5d991-0bf7-476f-b3cf-bec73f044b2e"
        },
        "display_value": "null"
      }
    ],
    "granted_to": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "employee"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      },
      "display_value": "null"
    },
    "expires_at": 1498749591,
    "reason": {
      "identifier": {
        "type": {
          "coding": [
            {
              "system": "eHealth/resources",
              "code": "service_request"
            }
          ]
        },
        "value": "9183a36b-4d45-4244-9339-63d81cd08d9c"
      },
      "display_value": "null"
    },
    "status": "new",
    "access_level": "read",
    "authentication_method_current": {
      "type": "OTP",
      "number": "+38093*****85"
    }
  },
  "meta": {
    "code": 201,
    "url": "http://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  }
}

...