Required parameters are marked with "*"

...

Purpose

...

This method WS is used to create Declaration Request (as part of Declaration creation process) via new api. This method allows you to create a declaration only for an existing person.

Specification*

...

Link

...

Створення декларації (версія 3)

Specification

...

Key points

1. This method method allows to create a declaration only for an existing person.

2. To create declaration request based on active declaration in reorganized legal entity, parent_declaration_id must be passed in request

...

Global and configuration parameters

Invoke Global parameters to get following parameters:

...

Variable

...

Values

...

Description

...

• ADULT_AGE

• DECLARATION_TERM

• no_self_auth_ag

Filters

УДАЛИТЬ ВООБЩЕ !

...

Filter

...

Values

...

Type

...

Description

...

Example

...

person_id

...

String

...

Person ID

...

нет слова Example. может это столбец Value? и в Request используются именно эти значения

4d0d790c-cbf1-44f5-ab21-ba8db67da161

...

employee_id

...

String

...

1. .

...

1a8b10ea-ba09-40f2-8f9e-55608e9208c6

...

division_id

...

String

...

Registered Medical Service Provider Division identifier.

...

d290f1ee-6c54-4b01-90e6-d701748f0851

...

authorize_with

...

String

...

identifier of person's auth method

...

cc949559-5dfe-420f-ac05-065e443b2cc6

...

parent_declaration_id

...

String

...

identifier of parent declaration in reorganized legal entity

...

8c7753fc-a647-435f-8e43-4ff4546431f6

Request structure*

See on Apiary

...

...

Authorize

...

1. Verify the validity of access token

   1. in case error - return 401 

2. Check users scopes ('declaration_request:write') to perform this action

   1. in case error return 403 - forbidden

Request to process the request using a token in the headers

Headers*

• Content-Type:application/json

• Authorization:Bearer c2778f3064753ea70de870a53795f5c9

• api-key:uXhEczJ56adsfh3Ri9SUkc4en

Validate request (JSON schema)*

...

 {
  "$schema": "http://json-schema.org/declaration_request_new/schema#",
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "employee_id": {
      "type": "string"
    },
    "division_id": {
      "type": "string"
    },
    "authorize_with": {
      "type": "string"
    }
  },
  "required": [
    "person_id",
    "employee_id",
    "division_id"
  ]
}

...

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

2. If BLOCK_DECEASED_PARTY_USERS is true, check that party is not deceased (party_verification record does not equal to: dracs_death_verification_status = VERIFIED and dracs_death_verification_reason = MANUAL_CONFIRMED):

   1. in case of error - return 403 ("Access denied. Party is deceased")

Validate request using JSON schema

Validate Legal Entity Type

Validate legal entity from token:  legal_entities.type should be in DECLARATION_REQUEST_LEGAL_ENTITY_TYPES("MSP,PRIMARY_CARE,MSP_PHARMACY") and legal_entities.status =='active' 

Validate doctor

...

Get employee details

Invoke Get employee details

...

Take the doctor_id and the division_id from the token

Validate person 

• validate person_id UUID

  • in case error return 422

• search person by person_id in MPI 

  • in case error return 404, "Such person doesn't exist"

• validate person.auth_method != NA

  • in case error return 422, "Person must have authentication method"

• validate person.status = ‘active’ and is_active =true

  • in case error return 404, "Such person doesn't exist"

Validate person verification status

• validate patient's verification_status is not equal to NOT_VERIFIED.

  • in case of error return 409, "Patient is not verified"

Validate authorize_with

The person can pass the id of his auth_method which he wants to confirm the create declaration request. The necessary auth method can be found by making Get person's auth methods

...

1. validate auth_method.

...

1. id is UUID

   1. in case error return 422

2. search auth method in MPI.person_authentication_method

   1. in case error return 422, "such authentication method doesn't exist"

3. search auth method of this person where  MPI.person_authentication_method.person_id = $.person.id

   1. in case error return 422, "such authentication method does not belong to this person"

4. validate that auth_method.type != NA

   1. in case error return 422, "Сannot be confirmed by a method with type= NA. Use a different method."

5. validate that this method is active ( authentication_method.ended_at > now() and is_active = true)

This field is optional and set in il.declaration_reques.authentication_method_current.

