Pay components

An item used to calculate employee pay, such as an earning, deduction or other payment.

Fields

The API name is what the API, MCP and the CLI use.

NameAPI nameTypeRequiredDescription
IDidRecord IDYes
NamelabelText I18n
CodecodeTextYes
Ledger accountaccountingledgeraccountIdReference
KindkindConstantYes
OccurrenceoccurrenceConstantYes
TimingtimingConstant
TagstagIdsTags
Created bycreatedByUser
Created atcreatedAtDate and TimeYes
Updated byupdatedByUser
Updated atupdatedAtDate and TimeYes
Published bypublishedByUser
Published atpublishedAtDate and Time
Disabled bydisabledByUser
Disabled atdisabledAtDate and Time
Blocked byblockedByUser
Blocked atblockedAtDate and Time
Archived byarchivedByUser
Archived atarchivedAtDate and Time

Relations

Owned records (solid line) are deleted with their owner. Grouped records (dashed line) can exist alone.

FieldPoints toKind
Ledger account accountingledgeraccountIdChart of accountsreference
Tags tagIdsTagsreference

Actions

What you can do with a record. Every action also sends the webhook event payrollcomponents.<action>. Reads (find, get, count) work on every table.

NameAPI nameDescriptionWhere
CreatecreateAdd a new pay component.App · WebMCP · API · MCP · CLI
EditupdateSave changes to this pay component.App · WebMCP · API · MCP · CLI
DisabledisableTurn this pay component off for new use. Existing references stay. Enable it again to use it.App · WebMCP · API · MCP · CLI
EnableundisableTurn this pay component back on for new use.App · WebMCP · API · MCP · CLI
PublishpublishMake this pay component available for use.App · WebMCP · API · MCP · CLI
BlockblockStop edits and deletion of this pay component. It stays visible and can still appear on existing documents. Unblock to edit again.App · WebMCP · API · MCP · CLI
UnblockunblockAllow edits and deletion of this pay component again.App · WebMCP · API · MCP · CLI
ArchivearchiveRetire this pay component from daily use. It leaves active lists and pickers, and most actions stop. Unarchive to restore it.App · WebMCP · API · MCP · CLI
RestoreunarchiveReturn this pay component to active lists and actions.App · WebMCP · API · MCP · CLI
DeletedeleteDelete this pay component and the data that belongs with it. This cannot be undone.App · WebMCP · API · MCP · CLI

States

How a record moves from state to state. Archive and block can happen in any state.

PublishCreatedPublished