Payroll runs
Payroll runs
Payroll runs are canonical records used for bookkeeping review, posting, and period-based reporting. The goal is that the register remains stable and audit-friendly while automation depends on deterministic identifiers and references.
Ownership
Owner: bus payroll. This module is responsible for implementing write operations for this object and is the only module that should directly change the canonical datasets for it.
Secondary read-only use cases are provided by these modules when they consume this object for validation, matching, posting, or reporting:
bus journal receives balanced postings produced by payroll runs, and bus period provides period control for month-based payroll workflows.
Actions
Run payroll computes monthly payroll and produces posting intent for wages and withholdings. List payroll runs provides review visibility for what has been produced by month.
Relations
A payroll run belongs to the workspace’s accounting entity. Scope is derived from the workspace root directory rather than from a per-row key.
A payroll run is computed from the employee register, typically including all employees active in the run month. The run produces posting intent that references ledger accounts through the account fields stored on employees.
Payroll runs are month-based and rely on accounting periods to keep close and lock rules deterministic for payroll workflows.