Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Removed

Table of Contents

Image Added

Requirements

  1. Deprecated - Використання направлення

Specification

  1. Use service request

Validations

Authorization

  • Verify the validity of access token
    • Return (401, 'unauthorized') in case of validation fails
  • Verify that token is not expired
    • in case of error - return (401, 'unauthorized')
  • Check user scopes in order to perform this action (scope = 'service_request:use')
    1. Return (403, 'invalid scopes') in case of invalid scope(s)

Validate request using JSON Schema

Return 422 with the list of validation errors in case validation fails

Validate service request

Only active and unused (released) service request can be used

  1. Get service request by ID
  2. Service request must be active
    1. $.status  == "active"
      1. in case of error return 409 "Invalid service request status"
  3. Service request must be unused
    1. $.used_by is empty object
      1. in case of error return 409 "Service request is already used"

Validate used_by_employee

Employee to whom service request is assigned must belong to the same legal entity as the requestor

  1. Get token metadata
    1. Extract user_id, client_id, client_type
  2. Ensure that employee belongs to client
    1. $.used_by.identifier.type.coding[*].system == "eHealth/resources"
    2. $.used_by.identifier.type.coding[*].code == "employee"
    3. $.used_by.identifier.value must belong to client_id (prm.employees.legal_entity_id == :client_id)
      1. in case of error return 422 "You can assign service request only to employee within your legal entity"
  3. Check employee_type - only DOCTOR can use service request
    1. employee_type == DOCTOR
      1. in case of error, return 422 "Invalid employee type. Only doctor can use service request"


Validate program

  1. validate by json schema
  2. validate id is real medical program in prm and type='SERVICE'
    1. in case error return 422, "Medical program with id $id is not found"
  3. validate medical program is_active=true
    1. in case error return 422, "Medical program with id $id is not active"

Validate used_by_division

  1. if SR.category = hospitalization
    1. validate used_by_division is sent, in case error return 422, "Division is mandatory for $category category"
    2. validate used_by_division.legal_entity_id = used_by_legal_entity_id
  2. Is SR.category = transfer_of_care
    1. validate used_by_division is sent, in case error return 422, "Division is mandatory for $category category"
    2. Validate $division.legal_entity_id = SR.Performer, in case error return 422, "Patient is transferred to another legal entity"

Qualify service request

  1. if medical program exists in request 
    1.  invoke qualify for medical program in in use request
  2. if not exists
    1. invoke qualify in SR, if it is in SR

Service logic

  1. Update service request attributes
    1. Set Medical Events DB: service_requests[<id>].used_by_legal_entity = Request: $.used_by_legal_entity
    2. if medical program exists in request
      1. Set Medical Events DB: service_requests[<id>].medical_program = Request: $.medical_program.identifier.value