Create one sales action request

post

/fscmRestApi/resources/11.13.18.05/salesOrderActionRequests

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
Nested Schema : Requests
Type: array
Title: Requests
The request executes the action performed on the sales order. It's a child of the action request.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Maximum Length: 30
    Code to identify the action.
  • Unique identifier for the child action request.
  • Identifier to track action requests in the Requests resource.
  • Value that uniquely identifies the carrier responsible for delivering the item.
  • Maximum Length: 255
    Abbreviation that identifies the demand class. A list of accepted values is defined in the lookup ORA_DOO_DEMAND_CLASS. Review and update the value for this attribute in the Setup and Maintenance work area using the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Value that uniquely identifies the fulfillment line prior to the split.
  • Unique identifier for the fulfillment line.
  • Value that uniquely identifies the organization fulfilling the item. If the item is shippable, this value references the warehouse responsible for shipping it. A contract or agreement is an example of an item that isn't shippable.
  • Unique identifier for the sales order header.
  • Maximum Length: 1
    Default Value: false
    Indicates that the action is a mass action.
  • Message Details
    Title: Message Details
    The Message Details resource fetches the details of the messages logged for the action request.
  • Order Details
    Title: Order Details
    Order Details resource fetches the order details of the sales order processed by the request.
  • Quantity of the item or service on the fulfillment line.
  • Order Line Details
    Title: Order Line Details
    The Order Line Details resource fetches the order line details of the sales order processed by the request.
  • Maximum Length: 30
    Code to indicate the outcome of the child action request. It can be SUCCESS or ERROR.
  • Maximum Length: 255
    Level of service for the shipping that delivers the shipment. A list of accepted values is defined in the lookup type WSH_SERVICE_LEVELS. Review and update the value for this attribute using the Setup and Maintenance work area and the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Maximum Length: 255
    Mode of shipping that delivers the item. A list of accepted values is defined in the lookup type WSH_MODE_OF_TRANSPORT. Review and update the value for this attribute in the Setup and Maintenance work area using the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Value that uniquely identifies the fulfillment line before the split.
  • Maximum Length: 30
    Default Value: PRE_PROCESSING
    Code to indicate the status of the child action request such as COMPLETE, PRE_PROCESSING, or PROCESSING.
  • Value that uniquely identifies the supplier for the purchase order.
  • Value that uniquely identifies the supplier site for the purchase order.
Nested Schema : Message Details
Type: array
Title: Message Details
The Message Details resource fetches the details of the messages logged for the action request.
Show Source
Nested Schema : Order Details
Type: array
Title: Order Details
Order Details resource fetches the order details of the sales order processed by the request.
Show Source
Nested Schema : Order Line Details
Type: array
Title: Order Line Details
The Order Line Details resource fetches the order line details of the sales order processed by the request.
Show Source
Nested Schema : salesOrderActionRequests-requests-messageDetails-item-post-request
Type: object
Show Source
Nested Schema : salesOrderActionRequests-requests-orderDetails-item-post-request
Type: object
Show Source
Nested Schema : salesOrderActionRequests-requests-orderLineDetails-item-post-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 : salesOrderActionRequests-item-response
Type: object
Show Source
Nested Schema : Requests
Type: array
Title: Requests
The request executes the action performed on the sales order. It's a child of the action request.
Show Source
Nested Schema : salesOrderActionRequests-requests-item-response
Type: object
Show Source
  • Maximum Length: 30
    Code to identify the action.
  • Unique identifier for the child action request.
  • Identifier to track action requests in the Requests resource.
  • Value that uniquely identifies the carrier responsible for delivering the item.
  • Maximum Length: 255
    Abbreviation that identifies the demand class. A list of accepted values is defined in the lookup ORA_DOO_DEMAND_CLASS. Review and update the value for this attribute in the Setup and Maintenance work area using the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Value that uniquely identifies the fulfillment line prior to the split.
  • Unique identifier for the fulfillment line.
  • Value that uniquely identifies the organization fulfilling the item. If the item is shippable, this value references the warehouse responsible for shipping it. A contract or agreement is an example of an item that isn't shippable.
  • Unique identifier for the sales order header.
  • Links
  • Maximum Length: 1
    Default Value: false
    Indicates that the action is a mass action.
  • Message Details
    Title: Message Details
    The Message Details resource fetches the details of the messages logged for the action request.
  • Order Details
    Title: Order Details
    Order Details resource fetches the order details of the sales order processed by the request.
  • Quantity of the item or service on the fulfillment line.
  • Order Line Details
    Title: Order Line Details
    The Order Line Details resource fetches the order line details of the sales order processed by the request.
  • Maximum Length: 30
    Code to indicate the outcome of the child action request. It can be SUCCESS or ERROR.
  • Read Only: true
    Maximum Length: 255
    Status of the request submitted for an order or line such as COMPLETED, FAILED, or IN_QUEUE
  • Maximum Length: 255
    Level of service for the shipping that delivers the shipment. A list of accepted values is defined in the lookup type WSH_SERVICE_LEVELS. Review and update the value for this attribute using the Setup and Maintenance work area and the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Maximum Length: 255
    Mode of shipping that delivers the item. A list of accepted values is defined in the lookup type WSH_MODE_OF_TRANSPORT. Review and update the value for this attribute in the Setup and Maintenance work area using the Manage Shipping Lookups task. To collect data for this attribute, use the Collect Order Reference Data task for Fusion Source.
  • Value that uniquely identifies the fulfillment line before the split.
  • Maximum Length: 30
    Default Value: PRE_PROCESSING
    Code to indicate the status of the child action request such as COMPLETE, PRE_PROCESSING, or PROCESSING.
  • Read Only: true
    Maximum Length: 1000
    Contains errors, warnings, and information messages for the action request.
  • Value that uniquely identifies the supplier for the purchase order.
  • Value that uniquely identifies the supplier site for the purchase order.
Nested Schema : Message Details
Type: array
Title: Message Details
The Message Details resource fetches the details of the messages logged for the action request.
Show Source
Nested Schema : Order Details
Type: array
Title: Order Details
Order Details resource fetches the order details of the sales order processed by the request.
Show Source
Nested Schema : Order Line Details
Type: array
Title: Order Line Details
The Order Line Details resource fetches the order line details of the sales order processed by the request.
Show Source
Nested Schema : salesOrderActionRequests-requests-messageDetails-item-response
Type: object
Show Source
Nested Schema : salesOrderActionRequests-requests-orderDetails-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 255
    Sold-to party name of the customer on the sales order.
  • Read Only: true
    Maximum Length: 30
    Identifies the interface using which the order was captured such as OrderImport, REST_salesOrdersForOrderHub, REST_omSalesOrders, or UI.
  • Title: Purchase Order
    Read Only: true
    Maximum Length: 50
    Customer purchase order of the sales order processed by the action request.
  • Read Only: true
    Unique identifier for the sales order header.
  • Links
  • Title: Orchestration Order
    Read Only: true
    Maximum Length: 50
    Default Value: -1
    Identifier of the sales order number.
  • Read Only: true
    Value that identifies the revision number of the order.
  • Read Only: true
    Unique identifier of the sold-to party on the sales order.
  • Title: Source Order
    Read Only: true
    Maximum Length: 50
    Unique identifier for the sales order in the source system.
  • Read Only: true
    Maximum Length: 255
    Status of the sales order.
  • Read Only: true
    Maximum Length: 30
    Default Value: OPEN
    Code to identify the status of the sales order such as DRAFT, PROCESSING, or CLOSED.
Nested Schema : salesOrderActionRequests-requests-orderLineDetails-item-response
Type: object
Show Source
Back to Top

Examples

These examples describe how to create a sales order action request to apply different actions on multiple orders or lines.

Table -

