Purpose

This WS give the opportunity to create unidentified person in eHealth. It means that person can be created w/o any information about it.

Specification

Apiary

Service logic

1. Only authenticated and authorized SPECIALIST, ASSISTANT, RECEPTIONIST employees can register prepersons.

2. Prepersons can be registered in OUTPATIENT and EMERGENCY legal entities.

3. Prepersons shoul be registered only with external_id as a required field. Other are optional

4. Preperson registers as separate record in MPI.prepersons table. On create ID of preperson sholdn’t match with ID of existent person.

5. Service should return preperson_id.

Authentication

1. Verify the validity of access token

   1. Return 401 in case validation fails

2. Check user scopes in order to perform this action (scope = 'preperson:write')

   1. Return 403 in case invalid scope(s)

Validate legal entity

Check that legal entity is active (status = ACTIVE) and belongs to the user

1. Extract client_id from token

2. Check legal entity status (status = ACTIVE)

   1. In case of error - return 409 (Legal entity must be ACTIVE)

3. Check legal entity has at least one healthcare service with status = ACTIVE and providing_condition = INPATIENT and speciality_type in ALLOWED_SPECIALITY_TYPE_FOR_PREPERSONS_HCS global variable (value should exist in SPECIALITY_TYPE dict)

   1. if no such healthcare services - return 409 (Legal entity does not have appropriate healthcare services)

Validate request

Validate request using schema (TBD)

Validate external_id

1. Check external_id is not empty.

   1. In case of error - return 422 (external_id should not be empty)

Generate preperson_id

1. Generate preperson_id (will be returned in response). Ensure there is no such person_id in MPI.persons

2. Generate patient_id to save it in patients collection (separate job).

Save object to DB

Insert preperson to MPI

prepersons table