Skip to main content
Spec ID: HR-PAY-04
Status: ✅ Phase 1 Complete; Phase 2/3 Planned
Last Updated: 2026-02-27 This document describes the integration interfaces between HR-PAY-04 (Tax Forms & Compliance) and linked systems: HR-07 (Payroll), HR-PAY-01 (Tax Calculation), HR-PAY-02 (Deductions), HR-PAY-03 (Direct Deposit & Pay Stubs), HR-01 (Employee Directory), HR-03 (Onboarding), HR-12 (Self-Service), and FA (Finance).

​
Integration Summary

​
Event Contracts (HR-PAY-04 as Publisher)

​
hr.employer_tax_liability.calculated

  • Subscribers: FA (Finance) — for GL posting and liability tracking.
  • Payload schema: See EVENT_CONTRACTS.md for full payload (organization_id, tax_period_type, federal_income_tax_withheld, employer_ss_tax, employer_medicare_tax, total_liability, etc.).
  • Purpose: Notify FA when employer-side tax liability has been calculated so FA can post to GL (or queue for manual posting).

​
Data Sources (Internal)

​
Platform Integration Layer Usage

  • PF-11 (Documents): W-2 PDFs stored and accessed via existing document storage; employee access via HR-12.
  • PF-10 (Notifications): Optional notification when W-2 is available (per spec).
  • Permissions (PF-30): hr.tax_forms.view, hr.tax_forms.manage; constants in src/platform/permissions/constants.ts; seed pf_module_permissions and pf_role_permissions.

​
CROSS_CORE_INTEGRATIONS.md

HR-PAY-04 is referenced in CROSS_CORE_INTEGRATIONS.md: HR → FA event hr.employer_tax_liability.calculated. This doc is the detailed integration reference for HR-PAY-04.

​
References

Last Updated: 2026-02-27