Skip to main content

Payroll Payslip Events

Summary​

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

PayslipGenerated communicates that a structured payslip record was generated.

Publisher​

PayrollOutputsService.

Consumer​

Document and Notification are confirmed subscribers.

When raised​

After the service creates or updates the structured payslip record and stages Payroll audit evidence.

When mapped​

The shared contract is serialized to outbox before the same SaveChanges call.

Delivery model​

Transactional outbox intent followed by asynchronous projection/notification handling.

Transactional boundary​

Payslip, audit, and event intent share a local save. PDF rendering, broker publication, and notification delivery are outside it.

Version​

Schema version 1.

Known limitations​

An absent extracted employee identifier is represented by an empty identifier, and tenant/user/causation context is not populated. The document reference is a Payroll-generated logical reference, not evidence of external document storage.

Requires confirmation​

  • Behavior for missing employee identity and tenant context.
  • Document-reference lifecycle and downstream delivery monitoring.

Source References​

  • microservices/src/contracts/Events/PayslipGeneratedEvent.cs
  • microservices/src/payroll-service/Application/PayrollOutputsService.cs
  • microservices/src/document-service/Messaging/DocumentReadModelConsumer.cs
  • microservices/src/notification-service/Application/EventNotificationResolver.cs
  • microservices/src/notification-service/Messaging/NotificationEventConsumer.cs

See Also​

Keywords​

  • Payroll events
  • Payroll Payslip Events
  • Integration contracts

Revision Information​

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