1. REST API for Oracle Fusion Cloud Procurement
  2. Tasks
  3. Supplier Initiatives

Create one initiative

post

/fscmRestApi/resources/11.13.18.05/supplierInitiatives

Request

Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Evaluation Due Date
    Date when the assessment was due for evaluation.
  • Title: Assessment Owner
    Maximum Length: 240
    Name of the assessment owner.
  • Value that uniquely identifies the owner of the assessment.
  • Attachments
    Title: Attachments
    The Attachments resource manages the attachments.
  • Title: Automatically Accept Responses
    Maximum Length: 1
    Value that indicates whether to accept questionnaire responses automatically or not. Contains one of the following values: true or false. If true, then the questionnaire response is automatically accepted. If false, then the qualification manager has to manually accept the response. The default value is false.
  • Title: Automatically Populate Responses
    Maximum Length: 1
    Value that indicates whether to default responses from response repository or not. Contains one of the following values: true or false. If true, then the response from repository is default on the questionnaire. If false, then the response does not default on the questionnaire. The default value is false.
  • Value that uniquely identifies the user who canceled the initiative.
  • Title: Canceled Reason
    Maximum Length: 1000
    Reason for cancellation of the initiative specified by the user.
  • Maximum Length: 80
    Abbreviation that identifies the creation source of initiative. A list of accepted values is defined in the lookup type ORA_POQ_CREATION_SOURCE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Description
    Maximum Length: 250
    Description of the initiative entered by the user.
  • Flexfields for Initiatives
    Title: Flexfields for Initiatives
    The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
  • Evaluation Team Members
    Title: Evaluation Team Members
    The Evaluation Team Members resource gets the evaluation team members on an initiative.
  • Title: Initiative
    Maximum Length: 30
    Number that is assigned to the initiative.
  • Title: Cancellation Date
    Date and time when the initiative was canceled.
  • Title: Completion Date
    Date and time when the initiative was completed.
  • Value that uniquely identifies the initiative.
  • Title: Initiative Owner
    Maximum Length: 240
    Name of the initiative owner.
  • Value that uniquely identifies the owner of the initiative.
  • Title: Internal survey
    Maximum Length: 1
    Default Value: false
    Contains one of the following values: true or false. If true, the initiative is of type survey and allows responses from multiple internal responders to be used for evaluation of the qualification. If false, the initiative allows responses from a single responder. The default value is false.
  • Title: Initiative Type
    Maximum Length: 80
    Value that identifies the type of initiative.
  • Maximum Length: 30
    Abbreviation that identifies the type of initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_TYPE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Internal Note
    Maximum Length: 4000
    Internal notes for the initiative entered by the user.
  • Title: Last Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an internal response that was overdue for the initiative.
  • Title: Last Supplier Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an external response that was overdue for the initiative.
  • Title: Launch Date
    Date and time when the initiative was launched.
  • Title: Procurement BU
    Maximum Length: 240
    Name of the procurement business unit associated with initiative.
  • Value that uniquely identifies the procurement business unit associated with the initiative.
  • Qualification Areas
    Title: Qualification Areas
    The Qualification Areas resource gets the qualification areas on an initiative.
  • Title: Qualification Model
    Maximum Length: 80
    Name of the qualification model for assessment initiative.
  • Value that uniquely identifies the qualification model for assessment initiative.
  • Title: Reuse Active Qualification
    Maximum Length: 1
    Value that indicates if existing active qualifications can be reused for the assessment type of initiative. The assessment type of initiative contains the following values: true or false. If true and if a valid reusable active qualification exists, then the qualification should be used in initiative. If true and if no valid reusable qualification exists, then the initiative will create a draft qualification. If false, then qualifications will be created for the qualification area. This attribute does not have a default value. The qualification type of initiative contains a null value.
  • Maximum Length: 30
    Abbreviation that identifies the status of the initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_STATUS. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Suppliers
    Title: Suppliers
    The Suppliers resource gets the suppliers on an initiative.
  • Title: Title
    Maximum Length: 80
    Title of the initiative entered by the user.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages the attachments.
