e-Dienstverlening: Beschrijving koppelvlakken Suites voor ...

e-Dienstverlening:

Beschrijving koppelvlakken Suites voor het Sociaal Domein

Versie: 3 Datum: 10-01-2018 Afdeling: Businessunit Sociaal Domein

©2018. Centric Netherlands B.V. Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand of openbaar gemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of enige andere manier, zonder voorafgaande schriftelijke toestemming van Centric Netherlands B.V.

2

1. Inhoudsopgave

1. Inhoudsopgave ............................................................................................................... 2

2. Aanpassingen document ................................................................................................ 5

3. Inleidingen ...................................................................................................................... 7

4. Leeswijzer ...................................................................................................................... 8

5. Koppelvlakken in context ................................................................................................ 9

A. Context ....................................................................................................................... 9

B. Overzicht koppelvlakken ............................................................................................10

C. Functionele beschrijving berichtenverkeer via de generieke adapter .........................12

D. Technische opzet berichtenverkeer (ontvangen bericht via generieke adapter) .........13

E. Technische opzet berichtenverkeer (verzenden bericht via generieke adapter) .........14

F. Beveiliging .................................................................................................................14

G. Testmogelijkheden .....................................................................................................15

H. WSDL ........................................................................................................................15

6. Koppelvlak DKD (Digitaal KlantDossier) ........................................................................16

A. Functionele beschrijving ............................................................................................16

B. Technische beschrijving .............................................................................................17

7. Koppelvlak Aanvraag (Webintake) ................................................................................19



8. Koppeling Midoffice .......................................................................................................22

1 Koppelvlak Zakenmagazijn (Gebruik Zaak-Document-services: nee) ........................22



2 Koppeling Zaak- en Document-services (Gebruik Zaak-Document-services: ja) ........24



9. Koppelvlak Jaaropgave .................................................................................................26



10. Koppelvlak Uitkeringsspecificatie ...............................................................................29



11. Koppelvlak Eenmalige Gegevensuitvraag (e-Formulier) ............................................32

A. Functionele omschrijving ...........................................................................................32


12. Koppelvlak e-BB ........................................................................................................34


3


13. Koppelvlak ‘Aanvraag langdurigheidstoeslag’ ............................................................36



14. Koppelvlak ‘Aanvraag vergoeding chronisch zieken of gehandicapten’ ......................38



15. Koppelvlak ‘Vakantie of verblijf in buitenland’ .............................................................40



16. Koppelvlak Betaalgegevens Midoffice ........................................................................42



17. Koppelvlak Terugmelding Gegevens Verificatie .........................................................43



18. Koppelvlak EROW: Inlezen e-WWB ...........................................................................46



19. Electronisch VerzoekOmInformatie (e-VOI) ...............................................................48


B. Technische beschrijving ...............................................................................................48

20. Koppelvlak aansluiting CORV ....................................................................................50



21. Berichtenverkeer GGK ...............................................................................................52



22. Wmo advies- en Jeugdwet advies bericht ..................................................................54



23. Inlezen WMO301- en JW301-bericht .........................................................................56



24. Koppelvlak Integraal klantbeeld .................................................................................58



25. Koppelvlak MijnOverheid Berichtenbox ......................................................................60


4


26. Koppelvlak Regie- en Zaakservices ...........................................................................61



27. Koppelvlak Gezondverzekerd ....................................................................................63



5

2. Aanpassingen document

Versie Datum Auteur Omschrijving

0.5 01-12-2009 Frank Bink Initiële versie. Technische beschrijving koppelvlakken.

0.6 16-12-2009 Wim de Jonge Functionele beschrijving toegevoegd.

0.7 11-01-2010 Wim de Jonge Concept.

0.8 11-01-2010 Wim de Jonge Wijze van aanroepen koppelvlakken toegevoegd.

0.9 18-03-2010 Wim de Jonge Technische beschrijving BizTalk toegevoegd.

1.0 19-03-2010 Wim de Jonge Inleiding en leeswijzer.

1.1 26-04-2010 Frank Bink Methode van aanroep uitgebreid.

1.2 23-12-2010 Wim de Jonge Informatie over licenties toegevoegd. Bijgewerkt tot en met GWS4all versie 13.

1.3 17-06-2011 Wim de Jonge Informatie over testmogelijkheden toegevoegd. Bijgewerkt tot en met GWS4all versie 14.

1.4 12-10-2012 Lenny Kloos Bijgewerkt tot en met GWS4all versie 16 deel 1.

1.5 20-03-2013 Lenny Kloos Bijgewerkt tot en met GWS4all versie 16 deel 3.

1.6 28-06-2013 Lenny Kloos Bijgewerkt tot en met GWS4all versie 17 (nooit vrijgegeven)

1.7 04-12-2013 Mida Palm Bijgewerkt tot en met GWS4all versie 17.

1.71 30-12-2013 Frank Bink/ Mida Palm

Informatie over WSDL toegevoegd (hoofdstuk 5, paragraaf I)

1.8 09-07-2014 Peter Bouwman/ Mida Palm

Bijgewerkt tot en met GWS4all versie 18. - XSD’s andere map opzet voor aantal hogere berichten uit module KVA - Nieuw koppelvlak e-VOI

1.9 25-02-2015 Lenny Kloos Bijgewerkt t/m GWS4all versie 19 deel 3 - Informatie betreft Messagehandler - Aanpassing SOAPAction Koppeling Midoffice (Zaak-Document-services (pagina 21)) - Nieuwe DKD berichten - Nieuwe versie e-WWB bericht - Nieuwe versie StUF-EF versie 0315 - Koppelvlak aansluiting CORV toegevoegd - (Wsdl voor koppelvlak e-VOI beschikbaar >19.4)

2.0 09-11-2015 Henk Hulst Bijgewerkt i.v.m. naamswijziging GWS4all naar Suites voor het Sociaal Domein

6

2.1 31-05-2016 Frank Bink Bijgewerkt t/m Suites voor het Sociaal Domein versie 20.4: - Nieuwe DKD berichten - Uitfaseren StUF-Zaken 0201 - Uitbreiding koppelvlak Uitkeringsspecificatie - Uitbreiding koppelvlak Jaaropgave - Nieuwe versie CORV berichten - Berichtenverkeer GGK (webservice) toegevoegd - Koppelvlak Integraal klantbeeld toegevoegd - Wmo- en Jeugdwet advies bericht toegevoegd - Koppelvlak Snelbalie via website (.NET) i.p.v. BizTalk en nieuwe versie 8

2.2 21-02-2017 Frank Bink Bijgewerkt t/m Suites voor het Sociaal Domein versie 1.2: - Nieuw DKD bericht - iWmo en iJw berichtenverkeer XML-variant v2.1 en nieuwe versie StUF-XML envelope v2.1 - Koppelvlak MijnOverheid Berichtenbox toegevoegd - Koppelvlak Regie- en Zaakservices toegevoegd - Naamswijziging ‘koppelvlak Periodieke verklaringen en mutaties’ naar ‘koppelvlak Terugmelding Gegevens Verificatie’ doorgevoerd

2.3 16-08-2017 Frank Bink Bijgewerkt t/m Suites voor het Sociaal Domein versie 2.2: - Gewijzigde DKD-berichten - Koppelvlak MijnOverheid Berichtenbox nu ook voor stuksdocumenten

3 10-01-2018 Frank Bink Bijgewerkt t/m Suites voor het Sociaal Domein versie 3.0: - Nieuw koppelvlak GezondVerzekerd - Nieuw: inlezen WMO301- en JW301-berichten - Gewijzigd DKD-bericht - Koppelvlak Snelbalie bijzondere bijstand verwijderd

7

3. Inleidingen

Al geruime tijd staat elektronische dienstverlening vanuit de overheid in de schijnwerpers. Steeds meer gemeenten bieden inmiddels elektronische diensten aan voor inwoners en bedrijven. Wij constateren dat ook steeds meer WIZ-diensten hier stappen in zetten en dat er een groeiende vraag is naar informatie over de mogelijkheden van beschikbare koppelvlakken van Suites voor het Sociaal Domein (SvhSD). Dit document kunt u gebruiken in combinatie met het gepubliceerde document ‘Whitepaper e-Dienstverlening in combinatie met de Suites voor het Sociaal Domein’ dat ingaat op de organisatorische en functionele aspecten van e-Dienstverlening (beschikbaar op de Customerportal van Suites voor het Sociaal Domein). We hebben de koppelvlakken die in het kader van e-Dienstverlening zijn ontwikkeld opnieuw voor u op een rijtje gezet. Parallel aan het samenstellen van dit document is de beschikbare documentatie per koppelvlak verzameld en gebundeld. Deze informatie is vrij beschikbaar en kan worden gebruikt voor verdere verdieping. Voor vrijwel alle koppelvlakken is de volgende aanvullende informatie beschikbaar:

• Basisontwerp

• Releasenotes

• Workshopmateriaal

• De betreffende XSD’s

• Voorbeeld XML-berichten

Vanuit Centric willen wij vanzelfsprekend graag passende diensten leveren om onze klanten te helpen bij het maken van keuzes en de implementatie daarvan. Als u gebruik wilt maken van onze dienstverlening, neemt u dan contact op met [email protected]. De aanvullende documentatie kunt u vinden op de Customerportal van Suites voor het Sociaal Domein (Correspondentie Koppelvlakspecificaties). De nummers van de submappen corresponderen met de hoofdstukindeling van dit document.

http://itsol.centric.nl/ondersteuning/GWS4ALL/correspondentie/c1422/Whitepaper%20e-dienstverlening%20icm%20GWS4all.pdf


mailto:[email protected]

8

4. Leeswijzer

Voor u ligt de beschrijving van de koppelvlakken van Suites voor het Sociaal Domein die zijn ontwikkeld in het kader van e-Dienstverlening. Met het doel een samenvatting te geven, worden in dit document de mogelijkheden van de verschillende koppelvlakken van Suites voor het Sociaal Domein beknopt beschreven. Wij raden u aan, om voorafgaand aan dit document het ‘Whitepaper e-Dienstverlening in combinatie met de Suites voor het Sociaal Domein ’ te lezen. Dit whitepaper kunt u downloaden van de Customerportal van Suites voor het Sociaal Domein. In het eerste volgende hoofdstuk worden de koppelvlakken in hun context geplaatst. Aansluitend hierop wordt een overzicht gegeven van de bestaande koppelvlakken waarbij beknopt hun functie wordt geschetst. De twee voorlaatste paragrafen van dit hoofdstuk geven een functionele en een technische beschrijving van de werking van de koppelvlakken in het algemeen. Hier worden ook de positie van de generieke adapter en website (.NET) t.b.v. koppelvlak Snelbalie verduidelijkt. Het hoofdstuk wordt afgesloten met het aspect beveiliging.

Bent u al bekend met de algemene werking van de koppelvlakken of op zoek naar specifieke informatie, dan kunt u direct doorgaan met de hoofdstukken waarin ieder koppelvlak afzonderlijk wordt beschreven. Bij de beschrijving van ieder koppelvlak wordt eerst ingegaan op de functionele werking ervan; wat doet het koppelvlak en waarvoor kan het in worden gezet. Vervolgens worden de technische aspecten van het koppelvlak uiteengezet.



9

5. Koppelvlakken in context

A. Context

Over vraaggerichte, geïntegreerde- en elektronische dienstverlening en de bijbehorende ICT infrastructuur is al veel geschreven. Het is dan ook niet de bedoeling hier uitvoerig op in te gaan, maar kort te beschrijven hoe de koppelvlakken van Suites voor het Sociaal Domein in deze ontwikkelingen passen.

