Jump to

• Request
• Response
• Examples

Create one cancellation request

post

/fscmRestApi/resources/11.13.18.05/inventoryMovementRequests/action/cancelLineQuantity

Creates a cancellation request by passing the cancellation quantity and allocated quantity.

Request

Header Parameters

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/vnd.oracle.adf.action+json

Request Body - application/vnd.oracle.adf.action+json ()

Root Schema : schema

Type: object

Show Source

• allocatedQuantity: number
• allocatedQuantityUOM: string
• cancelledQuantity: number
• cancelledQuantityUOM: string
• headerId: number
• headerNumber: string
• lineId: number
• lineNumber: number
• organizationCode: string
• organizationId: number

{
    "type":"object",
    "properties":{
        "organizationId":{
            "type":"number",
            "nullable":true
        },
        "organizationCode":{
            "type":"string",
            "nullable":true
        },
        "cancelledQuantity":{
            "type":"number",
            "nullable":true
        },
        "cancelledQuantityUOM":{
            "type":"string",
            "nullable":true
        },
        "allocatedQuantity":{
            "type":"number",
            "nullable":true
        },
        "headerNumber":{
            "type":"string",
            "nullable":true
        },
        "lineId":{
            "type":"number",
            "nullable":true
        },
        "lineNumber":{
            "type":"number",
            "nullable":true
        },
        "headerId":{
            "type":"number",
            "nullable":true
        },
        "allocatedQuantityUOM":{
            "type":"string",
            "nullable":true
        }
    },
    "additionalProperties":false
}

Back to Top

Response

Supported Media Types

• application/json
• application/vnd.oracle.adf.actionresult+json

Default Response

The following table describes the default response for this task.

Body ()

Root Schema : schema

Type: object

Show Source

• result(required): object result
  Additional Properties Allowed: additionalProperties

  Returns the line status and message, along with other details.

{
    "required":[
        "result"
    ],
    "type":"object",
    "properties":{
        "result":{
            "type":"object",
            "additionalProperties":{
                "type":"string"
            },
            "description":"Returns the line status and message, along with other details."
        }
    },
    "additionalProperties":false
}

Nested Schema : result

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    },
    "description":"Returns the line status and message, along with other details."
}

Returns the line status and message, along with other details.

Back to Top

Examples

These examples describe how to create one cancellation request.

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/inventoryMovementRequests/action/cancelLineQuantity"

For example:

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

Example 1

This example describes how to cancel a movement request line interfaced with a WMS.

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.

{
"headerNumber": 5597988,
"headerId":5597988,
"lineNumber" :1,
"lineId" : 4301066,
"organizationCode" :"M3",
"cancelledQuantity":99,
"cancelledQuantityUOM":"Ea",
"allocatedQuantity":99,
"allocatedQuantityUOM":"Ea"
}

Example 1 Response Body

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

{
    "result": {
        "HeaderNumber": "5597988",
        "HeaderId": "5597988",
        "LineNumber": "1",
        "LineId": "4301066",
        "OrganizationId": "606",
        "OrganizationCode": "M3",
        "CancelledQuantity": "99",
        "CancelledQuantityUOM": "Ea",
        "AllocatedQuantity": "99",
        "AllocatedQuantityUOM": "Ea",
        "ReturnStatus": "SUCCESS",
        "LineStatus": "Preapproved"
    }
}

Example 2

This example describes how to cancel partial quantities for a movement request line interfaced with a WMS.

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.

{
"headerNumber": 5597007,
"headerId":5597007,
"lineNumber" :2,
"lineId" : 4300116,
"organizationCode" :"M3",
"cancelledQuantity":5,
"cancelledQuantityUOM":"Ea",
"allocatedQuantity":10,
"allocatedQuantityUOM":"Ea"
}

Example 2 Response Body

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

{
    "result": {
        "HeaderNumber": "5597007",
        "HeaderId": "5597007",
        "LineNumber": "2",
        "LineId": "4300116",
        "OrganizationId": "606",
        "OrganizationCode": "M3",
        "CancelledQuantity": "5",
        "CancelledQuantityUOM": "Ea",
        "AllocatedQuantity": "10",
        "AllocatedQuantityUOM": "Ea",
        "ReturnStatus": "SUCCESS",
        "LineStatus": "Preapproved"
    }
}

Back to Top