| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
Extract user_id from token. Check that requester belongs to one of the user’s employee.
in case of error - return 422 ('User is not allowed to create device request for the requester')
Check requester is an active and approved employee.
in case of error - return 422 ('Invalid employee status')
Check requester relates to the legal entity (client_id from token).
in case of error - return 422 ('Employee <id> doesn't belong to your legal entity')
Check that requester is the same employee as encounter performer ($.requester == encounter.performer)
in case of error - return 422 ('Requester doesn’t match with encounter performer')
2. Validate based on
Validate values in the field $.based_on (Reference), array, optional.
Check that $.based_on contains only one reference
in case of error - return 422 ('Only one reference is allowed in based_on')
Validate that referenced resource is one of the following (activity):
in case of error - return 422 ("Referenced resource in based_on is not allowed")
Check that resource exists and belongs to the patient ($.subject)
in case of error - return 422 ('Referenced resource not found')
If Activity resource referenced:
Validate that entity status is “SCHEDULED” or “IN_PROGRESS“
in case of error - return 422 ("Invalid activity status (based_on)")
Check that activity.kind == 'device_request'
in case of error - return 422 ("Invalid Activity kind (based_on)")
Validate that referenced activity has the same product_codeable_concept or product_reference as current device request
Check that $.code == (referenced) activity.detail.codeable_concept OR
Check that $.code_reference == (referenced) activity.detail.product_reference
in case of error - return 422 ("Type in based_on activity doesn’t match with type in prescribed device request")
Validate that referenced activity has the same program as current device request
Check that $.program == (referenced) activity.detail.program OR is missing on both sides
in case of error - return 422 ("Program in based_on activity doesn’t match with program in prescribed device request")
Check that units of measure is the same
Check that $.quantity.code == activity.detail.quantity.code:
in case of error return 422 ("The quantity units must not differ from the quantity units in the activity")
Check that prescribed quantity does not exceed remaining quantity
select all device requests based on current activity and calculate previously reserved quantity as sum of DR.quantity.value.
calculate reserved at the moment quantity as sum of previously reserved quantity and quantity from current DR
calculate remaining quantity by subtracting reserved at the moment quantity from activity's quantity
Check that remaining quantity is greater then or equal to zero
in case of error return 422 "The number of available devices according to the care plan activity has been exhausted"
3. Validate intent
Validate value in the field $.intent, string, required.
...
4. Validate code or code_reference
One and only one of $.code (CodeableConcept) and $.code_reference (Reference) must be provided
Check that $.code or $.code_reference provided in request
in case of error - return 422 ('One of $.code and $.code_reference is required')
Check that both $.code or $.code_reference not provided at the same time
in case of error - return 422 ('Only one of $.code and $.code_reference is allowed')
If $.code provided:
Check that value is in allowed active values from
device_definition_classification_typedictionary.in case of error - return 422 ('value is not allowed in enum')
Check that there is at least one active device_definition with the same type (device_definitions.classification_type)
device_definitions.is_active = true
in case of error - return 422 ('No active device_definitions with the same type')
If $.code_reference provided:
Validate value in the field $.code_reference, Reference on device_definitions resource
Check that device definition exists and is_active
in case of error - return 422 ('Device definition not found')
5. Validate quantity
Validate value in the field $.quantity, SimpleQuantity type, required.
...
Check current date >= authored_on >= (current date - DEVICE_REQUEST_DELAY_INPUT)
in case of error - return 422 “Authored on date must be in range of <current date> and <current date - DEVICE_REQUEST_DELAY_INPUT>”
Check authored_on comply with the encounter period
check $.authored_on >= $.encounter.period.start and $.authored_on <= $.encounter.period.end
in case of error - return 422 ('Authored on date must be in between of Encounter period start and end')
8. Validate occurrence
Validate value in the field $.occurrence_period, Period type, required.
Check ($.authored_on + DEVICE_REQUEST_EXTENDED_LIMIT_START_DAYS) >= $.occurrence_period.start >= $.authored_on
in case of error - return 422 error ('Start date must be greater than or equal to <authored_on> date, but less than or equal to <authoredOn + DEVICE_REQUEST_EXTENDED_LIMIT_START_DAYS> date')
Check $occurrence_period.end >= $.occurrence_period.start
in case of error - return 422 error ('Occurrence end date must be greater than or equal to start date')
In case based_on passed in request and activity referenced - check that this occurrence period matches with care plan occurrence period:
Get care plan that relates to referenced activity
if care plan activity has detail.scheduled_timing.repeat.bounds_period - validate occurrence within bounds_period
if care plan activity has detail.scheduled_period - validate occurrence within scheduled_period
else - validate occurrence within care_plan.period
in case of error - return 422 error ('Occurrence period of device request must be in range of care plan occurrence period')
9. Validate reason
Validate value in the field $.reason, optional.
Check that reason is an array with References on (condition, diagnostic_report, observation) resource
in case of error - return 422 ('value is not allowed in enum')
Check that each {resource} belongs to the patient ($.subject)
in case of error - return 422 ('{resource} with such id is not found')
Check that status of each {resource} is not "entered_in_error" (for condition verification status should be used)
in case of error - return 422 ("{resource} in status "entered_in_error" can not be referenced")
...
Check the program exists and is active
in case of error - return reject_reason = “Medical program not found”
Check the program is of type DEVICE
in case of error - return reject_reason = “Invalid program type”
Check request_allowed = true for the program
in case of error - return reject_reason = “It is not allowed to create Device requests for the program”
Check there is at least one appropriate participant for a program:
Find program_devices, that:
is active
has device_request_allowed=true
its validity period (start_date and end_date) includes current date
has max_daily_count is null or max_daily_count >= $.quantity.value/(occurence_period.end - occurence_period.start+1)
relates to the Device Definition found at the Validate Device definition step
in case not found - return reject_reason = “No appropriate participants found for this medical program“
Make validation according to medical program settings:
If skip_employee_validation = false (null/absent), then $.requester should be validated:
If employee_types_to_create_request parameteris set, then check if it contains employee type of the requester
in case is not found - return reject_reason = “Employee type of the requester doesn't allow to create Device Request with the medical program”
In case employee type of the requester is SPECIALIST, then additional validations may be performed:
If speciality_types_allowed is set, then check if it contains speciality of the requester (speciality_officio=true):
in case is not found - return reject_reason = "Employee's specialty of the requester doesn't allow to create Device Request with the medical program"
In case employee type of the requester is DOCTOR, then additional validations may be performed:
if skip_request_employee_declaration_verify = false (null/absent), then get declaration by employee_id of the requester, person_id and status=ACTIVE
in case is not found - return reject_reason = "Only doctors with an active declaration with the patient can create Device Request with the medical program"
if skip_request_legal_entity_declaration_verify = false (null/absent), then get declaration by requester's legal_entity_id, person_id and status=ACTIVE
in case is not found - return reject_reason = "Only legal entity with an active declaration with the patient can create Device Request with the medical program"
If conditions_icd10_am_allowed is set and $.encounter has primary diagnosis code from the
eHealth/ICD10_AM/condition_codesdictionary, then check this code is in the conditions_icd10_am_allowed parameterin case is not found - return reject_reason = "Encounter in the request has no primary diagnosis allowed for the medical program”
If conditions_icpc2_allowed is set and $.encounter has primary diagnosis code from the
eHealth/ICD10_AM/condition_codesdictionary, then check this code is in the conditions_icpc2_allowed parameterin case is not found - return reject_reason = "Encounter in the request has no primary diagnosis allowed for the medical program”
If skip_treatment_period = false (null/absent), then:
Get all active/completed Device Requests with $.code or $.code_reference (depending on attribute provided in request), $.medical_program_id, $person_id
If such was found, get the Device Request with the latest occurrence_period.end date and check:
its occurrence_period.end less then $.occurrence_period.start from the request
in case of error - return reject_reason = ”It can be only one active / completed Device Request for the same code and patient at the same period of time”
if its occurrence_period.end greater than or equal to current date, then in addition check:
If occurrence_period of found Device Request is greater than or equal to DEVICE_REQUEST_STANDARD_DURATION, then $.authored_on from the request should be greater then (occurrence_period.ended at - DEVICE_REQUEST_MAX_RENEW_DAYS) of the found Device Request
else $.authored_on from the request should be greater then (occurrence_period.ended at - DEVICE_REQUEST_MIN_RENEW_DAYS)
in case of error - return reject_reason = “It's to early to create new Device Request for such code and medical program”
If request_max_period_day is set, then check if it is not exceeded by the number of days in the $.occurrence_period of the request
if exceeded - return reject_reason = “Occurrence period length exceeds allowed value for the medical program“
if there is parameter device_request_allowed_code_types, then check values in the array:
if it includes
CLASSIFICATION_TYPE- it is allowed to pass $.code in the requestif it includes
DEVICE_DEFINITION- it is allowed to pass $.code_reference in the requestin case of a mismatch between the filled field and the config values - return 422 ("<Device definition/Device classification type> is not allowed to set for this medical program").
If care_plan_required = true, then:
Reference to activity in $.based_on is required
in case of error - return reject_reason = “Care plan activity in based_on is required according to medical program settings”
12. Validate priority
Validate value in the field $.priority, string, optional.
Check that value is in allowed active values from
device_request_prioritydictionary.in case of error - return 422 ('value is not allowed in enum')
13. Validate supporting info
Validate values in the field $.supporting_info, array, optional. Validate each value with the following rules:
Validate that referenced resource is one of the following (diagnostic_report, observation, condition, procedure, encounter, episode, device, device_association)
in case of error - return 422 ("Referenced resource in supporting_info is not allowed")
Validate that entity is not in status "entered_in_error"
in case of error - return 422 ("Entity in status "entered_in_error" can not be referenced")
Check that resource belongs to the patient ($.subject)
in case of error - return 422 ('Referenced resource not found')
14. Validate performer
Validate value in the field $.performer, Reference, optional.
Validate that referenced resource is legal_entity and record with such id exists (is_active = true):
in case of error - return 422 ("Legal entity referenced as performer not found")
Validate that entity status is "ACTIVE" or “SUSPENDED“
in case of error - return 422 ("Legal entity referenced as performer is in invalid status")
15. Validate parameter
Validate values in the field $.parameter, array, optional. Validate each value with the following rules:
Check that value from $.parameter.code is in allowed active values from
device_propertiesdictionary.in case of error - return 422 ('value is not allowed in enum')
Check $.parameter.value[x] is one of the following:
value_codeable_concept,value_quantity,value_boolean,value_range,value_stringin case of value[x] is missing - return 422 ('value must be provided')
in case of more than one value[x] provided - return 422 ('only one value is allowed')
in case of value[x] is provided with incorrect type - return 422 ('value type <type> is not allowed')
Service logic
Generate structure for response
...