Skip to main content

Payroll Freeze Events

Summary​

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

The contract characteristics below are taken directly from its shared definition, publisher, mapping, and confirmed consumer code.

Purpose​

PayrollFrozen communicates the completed native freeze of a Payroll run.

Publisher​

PayrollCalculationService.

Consumer​

Document, Notification, and Platform are confirmed subscribers. Platform currently records receipt only.

When raised​

After freeze validation and while run/detail state, recovery changes, audit, and timeline evidence are staged.

When mapped​

The version-1 contract is serialized into the outbox before the freeze SaveChanges call.

Delivery model​

Transactional outbox intent and asynchronous consumer processing.

Transactional boundary​

Freeze state, recovery changes, evidence, and outbox intent share one local save. Notifications and projections are external.

Version​

Schema version 1.

Known limitations​

The publisher leaves tenant, user, and causation envelope fields unpopulated. No delivery completion feedback returns to the freeze command.

Requires confirmation​

  • Tenant-context propagation and consumer outcome monitoring.
  • Whether receipt-only Platform handling will evolve.

Source References​

  • microservices/src/contracts/Events/PayrollCalculatedEvent.cs
  • microservices/src/payroll-service/Application/PayrollCalculationService.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 Freeze Events
  • Integration contracts

Revision Information​

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