Skip to main content

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

  1. The User must be authenticated and have the Organisation Administrator role.
  2. The User must have an approved/rejected record that belongs to his organisation and that he wants to un-approve/reject

Postconditions

  1. The System rolls back the approval/rejection.

Main flow

  1. The Organisation Administrator retrieves a record marked as approved/rejected that belongs to his organisation.
  2. The Organisation Administrator un-approves/rejects the record.
  3. The system validates the request parameters.
  4. 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.

[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.