Manage Supplier Qualification Question Responses

You use Supplier Qualification Question Responses REST resource to create, query, and update question responses for a valid supplier and supplier site combination without creating an initiative and questionnaire.

Here's a typical application processing flow for the scenarios:

  1. You create a question response
  2. You query existing question response
  3. You update the question response

Let's discuss these scenarios:

  1. Create a question response
  2. Update a question response

Create a Question Response

Create a Question Response

Example URL

Use this resource URL format.

POST

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' 
https://servername/fscmRestApi/resources/version/supplierQualificationQuestionResponses

Example Request

Here's an example of the request body in JSON format.

{
	"Question": "Annual Revenue",
	"Supplier": "Chile Foods",
	"AcceptedBy": "Smith,Cody",
	"values" : 
	[ {
		"ResponseValueText": "12M"
	} ]
}

Example Response

Here's an example of the response body in JSON format. When the response is submitted, the response status changes to Processing.

{
	"Question": "Annual Revenue",
	"Supplier": "Chile Foods",
	"ResponseDate": "2019-05-14T18:20:59.164+00:00",
	"ResponseRepositoryId": 300100177300850,
	"ResponseStatus": "Processing",
	"FirstSubmissionDate": "2019-05-14T18:20:59.164+00:00",
	"ResponseArchiveDate": null,
	"AcceptanceDate": "2019-05-14T18:20:59.165+00:00",
	"AcceptedBy": "Smith,Cody",
	"ResponderType": "Supplier",
	"values": [{
		"ResponseRepositoryValueId": 300100177300851,
		"ResponseRepositoryId": 300100177300850,
		"ResponseValueText": "12M",
		...
	}]
}

Get the Latest Status

In this scenario, you query for the latest status of the question response after the processing is completed. The response status can either be Active, Discarded, or Archived.

Example URL

Use this resource URL format.

GET

curl -u username:password https://servername/fscmRestApi/resources/version/supplierQualificationQuestionResponses/?q=Question= Annual Revenue; Supplier='Chile Foods'

Example Response

If the response has different response values and attachments than the existing response, the status of the new response becomes Active while the status of the existing one becomes Archived. Here's an example of the response body in JSON format.

{
	"items": [{
		"Question": "Annual Revenue",
		"Supplier": "Chile Foods",
		"ResponseDate": "2019-05-14T18:20:59.164+00:00",
		"ResponseRepositoryId": 300100177343791,
		"ResponseStatus": "Active",
		"FirstSubmissionDate": "2019-05-14T18:20:59.164+00:00",
		"ResponseArchiveDate": null,
		"AcceptanceDate": "2019-05-14T18:20:59.165+00:00",
		"AcceptedBy": "Smith,Cody",
		"DataSourceType": "REST service",
		"ResponderType": "Supplier",
		"OriginalQuestionId": 300100177080767,
		...
	}, {
		"Question": "Annual Revenue ",
		"Supplier": "Chile Foods",
		"ResponseDate": "2019-05-14T06:31:19.937+00:00",
		"ResponseRepositoryId": 300100177329411,
		"ResponseStatus": "Archived",
		"FirstSubmissionDate": "2019-05-14T06:27:11.112+00:00",
		"ResponseArchiveDate": "2019-05-14T18:21:09+00:00",
		"AcceptanceDate": "2019-05-14T06:31:19.938+00:00",
		"AcceptedBy": "Smith,Cody",
		"DataSourceType": "REST service",
		"ResponderType": "Supplier",
		"OriginalQuestionId": 300100177080767,
		...
	}
}

Example Response

If the response has the same response values and attachments as the existing response, the status of the new response is set to Discarded. The status of the existing response remains as Active and these attributes are updated based on the new response: Acceptance Date, Acceptance Note, Accepted By, Response Date, Internal Responder and Supplier Contact. Here's an example of the response body in JSON format.

{
	"items": [ {
		"Question": "Annual Revenue",
		"Supplier": "Chile Foods",
		"ResponseDate": "2019-05-14T18:38:56.306+00:00",
		"ResponseRepositoryId": 300100177343791,
		"ResponseStatus": "Active",
		"FirstSubmissionDate": "2019-05-14T18:20:59.164+00:00",
		"ResponseArchiveDate": null,
		"AcceptanceDate": "2019-05-14T18:38:56.306+00:00",
		"AcceptedBy": "Smith,Cody",
		"DataSourceType": "REST service",
		"ResponderType": "Supplier",
		"OriginalQuestionId": 300100177080767,
		...
	}, {
		"Question": "Annual Revenue",
		"Supplier": "Chile Foods",
		"ResponseDate": "2019-05-14T18:38:56.306+00:00",
		"ResponseRepositoryId": 300100177343795,
		"ResponseStatus": "Discarded",
		"FirstSubmissionDate": "2019-05-14T18:38:56.306+00:00",
		"ResponseArchiveDate": null,
		"AcceptanceDate": "2019-05-14T18:38:56.306+00:00",
		"AcceptedBy": "Smith,Cody",
		"DataSourceType": "REST service",
		"ResponderType": "Supplier",
		"OriginalQuestionId": 300100177080767,
		...
	}
}

Update a Question Response

If you know that the response has the same response values and attachments as the existing response, you can use the PATCH operation to update these attributes for the existing response: Acceptance Date, Acceptance Note, Accepted By, Response Date, Internal Responder, and Supplier Contact.

Example URL

Use this resource URL format.

PATCH

curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload'  https://servername/fscmRestApi/resources/version/supplierQualificationQuestionResponses/300100177300846

Example Request

Here's an example of the request body in JSON format.

{
	"ResponseDate": "2019-05-13T18:52:15.458+00:00",
	"AcceptanceDate": "2019-05-13T18:52:16.500+00:00",
}

Example Response

Here's an example of the response body in JSON format.

{
	"Question": "Annual Revenue",
	"Supplier": "Chile Foods",
	"ResponseDate": "2019-05-13T18:52:15.458+00:00",
	"ResponseRepositoryId": 300100177300846,
	"ResponseStatus": "Active",
	"FirstSubmissionDate": "2019-05-13T18:51:34.439+00:00",
	"ResponseArchiveDate": null,
	"AcceptanceDate": "2019-05-13T18:52:16.500+00:00",
	"AcceptedBy": "Smith,Cody",
	"DataSourceType": "REST service",
	"ResponderType": "Supplier",
	"OriginalQuestionId": 300100177080767,
	...
}