Withdraw a Requisition Header or Line

You can withdraw a requisition from the approval process to make some changes to it or to route the requisition to another approver. You can use the Withdraw user-defined action on the Purchase Requisitions REST resource for a requisition or a requisition line that is pending approval, or approved. If it is approved, then the requisition lines must not be associated with a purchase order, transfer order, awarded negotiation, or pending buyer modification. Withdrawing all the lines in a requisition withdraws the requisition.

After a Withdraw operation, the requisition is removed from the approval process or from the Approved status. The requisition line status changes to Withdrawn. The requisition status also changes to Withdrawn when all active lines in the requisition are withdrawn. The document history is updated with entries for the header and line status changes. You can then patch requisition lines and requisitions with Withdrawn status. You can also add new lines when there's at least one line in the requisition with Withdrawn status.

You should be the preparer of the requisition to be able to withdraw a requisition or a requisition line.

Let's discuss these scenarios briefly.

• Withdraw a pending-approval requisition.

• Withdraw an approved line not yet associated with a downstream document and not pending the buyer's processing.

Withdraw a Pending-Approval Requisition

Let's consider that Jim Kenworthy, who is a preparer in an organization, submitted a requisition to order office supplies for a team of project leads. While the requisition is still pending approval, Jim receives another request for more office supplies. Since the requisition is still in the early stage of approval, Jim decides to withdraw the requisition to make some changes to it.

After the requisition is withdrawn, Jim can patch the lines to update the quantity, add new lines, and resubmit the requisition for approval.

Example URL

Use this resource URL format:

POST

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

Example Request

Here's an example of the request body in JSON format:

{
    "name":"withdraw",
    "parameters":[]
}

Example Response

Here's an example of the response body in JSON format:

{
    "result": {
        "STATUS": [
            {
                "CODE": "SUCCESS"
            }
        ]
    }
}

Withdraw an Approved Requisition Line Not Associated with a Downstream Document and Not Pending Buyer's Processing

Let's consider that Jim Kenworthy, who is a preparer in an organization, submitted a requisition to order office supplies for a team of project leads. After the requisition was approved, Jim realized that he had ordered more notebooks than was necessary. Since the requisition is already approved, Jim decides to withdraw just the requisition line for the notebooks to reduce the quantity to be purchased.

After the line is withdrawn, Jim can patch the line to update the quantity and resubmit it for approval. To take advantage of the fact that there's now one line with Withdrawn status, Jim can also post new lines and submit the updates for approval.

Example URL

Use this resource URL format:

POST

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

Example Request

Here's an example of the request body in JSON format:

{
    "name":"withdraw",
    "parameters":[]
}

Example Response

Here's an example of the response body in JSON format:

{
    "result": {
        "STATUS": [
            {
                "CODE": "SUCCESS"
            }
        ]
    }
}