Het mag duidelijk zijn dat Suites voor het Sociaal Domein binnen de bekende informatiearchitectuur (front-, mid- en backoffice) moet worden gepositioneerd als een backoffice-applicatie. Sinds versie 4 van Suites voor het Sociaal Domein (voorheen GWS4all) is er actief gewerkt aan zoeken van aansluiting met de ketenpartners en het ontsluiten van informatie. De eerste stap werd gezet met de realisatie van het Elektronisch Ketenbericht (EKB), voorheen ook wel bekend onder de naam ‘berichtenverkeer CWI’. Door middel van het EKB werd het mogelijk om digitale berichten met ketenpartners uit te wisselen. Dit berichtenverkeer is inmiddels uitgefaseerd. Met de komst van het DKD werd een nieuwe impuls gegeven aan de digitale dienstverlening. Onder deze noemer is de uitwisseling van cliëntgegevens in de SUWI-keten mogelijk gemaakt. Ook ontwikkelingen als de Koppelvlakken Aanvraag, Jaaropgave en Uitkeringsspecificatie kunnen hieronder worden geschaard.

Met de introductie van deze koppelvlakken is het daadwerkelijk mogelijk gemaakt om vanuit Suites voor het Sociaal Domein (via het midoffice) digitale dienstverlening en informatieverstrekking aan de frontoffice plaats te laten vinden. Het koppelvlak e-BB bouwt hierop verder door het mogelijk te maken (vooringevulde) e-Formulieren aan te bieden aan de klant en na het invullen te verwerken in Suites voor het Sociaal Domein.

Door diverse ontwikkelingen op het gebied van bijvoorbeeld e-Dienstverlening, DKD en Zaakgericht werken worden de koppelvlakken van Suites voor het Sociaal Domein regelmatig vernieuwd, uitgebreid of aangepast. Deze koppelvlakken worden in dit document nader beschreven.

10

B. Overzicht koppelvlakken

Hier volgt een overzicht van de koppelvlakken van Suites voor het Sociaal Domein tot en met versie 3.

Naam Koppelvlak Korte omschrijving functionaliteit Vanaf SvhSD versie

Koppelvlak DKD - Uitwisseling van cliëntgegevens via webservices met de SUWI-keten.

5.6 e.v.

Koppelvlak Aanvraag - Automatisch aanmaken van een werkproces in Suites voor het Sociaal Domein

- Overnemen cliëntgegevens

6.1

Koppelvlak zakenmagazijn

- Aanmaken Zaak in zakenmagazijn en versturen statusinformatie.

- Ontvangen Zaaknummer (versie 13) - Automatisch aanmaken van een werkproces m.b.v.

een aanvraag intake bericht (versie 15)

- Vastleggen en overnemen van relaties tussen werkprocessen/zaken (versie 16)

- Besluit en resultaat van een Zaak kenbaar maken aan het zakenmagazijn (versie 16)

- Wijzigen betrokkenen van een Zaak (versie 16) - Uitwisseling gegevens via Zaak-DMS services (versie

17)

8.1

Koppelvlak Jaaropgave

- Op verzoek aanleveren van informatie jaaropgaaf cliënt aan MO/FO

8.1

Koppelvlak Uitkeringsspecificatie

- Op verzoek aanleveren van informatie uitkeringsspecificatie cliënt aan MO/FO

8.1

Koppelvlak Eenmalige Gegevensuitvraag

- Pre-fil gegevens aanleveren voor e-Formulieren 8.1

Koppelvlak e-BB - Werkproces aanmaken in Suites voor het Sociaal Domein

- Cliëntgegevens overnemen - Gegevens formulier inzien - Gegevens formulier afdrukken in document

9.1

Koppelvlak Betaalgegevens

- Betaalgegevens uit Suites voor het Sociaal Domein versturen naar en opnemen in het midoffice (bijvoorbeeld het Centric midoffice)

11.1

Koppelvlak Snelbalie Bijzondere Bijstand

- Volledig geautomatiseerd verwerken van aanvragen Bijzondere Bijstand in Suites voor het Sociaal Domein via BizTalk

12.1

Koppelvlak Aanvraag langdurigheidstoeslag

- Werkproces aanmaken in Suites voor het Sociaal Domein

- Cliëntgegevens overnemen - Gegevens aanvraag formulier inzien - Gegevens formulier afdrukken in document

14.1

Koppelvlak Aanvraag vergoeding chronisch zieken of gehandicapten

- Werkproces aanmaken in Suites voor het Sociaal Domein

- Cliëntgegevens overnemen - Gegevens aanvraag formulier inzien - Gegevens formulier afdrukken in document

14.1

Koppelvlak Aanvraag - Werkproces aanmaken in Suites voor het Sociaal 14.1

11

Naam Koppelvlak Korte omschrijving functionaliteit Vanaf SvhSD versie

vakantie of verblijf in buitenland

Domein - Gegevens aanvraag automatisch verwerken - Gegevens formulier afdrukken in document

Koppelvlak Mutaties en Periodieke Verklaringen

- Op verzoek aanleveren van informatie statusformulier en/of periodieke verklaringen aan MO/FO

- Ontvangen/verwerken reactie burger - Indien nodig: werkproces aanmaken in Suites voor

het Sociaal Domein

- Bijlagen met het bericht meesturen

15.0

Koppelvlak Erow: Inlezen e-WWB

- Ontvangen e-WWB bericht van het UWV (werk.nl) - Werkproces aanmaken in Suites voor het Sociaal

Domein - Inzien gegevens - Gegevens overnemen (eenmalige registratie)

17

Koppelvlak e-VOI - Binnenkomend vraagbericht (InkomstenVraag_310) ontvangen, herkennen, valideren en afhandelen.

- Juiste gegevens verzamelen uit Suites voor het Sociaal Domein en synchroon versturen

- Gegevens inzien

18

Koppeling CORV

- VTO-bericht versturen - Notificatie-, Zorgmelding-, Bevestiging- en

Foutberichten ontvangen - Werkproces- en/of signaal aanmaken - Cliëntgegevens overnemen

19

Berichtenverkeer GGK Koppelvlak Integraal klantbeeld Wmo- en Jeugdwet advies-bericht

- Versturen, ontvangen en afhandelen iWmo- en iJw-berichten (webservice)

- Binnenkomend vraagbericht (ikbLv01) ontvangen, herkennen, valideren en afhandelen

- Juiste gegevens verzamelen uit Suites voor het Sociaal Domein en synchroon versturen

- Binnenkomend Wmo advies-bericht ontvangen, herkennen, valideren en afhandelen

20

Koppelvlak MijnOverheid Berichtenbox Koppelvlak Regie- en Zaakservices

- Versturen en afhandelen van berichten (webservice) voor bulkdocumenten

- Versturen, ontvangen, valideren en afhandelen van

berichten (webservice)

1

Koppelvlak MijnOverheid Berichtenbox

- Versturen en afhandelen van berichten (webservice) nu ook voor stuksdocumenten

2

Koppelvlak GezondVerzekerd Inlezen WMO301 en JW301

- Ontvangen en verwerken van collectieve verzekering-berichten (gemeentepolis)

- Ontvangen en verwerken van WMO301 en JW301

berichten door centrumgemeente n.a.v. verstuurde berichten vanuit regiogemeenten

3

12

C. Functionele beschrijving berichtenverkeer via de generieke adapter

Door middel van de generieke adapter is het mogelijk om berichten uit te wisselen tussen Suites voor het Sociaal Domein en de buitenwereld. In de vorm van XML-berichten worden gegevens verzonden naar bijvoorbeeld het midoffice of inlichtingenbureau. Ook kunnen XML-berichten worden ontvangen vanuit andere applicaties, zoals het midoffice. De ontvangen berichten resulteren bijvoorbeeld in het aanmaken van een werkproces, het wegschrijven van gegevens of het aanmaken van een reactie in de vorm van een nieuw XML-bericht.

13

D. Technische opzet berichtenverkeer (ontvangen bericht via generieke adapter)

UServerUServer

Tomcat

IIS

URouter Userver(bm_ber_ontv.aps)

8080

80

8009

13093Web.xml urouter.asn berichtenverkeer.asn

Zendende partij GSD (server) GSD (client)

A

C

E

BF

G H

I

D

Schematische weergave ontvangen bericht

Technische beschrijving

A. Er wordt een bericht naar GSD-webserver op poort 8080 verzonden.

B. Jakarta Tomcat ontvangt een http-request. In het instellingenbestand web.xml wordt gezocht welke servlet bij het ontvangen van dit bericht hoort.

C. Het is mogelijk een aparte webserver te gebruiken, bijvoorbeeld IIS. In dat geval zal niet poort 8080, maar poort 80 (default http) worden gebruikt.

D. In IIS staat gespecificeerd dat voor het specifieke request Tomcat moet worden gebruikt als servlet-engine.

E. Tomcat wordt nu benaderd via poort 8009. Dit is overigens configureerbaar.

F. Vanuit Tomcat wordt de applicatieserver op poort 13093 geactiveerd.

G. Op deze poort staat de Urouter van Uniface geconfigureerd. In het instellingenbestand urouter.asn staat gespecificeerd wat te doen.

H. Een userver-proces wordt opgestart. Afhankelijk van de instellingen kunnen hiervan meerdere instanties naast elkaar draaien. De berichtenverkeer-asn’s worden gebruikt. De adapter wordt gestart. Het bericht wordt verwerkt.

I. Hierbij wordt data in de betreffende database (verwijzing in .asn-bestand) geplaatst.

14

E. Technische opzet berichtenverkeer (verzenden bericht via generieke adapter)

Schematische weergave verzenden bericht

Technische beschrijving

A. Vanuit Suites voor het Sociaal Domein wordt opdracht gegeven om een bericht te verzenden.

B. De noodzakelijke data wordt in de betreffende database (verwijzing in .asn-bestand) geplaatst.

C. Vanaf de cliënt wordt een server proces opgestart, de applicatieserver wordt geactiveerd over poort 13093.

D. Op deze poort staat de Urouter van Uniface te luisteren.

E. Deze activeert een instantie van een userver-proces. Waarin het feitelijke bericht wordt samengesteld.

F. Hierbij wordt data uit de database gelezen.

G. Het bericht wordt uiteindelijk verzonden via een http kanaal (poort 80).

F. Beveiliging

Een aandachtspunt bij het berichtenverkeer is de beveiliging van de gegevens (XML-berichten) die over de lijnverbindingen verstuurd worden. De meest gangbare manier van communicatiebeveiliging over internet is de inzet van certificaten. Het inzetten van certificaten heeft geen gevolgen voor de functionaliteit van Suites voor het Sociaal Domein. Het speelt zich geheel af op de webserver, waar de generieke adapter op draait.

Sinds versie 19 wordt er door Centric een nieuwe tool aangeboden, namelijk de MessageHandler. Deze tool geeft mogelijkheden voor de beveiliging van het berichtenverkeer zoals transport- en versleutelingsmogelijkheden d.m.v. het gebruik van

15

certificaten. Meer informatie over het gebruik en de installatie van de MessageHandler, kunt u vinden via onze Customerportal.

G. Testmogelijkheden

Het testen van de beschikbare koppelvlakken op de generieke adapter behoort tot de mogelijkheden. Er zijn allerlei programma’s beschikbaar om webservices te testen. Voorbeelden hiervan zijn SOAPUI, Testmaker en WebInject. Alle drie zijn open source software. Met deze programma’s kunnen XML-berichten naar de generieke adapter gestuurd worden. Dit kan voor testdoeleinden gebruikt worden, maar kan ook voor demonstraties ingezet worden.

Ook wordt er een online testomgeving beschikbaar gesteld. Deze omgeving stelt de koppelvlakken beschikbaar en biedt daarmee derde partijen de gelegenheid software te testen door een xml bericht in te schieten en de respons te beoordelen. Om gebruik te kunnen maken van deze online testomgeving moet een bepaalde procedure doorlopen worden. Hiervoor kunt u contact opnemen met de afdeling Product management van de BU WIZ.

H. WSDL

Voor de volgende koppelvlakken (waarvoor geen landelijke standaard beschikbaar is) is een WSDL beschikbaar:

- Koppelvlak Aanvraag o T.b.v. Webintake berichtversie v0300 en v0400

- Koppelvlak Uitkeringsspecificatie o T.b.v. UitkeringsSpecificatieClient berichtversie v0200 en v0300

- Koppelvlak Jaaropgave o T.b.v. JaarOpgaveClient berichtversie v0200 en v0300

