Purpose

This WS allows to get details about unidentified person from eHealth.

Specification

Apiary

Service logic

1. Only authenticated and authorized OWNER, SPECIALIST, ASSISTANT, RECEPTIONIST, ADMIN employees can get preperson.

2. Preperson could be got only in OUTPATIENT or EMERGENCY legal entity type, if MPI identifier of preperson is being known (returns after Create preperson).

3. Only patient collection fields can be recieved.

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

   1. Return 403 in case invalid scope(s)

Validate person_id

1. Check person_id does not exist in mpi.persons

   1. In case error - return 422 (Person_id doesn’t belong to unidentified person)

2. Generate patient_id from person_id. Check if patient_id exists in patients collection.

   1. In case of error - return 404

Prepare response

Render response