Payroll Outbox and Notification Troubleshooting

Summary

This page records confirmed payroll outbox and notification troubleshooting behavior and marks incomplete boundaries explicitly.

Audience

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

Symptoms

Payroll state committed but Document, Platform, or Notification behavior is delayed or absent.

Cause

Outbox intent may remain Pending/Failed, relay execution is unconfirmed, publication/status update may fail, or downstream consumer requirements may not be met. Current Payroll publishers leave some shared context fields empty.

Evidence	What it proves	What it does not prove
Payroll state and outbox intent committed	Producer transaction completed	Broker publication or notification delivery
Pending/Failed outbox row	Intent awaits or failed processing	Safe replay policy
Processed outbox row	Processor recorded completion	Every downstream consumer completed
Consumer processed-event/audit evidence	That supported consumer handled the event	Coverage for unregistered consumers or event types
No evidence for PayrollUnfrozen consumer	No confirmed current subscription	That an unfreeze notification should exist

Resolution

Confirm the originating commit and event type, then inspect sanitized outbox status/age and downstream consumer evidence through approved tooling. Escalate relay or contract-context issues. Do not replay or mark records directly in persistence.

Notification and Document behavior must be diagnosed as downstream processing, not as part of the originating Payroll transaction. Missing tenant, user, correlation, or causation context is a compatibility/integration concern and must be escalated rather than populated manually.

Validation

Confirm downstream processed-event/audit evidence for a supported subscription. Do not expect a consumer for PayrollUnfrozen.

Source References

• microservices/src/payroll-service/Infrastructure/Persistence.cs
• microservices/src/payroll-service/Program.cs
• microservices/src/contracts/Events/PayrollCalculatedEvent.cs
• microservices/src/contracts/Events/PayslipGeneratedEvent.cs

Related Articles

• Payroll troubleshooting documentation
• Payroll technical documentation

See Also

• Payroll API documentation
• Payroll module

Keywords

• Payroll troubleshooting
• Payroll Outbox and Notification Troubleshooting

Revision Information

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