Skip to main content

Payroll Event Catalog

Summary​

This page documents confirmed payroll event catalog 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​

Outbound catalog​

ContractProducerRaised byMappingDeliveryConfirmed consumersVersion
PayrollCalculatedEventPayrollNative calculationShared serializer to outboxAsynchronous after local commitDocument1
PayrollFrozenEventPayrollNative freezeShared serializer to outboxAsynchronous after local commitDocument, Notification, Platform1
PayrollUnfrozenEventPayrollNative unfreezeShared serializer to outboxAsynchronous after local commitNone1
PayslipGeneratedEventPayrollStructured payslip generationShared serializer to outboxAsynchronous after local commitDocument, Notification1

Inbound catalog​

Producer domainConsumed event typesPayroll target
EmployeeEmployeeCreated, EmployeeUpdated, EmploymentStatusChangedEmployeePayrollProfile
AttendanceAttendanceApproved, AttendanceSubmittedAttendancePayrollSnapshot
LeaveLeaveApproved, LeaveRejected, LeaveCancelledLeavePayrollSnapshot
ExpenseExpenseApproved, ExpenseRejected, ExpensePaidApprovedExpenseSnapshot

Evidence records​

PayrollAuditLog and PayrollTimeline contain action/timeline labels corresponding to lifecycle operations but are not event contracts. ProcessedIntegrationEvent is an inbound idempotency ledger. OutboxMessage is publication intent, not the business contract itself.

Contract gaps​

No Payroll domain events, versioned inbound dispatch, Payroll event dead-letter flow, or consumer for PayrollUnfrozen is confirmed.

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
  • microservices/src/payroll-service/Messaging/PayrollReadModelConsumer.cs
  • microservices/src/payroll-service/Domain/PayrollEntities.cs
  • microservices/src/document-service/Messaging/DocumentReadModelConsumer.cs
  • microservices/src/notification-service/Application/EventNotificationResolver.cs
  • microservices/src/notification-service/Messaging/NotificationEventConsumer.cs
  • microservices/src/platform-service/Messaging/PlatformEventConsumer.cs
  • microservices/src/integration-service/Domain/IntegrationEntities.cs

See Also​

Keywords​

  • Payroll events
  • Payroll Event Catalog
  • Integration contracts

Revision Information​

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