1. REST API for Oracle Supply Chain Management Cloud
  2. Tasks
  3. Product Lifecycle Management
  4. Product Proposals

Update one proposal

patch

/fscmRestApi/resources/11.13.18.05/productProposals/{ProductProposalId}

Request

Path Parameters
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
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages the files and uniform resource locators (URLs) associated with the proposal.
Show Source
Nested Schema : Costs
Type: array
Title: Costs
The Costs resource manages various types of costs of the product proposal.
Show Source
Nested Schema : Next Statuses
Type: array
Title: Next Statuses
The Next Statuses resource gets the next possible workflow statuses of the product proposal.
Show Source
Nested Schema : Proposal Portfolio Relationships
Type: array
Title: Proposal Portfolio Relationships
The Proposal Portfolio Relationships resource manages the portfolios of the product proposal.
Show Source
Nested Schema : Versions
Type: array
Title: Versions
The Versions resource manages the versions of the product proposal.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a proposal. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : Resources
Type: array
Title: Resources
The Resources resource manages the resources of the product proposal.
Show Source
Nested Schema : Revenues
Type: array
Title: Revenues
The Revenues resource manages various types of revenue of the product proposal.
Show Source
Nested Schema : Team Members
Type: array
Title: Team Members
The Team Members resource manages the team members of the product proposal.
Show Source
Nested Schema : productProposals-Attachments-item-patch-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Amount
    Amount of cost associated with the proposal.
  • Title: Category
    Maximum Length: 30
    Default Value: DEVELOPMENT
    Category of cost associated with the proposal.
  • Title: Status
    Maximum Length: 30
    Default Value: PROJECTED
    Status of cost associated with the proposal.
  • Title: Trend
    Maximum Length: 30
    Default Value: POINT
    Trend of cost associated with the proposal.
  • Title: Type
    Maximum Length: 30
    Default Value: VARIABLE
    Type of cost associated with the proposal.
  • Title: Date
    Date when the cost will incur.
Nested Schema : productProposals-NextStatuses-item-patch-request
Type: object
Show Source
Nested Schema : productProposals-ProposalPortfolioRelationships-item-patch-request
Type: object
Show Source
Nested Schema : productProposals-ProposalVersions-item-patch-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : productProposals-Team-item-patch-request
Type: object
Show Source
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 : productProposals-item-response
Type: object
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages the files and uniform resource locators (URLs) associated with the proposal.
Show Source
Nested Schema : Costs
Type: array
Title: Costs
The Costs resource manages various types of costs of the product proposal.
Show Source
Nested Schema : Next Statuses
Type: array
Title: Next Statuses
The Next Statuses resource gets the next possible workflow statuses of the product proposal.
Show Source
Nested Schema : Proposal Portfolio Relationships
Type: array
Title: Proposal Portfolio Relationships
The Proposal Portfolio Relationships resource manages the portfolios of the product proposal.
Show Source
Nested Schema : Versions
Type: array
Title: Versions
The Versions resource manages the versions of the product proposal.
Show Source
Nested Schema : Relationships
Type: array
Title: Relationships
The Relationships resource manages the objects related to a proposal. The objects reference a concept, an item, or other objects.
Show Source
Nested Schema : Resources
Type: array
Title: Resources
The Resources resource manages the resources of the product proposal.
Show Source
Nested Schema : Revenues
Type: array
Title: Revenues
The Revenues resource manages various types of revenue of the product proposal.
Show Source
Nested Schema : Team Members
Type: array
Title: Team Members
The Team Members resource manages the team members of the product proposal.
Show Source
Nested Schema : productProposals-Attachments-item-response
Type: object
Show Source
Nested Schema : productProposals-Cost-item-response
Type: object
Show Source
Nested Schema : productProposals-NextStatuses-item-response
Type: object
Show Source
Nested Schema : productProposals-ProposalPortfolioRelationships-item-response
Type: object
Show Source
Nested Schema : productProposals-ProposalVersions-item-response
Type: object
Show Source
  • Title: Master ID
    Read Only: true
    Value that uniquely identifies the associated concept master.
  • Read Only: true
    Maximum Length: 400
    Alternate value that uniquely identifies the name of the associated concept master.
  • Read Only: true
    Maximum Length: 10
    Alternate value that uniquely identifies the version of the associated concept master.
  • Title: Latest
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then this version is the latest version. If false, then this version is not the latest version. Upon creation of a new proposal, the first version gets defaulted to true.
  • Links
  • Title: Proposal
    Read Only: true
    Maximum Length: 150
    Alternate value that uniquely identifies the name of the proposal.
  • Read Only: true
    Value that uniquely identifies the proposal.
  • Read Only: true
    Maximum Length: 400
    Notes that are entered when creating a proposal version.
  • Title: Version
    Read Only: true
    Default Value: 1
    Alternate value that uniquely identifies the proposal.
Nested Schema : productProposals-Relationships-item-response
Type: object
Show Source
Nested Schema : productProposals-Resource-item-response
Type: object
Show Source
Nested Schema : productProposals-Revenue-item-response
Type: object
Show Source
Nested Schema : productProposals-Team-item-response
Type: object
Show Source
Links
Attachments
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Attachments resource manages the files and uniform resource locators (URLs) associated with the proposal.
Cost
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Costs resource manages various types of costs of the product proposal.
NextStatuses
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Next Statuses resource gets the next possible workflow statuses of the product proposal.
ProposalPortfolioRelationships
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Proposal Portfolio Relationships resource manages the portfolios of the product proposal.
ProposalVersions
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Versions resource manages the versions of the product proposal.
Relationships
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Relationships resource manages the objects related to a proposal. The objects reference a concept, an item, or other objects.
Resource
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Resources resource manages the resources of the product proposal.
Revenue
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Revenues resource manages various types of revenue of the product proposal.
Team
Parameters:
  • ProductProposalId: $request.path.ProductProposalId
