Payroll Calculation Failure Troubleshooting

Summary

This page records confirmed payroll calculation failure troubleshooting behavior and marks incomplete boundaries explicitly.

Audience

Payroll users, developers, QA and support engineers, architects, and implementation reviewers.

Symptoms

Calculation cannot load, future period is rejected, rows are missing, save fails, or native calculation reports missing inputs.

Cause

Confirmed causes include invalid period, Frozen run, absent eligible workforce, missing required Attendance projection, incomplete employee identity/compensation inputs, or compatibility dependency failure.

Observation	Likely confirmed boundary	Next evidence
Future period rejected before request	Client/compatibility period validation	Selected month/year and UI validation state
Native run already Frozen	Lifecycle validation	Tenant/period run status
No employee rows	Workforce eligibility or compatibility dependency	Projection/read response and route family
Specific employee missing from native result	Workforce identity or required Attendance snapshot	Projection timestamps for that employee/period
Leave/expense value absent	Optional projection missing or stale	Inspect that projection independently; do not block Attendance checks
Save timed out	Commit outcome unknown	Read run/detail/audit/outbox state before retry

Resolution

Confirm period and lifecycle status, then projection freshness for workforce and Attendance. Check optional inputs independently. Retry only after the source condition is corrected. Do not invent missing Attendance or edit calculated persistence directly.

If native and compatibility results differ, stop treating the issue as a single calculation defect. Capture which route family produced each result and use supported parity evidence. Escalate unresolved formula or rounding differences to Payroll engineering with synthetic reproduction data; do not include compensation values from production.

Validation

Recalculate in an approved test scope and confirm a Calculated run/detail with audit/outbox evidence or a saved compatibility row, depending on the route used.

Source References

• UI/salary-ui/apps/client-hrms-portal/src/pages/salary/CalculateSalaryPage.tsx
• microservices/src/payroll-service/Application/PayrollCalculationService.cs
• microservices/src/payroll-service/Application/PayrollCompatService.cs
• microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs

Related Articles

• Payroll troubleshooting documentation
• Payroll technical documentation

See Also

• Payroll API documentation
• Payroll module

Keywords

• Payroll troubleshooting
• Payroll Calculation Failure Troubleshooting

Revision Information

• Status: Draft
• Last reviewed: 2026-07-15
• Review cycle: Quarterly