Show Source
Nested Schema : Flexfields for Initiatives
Type: array
Title: Flexfields for Initiatives
The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
Show Source
Nested Schema : Evaluation Team Members
Type: array
Title: Evaluation Team Members
The Evaluation Team Members resource gets the evaluation team members on an initiative.
Show Source
Nested Schema : Qualification Areas
Type: array
Title: Qualification Areas
The Qualification Areas resource gets the qualification areas on an initiative.
Show Source
Nested Schema : Suppliers
Type: array
Title: Suppliers
The Suppliers resource gets the suppliers on an initiative.
Show Source
Nested Schema : supplierInitiatives-attachments-item-post-request
Type: object
Show Source
Nested Schema : supplierInitiatives-DFF-item-post-request
Type: object
Show Source
Nested Schema : supplierInitiatives-evaluationTeamMembers-item-post-request
Type: object
Show Source
Nested Schema : supplierInitiatives-qualificationAreas-item-post-request
Type: object
Show Source
Nested Schema : supplierInitiatives-suppliers-item-post-request
Type: object
Show Source
  • Value that uniquely identifies the supplier.
  • Title: Internal Responder
    Maximum Length: 240
    Name of the internal responder.
  • Value that uniquely identifies the internal responder.
  • Title: Response Pulled
    Maximum Length: 1
    Value that indicates whether the response has been pulled for this supplier as part of initiative or not. Contains one of the following values: true or false. If true, then data is pulled from the profile into repository. If false, then data is not pulled from the profile into repository. This attribute does not have a default value.
  • Title: Send Internal Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the internal responder. If false, then questionnaire is not sent to the internal responder. The default value is true if the response to any of the required questions in the internal questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Send Supplier Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the supplier contact. If false, then questionnaire is not sent to the supplier contact. The default value is true if the response to any of the required questions in the supplier questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Supplier
    Maximum Length: 360
    Name of the supplier.
  • Title: Supplier Contact
    Maximum Length: 255
    Name of the supplier contact.
  • Value that uniquely identifies the supplier contact.
  • Value that uniquely identifies the supplier.
  • Title: Supplier Number
    Maximum Length: 30
    Number that identifies the supplier.
  • Title: Supplier Site
    Maximum Length: 240
    Name of the supplier site.
  • Value that uniquely identifies the supplier site.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : supplierInitiatives-item-response
