Create forecasts
post
/fscmRestApi/resources/11.13.18.05/collaborationOrderForecastRequests
Request
Header Parameters
-
Metadata-Context: string
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: string
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-
CollaborationOrderForecastRequestId: integer
(int64)
Value that uniquely identifies the request for the collaboration order forecast.
-
details: array
Details
Title:
DetailsThe Details resource manages details about collaboration order forecasts that you request. -
ItemNumber(required): string
Maximum Length:
300Number that identifies the item. -
NoteToPlanner: string
Maximum Length:
1000Note provided by the supplier to the collaboration planner. -
NoteToSupplier: string
Maximum Length:
1000Note provided by the collaboration planner to the supplier. -
ProcurementBUName: string
Maximum Length:
240Name of the business unit. The application assigns the supplier to this business unit. -
requestStatusDetails: array
Statuses
Title:
StatusesThe Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message. -
ShipFromSupplierName(required): string
Maximum Length:
360Name of the supplier that ships the item. -
ShipFromSupplierSiteName(required): string
Maximum Length:
240Name of the supplier site that ships the item. -
ShipToCustomerName: string
Maximum Length:
360Name of the customer that receives the item. -
ShipToCustomerSiteName: string
Maximum Length:
240Name of the customer site that received the item. -
ShipToCustomerSiteNumber: string
Maximum Length:
30Number that identifies the customer site that received the item. -
ShipToOrganizationCode(required): string
Maximum Length:
49Name of the organization that receives the item. -
SupplyPlanDescription(required): string
Maximum Length:
100Description of the supply plan that was used to generate the collaboration order forecast. -
SupplyPlanName(required): string
Maximum Length:
30Name of the supply plan that was used to generate the collaboration order forecast. -
UnitOfMeasure: string
Maximum Length:
25Unit of measure for the item. -
UOMCode: string
Maximum Length:
3Abbreviation that identifies the unit of measure for the item.
Nested Schema : Details
Type:
arrayTitle:
DetailsThe Details resource manages details about collaboration order forecasts that you request.
Show Source
Nested Schema : Statuses
Type:
arrayTitle:
StatusesThe Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message.
Show Source
Nested Schema : schema
Type:
Show Source
object-
BucketStartDate: string
(date)
Date when the time bucket starts.
-
CollaborationOrderForecastRequestId: string
Maximum Length:
18Value that uniquely identifies the request for the collaboration order forecast. -
PublisherOrderTypeCode: string
Maximum Length:
32Abbreviation that identifies the order type of the reference quantity. A list of accepted values is defined in the lookup type ORA_VCS_COLLAB_ORDER_TYPES. Review and update the values for this attribute using the Setup and Maintenance work area, and the Manage Supply Chain Collaboration Lookups task. -
Quantity: number
Quantity of the publisher order type.
-
ReferenceHeaderId: integer
(int64)
Value that uniquely identifies the reference header for a measure that originates in the Oracle Cloud. A measure that doesn't originate in the Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceHeaderNumber: string
Maximum Length:
64Reference header number for a measure that originates in the Oracle Cloud. A measure that doesn't originate in the Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure. -
ReferenceLineId: integer
(int64)
Value that uniquely identifies the reference line for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceLineLocationId: integer
(int64)
Value that uniquely identifies the reference line location for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceLineLocationNumber: string
Maximum Length:
64Number that identifies the reference line location for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure. -
ReferenceLineNumber: string
Maximum Length:
64Number that identifies the reference line for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
Nested Schema : collaborationOrderForecastRequests-requestStatusDetails-item-post-request
Type:
Show Source
objectResponse
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 : collaborationOrderForecastRequests-item-response
Type:
Show Source
object-
CollaborationOrderForecastRequestId: integer
(int64)
Value that uniquely identifies the request for the collaboration order forecast.
-
CreatedBy: string
Read Only:
trueMaximum Length:64User who created the collaboration order forecast. -
CreationDate: string
(date-time)
Read Only:
trueDate and time when the user created the collaboration order forecast. -
details: array
Details
Title:
DetailsThe Details resource manages details about collaboration order forecasts that you request. -
ItemNumber: string
Maximum Length:
300Number that identifies the item. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NoteToPlanner: string
Maximum Length:
1000Note provided by the supplier to the collaboration planner. -
NoteToSupplier: string
Maximum Length:
1000Note provided by the collaboration planner to the supplier. -
ProcessId: integer
(int64)
Read Only:
trueValue that uniquely identifies the scheduled process that was used to decompose the request. -
ProcurementBUName: string
Maximum Length:
240Name of the business unit. The application assigns the supplier to this business unit. -
requestStatusDetails: array
Statuses
Title:
StatusesThe Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message. -
ShipFromSupplierName: string
Maximum Length:
360Name of the supplier that ships the item. -
ShipFromSupplierSiteName: string
Maximum Length:
240Name of the supplier site that ships the item. -
ShipToCustomerName: string
Maximum Length:
360Name of the customer that receives the item. -
ShipToCustomerSiteName: string
Maximum Length:
240Name of the customer site that received the item. -
ShipToCustomerSiteNumber: string
Maximum Length:
30Number that identifies the customer site that received the item. -
ShipToOrganizationCode: string
Maximum Length:
49Name of the organization that receives the item. -
SourceSystem: string
Read Only:
trueMaximum Length:255Value that indicates the product data model source system for the supply plan that's available for supply chain collaboration. Values include External or Oracle. -
SourceSystemCode: string
Read Only:
trueMaximum Length:30Default Value:ORA_VCS_SRCSYSTEM_ORACLEAbbreviation that indicates the product data model source system for the supply plan that's available for supply chain collaboration. Values include ORA_VCS_SRCSYSTEM_EXTERNAL or ORA_VCS_SRCSYSTEM_ORACLE. -
StatusCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the current state of the collaboration order forecast. Values included ERROR, SUBMITTED, PROCESSING, PUBLISHED, and PUBLISHED_B2B_ONLY. -
SupplyPlanDescription: string
Maximum Length:
100Description of the supply plan that was used to generate the collaboration order forecast. -
SupplyPlanName: string
Maximum Length:
30Name of the supply plan that was used to generate the collaboration order forecast. -
UnitOfMeasure: string
Maximum Length:
25Unit of measure for the item. -
UOMCode: string
Maximum Length:
3Abbreviation that identifies the unit of measure for the item.
Nested Schema : Details
Type:
arrayTitle:
DetailsThe Details resource manages details about collaboration order forecasts that you request.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Statuses
Type:
arrayTitle:
StatusesThe Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message.
Show Source
Nested Schema : collaborationOrderForecastRequests-details-item-response
Type:
Show Source
object-
BucketStartDate: string
(date)
Date when the time bucket starts.
-
CollaborationOrderForecastRequestId: string
Maximum Length:
18Value that uniquely identifies the request for the collaboration order forecast. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PublisherOrderTypeCode: string
Maximum Length:
32Abbreviation that identifies the order type of the reference quantity. A list of accepted values is defined in the lookup type ORA_VCS_COLLAB_ORDER_TYPES. Review and update the values for this attribute using the Setup and Maintenance work area, and the Manage Supply Chain Collaboration Lookups task. -
Quantity: number
Quantity of the publisher order type.
-
ReferenceHeaderId: integer
(int64)
Value that uniquely identifies the reference header for a measure that originates in the Oracle Cloud. A measure that doesn't originate in the Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceHeaderNumber: string
Maximum Length:
64Reference header number for a measure that originates in the Oracle Cloud. A measure that doesn't originate in the Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure. -
ReferenceLineId: integer
(int64)
Value that uniquely identifies the reference line for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceLineLocationId: integer
(int64)
Value that uniquely identifies the reference line location for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
-
ReferenceLineLocationNumber: string
Maximum Length:
64Number that identifies the reference line location for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure. -
ReferenceLineNumber: string
Maximum Length:
64Number that identifies the reference line for a measure that originates outside of Oracle Cloud. A measure that doesn't originate in Oracle Cloud must use the Reference Header Number column. You must use a reference header, line, and location for each read-only reference measure. A purchase order is an example of a reference measure.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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.
Nested Schema : collaborationOrderForecastRequests-requestStatusDetails-item-response
Type:
Show Source
object-
CollaborationOrderForecastRequestId: integer
(int64)
Read Only:
trueValue that uniquely identifies the request for the collaboration order forecast. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
RequestDetailId: integer
Read Only:
trueValue that uniquely identifies the request detail for the collaboration order forecast. -
StatusDetailCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the request status for the collaboration order forecast. The application uses this attribute to provide error or status detail regarding the collaboration order forecast when the Supply Planning Collaboration Decomposition scheduled process runs. -
StatusDetailType: string
Read Only:
trueMaximum Length:30Value that identifies the type of status detail. Values include Error or Information.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- details
-
Parameters:
- CollaborationOrderForecastRequestId:
$request.path.CollaborationOrderForecastRequestId
The Details resource manages details about collaboration order forecasts that you request. - CollaborationOrderForecastRequestId:
- requestStatusDetails
-
Parameters:
- CollaborationOrderForecastRequestId:
$request.path.CollaborationOrderForecastRequestId
The Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message. - CollaborationOrderForecastRequestId:
Examples
This example describes how to create forecasts.
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/collaborationOrderForecastRequests"
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.
{
"SupplyPlanName": "US_Production",
"SupplyPlanDescription":"US Production Plan",
"ShipFromSupplierName" : "CV_SuppD01",
"ShipToOrganizationCode": "M1",
"ShipFromSupplierSiteName": "CV_SuppD01Site1",
"ItemNumber": "SCC-CNTRDL-03",
"details": [
{
"Quantity": 99,
"PublisherOrderTypeCode": "SUPPLY_FORECAST",
"BucketStartDate": "2019-11-28"
}
]
}
Example Response Body
The following example includes the contents of the response body in JSON format:
{
"CollaborationOrderForecastRequestId": 300100152655935,
"StatusCode": "SUBMITTED",
"SupplyPlanName": "US_Production",
"SupplyPlanDescription": "US Production Plan",
"ProcurementBUName": null,
"ShipFromSupplierName": "CV_SuppD01",
"ShipFromSupplierSiteName": "CV_SuppD01Site1",
"ShipToOrganizationCode": "M1",
"ShipToCustomerName": null,
"ShipToCustomerSiteName": null,
"ShipToCustomerSiteNumber": null,
"ItemNumber": "SCC-CNTRDL-03",
"CreatedBy": "COLLABPLANNER",
"CreationDate": "2018-07-25T18:03:29+00:00",
"details": {
"items": [
{
"CollaborationOrderForecastRequestId": "300100152655935",
"PublisherOrderTypeCode": "SUPPLY_FORECAST",
"BucketStartDate": "2019-11-28",
"Quantity": 99,
"ReferenceHeaderId": null,
"ReferenceLineId": null,
"ReferenceLineLocationId": null,
"ReferenceHeaderNumber": null,
"ReferenceLineNumber": null,
"ReferenceLineLocationNumber": null,
"links": [
{
...
},
{
...
},
{
...
}
]
}
],
"count": 1,
"hasMore": false,
"limit": 25,
"offset": 0,
"links": [
{
...
}
]
},
"links": [
{
...
},
{
...
},
{
...
},
{
...
}
]
}