Supplier Risk Aware Feed API (/supplier_risk_aware_feed)

Use the Supplier Risk Aware Feed API to load your governance, risk, and compliance (GRC) data into Risk Aware.

The Supplier Risk Aware Feed API lets you load your governance, risk, and compliance (GRC) data into Risk Aware.

The URL to access Order Lists is: https://{your_instance}/api/supplier_risk_aware_feed/

Note

To use this API, you'll need to create an API key that includes the Supplier Risk Feed permissions. See API Key Security for more info.

Actions

The Supplier Risk Aware Feed API allows you to:

Verb Path Action Description
POST /api/supplier_risk_aware_feed create Create a new Supplier Risk Feed for a specific supplier
GET /api/supplier_risk_aware_feed index Get a list of Supplier Risk Feeds
GET /api/supplier_risk_aware_feed/:id show Get a specific Supplier Risk Feed
PUT /api/supplier_risk_aware_feed/:id update Update a specific Supplier Risk Feed

You can get a feed for a supplier, even if you don't know the ID of the feed by querying by supplier[id] , supplier[name] , or supplier[number] .

Elements

The Supplier Risk Aware Feed API contains the following elements:

Element Description Req'd Unique Allowable Value In Out Data Type
created-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ yes datetime
id Coupa unique identifier yes integer
number-field-01 Number field 1. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-02 Number field 2. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-03 Number field 3. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-04 Number field 4. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-05 Number field 5. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-06 Number field 6. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-07 Number field 7. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-08 Number field 8. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-09 Number field 9. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
number-field-10 Number field 10. At least one number field is required. decimal or nil=true yes yes decimal(32,4)
supplier When performing a POST specify any one of these supplier elements id , name , or number . to positively identify the supplier. yes yes Supplier
updated-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ yes datetime

To set a number field to nil, use nil=true in the number field attribute. For example: <number-field-01 nil="true"/> . This is handy when you want to delete a value.

Sample payloads

GET a feed for a specific supplier

You can get a feed for a supplier, even if you don't know the ID of the feed by querying by supplier[id] , supplier[name] , or supplier[number] .

Example query

GET https://{your-instance}/api/supplier_risk_aware_feed?supplier[name]={name of the supplier in Coupa}

Example response

<?xml version="1.0" encoding="UTF-8"?>
<supplier-risk-aware-feeds type="array">
		<supplier-risk-aware-feed>
				<id type="integer">22</id>
				<created-at type="dateTime">2019-03-05T08:12:26+13:00</created-at>
				<updated-at type="dateTime">2019-03-05T08:12:26+13:00</updated-at>
				<number-field-01 nil="true"/>
				<number-field-02 type="decimal">4.1235</number-field-02>
				<number-field-03 type="decimal">1.1111</number-field-03>
				<number-field-04 type="decimal">1.0</number-field-04>
				<number-field-05 type="decimal">1.0</number-field-05>
				<number-field-06 type="decimal">1.0</number-field-06>
				<number-field-07 type="decimal">1.0</number-field-07>
				<number-field-08 type="decimal">1.0</number-field-08>
				<number-field-09 type="decimal">1.0</number-field-09>
				<number-field-10 type="decimal">1.0</number-field-10>
				<supplier>
					 ...
				</supplier>
		</supplier-risk-aware-feed>
</supplier-risk-aware-feeds> 

POST a new feed

You can create a new feed for a supplier by specifying one of <id> , <name> , or <number> . A given supplier can only have one Risk Aware feed.

Example query and payload

POST https://{your-instance}/api/supplier_risk_aware_feed
<?xml version="1.0" encoding="UTF-8"?>
<supplier-risk-aware-feed>
		<number-field-01 nil="true"/>
		<number-field-02 type="decimal">4.1235</number-field-02>
		<number-field-03 type="decimal">1.1111</number-field-03>
		<number-field-04 type="decimal">1.0</number-field-04>
		<number-field-05 type="decimal">1.0</number-field-05>
		<number-field-06 type="decimal">1.0</number-field-06>
		<number-field-07 type="decimal">1.0</number-field-07>
		<number-field-08 type="decimal">1.0</number-field-08>
		<number-field-09 type="decimal">1.0</number-field-09>
		<number-field-10 type="decimal">1.0</number-field-10>
		<supplier>
				<id>{Coupa's ID for the supplier}</id>
				<name>{the name of the supplier}</name>
				<number>{the supplier number}</number>
		</supplier>
</supplier-risk-aware-feed>

The response to a POST or PUT is the same as a GET.

Related Items


Invoices API (/invoices)

13 May 2022

Use the invoice API to create, update, or query invoices associated with a purchase order.

Invoices Import

26 January 2023

The invoice loader has header columns, charge columns, line columns, line allocation columns and tax columns.

Custom Field Namespace

18 April 2019

All new custom-fields are added to a custom-field namespace  to avoid name conflicts and to make customer-added fields more easily identifiable.

Sourcing API (/quote_requests)

03 September 2021

Use the Coupa Sourcing API to create new RFx events, see supplier responses, and award suppliers at the line level.