Example Number Description
Example 1 Create a sales order action request to submit multiple orders.
Example 2 Create a sales order action request to cancel multiple orders.
Example 3 Create a sales order action request to cancel multiple order lines.
Example 4 Create a sales order action request to reprice multiple orders.
Example 5 Create a sales order action request to apply hold on multiple orders.
Example 6 Create a sales order action request to release holds on multiple orders.
Example 7 Create a sales order action request to apply hold on multiple order lines.
Example 8 Create a sales order action request to release holds on multiple order lines.
Example 9 Create a sales order action request to release pause task on multiple order lines.
Example 10 Create a sales order action request to schedule multiple order lines.
Example 11 Create a sales order action request to unschedule multiple order lines.
Example 12 Create a sales order action request to update multiple order lines.
Example 13 Create a sales order action request to reserve multiple order lines.
Example 14 Create a sales order action request to unreserve multiple order lines.
Example 15 Create a sales order action request to update extensible flexfields on multiple order lines.
Example 16 Create a sales order action request to reserve multiple order lines using reservation priority.
Example 17 Create a sales order action request to reserve multiple order lines using a reservation priority rule.
Example 18 Create a sales order action request to reserve multiple order lines using reservation priority attributes that aren't of type DATE.

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/salesOrderActionRequests"

Example 1

In this example we submit sales order action requests for three sales orders.

Example 1 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. In this example we submit sales order action request for three sales orders with Header IDs 300100608434819, 300100608434932, and 300100608434934. We specify ActionCode: ORA_FOM_SUBMIT_ORDER to indicate that the sales order action request is for order submission. HeaderId attribute carries the unique identifier of the sales order to be submitted.

{
    "ActionCode": "ORA_FOM_SUBMIT_ORDER",
    "requests": [
        {
            "HeaderId": 300100608434819
        },
        {
            "HeaderId": 300100608434932
        },
        {
            "HeaderId": 300100608434934
        }
    ]
}

Example 1 Response Body

The following example includes the contents of the response body in JSON format. We can see one master request and 3 child action requests for sumitting 3 sales orders with header IDs mentioned in the request payload. The order is submitted through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request.