Type: object
Show Source
  • Title: Evaluation Due Date
    Date when the assessment was due for evaluation.
  • Title: Assessment Owner
    Maximum Length: 240
    Name of the assessment owner.
  • Value that uniquely identifies the owner of the assessment.
  • Attachments
    Title: Attachments
    The Attachments resource manages the attachments.
  • Title: Automatically Accept Responses
    Maximum Length: 1
    Value that indicates whether to accept questionnaire responses automatically or not. Contains one of the following values: true or false. If true, then the questionnaire response is automatically accepted. If false, then the qualification manager has to manually accept the response. The default value is false.
  • Title: Automatically Populate Responses
    Maximum Length: 1
    Value that indicates whether to default responses from response repository or not. Contains one of the following values: true or false. If true, then the response from repository is default on the questionnaire. If false, then the response does not default on the questionnaire. The default value is false.
  • Title: Canceled By
    Read Only: true
    Maximum Length: 240
    User who canceled the initiative.
  • Value that uniquely identifies the user who canceled the initiative.
  • Title: Canceled Reason
    Maximum Length: 1000
    Reason for cancellation of the initiative specified by the user.
  • Read Only: true
    Date and time when the initiative is created.
  • Title: Creation Source
    Read Only: true
    Maximum Length: 80
    Value that indicates the creation source of the initiative. Valid values are Manual, Requalification, Supplier Promotion, or Supplier Registration Approval.
  • Maximum Length: 80
    Abbreviation that identifies the creation source of initiative. A list of accepted values is defined in the lookup type ORA_POQ_CREATION_SOURCE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Description
    Maximum Length: 250
    Description of the initiative entered by the user.
  • Flexfields for Initiatives
    Title: Flexfields for Initiatives
    The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
  • Evaluation Team Members
    Title: Evaluation Team Members
    The Evaluation Team Members resource gets the evaluation team members on an initiative.
  • Title: Initiative
    Maximum Length: 30
    Number that is assigned to the initiative.
  • Title: Cancellation Date
    Date and time when the initiative was canceled.
  • Title: Completion Date
    Date and time when the initiative was completed.
  • Value that uniquely identifies the initiative.
  • Title: Initiative Owner
    Maximum Length: 240
    Name of the initiative owner.
  • Value that uniquely identifies the owner of the initiative.
  • Title: Internal survey
    Maximum Length: 1
    Default Value: false
    Contains one of the following values: true or false. If true, the initiative is of type survey and allows responses from multiple internal responders to be used for evaluation of the qualification. If false, the initiative allows responses from a single responder. The default value is false.
  • Title: Initiative Type
    Maximum Length: 80
    Value that identifies the type of initiative.
  • Maximum Length: 30
    Abbreviation that identifies the type of initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_TYPE. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Internal Note
    Maximum Length: 4000
    Internal notes for the initiative entered by the user.
  • Title: Last Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an internal response that was overdue for the initiative.
  • Title: Last Supplier Overdue Reminder Date
    Date and time when an overdue reminder notification was last sent to an external response that was overdue for the initiative.
  • Title: Launch Date
    Date and time when the initiative was launched.
  • Links
  • Title: Procurement BU
    Maximum Length: 240
    Name of the procurement business unit associated with initiative.
  • Value that uniquely identifies the procurement business unit associated with the initiative.
  • Qualification Areas
    Title: Qualification Areas
    The Qualification Areas resource gets the qualification areas on an initiative.
  • Title: Qualification Model
    Maximum Length: 80
    Name of the qualification model for assessment initiative.
  • Value that uniquely identifies the qualification model for assessment initiative.
  • Title: Qualification Model Revision
    Read Only: true
    Default Value: 0
    Revision of the qualification model for assessment initiative.
  • Title: Qualification Model Status
    Read Only: true
    Maximum Length: 80
    Status of the qualification model for assessment initiative.
  • Title: Qualification Model Status Code
    Read Only: true
    Maximum Length: 30
    Default Value: DRAFT
    Abbreviation that identifies the status of the qualification model. A list of accepted values is defined in the lookup type POQ_QUAL_MODEL_STATUS. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Title: Reuse Active Qualification
    Maximum Length: 1
    Value that indicates if existing active qualifications can be reused for the assessment type of initiative. The assessment type of initiative contains the following values: true or false. If true and if a valid reusable active qualification exists, then the qualification should be used in initiative. If true and if no valid reusable qualification exists, then the initiative will create a draft qualification. If false, then qualifications will be created for the qualification area. This attribute does not have a default value. The qualification type of initiative contains a null value.
  • Title: Initiative Status
    Read Only: true
    Maximum Length: 80
    Status of the initiative.
  • Maximum Length: 30
    Abbreviation that identifies the status of the initiative. A list of accepted values is defined in the lookup type POQ_INITIATIVE_STATUS. Review the values for this attribute using the Setup and Maintenance work area, and the Manage Standard Lookups task.
  • Suppliers
    Title: Suppliers
    The Suppliers resource gets the suppliers on an initiative.
  • Title: Title
    Maximum Length: 80
    Title of the initiative entered by the user.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages the attachments.
Show Source
Nested Schema : Flexfields for Initiatives
Type: array
Title: Flexfields for Initiatives
The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
Show Source
Nested Schema : Evaluation Team Members
Type: array
Title: Evaluation Team Members
The Evaluation Team Members resource gets the evaluation team members on an initiative.
Show Source
Nested Schema : Qualification Areas
Type: array
Title: Qualification Areas
The Qualification Areas resource gets the qualification areas on an initiative.
Show Source
Nested Schema : Suppliers
Type: array
Title: Suppliers
The Suppliers resource gets the suppliers on an initiative.
Show Source
Nested Schema : supplierInitiatives-attachments-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-DFF-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-evaluationTeamMembers-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-qualificationAreas-item-response
Type: object
Show Source
Nested Schema : supplierInitiatives-suppliers-item-response
Type: object
Show Source
  • Value that uniquely identifies the supplier.
  • Title: Internal Responder
    Maximum Length: 240
    Name of the internal responder.
  • Value that uniquely identifies the internal responder.
  • Links
  • Title: Response Pulled
    Maximum Length: 1
    Value that indicates whether the response has been pulled for this supplier as part of initiative or not. Contains one of the following values: true or false. If true, then data is pulled from the profile into repository. If false, then data is not pulled from the profile into repository. This attribute does not have a default value.
  • Title: Send Internal Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the internal responder. If false, then questionnaire is not sent to the internal responder. The default value is true if the response to any of the required questions in the internal questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Send Supplier Questionnaire
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then questionnaire is sent to the supplier contact. If false, then questionnaire is not sent to the supplier contact. The default value is true if the response to any of the required questions in the supplier questionnaire is missing in the response repository. Else, the default value is false. This attribute is used for both qualification and assessment type of initiatives.
  • Title: Supplier
    Maximum Length: 360
    Name of the supplier.
  • Title: Supplier Contact
    Maximum Length: 255
    Name of the supplier contact.
  • Value that uniquely identifies the supplier contact.
  • Value that uniquely identifies the supplier.
  • Title: Supplier Number
    Maximum Length: 30
    Number that identifies the supplier.
  • Title: Supplier Site
    Maximum Length: 240
    Name of the supplier site.
  • Value that uniquely identifies the supplier site.
