StUF koppeling laten maken
Appfront bouwt maatwerk StUF-koppelingen voor het gemeentelijke applicatielandschap. We verbinden zaaksystemen, BRP-voorzieningen, belastingapplicaties en midoffice via StUF-ZKN en StUF-BG — XML-berichten over SOAP en Digikoppeling, met PKIoverheid-beveiliging. En omdat StUF richting de ZGW API’s en Common Ground migreert, koppelen of migreren we ook naar die moderne opvolger.
Wat is een StUF koppeling?
StUF — voluit Standaard Uitwisseling Formaat — is de berichtenstandaard die VNG Realisatie (voorheen KING) beheert voor gegevensuitwisseling binnen het gemeentelijke applicatielandschap. Het beschrijft hoe applicaties gestructureerde XML-berichten uitwisselen, doorgaans via SOAP bovenop Digikoppeling. StUF is een volwassen standaard die nog breed in gebruik is bij gemeenten en de leveranciers van hun kernapplicaties.
StUF kent sectormodellen voor verschillende domeinen. StUF-ZKN regelt de zaak- en documentservices tussen bijvoorbeeld een zaaksysteem en taakspecifieke applicaties (zaken, statussen, besluiten, documenten). StUF-BG regelt de basisgegevens: het bevragen en synchroniseren van personen, adressen en bedrijven vanuit een BRP-voorziening of gegevensmagazijn. Een StUF-koppeling kan een eenvoudige vraag/antwoord-bevraging zijn, of een asynchrone stroom van kennisgevingen waarop afnemers geabonneerd zijn.
Appfront bouwt volgens de officiële GEMMA/VNG StUF-documentatie en de OWASP ASVS security standaard. Belangrijk om eerlijk te zijn: StUF is inmiddels een legacy-standaard en de opvolging gaat richting de ZGW API’s binnen Common Ground. Wij bouwen daarom niet alleen nieuwe StUF-koppelingen, maar adviseren ook over het migratiepad en kunnen StUF en ZGW naast elkaar laten draaien.
StUF-ZKN: zaak- en documentservices
Het sectormodel voor zaakgericht werken: zaken aanmaken en bijwerken, statussen en besluiten doorgeven en documenten uitwisselen tussen het zaaksysteem en taakspecifieke applicaties. De basis voor een geïntegreerd zaaklandschap binnen de gemeente.
StUF-BG: basisgegevens
Bevragen en synchroniseren van basisgegevens zoals personen, adressen en bedrijven vanuit een BRP-voorziening of gegevensmagazijn. Met afnemerindicaties en kennisgevingen blijven aangesloten applicaties automatisch up-to-date.
Migratie naar ZGW / Common Ground
StUF is legacy; de toekomst is de ZGW API’s. We laten StUF en ZGW naast elkaar draaien of vertalen StUF-ZKN naar de ZGW API’s via een zaakbrug — zodat u stap voor stap migreert zonder de huidige koppelingen te breken.
Ons ontwikkelproces voor StUF koppelingen
We werken volgens een bewezen methodiek die onzekerheid vroeg wegneemt en een stabiele koppeling oplevert. Van een eerste analyse van uw applicatielandschap, sectormodellen en Digikoppeling-aansluiting tot livegang en doorlopend beheer — elke stap is gericht op een koppeling die uw organisatie zelf kan begrijpen en vertrouwen.
We brengen in kaart welke applicaties moeten koppelen, welk sectormodel (StUF-ZKN, StUF-BG of beide) en welke berichttypen nodig zijn, en of een migratiepad naar ZGW relevant is.
We ontwerpen de koppelarchitectuur, kiezen het juiste Digikoppeling-profiel met PKIoverheid en stellen de berichtmapping en foutafhandelingsstrategie op.
Implementatie met XML-schemavalidatie, automated tests tegen de leverancier-testomgeving, gestructureerde logging en monitoring. U krijgt tussentijds werkende builds te zien.
Gecontroleerde livegang met berichtvalidatie en vangnet, gevolgd door doorlopend beheer, monitoring en een eventueel verdere migratie naar ZGW.
Wat een StUF koppeling concreet oplevert
Elke StUF-koppeling wordt specifiek ingericht voor uw applicatielandschap, sectormodellen en aangrenzende voorzieningen. Hieronder de functionaliteiten die we het vaakst opleveren voor gemeenten en leveranciers die StUF inzetten — en stap voor stap naar ZGW willen.
Vraag/antwoord-bevragingen (Lv01/La01)
Synchrone bevragingen waarbij uw applicatie een Lv01-vraag stelt en een La01-antwoord terugkrijgt — bijvoorbeeld een persoon of adres opzoeken in een StUF-BG-voorziening, of zaakgegevens ophalen via StUF-ZKN. Met correcte selectie- en scope-parameters.
Kennisgevingen & abonnementen (Lk01)
Asynchrone mutatieberichten (Lk01) die wijzigingen automatisch doorgeven aan afnemers. Met afnemerindicaties en abonnementen blijven aangesloten applicaties up-to-date zonder steeds opnieuw te hoeven bevragen — inclusief de bijbehorende Bv03-bevestigingen.
Documentuitwisseling (StUF-ZKN)
Documenten als bijlage bij zaken uitwisselen tussen zaaksysteem en taakapplicaties, inclusief grote bestanden via MTOM/XOP. Metadata, status en besluiten lopen mee zodat het zaakdossier in het zaaksysteem volledig en actueel blijft.
Digikoppeling & PKIoverheid
StUF-berichten lopen over Digikoppeling: het WUS-profiel voor synchrone bevragingen en ebMS voor betrouwbaar asynchroon meldingsverkeer. We richten de PKIoverheid-certificaten, endpoints en het routeren in volgens de geldende afsprakenstelsels.
Berichtvalidatie & mapping
Inkomende en uitgaande berichten worden gevalideerd tegen de StUF-schema’s (versie 03.01) en de sectormodellen. We bouwen heldere mappings tussen uw interne datamodel en de StUF-elementen, met nette foutafhandeling via Fo0x-foutberichten.
StUF naar ZGW-zaakbrug
Een vertaallaag die StUF-ZKN-berichten omzet naar de ZGW API’s en omgekeerd. Zo blijven bestaande StUF-applicaties werken terwijl u nieuwe componenten op moderne REST/JSON-API’s aansluit — de praktische route naar Common Ground.
Typische toepassingen in de praktijk
Een StUF-koppeling pakt per organisatie heel verschillend uit. Een aantal patronen zien we vaak terugkomen binnen het overheidsdomein — en voor elk daarvan hebben we een werkende opzet met aandacht voor de juiste sectormodellen, Digikoppeling en het migratiepad naar ZGW.
Zaaksysteem en taakapplicaties
Gemeenten die hun zaaksysteem via StUF-ZKN koppelen aan taakspecifieke applicaties voor vergunningen, meldingen of sociaal domein. Zaken, statussen, besluiten en documenten stromen heen en weer zodat het zaakdossier centraal en compleet blijft. Zie ook onze software voor gemeenten.
Basisgegevens uit de BRP
Applicaties die via StUF-BG personen, adressen en bedrijven bevragen of synchroniseren met een BRP-voorziening of gegevensmagazijn. Met afnemerindicaties en kennisgevingen blijven gegevens actueel zonder dubbele registratie — een kernprincipe van eenmalige inwinning. Verwant: onze BRP-koppeling.
Midoffice, broker & belastingen
Een midoffice of broker die als centrale hub StUF-berichten routeert tussen kernapplicaties, en koppelingen met de belastingapplicatie voor aanslagen en bezwaren. We richten betrouwbaar berichtenverkeer in met duidelijke routering, logging en monitoring over het hele landschap.
Migratie naar Common Ground
Organisaties die van StUF naar de ZGW API’s willen zonder big bang. Met een zaakbrug laten we StUF en ZGW naast elkaar draaien en migreren we applicaties gefaseerd, zodat de dienstverlening tijdens de overgang blijft werken.
Technologie die we inzetten
StUF-koppelingen bouwen we met de officiële StUF-standaard (versie 03.01) en de sectormodellen, in combinatie met de backend-stack die bij u past. De precieze keuze hangt af van uw applicatielandschap, Digikoppeling-aansluiting en het gewenste migratiepad naar ZGW — zodat uw organisatie de koppeling kan beheren of doorontwikkelen.
Waarom Appfront voor uw StUF koppeling?
Appfront heeft ruime ervaring met het bouwen van koppelingen voor uiteenlopende organisaties in Nederland, inclusief het overheidsdomein. We beginnen altijd met een grondige analyse van de bestaande systemen en processen — een StUF-koppeling moet niet alleen technisch kloppen, maar ook praktisch waarde toevoegen binnen uw applicatielandschap.
Bij elke integratie schrijven we heldere documentatie en zorgen we dat uw eigen team — of een toekomstige leverancier — de koppeling kan begrijpen en beheren. Geen black box, maar transparante code en duidelijke afspraken over monitoring, alerting en beheer.
U werkt samen met een vast aanspreekpunt dat zowel de technische als de functionele kant begrijpt. Dat houdt de lijnen kort, voorkomt miscommunicatie en versnelt beslissingen wanneer er tijdens de bouw keuzes gemaakt moeten worden.
Bekijk ook onze bredere diensten rond software voor gemeenten, gemeente-websites, maatwerk software en Digikoppeling-koppelingen.
- Ervaring met StUF-ZKN, StUF-BG en de StUF-berichttypen
- Vertrouwd met Digikoppeling (WUS/ebMS) en PKIoverheid
- Bouwt zowel StUF- als ZGW-koppelingen — en migreert ertussen
- Secure by default — scheiding van rechten, autorisatie op berichtniveau
- Gestructureerde foutafhandeling, validatie en retry-mechanismen
- Uitgebreide logging en monitoring vanaf dag één
- Heldere documentatie die uw team kan lezen en beheren
- Vast aanspreekpunt, geen doorgeschoven accountmanagers
- Doorlopend beheer en proactieve doorontwikkeling
- Werkwijze afgestemd op uw bestaande applicatielandschap
Security en privacy bij StUF koppelingen
StUF-berichten met zaak- en basisgegevens bevatten vrijwel altijd persoonsgegevens. Transport loopt daarom over Digikoppeling met PKIoverheid-certificaten en versleuteling, met autorisatie op berichtniveau zodat een afnemer uitsluitend de gegevens ontvangt waar hij recht op heeft. Appfront bouwt volgens de OWASP ASVS en de overheidsnormenkaders (BIO), met scheiding van rechten en volledige logging.
We werken vanuit dataminimalisatie: alleen de gegevens die een afnemer nodig heeft, worden uitgewisseld. Wij documenteren de datastromen, mappings en berichtdefinities zodat uw verwerkingsregister compleet is en u aantoonbaar voldoet aan de AVG. Logging op berichtniveau maakt het verkeer traceerbaar en controleerbaar.
Meer over onze aanpak van security: informatiebeveiligingsbeleid en CVD-beleid.
- AVG-conforme gegevensverwerking en -minimalisatie
- Encryptie in transit (TLS 1.2+) en at rest
- Rolgebaseerde toegang en least-privilege principes
- Auditlogs met traceerbare datastromen
- Automatische retry en dead-letter queues
- Monitoring en alerting voor afwijkingen
- Secrets management volgens best practices
- Documentatie voor uw verwerkingsregister
Veelgestelde vragen over StUF koppelingen
Antwoorden op de vragen die we het vaakst krijgen over StUF-koppelingen.
StUF (Standaard Uitwisseling Formaat) is de berichtenstandaard van VNG Realisatie (voorheen KING) voor gegevensuitwisseling binnen het gemeentelijke applicatielandschap. Een StUF-koppeling wisselt XML-berichten uit via SOAP, doorgaans bovenop Digikoppeling. De standaard kent sectormodellen: StUF-ZKN voor zaak- en documentservices en StUF-BG voor basisgegevens zoals personen en adressen. Een koppeling kan eenvoudig zijn (een vraag/antwoord-bevraging) tot complex (asynchrone kennisgevingen met abonnementen tussen meerdere kernapplicaties).
StUF is een volwassen, breed gebruikte maar inmiddels legacy-standaard. De opvolging gaat richting de ZGW API’s (REST/JSON) binnen de Common Ground-beweging van VNG. In de praktijk draaien beide vaak naast elkaar: veel kernapplicaties en landelijke voorzieningen spreken nog StUF, terwijl nieuwe componenten ZGW gebruiken. Appfront bouwt zowel StUF- als ZGW-koppelingen en kan een StUF-landschap stap voor stap richting ZGW/Common Ground migreren, bijvoorbeeld via een zaakbrug die StUF-ZKN naar de ZGW API’s vertaalt.
StUF-ZKN (Zaak- en Documentservices) regelt het uitwisselen van zaken, statussen, besluiten en documenten tussen bijvoorbeeld een zaaksysteem en taakspecifieke applicaties. StUF-BG (Basisgegevens) regelt het bevragen en synchroniseren van basisgegevens zoals personen, adressen en bedrijven, vaak vanuit een BRP-voorziening of gegevensmagazijn. Beide bouwen op dezelfde StUF-berichtstructuur (versie 03.01) en transportlaag, maar dekken een ander functioneel domein. Welke u nodig heeft hangt af van de applicaties en processen die u wilt koppelen.
StUF-berichten zijn XML en worden uitgewisseld via SOAP, in de regel over het Digikoppeling WUS-profiel (en ebMS voor bepaalde meldingsverkeer) met PKIoverheid-certificaten voor authenticatie en beveiliging. We werken met de StUF-berichttypen zoals Lv01/La01 (vraag/antwoord), Lk01 (kennisgeving/mutatie), Bv03 (bevestiging) en de vrije berichten Di01/Du01. Aan onze kant bouwen we de adapter met de stack die bij u past — Java/.NET, Node.js of Python — inclusief XML-validatie tegen de schema’s, logging en monitoring.
De kosten worden bepaald door welk sectormodel (StUF-ZKN, StUF-BG of beide) en welke berichttypen nodig zijn, het aantal te koppelen applicaties, of het om bevragingen of ook mutaties/abonnementen gaat, en de eisen rond Digikoppeling, PKIoverheid en de testomgeving van de leverancier. Ook een eventueel migratiepad naar ZGW telt mee. We maken altijd een heldere offerte na een vrijblijvende analyse van uw applicatielandschap.
Ja. StUF-verkeer met basis- en zaakgegevens bevat persoonsgegevens en valt onder de AVG. Transport loopt via Digikoppeling met PKIoverheid-certificaten en versleuteling, met autorisatie op berichtniveau zodat een afnemer alleen de gegevens ontvangt waar hij recht op heeft. Appfront bouwt volgens OWASP ASVS en de overheidsnormenkaders (BIO), met scheiding van rechten, volledige logging en een dataminimalisatie-aanpak. We documenteren de datastromen zodat uw verwerkingsregister compleet blijft en u aantoonbaar aan de AVG voldoet.
Ja. Appfront neemt regelmatig bestaande StUF-koppelingen in beheer, ook als deze oorspronkelijk door een andere leverancier zijn opgezet. We voeren een review uit op de berichtdefinities, mappings, foutafhandeling en Digikoppeling-configuratie, documenteren de huidige opzet en stellen verbetervoorstellen op. Vanaf dat moment verzorgen we aanpassingen, uitbreidingen en monitoring — en kunnen we de koppeling waar gewenst gefaseerd richting de ZGW API’s migreren.
StUF is de standaard binnen het Nederlandse gemeentelijke domein. Een StUF-koppeling is daarom geschikt voor gemeenten, gemeentelijke samenwerkingsverbanden, omgevingsdiensten en uitvoeringsorganisaties die kernapplicaties zoals een zaaksysteem, BRP-voorziening, belastingapplicatie of midoffice/broker moeten verbinden, of moeten aansluiten op landelijke voorzieningen. Ook softwareleveranciers die hun applicatie StUF-compliant willen maken of richting ZGW willen ontsluiten, helpen we hiermee.
Klaar om uw StUF koppeling te laten maken?
Vertel ons welke applicaties u via StUF wilt koppelen, welke sectormodellen meespelen en of een migratie naar de ZGW API’s op de planning staat — we denken graag mee over StUF-ZKN, StUF-BG, Digikoppeling en het pad naar Common Ground. Een vrijblijvend eerste gesprek geeft u snel een scherp beeld van de mogelijkheden. Neem gerust contact met ons op.