If person request doesn't have this field, then choose that method which is returned from mpi as person's default method

Validate parent declaration

• check that parent declaration exists and in status ‘active’

  • in case of error - return 404 (‘Active parent declaration was not found’)

• check that the parent declaration belongs to a person (person_id of parent declaration and person_id from request are the same)

  • in case of error - return 409 (‘Parent declaration does not belong to this person’)

• check that the legal entity of parent declaration and the current legal entity are in reorganization process with types ACCESSION, MERGING, DIVIDING, SEPARATING (request: select * from related_legal_entities where is_active=true and merged_from_id=parent_declaration_id.legal_entity_id and merged_to_id=employee_id.legal_entity_id and type in (‘ACCESSION’, ‘MERGING’, ‘DIVIDING’, ‘SEPARATING’); returns at least one record)

  • in case of error - return 409 (‘Legal entities of parent declaration and current are not in reorganization process’)    

• check that party_id of employee from parent declaration and party_id of current employee are the same

  • in case of error - return 409 (‘Employee of parent declaration and current employee are not the same’)

This field is optional and set in il.declaration_reques.parent_declaration_id.

If parent_declaration_id is passed in request, authorize_with validation and processing must be skipped, created declaration request will be processed without patients involvement.

Get global parameters

Invoke Global parameters to get following parameters:

• ADULT_AGE

• DECLARATION_TERM

• no_self_auth_ag

Calculate patient age

Calculate patient age

age = MONTHS_BETWEEN (now(), $.mpi.person.birth_date) / 12

Check that doctor speciality meets the patient age requirements

1. Get doctor's speciality_officio (speciality object where speciality_officio == true)

2. Check age requirements according to global parameters

Validate confidant person

...

• in case error return 422 - msg "Confidant person is mandatory for children"

Processing

...

Search pending declaration requests

...

where IL.Declaration_request.mpi_id = :($.person.id) and status in ('NEW' or 'APPROVED)
Cancel declaration requests

Change status and status reason of all found declarations:declaration requests:

• status: CANCELED

• status_reason: request_cancelled

SET   IL_DB.declaration_requests.status = 'CANCELED'
WHERE IL_DB.declaration_requests.id IN (:LIST)

Calculate declaration end/start date

Declaration 

Start date:

start_date = Current_date()

End date:

if (person.age < prm.global_parametrs.adult_age)&(doctor.speciality = PEDIATRICIAN) {
  end_date = min(birth_date + prm.global_parametrs.adult_age - 1d, start_date + declaration_term - 1d);
} else {
  end_date = start_date + declaration_term - 1d;
}

Save declaration request

1. Insert record to IL.declaration_request

...

1. :

   1. status 'NEW'

   2. is_shareable: false

Generate upload URL

If auth_method_requests.auth_method_current = OFFLINE

...

Signed URLs to be expired after some period of time (configurable `SECRETS_TTL`, розташування на Gitlab: (ael.api/docs/Centrul Național de Mediu )). If it has been expired - new declaration request should be created.

Each link is generated for one one-page document in jpeg format. Document should be no more than 10MB.

Set auth_method_current

...

Get parent_declaration_id from il.declaration_requests.parent_declaration_id.

If parent_declaration_id is null, set default auth method of person on IL.auth_method_request.auth_method_current - use function in mpi, that return default auth method.

If auth_method_current = NA - return Error "person authentication method is undefined".

If parent_declaration_id is not null, set auth_method_current = NA (request is processed without patients involvement).

Generate verification code

...

Invoke Initialize OTP to generate one time password and send it where auth_method_requests.auth_method_current = OTP.

cURL example

curl -X POST \
  http://localhost:4000/verifications \
  -H 'content-type: application/json' \
  -d '{
  "phone_number": "+380936235985"
}'

Generate human readable declaration number

...

• generate declaration_number

• Search declaration_number in declaration_requests.declaration_number

• if exists = go to 'generate declaration_number'

• else save declaration_number to declaration_request

Response structure*

See on Apiary

Code 201

...

...

• declaration

...

• _

...

Code 422

...

...

• request

...

Що має відбутися в ЦБД після опрацювання та відправлення відповіді, тощо

HTTP status codes

Backward compatibility

...