Table of Contents

Page Properties

id	API_Specification

Link	https://ehealthmisapi1.docs.apiary.io/#reference/public.-medical-service-provider-integration-layer/merge-request/create-merge-request	Посилання на Apiary або Swagger
Resource	/api/merge_requests	Посилання на ресурс, наприклад: /api/persons/create
Scope	merge_request:write	Scope для доступу
Components	Patient registry	Зазначається перелік бізнес компонентів, які використовують цей метод, наприклад: ePrescription
Microservices	il/api mpi/api fe/admin-web	Перелік мікросервісів, які використовує метод API, наприклад: Auth, ABAC
Protocol type	REST	Тип протоколу, який використовується запитом, наприклад: SOAP \| REST
Request type	POST	Тип запиту API, наприклад: GET, POST, PATCH…
Sync/Async	Sync	Метод є синхронним чи асинхронним?
Public/Private/Internal	Public	Потрібно зазначити тип методу за ступенем доступності

Logic

Only authenticated and authorized SPECIALIST, ASSISTANT or RECEPTIONIST employees can merge prepersons with prepersons.
Prepersons can be merged in EMERGENCY or OUTPATIENT legal entities.
Employee can merge any active preperson to any active person.
To merge person with preperson only their MPI ids needed.
Change status should be logged in the Event manager.

...

Verify the validity of access token
Return
- return 401 in case validation fails
Check user scopes in order to perform this action (scope = 'merge_request:write')
Return
- return 403 in case invalid scope(s)
If BLOCK_UNVERIFIED_PARTY_USERS is true, then check party's data match following condition: verification_status != NOT_VERIFIED or (verification_status = NOT_VERIFIED and updated_at <= current_date - UNVERIFIED_PARTY_PERIOD_DAYS_ALLOWED):
1. in case not match - return 403 ("Access denied. Party is not verified")

Headers

Content-Type:application/json

...

Parameter	Source	Description
id	uuid	Autogenerated
data	jsonb	Contains data for signed_content in json format. At this step is null. Optional field
master_person_id	Request: master_person_id	Person identifier in MPI (mpi.persons.id). Required
merge_person_id	Request: merge_person_id	Preperson identifier that corresponds to MPI.prepersons.id (returned on create preperson). Required
status	string	Status of the request, required. Set NEW
merged_pair_id	uuid	Reference to mpi.merged_pairs table when person becomes merged with preperson (on sign). By default is null.
printout_form	text	Printout form of preperson merge request in html format. By default is null at this step
legal_entity_id	Request: client_id	Legal entity where request was created. Client_id extracted from token. Required
documents	jsonb	urls of the person`s documents if chosen authentication method is OFFLINE
authentication_method_current	jsonb	Person current authentication method.
is_active	bool	Technical flag. By default is true
inserted_by	uuid	Extract user from token
inserted_at	timestamp	Get current date-time
updated_by	uuid	Extract user from token
updated_at	timestamp	Get current date-time

See on Apiary

...