Updating Findings Using the /findings/{findingId} Endpoint
The /findings/{findingId} endpoint of the Finding and Event Collaboration Integration API for Supplier Risk updates certain data fields in findings.
Context
Finding and Event Collaboration uses the PUT /findings/{findingId} endpoint to update the status, creation and due date, and residual risk information in a finding in your SAP Ariba Supplier Risk site.
Procedure
- A finding creator creates a finding.
- Users with different roles in the finding update it and it moves to different statuses.
- The PUT /findings/{findingId} endpoint transfers data in specific fields between Finding and Event Collaboration and your site.
Example:
PUT {{runtime_URL}}/findings/1234567&realm=mySite { "parentContextId": "WS1900658", "parentSubContextId": "", "parentSubContextType": "", "parentServiceId": "", "findingStatus": "Complete", "createdAt": "2022-07-28 18:30:30", "dueDate": "2022-12-29 18:30:30", "smVendorId": "S1000000", "residualRisk": 3, "residualRiskStr": "High" }Request Body Parameters Name
Required?
Description
parentContextId
No
The unique ID of an engagement project associated with the finding, if the finding is associated with an engagement.
parentSubContextId
No
The unique ID of the control associated with the finding, if the finding is associated with a control.
parentSubContextType
No
The type of the control associated with the finding, if the finding is associated with a control.
parentServiceId
No
The commodity (service) codes of the service control associated with the finding, if the finding is associated with a service control.
findingStatus
No
Valid values are:
-
Draft
-
New
-
In Validation
-
Invalid
-
In Analysis
-
In Response Review
-
In Response Approval
-
Completed
createdAt
No
The timestamp of the finding's creation in the format YYYY-MM-DD HH:MM:SS.
dueDate
No
The due date for the finding in the format YYYY-MM-DD HH:MM:SS.
smVendorId
Yes
The SM vendor ID of the supplier associated with the finding.
residualRisk
No
The unique ID of the risk classification associated with the finding's residual risk, which is a number between 1 and 5.
residualRiskStr
No
The name associated with the unique residual risk classification, which is defined in your site's risk classification data.
The request returns an error code indicating success or failure of the update operation.
-