Links
DFF
Parameters:
  • InitiativeId: $request.path.InitiativeId
The Flexfields for Initiatives resource gets the initiative descriptive flexfields.
attachments
Parameters:
  • InitiativeId: $request.path.InitiativeId
The Attachments resource manages the attachments.
evaluationTeamMembers
Parameters:
  • InitiativeId: $request.path.InitiativeId
The Evaluation Team Members resource gets the evaluation team members on an initiative.
launch
Parameters:
  • InitiativeId: $request.path.InitiativeId
Launches an initiative and sends questionnaires to suppliers and internal responders for their responses.
qualificationAreas
Parameters:
  • InitiativeId: $request.path.InitiativeId
The Qualification Areas resource gets the qualification areas on an initiative.
suppliers
Parameters:
  • InitiativeId: $request.path.InitiativeId
The Suppliers resource gets the suppliers on an initiative.
Back to Top

Examples

This example describes how to create one initiative.

Example cURL Command

Use the following cURL command to submit a request on the REST resource.

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

Example Request Body

The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates. 

{
	"Title": "Evaluate Suppliers for New Project",
	"Description": "Identify Qualified suppliers to supply electrical equipment",
	"InitiativeType": "Qualification",
	"ProcurementBU": "Vision Operations",
	"InitiativeOwner": "Davis, Cody",
	"InternalNote":"Identify suppliers for new Manufacturing plant"
}

Example Response Body

The following example includes the contents of the response body in JSON format:

{
	"InitiativeId": 300100188060693,
	"Initiative": "652",
	"Title": "Evaluate Suppliers for New Project",
	"Description": "Identify Qualified suppliers to supply electrical equipment",
	"StatusCode": "DRAFT",
	"Status": "Draft",
	"InitiativeTypeCode": "QUALIFICATION",
	"InitiativeType": "Qualification",
	"ProcurementBUId": 204,
	"ProcurementBU": "Vision Operations",
	"InitiativeOwnerId": 100010026863791,
	"InitiativeOwner": "Davis, Cody",
	"InternalNote": "Identify suppliers for new Manufacturing plant",
	"QualificationModelId": null,
	"QualificationModel": null,
	"QualificationModelStatusCode": null,
	"QualificationModelStatus": null,
	"QualificationModelRevision": null,
	"AssessmentOwnerId": null,
	"AssessmentOwner": null,
	"AssessmentEvaluationDueDate": null,
	"ReuseActiveQualificationFlag": null,
	"LaunchDate": null,
	"InitiativeCompletionDate": null,
	"InitiativeCancellationDate": null,
	"CanceledById": null,
	"CanceledBy": null,
	"CanceledReason": null,
	"CreationDate": "2020-08-12T19:08:26+00:00",
	"CreationSourceCode": "MANUAL",
	"CreationSource": "Manual",
	"AutoAcceptResponsesFlag": false,
	"AutoPopulateResponsesFlag": false,
	"LastOverdueReminderDate": null,
	"links": [
	{
		"rel": "self",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693",
		"name": "supplierInitiatives",
		"kind": "item",
		"properties": {
			"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78"
		}
	},
	{
		"rel": "canonical",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693",
		"name": "supplierInitiatives",
		"kind": "item"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/child/DFF",
		"name": "DFF",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/child/attachments",
		"name": "attachments",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/child/evaluationTeamMembers",
		"name": "evaluationTeamMembers",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/child/qualificationAreas",
		"name": "qualificationAreas",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/child/suppliers",
		"name": "suppliers",
		"kind": "collection"
	},
	{
		"rel": "action",
		"href": "https://servername/fscmRestApi/resources/version/supplierInitiatives/300100188060693/action/launch",
		"name": "launch",
		"kind": "other"
	}
	]
}
Back to Top