4.26. Organisation Administrator - Un-reject/approve an approved/rejected record lined to organisation
| Id | 4.26. |
| Description |
As an Organisation Administrator
I need to be able to un-approve/reject a record belonging to my organisation that was unintentionally rejected/approved.
So that I can rollback invalid changes and allow the approvers to correct their mistakes. |
| Priority | Medium |
| Actors | Organisation Administrator |
| API Calls | POST /phyiscal-links/<physical_link_id>/reset-approval/ |
| Linked Processes | |
| Status | Implemented |
Preconditions
- The User must be authenticated and have the Organisation Administrator role.
- The User must have an approved/rejected record that belongs to his organisation and that he wants to un-approve/reject
Postconditions
- The System rolls back the approval/rejection.
Main flow
- The Organisation Administrator retrieves a record marked as approved/rejected that belongs to his organisation.
- The Organisation Administrator un-approves/rejects the record.
- The system validates the request parameters.
- The system rolls back the approval/rejection.
Exceptions
[400 Bad Request] Invalid input:
If mandatory fields are missing or invalid, the system returns an error message.
[400 Bad Request] Record already approved / un-approved:
If the user tries to approve a record that is already approved an error is returned.
[404 Not found] Data not found
If the Organisation Administrator attempts to un-approve/reject a resources that does not exist or does not belong to his organisation, the system will return an error.
[409 Not approved/reject] Data not marked as approved or rejected
If the Organisation Administrator attempts to rollback a resources that is not marked as approved or rejected, the system will return an error.
[500 Internal Server Error] System Error
If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.