The Team Members resource manages the team members of the product proposal.
Back to Top

Examples

This example describes how to update a proposal.

Example cURL Command

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

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

For example:

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

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 updates. 

{
	"Description": "Updated Test Data",
	"ProposalType": "NEW_PRODUCT"
}

Example Response Body

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

{
	"ProductProposalId": 300100249901398,
	"Name": "XYZ",
	"Description": "Updated Test Data",
	"AllowAccesstoEveryone": "Y",
	"ConceptCurrencyCode": "USD",
	"ConceptMasterId": 300100249901400,
	"ConceptMasterName": "XYZ",
	"ConceptMasterVersion": "1",
	"CreatedBy": "PRODUCT_MANAGER",
	"CreationDate": "2020-08-31T08:09:18+00:00",
	"CurrencyConversionRate": null,
	"InstanceId": null,
	"IsCloned": "N",
	"IsLatest": "Y",
	"LastConceptVersion": null,
	"LastProjCostRefreshTime": null,
	"LastProjResourceRefreshTime": null,
	"LastUpdateDate": "2020-08-31T08:18:13+00:00",
	"LastUpdatedBy": "PRODUCT_MANAGER",
	"LatestConceptId": 300100249901400,
	"LatestConceptName": "XYZ",
	"LatestConceptVersion": "1",
	"LifecyclePhase": "DRAFT",
	"ProposalStatus": "DRAFT",
	"ProposalType": "NEW_PRODUCT",
	"PublishedFromPortfolio": "N",
	"ReportId": "/Supply Chain Management/Innovation Management/Concepts/DefaultProposalReport.xdo",
	"ReportTemplate": "",
	"SrcProductProposalId": null,
	"SrcProductProposalName": null,
	"SrcProductProposalVersion": null,
	"Version": 1,
	"WorkflowObjectType": null,
	"ProjectedResources": null,
	"ActualDevFixedCost": null,
	"MarketSharePercent": null,
	"HighLevelDesign": null,
	"ActualCost": null,
	"CompetitiveAdvantage": null,
	"ProjProdMaterialCost": null,
	"ActualProdFixedCost": null,
	"ReturnOnInvestment": null,
	"ProjectedMargin": null,
	"Summary": null,
	"Impact": null,
	"PaybackPeriod": null,
	"RiskSubjective": null,
	"DevelopmentStart": null,
	"TargetCost": null,
	"RndKnowHow": null,
	"AllocatedBudget": null,
	"ProjDevFixedCost": null,
	"BusinessObjectives": null,
	"ActualProductionCost": null,
	"ProposalVersionNotes": "Initial Version",
	"ActualDevLaborCost": null,
	"ActualProdLaborCost": null,
	"ProjDevLaborCost": null,
	"ProductCategorization": null,
	"InternalRateOfReturn": null,
	"ProposalProjectedCost": null,
	"MarketAttractiveness": null,
	"ProductStrategicFit": null,
	"DiscountRate": 0,
	"DevelopmentEnd": null,
	"YearTwoRevenue": null,
	"ProbOfCommercialSuccess": null,
	"BusinessUnitStrength": null,
	"ProjDevCost": null,
	"RiskNumeric": null,
	"ActualDevelopmentCost": null,
	"YearFiveRevenue": null,
	"CostValueIndex": null,
	"BaselineDate": "2020-08-31",
	"ActualDevVariableCost": null,
	"ExpectedCommercialValue": null,
	"ProposalProjectedRevenue": null,
	"ActualProdMaterialCost": null,
	"ActualRevenue": null,
	"Alignment": null,
	"ActualResources": null,
	"Launch": null,
	"EOL": null,
	"AverageSellingPrice": null,
	"ProjProdFixedCost": null,
	"ProjProdCost": null,
	"ProbOfTechnicalSuccess": null,
	"CPI": null,
	"ProjProdLaborCost": null,
	"MarketStrategy": null,
	"ProjProdVariableCost": null,
	"SupplyChainFit": null,
	"ActualMargin": null,
	"PrimaryJustification": null,
	"FundingAmount": null,
	"ActualDevMaterialCost": null,
	"ProjDevMaterialCost": null,
	"ActualLaunch": null,
	"FundingRequestFor": null,
	"ActualProdVariableCost": null,
	"NetPresentValue": null,
	"ProductLine": null,
	"RequirementsDefinition": null,
	"ProjDevVariableCost": null,
	"BusinessUnit": null,
	"ResourceValueIndex": null,
	"MarketGrowthPercent": null,
	"BreakEvenTime": null,
	"YearThreeRevenue": null,
	"SecondaryJustification": null,
	"Rpi": null,
	"ConceptType": "CONCEPT",
	"links": [
	{
		"rel": "self",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398",
		"name": "productProposals",
		"kind": "item",
		"properties": {
			"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000003770400000003737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B0200007870000000027371007E0002000000027371007E00020000000178"
		}
	},
	{
		"rel": "canonical",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398",
		"name": "productProposals",
		"kind": "item"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/Attachments",
		"name": "Attachments",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/Cost",
		"name": "Cost",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/ProposalVersions",
		"name": "ProposalVersions",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/Resource",
		"name": "Resource",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/Revenue",
		"name": "Revenue",
		"kind": "collection"
	},
	{
		"rel": "child",
		"href": "https://servername/fscmRestApi/resources/version/productProposals/300100249901398/child/Team",
		"name": "Team",
		"kind": "collection"
	}
	]
}
Back to Top