Search Results api_call_failed




Overview
Explore in AI Chat

Overview

CN_SCA_CREDITS_BATCH_PVT is a private PL/SQL package body owned by the APPS schema that supports the Sales Credit Allocations (SCA) feature in Oracle EBS Release 12.1.1 and 12.2.2. Its stated purpose, per the embedded header comment, is to "process the Sales Credit Allocations." The package is classified as PVT (private), meaning it is intended for internal invocation by other EBS components rather than as a public integration API. It orchestrates batch-level rule evaluation and allocation logic, driving the movement of sales credit data through the SCA staging and output tables. The source header indicates an original creation date of 11/10/03 and file version cnvscapb.pls, reflecting the package's long-standing role in Oracle's incentive compensation and order management flows.

Key Procedures and Functions

The package exposes a single documented procedure, PROCESS_BATCH_RULES. Its role is to evaluate the active credit rules for a given physical batch and transaction source across a specified date range, producing the winner records and the corresponding allocation output. The procedure is not a public API; it is a private worker routine invoked by the SCA batch processing framework.

The implementation also contains an internal helper, debugmsg, which emits diagnostic output to the CN_MESSAGE_PKG debug facility when the profile option CN_DEBUG is set to 'Y'. This is a logging convenience only and carries no business logic. Declared exceptions include NO_TRX, CONC_FAIL, and API_CALL_FAILED, which signal no-transaction, concurrent-program failure, and API invocation error conditions respectively. Notably, PROCESS_BATCH_RULES is designed as a concurrent-program entry point, as evidenced by its errbuf and retcode OUT parameters and the use of CN_SCA_PROCESS_BATCHES to derive the start and end identifier range for the run.

Tables Accessed

  • CN_SCA_PROCESS_BATCHES — Provides the start_id and end_id boundaries of the transaction records being processed in the current batch.
  • CN_SCA_CREDIT_RULES — Supplies the rule definitions applied during batch evaluation.
  • CN_SCA_HEADERS_INTERFACE — The inbound interface staging table for SCA header-level data.
  • CN_SCA_WINNERS — Stores the winning party or rule outcome determined by rule processing.
  • CN_SCA_LINES_OUTPUT — The output table holding the resulting credit allocation lines; this is the table most closely associated with the user's search term "cn_sca_lines_output" and represents the tangible allocation result.
  • PLITBLM — The PL/SQL table-to-VARCHAR2 conversion utility used for bulk SQL generation and dynamic statements.

Usage Notes

The package is invoked through the SCA concurrent program framework rather than directly from Oracle Forms, and it is referenced by zero other packages according to the ETRM metadata, confirming that its consumers are the concurrent manager and internal batch drivers only. Because the package is private and performs bulk DML against the interface, winners, and lines output tables, custom code should not call it directly; instead, integrations should target the supported SCA public APIs or the underlying concurrent program. Administrators troubleshooting allocations should first set the CN_DEBUG profile option to 'Y' to capture debugmsg output, then inspect CN_SCA_PROCESS_BATCHES for the run range and CN_SCA_LINES_OUTPUT for the resulting lines. The presence of NO_TRX and CONC_FAIL exceptions indicates that concurrent program completion status and transaction availability are significant failure modes to monitor in the concurrent manager log.