Create forecasts
post
/fscmRestApi/resources/11.13.18.05/collaborationOrderForecastRequests
Request
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
-
CollaborationOrderForecastRequestId: integer
(int64)
Value that uniquely identifies the request for the collaboration order forecast.
-
details: array
Details
Title:
Details
The Details resource manages details about collaboration order forecasts that you request. -
ItemNumber(required): string
Maximum Length:
300
Number that identifies the item. -
NoteToPlanner: string
Maximum Length:
1000
Note provided by the supplier to the collaboration planner. -
NoteToSupplier: string
Maximum Length:
1000
Note provided by the collaboration planner to the supplier. -
ProcurementBUName: string
Maximum Length:
240
Name of the business unit. The application assigns the supplier to this business unit. -
requestStatusDetails: array
Statuses
Title:
Statuses
The 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:
360
Name of the supplier that ships the item. -
ShipFromSupplierSiteName(required): string
Maximum Length:
240
Name of the supplier site that ships the item. -
ShipToCustomerName: string
Maximum Length:
360
Name of the customer that receives the item. -
ShipToCustomerSiteName: string
Maximum Length:
240
Name of the customer site that received the item. -
ShipToCustomerSiteNumber: string
Maximum Length:
30
Number that identifies the customer site that received the item. -
ShipToOrganizationCode(required): string
Maximum Length:
49
Name of the organization that receives the item. -
SupplyPlanDescription(required): string
Maximum Length:
100
Description of the supply plan that was used to generate the collaboration order forecast. -
SupplyPlanName(required): string
Maximum Length:
30
Name of the supply plan that was used to generate the collaboration order forecast. -
UnitOfMeasure: string
Maximum Length:
25
Unit of measure for the item. -
UOMCode: string
Maximum Length:
3
Abbreviation that identifies the unit of measure for the item.
Nested Schema : Details
Type:
array
Title:
Details
The Details resource manages details about collaboration order forecasts that you request.
Show Source
Nested Schema : Statuses
Type:
array
Title:
Statuses
The 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:
18
Value that uniquely identifies the request for the collaboration order forecast. -
PublisherOrderTypeCode: string
Maximum Length:
32
Abbreviation 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:
64
Reference 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:
64
Number 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:
64
Number 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
object
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context(required):
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(required):
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:
true
Maximum Length:64
User who created the collaboration order forecast. -
CreationDate: string
(date-time)
Read Only:
true
Date and time when the user created the collaboration order forecast. -
details: array
Details
Title:
Details
The Details resource manages details about collaboration order forecasts that you request. -
ItemNumber: string
Maximum Length:
300
Number that identifies the item. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NoteToPlanner: string
Maximum Length:
1000
Note provided by the supplier to the collaboration planner. -
NoteToSupplier: string
Maximum Length:
1000
Note provided by the collaboration planner to the supplier. -
ProcessId: integer
(int64)
Read Only:
true
Value that uniquely identifies the scheduled process that was used to decompose the request. -
ProcurementBUName: string
Maximum Length:
240
Name of the business unit. The application assigns the supplier to this business unit. -
requestStatusDetails: array
Statuses
Title:
Statuses
The Statuses resource manages details about collaboration order forecasts that you request, such as, Processing Type, Error Code, or Error Message. -
ShipFromSupplierName: string
Maximum Length:
360
Name of the supplier that ships the item. -
ShipFromSupplierSiteName: string
Maximum Length:
240
Name of the supplier site that ships the item. -
ShipToCustomerName: string
Maximum Length:
360
Name of the customer that receives the item. -
ShipToCustomerSiteName: string
Maximum Length:
240
Name of the customer site that received the item. -
ShipToCustomerSiteNumber: string
Maximum Length:
30
Number that identifies the customer site that received the item. -
ShipToOrganizationCode: string
Maximum Length:
49
Name of the organization that receives the item. -
SourceSystem: string
Read Only:
true
Maximum Length:255
Value 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:
true
Maximum Length:30
Default Value:ORA_VCS_SRCSYSTEM_ORACLE
Abbreviation 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:
true
Maximum Length:30
Abbreviation that identifies the current state of the collaboration order forecast. Values included ERROR, SUBMITTED, PROCESSING, PUBLISHED, and PUBLISHED_B2B_ONLY. -
SupplyPlanDescription: string
Maximum Length:
100
Description of the supply plan that was used to generate the collaboration order forecast. -
SupplyPlanName: string
Maximum Length:
30
Name of the supply plan that was used to generate the collaboration order forecast. -
UnitOfMeasure: string
Maximum Length:
25
Unit of measure for the item. -
UOMCode: string
Maximum Length:
3
Abbreviation that identifies the unit of measure for the item.
Nested Schema : Details
Type:
array
Title:
Details
The Details resource manages details about collaboration order forecasts that you request.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Statuses
Type:
array
Title:
Statuses
The 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:
18
Value that uniquely identifies the request for the collaboration order forecast. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PublisherOrderTypeCode: string
Maximum Length:
32
Abbreviation 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:
64
Reference 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:
64
Number 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:
64
Number 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:
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.
Nested Schema : collaborationOrderForecastRequests-requestStatusDetails-item-response
Type:
Show Source
object
-
CollaborationOrderForecastRequestId: integer
(int64)
Read Only:
true
Value that uniquely identifies the request for the collaboration order forecast. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
RequestDetailId: integer
Read Only:
true
Value that uniquely identifies the request detail for the collaboration order forecast. -
StatusDetailCode: string
Read Only:
true
Maximum Length:30
Abbreviation 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:
true
Maximum Length:30
Value that identifies the type of status detail. Values include Error or Information.
Nested Schema : Links
Type:
array
Title:
Links
The 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": [ { ... }, { ... }, { ... }, { ... } ] }