Payroll Payslip and Export Troubleshooting

Summary

This page records confirmed payroll payslip and export troubleshooting behavior and marks incomplete boundaries explicitly.

Audience

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

Symptoms

Payslip preview/PDF is unavailable, CSV export fails, or bank export is rejected.

Cause

The run/detail may be missing or not Frozen, the employee/month may have no saved data, identity may be incomplete, or output rendering/audit save may fail. Bank export specifically requires Frozen state.

Output symptom	Distinguishing check	Safe action
Preview unavailable	Does compatibility saved data exist for employee/month?	Correct selection or saved-data prerequisite
Structured native payslip rejected	Are both run and detail Frozen?	Resolve lifecycle state through supported flows
PDF response fails	Was the logical payslip already generated?	Check supported read/audit evidence before retry
CSV/report export fails	Is the run/report data readable and role-scoped?	Retry only after read/export failure is classified
Bank export rejected	Is the run Frozen?	Freeze only when business checks pass; do not bypass eligibility
File exists but no external outcome	Was it merely generated?	Do not infer bank submission, payment, or accounting posting

Resolution

Confirm tenant, run, detail, employee/month, and Frozen eligibility through approved interfaces. Distinguish structured payslip generation from PDF rendering. Retry only after eligibility is corrected; handle generated files as sensitive.

Validation

Verify the expected content type/file response and corresponding audit/outbox evidence. Do not attach real output to general support records.

Source References

• UI/salary-ui/apps/client-hrms-portal/src/pages/hr/PayrollFeaturePages.tsx
• microservices/src/payroll-service/Application/PayrollOutputsService.cs
• microservices/src/payroll-service/Application/PayrollCompatService.cs

Related Articles

• Payroll troubleshooting documentation
• Payroll technical documentation

See Also

• Payroll API documentation
• Payroll module

Keywords

• Payroll troubleshooting
• Payroll Payslip and Export Troubleshooting

Revision Information

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