Skip to main content
Payroll Changes are used to represent all inputs to payroll calculations, including regular compensation, salary increases or decreases, changes in bonuses, alterations to vacation or sick time, or changes to health insurance or retirement plans. Changes may also include modifications to payroll deductions, such as taxes or 401K contributions. Note that each worker’s payroll starts from a blank slate, so their initial compensation is also represetned as a Payroll Change, not any subsequent modifications to it. When computing payroll items for any given pay period, Plane will take into account all payroll changes that are effective in that period.

​
Examples

Here are a few examples of what would result in a payroll change being created in Plane:
  • Compensation is set for the first time This can result in two Payroll Change entries if proration is needed to adjust the amount for the first pay period.
  • Compensation is changed after worker’s first payroll This can result in two Payroll Change entries if proration is needed to adjust the amount if the change happens mid-period.
  • Expense report is approved and added to payroll
  • Recurring reimbursement is set up
  • Benefits or deductions must be added to payroll

​
Attributes

​
string
Unique identifier for the object, e.g. prc_cNqYX2J3s9bI2Aa.
​
string
Status of the payroll change. This can be one of draft, accepted, processed, or cancelled.
​
string
Date this payroll change is effective from.
​
string
Date this payroll change is effective until. Can be null, meaning the change is effective indefinitely.
​
string
Type of this payroll change. One of reimbursement, regular, benefit, bonus or commission.
​
string
Amount of the payroll change.
​
string
Currency of the payroll change.
​
string
The frequency of this payroll change, aligned with the worker’s pay period. One of once, monthly, twice_monthly, weekly, biweekly, twice_annual or annual.
​
string
The hourly and raily rate calculated from the payroll change amount and reportable hours.
​
string
Either pre or post. Affects whether or not the change should be apply before or after taxes.
​
string
Hours reportable for this payroll change. Mostly used for prorated pay or certain types of bonuses. Optional.
​
string
An additional description of the payroll change, visible to the payroll admin.
​
boolean
If the change is recurring, it will be set to true. Otherwise false.
​
string
Whether or not this change was a result of a proration.
​
object
Object representing the worker whose payroll this change is applicable to.
​
object
Reference to the source of this payroll change. For example, a salary change will reference the Worker Compensation object that resulted in this payroll change.