Earnings, hours, and deductions collected within a non-Paychex system such as an external Point-of-Sales systems to be sent over to Paychex to perform Payroll services.  The Payroll API provides all the capabilities needed to integrate pay data with Paychex Flex.  It exposes resources for Pay Components, Pay Periods and Checks. You will be using these end points, in combination with foundational APIs to create your solution.  

This will allow solutions to send and work with unprocessed check information.  The most common unprocessed check use cases are adding hours worked and commission/bonus/tip amounts to checks in Flex payroll entry. While an API solution can be used to send payroll data, the client or Paychex service provider must still review and complete the submission of the payroll for processing.  If you are interested in the Payroll API, please contact your Paychex sales rep or service provider. 
 

Pay Periods 

The company pay period calendar enables syncing and ensuring wages are paid on the correct dates.  Pay periods are typically used for applying earnings and deductions that a worker accumulated within the pay period range that can be added into one or more checks. The API supports the use of both unprocessed and processed pay periods. An unprocessed pay period allows for creating and retrieving unprocessed checks. A processed pay period allows only for the retrieval of checks. 

Note: The API will not allow the use of a pay period which is currently processing.  Use of the pay period will be allowed once the processing has completed.  

Pay Components 

Companies can define the pay components that are applicable to their business and are used in constructing a worker's check. The pay components are put into classifications and can have different effects on the outcome of the check. The company can set when these pay components are available by defining start and end dates, these dates come into play when creating a check in conjunction with the pay periods date range. When dealing with unprocessed check an earning needs to exists if a deduction is placed on the check.  

Checks 

The API will allow you to work with earnings on unprocessed checks. Using the other resources like workers, pay period, and pay components you can POST, GET, and DELETE for unprocessed checks. When creating checks, you can define for a worker their earnings and deductions using the pay components and combination of rate/amounts. When predefined configurations like reoccurring earnings and deductions are set on a worker these will automatically be applied to the check when it is created from the API.