Use of the Supplier Data API with Pagination answers Endpoint
The Supplier Data API with Pagination answers endpoint uses the POST method to send a JSON post to your site to update specific answers in supplier management questionnaires. The post specifies authentication in the header.
|
Method |
Endpoint |
Pagination |
Description |
|---|---|---|---|
|
POST |
{{runtime_URL}}supplierdatapagination/v4/prod/vendors/{SM VendorID}/workspaces/{workspace id}/questionnaires/{questionnaire id}/answers |
N/A |
Posts answers to questions in the specified questionnaire in the specified project for the specified supplier. |
-
For external (supplier-facing) questionnaires, the post can update an answer in any questionnaire that the supplier isn't currently acting on. This restriction always applies to external registration and qualification questionnaires, and is the default behavior for external modular questionnaires. If the supplier is currently acting on the questionnaire, updates to it return a statusCode of 403 (Forbidden). A supplier is considered to be acting on a questionnaire under the following conditions:
Condition
Registration Status
Qualification Status
Modular Supplier Management Questionnaire Status
The supplier has been invited to fill out the questionnaire and sent an email notification with a link to it.
Invited
Qualification Started
Not Responded
The supplier has opened the questionnaire but hasn't yet submitted it.
In Registration
In Qualification
Pending Submission
The supplier has reopened the questionnaire after an approver has requested additional information.
Pending Resubmit
Pending Qualification Resubmit
Pending Resubmission
The self-service configuration parameter Enable API updates for external modular questionnaires with any status controls this restriction for external modular questionnaires. An administrator in your site can manage this parameter in Intelligent Configuration Manager. If this parameter is set to Yes, the post can update answers to external modular questionnaires in any status, including prepopulating newly created questionnaires with answers from other systems.
-
For internal questionnaires, the post can update an answer in any questionnaire regardless of whether or not an internal user is currently editing it.
The updates posted using the answers endpoint show in your site as updates by the aribasystem system user. For any individual external registration or modular supplier management questionnaire, the answers included in a single POST operation are added to the questionnaire as a single updated version of the questionnaire. Users comparing versions of the questionnaire in your site see the updates made using this API as separate, numbered versions in the user interface alongside updates made by the supplier or internal questionnaire editor.
By default, updates made using this API don't trigger any approval tasks associated with the questionnaire. For modular questionnaires and registration questionnaires only, if the update request body includes a triggerApprove attribute of true, the update starts any approval tasks associated with the current phase of the questionnaire and proceeds through the approval flow configured in those tasks in the same way as a manual questionnaire update. If the triggerApprove attribute is false, or if the questionnaire isn't a modular questionnaire or a registration questionnaire, no approval tasks are triggered.