Custom Suwinet integration
Appfront builds custom Suwinet integrations for municipal social services departments and other SUWI chain partners. Via Suwinet-Services (web services) and Suwinet-Inkijk, your own line-of-business application retrieves authorised income, benefit and employment data, in line with Digikoppeling, the Suwinet standards framework and ENSIA accountability. This keeps your team's data within a single workflow, without compromising on the strict security requirements of the SUWI chain.
What is a Suwinet integration?
Suwinet is the secure, shared infrastructure (the Gemeenschappelijke elektronische Voorziening Suwi, GeVS) that organisations in the SUWI chain use to exchange data for their statutory tasks. The chain consists of UWV, the SVB (Social Insurance Bank) and the municipal social services departments that implement the Participation Act. Suwinet is managed by BKWI, the Bureau Keteninformatisering Werk en Inkomen, a distinct organisational unit of UWV that acts on behalf of the Ministry of Social Affairs and Employment.
There are two ways to connect. Suwinet-Inkijk is a web application that authorised staff use to look up a citizen's data manually. Suwinet-Services are web services that let your own line-of-business application retrieve authorised data system-to-system, such as income, benefit and employment data. Data is not stored in Suwinet; it is transported solely within the government, with strict purpose limitation and only where a legal basis exists.
Appfront builds the integration based on the official BKWI Suwinet documentation and the OWASP ASVS security standard. We align web service calls, authorisation and logging with your working process and with the requirements of the Suwinet standards framework, so the integration fits both your existing software and the strict chain agreements. You should always verify the current specifications and connection requirements with BKWI. We also build integrations with related standards, such as Digikoppeling and the BRP (Personal Records Database).
Suwinet-Services web services
System-to-system data exchange from your own line-of-business application, in line with Digikoppeling. Your staff keep working in a single environment instead of switching to a separate screen.
Authorisation per service
Access is granted per service and per role through Suwinet-Autorisatie. We set up the integration so that only authorised data within the purpose limitation of your statutory task is retrieved, and no more than necessary.
Standards framework & ENSIA
The integration is built within the Suwinet-specific standards framework, which is included in ENSIA. Logging, access restriction and data minimisation are in place from the start, so you can demonstrate accountability every year.
Our development process for Suwinet integrations
We follow a proven method that removes uncertainty early and delivers a stable, compliant integration. From an initial analysis of your working process, the services you need and BKWI's connection requirements through to go-live and ongoing management, every step is aimed at an integration that your team can understand, manage and account for.
We map out which Suwinet services you need, which statutory task and purpose limitation apply, how your authorisation is set up and where your line-of-business application needs to connect.
We design the integration around the Suwinet-Services web services, PKIoverheid certificates and mutual TLS, with logging and error handling that meet the standards framework.
Implementation with automated tests, watertight audit logging and monitoring. We test against the chain acceptance environment, and you see working builds along the way.
A controlled go-live following BKWI's connection procedure, followed by ongoing maintenance, certificate rotation and support with your ENSIA accountability.
What a Suwinet integration delivers in practice
Every Suwinet integration is tailored to your work process, the services you are permitted to use and the adjacent systems in your IT landscape. Below are the features we deliver most often for municipal social services departments and other SUWI chain partners.
Data in your line-of-business application
Authorised income, benefit and employment data is shown directly in your own line-of-business application via Suwinet-Services. Your case manager or caseworker keeps working in a single screen, without switching to a separate lookup environment.
Tailored web service calls
We integrate exactly the Suwinet services you need, with proper error handling, timeouts and retry logic. If a source is unavailable, this is handled gracefully, so your process does not stall and the employee sees a clear message.
Authorisation and role management
Roles and permissions are set up in line with Suwinet-Autorisatie, so each employee only sees the services and data that match their task and legal basis. Stackable authorisations keep management clear and demonstrable.
Watertight audit logging
Every lookup is recorded in a traceable way: who, when, which data and on what basis. This logging is aligned with the standards framework and directly provides the evidence you need for ENSIA accountability and internal audits.
Data minimisation & purpose limitation
The integration only retrieves what the work process needs, at the right moment. No unnecessary queries, no needless storage — data is transported and displayed, not duplicated. This keeps the privacy impact as small as possible.
Certificate and connection management
Management of PKIoverheid certificates and mutual TLS connections, including timely rotation and monitoring of expiring certificates. Disruptions in the chain are detected early, so data exchange remains reliably available.
Typical use cases in practice
A Suwinet integration looks different for every organisation. We see a number of contexts come up again and again within the SUWI chain — and for each of them we have a working setup that pays attention to authorisation, purpose limitation and the standards framework.
Municipal social services departments
Case managers who carry out the Participation Act and need authorised income, benefit and employment data for intake, re-examination and lawfulness assessments. The integration brings this data into the line-of-business application, within a single work process. See also our software for municipalities.
Debt assistance
Debt assistance programmes where an up-to-date and reliable picture of income, benefits and employment is essential for drawing up a plan. With the right authorisation, the caseworker retrieves the data they need, with watertight logging and strict purpose limitation.
Income support
Special assistance, low-income schemes and other forms of income support where the municipality must be able to substantiate lawfulness. Authorised data from the chain supports a careful, fast and traceable assessment of applications.
Enforcement and lawfulness
Supervision and enforcement teams who investigate signs of unlawfulness within their statutory remit. The integration delivers the relevant data in an authorised manner, with full traceability of every query for accountability and audit.
Technology we use
We build Suwinet integrations around the Suwinet-Services web services, in line with Digikoppeling and the applicable chain agreements. The exact approach depends on the services you use and your existing backend — so your own team can manage and account for the integration. We verify the current technical specifications per service with BKWI.
For messages that follow the Suwi chain standard, there is our SuwiML integration.
Why choose Appfront for your Suwinet integration?
Appfront has extensive experience building integrations with government standards and API integrations for organisations in the Netherlands. We always start with a thorough analysis of your work process, the services you need and the chain agreements — a Suwinet integration must not only be technically correct, but also demonstrably stay within the legal frameworks.
For every integration we write clear documentation and make sure your own team — or a future supplier — can understand, manage and account for the integration. No black box, but transparent code and clear agreements on authorisation, logging, monitoring and certificate management.
You work with a dedicated point of contact who understands both the technology of Suwinet-Services and the requirements of the standards framework. That keeps communication lines short, prevents miscommunication and speeds up decisions when choices have to be made during the build.
Also take a look at our broader services around software for municipalities, custom software, the Digikoppeling integration and the BRP integration. Questions about your situation? Get in touch.
- Experience with government standards, Digikoppeling and web services
- Familiar with Suwinet-Services, Suwinet-Inkijk and per-service authorisation
- Works within the Suwinet security framework and ENSIA accountability
- Secure by default: PKIoverheid certificates, mutual TLS, scoped permissions
- Structured error handling and retry mechanisms
- Watertight audit logging and monitoring from day one
- Clear documentation that your team can read, manage and account for
- A single point of contact, no passing you between account managers
- Ongoing maintenance, certificate rotation and proactive development
- An approach tailored to your existing IT landscape and the chain agreements
Security and privacy in Suwinet integrations
Suwinet provides access to highly sensitive personal data (income, benefits and employment records) and is therefore exceptionally strictly regulated. Connected organisations must comply with the Suwinet-specific security framework, which has been fully incorporated into ENSIA since 1 April 2017 and consists of standards divided across a policy, implementation and control domain. You account for compliance each year through the ENSIA process. The legal basis lies in the SUWI Act and the SUWI Regulation, with strict requirements for purpose limitation, per-service authorisation and traceability. Appfront also builds in line with the OWASP ASVS.
In practice, we set up the integration with PKIoverheid certificates and mutual TLS, authorisation per service via Suwinet-Autorisatie, strict data minimisation and watertight audit logging that records, for every lookup, who requested data, when and on what legal basis. Data is only transported and displayed, never duplicated in your application. We document all data flows so that your processing register is complete, you demonstrably comply with the GDPR and you pass the Suwinet audit within ENSIA. You should always verify the final standards and connection requirements with BKWI.
More about our approach to security: information security policy and coordinated vulnerability disclosure (CVD) policy. Or book an advisory call about your connection.
- Complies with the Suwinet security framework (within ENSIA)
- In line with the SUWI Act and SUWI Regulation, with strict purpose limitation
- Per-service authorisation via Suwinet-Autorisatie
- PKIoverheid certificates and mutual TLS 1.2
- Traceable audit logging for every query
- Data minimisation: transport only, no storage in your application
- Monitoring, alerting and timely certificate rotation
- Documentation for your record of processing activities and ENSIA accountability
Frequently asked questions about Suwinet integrations
Answers to the questions we are asked most often about Suwinet integrations.
A Suwinet integration connects your application to Suwinet, the secure infrastructure that the SUWI chain partners (UWV, SVB and municipal social services departments) use to exchange data. As well as looking up data via the Suwinet-Inkijk web application, you can use Suwinet-Services (web services) to request authorised income, benefit and employment data system-to-system from your own specialist application. Suwinet is managed by BKWI, a department of UWV. Always verify the current conditions with BKWI.
Connecting to Suwinet is reserved for organisations with a statutory task and legal basis within the SUWI chain, such as UWV, SVB and municipal social services departments that implement the Participation Act. Data is only exchanged if there is a legal basis and purpose limitation for it. Whether and how your organisation may connect, and which services you may use, is determined by BKWI in the authorisation process. Appfront builds the technical integration; you confirm the connection requirements with BKWI.
Suwinet-Inkijk is a secure web application that allows authorised staff to look up a citizen's data manually. Suwinet-Services are web services that let your own specialist application request data automatically, system-to-system, without a staff member having to switch to a separate screen environment. For a seamless integration in your own software, Suwinet-Services is usually the most suitable route. Together with you, we assess which option fits your process and authorisation.
Suwinet-Services are SOAP web services offered in line with Digikoppeling, with a distinction between pull and push profiles depending on who initiates the exchange. Messages containing privacy-sensitive data are sent encrypted using mutual TLS 1.2 with PKIoverheid certificates. We connect these web services to your existing backend (Node.js, Java, .NET, Python or PHP) with robust error handling and logging. We verify the final specifications per service against the current BKWI documentation.
The cost depends on the complexity of the integration, the number of services you use, how authorisation and logging are set up, and the degree of customisation in your line-of-business application. Meeting the Suwinet standards framework and the ENSIA accountability requirements also demands care. We always provide a clear quote after a no-obligation analysis of your situation and BKWI's connection requirements.
Suwinet is strictly regulated. Connected organisations must comply with the Suwinet-specific standards framework, which has been part of ENSIA since 2017, and they report on this annually through the ENSIA process. The legal basis lies in the Wet SUWI and the Regeling SUWI, with strict purpose limitation and authorisation per service. Appfront builds the integration with PKIoverheid certificates, mutual TLS, tight access control, watertight logging and data minimisation, so you can demonstrably comply with both the standards framework and the GDPR.
Yes. Appfront takes over the management of existing Suwinet integrations, even if they were originally set up by another party. We review the web service calls, certificate chains, authorisation setup, logging and error handling, document the current set-up and assess it against the standards framework. From that point on, we handle changes, extensions with additional services and monitoring, including timely rotation of PKIoverheid certificates.
Suwinet provides access to data from, among others, UWV, SVB, municipalities, the BRP (personal records database), the Trade Register, the Tax Administration and the RDW, to the extent necessary for the statutory task. In practice, this mainly concerns income, benefit and employment data that municipal social services, debt assistance and enforcement teams need. Which services you may use exactly depends on your authorisation. Data is not stored in Suwinet but only transported; you can verify the current set of services with BKWI.
Ready to build your Suwinet integration?
Tell us which Suwinet services you want to use and in which line-of-business application the data needs to land, and we'll gladly help you think through Suwinet-Services, authorisation, the standards framework and ENSIA reporting. A no-obligation first conversation quickly gives you a clear picture of the possibilities. You can verify the connection requirements with BKWI.