Search Results pay_us_emp_state_tax_rules_f




Overview
Explore in AI Chat

Overview

The PAY_US_EMP_STATE_TAX_RULES_F table is a core data object within the Oracle E-Business Suite (EBS) Payroll module, specifically for the US localization. It serves as the primary repository for storing state-level income tax withholding rules and details for employee assignments. This table is essential for the accurate calculation, withholding, and reporting of state income taxes during payroll processing. As a date-effective table (indicated by the '_F' suffix and the EFFECTIVE_START_DATE and EFFECTIVE_END_DATE columns), it maintains a historical record of changes to an employee's state tax information over time, allowing for correct retroactive calculations and audit trails. Its role is critical for ensuring compliance with the diverse and frequently changing tax regulations across different US states and localities.

Key Information Stored

The table's structure is designed to capture the necessary parameters for state tax calculation. The primary key is a composite of EMP_STATE_TAX_RULE_ID, EFFECTIVE_START_DATE, and EFFECTIVE_END_DATE, which uniquely identifies each tax rule record and its period of validity. Key columns include STATE_CODE, which links to the PAY_US_STATES table to identify the taxing jurisdiction, and BUSINESS_GROUP_ID, which links to HR_ALL_ORGANIZATION_UNITS. Other significant columns typically store data such as the employee's filing status (e.g., Single, Married), number of allowances, additional withholding amounts, reciprocal agreement indicators, and jurisdiction-specific tax codes. The effective date columns are paramount, defining the precise date range for which the stored tax rules are applicable to the employee's assignment.

Common Use Cases and Queries

This table is central to numerous payroll operations and reporting requirements. Common use cases include the setup and maintenance of employee state tax profiles, the generation of year-end tax forms like the W-2 (specifically the state wage and tax boxes), and audits of tax withholding. A frequent reporting query involves retrieving the current active state tax rule for an employee to verify withholding settings. A sample SQL pattern for such a query is:

  • SELECT per.employee_number, petf.state_code, petf.filing_status_code FROM pay_us_emp_state_tax_rules_f petf, per_assignments_f paf, per_people_f per WHERE petf.assignment_id = paf.assignment_id AND paf.person_id = per.person_id AND SYSDATE BETWEEN petf.effective_start_date AND petf.effective_end_date AND SYSDATE BETWEEN paf.effective_start_date AND paf.effective_end_date AND SYSDATE BETWEEN per.effective_start_date AND per.effective_end_date;

Another critical use case is historical analysis, where queries span the effective date ranges to track changes in an employee's state tax elections over time.

Related Objects

The PAY_US_EMP_STATE_TAX_RULES_F table has integral relationships with other key EBS objects. As per the provided metadata, it holds foreign key relationships to PAY_US_STATES (via STATE_CODE) for state master data and to HR_ALL_ORGANIZATION_UNITS (via BUSINESS_GROUP_ID) for organizational context. It is fundamentally linked to the employee assignment through the ASSIGNMENT_ID column (implied by its description), which would reference PER_ASSIGNMENTS_F. For payroll processing, this table is read by the US payroll calculation engine. It is also referenced by key payroll reporting views, such as those underlying the Year-End Reporting process. Updates to this table are typically performed through the dedicated "State Tax Information" form or via public APIs, which ensure data integrity and proper history maintenance.