Validate request
Validate request using JSON schema
Authorize
- Verify the validity of access token
- Check user scope declaration_request:create in order to perform this action
Validate Legal Entity Type
Validate legal entity from token: legal_entities.type should be in DECLARATION_REQUEST_LEGAL_ENTITY_TYPES and legal_entities.status =='active'
Validate doctor
Get employee details
Invoke Get employee details
Validate Response $.data.employee_type == DOCTOR
Calculate patient age
Calculate patient age
age = MONTHS_BETWEEN (now(), $.declaration_request.person.birth_date) / 12
Get global parameters
Invoke Global parameters to get following parameters:
- ADULT_AGE
- DECLARATION_TERM
- phone_number_auth_limit
curl -X GET \
{:host}/prm/api/global_parameters
{
"meta": {
"url": "http://api-svc.prm/api/global_parameters",
"type": "object",
"request_id": "ikff7hcf0hhto5c06irl9i976kc3s41m",
"code": 200
},
"data": {
"verification_request_expiration": "30",
"employ_request_expiration": "30",
"declaration_term": "30",
"declaration_request_expiration": "30",
"billing_date": "2",
"adult_age": "18",
"type": "global_parameter"
}
}
Check that doctor speciality meets the patient age requirements
- Get doctor's speciality_officio (speciality object where speciality_officio == true)
- Check age requirements according to global parameters
| Speciality officio | Age |
|---|---|
| FAMILY DOCTOR | All ages |
| THERAPIST | Greater or equal to $.data.adult_age |
| PEDIATRICIAN | Less than $.data.adult_age |
Check phone number
Invoke Check phone number WS in order to check phone number exists in DB.
Phone number: $.declaration_request.person.phones.[0].number
curl -k -L '{:host}/verifications/+380508887700'
{
"meta": {
"url": "http://dev.ehealth.world/verifications/+380936235985",
"type": "object",
"request_id": "b98ie5d0j3fn7vcbbmksa4k45ptue2ca",
"code": 200
},
"data": {
"phone_number": "+380936235985"
}
}
{
"meta": {
"url": "http://dev.ehealth.world/verifications/+380936235986",
"type": "object",
"request_id": "b4adrhrj5og9ogqanb57dqj0v1qkbb9j",
"code": 404
},
"error": {
"type": "not_found"
}
}
Search pending declaration requests
Search declarations in IL_DB.declaration_requests to prevent requests duplication:
- if tax_id is not null
WHERE IL_DB.declaration_requests.data.declaration_request.person.tax_id = :($.declaration_request.person.tax_id)
AND IL_DB.declaration_requests.data.declaration_request.legal_entity_id = :($.declaration_request.legal_entity_id)
AND IL_DB.declaration_requests.data.declaration_request.employee_id = :($.declaration_request.employee_id)
AND IL_DB.declaration_requests.status IN ('NEW', 'APPROVED')
- if tax_id is null
WHERE IL_DB.declaration_requests.data.declaration_request.person.first_name = :($.declaration_request.person.first_name)
AND IL_DB.declaration_requests.data.declaration_request.person.last_name = :($.declaration_request.person.last_name)
AND IL_DB.declaration_requests.data.declaration_request.person.birth_date = :($.declaration_request.person.birth_date)
AND IL_DB.declaration_requests.data.declaration_request.legal_entity_id = :($.declaration_request.legal_entity_id)
AND IL_DB.declaration_requests.data.declaration_request.employee_id = :($.declaration_request.employee_id)
AND IL_DB.declaration_requests.status IN ('NEW', 'APPROVED')
Cancel declaration requests
Change status of all found declarations:
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 < 18)&(doctor.speciality = PEDIATRICIAN) {
end_date = min(birth_date + 18y - 1d, start_date + declaration_term);
} else {
end_date = start_date + declaration_term;
}
Validate confidant person
If person age < 14 check existence of confidant_person
- in case error return 422 - msg "Confidant person is mandatory for children"
Save declaration request
Insert record to IL.declaration_request in status 'NEW'
Check "no_tax_id" flag
- If "no_tax_id"= true, tax_id field should be empty, in case error return 422
- If "no_tax_id"=false and age>14, tax_id should be present, in case error return 422
Validate person_id
If person_id is in request then
- validate person_id is UUID
- in case error return 422
- search person by person_id in MPI
- in case error return 422, "such person doesn't exist"
- validate person be deduplication model (if score > ONLINE_PERSON_UPDATE_SCORE, then add mpi_id to declaration request)
- else return error 409, "such person can't be updated. New person should be created instead"
If person_id is not in request then
- search persons in mpi, which have the same last name OR first name OR document OR son or phone. Then we create pairs of new person with people from cluster and send to the model.
- in case deduplication model gave score < ONLINE_PERSON_UPDATE_SCORE, create new person
- else return error 409, "such person with $.
person_idis in mpi. Update this person.
Validate phone number limit
USE_PHONE_NUMBER_AUTH_LIMIT is a flag in ehealth.charts that shows whether we count phones or not.
- in case person is found, person_id will be saved to declaration_request, and person has the same authentication_methods.phone_number, we do not count phone numbers and do not compare the phone number with global_parameters.phone_number_auth_limit. So that we can update person, but still can not use phone over limit.
- In case person is not found
- Check if (SELECT count(*) from persons where authentication_methods::json->0->>'phone_number'='$.phone_number' and persons.status='active' and is_active=true)<global_parameters.phone_number_auth_limit
in case error return 422, msg "This phone number is present more then $.global_parameters.phone_number_auth_limit times in the system"
- Check if (SELECT count(*) from persons where authentication_methods::json->0->>'phone_number'='$.phone_number' and persons.status='active' and is_active=true)<global_parameters.phone_number_auth_limit
Validate declaration limit
- Count all declarations in status
activewhere OPS.declarations.employee_id==$.declaration_request.employee_id
1.1 If there is an active declaration with the current person, exclude it from the selection in order to let doctor resign declaration with current patient - Count all declaration_requests in status
approvedwhere IL.declaration_requests.data($.employee.id) ==$.declaration_request.employee_id - Get all specialities of current doctor
- Select speciality from PRM.employees where PRM.employees.party_id == (select PRM.employees.party_id where PRM.employees.id=$.declaration_request.employee_id)
- Select config parameter for declarations_limit where speciality == select 3
- Compare the result of selections 1+2 with the lowest config parameter from select 4. In case count (declarations+declaration_requests )> config_parameter, return 409 "The employee has reached the declaration limit"
Validate person documents
- issued_at, issued_by is mandatory for documents
- Validate dates
- issued_at <= now() and issued_at => birth_date
- in case `issued_at > now()` show error 422, "Document issued date should be in the past"
- in case `issued_at < person.birth_date` show error 422, "Document issued date should greater than person.birth_date "
- expiration_date > now()
- in case error show 422, "Document expiration_date should be in future"
- expiration_date is mandatory for document_type
- NATIONAL_ID
- COMPLEMENTARY_PROTECTION_CERTIFICATE
- PERMANENT_RESIDENCE_PERMIT
- REFUGEE_CERTIFICATE
- TEMPORARY_CERTIFICATE
- TEMPORARY_PASSPORT
- in case error return 422, "expiration_date is mandatory for document_type $.documents.type"
- issued_at <= now() and issued_at => birth_date
- Validate documents_type.number according to json schema
- PASSPORT - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`
- NATIONAL_ID - `^[0-9]{9}$`
- BIRTH_CERTIFICATE - `` ^(?![ыъэ@%&$^#`~:,.*|}{?!])[А-ЯҐЇІЄа-яґїіє0-9 №\\\"()-]+$ ``
- COMPLEMENTARY_PROTECTION_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`
- PERMANENT_RESIDENCE_PERMIT - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`
- REFUGEE_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`
- TEMPORARY_CERTIFICATE - `^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$`
- TEMPORARY_PASSPORT - `` ^(?![ыъэ@%&$^#`~:,.*|}{?!])[А-ЯҐЇІЄа-яґїіє0-9 №\\\"()-]+$ `
- if `unzr`exists and is not null and matches "^[0-9]{8}-[0-9]{5}$" check if first 8 symbols = birth_date
- in case error return 422, msg "unzr or birthdate are not correct"
if documents.type=NATIONAL_ID
check if unzr exists in request, in case error return 422, msg "unzr is mandatory for document type NATIONAL_ID"
- Document numbersmaxLength < 25
Determine auth method
Determine Channel
- channel from url
- if url is for cabinet сhannel set declaration_request.сhannel = CABINET
- if not - set declaration_request.сhannel = MIS
- if url is for cabinet сhannel set declaration_request.сhannel = CABINET
Generate printout form
Invoke MAN to render print form.
Request mapping:
| Parameter | Source |
|---|---|
| id | DECLARATION REQUEST |
curl --request POST \
--header 'Accept: text/html' \
--header 'Content-Type: application/json' \
{:host}/templates/{:declaration_printout_id}/actions/render
Set IL.declaration_request.printout_content:
MANResponse.$.data
Generate upload URL
Depending on the payload system generates list of signed urls for document scan-copies upload.
Signed URLs to be expired after some period of time (configurable `SECRETS_TTL`). 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.
For On-line
- if no_tax_id = true
- Generate URL with type person.no_tax_id
For Offline
1. If $.declaration_request.person.tax_id not null:
- Generate URL with type person.tax_id
2. For each $.declaration_request.person.documents:
- Generate URL's with type person.{$.declaration_request.person.documents.[:].type}
3. If $.declaration_request.person.confidant_person.[:].tax_id not null, for each:
- Generate URL with type confidant_person.{confidant_person.type}.tax_id
4. For each $.declaration_request.person.confidant_person.[:].documents_person:
- Generate URL's with type confidant_person.{confidant_person.type}.{$.declaration_request.person.confidant_person.[:].documents_person.[:].type}
5. For each $.declaration_request.person.confidant_person.[:].documents_relationship:
- Generate URL's with type confidant_person.{confidant_person.type}.{$.declaration_request.person.confidant_person.[:].documents_relationship.[:].type}
6. If no_tax_id = true
- Generate URL with type person.no_tax_id
Invoke Media Content Storage to generate upload URL for each document obtained by executing logic above
IL.declaration_request.documents structure:
{
"documents":[
{
"type":"person.tax_id",
"url": "https://storage.googleapis.com/..."
}
]
}
Save documents to DB.
Generate verification code
Invoke Initialize OTP to generate one time password and send it to client number.
Phone_number: IL.declaration_request.authentication_method_current.$.authentication_number
curl -X POST \
http://localhost:4000/verifications \
-H 'content-type: application/json' \
-d '{
"phone_number": "+380936235985"
}'
Generate human readable declaration number
- Use algorithm to generate declaration_number
- Declaration number should consist of a 4 serial symbols and 8 number symbols and looks like XXXX-12H4-245D
- Add field to ops.declarations and il.declaration_requests - declaration_number
- Add declaration_number to print out form
Validate uniqueness of 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