Search Results hr_h2pi_county_tax_rules_pk




Overview

The HR_H2PI_COUNTY_TAX_RULES table is a staging table within the Oracle E-Business Suite Human Resources (HR) module, specifically designed for the HR to Payroll Interface (H2PI). Its primary role is to temporarily hold data related to US employee county tax rules during the upload and synchronization process from the HRMS system to the Oracle Payroll engine. This table is critical for ensuring data integrity and managing the flow of complex, dated tax rule information between the two core systems, particularly for implementations supporting US legislative requirements in releases 12.1.1 and 12.2.2.

Key Information Stored

The table stores effective-dated records for county-level tax rules assigned to employees. As per the provided metadata, its structure is anchored by a primary key composed of EMP_COUNTY_TAX_RULE_ID, EFFECTIVE_START_DATE, and EFFECTIVE_END_DATE, ensuring unique identification of a tax rule's validity period. The BUSINESS_GROUP_ID column segregates data by the assigned business group, a fundamental security and data partitioning construct in Oracle HRMS. A CLIENT_ID column is also present, which is typically used in staging tables to track and manage batches of data during interface processing. While the full column list is not detailed, such a table would logically hold attributes like jurisdiction codes, tax exemption statuses, additional withholding amounts, and other county-specific tax parameters.

Common Use Cases and Queries

The primary use case is the H2PI data transfer process. Data is inserted into this staging table, validated, and then processed by concurrent programs to populate the corresponding Payroll tables (e.g., PAY_US_EMP_COUNTY_TAX_RULES_F). Common operational queries involve monitoring interface status and troubleshooting. For example, identifying incomplete or erroneous staging records for a specific business group or upload batch:

  • SELECT * FROM hr_hr_h2pi_county_tax_rules WHERE business_group_id = &bg_id AND client_id = '&batch_number';
  • SELECT COUNT(*), client_id FROM hr_hr_h2pi_county_tax_rules WHERE effective_end_date IS NULL GROUP BY client_id;

Reporting directly from this table is atypical for end-users, as it is a transient object. However, it is crucial for technical support during payroll initialization or mass updates of employee tax information.

Related Objects

This table is intrinsically linked to the H2PI interface architecture. It feeds data into the corresponding Payroll base table, PAY_US_EMP_COUNTY_TAX_RULES_F. Its processing is governed by H2PI-specific concurrent programs and likely referenced by the standard HR_API transfer processes. The table's primary key constraint, HR_H2PI_COUNTY_TAX_RULES_PK, enforces data integrity. It resides in the HR schema, indicating its ownership by the Human Resources product, despite serving as the source for Payroll data. Other related staging tables in the HR schema, such as HR_H2PI_PERSONAL_PAY_METHODS, follow a similar pattern for different data sets.