- Koppelvlak Eenmalige Gegevensuitvraag o T.b.v. EenmaligeGegevensUitvraag berichtversie v0100 en v0200

- Koppelvlak Mutaties en periodieke verklaringen o T.b.v. VoorinvullingGegevensVerificatie berichtversie v0100 o T.b.v. TerugmeldingGegevensVerificatie berichtversie v0100 en v0200

- Koppelvlak e-VOI (20.3) o T.b.v. InkomstenVraag_310 berichtversie X04V02

- Wmo- en Jeugdwet advies-bericht (20.3 resp. 20.4) o T.b.v. ggsDi01-v0301(ontvangen) en ggsDu01-v0301 (versturen) o T.b.v. ggkDi01-v0310 (ontvangen) en ggkDu01-v0310 (versturen)

- Koppelvlak Integraal klantbeeld (20.3) o T.b.v. ikbLv01-v0310

- Koppelvlak GezondVerzekerd o T.b.v. GezondVerzekerd berichtversie v0100

Elke WSDL beschrijft in XML-taal de interface van het koppelvlak. M.b.v. een WSDL kan een voorbeeld testbericht gemaakt worden. Dit is vooral handig voor ontwikkelaars. Intern bij Centric is getest met het genereren van testberichten m.b.v. .NET. Naar aanleiding hiervan zijn er nog wijzigingen doorgevoerd aan de XSD’s. Er is geen test uitgevoerd met het genereren van testberichten onder bijvoorbeeld Java. Bij de implementatie dient u de SOAPEndpoint te vullen met de gewenste waarde. Deze waarde is per gemeente en per omgeving verschillend. De WSDL’s bevinden zich in de voor het bericht (dienst) van toepassing zijnde XSD-map. Deze dienen zich op het zelfde niveau te bevinden.

16

6. Koppelvlak DKD (Digitaal KlantDossier)

A. Functionele beschrijving

Met dit koppelvlak kunnen binnen de SUWI-keten (bijv. GSD, UWV Werkbedrijf, UWV, RDW, SVB) bekende gegevens van cliënten worden uitgewisseld en kan invulling gegeven worden aan de vereisten uit de Wet Eenmalige Gegevensuitvraag.

In versie 5 van Suites voor het Sociaal Domein is de basisfunctionaliteit geleverd, namelijk de nodige aanpassingen aan de adapter en het automatisch aanmaken van een verwijsindex die naar het Inlichtingenbureau (IB) wordt gezonden. De verwijsindex is een bestand waarin wordt aangegeven welke personen met een BSN in registraties van de desbetreffende organisaties zijn opgenomen. Met deze index kunnen de relevante (GSD)gegevens worden geleverd aan het IB. Bevragingen van gemeenten lopen via het IB, door middel van de verwijsindex kan de juiste WIZ-dienst via het IB worden bevraagd. Met andere woorden, vanuit de verwijsindex bij het Inlichtingenbureau wordt dan verwezen naar de plek waar de gevraagde informatie beschikbaar is. De functionele ondersteuning van het daadwerkelijk gebruik van de beschikbare DKD–gegevens is met de najaarsversie 2007 van Suites voor het Sociaal Domein gerealiseerd. Binnen Suites voor het Sociaal Domein is het mogelijk gemaakt om de DKD-gegevens via webservices op te vragen. Handmatig vanuit een programma in Suites voor het Sociaal Domein en automatisch bij het opstarten van een werkproces worden de DKD-berichten van alle partijen opgevraagd. Tevens is er een apart programma beschikbaar om de opgevraagde gegevens te raadplegen. Daarbij bestaat de mogelijkheid om een kwaliteitskenmerk aan te geven.

De opgevraagde gegevens kunnen worden ingezien en vergeleken met gegevens uit eerdere berichten van dezelfde soort. Ook het hergebruiken van de gegevens in documenten behoort tot de mogelijkheden.

Samengevat zijn de volgende functionaliteiten in Suites voor het Sociaal Domein beschikbaar:

- Aanleveren verwijsindex aan IB (versie 5.6) - Bevraagd worden via het IB (versie 7) - Opvragen, inzien en beoordelen van DKD-gegevens (versie 7) - DKD-gegevens gebruiken binnen documenten (versie 7) - Collectieve opvraag BSN’s (versie 8) - Vergelijkingsscherm DKD (versie 9) - Tonen van UWV-berichten in Participatiedossier

17

B. Technische beschrijving

Technische onderdelen

Er wordt gebruik gemaakt van de volgende berichtversies.

Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten).

Versturen bericht Ja (n.a.v. het vragen om gegevens, betreft een synchrone beantwoording)

Ontvangen bericht Ja (n.a.v. het bevraagd worden, betreft een synchrone beantwoording)

Gebruikte standaard

SuwiML (standaard binnen de SUWI-keten).

Informatie-beveiliging

Het behoort tot de mogelijkheden om PKI-certificaten in te zetten om een tweetal beveiligingsniveaus te bereiken namelijk:

• Beveiligde verbinding (SSL – HTTPS);

• Versleuteling van de inhoud van het bericht. Dit wordt ondersteund door de MessageHandler.

18

Methode van aanroep

In de protocol header staan de stuurgegevens van het bericht opgenomen: de URL en de SOAPAction. Bij het versturen van berichten middels SOAP over HTTP zijn de URL, de SOAPAction en het Bericht type van belang voor het authentiseren, valideren en routeren van het bericht. - De URL bevat de ‘adressering’ van het bericht. - De SOAPAction is de aanduiding voor de webserver aan welk

stuk programmatuur het bericht moet worden aangeboden. De SOAPAction moet qua naamgeving overeenkomen met die uit het bericht en die uit de URL.

- Het berichttype is samengesteld uit een berichtnaam, een VersieMajor en een VersieMinor.

Voor de berichten vanaf Suites voor het Sociaal Domein versie 15 geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. Het berichttype in de header wordt bij webservice adressering ook niet meer gevuld. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. De gewenste inhoud is opgenomen in de bij het bericht behorende wsdl. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/GSDDossierPersoon-v0400/ of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Bijstandsregelingen-v0400/ of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente /run/GSDDossierReintegratie-v0100/

SOAP action "SOAPAction" value =" "/> Contenttype text/xml METHOD - POST

Meer informatie over SuwiML transactiestandaard is te vinden op: http://bkwi.nl/transactiestandaard (Suwi-ML v3.1)

Licentie Dit koppelvlak is beschikbaar gesteld onder het DKD budget. Omschrijving licentie: Koppeling Digitaal KlantDossier

http://bkwi.nl/transactiestandaard

19

7. Koppelvlak Aanvraag (Webintake)


Via het koppelvlak Aanvraag is het mogelijk automatisch een werkproces binnen Suites voor het Sociaal Domein op te laten voeren (op vooraf gedefinieerde regeling/groep). De uitwisseling gaat via een XML bericht. De generieke adapter zet het bericht om tot een signaal en/of werkproces. Zolang het bericht aan de vastgestelde opbouw voldoet, maakt het niet uit door welke applicatie het bericht gegenereerd wordt.

Indien het een binnen Suites voor het Sociaal Domein onbekende cliënt betreft, worden ook NAW gegevens overgenomen uit het bericht en wordt de mogelijkheid geboden de cliënt aan Suites voor het Sociaal Domein toe te voegen (na controle op GBA).

Met Suites voor het Sociaal Domein versie 8 is de tweede versie beschikbaar gekomen. In dit bericht is specifiek het element ‘Zaakidentificatie’ toegevoegd om ondersteuning aan het midoffice te geven in combinatie met het eveneens in Suites voor het Sociaal Domein versie 8 beschikbaar gestelde bericht omtrent ‘Statusinformatie’.

In Suites voor het Sociaal Domein versie 15 is er mogelijkheid om bijlagen met het bericht mee te sturen en deze af te laten vangen in het midoffice, zodat deze onder het Zaak-id kunnen worden opgenomen in het documentenmagazijn. Ook worden vanaf deze versie de cliënt en eventueel andere bijstandspartijen automatisch opgenomen als bijstandspersonen in Suites voor het Sociaal Domein (tabel SZBPAANVR).

