Update a forecast product
patch
/crmRestApi/resources/11.13.18.05/territoryForecasts/{ForecastParticipantId}/child/forecastProducts/{FcstProductId}
Request
Path Parameters
-
FcstProductId(required): integer(int64)
The unique identifier of the product.
-
ForecastParticipantId(required): integer(int64)
The unique identifier of the participant associated with the territory forecast.
Header Parameters
-
Metadata-Context:
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".
-
REST-Framework-Version:
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
- application/json
Root Schema : schema
Type:
Show Source
object
-
AdjustedForecast: number
The value of the product forecast after adjustments.
-
AdjustedQuantity: number
The value of the adjusted quantity.
-
BestCaseAdjustedForecast: number
The best case value of the forecast after adjustments.
-
EntityType: string
Maximum Length:
360
The type of the entity, such as product or a product group. -
FcstProductId(required): integer
(int64)
The unique identifier of the product.
-
forecastProductAdjustmentPeriods: array
Product Adjustment Periods
Title:
Product Adjustment Periods
The forecast product adjustment periods resource is used to view and update the time period adjustment applied to a forecast product. -
InventoryItemId: integer
(int64)
The unique identifier of the inventory item that is generated during product creation. This attribute in combination with the InvOrgID attribute forms the composite unique identifier of the inventory item.
-
InvOrgId: integer
(int64)
The unique identifier of the inventory organization that is generated during product creation. This attribute in combination with the InventoryItemID attribute forms the composite unique identifier of the inventory item.
-
Name: string
The product name.
-
NewAdjustedForecast: number
The net new value of the product forecast after adjustments.
-
NewAdjustedQuantity: number
The value of the adjusted quantity for net new.
-
NewBestCaseAdjustedForecast: number
The net new best case value of the forecast after adjustments.
-
NewUnadjustedBcAmount: number
The net new best case value of the unadjusted product forecast.
-
NewUnadjustedForecast: number
The value of the unadjusted product forecast for net new.
-
NewUnadjustedQuantity: number
The value of the unadjusted quantity for net new.
-
NewUnadjustedWcAmount: number
The net new worst case value of the unadjusted product forecast.
-
NewWorstCaseAdjustedForecast: number
The net new worst case value of the forecast after adjustments.
-
ParentFcstProductId: integer
(int64)
The unique identifier of the parent product.
-
ProdHierarchyLevel: number
The level of the node in the product hierarchy.
-
ProductGroupId: integer
(int64)
The unique identifier of the product group.
-
RenewalAdjustedForecast: number
The renewal value of the product forecast after adjustments.
-
RenewalAdjustedQuantity: number
The value of the adjusted quantity for renewals.
-
RenewalBestCaseAdjustedForecast: number
The renewal best case value of the forecast after adjustments.
-
RenewalUnadjustedBcAmount: number
The renewal best case value of the unadjusted product forecast.
-
RenewalUnadjustedForecast: number
The value of the unadjusted product forecast for renewals.
-
RenewalUnadjustedQuantity: number
The value of the unadjusted quantity for renewals.
-
RenewalUnadjustedWcAmount: number
The renewal worst case value of the unadjusted product forecast.
-
RenewalWorstCaseAdjustedForecast: number
The renewal worst case value of the forecast after adjustments.
-
SnapshotVersionId: integer
(int64)
The unique identifier of the product hierarchy snapshot version. A snap shot of the product hierarchy is taken for each forecasting period.
-
UnadjustedBcAmount: number
The best case value of the unadjusted product forecast.
-
UnadjustedForecast: number
The value of the unadjusted product forecast.
-
UnadjustedQuantity: number
The value of the unadjusted quantity.
-
UnadjustedWcAmount: number
The worst case value of the unadjusted product forecast.
-
UnspecifiedFlag: boolean
Maximum Length:
1
The revenue associated with the product group for which the product is not specified. -
WorstCaseAdjustedForecast: number
The worst case value of the forecast after adjustments.
Nested Schema : Product Adjustment Periods
Type:
array
Title:
Product Adjustment Periods
The forecast product adjustment periods resource is used to view and update the time period adjustment applied to a forecast product.
Show Source
Nested Schema : territoryForecasts-forecastProducts-forecastProductAdjustmentPeriods-item-patch-request
Type:
Show Source
object
-
AdjustedForecast: number
The value of the forecast product after adjustments.
-
AdjustedQuantity: number
The value of the adjusted quantity.
-
BestCaseAdjustedForecast: number
The best case value of the forecast after adjustments.
-
NewAdjustedForecast: number
The net new value of the product forecast after adjustments.
-
NewAdjustedQuantity: number
The value of the adjusted quantity for net new.
-
NewBestCaseAdjustedForecast: number
The net new best case value of the forecast after adjustments.
-
NewWorstCaseAdjustedForecast: number
The net new worst case value of the forecast after adjustments.
-
RenewalAdjustedForecast: number
The renewal value of the product forecast after adjustments.
-
RenewalAdjustedQuantity: number
The value of the adjusted quantity for renewals.
-
RenewalBestCaseAdjustedForecast: number
The renewal best case value of the forecast after adjustments.
-
RenewalWorstCaseAdjustedForecast: number
The renewal worst case value of the forecast after adjustments.
-
WorstCaseAdjustedForecast: number
The worst case value of the unadjusted product forecast after adjustments.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Root Schema : territoryForecasts-forecastProducts-item-response
Type:
Show Source
object
-
AdjustedForecast: number
The value of the product forecast after adjustments.
-
AdjustedQuantity: number
The value of the adjusted quantity.
-
BestCaseAdjustedForecast: number
The best case value of the forecast after adjustments.
-
EntityType: string
Maximum Length:
360
The type of the entity, such as product or a product group. -
FcstHeaderId: integer
(int64)
Title:
Forecast Type
Read Only:true
The unique identifier of the forecast. -
FcstParticipantId: integer
(int64)
Title:
Participant ID
Read Only:true
The unique identifier of the participant associated with the territory forecast. -
FcstProductId: integer
(int64)
The unique identifier of the product.
-
forecastProductAdjustmentPeriods: array
Product Adjustment Periods
Title:
Product Adjustment Periods
The forecast product adjustment periods resource is used to view and update the time period adjustment applied to a forecast product. -
InventoryItemId: integer
(int64)
The unique identifier of the inventory item that is generated during product creation. This attribute in combination with the InvOrgID attribute forms the composite unique identifier of the inventory item.
-
InvOrgId: integer
(int64)
The unique identifier of the inventory organization that is generated during product creation. This attribute in combination with the InventoryItemID attribute forms the composite unique identifier of the inventory item.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Name: string
The product name.
-
NewAdjustedForecast: number
The net new value of the product forecast after adjustments.
-
NewAdjustedQuantity: number
The value of the adjusted quantity for net new.
-
NewBestCaseAdjustedForecast: number
The net new best case value of the forecast after adjustments.
-
NewUnadjustedBcAmount: number
The net new best case value of the unadjusted product forecast.
-
NewUnadjustedForecast: number
The value of the unadjusted product forecast for net new.
-
NewUnadjustedQuantity: number
The value of the unadjusted quantity for net new.
-
NewUnadjustedWcAmount: number
The net new worst case value of the unadjusted product forecast.
-
NewWorstCaseAdjustedForecast: number
The net new worst case value of the forecast after adjustments.
-
ParentFcstProductId: integer
(int64)
The unique identifier of the parent product.
-
ProdHierarchyLevel: number
The level of the node in the product hierarchy.
-
ProductGroupId: integer
(int64)
The unique identifier of the product group.
-
RenewalAdjustedForecast: number
The renewal value of the product forecast after adjustments.
-
RenewalAdjustedQuantity: number
The value of the adjusted quantity for renewals.
-
RenewalBestCaseAdjustedForecast: number
The renewal best case value of the forecast after adjustments.
-
RenewalUnadjustedBcAmount: number
The renewal best case value of the unadjusted product forecast.
-
RenewalUnadjustedForecast: number
The value of the unadjusted product forecast for renewals.
-
RenewalUnadjustedQuantity: number
The value of the unadjusted quantity for renewals.
-
RenewalUnadjustedWcAmount: number
The renewal worst case value of the unadjusted product forecast.
-
RenewalWorstCaseAdjustedForecast: number
The renewal worst case value of the forecast after adjustments.
-
SnapshotVersionId: integer
(int64)
The unique identifier of the product hierarchy snapshot version. A snap shot of the product hierarchy is taken for each forecasting period.
-
TerritoryId: integer
(int64)
Title:
Territory ID
Read Only:true
The unique identifier of the territory. -
UnadjustedBcAmount: number
The best case value of the unadjusted product forecast.
-
UnadjustedForecast: number
The value of the unadjusted product forecast.
-
UnadjustedQuantity: number
The value of the unadjusted quantity.
-
UnadjustedWcAmount: number
The worst case value of the unadjusted product forecast.
-
UnspecifiedFlag: boolean
Maximum Length:
1
The revenue associated with the product group for which the product is not specified. -
UpdateFlag: boolean
Read Only:
true
Indicates if the user has access to update the record. -
WorstCaseAdjustedForecast: number
The worst case value of the forecast after adjustments.
Nested Schema : Product Adjustment Periods
Type:
array
Title:
Product Adjustment Periods
The forecast product adjustment periods resource is used to view and update the time period adjustment applied to a forecast product.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : territoryForecasts-forecastProducts-forecastProductAdjustmentPeriods-item-response
Type:
Show Source
object
-
AdjustedForecast: number
The value of the forecast product after adjustments.
-
AdjustedQuantity: number
The value of the adjusted quantity.
-
AdjustmentPeriodEndDate: string
(date)
Read Only:
true
The date when the forecast ends. -
AdjustmentPeriodStartDate: string
(date)
Read Only:
true
The date when the forecast starts. -
BestCaseAdjustedForecast: number
The best case value of the forecast after adjustments.
-
BestCaseUnadjustedForecast: number
Read Only:
true
The best case value of the unadjusted product forecast. -
FcstAdjustPeriodId: integer
(int64)
Read Only:
true
The unique identifier of the summary level forecast adjustment. -
FcstHeaderId: integer
(int64)
Title:
Forecast Type
Read Only:true
The unique identifier of the forecast. -
FcstParticipantId: integer
(int64)
Title:
Participant ID
Read Only:true
The unique identifier of the territory forecast participant. -
FcstProductId: integer
(int64)
Read Only:
true
The unique identifier of the product that the forecast item is associated with. -
InventoryItemId: integer
(int64)
Read Only:
true
The unique identifier of the inventory item that is generated during product creation. This attribute in combination with the InvOrgID attribute forms the composite unique identifier of the inventory item. -
InvOrgId: integer
(int64)
Read Only:
true
The unique identifier of the inventory organization that is generated during product creation. This attribute in combination with the InventoryItemID attribute forms the composite unique identifier of the inventory item. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NewAdjustedForecast: number
The net new value of the product forecast after adjustments.
-
NewAdjustedQuantity: number
The value of the adjusted quantity for net new.
-
NewBestCaseAdjustedForecast: number
The net new best case value of the forecast after adjustments.
-
NewBestCaseUnadjustedForecast: number
Read Only:
true
The net new best case value of the unadjusted product forecast. -
NewUnadjustedForecast: number
Read Only:
true
The value of the unadjusted territory forecast for net new. -
NewUnadjustedQuantity: number
Read Only:
true
The value of the unadjusted quantity for net new. -
NewWorstCaseAdjustedForecast: number
The net new worst case value of the forecast after adjustments.
-
NewWorstCaseUnadjustedForecast: number
Read Only:
true
The net new worst case value of the unadjusted product forecast. -
ParentFcstProductId: integer
(int64)
Read Only:
true
The unique identifier of the parent product. -
PeriodName: string
Title:
Adjustment Period
Read Only:true
Maximum Length:15
The name of the forecast period. -
PeriodSetName: string
Read Only:
true
Maximum Length:15
The name of the adjustment period. -
ProductGroupId: integer
(int64)
Read Only:
true
The unique identifier of the product group. -
RenewalAdjustedForecast: number
The renewal value of the product forecast after adjustments.
-
RenewalAdjustedQuantity: number
The value of the adjusted quantity for renewals.
-
RenewalBestCaseAdjustedForecast: number
The renewal best case value of the forecast after adjustments.
-
RenewalBestCaseUnadjustedForecast: number
Read Only:
true
The renewal best case value of the unadjusted product forecast. -
RenewalUnadjustedForecast: number
Read Only:
true
The value of the unadjusted territory forecast for renewals. -
RenewalUnadjustedQuantity: number
Read Only:
true
The value of the unadjusted quantity for renewals. -
RenewalWorstCaseAdjustedForecast: number
The renewal worst case value of the forecast after adjustments.
-
RenewalWorstCaseUnadjustedForecast: number
Read Only:
true
The renewal worst case value of the unadjusted product forecast. -
TerritoryId: integer
(int64)
Title:
Territory ID
Read Only:true
The unique identifier of the territory. -
UnadjustedForecast: number
Read Only:
true
The value of the unadjusted product forecast. -
UnadjustedQuantity: number
Read Only:
true
The value of the unadjusted quantity. -
UpdateFlag: boolean
Read Only:
true
Indicates if the user has access to update the record. -
WorstCaseAdjustedForecast: number
The worst case value of the unadjusted product forecast after adjustments.
-
WorstCaseUnadjustedForecast: number
Read Only:
true
The worst case value of the unadjusted product forecast.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Links
- forecastProductAdjustmentPeriods
-
Parameters:
- FcstProductId:
$request.path.FcstProductId
- ForecastParticipantId:
$request.path.ForecastParticipantId
The forecast product adjustment periods resource is used to view and update the time period adjustment applied to a forecast product. - FcstProductId:
Examples
The following example shows how to update a forecast product by submitting a patch request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X PATCH -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/territoryForecasts/7414679/child/forecastProducts/838927
Example of Request Body
The following shows an example of the request body in JSON format.
{ "BestCaseAdjustedForecast": 1000, "WorstCaseAdjustedForecast": 100 }
Example of Response Body
The following shows an example of the response body in JSON format.
{ "EntityType": "UNSPECIFIED" "FcstProductId": 838927 "ParentFcstProductId": 838922 "ProdHierarchyLevel": 2 "SnapshotVersionId": -1 "UnspecifiedFlag": true "FcstHeaderId": 300100093651293 "AdjustedForecast": 1250000 "Name": " " "BestCaseAdjustedForecast": 1000 "WorstCaseAdjustedForecast": 100 "UnadjustedForecast": 1250000 "UnadjustedBcAmount": 1250000 ... }