Status
Purpose
This WS is design to update flags "is_active" for Medical Program.
APIary
Input parameters
- id
Authorize
- Verify the validity of access token
- Check user scope (scope = 'medical_programs:write') in order to perform this action
- In case error - generate 401 response
Validate FKs
Purpose validation: Check on active program medication. Only medical program without active program medication can be deactivated. In case on existing active program medication error must be shown.
- Check exist `program medication` by $.id & `is_active`=false
- if invalid - return 409 error (message: "There are active participants on this program. Only medical programs without participants can be deactivated.")
Validate PK Program Medications
Purpose validation: Check on existing record for Medical program
Check exist `Medical_program` by $.id.
if invalid - return 404 error (message: "Medical program with id={id} doesn't exist.")
Validate status
Purpose validation: Medical program should be active (is_active == TRUE)
- Validate `is_active` == TRUE
- if invalid - return 409 error (message: "Medical program is not active and can't be deactivated again")
Deactivate Program Medications
Update medical program record by $.id set values:
Destination | Source |
---|---|
is_active | FALSE |
updated_at | :timestamp |
updated_by | user_id |
Prepare & return response data structure
- Fill response WS data structure
- Validate response using JSON schemas (!!! TBD)
- Return 422 with list of validation errors in case validation fails (422 EView)