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

  1. A finding creator creates a finding.
  2. Users with different roles in the finding update it and it moves to different statuses.
  3. 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.