Results for “oks_renew_contract_pvt”

AI-generated from documented ETRM metadata — verify critical details on the linked pages.

Overview

OKS_RENEW_CONTRACT_PVT is a private (PVT) PL/SQL package in the APPS schema that forms the core renewal execution engine within Oracle E-Business Suite's Service Contracts (OKS/ETRM) module. Its business function is to process the renewal of service contracts by evaluating renewal eligibility, validating renewal parameters, and generating the renewed contract structure. The package is classified as a private API, meaning it is not intended for direct invocation by external or customer-written code; instead, it is consumed by the public renewal APIs and internal orchestration layers within the same module. Because it operates as the runtime workhorse beneath the public interface, it encapsulates the low-level business logic that transforms an expiring or candidate contract into a renewed contract, applying pricing, coverage, and counter-based entitlements as configured by the user.

Key Procedures and Functions

The documented package exposes four procedures and functions, of which the primary entry points are RENEW_CONTRACT and VALIDATE_RENEWAL:

• RENEW_CONTRACT — Executes the renewal of the contract. It applies the renewal rules defined for the source contract and produces the renewed contract header and associated lines. It is the substantive processing routine invoked when a contract qualifies for renewal.
• VALIDATE_RENEWAL — Performs pre-execution validation of the renewal request. This routine confirms that the source contract and its configuration satisfy the preconditions required for a successful renewal, returning diagnostic information to the caller.
• Remaining two documented procedures/functions — The ETRM metadata lists two additional private members. These operate as internal helpers supporting the renewal lifecycle, supplying supporting logic invoked from within RENEW_CONTRACT and VALIDATE_RENEWAL rather than from external callers.

Parameter lists are not reproduced here; parameter signatures are reserved for the package specification and should not be assumed without direct inspection.

Tables Accessed

Through APPS synonyms, the package reads and writes a set of core ETRM and shared tables:

• OKC_K_HEADERS_B — The contract header base table, holding the master contract records created and modified during renewal.
• MTL_UNITS_OF_MEASURE_TL — Provides unit-of-measure translations used when deriving renewed line quantities or coverage units.
• CSI_COUNTERS_B / CSI_COUNTERS_TL / CSI_COUNTER_ASSOCIATIONS / CS_CSI_COUNTER_GROUPS — Counter definitions, translations, group membership, and associations used to determine metered or counter-based entitlements carried into the renewed contract.
• CSI_ITEM_INSTANCES / CSI_INSTALL_PARAMETERS / CSI_I_PARTIES / CSI_SYSTEMS_TL — Installed base records, their parameters, parties, and system translations, establishing the customer and asset context for renewal.
• HZ_PARTIES / HZ_CUST_ACCOUNTS / HZ_LOCATIONS — Trading partner, customer account, and address data used to populate the renewed contract's party and location details.
• FND_USER / HR_ALL_ORGANIZATION_UNITS — User and organization references applied as ownership and operating unit context and audit fields.

Usage Notes

As a private package, OKS_RENEW_CONTRACT_PVT is never called from forms or concurrent programs directly. It is referenced by the following packages: OKS_AUTO_REMINDER (renewal reminders), OKS_EVTREN_PUB (event-based renewal), OKS_K_ACTIONS_PVT (contract actions), OKS_RENCON_PVT (renewal concurrent processing), OKS_RENEW_CONTRACT_PUB, OKS_RENEW_PUB (public renewal APIs), and the workflow packages OKS_WF_K_APPROVE and OKS_WF_K_PROCESS_PVT. Accordingly, renewal scenarios reach this package through the public renewal API, the auto-reminder concurrent program, or the contract approval workflow. Customizations must call the public layer (OKS_RENEW_CONTRACT_PUB or OKS_RENEW_PUB) rather than this private package, since its interface may change without notice across EBS releases, including 12.1.1 and 12.2.2.