{
    "ActionCode": "ORA_FOM_SUBMIT_ORDER",
    "ActionRequestId": 300100608436027,
    "ActionRequestTrackingId": 427736,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2023-10-20T06:19:28.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2023-10-20T06:19:28.102+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 474122,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_SUBMIT_ORDER",
            "ActionRequestId": 300100608436028,
            "ActionRequestTrackingId": 427736,
            "FulfillLineId": null,
            "HeaderId": 300100608434819,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436028",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436028",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436028/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_SUBMIT_ORDER",
            "ActionRequestId": 300100608436029,
            "ActionRequestTrackingId": 427736,
            "FulfillLineId": null,
            "HeaderId": 300100608434932,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436029",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436029",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436029/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_SUBMIT_ORDER",
            "ActionRequestId": 300100608436030,
            "ActionRequestTrackingId": 427736,
            "FulfillLineId": null,
            "HeaderId": 300100608434934,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436030",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436030",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests/300100608436030/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100608436027/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 2

This example describes how to create a sales order action request to cancel multiple orders.

Example 2 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. In this example you submit a sales order action request for three sales orders with Header IDs 300100608647565, 300100609916691, and 300100608453169. You specify ActionCode: ORA_FOM_CANCEL_ORDER to indicate that the sales order action request is for order cancellation. You can also specify CancelReasonCode and Comments, if needed. The HeaderId attribute carries the unique identifier of the sales order to be cancelled.

{
    "ActionCode": "ORA_FOM_CANCEL_ORDER",
    "CancelReasonCode": "LATE",
    "Comments": "Canceled as per customer request",
    "requests": [
        {
            "HeaderId": 300100608647565
        },
        {
            "HeaderId": 300100609916691
        },
        {
            "HeaderId": 300100608453169
        }
    ]
}

Example 2 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests for cancelling three sales orders with header IDs mentioned in the request payload. The order is cancelled through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the order cancellation request. You can also use the Get operation to check the status of the child request action requests. It provides the status of the order cancellation and the error or warning details if any for each order.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_CANCEL_ORDER",
    "ActionRequestId": 300100609916275,
    "ActionRequestTrackingId": 347710,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-02-08T06:59:11.002+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-02-08T06:59:11.234+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 300945,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Canceled as per customer request",
    "CancelReasonCode": "LATE",
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_CANCEL_ORDER",
            "ActionRequestId": 300100609916279,
            "ActionRequestTrackingId": 347710,
            "FulfillLineId": null,
            "HeaderId": 300100608647565,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916279",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916279",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916279/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916279/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916279/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_CANCEL_ORDER",
            "ActionRequestId": 300100609916280,
            "ActionRequestTrackingId": 347710,
            "FulfillLineId": null,
            "HeaderId": 300100609916691,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916280",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916280",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916280/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916280/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916280/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_CANCEL_ORDER",
            "ActionRequestId": 300100609916281,
            "ActionRequestTrackingId": 347710,
            "FulfillLineId": null,
            "HeaderId": 300100608453169,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916281",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916281",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916281/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916281/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests/300100609916281/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100609916275/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 3

This example describes how to create a sales order action request to cancel multiple order lines.

Example 3 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. In this example you submit sales order action request for three fulfillment lines with Fulfill Line IDs 300100610023895, 300100610023690, and 300100610023731. You specify ActionCode: ORA_FOM_CANCEL_LINE to indicate that the sales order action request is for order line cancellation. You can also specify CancelReasonCode and Comments if needed. The FulfillLineId attribute carries the unique identifier of the sales order line to be cancelled.

 {
    "ActionCode": "ORA_FOM_CANCEL_LINE",
    "CancelReasonCode": "ORA_WRONG_ITEM",
    "Comments": "Incorrect Item ordered",
    "requests": [
        {
            "FulfillLineId": 300100610023895
        },
        {
            "FulfillLineId": 300100610023690
        },
        {
            "FulfillLineId": 300100610023731
        }
    ]
}

Example 3 Response Body

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

You can see one master request and three child action requests for cancelling three sales order lines with Fulfill Line IDs mentioned in the request payload. The order line is cancelled through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the order line cancellation request. You can also use the Get operation to check the status of the child request action requests. It provides you status of the order line cancellation and the error or warning details if any for each order line.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_CANCEL_LINE",
    "ActionRequestId": 300100610036489,
    "ActionRequestTrackingId": 349735,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-02-08T17:11:48.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-02-08T17:11:48.162+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 308326,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Incorrect Item ordered",
    "CancelReasonCode": "ORA_WRONG_ITEM",
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_CANCEL_LINE",
            "ActionRequestId": 300100610036493,
            "ActionRequestTrackingId": 349735,
            "FulfillLineId": 300100610023895,
            "HeaderId": 300100610023843,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036493",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036493",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036493/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036493/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036493/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_CANCEL_LINE",
            "ActionRequestId": 300100610036494,
            "ActionRequestTrackingId": 349735,
            "FulfillLineId": 300100610023690,
            "HeaderId": 300100610023665,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036494",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036494",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036494/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036494/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036494/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_CANCEL_LINE",
            "ActionRequestId": 300100610036495,
            "ActionRequestTrackingId": 349735,
            "FulfillLineId": 300100610023731,
            "HeaderId": 300100610023665,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036495",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036495",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036495/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036495/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests/300100610036495/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610036489/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 4

This example describes how to create a sales order action request to reprice multiple orders.

Example 4 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. In this example you submit sales order action request for three sales orders with Header IDs 300100609979963, 300100610845045, and 300100601830766. You specify ActionCode: ORA_FOM_REPRICE_ORDER to indicate that the sales order action request is for reprice order. The HeaderId attribute carries the unique identifier of the sales order to be repriced.

{
    "ActionCode": "ORA_FOM_REPRICE_ORDER",
    "requests": [
        {
            "HeaderId": 300100609979963
        },
        {
            "HeaderId": 300100610845045
        },
        {
            "HeaderId": 300100601830766
        }
    ]
}

Example 4 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests for repricing 3 sales orders with header IDs mentioned in the request payload. The order is repriced through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the reprice order request. You can also use the Get operation to check the status of the child request action requests. It provides you status of the reprice order and the error or warning details if any for each order.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_REPRICE_ORDER",
    "ActionRequestId": 300100610889715,
    "ActionRequestTrackingId": 353752,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-02-09T11:28:25.028+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-02-09T11:28:25.063+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 313824,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_REPRICE_ORDER",
            "ActionRequestId": 300100610889716,
            "ActionRequestTrackingId": 353752,
            "FulfillLineId": null,
            "HeaderId": 300100609979963,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889716",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889716",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889716/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889716/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889716/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_REPRICE_ORDER",
            "ActionRequestId": 300100610889717,
            "ActionRequestTrackingId": 353752,
            "FulfillLineId": null,
            "HeaderId": 300100610845045,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889717",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889717",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889717/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889717/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889717/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_REPRICE_ORDER",
            "ActionRequestId": 300100610889718,
            "ActionRequestTrackingId": 353752,
            "FulfillLineId": null,
            "HeaderId": 300100601830766,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889718",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889718",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889718/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889718/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests/300100610889718/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100610889715/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 5

This example describes how to create a sales order action request to apply hold on multiple orders.

Example 5 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. In this example you submit a sales order action request for three sales orders with header IDs 300100608313927, 300100608314069, and 300100608314211. You specify ActionCode: ORA_FOM_APPLY_ORDER_HOLD and HoldCode: ADMINISTRATIVE_HOLD to indicate that the sales order action request is to apply the ADMINISTRATIVE_HOLD hold on all the three orders. You can also specify comments, if needed. You can specify only one HoldCode in a request. The HeaderId attribute carries the unique identifier of the sales order for applying the order hold.

{
    "ActionCode": "ORA_FOM_APPLY_ORDER_HOLD",
    "HoldCode": "ADMINISTRATIVE_HOLD",  
    "Comments": "Complete Administrative Check on the orders",
    "requests": [
        {
            "HeaderId": 300100608313927
        },
        {
            "HeaderId": 300100608314069
        },
        {
            "HeaderId": 300100608314211
        }
    ]
}

Example 5 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to apply hold on three sales orders with the header IDs mentioned in the request payload. The hold is applied on the orders through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the apply order hold request on the orders. You can also use the Get operation to check the status of the child action requests. It provides the status of the apply order hold request on each order and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_APPLY_ORDER_HOLD",
    "ActionRequestId": 300100608320103,
    "ActionRequestTrackingId": 320703,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-04-26T14:13:43.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-04-26T14:13:43.365+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 214235,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Complete Administrative Check on the orders",
    "CancelReasonCode": null,
    "HoldCode": "ADMINISTRATIVE_HOLD",
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_APPLY_ORDER_HOLD",
            "ActionRequestId": 300100608320106,
            "ActionRequestTrackingId": 320703,
            "FulfillLineId": null,
            "HeaderId": 300100608313927,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320106",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320106",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320106/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320106/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320106/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_APPLY_ORDER_HOLD",
            "ActionRequestId": 300100608320107,
            "ActionRequestTrackingId": 320703,
            "FulfillLineId": null,
            "HeaderId": 300100608314069,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320107",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320107",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320107/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320107/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320107/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_APPLY_ORDER_HOLD",
            "ActionRequestId": 300100608320108,
            "ActionRequestTrackingId": 320703,
            "FulfillLineId": null,
            "HeaderId": 300100608314211,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320108",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320108",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320108/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320108/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests/300100608320108/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608320103/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 6

This example describes how to create a sales order action request to release holds on multiple orders.

Example 6 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. In this example you submit a sales order action request for three sales orders with header IDs 300100608313927, 300100608314069, and 300100608314211. You specify ActionCode: ORA_FOM_RELEASE_ORDER_HOLD and HoldCode: ADMINISTRATIVE_HOLD and EXPORT_CHECK_HOLD to indicate that the sales order action request is to release the ADMINISTRATIVE_HOLD and EXPORT_CHECK_HOLD holds on all the three orders.. You can specify comma-separated HoldCode to release multiple holds on the orders in a request as illustrated in this example. You can also specify ReleaseReasonCode and comments, if needed. If you must send a ReleaseReasonCode, then set the RequireReasonCodeFlag to true. Otherwise, it's optional for you to send a ReleaseReasonCode. The HeaderId attribute carries the unique identifier of the sales order for releasing the order hold.

{
    "ActionCode":"ORA_FOM_RELEASE_ORDER_HOLD",
    "HoldCode": "ADMINISTRATIVE_HOLD,EXPORT_CHECK_HOLD",
    "Comments": "Administrative check completed for domestic and export orders",
    "ReleaseReasonCode": "ADMINISTRATIVE_CHECK_COMPLETE",
    "RequireReasonCodeFlag": true,

    "requests": [
        {
            "HeaderId": 300100608313927
        },
        {
            "HeaderId": 300100608314069
        },
        {
            "HeaderId": 300100608314211
        }
    ]
}

Example 6 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to release hold on three sales orders with the header IDs mentioned in the request payload. The holds on the orders are released through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the apply order hold request on the orders. You can also use the Get operation to check the status of the child action requests. It provides the status of the release order hold request on each order and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RELEASE_ORDER_HOLD",
    "ActionRequestId": 300100608322602,
    "ActionRequestTrackingId": 320716,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-04-26T15:42:10.004+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-04-26T15:42:10.304+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 214485,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Administrative check completed for domestic and export orders",
    "CancelReasonCode": null,
    "HoldCode": "ADMINISTRATIVE_HOLD,EXPORT_CHECK_HOLD",
    "ReleaseReasonCode": "ADMINISTRATIVE_CHECK_COMPLETE",
    "RequireReasonCodeFlag": "true",
    "requests": [
        {
            "ActionCode": "ORA_FOM_RELEASE_ORDER_HOLD",
            "ActionRequestId": 300100608322607,
            "ActionRequestTrackingId": 320716,
            "FulfillLineId": null,
            "HeaderId": 300100608313927,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322607",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322607",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322607/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322607/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322607/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_ORDER_HOLD",
            "ActionRequestId": 300100608322608,
            "ActionRequestTrackingId": 320716,
            "FulfillLineId": null,
            "HeaderId": 300100608314069,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322608",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322608",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322608/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322608/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322608/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_ORDER_HOLD",
            "ActionRequestId": 300100608322609,
            "ActionRequestTrackingId": 320716,
            "FulfillLineId": null,
            "HeaderId": 300100608314211,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322609",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322609",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322609/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322609/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests/300100608322609/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100608322602/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 7

This example describes how to create a sales order action request to apply hold on multiple order lines.

Example 7 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100608313952, 300100608314073, and 300100608314213. You specify ActionCode: ORA_FOM_APPLY_LINE_HOLD and HoldCode: QUALITY_CHECK_HOLD to indicate that the sales order action request is to apply the QUALITY_CHECK_HOLD hold on all the three fulfillment lines. You can specify only one HoldCode in a request. You can also specify comments, if needed. The FulfillLineId attribute carries the unique identifier of the order line for applying the line hold. You can apply hold at the fulfillment line entity. You can't apply hold at the order line entity.

{
    "ActionCode": "ORA_FOM_APPLY_LINE_HOLD",
    "HoldCode": "QUALITY_CHECK_HOLD",  
    "Comments": "Item Lot Requires Quality Check",
    "requests": [
        {
            "FulfillLineId": 300100608313952
        },
        {
            "FulfillLineId": 300100608314073
        },
        {
            "FulfillLineId": 300100608314213
        }
    ]
}

Example 7 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to apply hold on three fulfillment lines with the Fulfill Line IDs mentioned in the request payload. The hold is applied on the lines through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the apply line hold request on the lines. You can also use the Get operation to check the status of the child action requests. It provides the status of the apply line hold request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_APPLY_LINE_HOLD",
    "ActionRequestId": 300100611832170,
    "ActionRequestTrackingId": 331038,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-04-29T09:01:09.002+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-04-29T09:01:09.264+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 312634,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Item Lot Requires Quality Check",
    "CancelReasonCode": null,
    "HoldCode": "QUALITY_CHECK_HOLD",
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_APPLY_LINE_HOLD",
            "ActionRequestId": 300100611832173,
            "ActionRequestTrackingId": 331038,
            "FulfillLineId": 300100608313952,
            "HeaderId": 300100608313927,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832173",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832173",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832173/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832173/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832173/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_APPLY_LINE_HOLD",
            "ActionRequestId": 300100611832174,
            "ActionRequestTrackingId": 331038,
            "FulfillLineId": 300100608314073,
            "HeaderId": 300100608314069,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832174",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832174",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832174/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832174/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832174/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_APPLY_LINE_HOLD",
            "ActionRequestId": 300100611832175,
            "ActionRequestTrackingId": 331038,
            "FulfillLineId": 300100608314213,
            "HeaderId": 300100608314211,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832175",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832175",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832175/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832175/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests/300100611832175/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611832170/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 8

This example describes how to create a sales order action request to release holds on multiple order lines.

Example 8 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100608313952, 300100608314073, and 300100608314213. You specify ActionCode: ORA_FOM_RELEASE_LINE_HOLD and HoldCode: QUALITY_CHECK_HOLD and HOLD_INVOICE_CREATION to indicate that the sales order action request is to release the QUALITY_CHECK_HOLD and HOLD_INVOICE_CREATION holds on all the three fulfillment lines. You can specify comma-separated HoldCode to release multiple holds on the lines in a request as illustrated in this example. You can also specify ReleaseReasonCode and comments, if needed. If you must send a ReleaseReasonCode, then set the RequireReasonCodeFlag to true. Otherwise, it's optional for you to send a ReleaseReasonCode. The FulfillLineId attribute carries the unique identifier of the order lines for releasing the line hold. You can release hold that's applied at the fulfillment line entity. You can't release hold that's applied at the order line entity.

{
    "ActionCode":"ORA_FOM_RELEASE_LINE_HOLD",
    "HoldCode": "QUALITY_CHECK_HOLD,HOLD_INVOICE_CREATION",
    "Comments": "Item Lot Passed Quality Check.Ready to Ship and Invoice",
    "ReleaseReasonCode": "PASSED_QUALITY_CHECK",
    "RequireReasonCodeFlag": true,
    "requests": [
         {
            "FulfillLineId": 300100608313952
        },
        {
            "FulfillLineId": 300100608314073
        },
        {
            "FulfillLineId": 300100608314213
        }
    ]
}

Example 8 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to release hold on three Fulfill Line IDs mentioned in the request payload. The hold is released on the lines through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the release line hold request on the lines. You can also use the Get operation to check the status of the child action requests. It provides the status of the release line hold request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RELEASE_LINE_HOLD",
    "ActionRequestId": 300100611833564,
    "ActionRequestTrackingId": 331049,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-04-29T09:29:14.126+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-04-29T09:29:14.469+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 316668,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": "Item Lot Passed Quality Check.Ready to Ship and Invoice",
    "CancelReasonCode": null,
    "HoldCode": "QUALITY_CHECK_HOLD,HOLD_INVOICE_CREATION",
    "ReleaseReasonCode": "PASSED_QUALITY_CHECK",
    "RequireReasonCodeFlag": "true",
    "requests": [
        {
            "ActionCode": "ORA_FOM_RELEASE_LINE_HOLD",
            "ActionRequestId": 300100611833569,
            "ActionRequestTrackingId": 331049,
            "FulfillLineId": 300100608313952,
            "HeaderId": 300100608313927,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833569",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833569",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833569/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833569/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833569/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_LINE_HOLD",
            "ActionRequestId": 300100611833570,
            "ActionRequestTrackingId": 331049,
            "FulfillLineId": 300100608314073,
            "HeaderId": 300100608314069,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833570",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833570",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833570/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833570/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833570/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_LINE_HOLD",
            "ActionRequestId": 300100611833571,
            "ActionRequestTrackingId": 331049,
            "FulfillLineId": 300100608314213,
            "HeaderId": 300100608314211,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833571",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833571",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833571/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833571/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests/300100611833571/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611833564/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 9

This example describes how to create a sales order action request to release pause task on multiple order lines.

Example 9 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. In this example you submit a sales order action request for three lines with Fulfill Line IDs 300100611851727, 300100611851778, and 300100611851919. You specify ActionCode: ORA_FOM_RELEASE_PAUSE_TASK to indicate that the sales order action request is to release pause task on all the three lines. The FulfillLineId attribute carries the unique identifier of the lines for releasing the pause task.

{
    "ActionCode": "ORA_FOM_RELEASE_PAUSE_TASK",
    "requests": [
        {
            "FulfillLineId": 300100611851727
        },
        {
            "FulfillLineId": 300100611851778
        },
        {
            "FulfillLineId": 300100611851919
        }
    ]
}

Example 9 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to release pause task on three Fulfill Line IDs mentioned in the request payload. The pause task on the lines are released through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the release pause task request on the lines. You can also use the Get operation to check the status of the child action requests. It provides the status of the status of release pause task request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RELEASE_PAUSE_TASK",
    "ActionRequestId": 300100611858237,
    "ActionRequestTrackingId": 331058,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-04-29T10:05:24.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-04-29T10:05:24.254+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 318216,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_RELEASE_PAUSE_TASK",
            "ActionRequestId": 300100611858238,
            "ActionRequestTrackingId": 331058,
            "FulfillLineId": 300100611851727,
            "HeaderId": 300100611851702,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858238",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858238",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858238/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858238/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858238/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_PAUSE_TASK",
            "ActionRequestId": 300100611858239,
            "ActionRequestTrackingId": 331058,
            "FulfillLineId": 300100611851778,
            "HeaderId": 300100611851702,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858239",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858239",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858239/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858239/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858239/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RELEASE_PAUSE_TASK",
            "ActionRequestId": 300100611858240,
            "ActionRequestTrackingId": 331058,
            "FulfillLineId": 300100611851919,
            "HeaderId": 300100611851917,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858240",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858240",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858240/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858240/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests/300100611858240/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version5/salesOrderActionRequests/300100611858237/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 10

This example describes how to create a sales order action request to schedule multiple order lines.

Example 10 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100615865777, 300100615865893, and 300100615865994. You specify ActionCode: ORA_FOM_SCHEDULE_LINE to indicate that the sales order action request is to schedule all the three lines. The FulfillLineId attribute carries the unique identifier of the lines to be scheduled.

{
    "ActionCode": "ORA_FOM_SCHEDULE_LINE",
    "requests": [
        {
            "FulfillLineId": 300100615865777
        },
        {
            "FulfillLineId": 300100615865893
        },
        {
            "FulfillLineId": 300100615865994
        }
    ]
}

Example 10 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to schedule three Fulfill Line IDs mentioned in the request payload. The order lines are scheduled through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the schedule line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the schedule line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_SCHEDULE_LINE",
    "ActionRequestId": 300100619025386,
    "ActionRequestTrackingId": 310764,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-07-30T14:49:25.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-07-30T14:49:25.191+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 209301,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_SCHEDULE_LINE",
            "ActionRequestId": 300100619025387,
            "ActionRequestTrackingId": 310764,
            "FulfillLineId": 300100615865777,
            "HeaderId": 300100615865752,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025387",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025387",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025387/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025387/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025387/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_SCHEDULE_LINE",
            "ActionRequestId": 300100619025388,
            "ActionRequestTrackingId": 310764,
            "FulfillLineId": 300100615865893,
            "HeaderId": 300100615865891,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025388",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025388",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025388/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025388/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025388/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_SCHEDULE_LINE",
            "ActionRequestId": 300100619025389,
            "ActionRequestTrackingId": 310764,
            "FulfillLineId": 300100615865994,
            "HeaderId": 300100615865990,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025389",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025389",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025389/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025389/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests/300100619025389/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619025386/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 11

This example describes how to create a sales order action request to unschedule multiple order lines.

Example 11 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100615865811, 300100615865895, and 300100615865992. You specify ActionCode: ORA_FOM_UNSCHEDULE_LINE to indicate that the sales order action request is to unschedule all the three lines. The FulfillLineId attribute carries the unique identifier of the lines to be unscheduled.

{
    "ActionCode": "ORA_FOM_UNSCHEDULE_LINE",
    "requests": [
        {
            "FulfillLineId": 300100615865811
        },
        {
            "FulfillLineId": 300100615865895
        },
        {
            "FulfillLineId": 300100615865992
        }
    ]
}

Example 11 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to unschedule three Fulfill Line IDs mentioned in the request payload. The order lines are unscheduled through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the unschedule line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the unschedule line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_UNSCHEDULE_LINE",
    "ActionRequestId": 300100619038592,
    "ActionRequestTrackingId": 310773,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-07-30T16:13:02.007+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-07-30T16:13:07.147+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 209438,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_UNSCHEDULE_LINE",
            "ActionRequestId": 300100619038593,
            "ActionRequestTrackingId": 310773,
            "FulfillLineId": 300100615865811,
            "HeaderId": 300100615865752,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038593",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038593",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038593/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038593/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038593/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UNSCHEDULE_LINE",
            "ActionRequestId": 300100619038594,
            "ActionRequestTrackingId": 310773,
            "FulfillLineId": 300100615865895,
            "HeaderId": 300100615865891,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038594",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038594",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038594/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038594/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038594/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UNSCHEDULE_LINE",
            "ActionRequestId": 300100619038595,
            "ActionRequestTrackingId": 310773,
            "FulfillLineId": 300100615865992,
            "HeaderId": 300100615865990,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038595",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038595",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038595/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038595/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests/300100619038595/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619038592/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 12

This example describes how to create a sales order action request to update multiple order lines.

Example 12 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100615865777, 300100615865893, and 300100619008728. You specify ActionCode: ORA_FOM_UPDATE_LINE and the values for OverrideScheduleDateFlag, ScheduleShipDate, ScheduleArrivalDate, and DemandClassCode attributes to indicate that the sales order action request is to update the new value of these attributes on all the three fulfillment lines. You can specify value for any attribute that's enabled for ORA_FOM_UPDATE_LINE action. If you want to remove the value of an attribute on a fulfillment line, then set the attribute value to null. You can also specify OrderRevisionReasonCode and OrderRevisionComments, if needed. The FulfillLineId attribute carries the unique identifier of the lines to be updated.

{
    "ActionCode": "ORA_FOM_UPDATE_LINE",
    "OverrideScheduleDateFlag": true,
    "ScheduleArrivalDate": "2024-08-23T20:49:12+00:00",
    "ScheduleShipDate": "2024-08-20T20:49:12+00:00",
    "DemandClassCode": "East-GOP",
    "OrderRevisionReasonCode": "ORA_CUST_REQUEST",
    "OrderRevisionComments": "Schedule change requested by customer.",
    "requests": [
        {
            "FulfillLineId": 300100615865777
        },
        {
            "FulfillLineId": 300100615865893
        },
        {
            "FulfillLineId": 300100619008728
        }
    ]
}

Example 12 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to update three Fulfill Line IDs mentioned in the request payload. The order lines are updated through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the update line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the update line request on each line and the corresponding error or warning details if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_UPDATE_LINE",
    "ActionRequestId": 300100619048861,
    "ActionRequestTrackingId": 312708,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-07-30T17:02:03.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-07-30T17:02:03.460+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 209700,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": "true",
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": "2024-08-20T20:49:12+00:00",
    "ScheduleArrivalDate": "2024-08-23T20:49:12+00:00",
    "DemandClassCode": "East-GOP",
    "OrderRevisionReasonCode": "ORA_CUST_REQUEST",
    "OrderRevisionComments": "Schedule change requested by customer.",
    "requests": [
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619048868,
            "ActionRequestTrackingId": 312708,
            "FulfillLineId": 300100615865777,
            "HeaderId": 300100615865752,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048868",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048868",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048868/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048868/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048868/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619048869,
            "ActionRequestTrackingId": 312708,
            "FulfillLineId": 300100615865893,
            "HeaderId": 300100615865891,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048869",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048869",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048869/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048869/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048869/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619048870,
            "ActionRequestTrackingId": 312708,
            "FulfillLineId": 300100619008728,
            "HeaderId": 300100619008722,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048870",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048870",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048870/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048870/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests/300100619048870/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619048861/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 13

This example describes how to create a sales order action request to reserve multiple order lines.

Example 13 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100618320918, 300100618472234, and 300100618055843. You specify ActionCode: ORA_FOM_RESERVE_LINE to indicate that the sales order action request is to reserve all the three lines. The FulfillLineId attribute carries the unique identifier of the lines to be reserved.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "requests": [
        {
            "FulfillLineId": 300100618320918
        },
        {
            "FulfillLineId": 300100618472234
        },
        {
            "FulfillLineId": 300100618055843
        }
    ]
}

Example 13 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to reserve three Fulfill Line IDs mentioned in the request payload. The order lines are reserved through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides the overall status of the reserve line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the reserve line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ActionRequestId": 300100619376014,
    "ActionRequestTrackingId": 334708,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-10-25T12:16:45.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-10-25T12:16:45.201+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 221203,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": null,
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100619376015,
            "ActionRequestTrackingId": 334708,
            "FulfillLineId": 300100618320918,
            "HeaderId": 300100618320794,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376015",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376015",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376015/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376015/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376015/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100619376016,
            "ActionRequestTrackingId": 334708,
            "FulfillLineId": 300100618472234,
            "HeaderId": 300100618472094,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376016",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376016",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376016/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376016/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376016/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100619376017,
            "ActionRequestTrackingId": 334708,
            "FulfillLineId": 300100618055843,
            "HeaderId": 300100618055837,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376017",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376017",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376017/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376017/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests/300100619376017/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376014/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 14

This example describes how to create a sales order action request to unreserve multiple order lines.

Example 14 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100618055843, 300100618472234, and 300100618472096. You specify ActionCode: ORA_FOM_UNRESERVE_LINE to indicate that the sales order action request is to unreserve all the three lines. The FulfillLineId attribute carries the unique identifier of the lines to be unreserved.

{
    "ActionCode": "ORA_FOM_UNRESERVE_LINE",
    "requests": [
        {
            "FulfillLineId": 300100618055843
        },
        {
            "FulfillLineId": 300100618472234
        },
        {
            "FulfillLineId": 300100618472096
        }
    ]
}

Example 14 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to unreserve three Fulfill Line IDs mentioned in the request payload. The order lines are reserved through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the unreserve line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the unreserve line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_UNRESERVE_LINE",
    "ActionRequestId": 300100619376127,
    "ActionRequestTrackingId": 334716,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-10-25T13:13:26.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-10-25T13:13:26.049+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 221367,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": null,
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_UNRESERVE_LINE",
            "ActionRequestId": 300100619376128,
            "ActionRequestTrackingId": 334716,
            "FulfillLineId": 300100618055843,
            "HeaderId": 300100618055837,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376128",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376128",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376128/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376128/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376128/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UNRESERVE_LINE",
            "ActionRequestId": 300100619376129,
            "ActionRequestTrackingId": 334716,
            "FulfillLineId": 300100618472234,
            "HeaderId": 300100618472094,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376129",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376129",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376129/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376129/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376129/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UNRESERVE_LINE",
            "ActionRequestId": 300100619376130,
            "ActionRequestTrackingId": 334716,
            "FulfillLineId": 300100618472096,
            "HeaderId": 300100618472094,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376130",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376130",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376130/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376130/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests/300100619376130/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619376127/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 15

This example describes how to create a sales order action request to update extensible flexfields on multiple order lines.

Example 15 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100618988498, 300100618770355, and 300100618768170. You specify ActionCode: ORA_FOM_UPDATE_LINE and the values for the extensible fields to indicate that the sales order action request is to update the new value of these extensible flexfields on all the three fulfillment lines. In this example, the extensible flexfileds being updated are Ship Instructions and Expected Pick Date in the Shipment Instructions ContextCode, and Deliver To in the Customer Fulfillment ContextCode. If you want to remove the value of an extensible flexfield on a fulfillment line, then set the extensible flexfield value to null. You can update standard attributes along with the extensible flexfields. You can also specify OrderRevisionReasonCode and OrderRevisionComments, if needed. The FulfillLineId attribute carries the unique identifier of the lines to be updated.

{
    "ActionCode": "ORA_FOM_UPDATE_LINE",
    "AdditionalInformation": "[{\"ContextCode\":\"Shipment Instructions\",\"Ship Instructions\":\"Ship all goods in single shipment\",\"Expected Pick Date\":\"2024-10-29T06:00:00+00:00\"},{\"ContextCode\":\"Customer Fulfillment\",\"Deliver To\":\"Alex, 13th street, New York 10012\"}]",
    "OrderRevisionReasonCode": "ORA_CUST_REQUEST",
    "OrderRevisionComments": "Changes requested by customer.",
    "requests": [
        {
            "FulfillLineId": 300100618988498
        },
        {
            "FulfillLineId": 300100618770355
        },
        {
            "FulfillLineId": 300100618768170
        }
    ]
}

Example 15 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to update three Fulfill Line IDs mentioned in the request payload. The order lines are updated through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides you the overall status of the update line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the update line request on each line and the corresponding error or warning details if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_UPDATE_LINE",
    "ActionRequestId": 300100619527878,
    "ActionRequestTrackingId": 335709,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2024-10-28T08:23:13.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2024-10-28T08:23:13.306+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 231976,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": "ORA_CUST_REQUEST",
    "OrderRevisionComments": "Changes requested by customer.",
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": "[{\"ContextCode\":\"Shipment Instructions\",\"Ship Instructions\":\"Ship all goods in single shipment\",\"Expected Pick Date\":\"2024-10-29T06:00:00+00:00\"},{\"ContextCode\":\"Customer Fulfillment\",\"Deliver To\":\"Alex, 13th street, New York 10012\"}]",
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619527884,
            "ActionRequestTrackingId": 335709,
            "FulfillLineId": 300100618988498,
            "HeaderId": 300100618988492,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527884",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527884",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527884/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527884/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527884/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619527885,
            "ActionRequestTrackingId": 335709,
            "FulfillLineId": 300100618770355,
            "HeaderId": 300100618770351,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527885",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527885",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527885/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527885/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527885/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_UPDATE_LINE",
            "ActionRequestId": 300100619527886,
            "ActionRequestTrackingId": 335709,
            "FulfillLineId": 300100618768170,
            "HeaderId": 300100618768157,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527886",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527886",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527886/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527886/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests/300100619527886/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100619527878/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 16

This example describes how to create a sales order action request to reserve multiple order lines using reservation priority.

Example 16 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100648176325, 300100648176357, and 300100648176422. You specify ActionCode ORA_FOM_RESERVE_LINE and ReservationPriority to indicate that the sales order action request is to reserve these lines according to the specified reservation priority. Order Management groups the order lines by item for reservation and makes sure that the order lines are reserved in the order of their priority. You can specify up to three attributes to prioritize your order lines for reservation. The attributes that you can use are ORDERED_DATE, REQUESTED_DATE, SCHEDULED_SHIP_DATE, SCHEDULED_ARRIVAL_DATE, or PROMISED_DATE. In this example, two PrioritizeBy attributes are specified. They're REQUESTED_DATE and ORDERED_DATE. The Sequence is specified as 1 and 2, and Sort as ASC and DESC respectively for these attributes. This means, these fulfillment lines need to be first sorted by the REQUESTED_DATE in ascending order, then by the ORDERED_DATE in descending order, and the sorted lines need to be reserved starting from the first line. The FulfillLineId attribute carries the unique identifier of the lines to be reserved.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ReservationPriority": "[{\"PrioritizeBy\":\"REQUESTED_DATE\",\"Sort\":\"ASC\",\"Sequence\":1},{\"PrioritizeBy\":\"ORDERED_DATE\",\"Sort\":\"DESC\",\"Sequence\":2}]",
    "requests": [
        {
            "FulfillLineId": 300100648176325
        },
        {
            "FulfillLineId": 300100648176357
        },
        {
            "FulfillLineId": 300100648176422
        }
    ]
}

Example 16 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to reserve three Fulfill Line IDs mentioned in the request payload. The order lines are reserved through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides the overall status of the reserve line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the reserve line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ActionRequestId": 300100648261036,
    "ActionRequestTrackingId": 367732,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2025-01-27T17:30:06.002+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2025-01-27T17:30:06.088+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 371549,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": null,
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "ShipToPartyId": null,
    "ShipToPartySiteId": null,
    "ShipToContactId": null,
    "ShipToContactPointId": null,
    "BillToCustomerId": null,
    "BillToAccountSiteUseId": null,
    "BillToContactId": null,
    "BillToContactPointId": null,
    "BillToAccountNumber": null,
    "ReservationPriority": "[{\"PrioritizeBy\":\"REQUESTED_DATE\",\"Sort\":\"ASC\",\"Sequence\":1},{\"PrioritizeBy\":\"ORDERED_DATE\",\"Sort\":\"DESC\",\"Sequence\":2}]",
    "ShipToPartyName": null,
    "ShipToPartyNumber": null,
    "ShipToAddress1": null,
    "ShipToAddress2": null,
    "ShipToAddress3": null,
    "ShipToAddress4": null,
    "ShipToCity": null,
    "ShipToState": null,
    "ShipToPostalCode": null,
    "ShipToCounty": null,
    "ShipToProvince": null,
    "ShipToCountry": null,
    "ShipToPartyContactName": null,
    "ShipToPartyContactNumber": null,
    "BillToCustomerName": null,
    "BillToAccountContactName": null,
    "BillToAccountContactNumber": null,
    "BillToAddress1": null,
    "BillToAddress2": null,
    "BillToAddress3": null,
    "BillToAddress4": null,
    "BillToCity": null,
    "BillToState": null,
    "BillToCounty": null,
    "BillToProvince": null,
    "BillToPostalCode": null,
    "BillToCountry": null,
    "AccountingRuleCode": null,
    "AccountingRule": null,
    "InvoicingRuleCode": null,
    "InvoicingRule": null,
    "SubstitutionAllowedFlag": null,
    "TaxClassificationCode": null,
    "TaxClassification": null,
    "TransactionBusinessCategory": null,
    "TransactionBusinessCategoryName": null,
    "ThirdPartyTaxRegistration": null,
    "ThirdPartyTaxRegistrationNumber": null,
    "ContractStartDateTime": null,
    "ContractEndDateTime": null,
    "FinalDischargeLocationId": null,
    "ProductFiscalCategoryId": null,
    "ProductFiscalCategory": null,
    "IntendedUseClassificationId": null,
    "IntendedUseClassification": null,
    "BillingTransactionTypeId": null,
    "BillingTransactionTypeName": null,
    "ServiceDuration": null,
    "ServiceDurationPeriodCode": null,
    "ServiceDurationPeriodName": null,
    "FinalDischargeLocationAddressLine1": null,
    "FinalDischargeLocationAddressLine2": null,
    "FinalDischargeLocationAddressLine3": null,
    "FinalDischargeLocationAddressLine4": null,
    "FinalDischargeLocationAddressCity": null,
    "FinalDischargeLocationAddressPostalCode": null,
    "FinalDischargeLocationAddressState": null,
    "FinalDischargeLocationAddressProvince": null,
    "FinalDischargeLocationAddressCounty": null,
    "FinalDischargeLocationAddressCountry": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100648261038,
            "ActionRequestTrackingId": 367732,
            "FulfillLineId": 300100648176325,
            "HeaderId": 300100648176300,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261038",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261038",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261038/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261038/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261038/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100648261039,
            "ActionRequestTrackingId": 367732,
            "FulfillLineId": 300100648176357,
            "HeaderId": 300100648176300,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261039",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261039",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261039/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261039/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261039/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100648261040,
            "ActionRequestTrackingId": 367732,
            "FulfillLineId": 300100648176422,
            "HeaderId": 300100648176397,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261040",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261040",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261040/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261040/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests/300100648261040/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100648261036/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 17

This example describes how to create a sales order action request to reserve multiple order lines using a reservation priority rule.

Example 17 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100640444064, 300100640444189, and 300100640444292. The ordered item on these fulfillment lines is the same. You specify ActionCode ORA_FOM_RESERVE_LINE and ReservationPriorityRuleName to indicate that the sales order action request is to reserve these lines according to the priority of attributes and its sorting order in the specified reservation priority rule. The reservation priority rule is set up on the Reservation Priority page in the Order Management work area. You can specify up to three attributes in a reservation priority rule to prioritize your order lines for reservation. In this example, the reservation priority rule Prioritize Export Orders and by SSD is set up with two attributes, Order Type and Scheduled Ship Date with priority 1 and 2 respectively. The Order Type attribute is set up to sort in the order of Export Order, then other order types. Scheduled Ship Date is set up to sort in ascending order. This means, these fulfillment lines first need to be sorted by Order Type, then by Scheduled Ship Date using the respective sort order specified in the reservation priority rule, and reserve the sorted lines starting from the first line. Order Management groups the order lines by item before applying the reservation priority rule. The FulfillLineId attribute carries the unique identifier of the lines to be reserved.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ReservationPriorityRuleName": "Prioritize Export Orders and by SSD",
    "requests": [
        {
            "FulfillLineId": 300100640444064
        },
        {
            "FulfillLineId": 300100640444189
        },
        {
            "FulfillLineId": 300100640444292
        }
    ]
}

Example 17 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to reserve three Fulfill Line IDs mentioned in the request payload. The order lines are reserved through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides the overall status of the reserve line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the reserve line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ActionRequestId": 300100640480792,
    "ActionRequestTrackingId": 281708,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2025-05-01T10:44:22.002+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2025-05-01T10:44:22.136+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 53226,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": null,
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "ShipToPartyId": null,
    "ShipToPartySiteId": null,
    "ShipToContactId": null,
    "ShipToContactPointId": null,
    "BillToCustomerId": null,
    "BillToAccountSiteUseId": null,
    "BillToContactId": null,
    "BillToContactPointId": null,
    "BillToAccountNumber": null,
    "ReservationPriority": null,
    "ShipToPartyName": null,
    "ShipToPartyNumber": null,
    "ShipToAddress1": null,
    "ShipToAddress2": null,
    "ShipToAddress3": null,
    "ShipToAddress4": null,
    "ShipToCity": null,
    "ShipToState": null,
    "ShipToPostalCode": null,
    "ShipToCounty": null,
    "ShipToProvince": null,
    "ShipToCountry": null,
    "ShipToPartyContactName": null,
    "ShipToPartyContactNumber": null,
    "BillToCustomerName": null,
    "BillToAccountContactName": null,
    "BillToAccountContactNumber": null,
    "BillToAddress1": null,
    "BillToAddress2": null,
    "BillToAddress3": null,
    "BillToAddress4": null,
    "BillToCity": null,
    "BillToState": null,
    "BillToCounty": null,
    "BillToProvince": null,
    "BillToPostalCode": null,
    "BillToCountry": null,
    "AccountingRuleCode": null,
    "AccountingRule": null,
    "InvoicingRuleCode": null,
    "InvoicingRule": null,
    "SubstitutionAllowedFlag": null,
    "TaxClassificationCode": null,
    "TaxClassification": null,
    "TransactionBusinessCategory": null,
    "TransactionBusinessCategoryName": null,
    "ThirdPartyTaxRegistration": null,
    "ThirdPartyTaxRegistrationNumber": null,
    "ContractStartDateTime": null,
    "ContractEndDateTime": null,
    "FinalDischargeLocationId": null,
    "ProductFiscalCategoryId": null,
    "ProductFiscalCategory": null,
    "IntendedUseClassificationId": null,
    "IntendedUseClassification": null,
    "BillingTransactionTypeId": null,
    "BillingTransactionTypeName": null,
    "ServiceDuration": null,
    "ServiceDurationPeriodCode": null,
    "ServiceDurationPeriodName": null,
    "FinalDischargeLocationAddressLine1": null,
    "FinalDischargeLocationAddressLine2": null,
    "FinalDischargeLocationAddressLine3": null,
    "FinalDischargeLocationAddressLine4": null,
    "FinalDischargeLocationAddressCity": null,
    "FinalDischargeLocationAddressPostalCode": null,
    "FinalDischargeLocationAddressState": null,
    "FinalDischargeLocationAddressProvince": null,
    "FinalDischargeLocationAddressCounty": null,
    "FinalDischargeLocationAddressCountry": null,
    "InventoryItemId": null,
    "SubstituteReasonCode": null,
    "ReservationPriorityRuleId": null,
    "ReservationPriorityRuleName": "Prioritize Export Orders and by SSD",
    "requests": [
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480794,
            "ActionRequestTrackingId": 281708,
            "FulfillLineId": 300100640444064,
            "HeaderId": 300100640444056,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480794",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480794",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480794/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480794/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480794/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480795,
            "ActionRequestTrackingId": 281708,
            "FulfillLineId": 300100640444189,
            "HeaderId": 300100640444187,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480795",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480795",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480795/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480795/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480795/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480796,
            "ActionRequestTrackingId": 281708,
            "FulfillLineId": 300100640444292,
            "HeaderId": 300100640444290,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480796",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480796",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480796/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480796/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests/300100640480796/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480792/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}

Example 18

This example describes how to create a sales order action request to reserve multiple order lines using reservation priority attributes that aren't of type DATE.

Example 18 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. In this example you submit a sales order action request for three fulfillment lines with Fulfill Line IDs 300100640444401, 300100640444517, and 300100640482620. The ordered item on these fulfillment lines is the same. You specify ActionCode ORA_FOM_RESERVE_LINE and ReservationPriority to indicate that the sales order action request is to reserve these lines according to the specified PrioritizeBy attributes and its sequence. It also uses the default sorting order that you set up for these attributes on the Reservation Priority page in the Order Management work area to prioritize the lines for reservation. The attributes you can use that aren't of type DATE are ORDER_TYPE, SHIPMENT_PRIORITY, CUSTOMER, DEMAND_CLASS, SALES_CHANNEL, and CUSTOMER_CLASS. The DATE type attributes that you can use are ORDERED_DATE, REQUESTED_DATE, SCHEDULED_SHIP_DATE, SCHEDULED_ARRIVAL_DATE, and PROMISED_DATE. You can specify any and up to three attributes to prioritize your order lines for reservation. In this example, two PrioritizeBy attributes are specified, ORDER_TYPE and SHIPMENT_PRIORITY. The sequence is specified as 1 and 2 respectively for these attributes. The default sorting order for the ORDER_TYPE attribute is set up to sort in the order of Export Order, then other types of orders, and SHIPMENT_PRIORITY is set up to sort in the order of High, Medium, and Low. This means, these fulfillment lines first need to be sorted by ORDER_TYPE, then by SHIPMENT_PRIORITY using the respective sort order specified in the default sorting order setup, and reserve the sorted lines starting from the first line. Order Management groups the order lines by item before applying the reservation priority. The FulfillLineId attribute carries the unique identifier of the lines to be reserved.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ReservationPriority":"[{\"PrioritizeBy\":\"ORDER_TYPE\",\"Sequence\":1},{\"PrioritizeBy\":\"SHIPMENT_PRIORITY\",\"Sequence\":2}]",
    "requests": [
        {
            "FulfillLineId": 300100640444401
        },
        {
            "FulfillLineId": 300100640444517
        },
        {
            "FulfillLineId": 300100640482620
        }
    ]
}

Example 18 Response Body

The following example includes the contents of the response body in JSON format. You can see one master request and three child action requests to reserve three Fulfill Line IDs mentioned in the request payload. The order lines are reserved through a batch process. The response shows StatusCode as PRE_PROCESSING and ProcessStatus as IN_QUEUE as the batch process is yet to start processing. You can use the Get operation to check the status of the sales order action request. It provides the overall status of the reserve line request. You can also use the Get operation to check the status of the child action requests. It provides the status of the reserve line request on each line and the corresponding error or warning details, if any.

For details, see the use cases for Order Management.

{
    "ActionCode": "ORA_FOM_RESERVE_LINE",
    "ActionRequestId": 300100640480223,
    "ActionRequestTrackingId": 282709,
    "CreatedBy": "SCMOPERATIONS",
    "CreationDate": "2025-05-01T11:42:50.001+00:00",
    "FulfillLineId": null,
    "HeaderId": -1,
    "LastUpdateDate": "2025-05-01T11:42:50.114+00:00",
    "MassActionFlag": true,
    "OutcomeCode": null,
    "StatusCode": "PRE_PROCESSING",
    "Action": null,
    "ProcessId": 53616,
    "TotalRecords": 3,
    "TotalFailed": 0,
    "TotalPassed": 0,
    "ProcessStatus": "IN_QUEUE",
    "FilterCriteria": null,
    "Comments": null,
    "CancelReasonCode": null,
    "HoldCode": null,
    "ReleaseReasonCode": null,
    "RequireReasonCodeFlag": null,
    "OverrideScheduleDateFlag": null,
    "ShippingModeCode": null,
    "SupplierSiteId": null,
    "SupplierId": null,
    "RequestedFulfillmentOrganizationId": null,
    "ShippingCarrierId": null,
    "ShippingServiceLevelCode": null,
    "ScheduleShipDate": null,
    "ScheduleArrivalDate": null,
    "DemandClassCode": null,
    "OrderRevisionReasonCode": null,
    "OrderRevisionComments": null,
    "RequestedFulfillmentOrganizationCode": null,
    "RequestedFulfillmentOrganizationName": null,
    "DemandClass": null,
    "CustomerPONumber": null,
    "ShipmentPriorityCode": null,
    "SalespersonId": null,
    "ShippingInstructions": null,
    "PaymentTermsCode": null,
    "TransactionLineTypeCode": null,
    "FreightTermsCode": null,
    "FOBPointCode": null,
    "PackingInstructions": null,
    "EnforceSingleShipmentFlag": null,
    "CancelBackordersFlag": null,
    "RequestTypeCode": null,
    "CustomerPOLineNumber": null,
    "ShipSetName": null,
    "RequestedDate": null,
    "EarliestAcceptableDate": null,
    "LatestAcceptableDate": null,
    "ShippingCarrier": null,
    "SupplierName": null,
    "SupplierSiteName": null,
    "ShippingServiceLevel": null,
    "ShippingMode": null,
    "AdditionalInformation": null,
    "ShipmentPriority": null,
    "FreightTerms": null,
    "RequestType": null,
    "FOBPoint": null,
    "PaymentTerms": null,
    "Subinventory": null,
    "SubinventoryCode": null,
    "ShipToPartyId": null,
    "ShipToPartySiteId": null,
    "ShipToContactId": null,
    "ShipToContactPointId": null,
    "BillToCustomerId": null,
    "BillToAccountSiteUseId": null,
    "BillToContactId": null,
    "BillToContactPointId": null,
    "BillToAccountNumber": null,
    "ReservationPriority": "[{\"PrioritizeBy\":\"ORDER_TYPE\",\"Sequence\":1},{\"PrioritizeBy\":\"SHIPMENT_PRIORITY\",\"Sequence\":2}]",
    "ShipToPartyName": null,
    "ShipToPartyNumber": null,
    "ShipToAddress1": null,
    "ShipToAddress2": null,
    "ShipToAddress3": null,
    "ShipToAddress4": null,
    "ShipToCity": null,
    "ShipToState": null,
    "ShipToPostalCode": null,
    "ShipToCounty": null,
    "ShipToProvince": null,
    "ShipToCountry": null,
    "ShipToPartyContactName": null,
    "ShipToPartyContactNumber": null,
    "BillToCustomerName": null,
    "BillToAccountContactName": null,
    "BillToAccountContactNumber": null,
    "BillToAddress1": null,
    "BillToAddress2": null,
    "BillToAddress3": null,
    "BillToAddress4": null,
    "BillToCity": null,
    "BillToState": null,
    "BillToCounty": null,
    "BillToProvince": null,
    "BillToPostalCode": null,
    "BillToCountry": null,
    "AccountingRuleCode": null,
    "AccountingRule": null,
    "InvoicingRuleCode": null,
    "InvoicingRule": null,
    "SubstitutionAllowedFlag": null,
    "TaxClassificationCode": null,
    "TaxClassification": null,
    "TransactionBusinessCategory": null,
    "TransactionBusinessCategoryName": null,
    "ThirdPartyTaxRegistration": null,
    "ThirdPartyTaxRegistrationNumber": null,
    "ContractStartDateTime": null,
    "ContractEndDateTime": null,
    "FinalDischargeLocationId": null,
    "ProductFiscalCategoryId": null,
    "ProductFiscalCategory": null,
    "IntendedUseClassificationId": null,
    "IntendedUseClassification": null,
    "BillingTransactionTypeId": null,
    "BillingTransactionTypeName": null,
    "ServiceDuration": null,
    "ServiceDurationPeriodCode": null,
    "ServiceDurationPeriodName": null,
    "FinalDischargeLocationAddressLine1": null,
    "FinalDischargeLocationAddressLine2": null,
    "FinalDischargeLocationAddressLine3": null,
    "FinalDischargeLocationAddressLine4": null,
    "FinalDischargeLocationAddressCity": null,
    "FinalDischargeLocationAddressPostalCode": null,
    "FinalDischargeLocationAddressState": null,
    "FinalDischargeLocationAddressProvince": null,
    "FinalDischargeLocationAddressCounty": null,
    "FinalDischargeLocationAddressCountry": null,
    "InventoryItemId": null,
    "SubstituteReasonCode": null,
    "ReservationPriorityRuleId": null,
    "ReservationPriorityRuleName": null,
    "requests": [
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480225,
            "ActionRequestTrackingId": 282709,
            "FulfillLineId": 300100640444401,
            "HeaderId": 300100640444399,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480225",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480225",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480225/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480225/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480225/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480226,
            "ActionRequestTrackingId": 282709,
            "FulfillLineId": 300100640444517,
            "HeaderId": 300100640444515,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480226",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480226",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480226/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480226/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480226/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        },
        {
            "ActionCode": "ORA_FOM_RESERVE_LINE",
            "ActionRequestId": 300100640480227,
            "ActionRequestTrackingId": 282709,
            "FulfillLineId": 300100640482620,
            "HeaderId": 300100640482618,
            "MassActionFlag": false,
            "OutcomeCode": null,
            "StatusCode": "PRE_PROCESSING",
            "SummaryMessageText": null,
            "RequestStatus": "IN_QUEUE",
            "SplitFromFlineId": null,
            "FlineObjectVersionNumber": null,
            "OrderedQuantity": null,
            "FulfillOrgId": null,
            "CarrierId": null,
            "ShipClassOfService": null,
            "ShipModeOfTransport": null,
            "SupplierId": null,
            "SupplierSiteId": null,
            "DemandClassCode": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480227",
                    "name": "requests",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480227",
                    "name": "requests",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223",
                    "name": "salesOrderActionRequests",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480227/child/messageDetails",
                    "name": "messageDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480227/child/orderDetails",
                    "name": "orderDetails",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests/300100640480227/child/orderLineDetails",
                    "name": "orderLineDetails",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223",
            "name": "salesOrderActionRequests",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223",
            "name": "salesOrderActionRequests",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/salesOrderActionRequests/300100640480223/child/requests",
            "name": "requests",
            "kind": "collection"
        }
    ]
}
Back to Top