SuwiML-koppeling laten maken
SuwiML is de berichtstandaard van de Suwi-keten, waarin UWV, SVB, gemeenten en andere partijen gegevens over werk en inkomen uitwisselen. BKWI beheert de standaard. Appfront bouwt koppelingen die berichten volgens SuwiML maken, lezen en controleren tegen de schema's, zodat uw systeem correct aansluit en bij een nieuwe versie van de standaard niet stilvalt.
Wat is een SuwiML-koppeling?
SuwiML is de taal waarin de Suwi-keten gegevens uitwisselt. Het bestaat uit een gegevensmodel, een basisschema in XML bij het gegevensregister van de keten, een berichtstandaard met de regels voor de opbouw van berichten, en een transactiestandaard per interface. BKWI beheert de standaard en de afspraken eromheen, samen met werkgroepen van de ketenpartijen.
Wie aansluit op de keten, moet berichten maken die exact aan de standaard voldoen, en berichten van anderen goed kunnen lezen. Dat gaat mis op details: een veld dat in de nieuwe versie anders heet, een code die niet meer geldig is, of een bericht dat technisch klopt maar inhoudelijk wordt afgewezen. Een koppeling die met de hand is gebouwd op één versie, valt stil zodra de standaard verandert.
Wij bouwen maatwerk omdat aansluitingen verschillen: welke berichten, welke interfaces en welke transportroute. Welke berichten en versies voor uw aansluiting gelden, en welke afspraken met BKWI of de ketenpartner nodig zijn, bekijken we in de eerste stap, samen met u. Voor de raadpleging van gegevens via Suwinet is er een aparte koppeling.
Berichten volgens de standaard
Gemaakt en gelezen volgens SuwiML.
Gevalideerd vooraf
Tegen de schema's, voordat een bericht vertrekt.
Klaar voor nieuwe versies
Bijgewerkt als de standaard verandert.
Hoe wij uw SuwiML-koppeling bouwen
We beginnen bij uw aansluiting: welke berichten moeten heen en terug, met welke ketenpartner, volgens welke versie van de standaard, en hoe gaat het transport. Vaak beginnen we bij het valideren van berichten tegen de schema's, omdat dat meteen laat zien wat er nu misgaat. Daarna bouwen we het maken en lezen van berichten, de foutafhandeling en het transport. We testen met de testomgeving van de ketenpartner voordat de koppeling live gaat, en houden hem bij als er een nieuwe versie van SuwiML komt.
Berichten, versies en ketenpartners.
Tegen de schema's van SuwiML.
Maken, lezen en transport.
Testen, en bijwerken bij nieuwe versies.
Wat een SuwiML-koppeling concreet doet
De onderdelen hieronder komen bij vrijwel elke SuwiML-koppeling terug. Welke u nodig hebt, hangt af van uw aansluiting.
Berichten maken
Volgens het basisschema.
Berichten lezen
In uw eigen systeem.
Validatie
Tegen de XML-schema's.
Foutafhandeling
Afwijzingen opgevolgd.
Versies
Nieuwe versies ondersteund.
Logboek
Elk bericht vastgelegd.
Voor wie wij een SuwiML-koppeling bouwen
De koppeling is bedoeld voor partijen die berichten in de Suwi-keten uitwisselen. Hoe meer berichten en interfaces, hoe meer een goede koppeling oplevert.
Gemeenten
Werk en inkomen. Juiste gegevens tellen het meest.
Leveranciers van software
Producten voor de keten. De standaard is de kern.
Regio's
Meerdere gemeenten. Eén aansluiting telt.
Re-integratie
Trajecten in de keten. Berichten tellen.
Technologie en koppelingen
Deze pagina gaat over berichten volgens SuwiML. Voor het raadplegen van gegevens via Suwinet is er onze pagina over de Suwinet-koppeling, voor het transport tussen overheden onze pagina over Digikoppeling, en voor gegevens van UWV onze pagina over de WBS-UWV-integratie. Onze werkwijze leest u op software laten maken.
Waarom Appfront voor uw SuwiML-koppeling?
Een bericht dat wordt afgewezen om een detail, of een koppeling die stilvalt bij een nieuwe versie, legt een proces in werk en inkomen stil, met mensen die op een besluit wachten. Daar bouwen we op: berichten volgens de standaard, validatie vooraf, en een koppeling die meegaat met nieuwe versies.
Correct
Volgens de standaard.
Vooraf getoetst
Geen afwijzing achteraf.
Actueel
Mee met nieuwe versies.
Security en privacy bij een SuwiML-koppeling
De koppeling verwerkt gegevens over werk, inkomen en uitkeringen van burgers, en daarvoor gelden strenge eisen. Toegang is per rol ingericht, berichten worden versleuteld verstuurd, en elk bericht wordt gelogd zodat terug te vinden is wie wat heeft uitgewisseld.
De koppeling draait in een Europees datacenter of in uw eigen omgeving, met versleutelde opslag en dagelijkse back-ups. We leggen de verwerking vast in een verwerkersovereenkomst en sluiten aan op de beveiligingsafspraken van de keten.
Veelgestelde vragen over een SuwiML-koppeling
Vragen die gemeenten en leveranciers stellen voordat ze hiermee beginnen.
SuwiML is de berichtstandaard van de Suwi-keten, waarin partijen als UWV, SVB en gemeenten gegevens over werk en inkomen uitwisselen. Het bestaat uit een gegevensmodel, een basisschema in XML, een berichtstandaard en een transactiestandaard per interface. BKWI beheert de standaard.
Suwinet is de voorziening waarmee gemeenten en ketenpartners gegevens raadplegen, bijvoorbeeld via Suwinet-Inkijk of Suwinet-Services. SuwiML is de standaard voor de berichten zelf. Een koppeling met Suwinet-Services gebruikt berichten volgens SuwiML.
Elk bericht wordt voor vertrek gecontroleerd tegen de XML-schema's van de geldende versie. Klopt het niet, dan vertrekt het niet en ziet u wat er mis is. Berichten die binnenkomen worden op dezelfde manier gecontroleerd voordat ze uw systeem in gaan.
Dan werken we de koppeling bij. We kijken wat er in de nieuwe versie verandert, passen de berichten aan en testen met de testomgeving van de ketenpartner. Waar nodig ondersteunt de koppeling een tijd beide versies, zodat de overgang niet op één dag hoeft.
De koppeling legt de afwijzing vast met de reden, en zet het bericht klaar voor controle en opnieuw versturen. Zo blijft er geen bericht liggen zonder dat iemand het ziet.
Voor aansluiting op de keten gelden afspraken en voorwaarden, die per voorziening verschillen. Welke voor uw situatie gelden, bekijken we in de eerste stap. Wij bouwen de koppeling; de aansluiting zelf regelt u met de ketenpartner.
Voor gemeenten en samenwerkingsverbanden die berichten in de Suwi-keten uitwisselen, voor softwareleveranciers die hun product op de keten willen aansluiten, en voor re-integratiebedrijven met berichten over trajecten. Hoe meer berichten, hoe meer een goede koppeling oplevert.
Berichten in de Suwi-keten die kloppen?
Vertel ons welke berichten u uitwisselt, met welke ketenpartner en wat er nu misgaat. We laten zien hoe de SuwiML-koppeling eruitziet.