Returns filed from your own payroll data Submitted to the Tax Authority via Digipoort Feedback messages processed per return

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.

1
Mapping data and channel

Your payroll data, employers and payroll tax numbers, the submission channel, and certificates.

2
Preparing the return

Messages built from your data in line with the data specifications, with checks before submission.

3
Submission and feedback reports

Submission via Digipoort or a service provider, and processing of acknowledgements, errors and feedback reports.

4
Corrections and maintenance

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.

Tax Administration data specifications Digipoort PKIoverheid certificate Pre-submission checks Multiple payroll tax numbers Acknowledgements Error messages and feedback reports Corrections for earlier periods Log per return Maintenance for annual changes

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.

Edit content