Apply decision reasons to assessments

Standardized decision reasons can be applied to individual or company assessments. You can apply multiple reasons to an assessment.

Prerequisites

Your institution is using policy versioning. If you're not using policy versioning, contact us to set this up.
Once a user has set up a standardized list of decision reasons and assigned them to an assessment, you can apply these to your assessment outcomes.

Apply a decision reason to an assessment

Once all the tasks have been completed for an assessment, you need to pass or fail it. When you are reviewing an assessment, you may need to manually accept or reject it. If your institution uses policy versioning, you can apply a pre-determined reason to your assessment's outcome. If you are not yet using policy versioning, you can use a different method to pass, fail, or cancel an assessment.

If you fail or cancel a company's assessment, you should also fail/cancel the assessments for the related associates. If you don't, the associates' entities will stay in ongoing monitoring.

To apply a decision reason to an assessment:

Go to the entity.
Select Assessment overview or an individual assessment.
Select either the Pass button or the Fail button, based on your review of the assessment.
Note
If it’s not possible to select Pass, one or more of the assessment’s tasks are incomplete or failed. All tasks must be passed before the assessment can be passed.
When you select the button, a drop-down menu appears.
From the menu, choose one or more reasons for your decision. Optionally, add a comment to explain or support your decision.
Select the Pass assessment or Fail assessment button.
If you're failing an assessment, at least one reason must be given for your failure.
The outcome of the decision reason appears in your audit history.
If it’s a previously passed assessment, select Cancel.

Apply a decision reason to an assessment from the API

To get the full list of decision reasons that are available to you:

Get all the information about a specific assessment from the API with a GET request to the following endpoint:
```
GET https://api.eu.maxsight.com/4.0/profiles/{profile_id}/applications/{application_id}
```
From the response, find the decision reasons attribute inside the product attribute. The decision reasons attribute contain a list of decision reasons.

Make a POST request to the following endpoint:

POST https://api.eu.maxsight.com/4.0/profiles/{profile_id}/applications/{application_id}

Use the following body example to pass an assessment with a standardized decision reason. This updates the assessment's outcome with the decision reasons in the body, ["reason_1", "reason_2"].
```
{
"status": "APPROVED",
"decision_reasons": ["reason_1", "reason_2"]
}
```

Revert a decision using a decision reason

Once you have passed or failed an assessment, you may need to revert your decision. Note that if the assessment has been automatically passed, it can’t be reverted, it can only be canceled.

To revert your decision:

Go to the entity.
Select the Assessment overview section.
Find the assessment and select the active button. If the assessment has been passed, the active button label is Passed.
Select the Revert decision button from the dialog box that appears.

The assessment is returned to its previous state. If the assessment was previously new, it resumes the onboarding process. If the assessment was previously passed, the monitoring process resumes.

Caution

If you revert a decision to fail or cancel an assessment, ongoing monitoring for the PEPs and sanctions screening, Sanctions and adverse media screening, or Merchant fraud check will only restart automatically if you have them configured as automatic checks. To restart ongoing monitoring manually, run the checks manually.

To revert a decision reason from the API

POST https://api.eu.maxsight.com/4.0/profiles/{profile_id}/applications/{application_id}/revert_decision

The assessment is reset to its previous state without a comment or decision reason.

Additional information

In this section: