Payroll Integration Events

Summary

This page documents confirmed payroll integration events behavior and explicitly marks incomplete integration boundaries.

Audience

Payroll and integration developers, QA and support engineers, solution and security architects, and implementation partners.

Reference Content

Four shared outbound contracts derive from IntegrationEvent.

Event	Purpose	Publisher	Confirmed consumers	Version
PayrollCalculated	Announces completed run calculation	PayrollCalculationService	Document	1
PayrollFrozen	Announces run freeze	PayrollCalculationService	Document, Notification, Platform	1
PayrollUnfrozen	Announces run unfreeze	PayrollCalculationService	None confirmed	1
PayslipGenerated	Announces structured payslip generation	PayrollOutputsService	Document, Notification	1

The common contract envelope defines event identity/type/time, correlation, causation, tenant and user context, source, and schema version. Payroll-specific contracts add run/period and aggregate context; payslip adds payslip/run/employee and document-reference context. Payload samples and sensitive values are intentionally excluded.

All four are serialized into outbox records directly; no domain-event mapping exists.

Source References

• microservices/src/contracts/Events/IntegrationEvent.cs
• microservices/src/contracts/Events/PayrollCalculatedEvent.cs
• microservices/src/contracts/Events/PayslipGeneratedEvent.cs
• microservices/src/payroll-service/Application/PayrollCalculationService.cs
• microservices/src/payroll-service/Application/PayrollOutputsService.cs
• microservices/src/shared-kernel/Outbox/IntegrationEventJsonSerializer.cs

Related Articles

• Payroll events documentation
• Payroll technical messaging

See Also

• Payroll database outbox
• Payroll module

Keywords

• Payroll events
• Payroll Integration Events
• Integration contracts

Revision Information

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