App-po-14160 Document Action Not Completed Successupdated Fully May 2026
The error code APP-PO-14160: Document action not completed successfully is a common validation error in Oracle E-Business Suite (Purchasing module). It occurs when a user attempts to perform a control action—such as cancelling, closing, or finally closing a document—that is restricted by the document's current state or underlying data issues. Core Causes
The primary reason for this error is a mismatch between the requested action and the document status. Specific triggers include:
Status Conflicts: Attempting to cancel or close a document that is already in a terminal state (e.g., already cancelled or finally closed) or in a transitional state (e.g., Pending Approval).
Internal Dependencies: Trying to cancel a Purchase Order (PO) derived from an internal requisition or one with linked sales order lines that are still open.
Fully Received Lines: The system prevents cancellation of lines that have been fully received or where the received quantity has already been consumed by the warehouse.
Account Issues: A disabled or inactive charge account on the PO distributions can block completion of document actions.
Software Bugs: Known bugs in specific Oracle versions (e.g., R12) often require patches like PSA RPC Patch 14563642 or referring to Oracle Support Note 1912083.1. Recommended Troubleshooting Steps APP-PO-14160: Document Action Not Completed Successfully
Case Study: Real-World Resolution of Error 14160
Company: Mid-sized manufacturing firm using Microsoft Dynamics 365 Finance and Operations.
Problem: A procurement manager repeatedly received "app-po-14160 document action not completed successfully" when trying to approve a $50,000 PO for raw steel.
Initial troubleshooting:
- PO was created, went through two approval levels, but failed at the final approval.
- No locks, no other users active.
Root cause discovered via event log: The PO was linked to a vendor who had been marked "Inactive" the previous day by the AP team. The approval workflow had a validation rule: "Cannot approve PO for inactive vendor."
Solution:
- AP team reactivated the vendor record.
- Buyer changed one character in the PO description and saved (forcing a refresh of vendor validation).
- Approval succeeded immediately.
Lesson: Always check related master data (vendors, items, accounts) for status changes that could trigger a hidden validation failure.
5. Concurrent Processing Overlap
If another user or background process is modifying the same document simultaneously, the system may lock the record. The app-po-14160 error can appear when a process tries to update a PO that is currently locked.
3. Data Integrity Violations
Corrupt or inconsistent data in the background tables can trigger the error. This includes:
- Missing supplier information.
- Invalid item categories or conversions.
- Price or quantity mismatches against a blanket purchase agreement (BPA).
Conclusion
The "app-po-14160 document action not completed successfully" error is frustrating but rarely insurmountable. In most cases, the issue lies outside the user’s control—a broken approval chain, a locked document, or a budget check failure. By following a logical troubleshooting path (check status → review workflow → validate data → examine budget), most procurement professionals can resolve it without developer intervention.
When technical help is required, providing clear logs and understanding the context of the failed action will accelerate the fix. Ultimately, consistent data governance and workflow maintenance are the best long-term defenses against this and similar document processing errors.
If this guide resolved your issue, share it with your team to reduce future downtime. And if you’re still stuck, consult your system administrator with the troubleshooting steps you have already attempted.
Keywords: app-po-14160, document action not completed successfully, purchase order error, Oracle PO workflow issue, fix app-po-14160.
The error APP-PO-14160: Document action not completed successfully typically occurs in Oracle E-Business Suite when a user attempts to perform a control action (like canceling or finally closing) on a document whose current status or underlying data prevents that action. Common Causes & Solutions
Incompatible Document Status: The most frequent cause is trying to perform an action (e.g., "Cancel PO") that is not allowed for the document's current state (e.g., it is already "Fully Received" or has "In Process" approval).
Check: Use the Purchase Order Summary form to verify the current status of the document.
Stuck Receiving Transactions: Unprocessed or stuck transactions in the receiving interface can block control actions.
Check: Navigate to Receiving > Transaction Status Summary to see if any records are stuck for that PO. Clearing these records often resolves the block.
Inactive Accounts: The error can trigger if the charge account associated with the PO line is no longer active or enabled. Check: Verify the account status in the General Ledger.
Known System Bugs: This error is sometimes linked to specific Oracle bugs that require patches (e.g., Note 1912083.1).
Check: Consult My Oracle Support (MOS) for specific notes related to your EBS version. Quick Troubleshooting Steps APP-PO-14160: Document Action Not Completed Successfully app-po-14160 document action not completed successfully
The error "app-po-14160: Document action not completed successfully" is a generic but frustrating Oracle EBS failure that usually points to a data inconsistency in the purchasing workflow [1, 2]. Why this happens
This error typically occurs when the system cannot move a document (like a Purchase Order or Requisition) to the next status. Common culprits include:
Stuck Workflows: The background process for approvals has stalled or errored out [2, 3].
Inconsistent Data: The document status in the header doesn't match the status in the action history [1, 4].
Missing Setup: A change in the approval hierarchy (like a deleted user or missing supervisor) has left the document with nowhere to go [3]. How to fix it
Check Workflow Status: Run the "Workflow Background Process" for the PO Approval item type. This often pushes "stuck" documents through [2, 3].
Verify the Approval Hierarchy: Ensure the requester and the next approver in the chain are active and have the correct job/position assignments [3, 4].
Data Cleanup (DBA Level): If the workflow is fine, a developer may need to check the PO_HEADERS_ALL table. If the AUTHORIZATION_STATUS is 'IN PROCESS' but there are no active workflow activities, the status may need to be reset via a data fix script [1, 4].
Review System Logs: Check the FND Log at the time of the error for more specific details, such as a "Unique Constraint" or "Null Value" error hidden behind the generic message [5].
The error code APP-PO-14160: Document action not completed successfully is a common hurdle found in Oracle E-Business Suite (EBS), specifically within the Purchasing module. It typically pops up when a user tries to approve, reserve, or forward a document (like a Purchase Order or Requisition) and the system hits a logical "dead end." 1. The "Why" Behind the Error
This isn't usually a bug in the code, but rather a data integrity check failing. The system is essentially saying, "I tried to process this, but something about the document's current state or the setup doesn't add up." Common culprits include:
The Approval Loop: The document is stuck in a "Pre-Approved" or "In Process" status because the next person in the hierarchy doesn't have enough signing authority or isn't assigned a proper position.
Budgetary Control: If your organization uses Encumbrance Accounting, the error often triggers because there are insufficient funds in the specific GL account, or the budget period is closed.
Inactive Users: The person who originally created the document or the next approver in the chain has been deactivated in the system. 2. How to "Unstick" It
If you are troubleshooting this, the "interesting" part is that the fix is almost never on the document itself, but in the Workflow:
Check the Workflow Monitor: This is the "X-ray" for Oracle EBS. It will show exactly which activity failed (e.g., Is_Forward_To_Valid or Reserve_Action).
The "Reset" Script: Oracle provides a specific script (porvdoc.sql) that DBAs use to "force-reset" a document's status back to 'Incomplete' so it can be re-submitted correctly.
Verify the Employee-Supervisor Hierarchy: Ensure there isn't a "broken link" in the chain. If a manager left the company and their supervisor link wasn't updated, the document has nowhere to go. 3. A Pro-Tip for Techies
The error is often a "wrapper." If you look at the underlying PO_ACTION_HISTORY, you might find a more descriptive sub-error. Usually, if APP-PO-14160 appears alongside a message about "Tax Calculation," the issue is actually in the E-Business Tax (eBTax) module failing to calculate a rate, which then halts the entire PO approval. Are you seeing this error on a specific document type, or AI responses may include mistakes. Learn more
The error APP-PO-14160: Document action not completed successfully is a common validation message in Oracle E-Business Suite (EBS) Purchasing. It occurs when a user attempts to perform a document control action—such as cancelling, closing, or finally closing a Purchase Order (PO) or Blanket Release—that the system deems incompatible with the current state of the document. Common Causes for APP-PO-14160
Understanding the specific "why" behind this error is the first step toward a resolution. The system usually blocks the action for one of the following reasons: APP-PO-14160: Document Action Not Completed Successfully
The Oracle E-Business Suite error "APP-PO-14160: Document action not completed successfully" occurs when attempting to control a document (e.g., cancel, close) that is in an incompatible status, such as "In Process," "Frozen," or "Incomplete". Solutions include clearing stuck receiving transactions, updating the charge account, or utilizing SQL scripts to reset the document status. For more details, visit Oracle Community.
The error APP-PO-14160: Document action not completed successfully is a common issue in Oracle E-Business Suite (EBS), specifically within the Oracle Purchasing module. It typically appears when a user tries to perform a control action—like canceling, closing, or approving—on a Purchase Order (PO) or Blanket Release. Core Causes of APP-PO-14160
This error is essentially a "catch-all" notification indicating that the system cannot process your request due to an underlying data inconsistency or status mismatch.
Incompatible Document Status: The most frequent cause. You may be trying to cancel a document that is in a status (like 'In Process' or 'Pre-Approved') where that action is not permitted.
Disabled Charge Accounts: If the charge account associated with the PO distribution is disabled or end-dated in the General Ledger, the system will block any further actions on the document. The error code APP-PO-14160: Document action not completed
Stuck Receiving Transactions: Pending or "stuck" records in the RCV_TRANSACTIONS_INTERFACE or the Transaction Status Summary form can prevent a PO from being modified or canceled.
Known Software Bugs: Certain versions of Oracle EBS have documented bugs related to this error, often requiring specific patches like the PSA RPC Patch. Troubleshooting & Solutions 1. Check Document and Account Status Before deep-diving into technical fixes, verify the basics:
Document Status: Ensure the PO is not currently "In Process." If it is, you may need to wait for the workflow to complete or abort it.
Account Validity: Navigate to the General Ledger and confirm that all accounts used in the PO Distributions are Active and have not passed their End Date. 2. Clear Stuck Transactions
If you are trying to cancel a PO and receiving this error, check for pending transactions: Navigation: Receiving > Transaction Status Summary.
Action: Query the specific PO. If records are stuck here, delete them and save your changes. This often "releases" the PO for further actions like cancellation. 3. Review Internal Requisitions
For POs created from Internal Requisitions, the error often occurs if there is a mismatch between the line_location_id on the PO and the corresponding request lines. Ensure that the link between the requisition and the PO remains intact and consistent. 4. Apply Oracle Patches
If the data appears clean but the error persists, you may be facing a system bug. Reference Oracle Support Note 1912083.1 on My Oracle Support. Common patches include:
PSA RPC Patch 14563642 (or the latest cumulative equivalent). Technical Diagnostics for Admins
If you have backend access, running these checks can pinpoint the root cause:
Check Workflow: Verify if the POAPPRV workflow is stuck or has errored out.
Table Check: Query PO_HEADERS_ALL and PO_LINES_ALL to ensure the AUTHORIZATION_STATUS and CLOSED_CODE are consistent with what you see in the frontend. If you'd like to troubleshoot further, let me know: What action were you taking (Canceling, Approving, etc.)? What is the current status of the document? Does this happen for all documents or just one specific PO? APP-PO-14160: Document Action Not Completed Successfully
Title: Troubleshooting the "APP-PO-14160: Document Action Not Completed Successfully" Error in Oracle Purchasing
Introduction
In the landscape of enterprise resource planning (ERP) systems, Oracle E-Business Suite (EBS) stands as a colossal framework for managing organizational procurement. However, its complexity often gives rise to cryptic error messages that can halt critical business processes. One such prevalent and often frustrating error is "APP-PO-14160: Document Action Not Completed Successfully." This error typically surfaces during the approval workflow of Purchase Orders (PO) or Requisitions, acting as a bottleneck that prevents the procurement cycle from moving forward. Understanding the root causes of this error—ranging from workflow notification issues to setup inconsistencies—is essential for database administrators and functional users to maintain operational efficiency.
Understanding the Context
The error code APP-PO-14160 is a generic catch-all message signaling that the workflow engine failed to execute a specific action on the document. In Oracle Purchasing, the workflow engine acts as the traffic controller, moving documents through various states (e.g., Draft, Incomplete, Requires Approval, Approved). When a user attempts to approve, reject, or forward a document, the system initiates a background workflow process. When this process encounters an exception—be it a data integrity issue, a missing approval hierarchy, or a system configuration error—it terminates and throws the 14160 error. Because the message itself offers little detail, it necessitates a deeper diagnostic approach.
Primary Causes and Technical Mechanisms
The etiology of the APP-PO-14160 error is multifaceted. One of the most common causes lies within the Position Hierarchy and Approval Group setups. Oracle Purchasing relies heavily on the position hierarchy to determine the chain of authority. If a user's position is not correctly assigned to a job that falls within the approval limits required for the transaction, the workflow cannot determine the next approver. Consequently, the workflow state becomes "No Approver Found," leading to the failure of the document action.
A second major cause is Workflow Notification System (WFS) congestion or corruption. Often, the workflow background engine encounters a "hanging" process. If a previous workflow activity did not complete cleanly—perhaps due to a database timeout or a locking issue—the document enters a state of limbo. Subsequent attempts to act on the document fail because the system perceives the document as currently being processed or locked by another session.
Furthermore, customizations and data corruption can trigger this error. Organizations frequently customize the standard PO Approval Workflow (POWFRQAG or POAPPRV workflow) to accommodate specific business rules. Errors in the PL/SQL code within these custom wrappers, or invalid data in the PO_HEADERS_ALL or PO_LINES_ALL tables (such as a missing distribution set or invalid charge account), can cause the workflow engine to crash ungracefully, resulting in the generic 14160 message.
Diagnostic and Resolution Strategies
Resolving the APP-PO-14160 error requires a systematic approach, moving from the application layer to the database layer.
- Workflow Status Checks: The first step is to utilize the "Status Monitor" in Oracle Workflow. By searching for the item key associated with the Purchase Order, administrators can view the workflow diagram to identify exactly which node failed. This helps pinpoint whether the error occurred during the "Notify Approver" phase or the "Approval" phase.
- The
wfstat.sqlandPOXWDDB.sqlScripts: Oracle Support provides diagnostic scripts such aswfstat.sqlto check the status of workflow items andPOXWDDB.sqlto debug PO workflows. These scripts reveal if the document is stuck in a specific activity and can identify "Blocked" or "Errored" activities. - Position Hierarchy Validation: Functional consultants must verify the Approval Group and Position Hierarchy setups. Ensuring that the user attempting to approve the document has a valid position defined in the hierarchy and that the "Document Total" falls within their approval limits is a crucial validation step.
- Database Intervention: If the document is physically locked or the workflow activity is stuck, intervention via the backend may be required. Administrators may need to use the Workflow Administration console to "Retry" or "Skip" a stuck activity. In more severe cases, verifying the
PO_ACTION_HISTORYtable to see if there is a mismatch between the application status and the database record is necessary. If the document is in a "Locked" state, identifying and killing the blocking session or resetting the workflow status may be the only recourse.
Conclusion
While the "APP-PO-14160: Document Action Not Completed Successfully" error is a daunting obstacle in Oracle Purchasing, it is a solvable one. It serves as a reminder of the intricate dependencies between organizational hierarchy setups, workflow engine logic, and underlying database integrity. By systematically analyzing workflow logs, validating hierarchy setups, and employing Oracle diagnostic scripts, technical teams can resolve these blockages. Ultimately, a proactive approach—ensuring clean setups and monitoring workflow performance—is the best defense against such disruptions, ensuring that the procurement lifecycle remains fluid and uninterrupted.
The error APP-PO-14160: Document action not completed successfully typically occurs in Oracle E-Business Suite when a user attempts to perform a control action (like cancelling or closing) on a Purchase Order or Blanket Release that is in an incompatible status. Common Causes Case Study: Real-World Resolution of Error 14160 Company:
Incompatible Status: You are trying to cancel or close a document that is already in a state (e.g., Incomplete, Pre-Approved, or Partially Received) that prevents the action.
Disabled Accounts: The charge account associated with the PO lines may have been disabled or is no longer active in the General Ledger.
Stuck Transactions: Records might be stuck in the "Transaction Status Summary" interface, preventing further actions on the PO shipments.
Known Bugs: There are specific bugs related to this error code that may require applying patches, such as PSA RPC Patch 14563642. Recommended Solutions
Check Document Status: Ensure the PO is in a status that allows the action. For example, to cancel a PO, it generally needs to be in Approved or Open status.
Verify GL Accounts: Navigate to the PO distributions and confirm that the Charge Account and Accounting Date are still valid and within an open encumbrance period. Clear Interface Tables: Navigate to Receiving > Transaction Status Summary. Query the problematic PO. Delete any stuck records and save.
Run Workflow Processes: If the document is stuck in "Pending Approval," run the Workflow Background Process for the "PO Approval" item type to clear deferred activities.
Review Oracle Support: Consult Note: 1912083.1 on My Oracle Support for specific patches if the error persists across multiple documents. APP-PO-14160: Document Action Not Completed Successfully
The error APP-PO-14160: Document action not completed successfully is a message from Oracle E-Business Suite (EBS), specifically within the Purchasing (PO) module. It typically triggers when you attempt a document action (like cancelling, approving, or modifying a Purchase Order) that is incompatible with the document's current status. Common Causes and Solutions
Status Mismatch: You may be trying to cancel a Purchase Order (PO) or Blanket Release that is in a status where that action isn't allowed, such as a PO originating from an internal requisition.
Inactive Accounts: The charge account associated with the PO may no longer be enabled.
Known Software Bugs: In certain versions (e.g., r12.2.12), this error can be caused by a bug. Consult My Oracle Support (MOS) regarding Note 1912083.1 to see if a patch is required.
Incomplete Documents: For documents in "Incomplete" status, users may need to Delete the document rather than cancel it.
Open Dependencies: Ensure all associated shipments, lines, or timecards are properly closed or cancelled before attempting to final-close the main agreement. Troubleshooting Steps
Verify Status: Open the document and check the "Status" field to ensure the action is valid.
Check Charge Accounts: Ensure the GL accounts used are currently active and have not expired.
Review Dependencies: Check for linked sales order lines or approved timecards that might be blocking the action.
Contact Support: If you are following the standard process and the error persists, report it to Oracle Support as it may require a specific system patch. APP-PO-14160: Document Action Not Completed Successfully
1. Symptom
When attempting to perform a document action (such as Approve, Reject, Submit for Approval, or Update) on a Purchase Order or Requisition, the system displays a generic error message:
"Error: APP-PO-14160: Document action not completed successfully."
In some instances, the error may be accompanied by a Java stack trace or a database constraint error in the backend logs. The user is forced to navigate away from the page, and the transaction is rolled back.
Step 6: Consult the Application Logs
If you have administrator access, check the server logs or audit trails. Search for "14160". You may find a more detailed stack trace:
"Error 14160: User [ID] attempted to set status='APPROVED' on PO_ID=5678 but workflow rule WF-210 requires vendor approval flag=True."
Step 1: Check the Full Error Stack
The pop-up message is often truncated. To see the real cause:
- Navigate to Help > Diagnostics > Examine (or check the log file:
$APPLCSF/$APPLLOG). - Look for the underlying error, such as:
FRM-40735: WHEN-BUTTON-PRESSED trigger raised unhandled exception ORA-06508APP-PO-14160: Approval Workflow Failed to launch.
2. Run Diagnostic Scripts
Use backend queries to validate the PO’s integrity. Example SQL check for inconsistent approval status:
SELECT po_header_id, approval_status, wf_item_key
FROM po_headers_all
WHERE segment1 = 'YOUR_PO_NUMBER';
Compare the approval_status against the workflow state.
