Retrieving Change-Request Information Using the Order Change Requests API for Buyers

Use this procedure to gather change request information sent by your suppliers.

Prerequisites

To create an application and request access to use this API, you must have access to the SAP Ariba Developer Portal. For details, see Steps to Start Using the SAP Ariba APIs in the SAP Ariba developer portal guide.
You must configure the API client ID in SAP Business Network for buyers. For more details see, Configuring the API Client ID in SAP Business Network for Buyers.

Context

You can retrieve from SAP Business Network information in change requests, change request responses, and change request confirmations for your suppliers.

Procedure

Identify which type of information is desired:
- Change requests (/changeRequests), change-request responses (/changeRequestResponses), or change-request confirmations (/changeRequestConfirmations)
- Either header or item information
Construct a filter list to specify what information to retrieve.

For details and an example, see Filter Construction for the Order Change Requests API for Buyers.
Request a count of the desired change request information by including $count=true in your filter list.
Sample Code
```
GET {{runtime_url}}/endpoint?$filter=filter_list&$count=true&$orderby=value&$top=value&$skip=value
                  
```
Note

In the sample code, replace {{runtime_url}} with the desired runtime URL from the Environment Details table on the SAP Ariba Developer Portal discovery page for this API.
A successful query returns the number of records that match the specified filter criteria.

If the query is unsuccessful, the response includes an error message. See Error Messages Returned by the Order Change Requests API for Buyers for a list of error messages specific to this API.
If the count indicates the need for a more detailed inquiry, request the desired information.
Parse or format the response data as needed.

Note

This step is not performed using the API. It can be executed programmatically or by hand, as you prefer.