Search Results okc_contract_party_pvt




Overview
Explore in AI Chat

Overview

OKC_CONTRACT_PARTY_PVT is a private (PVT) PL/SQL package in the APPS schema that forms part of the Oracle Contracts (OKC) application family within Oracle E-Business Suite 12.1.1 and 12.2.2. Its business function is to encapsulate the low-level logic required to manage the parties associated with a contract, together with the party roles those parties play on the contract. In the Oracle Contracts architecture, the PVT layer sits beneath the public (PUB) API layer: OKC_CONTRACT_PARTY_PUB is the documented entry point for external callers, and it delegates its work to OKC_CONTRACT_PARTY_PVT. The package therefore holds the core validation, locking, and persistence routines that keep contract party and party-role data consistent with the rest of the contract model. It is classified as a private API, meaning it is not intended for direct invocation by customer extensions, although it is reachable from other Oracle-owned code.

Key Procedures and Functions

The documented interface contains eleven procedures and functions, which fall into three functional groups.

  • Contact operations: CREATE_CONTACT, UPDATE_CONTACT, DELETE_CONTACT, LOCK_CONTACT, and VALIDATE_CONTACT handle the lifecycle of a contract contact (party) record. CREATE_CONTACT inserts a new party association for a contract, UPDATE_CONTACT modifies it, DELETE_CONTACT removes it, LOCK_CONTACT obtains the necessary concurrency lock on the record before change, and VALIDATE_CONTACT applies the business validation rules that must pass before the record can be saved.
  • Party-role operations: CREATE_K_PARTY_ROLE, UPDATE_K_PARTY_ROLE, DELETE_K_PARTY_ROLE, LOCK_K_PARTY_ROLE, and VALIDATE_K_PARTY_ROLE perform the equivalent create, update, delete, lock, and validate operations for the party roles that a party holds on a contract. These routines manage the relationship between the contract and its associated parties in the respective role context.
  • Language support: ADD_LANGUAGE supports multilingual (MLS) handling, allowing the translated descriptive attributes of party records to be added for an additional installed language.

All parameters are intentionally omitted here; the documented metadata names the procedures only, and parameter lists must be read from the package specification in the database.

Tables Accessed

The documented table accessed through APPS synonyms is OKC_K_PARTY_ROLES_B, the base table that stores contract party role assignments. The contact and party-role routines read, insert, update, and delete rows in this table as parties are added to or removed from a contract. Because the package also depends on OKC_API, OKC_CPL_PVT, and OKC_CTC_PVT, its processing interacts indirectly with the broader contract, contract-line, and contract-term structures that those packages manage, but OKC_K_PARTY_ROLES_B is the principal persistent object under its control.

Usage Notes

OKC_CONTRACT_PARTY_PVT is not a customer-facing API and should not be called directly from custom code. It is invoked when the Contracts forms and the public contract APIs create or maintain parties on a contract. The dependency metadata shows it is referenced by OKC_CONTRACT_PARTY_PUB (the supported public layer), by itself (recursive internal calls), and by the leasing merge utilities OKL_PARTY_MERGE_PUB and OKL_VENDORMERGE_GRP, which use it during party and vendor merge processing to reconcile contract party-role data. Developers requiring contract party functionality should call OKC_CONTRACT_PARTY_PUB instead, leaving OKC_CONTRACT_PARTY_PVT as an internal implementation detail. When troubleshooting party or party-role problems on contracts, this package and OKC_K_PARTY_ROLES_B are the first places to inspect.