Custom payroll tax return integration development
Appfront builds payroll tax return integrations for payroll software vendors, payroll bureaus and organisations with their own payroll administration. We build the integration that prepares the payroll tax return according to the Tax Authority's data specifications, validates it, submits it via Digipoort, and processes the confirmation of receipt and feedback messages, including corrections to earlier periods. So the return comes straight from your own data, and no feedback message goes unnoticed.
What is a payroll tax return integration?
Every employer periodically files a payroll tax return with the Dutch Tax Authority, containing data on wages, withheld tax and contributions per employee. The return is submitted digitally according to the Tax Authority's data specifications, via Digipoort. Most payroll packages do this for their customers. If you build or use your own payroll software, you have to arrange that submission yourself. That is what we build a payroll tax return integration for.
Without an integration, the return takes a detour: an export to another package, or re-entering data in a portal. Feedback messages from the Tax Authority about an employee or a period arrive separately and are processed by hand. Corrections to earlier periods are a puzzle of their own. And every year the specifications change, and someone has to work out what is different.
We build custom because the integration has to fit your software and your customers: how your payroll data is structured, how many employers and payroll tax numbers you serve, whether you submit directly via Digipoort or through a service provider, how you handle certificates, and how users want to see feedback messages. The Tax Authority's specifications are fixed; how they fit into your software is the real work.
From your own data
The return is prepared from the payroll data in your software, according to the specifications for the year being filed.
Validated before submission
Checks against the rules in the specifications before submitting, so a return is not rejected only once it reaches the Tax Authority.
Feedback messages processed
Acknowledgements, error messages and feedback reports returned to your software, by employer, period and employee.
How we build your payroll tax return integration
We start with your software: how the payroll data is structured, how many employers there are, and how returns currently reach the Tax Administration.
Your payroll data, employers and payroll tax numbers, the submission channel, and certificates.
Messages built from your data in line with the data specifications, with checks before submission.
Submission via Digipoort or a service provider, and processing of acknowledgements, errors and feedback reports.
Corrections for earlier periods, testing in the test environment, and maintenance for the annual changes.
What a payroll tax return integration actually does
The components below feature in almost every payroll tax return integration. Which ones you need depends on your software and customers.
Preparing
The return per employer and period, built from your payroll data in line with the specifications.
Validation
Checks against the rules in the specifications before sending.
Submission
Sending via Digipoort with a PKIoverheid certificate, or via a service provider.
Feedback reports
Acknowledgements, error messages and feedback reports by employer, period and employee.
Corrections
Corrections for earlier periods, included in a subsequent return.
Log
For each return: what was sent, when, by whom and with what result.
Who we build a payroll tax return integration for
The integration is intended for anyone who wants to submit the payroll tax return from their own software.
Payroll software vendors
A package that needs to support the return. The specifications and testing are the core.
Payroll bureaus
Returns for many employers. Feedback reports per employer matter most.
Organisations with their own payroll software
A custom system for a special collective labour agreement. What you need is the submission.
Industry-specific packages
Software for a sector with its own schemes. Corrections and validation are the core.
Technology and integrations
This page is about the payroll tax return. For integrations with payroll packages, see our pages on a Nmbrs integration and a Loket.nl integration, and for other financial messages our page on an SBR integration. You can read about our approach on building software.
For pension reporting to pension providers, see our page on a UPA integration.
Why Appfront for your payroll tax return integration?
A return that is late or incorrect costs the employer a fine or a correction. We build with that in mind: returns drawn from your own data, checked before submission, and feedback reports that don't get left unaddressed.
No detour
The return comes straight from your payroll data, with no export or portal.
No feedback report forgotten
Every feedback report stays with the employer and employee until it has been processed.
Ready for the new year
The specifications change every year. Maintaining the integration keeps your returns up to date.
Security and privacy in a payroll tax return integration
The integration processes employees' payroll and personal data, including the citizen service number (BSN), which is highly confidential. Certificates are stored securely and used only by the integration. Access is set up by role, and every return is logged.
The integration runs in a European data centre or in your own environment, with encrypted storage, daily backups and two-factor login.
Frequently asked questions about a payroll tax return integration
Questions that payroll bureaus and software vendors ask before getting started.
An integration that prepares the payroll tax return from your payroll software's data, validates it, submits it to the Dutch Tax Authority and processes the feedback messages.
Digitally via Digipoort, either directly with a PKIoverheid certificate or through a service provider that handles the connection. We look at which route fits in the first step.
According to the data specifications the Tax Authority publishes each year. What belongs in the return follows from your payroll calculation; the integration makes sure it is submitted correctly.
A message from the Tax Authority about a return, for example about employee data that is incorrect. The integration links it to the employer, the period and the employee so that it gets resolved.
Yes. In line with the specifications, corrections are included in a subsequent return, with an overview of what was corrected.
The Tax Authority publishes the specifications for each new year. As part of maintenance, we adapt the integration in good time and test it in the test environment.
Check that first. Almost all payroll packages submit the return, in which case this isn't needed. A custom build makes sense if you make or use your own payroll software, or if you are a supplier who wants the return built into your product.
Payroll tax returns straight from your own software?
Tell us which payroll software you use or build, for how many employers, and how the return is currently submitted. We'll show you what preparing, submitting and handling feedback messages would look like.