Search Results reverse_application_to_ps

Overview

ARP_CONFIRMATION is an Oracle Applications (APPS) PL/SQL package within the Oracle Receivables (AR) module. Its primary business function is to manage the confirmation and unconfirmation of cash receipts. In Oracle EBS, a receipt is considered "confirmed" once it has been fully accounted, cleared, and matured. The confirmation process is a critical step in the receipt lifecycle, as it triggers the creation of accounting entries, updates payment schedules, and marks the receipt as no longer subject to reversal or modification. The ARP_CONFIRMATION package encapsulates the logic required to perform this process, either for individual receipts or for a batch of receipts. It also handles the reversal of confirmed receipts (unconfirmation) when necessary, such as when a receipt is remitted or when a reversal is required. The package is classified as an "OTHER" API in the EBS Technical Reference Manual (ETRM), indicating that it is not a public, documented API for external use but rather an internal component used by Oracle Receivables and other modules.

Key Procedures and Functions

The package exposes a set of procedures and functions that form the core of the confirmation logic. These include:

• CONFIRM – Main entry point to confirm a single receipt, orchestrating the confirmation process.
• UNCONFIRM – Reverses a previously confirmed receipt, restoring it to an unconfirmed state.
• CONFIRM_BATCH – Confirms a batch of receipts in a single operation, improving performance for bulk processing.
• CONFIRM_RECEIPT – Core confirmation routine that performs the actual confirmation for a given receipt.
• DO_CONFIRM – Internal worker that executes the confirmation steps, including validation and data updates.
• DO_UNCONFIRM – Internal worker that executes the unconfirmation steps.
• UPDATE_CR_HISTORY_CONFIRM – Updates the AR_CASH_RECEIPT_HISTORY table to record the confirmation event.
• UPDATE_CR_HISTORY_UNCONFIRM – Updates the history table to record the unconfirmation event.
• CONFIRM_UPDATE_PS_REC – Updates the payment schedule records (AR_PAYMENT_SCHEDULES) during confirmation.
• CREATE_MATCHING_UNAPP_RECORDS – Creates unapplied receipt records to match the confirmed receipt, ensuring proper accounting.
• GET_RECEIPT_CLEARING_CCID – Retrieves the clearing account code combination ID for the receipt, used in accounting entries.
• REVERSE_APPLICATION_TO_PS – Reverses the application of a receipt to a payment schedule during unconfirmation.
• REVERSE_RA_RECS – Reverses receivable application records (AR_RECEIVABLE_APPLICATIONS) during unconfirmation.
• UNCONFIRM_UPDATE_PS_REC – Updates payment schedule records during unconfirmation.
• VALIDATE_IN_PARAMETERS – Validates input parameters passed to the confirmation routines.
• GET_APPLICATION_FLAGS – Retrieves flags that control application behavior during confirmation.
• HANDLE_MAX_DATES – Manages date-related logic, such as setting maximum dates for accounting periods.

Tables Accessed

The package reads from and writes to several key Oracle Receivables tables via APPS synonyms:

• AR_CASH_RECEIPTS – Stores receipt header information; updated to reflect confirmation status.
• AR_CASH_RECEIPT_HISTORY – Records the history of receipt status changes, including confirmation and unconfirmation events.
• AR_PAYMENT_SCHEDULES – Contains payment schedule details for transactions; updated to reflect the impact of receipt confirmation on outstanding balances.
• AR_RECEIPT_METHOD_ACCOUNTS – Provides the accounting flexfield for receipt methods, used to determine clearing accounts.
• AR_RECEIVABLE_APPLICATIONS – Stores the application of receipts to transactions; records are created or reversed during confirmation/unconfirmation.
• RA_CUST_TRX_TYPES – Defines transaction types; used to validate or derive information during processing.
• AR_ADJUSTMENTS – May be accessed to handle adjustments related to receipt confirmation.
• AR_DISTRIBUTIONS – Stores accounting distributions; may be updated or created during confirmation.
• AR_RECEIVABLE_APPLICATIONS_S – A temporary or shadow table for receivable applications.
• RA_CUSTOMER_TRX_ALL – Stores customer transactions; used for validation or cross-reference.
• DUAL – Used for simple queries or function calls.
• PLITBLM – A PL/SQL table or index-by table used internally.

Usage Notes

ARP_CONFIRMATION is invoked primarily by Oracle Receivables forms and concurrent programs, such as the "Receipt Confirmation" program or the "Remittance" process. It is also called by other internal packages, including ARP_PROC_RECEIPTS1 and AR_MRC_ENGINE3, which handle receipt processing and multi-reporting currency (MRC) accounting. Because it is an internal API, direct calls from custom code are generally discouraged unless the developer fully understands the confirmation logic and its side effects. When invoked, the package performs validations, updates receipt and payment schedule records, creates accounting entries, and records history. Unconfirmation is typically used when a confirmed receipt needs to be reversed due to a remittance failure, a returned check, or an error. The package ensures data integrity by using database transactions and locking mechanisms. It is critical to test any custom integration thoroughly, as improper use can lead to inconsistent receipt statuses and accounting errors.