Submit Requisitions with Insufficient Funds Override Request

When you enable budgetary control in a business unit, you can control spending by checking and reserving funds for your transactions.

Transaction Failed Budgetary Control Validation and Funds Override Request is Possible

You can use budgetary controls to define insufficient funds override rules and approvers for requisitions. With the purchaseRequisitions resource, you can submit requisitions for approval and request insufficient funds override, if an override is possible. For requisitions submitted for approval with funds override request, the commitment funds are reserved only after the requisition is successfully approved regardless of the reservation point defined for your business unit.

When control budgets are defined with override rules and approver, users who are assigned a role that contains the following privilege can submit requisitions and request insufficient funds override:

• Request Budgetary Control Override (XCC_REQUEST_BUDGETARY_CONTROL_OVERRIDE_PRIV)

Let's discuss this scenario.

• A transaction failed budgetary control validation due to insufficient funds, and insufficient funds override request is possible.

Let's consider that Jim Kenworthy, who is a preparer in Vision City Organization, wants to submit a requisition to order some items for the City Manager department. Since the spending-control level for this department is absolute, then in case of insufficient funds Jim won't be able to submit the requisition for approval until the budget issue is resolved.

After creating the requisition, Jim can check funds availability for his order.

Example URL

Use this resource URL format:

POST

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+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":"checkFunds",
    "parameters": [{"fundsCheckType":"REQ_CHECK_MANUALLY"}]
}

Example Response

Here's s an example of the response body in JSON format for this use case:

1  The requisition didn't pass the funds check, but an override is available. You can submit the requisition for an insufficient funds override approval. (POR-2011304)

From the check funds response, Jim noticed that he has the option to submit the requisition for an insufficient funds override approval. Given the urgency of this purchase for the City Manager department, Jim will submit the requisition requesting the funds override approval.

First, Jim needs to patch the requisition header to provide a justification for the override request. A justification is required to submit the requisition with insufficient funds override request. Then, he can submit the requisition with the funds override request by setting the optional parameter to true. Assuming Jim updated the requisition header with the justification, Jim now submits the requisition.

Example URL

Use this resource URL format:

POST

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

Example Request

Here's s an example of the request body in JSON format for this use case:

{
    "name": "submitRequisition",
    "parameters": [
        {
            "requestFundsOverrideFlag": "true"
        }
    ]
}

Example Response

Here's s an example of the response body in JSON format for this use case:

{
    "result": "SUCCESS"
}

As the final stage of the approval process, the requisition will be sent for approval to the funds override approver designated in the control budget. After the requisition is successfully approved, then the commitment funds will be reserved for the requisition.