Search Results pay_interpreter_pkg
Overview
PAY_INTERPRETER_PKG is an Oracle Payroll package body in the APPS schema responsible for interpreting dated-tracked changes to payroll data. Its principal business function is determining which payroll elements, assignments, and element entries are affected by datetrack events, event groups, and legislation rules, and then driving the appropriate payroll processing logic. In effect, it acts as the interpretation layer that translates raw datetracked changes into the payroll engine's concept of "affected" records requiring reprocessing or recalculation.
The package operates at the intersection of Oracle Payroll and Oracle Advanced Benefits (BEN) constructs, referencing BEN_EXT_DFN, BEN_EXT_THREAD, and related extraction definitions alongside core payroll tables. It is highly central: according to ETRM metadata for 12.2.2, the package is referenced by 24 other packages. It exposes 25 documented procedures and functions and is not itself referenced as a dependency by any database object in the dependency listing, though its internal call graph is extensive.
Key Procedures and Functions
The documented routines fall into several functional clusters:
- Initialisation and global state: INITIALISE_GLOBAL establishes package-level context for a processing run.
- Datetrack event handling: ADD_DATETRACK_EVENT_TO_ENTRY, CLEAR_DT_EVENT_FOR_ENTRY, ENTRY_AFFECTED, ENTRIES_AFFECTED, EVENT_GROUP_TABLES, EVENT_GROUP_TABLES_AFFECTED, and VALID_GROUP_EVENT_FOR_ASG determine which element entries and event groups are touched by datetracked changes. TIME_FN and ASG_ACTION_EVENT/ASG_ACTION_AFFECTED extend this to assignment actions.
- Date and proration logic: GET_PRORATED_DATES and PRORATE_START_DATE compute adjusted effective dates for proration.
- Key and identifier resolution: GET_OBJECT_KEY, GET_PARENT_KEY, GET_EFFECTIVE_DATE, GET_ASSIGNMENT_ID, and GET_ELEMENT_ENTRY_ID derive the identifying keys needed to map generic datetrack payloads to specific payroll records.
- Validation and subset derivation: GENERIC_DATA_VALIDATION and GET_SUBSET_GIVEN_NEW_EVG validate incoming data and compute the subset of records affected by a new event group version.
Tables Accessed
The package reads and writes a broad set of payroll and HR tables via APPS synonyms. Core payroll tables include PAY_DATED_TABLES, PAY_DATETRACKED_EVENTS, PAY_ELEMENT_ENTRIES_F, PAY_ELEMENT_ENTRY_VALUES_F, PAY_ELEMENT_LINKS_F, PAY_EVENT_PROCEDURES, PAY_EVENT_QUALIFIERS_F, PAY_EVENT_UPDATES, PAY_EVENT_VALUE_CHANGES_F, PAY_PROCESS_EVENTS, and PAY_ASSIGNMENT_ACTIONS. Advanced Benefits extraction tables (BEN_EXT_CRIT_TYP, BEN_EXT_CRIT_VAL, BEN_EXT_DFN, BEN_EXT_RSLT) supply criteria and definition data. HR assignment and business group context comes from PER_ALL_ASSIGNMENTS_F and related PER tables. These tables are accessed to identify affected entries, resolve event qualifiers, and record event updates resulting from interpretation.
Usage Notes
PAY_INTERPRETER_PKG is invoked internally by the payroll processing engine and by dependent packages rather than directly by end users. It is typically triggered during datetracked updates to assignments or element entries, during payroll run preparation, and when event groups or legislation rules change. Because it is referenced by 24 other packages, custom code should treat it as an internal API and avoid direct calls where a supported payroll API exists. When extending payroll behaviour, developers should review the documented entry points above and confirm the current event group and datetrack context before invoking interpretation logic.
-
SYNONYM: APPS.PAY_EVENT_PROCEDURES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_PROCEDURES, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_PROCEDURES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_PROCEDURES, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_QUALIFIERS_F
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_QUALIFIERS_F, status:VALID,
-
PACKAGE BODY: APPS.PAY_INTERPRETER_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_INTERPRETER_PKG, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_QUALIFIERS_F
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_QUALIFIERS_F, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_VALUE_CHANGES_F
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_VALUE_CHANGES_F, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_VALUE_CHANGES_F
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_VALUE_CHANGES_F, status:VALID,
-
PACKAGE BODY: APPS.PAY_INTERPRETER_PKG
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_INTERPRETER_PKG, status:VALID,
-
SYNONYM: APPS.PAY_DATETRACKED_EVENTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_DATETRACKED_EVENTS, status:VALID,
-
PACKAGE: APPS.PAY_INTERPRETER_PKG
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_INTERPRETER_PKG, status:VALID,
-
SYNONYM: APPS.PAY_DATETRACKED_EVENTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_DATETRACKED_EVENTS, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_UPDATES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_UPDATES, status:VALID,
-
SYNONYM: APPS.PAY_PROCESS_EVENTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_PROCESS_EVENTS, status:VALID,
-
SYNONYM: APPS.PAY_PROCESS_EVENTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_PROCESS_EVENTS, status:VALID,
-
SYNONYM: APPS.PAY_EVENT_UPDATES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_EVENT_UPDATES, status:VALID,
-
SYNONYM: APPS.PAY_DATED_TABLES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PAY_DATED_TABLES, status:VALID,
-
PACKAGE: APPS.PAY_INTERPRETER_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_INTERPRETER_PKG, status:VALID,
-
PACKAGE: APPS.PAY_GROUP_EVENT_PKG
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_GROUP_EVENT_PKG, status:VALID,
-
PACKAGE: APPS.PAY_EVENTS_WRAPPER
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_EVENTS_WRAPPER, status:VALID,
-
SYNONYM: APPS.PAY_DATED_TABLES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PAY_DATED_TABLES, status:VALID,
-
PACKAGE BODY: APPS.PAY_QPI_API
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_QPI_API, status:VALID,
-
PACKAGE: APPS.PAY_NO_EERR_STATUS_CONTROL
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_NO_EERR_STATUS_CONTROL, status:VALID,
-
PACKAGE: APPS.PAY_EVENTS_WRAPPER
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_EVENTS_WRAPPER, status:VALID,
-
PACKAGE: APPS.PAY_NO_EERR_STATUS_CONTROL
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_NO_EERR_STATUS_CONTROL, status:VALID,
-
PACKAGE: APPS.PAY_NO_EERR_CONTINUOUS
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_NO_EERR_CONTINUOUS, status:VALID,
-
PACKAGE: APPS.PAY_CORE_DATES
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_CORE_DATES, status:VALID,
-
PACKAGE: APPS.PAY_CORE_DATES
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PAY_CORE_DATES, status:VALID,
-
PACKAGE BODY: APPS.PAY_PQH_RBC
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_PQH_RBC, status:VALID,
-
PACKAGE: APPS.HRI_OPL_EVENT_CAPTURE
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HRI_OPL_EVENT_CAPTURE, status:VALID,
-
PACKAGE BODY: APPS.PAY_QPI_API
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_QPI_API, status:VALID,
-
PACKAGE: APPS.PAY_GROUP_EVENT_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_GROUP_EVENT_PKG, status:VALID,
-
SYNONYM: APPS.PQH_CRITERIA_RATE_ELEMENTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_CRITERIA_RATE_ELEMENTS, status:VALID,
-
PACKAGE BODY: APPS.PAY_PQH_RBC
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_PQH_RBC, status:VALID,
-
PACKAGE: APPS.PAY_NO_EERR_CONTINUOUS
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PAY_NO_EERR_CONTINUOUS, status:VALID,
-
PACKAGE BODY: APPS.PAY_QPE_API
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_QPE_API, status:VALID,
-
SYNONYM: APPS.PQH_RATE_MATRIX_RATES_F
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_RATE_MATRIX_RATES_F, status:VALID,
-
PACKAGE BODY: APPS.PAY_CORE_UTILS
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_CORE_UTILS, status:VALID,
-
PACKAGE BODY: APPS.PAY_QPE_API
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_QPE_API, status:VALID,
-
PACKAGE: APPS.HRI_OPL_EVENT_CAPTURE
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HRI_OPL_EVENT_CAPTURE, status:VALID,
-
PACKAGE BODY: APPS.PQP_UTILITIES
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PQP_UTILITIES, status:VALID,
-
PACKAGE BODY: APPS.PER_MX_SSAFFL_ARCHIVE
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PER_MX_SSAFFL_ARCHIVE, status:VALID,
-
SYNONYM: APPS.PQH_CRITERIA_RATE_FACTORS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_CRITERIA_RATE_FACTORS, status:VALID,
-
PACKAGE BODY: APPS.PER_UTILITY_FUNCTIONS
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PER_UTILITY_FUNCTIONS, status:VALID,
-
PACKAGE BODY: APPS.PAY_EVENTS_WRAPPER
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_EVENTS_WRAPPER, status:VALID,
-
PACKAGE BODY: APPS.PAY_CORE_UPGRADE_PKG
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_CORE_UPGRADE_PKG, status:VALID,
-
PACKAGE BODY: APPS.BEN_EXT_CHG_EVT_API
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:BEN_EXT_CHG_EVT_API, status:VALID,
-
PACKAGE BODY: APPS.PAY_EVENTS_WRAPPER
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PAY_EVENTS_WRAPPER, status:VALID,
-
SYNONYM: APPS.PQH_CRITERIA_RATE_FACTORS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_CRITERIA_RATE_FACTORS, status:VALID,
-
PACKAGE BODY: APPS.PQP_GB_TP_PENSION_EXTRACTS
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PQP_GB_TP_PENSION_EXTRACTS, status:VALID,
-
SYNONYM: APPS.PQH_CRITERIA_RATE_ELEMENTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_CRITERIA_RATE_ELEMENTS, status:VALID,