Employees
Employees
Employees 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 payroll posting outputs derived from payroll runs, and bus accounts provides accounts referenced by payroll posting fields.
Actions
Register an employee creates stable person references for payroll runs. Set employee pay structure records gross pay and withholding parameters used in payroll calculations and postings.
Properties
Core fields are employee_id, entity_id, start_date, end_date, gross, and withholding_rate. Posting-account fields are wage_expense_account_id, withholding_payable_account_id, and net_payable_account_id.
Relations
An employee belongs to the workspace’s accounting entity. Scope is derived from the workspace root directory rather than from a per-row key.
An employee references one party via entity_id so that identity, payment identifiers, and deduplication rules can be shared with other counterparty workflows.
Payroll runs consume employee records to compute wages and withholdings for a month. Employee pay structure fields reference ledger accounts so payroll outputs can be posted consistently.