Payroll API
The Payroll API is an interface for payroll processing built into the Procountor API. It is a secure, well-documented, and automation-friendly integration for handling payroll. The Payroll API uses an M2M authentication model and an API Key. Procountor’s Payroll API is open, allowing software partners to build their own integrations. This eliminates the need to update data in multiple systems, as updates can be made directly via the API.
Once the integration is complete, the API allows you to:
Create, update, and retrieve employee data.
Create, update, retrieve, and approve payroll lists and payslips.
Retrieve and update accounting data for payslips, including dimensions.
You can access the technical documentation for the API here.
Deployment
To enable the Payroll API in a Procountor environment, the integration from the other software (API interfaces) must be ready.
Company information and payroll settings must also be done in Procountor beforehand.
Preparing the Environment for Payroll API Deployment (Example)
Enter the company information into Procountor:
Also ensure that vacation settings, working hour reduction leave, and average hourly calculation settings are configured.
Open the API key connection to Procountor according to the integration provider’s instructions.
Using the Payroll API from a user perspective (example)
Once payroll has been set up in Procountor and the necessary data is available:
Employees can be created in Procountor’s employee and payroll register via another software.
Working hours can be reviewed and approved in the other software and transferred to Procountor, which then generates the payroll list and payslips.
Payslips can be approved in the other software or alternatively in Procountor, if no dimension data is included.
If dimension data is transferred from the other software, the payslips will appear as Approved in Procountor after the transfer.
Verifying a successful transfer in the other software
Procountor sends any error messages to the other software (they are not visible in Procountor). The software provider may also have implemented the integration so that data is not transferred if it contains errors.
The payment of payslips and payroll lists is still handled through the Procountor user interface.
Note: Editing an approved payslip will also reset any dimension data imported from the other software to default values.
Terminating the Payroll API
Instructions for terminating the Payroll API can be found here. The Payroll API uses the M2M authentication model.