Page Comparison

...

The target status value must be submitted in the order of display in the signed content (media storage)

1. Validate $.status isIN_PROGRESS if there are program specified in the dispense , else

   1. in case status is COMPLETED - return 409 ("Status is not allowed for Device dispense with Medical program")

   2. else - return 422 ("value is not allowed in enum")

2. Validate $.status is COMPLETED if no program specified

   1. in case status isIN_PROGRESS - return 409 ("Status is not allowed for Device dispense without Medical program")

   2. else - return 422 ("value is not allowed in enum")

Validate Device request

Validate value in the field $.based_on ($.based_on.identifier.value), Reference on device request, required.

• Check that device request exists and has ACTIVE status

  • in case of error - return 422 ('Device request not found')

• Check that intent specified in Device request is order

  • in case of error - return 409 error ('Only device request with intent = 'order' can be dispensed')

• If medical_program specified in the Device dispensecheck that dispense_valid_to (whole day - time must be ignored) is greater or equal to current date

  • in case of error - return 409 ('Device request is expired for dispense')

Validate related Care plan

Verify care plan Care Plan and Activity as described in https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17782015072#Validate-related-Care-plan

...

• Check that program in dispense is the same as program in device request or empty on both sides(request.program.identifier.value = device_requests.program.identifier.value)

  • in case of error - return 409 ('Program in dispense doesn't match the one in device request')

• Check that program exists in DB

  1. in case of error - return 422 ('Medical program not found')

• Сheck that program has is_active set in true and status is 'ACTIVE'

  1. in case of error - return 422 error ('Medical program is not active')

• If the medical program has no setting skip_contract_provision_verify or it is set in false/null validate:

  • Check $.division participates in submitted program. Validate Provision for the medical program:

    • Medical program in the request has funding_source = NHS

      1. In case of error - return reject_reason = "Program was configured incorrectly - incorrect source of funding"

    • Provision exist and active, relates to the $.location and to the actual reimbursement contract: contract.start_date <= current_date <= contract.end_date, is_active = true, status = VERIFIED, contracts.type==reimbursement, contracts.contractor_legal_entity_id=token.client_id, contracts.medical_program_id==$.medical_program_id

      1. in case of error - return reject_reason = "Medical program provision is not related to any actual contract for the current date"

    • Сontract is_suspended = false

      1. in case of error - return reject_reason="Contract with number <contract_number> is suspended"

  else if skip_contract_provision_verify = true, then skip provision verification for the medical program

• If the medical program has no setting skip_dispense_division_dls_verify or it is set in false/null validate:

  • Check $.division.dls_verify == true:

    • In case of error - return 409 "Division is not verified in DLS"

  else if skip_dispense_division_dls_verify = true, then skip license verification for the division

Validate when_handed_over

• If medical_program not specified in the Device dispense validate when_handed_over

  • check that when_handed_over is greater or equal to Device request. authored_on and less or equal to current date

    • in case of error - return 409 error ('Invalid dispense period')

Validate Dispense details

If Medical program($.program) is specified in the Device dispense, check that details.device is present in the Device dispense, not details.device_code

• in case of error - return 409 ('Dispense with device code is not allowed for Device dispenses with a medical program')

Validate device

• Check device (device definition) to be dispensed ($.details.device)

  • Check code ($.details.device.identifier.type.coding.code) = device_definition

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

  • Get device definition by id ($.details.device.identifier.value)

    • device_definition.is_active = true

      • in case of error - return 422 ('Device definition not found')

  • Check that this device definition is compliant with prescribed device

    • If device request contains reference to a device definition in device_request.code_reference

      • Check that device_definition_id in dispense is equal to device_definition_id in the request

    • If device request contains device_request.code

      • Check that device_definition.classification_type is equal to prescribed device definition code in device request (device_request.code)

    • in case of error - return 422 ('Dispensed device doesn’t match with prescribed device')

  • Check that packaging_unit matches with quantity.code of the Device Request

    • in case of error - return 422 (Dispensed packaging unit doesn’t match with prescribed packaging unit)

  • Check the remainder of the division ($.details.quantity.value/device_definition.packaging_count) is equal to 0

    • in case of error - return reject_reason = “The quantity must be divisible to packaging_count of prescribed Device Definition”

Validate device_code

• Check device_code to be dispensed ($.details.device_code)

  • Check system($.details.device_code.coding.system) = device_definition_classification_type

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

  • Get device_code from the dictionary device_definition_classification_type ($.details.device_code.coding.code) and check parameter is_active = true

    • in case of error - return 422 ('Device code not found')

  • Check that this device code is compliant with prescribed device code:

    • Check device_request.code_reference is not present in the request

      • return an error 422 ('Dispense with device code is not allowed, since the prescription is for device or device definition ')

    • Check device_request.code is equal to device_dispense.device_code

      • in case of error - return 422 ('Dispensed device code doesn’t match with prescribed device code')

Validate program device

• Check program device

  • Is applicable only if program was passed to request and program device passed to request

    • Check code ($.details.program_device.identifier.type.coding.code) = program_device

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

    • Check that program device exists in DB and has is_active=true

      • in case of error - return 422 ('Program device not found')

    • Check that program device has validity period (start_date and end_date) within current date

      • in case of error - return 422 ('Program device is not active')

    • Check that program device relates to the device definition in $.details.device

      • in case of error - return 422 ('Program device doesn’t match with device')

    • Check that program device relates to the program in $.program

      • in case of error - return 422 ('Program device doesn’t match with program')

  • if program was passed to request and no program device specified

    • find program device related to dispensed device definition and selected program with:

      • active status

      • validity period (start_date and end_date) within current date

        • in case not found - return 422 ('No appropriate participants found for this medical program')

        • in case found more then one - return 422 ('More than one program_device was found. Specify the required in the request')

...

Perform the validation if Device request has quantity

• Validate quantity value

  • If Medical program is specified:

    • Check that dispensed device quantity is equal prescribed quantity in Device Request

      • sum($.details.quantity.value) == device_request.quantity

      • in case of error - return 422 ('Dispensed quantity must be equal to prescribed quantity in Device Request')

  • If Medical program is not specified:

    • Check that dispensed device quantity is equal or less then remaining_quantity in Device Request:

      • Select all Device dispenses in status completed related to the Device request

      • Sum quantity in the filtered Device dispenses as dispensed_quantity

      • Calculate remaining_quantity = requested_quantity- dispensed_quantity

        • in case of error - return 422 ('Dispensed quantity must be equal or less then prescribed remaining quantity in Device Request')

• Validate quantity units

  • Check that quantity.code matches with packaging_unit of the device_request

    • in case of error - return 422 (Does not match the packaging unit of the prescribed device)

...

Validate verification code

• This validation must be done only if medical_program is specified in the request($.program)

  • Check that $.verification_code in request is equal to verification_code in device_request

    • In case code exists in request - it should match with code in device_request

      • in case of error - return 403 (message: “Incorrect code“)

...

• Fill in the following fields:

  • status = IN_PROGRESS if there are program specified in the dispense OR

  • status = COMPLETED if no program specified

  • status_reason = null

  • subject. Set hashed patient_id from URL

  • performer_legal_entity. Set client_id from token

  • details.quantity.unit. Set description according to quantity code and system

  • details.reimbursement_amount. Set calculated above allowed_reimbursement_amount from program_medication if program is present.

  • inserted_at. Set current date and time

  • updated_at. Set current date and time

  • inserted_by. Set current user from token

  • updated_by. Set current user from token

  • origin_episode_id. Set context_episode_id from device request referenced in based_on

• If Device dispenses status is changed to completed and related Device request has a reference on an Activity as device_request.based_on, then

  • add the reference on the Device dispense resource to the outcome_reference attribute of the related Activity

  • if Activity.status is scheduled change it to in_progress

• If there are no Medical program specified in Device dispense AND there is quantity specified in Device request:

  1. calculate remaining quantity of the related Device request (same as on [UPD] Get Device request details | Service logic):

     1. Select all Device dispenses in status completed related to the Device request

     2. Sum quantity in the filtered Device dispenses as dispensed_qty

     3. Calculate remaining_quantity = Device_request.quantity- dispensed_quantity

  2. If remaining_quantity is equal to Device_dispense.quantity, change status of the related Device request($.based_on) to completed

• Save data to device_dispenses collection in MongoDB according to RС_[UPD] Device dispense data model

• Send StatusChangeEvent to Event Manager