Required parameters are marked with "*"

Якщо інформації по відповідному параметру немає, потрібно зазначити: “APIparagraph not found”.

Purpose*

This method adds activity to an existing patient's Care Plan.

...

Logic*

This method adds activity to an existing patient's Care Plan. Method receives signed message (pkcs7) that consists of signed content, digital signature and signer public key. All signature fields will be validated (including signer certificate authority). Service will store signed copy of Care Plan activity in Media Content Storage if all checks is passed.

...

Request to process the request using a token in the headers

Headers*

Наприклад:

• Content-Type:application/json

• Authorization:Bearer F3GF124Df565FDS234SDF34

• api-key:aDGFDFGT46S5gFGD

...

• Check that value is an array with references of condition, observation, diagnostic report or clinical impression types.

  • in case of error - return 422 ('value is not allowed in enum')

• Check that each reference:

  • is valid ME

  • belongs to the patient ($.subject)

    • in case of error - return 422 ('<medical event type> with such ID is not found')

• If $.detail.reason_reference=clinical_impression:

  • Check that clinical impression is valid based on clinical_impression.code.coding.code and CLINICAL_IMPRESSION_PATIENT_CATEGORIES_<CODE.CODING.CODE>_VALIDITY_PERIOD chart parameter: difference between now() and clinical_impression.inserted_at date must be less than a value in chart parameter (pointed in config for a corresponding care plan category) for clinical impression code

    • in case of error - return 422 ("Clinical impression with patient category exceeds validity period")

  • Check that clinical impression is based on active rule engine rule (exists record in rule_engine_rules collection with is_active=true, code.code=clinical_impression.code.coding.code, code.system=clinical_impression.code.coding.system)

    • if true - check that clinical impression still corresponds to configured rule (https://e-health-ua.atlassian.net/wiki/spaces/PCR/pages/16741466119/UPD+Submit+Encounter+Data+Package+modified+EN#Validate-Clinical-impression)

      • in case of error - return 422 (“Clinical impression with patient category does not correspond to rule engine rule“)

    • if false - skip rule validation

5. Goal

Validate value in the field $.detail.goal, if submitted

...

• Check the value is valid reference o employee resource

• Check employee is active and approved

  • Return 422 ('Invalid employee status')

10. Daily amount

Validate value in the field $.detail.daily_amount, if submitted.

• Check activity kind is medication_request

  • Return 422 ('Field is allowed for medication request activities only') in case kind is not medication_request

11. Medical program

Validate field exists for kind = medication_request

...

• Сheck program exists and active

  • in case not found or is_active==false return 404 "Program not found"

• Validate product is program participant:

  • If product is medication - validate that medication has brand that is an active member of the program (program_medications table)

    • in case not found or is_active==false return 422 "Medication is not included in the program"

  • If product is service - validate that service is an active member of the program

    • in case not found or is_active==false return 422 "Service is not included in the program"

  • if product is service_group - validate that service group is an active member of the program

    • in case not found or is_active==false return 422 "Service group is not included in the program"

• Validate medical program settings (prm.medical_programs table):

  • if there is a parameter SPECIALITY_TYPES_ALLOWED:

    • Check author’s speciality is present in SPECIALITY_TYPES_ALLOWED

      • in case of error - return 422 “Author’s specialty doesn't allow to create activity with medical program from request”

  • if there is a parameter CONDITIONS_ICD10_AM_ALLOWED or/and CONDITIONS_ICPC2_ALLOWED:

    • Check related Care plan has condition codes in addresses field that correspond to codes pointed in CONDITIONS_ICD10_AM_ALLOWED or/and CONDITIONS_ICPC2_ALLOWED (depending on dictionary - eHealth/ICD10_AM/condition_codes or eHealth/ICPC2/condition_codes)

      • in case of error - return 422 “Care plan diagnosis is not allowed for the medical program“

  • If there is a parameter PROVIDING_CONDITIONS_ALLOWED:

    • Check related Care plan has a value in terms_of_service field that is included in the list of PROVIDING_CONDITIONS_ALLOWED parameter

      • in case of error - return 422 “Care plan’s terms of service are not allowed for the medical program“

  • if there is a parameter patient_categories_allowed:

    • check that patient_categories_allowed has codes in $.detail.reason_reference.[].clinical_impression.code.[].code that correspond to codes pointed in patient_categories_allowed

      • in case of error - return 422 "Clinical impression with patient category should be present in request for this medical program"

12. Do not perform flag

Validate value in the field $.do_not_perform

...