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 but requires a medical identification with set of medical events.

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 predefined set of medical events (package).

4. Preperson registered w/o entry in MPI. Only as document in patients collection.

5. Service should generate patient_id in MongoDB, but return person_id (w/o creating entry in MPI)

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:create')

   1. Return 403 in case invalid scope(s)

Validate legal entity

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

1. Extract client_id from token (token.client_id == legal_entity_id)

2. Check legal entity status (status = ACTIVE, SUSPENDED)

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

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 person_id

1. Generate person_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