Met de verschillende releases van Suites voor het Sociaal Domein zijn de schema`s voor de berichten aangepast om de overdracht van de volgende informatie mogelijk te maken:

Berichtversie 1 Initiële versie (Suites voor het Sociaal Domein versie 6)

Berichtversie 2 Zaak-id toegevoegd, binnen het koppelvlak kan het in het front-/midoffice uitgetrokken Zaak-id aan Suites voor het Sociaal Domein worden doorgegeven. Uitbreiding met eigen onderwerp- en categorietype (Suites voor het Sociaal Domein versie 8.1.4).

Berichtversie 3 Aanvraagdatum toegevoegd (Suites voor het Sociaal Domein versie 10).

Berichtversie 4 Mogelijkheid om bijlagen mee te sturen en 1 of meerdere bijstandspartijen worden automatisch als bijstandspersoon opgenomen (Suites voor het Sociaal Domein versie 15).

20


Technische

onderdelen

Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende bericht te valideren: Voor berichtversie 3:

• Webintake-v0300-b01-Envelope.xsd;

• Webintake-v0300-b01-Body.xsd;

• GWSML-v0100-Header.xsd;

• GWSgegevenstypen-v0100-b01.xsd Voor berichtversie 4: map Diensten\Webintake\v0400-b01:

• Envelope.xsd;

• Body.xsd;

• GWSMLHeader.xsd;

• Include-gwsml.xsd De in de genoemde XSD’s benodigde subschema’s worden uit onderstaande mappen gehaald:

Deze schema’s zijn vrij beschikbaar (inclusief WSDL en voorbeeld XML-berichten).

Versturen bericht Nee

Ontvangen bericht Ja

Gebruikte

standaard

GWSML

Voor het grootste deel van de gebruikte elementen in het XML-

bericht is aansluiting gezocht bij de standaard SuwiML (gebaseerd

op het entiteitenmodel SGR v8.0).

De volgende elementen maken geen deel uit van SGR, maar zijn

wel noodzakelijk t.b.v. het koppelvlak en achterliggende

functionaliteit in Suites voor het Sociaal Domein:

• Berichtsoort;

• Onderwerp;

• Categorie;

• ZaakIdentificatie;

• Toelichting;

• CdFictieveGeboorteDat; Ook bevat GWSML gegevens uit STUFML.

21

Informatie-

beveiliging




Methode van aanroep

Webintake v0300 In de protocol header staan de stuurgegevens van het bericht opgenomen: de URL en de SOAPAction. Bij het versturen van berichten middels SOAP over HTTP zijn de URL, de SOAPAction en het Bericht type van belang voor het authentiseren, valideren en routeren van het bericht. - De URL bevat de ‘adressering’ van het bericht. - De SOAPAction is de aanduiding voor de webserver aan welk



SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Webintake-v0300/

SOAP action "SOAPAction" value ="http://www.centric.nl/GWS/Basis/Webintake-v0300"/> Webintake v0400 Voor het bericht Webintake v0400 geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Webintake-v0400/

SOAP action "" Voor beide berichtversies: Contenttype text/xml METHOD - POST

Licentie Dit koppelvlak is beschikbaar gesteld onder het DKD budget. Omschrijving licentie: Koppelvlak Aanvragen

22

8. Koppeling Midoffice

1 Koppelvlak Zakenmagazijn (Gebruik Zaak-Document-services: nee)


Via dit koppelvlak worden een drietal onderdelen ondersteund. Sinds versie 8 worden vanuit Suites voor het Sociaal Domein relevante statuswijzigingen van werkprocessen binnen de module Werkbeheersing actief doorgegeven aan het midoffice. Werkprocessen en fasen waarvoor dit relevant is kunnen binnen Suites voor het Sociaal Domein ingesteld worden. Ten tweede ondersteunt dit koppelvlak sinds versie 10 de mogelijkheid om bij het rechtstreeks opvoeren van een werkproces in Suites voor het Sociaal Domein een Zaak aan te laten maken in het zakenmagazijn (in het midoffice). Ten derde is het vanaf Suites voor het Sociaal Domein versie 15 mogelijk om, naast de huidige mogelijkheden, een ‘aanvraag intake’ bericht o.b.v. StUF Zaken te ontvangen. Deze berichten zullen in Suites voor het Sociaal Domein leiden tot het aanmaken van werkprocessen en/of signalen, waarbij het Zaak-id al direct bekend is. StUF Zaken wordt gezien als standaard voor het ‘Webintake berichtenverkeer’ tussen midoffice en backoffice . Bij deze wijziging is een nieuw bericht beschikbaar gekomen: Ontvangen Zaak (zakLk01-v0310)

Vanaf Suites voor het Sociaal Domein versie 16 (StUF Zaken 0310) zijn er ook de volgende mogelijkheden bijgekomen:

- Het vastleggen van relaties tussen werkprocessen (zaken) en dit kenbaar maken aan het zakenmagazijn.

- Het overnemen van relaties tussen zaken in Suites voor het Sociaal Domein - Besluit en resultaat van een werkproces (Zaak) kenbaar maken aan het zakenmagazijn

en dit koppelen aan de juiste Zaak.

- Het wijzigen van betrokkenen bij een Zaak.

Voor deze nieuwe mogelijkheden zijn berichten beschikbaar gekomen op basis van StUF Zaken. Hier zijn voorbeelden van beschikbaar in de bijlagen van dit document.

Sinds versie 17 is er de mogelijkheid bijgekomen om via de door KING gespecificeerde services te communiceren met het DMS en het zakenmagazijn. In Suites voor het Sociaal Domein is er de keuzemogelijkheid om via de nieuwe Zaak-Document-services te werken, om op de ‘oude’ manier te communiceren of beide mogelijkheden naast elkaar te gebruiken (meergemeentefunctionaliteit). Voor meer informatie over de Zaak-Document-services zie het volgende hoofdstuk en het workshopmateriaal van versie 17, te vinden in de bijlagen.

Met versie 20 is StUF-Zaken v0201 uitgefaseerd aangezien deze versie voor KING geen geaccepteerde standaard is.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om de uitgaande berichten te valideren: StUF 03.01 met sectormodel StUF-zaken 03.10

• zkn0310.msg.xsd Tevens is er een .wsdl beschikbaar:

• zkn0310.ontvangAsynchroon.wsdl

• zkn0310.verwerkSynchroneKennisgeving.wsdl

23

• zkn0310.beantwoordVraag.wsdl Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld xml-berichten).

Versturen bericht Ja


Gebruikte standaard

Sectormodel StUF-Zaken (gebaseerd op GFO-Zaken). De standaard StUF maakt onderdeel uit van OSOSS.




• Versleuteling van de inhoud van het bericht. Het inzetten van PKI-certificaten is momenteel in ontwikkeling.

Methode van aanroep




SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/zakLk01-v0310/

SOAP action “SOAPAction” value =”http://www.egem.nl/StUF/sector/zkn/0310/zakLk01”/> Contenttype text/xml METHOD POST

Licentie Dit koppelvlak Zakenmagazijn is beschikbaar gesteld onder het DKD budget. Omschrijving licentie: Koppeling Digitaal KlantDossier

24

2 Koppeling Zaak- en Document-services (Gebruik Zaak-Document-services: ja)


De programmatuur van Suites voor het Sociaal Domein wordt in de loop der tijd aangepast aan de nieuwe eisen van het Zaakgericht werken. Om die reden is het mogelijk gemaakt dat Suites voor het Sociaal Domein kan communiceren met de zogenaamde Zaak-Document-services. Deze services zijn gespecificeerd door KING waardoor de Zaakgegevens via een vast gestelde standaard worden uitgewisseld. Deze services zorgen voor ontsluiting en koppeling van Zaakgegevens tussen de backoffice (Suites voor het Sociaal Domein), het zakenmagazijn en het DMS. Voor meer informatie over deze services en over de huidige werking van Suites voor het Sociaal Domein in combinatie met het ZM en het DMS, zie het workshopmateriaal V17 ‘Koppeling Zaak en DMS services’ dat is opgenomen in de bijlage.

Vanaf versie 18 is het mogelijk om met deze services te werken. Duidelijk moet zijn dat ook de huidige koppeling met het Zakenmagazijn mogelijk blijft, en ook beide koppelingen naast elkaar kunnen werken (i.g.v. gebruik meergemeentefunctionaliteit). Voor meer informatie wordt verwezen naar: http://gemmaonline.nl/index.php/Zaak-_en_Documentservices.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om de uitgaande berichten te valideren:

• zkn0310_msg_mutatie.xsd

• zkn0310_ontvangAsynchroon_mutatie.wsdl

• zkn0310_msg_vraagAntwoord.xsd

• zkn0310_ontvangAsynchroon_vraagAntwoord

• zkn0310_msg_zs-dms.xsd Tevens is er een .wsdl beschikbaar:

• zkn0310_beantwoordVraag.wsdl

• zkn0310_ontvangAsynchroon_vraagAntwoord.wsdl

• zkn0310_ontvangAsynchroon_mutatie.wsdl

• zkn0310_verstrekSynchronisatieBericht.wsdl

• zkn0310_verwerkSynchroneKennisgeving_mutatie.wsdl Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld xml-berichten).



Gebruikte standaard

Standaard ontwikkeld door KING: “Standaard services voor ontsluiten en koppelen van Zaak systeem (ZS) en Document Management Systeem (DMS)” Dit wordt nog doorontwikkeld. KING is verantwoordelijk voor specificaties. De standaard is gebaseerd op StUF zaken.





http://gemmaonline.nl/index.php/Zaak-_en_Documentservices

25

Methode van aanroep

Vanuit Suites voor het Sociaal Domein worden alleen Zaakservices en Zaakdocumentservices aangeroepen. Specificaties voor deze services worden opgesteld en beheerd door KING. De services zijn:

- StUF Zaakservices - StUF Zaakdocumentservices De CMIS services voor synchroniseren zaken en documenten zijn in het midoffice gepositioneerd. Deze services zijn: - CMIS Document services - CMIS Integratie services De applicatiebeheerder van Suites voor het Sociaal Domein dient met de midoffice leverancier af te stemmen wat de url voor de verschillende services zijn. Deze zijn namelijk variabel en in te stellen via Parameters Berichtenverkeer in Suites voor het Sociaal Domein. SOAP action De SOAP Action in het bericht dient te eindigen met de naam van de aan te roepen service (gedefinieerd door KING). Als voorbeeld: "SOAPAction" value ="http://www.egem.nl/StUF/sector/zkn/0310/<naam_service>", bijvoorbeeld: http://www.egem.nl/StUF/sector/zkn/0310/CreeerZaak.

Licentie De licentie ‘Koppeling Zaak en DMS services’ is nodig indien gebruik wordt gemaakt van deze services.

26

9. Koppelvlak Jaaropgave


Via dit koppelvlak kan aan Suites voor het Sociaal Domein gevraagd worden om de gegevens te verstrekken voor een jaaropgave. Op deze wijze kan de klant via internet zelf inzage krijgen in diens jaaropgave. De informatie voor de jaaropgave wordt op dat moment opnieuw bepaald en houdt dus altijd rekening met de meest actuele situatie (inclusief correcties e.d.). Het koppelvlak levert een bericht op en dus geen document. De in het bericht opgenomen gegevens dienen via de frontoffice (desgewenst via een midoffice) gepresenteerd te worden.

Vanaf versie Suites voor het Sociaal Domein 16.3 is er een nieuwe berichtversie van het bericht Jaaropgave beschikbaar gekomen, namelijk versie JaarOpgaveClient-v0300-b01. Dit vanwege aanpassingen in verband met de Wet Uniform Loonbegrip. In het bericht is nu de werkgeversheffing opgenomen.

In versie 20 is in het antwoordbericht een element toegevoegd (BelasteAlimentatie). Hiervoor is geen nieuwe versie/buildnummer beschikbaar gesteld maar opgenomen in v0300-b01.


Technische

onderdelen

Er wordt o.a. gebruik gemaakt van de volgende schema’s om de

binnenkomende vraag en uitgaande antwoordbericht te valideren.

Voor berichtversie 2:

T.b.v. het requestbericht:

• JaarOpgaveClient-v0200-b01-EnvelopeAction.xsd;

• JaarOpgaveClient-v0200-b01-BodyAction.xsd;

T.b.v. het responsebericht:

• JaarOpgaveClient-v0200-b01-EnvelopeReaction.xsd;

• JaarOpgaveClient-v0200-b01-BodyReaction.xsd;

T.b.v. beide berichten:


• GWSgegevenstypen-v0100-b01.xsd;

• FWI-v0100-b01.xsd.

Voor berichtversie 3: map Diensten\JaarOpgaveClient\v0300-b01 T.b.v. het requestbericht:

• EnvelopeAction.xsd;

• BodyAction.xsd; T.b.v. het responsebericht:

• EnvelopeReaction.xsd;

• BodyReaction.xsd; T.b.v. beide berichten:

27


• Include-gwsml.xsd De in de genoemde XSD’s benodigde subschema’s worden uit onderstaande mappen gehaald:



Ontvangen bericht Ja (betreft een synchrone beantwoording)

Gebruikte

standaard

GWS-ML




De volgende elementen maken geen deel uit van SGR, maar

worden wel geleverd om een juiste weergave van de jaaropgave te

tonen:

• Gemeentecode;

• Gemeentenaam;

• Bezoekadres;

• Woonplaatsnaam;

• Regeling;

• Dienstjaar;

• AangiftePeriodeVan;

• AangiftePeriodeTot;

• Fiscaalloon;

• Loonheffing;

• CdPremieVolksverzekering;

• IndicatieZVW;

• IngehoudenPremieZVW;

• VergoedingPremieZVW;

• Loonheffingskorting;

• Belaste Alimentatie;

Informatie-

beveiliging




28

Methode van aanroep

JaarOpgaveClient-v0200 In de protocol header staan de stuurgegevens van het bericht opgenomen: de URL en de SOAPAction. Bij het versturen van berichten middels SOAP over HTTP zijn de URL, de SOAPAction en het Bericht type van belang voor het authentiseren, valideren en routeren van het bericht. - De URL bevat de ‘adressering’ van het bericht. - De SOAPAction is de aanduiding voor de webserver aan welk



JaarOpgaveClient-v0300 Voor het bericht JaarOpgaveClient-v0300 geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/JaarOpgaveClient-v0200/ of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/JaarOpgaveClient-v0300/

SOAP action JaarOpgaveClient-v0200

"SOAPAction" value

="http://www.centric.nl/GWS/Basis/JaarOpgaveClient-v0200"/>

SOAP action JaarOpgaveClient-v0300

””

Contenttype text/xml METHOD - POST


29

10. Koppelvlak Uitkeringsspecificatie


Dit koppelvlak is vergelijkbaar met dat voor de Jaaropgave, alleen hierbij wordt informatie verstrekt over de uitkering van een bepaalde periode. Ook hiervoor geldt dat het koppelvlak, op basis van een vraag met daarin relevante selectiecriteria, een bericht levert dat door de frontoffice (desgewenst via een midoffice) geïnterpreteerd en gepresenteerd moet worden.

Vanaf Suites voor het Sociaal Domein versie 16.3 is er een nieuwe versie van het bericht uitkeringsspecificatie beschikbaar gekomen, namelijk UitkeringsSpecificatieClient-v0300. In deze versie zijn aanpassingen doorgevoerd i.v.m. met SEPA.

In versie 20.3 heeft er een uitbreiding plaatsgevonden in het antwoordbericht en in functionaliteit aan de applicatie-kant. Hiervoor is een nieuw berichtversie v0400-b01 beschikbaar gekomen en is de ondersteuning van v0200-b01 beëindigd.


Technische

onderdelen

Er wordt o.a. gebruik gemaakt van de volgende schema’s om de binnenkomende vraag en uitgaande antwoordbericht te valideren. Voor berichtversie 3: map Diensten\UitkeringsSpecificatieClient\v0300-b01: T.b.v. het requestbericht:






• Include-gwsml.xsd Voor berichtversie 4: map Diensten\UitkeringsSpecificatieClient\v0400-b01: T.b.v. het requestbericht:






• Include-gwsml.xsd

30

Voor beide berichtversies geldt dat de in de genoemde XSD’s benodigde subschema’s uit onderstaande mappen gehaald worden:




Gebruikte

standaard

GWS-ML




De volgende elementen maken geen deel uit van SGR, maar worden wel geleverd om een juiste weergave van de uitkeringsspecificatie te tonen:

• Gemeentecode;

• Gemeentenaam;

• Bezoekadres;

• Woonplaatsnaam;

• Regeling;

• Dossiernummer;

• Periodenummer;

• Betrekkingsperiode;

• Componenthistorie;

• GekorteInkomsten

• OpgegevenInkomsten;

• TeVerrekenenInkomsten;

• InkomstenVrijlating;

• InkomstenNaVrijlating;

• VakantieGeldOverInkomsten;

• UitbetaaldBedrag;

• Cliëntnummer;

• Toelichting bij component;

• Datum betaling uitkering;

• Uitbetaald bedrag cliënt en partner.

Informatie-

beveiliging




31

Methode van aanroep

UitkeringsSpecificatieClient v0300 en v0400 Voor het bericht UitkeringsSpecificatieClient geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/UitkeringsSpecificatieClient-v0300/ of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/UitkeringsSpecificatieClient-v0400/

SOAP action ”” Contenttype text/xml METHOD POST


32

11. Koppelvlak Eenmalige Gegevensuitvraag (e-Formulier)

A. Functionele omschrijving

Koppelvlak voor het opvragen van NAW-gegevens van bekende cliënten uit Suites voor het Sociaal Domein, te gebruiken ten behoeve van pre-fill van e-Formulieren.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om de binnenkomende vraag en uitgaande antwoordbericht te valideren. Voor berichtversie 1: T.b.v. het requestbericht:

• EenmaligeGegevensUitvraag-v0100-b01-EnvelopeAction.xsd;

• EenmaligeGegevensUitvraag-v0100-b01-BodyAction.xsd;


• EenmaligeGegevensUitvraag-v0100-b01-EnvelopeReaction.xsd;

• EenmaligeGegevensUitvraag-v0100-b01-BodyReaction.xsd;



• GWSgegevenstypen-v0100-b01.xsd. Voor berichtversie 2: T.b.v. het requestbericht:

• EenmaligeGegevensUitvraag-v0200-b01-EnvelopeAction.xsd;

• EenmaligeGegevensUitvraag-v0200-b01-BodyAction.xsd;


• EenmaligeGegevensUitvraag-v0200-b01-EnvelopeReaction.xsd;

• EenmaligeGegevensUitvraag-v0200-b01-BodyReaction.xsd;



• GWSgegevenstypen-v0100-b01.xsd. Deze schema’s zijn vrij beschikbaar (inclusief WSDL en voorbeeld XML-berichten).



33

Gebruikte standaard

GWS-ML Voor het grootste deel van de gebruikte elementen in het XML-bericht is aansluiting gezocht bij de standaard SuwiML (gebaseerd op het entiteitenmodel SGR v8.0). Het volgende element maakt geen deel uit van SGR, maar worden wel geleverd om een juiste weergave van de cliëntgegevens te tonen t.b.v. de pre-fill:

• CdFictieveGeboorteDat;





Methode van aanroep




SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/EenmaligeGegevensUitvraag-v0200/

SOAP action "SOAPAction" value ="http://www.centric.nl/GWS/Basis/EenmaligeGegevensUitvraag-v0200"/> Contenttype text/xml METHOD - POST


34

12. Koppelvlak e-BB


Dit betreft een verdieping van het Koppelvlak Aanvraag, waarbij aanvullende inhoudelijke gegevens betreffende de aanvraag voor bijzondere bijstand kunnen worden uitgewisseld. Vergelijkbaar met de beschreven werking bij het Koppelvlak aanvragen wordt automatisch een werkproces aangemaakt en zo nodig de cliënt opgevoerd. Aanvullend worden de inhoudelijke gegevens in Suites voor het Sociaal Domein opgenomen en kunnen deze bij de aanvraag worden getoond.

Vanaf versie 14 kan ook gebruik worden gemaakt van het DKD2 e-Formulier ‘aanvraag e-BB’ van het Kwaliteitsinstituut Nederlandse Gemeenten (KING), welk is gebaseerd op StUF-EF 03.10.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende bericht te valideren. Vanaf versie 14 ook: StUF 03.01 en sectormodel StUF-EF 03.10

• ef0310.msg.xsd

• ef0310.ontvangAsynchroon.wsdl Vanaf versie 19 StUF 03.01 en sectormodel StUF-EF 03.15

• ef0315_msg_mutatie.xsd

• ef0315_OntvangAsynchroon_mutatie.wsdl Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten).



Gebruikte standaard

Sectormodel StUF-EF 3.10 en Sectormodel StUF-EF 3.15. De standaard StUF maakt onderdeel uit van OSOSS.





35

Methode van aanroep

In de protocol header staan de stuurgegevens van het bericht opgenomen: de URL en de SOAPAction. Bij het versturen van berichten middels SOAP over HTTP zijn de URL, de SOAPAction van belang voor het authentiseren, valideren en routeren van het bericht. - De URL bevat de ‘adressering’ van het bericht. - De SOAPAction is de aanduiding voor de webserver aan welk

stuk programmatuur het bericht moet worden aangeboden. De SOAPAction moet qua naamgeving overeenkomen met die uit het bericht en die uit de URL. In de SOAPAction wordt entiteittype, berichtcode en versienummer opgenomen.

SOAP endpoint vanaf versie 14 http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/bbaLk01-v0310/

SOAP action vanaf versie 14 "SOAPAction" value =” http://www.egem.nl/StUF/sector/ef/0310/bbaLk01"/> SOAP endpoint vanaf versie 19 http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/bbaLk01-v0315/

SOAP action vanaf versie 19 "SOAPAction" value =” http://www.egem.nl/StUF/sector/ef/0315/bbaLk01"/> Contenttype text/xml METHOD - POST


36

13. Koppelvlak ‘Aanvraag langdurigheidstoeslag’


In het kader van DKD2 zijn meerdere e-Formulieren beschikbaar gekomen. Deze e-Formulieren worden aangeboden door het KING. E-Formulieren zijn aanvragen (of wijzigings-)formulieren die een burger via internet kan invullen en digitaal kan versturen. Burgers zijn hierdoor niet meer afhankelijk van openingstijden van de gemeente.

Binnen de set van e-Formulieren, bevindt zich het formulier “Aanvraag langdurigheidstoeslag” (zowel voor klanten met als zonder een uitkering in het kader van WWB, IOAW, IOAZ) .

Vergelijkbaar met de hierboven beschreven werking van Koppelvlak e-BB wordt automatisch een werkproces aangemaakt en zo nodig de cliënt opgevoerd. Aanvullend worden de inhoudelijke gegevens van de aanvraag langdurigheidstoeslag in Suites voor het Sociaal Domein opgenomen en kunnen deze bij de aanvraag worden getoond.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende bericht te valideren. StUF 03.01 en sectormodel StUF-EF 03.10

• ef0310.msg.xsd

• ef0310.ontvangAsynchroon.wsdl

Vanaf versie 19 StUF 03.01 en sectormodel StUF-EF 03.15





Gebruikte standaard






37

Methode van aanroep

In de protocol header staan de stuurgegevens van het bericht opgenomen: de URL en de SOAPAction. Bij het versturen van berichten middels SOAP over HTTP zijn de URL en de SOAPAction van belang voor het authentiseren, valideren en routeren van het bericht. - De URL bevat de ‘adressering’ van het bericht. - De SOAPAction is de aanduiding voor de webserver aan welk


SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ltsLk01-v0310/ SOAP action "SOAPAction" value =” http://www.egem.nl/StUF/sector/ef/0310/ltsLk01"/> Vanaf versie 19 SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ltsLk01-v0315/ SOAP action "SOAPAction" value =” http://www.egem.nl/StUF/sector/ef/0315/ltsLk01"/> Contenttype text/xml METHOD - POST


38

14. Koppelvlak ‘Aanvraag vergoeding chronisch zieken of gehandicapten’


In het kader van DKD2 zijn meerdere e-Formulieren beschikbaar gekomen. Deze e-Formulieren worden aangeboden door KING. E-formulieren zijn aanvragen (of wijzigings)formulieren die een burger via internet kan invullen en digitaal kan versturen. Burgers zijn hierdoor niet meer afhankelijk van openingstijden van de gemeente. Binnen de set van e-Formulieren welke door het KING aangeboden worden, bevindt zich het formulier “Aanvraag vergoeding chronisch zieken of gehandicapten”.

Vergelijkbaar met de hiervoor beschreven werking van Koppelvlak e-BB wordt automatisch een werkproces aangemaakt en zo nodig de cliënt opgevoerd. Aanvullend worden de inhoudelijke gegevens van de aanvraag ‘Aanvraag vergoeding chronisch zieken of gehandicapten’ in Suites voor het Sociaal Domein opgenomen en kunnen deze bij de aanvraag worden getoond.




• ef0310.msg.xsd

• ef0310.ontvangAsynchroon.wsdl Vanaf versie 19 StUF 03.01 en sectormodel StUF-EF 03.15





Gebruikte standaard






39

Methode van aanroep



SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/cgzLk01-v0310/

SOAP action "SOAPAction" value =" http://www.egem.nl/StUF/sector/ef/0310/cgzLk01"/> Vanaf versie 19: SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/cgzLk01-v0315/

SOAP action "SOAPAction" value =" http://www.egem.nl/StUF/sector/ef/0315/cgzLk01"/> Contenttype text/xml METHOD - POST


40

15. Koppelvlak ‘Vakantie of verblijf in buitenland’


In het kader van DKD2 zijn meerdere e-Formulieren beschikbaar gekomen. Deze e-Formulieren worden aangeboden door het KING. E-formulieren zijn aanvragen (of wijzigings)formulieren die een burger via internet kan invullen en digitaal kan versturen. Burgers zijn hierdoor niet meer afhankelijk van openingstijden van de gemeente. Binnen de set van e-Formulieren welke door het CP-ICT aangeboden worden, bevindt zich het formulier “Vakantie of verblijf in buitenland”.

Vergelijkbaar met de hiervoor beschreven werking van Koppelvlak e-BB wordt automatisch een werkproces aangemaakt. Als het ontvangen bericht betrekking heeft op een in Suites voor het Sociaal Domein bestaande cliënt, dan wordt de inhoud van dit bericht automatisch overgenomen in Suites voor het Sociaal Domein.




• ef0310.msg.xsd

• ef0310.ontvangAsynchroon.wsdl

Vanaf versie 19 StUF 03.01 en sectormodel StUF-EF 03.15





Gebruikte standaard

Sectormodel StUF-EF 3.10 en StUF-EF 3.15. De standaard StUF maakt onderdeel uit van OSOSS.





41

Methode van aanroep



SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/vvbLk01-v0310/

SOAP action "SOAPAction" value =" http://www.egem.nl/StUF/sector/ef/0310/vvbLk01"/> Vanaf versie 19: SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/vvbLk01-v0315/

SOAP action "SOAPAction" value =" http://www.egem.nl/StUF/sector/ef/0315/vvbLk01"/> Contenttype text/xml METHOD - POST


42

16. Koppelvlak Betaalgegevens Midoffice


Om in applicaties van de frontoffice gegevens uit het gegevensmagazijn met betrekking tot betalingen van uitkeringen beschikbaar te kunnen stellen moeten deze gegevens uit de database van Suites voor het Sociaal Domein (backoffice) naar het gegevensmagazijn worden gedistribueerd.

Met dit koppelvlak kunnen betaal gegevens uit Suites voor het Sociaal Domein beschikbaar worden gesteld in het gegevensmagazijn in het (Centric) midoffice. Vanuit Suites voor het Sociaal Domein wordt een programma gestart om de gegevensoverdracht te initiëren, de verdere afhandeling van de opdracht vindt plaats op een applicatieserver. Met het programma kunnen betaalgegevens worden toegevoegd, wijzigingen worden doorgegeven en weer uit het midoffice worden verwijderd.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om de uitgaande berichten te valideren: Berichtversie StUF 2.04 / WIZ 01.00

• wiz0100.msg.xsd Berichtversie StUF 03.10 / WIZ 03.10

• wiz0310.msg.xsd Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten).


Ontvangen bericht Nee

Gebruikte standaard Conform StUF-XML





Methode van aanroep

Niet van toepassing; het berichtenverkeer wordt geïnitieerd vanuit Suites voor het Sociaal Domein.

Licentie Bij dit koppelvlak is beschikbaar gesteld onder het DKD budget. Omschrijving licentie: Koppeling betaalgegevens midoffice.

43

17. Koppelvlak Terugmelding Gegevens Verificatie


Het koppelvlak Terugmelding Gegevens Verificatie bestaat uit twee koppelvlakken namelijk: VoorinvullingGegegevensVerificatie (VGV) en TerugmeldingGegevensVerificatie (TGV). Via deze koppelvlakken kunnen gegevens voor een statusformulier of periodieke verklaring uit Suites voor het Sociaal Domein aan de frontoffice worden aangeboden om zo voor een pre-fill te zorgen van bijvoorbeeld een webformulier (VGV). Als dit vooringevulde webformulier vervolgens door de burger geaccordeerd wordt, kan er een bericht worden teruggestuurd naar Suites voor het Sociaal Domein om zo een geblokkeerd uitkeringsdossier te laten deblokkeren (TGV). In geval de burger niet akkoord is, dient in het XML bericht het gedeelte (tag) m.b.t. Webintake aangeleverd te worden. Hierdoor wordt een werkproces aangemaakt waarin de aangegeven wijzigingen handmatig doorgevoerd kunnen worden in Suites voor het Sociaal Domein. Met dit bericht kunnen ook bijlagen meegestuurd worden. Deze bijlagen dienen in de midoffice opgeslagen te worden in het DMS. Tevens wordt er een Zaak aangemaakt waarvan het unieke Zaaknummer wordt gekoppeld aan het document in het DMS en in het TGV bericht.

Het bericht VGV is een (synchroon) vraagbericht welke vanaf de webpagina naar de generieke adapter van Suites voor het Sociaal Domein wordt gestuurd, vergelijkbaar met EenmaligGegevensUitvraag.TGV is het ontvangen van de terugmelding (asynchroon), vergelijkbaar met het Webintake bericht.

Deze nieuwe koppelvlakken zijn beschikbaar gekomen in Suites voor het Sociaal Domein versie 15.

Vanaf versie 17.1 van Suites voor het Sociaal Domein een nieuwe versie van het bericht TerugmeldingGegevensVerificatie beschikbaar gesteld: v0200.

Het is mogelijk gemaakt om bij AKKOORD ook Webintake-gegevens op te nemen t.b.v. het aanmaken van een werkproces en/of signaal in Suites voor het Sociaal Domein. De status van de periodieke verklaring in SZINKBR wordt bijgewerkt naar 3: Teruggemeld zonder mutaties.



Er wordt gebruik gemaakt van de volgende schema’s om de berichten te kunnen valideren: TerugmeldingGegevensVerificatie: Voor berichtversie 1: map Diensten\TerugmeldingGegevensVerificatie\v0100-b01

• Body.xsd;

• Envelope.xsd;


• Include-gwsml.xsd Voor berichtversie 2: map Diensten\TerugmeldingGegevensVerificatie\v0200-b01

• Body.xsd;

• Envelope.xsd;

44


• Include-gwsml.xsd VoorinvullingGegevensVerificatie: map Diensten\VoorinvullingGegevensVerificatie\v0100-b01: T.b.v. het requestbericht:

• EnvelopeAction.xsd

• BodyAction.xsd T.b.v. het responsebericht:

• EnvelopeReaction.xsd

• BodyReaction.xsd Voor beide berichten geldt dat de in de genoemde XSD’s benodigde subschema’s uit onderstaande mappen gehaald worden:

Deze schema’s zijn vrij beschikbaar (inclusief WSDL en voorbeeld XML-berichten)

Versturen bericht Ja (VGV)

Ontvangen bericht Ja (TGV)

Gebruikte standaard GWS-ML








Methode van aanroep

VoorinvullingGegevensVerificatie en TerugmeldingGegevensVerificatie Voor de berichten VoorinvullingGegevensVerificatie en TerugmeldingGegevensVerificatie geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de

45

SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/TerugmeldingGegevensVerificatie-v0100/ http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/TerugmeldingGegevensVerificatie-v0200/ http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/VoorinvullingGegevensVerificatie-v0100/ SOAP action ”” Contenttype text/xml METHOD POST

Licentie Dit koppelvlak kunt u gebruiken met de licentie: Koppeling TerugmeldingGegevensVerificatie

46

18. Koppelvlak EROW: Inlezen e-WWB


Het koppelvlak EROW verwerkt een XML bericht dat bij een Wwb aanvraag bij het UWV wordt gegenereerd. Dit ‘e-WWB bericht’ wordt gegenereerd via http://www.werk.nl. Het bericht valt onder de berichten van EROW (Eenmalige Registratie Op Werkpleinen). De specificaties van dit bericht zijn door het KING eind mei 2012 beschikbaar gesteld.

Voor de verwerking van het nieuwe bericht ‘WerkpleinDienstverleningEWwb’ is op de generieke adapter een koppelvlak gerealiseerd. Omdat het nieuwe bericht, net zoals het voormalige EKB aanvraagbericht, een aanvraag voor algemene bijstand betreft, zijn er overeenkomsten voor wat betreft de functionaliteit. Een samenvatting van de functionaliteit die Suites voor het Sociaal Domein hierbij biedt:

- Op basis van een meldingnummer automatisch een werkproces opboeken - Controle op al in Suites voor het Sociaal Domein aanwezige cliënten zodat de

aanvraaggegevens aan het eventueel al bestaande cliëntnummer gekoppeld kunnen worden

- Overnameschermen voor persoons-, uitkerings-, inkomens-, en vermogensgegevens die in het bericht zijn opgenomen

- Binnen het programma ‘Inzien berichten’ de logging en de inhoud van het e-WWB bericht bekijken

- Vanuit Opvragen Algemeen een ontvangen e-WWB bericht inzien - De gegevens uit het bericht gebruiken in documenten.

Dit nieuwe koppelvlak is beschikbaar gekomen in versie 17. In versie 18 zijn de wijzigingen betreft de invoering van de kostendelersnorm en uniforme verplichtingen doorgevoerd.



Er wordt gebruik gemaakt van de volgende berichtversie:

• WerkpleinDienstverleningEWwb-v0201-b02

• WerkpleinDienstverleningEWwb-v0202-b03 Tevens is er een wsdl beschikbaar:

• WerkpleinDienstverleningEWwb.wsdl De berichtschema’s (.xsd) die gebruikt worden om de binnenkomende berichten te valideren zijn in de bijlagen van dit document te vinden. Ook zijn hier voorbeeld XML-berichten te vinden.



Gebruikte standaard SuwiML





http://www.werk.nl/

47

Methode van aanroep

WerkpleinDienstverleningEWwb-v0203 Voor het bericht WerkpleinDienstverleningEWwb-v0203 geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/WerkpleinDienstverleningEWwb-v0203/

SOAP action ”” Contenttype text/xml METHOD POST

Licentie Dit koppelvlak kunt u gebruiken met de licentie: Koppeling ‘Eenmalige Registratie op de Werkpleinen’.

48

19. Electronisch VerzoekOmInformatie (e-VOI)


Het elektronisch VerzoekOmInformatie (e-VOI) van Stichting Netwerk Gerechtsdeurwaarders (SNG) is gebaseerd op een vraag- en antwoordbericht met synchrone afhandeling. Binnen de Berichten Module is hiervoor een nieuw koppelvlak ontwikkeld: SNG Stichting Netwerk Gerechtsdeurwaarders.

De functionaliteit is vergelijkbaar met GSDDossierPersoon ten behoeve van het leveren van gegevens voor Digitaal KlantDossier. Het koppelvlak kan een binnenkomend vraagbericht (InkomstenVraag_310) ontvangen, herkennen, valideren en afhandelen. Met afhandelen wordt bedoeld het verzamelen van de juiste gegevens uit Suites voor het Sociaal Domein. Deze gegevens worden in het door SNG gedefinieerde formaat in het uitgaande antwoordbericht (InkomstenAntwoord_310) geplaatst en tot slot wordt het bericht synchroon verstuurd.Er is sprake van een XML-vraagbericht en een te versturen XML-antwoordbericht:

• InkomstenVraag_310_X04V02

• InkomstenAntwoord_310_X04V02

Het gehele berichtenverkeer wordt gelogd, zodat e.e.a. nagegaan kan worden m.b.t. aantallen en op welke BSN’s de bevraging betrekking heeft gehad. Deze logging kan worden ingezien en de inhoud van het bericht kan in de vorm van een rapportage getoond worden (.HTML-pagina).



Er wordt gebruik gemaakt van de volgende schema’s om het binnenkomende vraagbericht en het bijbehorende antwoordbericht te valideren.

• InkomstenVraag_310_X04V02

• InkomstenAntwoord_310_X04V02 Tevens is er vanaf versie19.4 een .wsdl beschikbaar:

• InkomstenService_310_X04V02.wsdl Deze schema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten).

Versturen bericht Ja (n.a.v. het vragen om gegevens, betreft een synchrone beantwoording)

Ontvangen bericht Ja (n.a.v. het bevraagd worden, betreft een synchrone beantwoording)

Gebruikte standaard XML standaard van SNG.


Ja, er wordt gebruik gemaakt van dubbelzijdige transportbeveiliging (d.m.v. PKI-certificaat). Hiervoor is de inzet van de MessageHandler noodzakelijk. Gemeente moet bij SNG aangeven op welke URL (die van de MessageHandler) zij benaderd kunnen worden. Indien van toepassing moet de systeembeheerder van de gemeente in de firewall configureren dat een van het IP adres van SNG afkomstig bericht, doorgelaten moet worden. Overigens kan de MessageHandler o.b.v. certificaat vaststellen of het om een

49

betrouwbare afzender gaat. In de MessageHandler moet worden aangegeven dat het bericht van SNG naar Suites voor het Sociaal Domein (Berichtenmodule) gezonden moet worden. T.b.v. het gebruik van de MessageHandler is documentatie m.b.t. de installatie en configuratie beschikbaar alsmede over de installatie van certificaten.

Methode van aanroep



SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/InkomstenVraag_310_X04V02/ SOAP action SOAPAction="InkomstenVraag_310_X04V02" Contenttype text/xml METHOD POST

Licentie Dit koppelvlak kunt u gebruiken met de licentie: Koppelvlak e-VOI

50

20. Koppelvlak aansluiting CORV


Dit koppelvlak biedt de mogelijkheid om berichten uit te wisselen met CORV (Collectieve Opdracht en Routeer Voorziening) in het kader van de uitvoering van de Jeugdwet. CORV is de voorziening die ervoor zorgt dat gemeentelijke instellingen berichten met het justitieel netwerk kunnen uitwisselen. Gemeenten kunnen berichten sturen naar de CORV, namelijk het VTO ‘Verzoek tot onderzoek’ bericht. Hiernaast kunnen er berichten ontvangen worden, namelijk notificaties op VTO- berichten (intake en uitkomst), notificatie ambtshalve onderzoek (uitvoering en uitkomst) en zorgmeldingen (niet zijnde van politie).

De functionaliteiten die Suites voor het Sociaal Domein hierbij biedt zijn:

- Aan de hand van binnenkomende berichten kan er automatisch een werkproces/signaal worden opgeboekt.

- VTO berichten worden vanuit de Suite4Jeugdwet automatisch verzonden wanneer een gebruiker dit bericht aanmaakt. Gegevens uit het VTO dossier worden in dit bericht opgenomen. Ook kan er een rapportage (document) worden meegezonden. A.d.h.v. notificatie-berichten ontvangen van de Raad van de Kinderbescherming op verstuurde VTO-berichten wordt de status in het VTO-dossier bijgewerkt.

Om het berichtenverkeer mogelijk te maken zijn een aantal componenten nodig:

De generieke adapter/berichtenmodule van Suites voor het Sociaal Domein. Bij de meeste gemeenten die Suites voor het Sociaal Domein inzetten is deze component al operationeel omdat deze ook al wordt gebruikt voor het berichtenverkeer in het kader van het DKD

- Een digikoppeling oplossing (bijv. Centric Saas-oplossing: Conductor en digikoppeling)



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende- en uitgaande berichten te valideren. CORV-berichten versie 09.04:

• zkn0310_msg_corv.xsd

• zkn0310_ontvangAsynchroon_corv.wsdl CORV-berichten versie 1.0:

• jz0100_msg_stuf_jzberichten_resolved.xsd

• jz01010_ontvangAsynchroon_jzberichten.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte standaard Standaard ontwikkeld door KING: “StUF-koppelvlak Jeugdzorg (CORV) ”. Dit wordt nog doorontwikkeld. KING is verantwoordelijk voor specificaties. De standaard is gebaseerd op StUF zaken.


Voor dit koppelvlak wordt er gebruik gemaakt van de Digikoppeling. Met Digikoppeling kunnen overheidsorganisaties gemakkelijk, eenduidig, veilig en betrouwbaar onderling gegevens uitwisselen. De Digikoppeling bestaat uit, door het College Standaardisatie vastgestelde, koppelvlakstandaarden en bevat logistieke afspraken voor digitale berichtenuitwisseling tussen

51

overheidsorganisaties.

Methode van aanroep

SOAP endpoint CORV-berichten versie 09.04: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/notificatieDi01-v0310/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/zorgmeldingDi01-v0310/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/Bv01Bericht-v0301/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/Fo01Bericht-v0301/ CORV-berichten versie 1.0: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/notificatieDi01-v0100/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/notificatiejrDi01-v0100/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/Bv01Bericht-v0301/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/Fo01Bericht-v0301/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente>/run/Fo03Bericht-v0301/ SOAP action CORV-berichten versie 09.04: "SOAPAction" value ="http://www.egem.nl/StUF/sector/zkn/0310/notificatieDi01" ="http://www.egem.nl/StUF/sector/zkn/0310/zorgmeldingDi01" ="http://www.egem.nl/StUF/StUF0301/Bv01" ="http://www.egem.nl/StUF/StUF0301/Fo01" CORV-berichten versie 1.0: "SOAPAction" value ="www.stufstandaarden.nl/koppelvlak/jz0100/notificatieDi01" ="www.stufstandaarden.nl/koppelvlak/jz0100/notificatiejrDi01" ="http://www.egem.nl/StUF/StUF0301/Fo03" ="http://www.egem.nl/StUF/StUF0301/Bv01" ="http://www.egem.nl/StUF/StUF0301/Fo01" Contenttype text/xml METHOD POST

Licentie Dit koppelvlak valt onder de licentie van Key2Jeugdwet.

52

21. Berichtenverkeer GGK


Binnen het berichtenverkeer met het Gemeentelijk Gegevens Knooppunt (GGK) worden berichten in het kader van iWmo en iJw uitgewisseld. Met deze berichten worden gegevens over cliënten en de hulp die zij behoeven uitgewisseld tussen gemeenten en zorgaanbieders. De inhoudelijke gegevens bevinden zich in een zogenaamde flat file (bijv. WMO301-WMO302-JW301-JW302), die in de vorm van een base64-bestand als payload is opgenomen in een StUF-XML-envelop. Bij de webservice-variant wordt de StUF-XML-envelop met payload verstuurd van en naar het GGK. Het GGK wordt beheerd door het Inlichtingenbureau (IB). De communicatie tussen gemeenten en GGK vindt beveiligd plaats d.m.v. Digikoppeling.

Op 12 juni 2017 wordt de nieuwe versie 2.1 van iWmo- en iJw berichten in gebruik genomen. Dit gaat in de vorm van een zogenaamde ‘big bang’. Vanaf dat moment zijn deze berichten geen ascii-bestanden meer maar volledige XML-berichten. Bij deze berichten wordt gelijktijdig een nieuwe versie 2.1 van de StUF-XML-envelop in gebruik genomen (v2.1.04).



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende- en uitgaande berichten te valideren. StUF-XML-envelop versie 2.1.04:

• ggk0210_msg_ggkberichten.xsd

• ggk0210_stuf0301_msg_ggkberichten.xsd

• ggk0210_OntvangAsynchroon_ggkberichten.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte standaard

Digikoppeling standaard


Voor dit koppelvlak wordt er gebruik gemaakt van de Digikoppeling. Met Digikoppeling kunnen overheidsorganisaties gemakkelijk, eenduidig, veilig en betrouwbaar onderling gegevens uitwisselen. De Digikoppeling bestaat uit, door het College Standaardisatie vastgestelde, koppelvlakstandaarden en bevat logistieke afspraken voor digitale berichtenuitwisseling tussen overheidsorganisaties.

Methode van aanroep

SOAP endpoint StUF-XML-envelop versie 2.1: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ envelopHeenbericht-ggk_Di01-v0210/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ envelopRetourbericht-ggk_Du01-v0210/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Fo01Bericht-v0301/ SOAP action StUF-XML-envelop versie 2.1.04: "SOAPAction" value =" http://www.stufstandaarden.nl/StUF/koppelvlak/ggk0210/

53

ggk_Di01" =" http:// www.stufstandaarden.nl/StUF/koppelvlak/ggk0210/ ggk_Du01" ="http://www.egem.nl/StUF/StUF0301/Fo01" Contenttype text/xml METHOD POST

Licentie Dit koppelvlak valt onder de licentie van Key2Wmo en Key2Jeugdwet.

54

22. Wmo advies- en Jeugdwet advies bericht


Met het in gebruik nemen van het GGK is er begonnen met een ketenberichtencyclus tussen gemeenten en zorgaanbieders voor de Wmo. Daarnaast is ook behoefte aan een bericht wat men vooral binnengemeentelijk wil gaan gebruiken (voorheen WMO311 en JW311). Dit is een inkomend bericht wat bestaat uit de gegevens die allemaal ook voorkomen in de 301 met uitzondering van de toewijzing. Dit bericht gaat vooral gebruikt worden voor het doorgeven van informatie van een wijkteam naar de backoffice. De naamgeving van het bericht is Wmo-advies bericht. Voor de webservice-variant wordt gebruik gemaakt van de StUF-XML-enveloppe zoals die gebruikt worden binnen het berichtenverkeer met GGK t.b.v. iWmo- en iJw-berichten. Het Wmo- en Jeugdwet advies bericht (flat file) wordt in dit geval in de vorm van een base64-bestand als payload opgenomen in de StUF-XML-envelop.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende- en uitgaande berichten te valideren. StUF-XML-envelop versie 1.0:

• ggs0301_msg.xsd

• ggs0301_msg_stuf.xsd

• ggs0301_OntvangAsynchroon.wsdl StUF-XML-envelop versie 2.0:

• ggk0310_msg.xsd

• ggk0310_msg_stuf.xsd

• ggk0310_OntvangAsynchroon.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte standaard

StUF





Methode van aanroep

SOAP endpoint StUF-XML-envelop versie 1.0: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ ggs_Di01-v0301/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ ggs_Du01-v0301/ StUF-XML-envelop versie 2.0: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ envelopHeenbericht-ggk_Di01-v0310/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente

55

>/run/ envelopRetourbericht-ggk_Du01-v0310/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Fo01Bericht-v0301/ SOAP action StUF-XML-envelop versie 1.0: "SOAPAction" value = ="http://www.egem.nl/StUF/sector/wbg/0310/ggs_Di01" ="http://www.egem.nl/StUF/sector/wbg/0310/ggs_Du01" StUF-XML-envelop versie 2.0: "SOAPAction" value =" http://www.egem.nl/StUF/sector/ggk/0310/envelopHeenbericht-ggk_Di01" =" http://www.egem.nl/StUF/sector/ggk/0310/envelopRetourbericht-ggk_Du01" ="http://www.egem.nl/StUF/StUF0301/Fo01" Contenttype text/xml METHOD POST

Licentie Dit koppelvlak valt onder de licentie van koppelvlak Wmo advies resp. koppelvlak Jeugdwet advies.

56

23. Inlezen WMO301- en JW301-bericht

A. Functionele beschrijving Regionale organisaties spelen een steeds belangrijkere rol bij de inkoop en administratie van jeugdzorg- en Wmo-producten. Gemeenten krijgen in het geval van alleen een regionale inkoop de administratie voor eigen rekening. Als de administratie ook wordt overgenomen door de regionale organisatie, dan blijft de gemeente wel zelf verantwoordelijk voor de toegang en rechtmatigheidstoets. Dit betekent dat de gemeente zelf vastlegt of een klant zorg krijgt en welke zorg dat is, maar dat de toewijzing naar het GGk en de verdere afhandeling van berichten (start zorg, stop zorg en declaratie/facturatie) door de regionale organisatie wordt gedaan.

Binnen deze werkwijze moeten de gegevens van het lokale systeem (gemeente) in het regionale systeem (regionale organisatie) terechtkomen. Hier wordt door landelijke standaarden op dit moment niet in voorzien.

Figuur 1

Daarom is besloten om het mogelijk te maken om een toewijzingsbericht (JW301 en WMO301) in te lezen en te verwerken. De terugkoppeling van een zorgaanbieder of het bericht goed is aangekomen of fouten bevat (retourbericht) aan de lokale gemeente (stippellijn in Figuur 2) is géén onderdeel van deze versie. Indien het bericht in goede orde is ontvangen, wordt er een Bv03-bericht retour gezonden. Indien het bericht niet in goede orde is ontvangen, wordt er een Fo01-bericht retour gezonden.

Figuur 2



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende- en uitgaande berichten te valideren. StUF-XML-envelop versie 2.1:

• ggk0210_msg_ggkberichten.xsd

• ggk0210_stuf0301_msg_ggkberichten.xsd

• ggk0210_OntvangAsynchroon_ggkberichten.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte StUF

57

standaard





Methode van aanroep

SOAP endpoint StUF-XML-envelop versie 2.1: http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ envelopHeenbericht-ggk_Di01-v0210/ Of http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/Fo01Bericht-v0301/ SOAP action StUF-XML-envelop versie 2.1: "SOAPAction" value =" http://www.stufstandaarden.nl/StUF/koppelvlak/ggk0210/ ggk_Di01" ="http://www.egem.nl/StUF/StUF0301/Fo01" Contenttype text/xml METHOD POST

Licentie Dit koppelvlak valt onder de licentie van Key2Wmo en/of Key2Jeugdwet.

58

24. Koppelvlak Integraal klantbeeld


Veel gemeenten zijn in het kader van de 3 decentralisaties wijkgericht gaan werken en werken nu volgens het principe 1 dossier, 1 plan en 1 regisseur. Hierbij wordt gebruik gemaakt van een regiesysteem. Bij gemeenten bestaat de behoefte om in het regiesysteem inzicht te krijgen in de gegevens die van burgers in de backoffice systemen zijn vastgelegd. Om dit te realiseren is een vorm van geautomatiseerde gegevensuitwisseling nodig.

Met o.a. PinkRoccade Local Government (PRLG) hebben wij de te gebruiken standaard en inhoud van de uit te wisselen gegevens afgestemd en een nieuw koppelvlak ontwikkeld om gegevens uit de backoffice, in dit verband de Suites voor het Sociaal Domein, te ontsluiten. De afspraak geldt dat gebruik wordt gemaakt van de open standaard StUF.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende vraagbericht en het bijbehorende antwoordbericht te valideren.

• wiz0310_ent_vraagAntwoord.xsd

• wiz0310_msg_stuf_vraagAntwoord.xsd

• wiz0310_msg_vraagAntwoord.xsd

• wiz0310_bg0310_ent.xsd

• wiz0310_ent_basis.xsd

• wiz0310_simpleTypes.xsd

• wiz0310_stuf_simpleTypes.xsd

• wiz0310_beantwoordVraag.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte standaard

Conform StUF-XML





Methode van aanroep

SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/ikbLv-v0310/ SOAP action "SOAPAction" value = "http://www.egem.nl/StUF/sector/wiz/0310/ikbLv01 " Contenttype text/xml

59

METHOD POST

Licentie Dit koppelvlak valt onder de licentie van koppelvlak Integraal klantbeeld.

60

25. Koppelvlak MijnOverheid Berichtenbox


MijnOverheid is de persoonlijke website van burgers voor overheidszaken. Alle personen met een BSN kunnen Berichtenbox MijnOverheid actieveren. Binnen MijnOverheid kunnen burgers bijv. zien welke gegevens verschillende aangesloten organisaties over hen hebben geregistreerd. Burgers kunnen er voor kiezen om binnen MijnOverheid ook post van de overheid digitaal te ontvangen via de Berichtenbox. Een burger kan dit zelf activeren binnen het eigen MijnOverheid-account.

Voor de te versturen bulkdocumenten jaaropgave, uitkeringsspecificatie en debiteuren-aanmaningen is het mogelijk gemaakt om deze digitaal te delen met de burger via MijnOverheid Berichtenbox. Per aan te maken document wordt van het betreffende BSN gecontroleerd of deze abonnee is. Indien dit het geval is, zal het te verzenden document digitaal verstuurd worden naar de Berichtenbox. Deze berichten worden uitgewisseld via een Digikoppeling-adapter. Het is nu ook mogelijk gemaakt om stuksdocumenten aangemaakt vanuit de Suites voor het Sociaal Domein digitaal te delen met de burger via MijnOverheid Berichtenbox.



Er wordt o.a. gebruik gemaakt van de volgende schema’s om het uitgaande berichten te valideren.

• Abonnee.wsdl

• Abonnee.xsd

• Abonnee_1.wsdl

• Abonnee_1.xsd

• Abonnee_1_2.wsdl

• BerichtVerwerk.wsdl

• BerichtVerwerk.xsd

• BerichtVerwerk_1.wsdl

• BerichtVerwerk_1.xsd

• BerichtVerwerk_1_2.wsdl

• BerichtVerwerk_1_2.xsd Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.


Ontvangen bericht Nee

Gebruikte standaard

Logius-standaard: Berichtenbox





Methode van aanroep

Niet van toepassing.

Licentie Dit koppelvlak valt onder de licentie van koppelvlak MijnOverheid Berichtenbox.

61

26. Koppelvlak Regie- en Zaakservices


Gemeenten hebben de komende jaren te maken met een grote uitdaging in het sociaal domein. Enkele omvangrijke taken en verantwoordelijkheden op het gebied van zorg, jeugd en participatie zijn vanuit het rijk (en provincies) overgeheveld naar gemeenten. Centraal in deze uitdaging staat het principe van ‘één gezin, één plan, één regisseur’. Gemeenten moeten regie voeren over een heel netwerk aan hulpverleners dat betrokken is bij een gezin en dat met een hogere kwaliteit en tegen mindere kosten dan voorheen.

Om de nieuwe taken goed te kunnen uitvoeren is een goede informatievoorziening van gemeenten én ketenpartners van groot belang. Zaakgericht werken biedt kansen bij het ondersteunen van de regiefunctie. Derhalve zijn de bijbehorende standaarden (ZTC, RGBZ, StUF-ZKN) binnen dit nieuwe domein verder uitgewerkt en heeft dit geleid tot een nieuwe koppelvlakspecificatie.

Deze koppelvlakspecificatie geeft aan hoe regie-applicaties voor het Sociaal Domein en taakspecifieke backoffice applicaties (SvhSD) gegevens uit kunnen wisselen in relatie tot zaaksysteem, zakenmagazijn en documentbeheersysteem.

Met deze koppeling wordt het zaakgericht werken met zaken en documenten ondersteund conform landelijk standaarden. Een groot gedeelte van de berichten die uitgewisseld worden, komen uit de standaard Zaak-document-services. Daarnaast zijn er specifieke berichten t.b.v. Regie-zaak-services. Door gebruik te maken van standaarden kan worden aangesloten op ieder systeem dat dezelfde standaardfuncties ondersteunt. De beschreven services van de Regie- en Zaakservices zijn gebaseerd op webservices en maken gebruik van bestaande (open) standaarden. Voor meer informatie wordt verwezen naar: http://gemmaonline.nl/index.php/Regie_en_zaakservices.



Naast schema’s van Zaak-documenten-services wordt o.a. ook gebruik gemaakt van de volgende schema’s om de berichten te valideren.

• rzs0310_zkn0310_ent.xsd

• rzs0310_zkn0310_simpleTypes.xsd

• rzs0310_msg_rzsberichten.xsd

• rzs0310_msg_stuf_rzsberichten.xsd

• rzs0310_msg_totaal.xsd

• rzs0310_ontvangAsynchroon_rzsberichten.wsdl Deze berichtschema’s zijn vrij beschikbaar (inclusief voorbeeld XML-berichten) en zijn opgenomen in de bijlage van dit document.



Gebruikte standaard

Standaard ontwikkeld door KING: “Standaard services voor het uitwisselen van informatie tussen Regiesystemen in het sociaal domein, zaaksystemen, zakenmagazijnen, documentbeheer- systemen en taakspecifieke backoffice-applicaties” Dit wordt nog doorontwikkeld. KING is verantwoordelijk voor specificaties. De standaard is gebaseerd op StUF zaken.




http://gemmaonline.nl/index.php/Regie_en_zaakservices

62


Methode van aanroep

Vanuit Suites voor het Sociaal Domein worden alleen Zaakservices en Zaakdocumentservices aangeroepen. Daarnaast worden er berichten ontvangen die afkomstig zijn van de Regie-Zaak-servicelaag, Abonnementenbeheer of rechtstreeks van het Regiesysteem (geldt alleen voor overdragenZaak-bericht). Specificaties voor deze services worden opgesteld en beheerd door KING. De services zijn: - StUF Zaakservices - StUF Zaakdocumentservices - StUF Regieservices De CMIS services voor synchroniseren zaken en documenten zijn in het midoffice gepositioneerd. Deze services zijn: - CMIS Document services - CMIS Integratie services De applicatiebeheerder van Suites voor het Sociaal Domein dient met de midoffice leverancier af te stemmen wat de url voor de verschillende services zijn. Deze zijn namelijk variabel en in te stellen via Parameters Berichtenverkeer in Suites voor het Sociaal Domein. SOAP action De SOAP Action in het bericht dient te eindigen met de naam van de aan te roepen service (gedefinieerd door KING). Als voorbeeld: "SOAPAction" value ="http://www.egem.nl/StUF/sector/zkn/0310/<naam_service>", bijvoorbeeld: http://www.egem.nl/StUF/sector/zkn/0310/CreeerZaak.

Licentie Dit koppelvlak valt onder de licentie van koppelvlak Regie- en Zaakservices.

63

27. Koppelvlak Gezondverzekerd

A. Functionele beschrijving Iedereen die in Nederland woont, is verplicht een ziektekostenverzekering af te sluiten. Speciaal voor mensen met een laag inkomen hebben gemeenten een collectieve zorgverzekering voor minima afgesloten, een gemeentepolis.

Om zich aan te melden voor de gemeentepolis bieden steeds meer gemeenten de mogelijkheid dit via de website van Gezondverzekerd te doen. Op de website van Gezondverzekerd kan een klant alle relevante informatie vinden over de Collectieve Zorgverzekering voor Minima (CZM) van de gemeente. Op detailniveau zijn de gemeentelijke pakketten te vergelijken met alle mogelijke zorgverzekeringen in Nederland. Een klant kan er uiteindelijk voor kiezen om een aanvraag in te dienen.

Deze aanvraag wordt doorgestuurd naar de betreffende zorgverzekeraar en gemeente. Het doorsturen van de aanvraag naar de gemeente vindt momenteel altijd plaats via een mail met een PDF als bijlage, maar in deze versie is een koppelvlak gerealiseerd, dat de XML-berichten van Gezondverzekerd kan ontvangen, valideren en verwerken. De ontvangst van berichten worden gelogd. De basis voor dit bericht is gebaseerd op het koppelvlak webintake met aanvullende gegevens. Hierin zit o.a. het PDF bestand in opgesloten. Op basis van dit bericht wordt momenteel een werkproces aangemaakt waarmee de verdere afhandeling van het bericht, de verwerking van de informatie m.b.t. Gezondverzekerd, kan worden gedaan.

Er wordt gebruik gemaakt van de mogelijkheden zoals die binnen het Webintake-bericht aanwezig zijn. Dit betreft de mogelijkheid om:

- Een werkproces en/of signaal aan te maken - Cliënt- en partnergegevens over te nemen - Het opnemen van een pdf-document in het XML-bericht

Voor deze koppeling is een nieuw bericht gerealiseerd binnen de module Koppelvlak Aanvraag (KVA). Aanvullend wordt ondersteuning gegeven aan:

- Het opslaan van het pdf-document in een database-veld - Het tonen van het pdf-document aan een eindgebruiker binnen het werkproces

Dit bericht voorziet al in de aanlevering van aanvullende zorgverzekeringsgegevens. Dit is mogelijk gemaakt door deze gegevens als optionele elementen op te nemen in het bericht.

Tenslotte is de volgende stap gerealiseerd om op basis van relevante informatie in het Gezondverzekerd XML-bericht (semi-)automatisch het pakket (product) bij de cliënt te kunnen aanmaken en eventueel als nevenactie een inhoudings- of doorbetalingscomponent. In hoeverre dit automatisch moet plaats vinden of dat in eerste instantie alleen een werkproces wordt aangemaakt wordt via een parameter gestuurd.


Technische

onderdelen

Er wordt o.a. gebruik gemaakt van de volgende schema’s om het binnenkomende bericht te valideren: Voor berichtversie v0100-b01:

• BodyAction.xsd;

• BodyReaction.xsd;


• EnvelopeReaction.xsd

• GWSMLHeader.xsd

• Include-gsml.xsd

• GezondVerzekerd.wsdl De in de genoemde XSD’s benodigde subschema’s worden uit

64

onderstaande mappen gehaald:




Gebruikte

standaard

GWSML




De volgende elementen maken geen deel uit van SGR, maar zijn

wel noodzakelijk t.b.v. het koppelvlak en achterliggende

functionaliteit in Suites voor het Sociaal Domein:

• Uzovicode;

• Pakketcode;

• Collectiviteitsnummer;

• Ingangsdatum;

• Aanvullingstekst;

• Zaakidentificatie; Ook bevat GWSML gegevens uit STUFML.

Informatie-

beveiliging




Methode van aanroep

GezondVerzekerd v0100-b01 Voor het bericht GezondVerzekerd v0100 geldt dat er gebruik wordt gemaakt van webservice adressering. Dit betekent dat de door de berichtenmodule uit te voeren actie uit de header van het bericht gehaald wordt i.p.v. uit de SOAPAction in de http header. De partij die het betreffende bericht naar de berichtenmodule van Suites voor het Sociaal Domein stuurt, zal er voor moeten zorgen dat de SOAPAction in de http header niet gevuld wordt / de waarde “” (leeg) krijgt. In <SOAP-ENV:Header> is in het veld <wsa:Action> de naam van de uit te voeren dienst opgenomen. SOAP endpoint http://<server>:<poort>/berichtenverkeercwi/<omgeving>/<gemeente >/run/GezondVerzekerd-v0100/

SOAP action ""

65

Voor beide berichtversies: Contenttype text/xml METHOD - POST

Licentie Dit koppelvlak valt onder de licentie van Koppelvlak Gezondverzekerd.

e-Dienstverlening: Beschrijving koppelvlakken Suites voor ...

Documents

Transcript of e-Dienstverlening: Beschrijving koppelvlakken Suites voor ...