Pay Schedule
A pay schedule defines how often employees are paid and the specific dates associated with each pay period. Available Frequencies: Weekly, Bi-Weekly, Semi-Monthly, MonthlyDates
For Semi-Monthly and Monthly pay schedules, thepayBeginDate, payEndDate, and payDate must align with the company’s payroll calendar.
Use getMonthlyAndSemiMonthlyPayScheduleDates API to retrieve valid dates.
Configuration
- Pay schedules are typically configured during company onboarding but can be updated later.
- Only one active pay schedule is allowed per worker type (W2 or 1099).
- Payrolls can be self-initiated or automatic (most common) based on company preference.
- Employees are automatically included in payrolls based on their active status and pay schedule.
- Pay is automatically calculated based on employee configurations, including wages, benefits, and elections.
Supplemental Payroll
When a payroll falls outside a regular pay schedule, it is considered a supplemental payroll. Supplemental payrolls are useful for companies with unique or irregular pay needs (e.g., project-based or off-cycle payments).Adding a Supplemental Pay Period
A supplemental pay period can be created at any time using the addSupplementalPayPeriod API, regardless of existing pay schedules.Pay Period Types
| Pay Period Type | Description |
|---|---|
| Missing | Pay periods not recorded in the system due to cancellations or processing errors. |
| Dismissal | Final paychecks or severance pay for terminated employees. |
| Off-Cycle | General pay period for employees paid outside the normal schedule. |
⚠️ Note:
payEndDate and payDate must be future dates to allow time for adjustments, initiation, and processing.
Additional Details:
- Once created, employees can be added using addUsersToSupplementalPayPeriod.
- Employees may belong to multiple supplemental pay periods.
- Supplemental pay periods follow the standard payroll processing workflow, including adding or removing payroll items.
Pay Period Adjustments
Adjustments allow modification of payroll data before the pay period is submitted for processing. Adjustments can include adding or removing employees, modifying wages, bonuses, deductions, and other compensation items.Adding Adjustments
Adjustments can be added to a pay period using the importRegularPayrollData API. This endpoint allows you to import or update regular payroll data such as employee wages, hours worked, deductions, reimbursements, bonuses, and other compensation details for a specific pay period.Removing Adjustments
Use the following APIs to remove previously applied adjustments from a pay period:Processing Payroll
When a payroll is submitted, it progresses through several stages before employee funds are disbursed.Each stage has a specific status that indicates where the payroll is in the process. For a detailed overview of payroll statuses and lifecycle, refer to the Payroll Processing Guide.