Handleiding Testvoorziening istandaarden

Transcriptie

1 Handleiding Testvoorziening istandaarden 21 november 2017 Versiebeheer Versie Datum Toelichting en status november 2017 Vulberichten iwmo 2.2 en ijw 2.2 toegevoegd september 2017 Implementatie iwlz toegevoegd juli 2017 Implementatie ipgb toegevoegd mei 2017 Definitief

2 Inhoud Handleiding Testvoorziening istandaarden 1 21 november Inleiding 5 2 Toegang tot de Testvoorziening istandaarden (TiS) istandaarden-account Bedoeling en ontwikkeling Huidige ondersteunde berichtstandaard WSDL Endpoint 6 3 Gebruik en werking Testvoorziening istandaarden (TiS) De rol van TiS Werking: volledige doorloop van processen Werking: toestand 7 4 SOAP-envelop WSDL-bestand met voorbeeldrequests downloaden WS-security-header 8 5 Bericht aanbieden:<offerfile*> SOAP-request <OfferFileRequest> SOAP-response <OfferFileResponse> SOAP Fault: foutmeldingen Berichtcontroles Alle validaties binnen het bericht Scenario-specifieke controles 11 6 Bericht ophalen: <RequestFile*> SOAP-request: <RequestFileRequest> RequestFileResponse 12 7 Wet maatschappelijke ondersteuning en Jeugdwet: iwmo en ijw 14 Handleiding Testvoorziening istandaarden 2/24

3 7.1 Voor wie? Vulbericht StUF-envelop Beperkingen Testcases Voor de zorgaanbieder: Wmo en Jw Proces In schema, met TiS-toestand <TestCase> Vulbericht Voor de gemeente; Wmo en Jw Proces In schema, met TiS-toestand <TestCase> Vulbericht Berichtoverstijgende controles: Wmo en Jeugdwet 17 8 Persoonsgebonden budget: ipgb Voor wie? Aansluiting casuïstiek Vulbericht Beperkingen Testcases Voor de gemeente of het zorgkantoor In schema, met TiS-toestand <TestCase> Berichtoverstijgende regels 19 9 Wet langdurige zorg: iwlz Voor wie? Aansluiting casuïstiek Samenstelling vulbericht Beperkingen Testcases Voor de zorgaanbieder: zonder mutatiebericht (AW39) 21 Handleiding Testvoorziening istandaarden 3/24

4 9.6.1 Proces In schema, met TiS-toestand <TestCase> Vulbericht Voor de zorgaanbieder: met mutatiebericht (AW39) Proces In schema, met TiS-toestand De interactie met TiS ziet er zo uit: <TestCase> Vulbericht Voor het zorgkantoor: zonder mutatiebericht Proces In schema, met TiS-toestand <TestCase> Vulbericht Voor het zorgkantoor: met mutatiebericht Proces In schema, met TiS-toestand <TestCase> Vulbericht 24 Handleiding Testvoorziening istandaarden 4/24

5 1 Inleiding De Testvoorziening istandaarden (TiS) is een webservice van Zorginstituut Nederland voor leveranciers van iwlz-, iwmo-, ijw en ipgb-software. De softwareleveranciers kunnen hun producten testen in de rol van elke partij die deelneemt aan het istandaarden-berichtenverkeer, en zo nodig verbeteren. TiS ondersteunt softwareleveranciers bij de bouw van hun softwareproducten, waarmee hun klanten gemeenten, zorgaanbieders snel en soepel digitale Wmo-, Jw-, iwlz- en ipgb-berichten kunnen uitwisselen via istandaarden. TiS biedt een online-simulatieomgeving waar softwareleveranciers hun producten kunnen testen in de rol van elke partij die deelneemt aan het istandaarden-berichtenverkeer. TiS werkt met een geautomatiseerd testproces volgens vastgestelde en ingebouwde scenario s. Daarmee worden verzendende en ontvangende partijen gesimuleerd. TiS is ontwikkeld samen met softwareleveranciers die actief zijn in de verschillende istandaarden-domeinen. De service wordt voortdurend voorzien van nieuwe testscenario s. Zo wordt TiS een volwaardig product dat softwareleveranciers structureel ondersteunt bij de bouw van hun software. De opzet van deze handleiding is gewijzigd ten opzichte van de vorige versie. De aanleiding is de toevoeging van het gebruik van TiS voor iwlz en ipgb. De hoofdstukken 1 tot en met 6 gaan over het het gebruik van TiS, de nieuwe hoofdstukken 7, 8 en 9 gaan in op de toepassing van TiS voor een specifieke berichtstandaard, respectievelijk iwmo / ijw, ipgb en iwlz. Meer informatie Hebt u vragen of opmerkingen over de Handleiding Testvoorziening istandaarden? Neemt u dan contact op met: Zorginstituut Nederland Team istandaarden (020) info@istandaarden.nl Bezoekadres Eekholt XH Diemen Postadres Postbus AH Diemen Handleiding Testvoorziening istandaarden 5/24

6 2 Toegang tot de Testvoorziening istandaarden (TiS) In dit hoofdstuk leest u wat u nodig hebt om toegang te krijgen tot TiS, wat de bedoeling is van de testvoorziening en waar u de WSDL en het endpoint vindt. 2.1 istandaarden-account Om gebruik te kunnen maken van TiS hebt u een geldig istandaarden-account nodig met de juiste gebruikersrechten. Via de module Accountbeheer kunt u een istandaarden-account aanvragen en beheren. Hebt u nog geen account, is het inactief of hebt u nog niet de juiste rechten? Neemt u dan contact op met de Servicedesk istandaarden, op werkdagen bereikbaar van 8.00 tot uur via (020) of info@istandaarden.nl. 2.2 Bedoeling en ontwikkeling TiS is bedoeld voor de ondersteuning bij de implementatie van de nieuwe releases van de istandaarden. Voor nieuwe istandaarden-releases wordt de testvoorziening beschikbaar gesteld. TiS volgt de ontwikkeling van nieuwe releases zodat gebruikers op voorhand kunnen testen. 2.3 Huidige ondersteunde berichtstandaard Hieronder een overzicht van de versie van de ondersteunde berichtstandaard: istandaard Versie Opmerking iwmo 2.1 ijw 2.1 iwmo 2.2 ijw 2.2 iwlz 2.0 ipgb 2.0 Voor Wmo, Jw en Wlz 2.4 WSDL Om TiS te kunnen gebruiken, hebt u de WSDL (Web Service Description Language) nodig. U kunt de WSDL als.zip-bestand downloaden op de TiSpagina op Endpoint Om de webservice te benaderen, hebt u dit endpoint nodig: Handleiding Testvoorziening istandaarden 6/24

7 3 Gebruik en werking Testvoorziening istandaarden (TiS) In dit hoofdstuk leest u meer over de werking en het gebruik van de testvoorziening. 3.1 De rol van TiS De testvoorziening speelt de rol van tegenpartij. Afhankelijk van het domein en het scenario speelt de simulatieomgeving de rol van zorgaanbieder, gemeente, zorgkantoor of SVB. Wilt u bijvoorbeeld simuleren als zorgaanbieder binnen de Wmo, dan speelt TiS de rol van gemeente. En wilt u simuleren voor een gemeente, dan kan TiS de rol van zorgaanbieder vervullen. 3.2 Werking: volledige doorloop van processen U biedt TiS testberichten aan, waarop de testvoorziening een functionele reactie geeft overeenkomstig het bedrijfsproces. TiS versie 1.2 gaat altijd uit van een volledige doorloop van de processen die in het echte berichtenverkeer ook plaatsvinden tussen partijen. In TiS is daarom de volgorde van de berichten altijd hetzelfde tussen start en einde. De rol die de testvoorziening moet spelen, bepaalt wat de volgorde van de berichten moet zijn. Het is met TiS 1.2 nog niet mogelijk een afwijkende berichtvolgorde te doorlopen, bijvoorbeeld een scenario om na een toewijzing [301] direct een factuur [303] te sturen en de start van zorg [305] over te slaan. Een aangeboden bericht kan per bericht één cliënt en/of één product bevatten. Alle berichten die TiS aanmaakt binnen een testsessie krijgt u terug in de response. Naarmate u verder in het proces komt van een testsessie, bevat de response meer berichten. Uiteindelijk staan alle berichten die TiS aanmaakt binnen een testsessie bij elkaar. 3.3 Werking: toestand Nadat u een bericht hebt aangeboden aan TiS wordt het bericht gevalideerd. Als het bericht in orde is komt TiS in een bepaalde toestand ofwel state. Daarbij is het zo dat TiS het bericht verwacht om naar de volgende toestand over te gaan. Voert u hetzelfde bericht nogmaals op of biedt u een bericht van een voorgaande toestand aan, dan leidt dat tot een foutmelding. Uitzondering daarop is het aanbieden van het vulbericht. Dat zet automatisch een nieuwe testsessie in werking. Bij elk testscenario in deze handleiding is een schema opgenomen waarin u ziet wat de volgorde is van de berichten en welke TiS-toestand daarbij hoort. Handleiding Testvoorziening istandaarden 7/24

8 4 SOAP-envelop TiS maakt gebruik van het SOAP-protocol. Aanroepen naar de webservices dienen aan dit protocol te voldoen. Het WSDL-bestand dat bij TiS hoort, beschrijft hoe een juiste aanroep naar de webservice eruitziet. 4.1 WSDL-bestand met voorbeeldrequests downloaden U kunt de WSDL als.zip-bestand downloaden op de TiS-pagina op Voorbeeldrequests maken deel uit van de WSDL, ze zijn beschikbaar als apart.zip-bestand op de TiS-pagina. In dit document zijn de requests ook opgenomen in de tekst, maar om typeof kopieerfouten te voorkomen is het beter om te werken met de voorbeeldrequests. 4.2 WS-security-header Als beveiligingsmethodiek maakt TiS gebruik van WS-security 1.0. De header van de SOAP-envelop dient een WS-security-header te zijn. Een voorbeeldbericht van de WS-security-header: <soapenv:header> <wsse:security xmlns:wsse=" <wsse:usernametoken> <wsse:username>gebruikersnaam</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> De WS-security-header bevat deze parameters: Element Formaat Verplicht Beschrijving Username String Ja De gebruikersnaam van de istandaardengebruiker die de service aanroept. De gebruiker moet geautoriseerd zijn voor het gebruik van TiS. Zie hoofdstuk 1. Password String Ja Het wachtwoord van de istandaardengebruiker. Handleiding Testvoorziening istandaarden 8/24

9 5 Bericht aanbieden:<offerfile*> Biedt u een bericht aan in TiS dan beoordeelt de testvoorziening het bericht. TiS reageert op uw request met een nieuw bericht in de response. Het kan ook zijn dat u een foutmelding krijgt. 5.1 SOAP-request <OfferFileRequest> Het onderdeel OfferFileRequest is bedoeld om een bericht aan te bieden aan de testvoorziening. Hiervoor gelden deze voorwaarden. Een voorbeeld van een request: <soapenv:envelope xmlns:test= xmlns:soapenv= > <soapenv:header> <wsse:security xmlns:wsse= > <wsse:usernametoken> <wsse:username>username</wsse:username> <wsse:password Type= >password</wsse:password> </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <test:offerfilerequest> <test:id> <test:testcase>wmo_tis_als_gemeente-za_als_initiator</test:testcase> <test:id>[sessionuuid]</test:id> </test:id> <test:message> <test:xml> [istandaarden xml-bericht] </test:xml> </test:message> </test:offerfilerequest> </soapenv:body> </soapenv:envelope> De body van het request bevat deze parameters: Element Formaat Verplicht Beschrijving TestCase String Ja Beschrijving van de testcase. De waarde bepaalt welke rol TiS heeft en om welke wet het gaat. De waarde moet exact worden overgenomen uit de testscenario s. Zie hoofdstuk 7, 8 en 9. Handleiding Testvoorziening istandaarden 9/24

10 Id String Nee De unieke sleutel voor een (test-)sessie. De eerste keer (startstate) moet dit element leeg gelaten worden, zodat TiS dit opvat als het starten van een nieuwe sessie en reageert met het terugsturen van een nieuwe Id in de SOAPresponse in het element./offerfileresponse/id/id. In de vervolgrequests ofwel: bij het aanbieden van de vervolgberichten moet dit sessionuuid worden ingevuld om de berichten aan elkaar te kunnen relateren en controleren ten opzichte van elkaar. Xml String Ja Neem hier het bericht op dat ingestuurd moet worden aan TiS. 5.2 SOAP-response <OfferFileResponse> De response geeft terugkoppeling of het ingestuurde bericht behandeld kan worden en in welke toestand TiS komt. Wanneer een startbericht is ingestuurd, maakt de testvoorziening een Id aan en stuurt deze terug. Een voorbeeldresponse: <soapenv:envelope xmlns:test=" xmlns:soapenv=" <soapenv:body> <test:offerfileresponse> <test:id> <test:testcase> Message processed successfully. Status is 'wmo315state'. </test:testcase> <test:id>[sessionuuid]</test:id> </test:id> </test:offerfileresponse> </soapenv:body> </soapenv:envelope> De response bevat deze waarden: Element Formaat Verplicht Beschrijving TestCase String Ja Bevat de omschrijving in welke state TiS voor deze sessie is gezet. Id String Ja Id bevat in de response de sessionuuid. Deze waarde blijft gedurende het hele scenario gelijk totdat opnieuw een vulbericht is aangeboden. 5.3 SOAP Fault: foutmeldingen In sommige situaties ontstaan foutmeldingen, die u geretourneerd krijgt als SOAP Fault. Het ontstaan van de meldingen kan verschillende oorzaken hebben. Meldingen die in het algemeen optreden zijn: Gebruikersinformatie is onjuist gevuld; Gebruiker beschikt niet over de vereiste autorisatie; Het request is onjuist (vaak door typefouten); Niet alle verplichte velden zijn gevuld; Het berichttype wordt niet ondersteund; Handleiding Testvoorziening istandaarden 10/24

11 De verwachte vulling klopt niet; Meer dan één cliënt, adres, beschikking of toewijzing. 5.4 Berichtcontroles TiS voert altijd dezelfde controles uit als de controles waarmee de Validatiemodule werkt: validaties die binnen een bericht uitgevoerd kunnen worden. Daarnaast voert TiS een aantal berichtoverstijgende regels uit, waarbij de voorbeeldberichten van de WS-security-header (paragraaf 4.2), request (5.1) en response (5.2) het uitgangspunt zijn in het scenario Alle validaties binnen het bericht Het bericht wordt gevalideerd op: soort en type bericht; structuur; aanwezigheid van verplichte velden; correcte vulling; technische en berichtspecifieke bedrijfsregels Scenario-specifieke controles Omdat TiS de mogelijkheid heeft om ingezonden berichten binnen dezelfde sessie met elkaar te vergelijken, zijn op beperkte schaal berichtoverstijgende controles mogelijk. In de hoofdstukken waarin per wet de scenario s behandeld worden, staat vermeld om welke berichtoverstijgende controles het gaat. Zie hoofdstuk 7 voor iwmo/ijw, hoofdstuk 8 voor ipgb en hoofdstuk 9 voor iwlz. Handleiding Testvoorziening istandaarden 11/24

12 6 Bericht ophalen: <RequestFile*> Nadat u een bericht hebt aangeboden aan TiS, maakt de testvoorziening op basis van de toestand bestanden aan. Met de bijbehorende request kunt u die ophalen. Let op TiS geeft alle aangemaakte berichten die binnen een sessie worden aangemaakt terug: het aantal berichten in de response groeit dus naarmate u vordert in het scenario. 6.1 SOAP-request: <RequestFileRequest> Het onderdeel RequestFileRequest is bedoeld om de berichten die TiS heeft aangemaakt op te halen. Een voorbeeldbericht van het request: <soapenv:envelope xmlns:test=" xmlns:soapenv=" <soapenv:header> <wsse:security xmlns:wsse=" <wsse:usernametoken> <wsse:username>username</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <test:requestfilerequest> <test:id> <test:testcase>wmo_tis_als_gemeente-za_als_initiator</test:testcase> <test:id>sessionuuid</test:id> </test:id> </test:requestfilerequest> </soapenv:body> </soapenv:envelope> De body van het request bevat deze parameters: Element Formaat Verplicht Beschrijving TestCase String ja Beschrijving van de testcase. Id String ja Vul hier de sessionuuid in van de huidige sessie. 6.2 RequestFileResponse De response geeft het opgevraagde bericht terug. Een voorbeeld: <soapenv:envelope xmlns:tns=" xmlns:soapenv=" <soapenv:body> <tns:requestfileresponse> <tns:id> Handleiding Testvoorziening istandaarden 12/24

13 <tns:testcase>wmo_tis_als_gemeente-za_als_initiator</tns:testcase> <tns:id>sessionuuid</tns:id> </tns:id> <tns:message> <tns:xml xmlns:n1=" <alle door TiS aangemaakte berichten binnen een sessie> </tns:xml> </tns:message> </tns:requestfileresponse> </soapenv:body> </soapenv:envelope> De WS-security header bevat deze parameters: Element Formaat Verplicht Beschrijving TestCase String Ja De huidige TestCase. Id String Ja De huidige sessie. Xml String Ja Bevat alle XML-berichten van de huidige sessie. Handleiding Testvoorziening istandaarden 13/24

14 7 Wet maatschappelijke ondersteuning en Jeugdwet: iwmo en ijw In dit hoofdstuk leest u over de mogelijkheden van TiS voor gebruik bij de implementatie van zowel iwmo als ijw. We bespreken de testscenario s voor beide informatiestandaarden gezamenlijk omdat de berichtstromen nagenoeg overeenkomen. 7.1 Voor wie? TiS kan binnen beide wetten de rol aannemen van (softwareleverancier voor de) gemeente of van (softwareleverancier voor de) zorgaanbieder. TiS heeft dan de rol van respectievelijk zorgaanbieder of gemeente. 7.2 Vulbericht Om het testscenario goed te kunnen uitvoeren, moet vooraf een aantal gegevens bekend zijn om gewenste controles uit te voeren en berichten aan te maken. Het vulbericht is gebaseerd op het 301-bericht en moet geldig zijn volgens de schemadefinitie van de 301: WMO301 voor een Wmo-scenario en JW301 voor een Jeugdwet-scenario. In het commentaarveld van de cliënt kan vervolgens het tarief worden opgenomen. Het mogen alleen cijfers zijn, een tarief van 12,45 vult u bijvoorbeeld als [xpath: /Bericht/Clienten/Client/Commentaar] Dit gegeven is noodzakelijk om de declaratie te betrekken in de berichtstroom. Voor ijw 2.1 of iwmo 2.1 gebruikt u respectievelijk het ijw301- of iwmo301- bericht. Voor ijw 2.2 of iwmo 2.2 gebruikt u een vulbericht. U kunt de vulberichten downloaden op de TiS-pagina op istandaarden.nl. 7.3 StUF-envelop Alle berichten kunnen met of zonder StUF-envelop worden verstuurd. Wanneer het scenario is gestart met een StUF envelop verwacht TiS alle berichten met een StUF-envelop en retourneert zelf ook berichten in een StUF-envelop. 7.4 Beperkingen - Eén cliënt per bericht; - Eén product aan te vragen. 7.5 Testcases Er zijn vier testcases gedefinieerd: 1. Voor de zorgaanbieder: Wmo; 2. Voor de zorgaanbieder: Jw; 3. Voor de gemeente: Wmo; 4. Voor de gemeente: Jw. De berichtstromen zijn voor elke wet voor dezelfde partij vergelijkbaar. We bespreken daarom in de volgende paragrafen twee varianten per gebruiker. Handleiding Testvoorziening istandaarden 14/24

15 7.6 Voor de zorgaanbieder: Wmo en Jw In dit scenario is TiS de gemeente en is de initiator de zorgaanbieder Proces Het scenario begint met een vulbericht. De informatie in het vulbericht dient als input voor berichten die TiS aanmaakt en om berichtoverstijgende validaties uit te voeren wanneer informatie niet in eerder aangeboden berichten zit. Na het insturen van het vulbericht stuurt de softwareleverancier een verzoek om toewijzing. Daarmee is het toewijzingsproces gestart In schema, met TiS-toestand De interactie met TiS ziet er zo uit: Zorgaanbieder TiS Toestand Toelichting 1 Vulbericht.xml - startstate De zorgaanbieder stuurt het vulbericht aan TiS 2 WMO/JW315 - wmo/jw315state Zorgaanbieder stuurt een 315- bericht 3 - WMO/JW316 TiS maakt het retourbericht 4 WMO/JW301 TiS maakt een 301- bericht op basis van het vulbericht en de WMO/JW315 5 WMO/JW302 - wmo/jw302state De zorgaanbieder stuurt het retourbericht 6 WMO/JW305 - wmo/jw305state De zorgaanbieder stuurt een melding aanvang zorg (305- bericht) aan TiS 7 - WMO/JW306 TiS maakt het retourbericht 8 WMO/JW303 - wmo/jw303state De zorgaanbieder stuurt het 303- bericht 9 - WMO/JW304 TiS maakt het retourbericht 10 WMO/JW307 - wmo/jw307state De zorgaanbieder stuurt het 307- bericht 11 - WMO/JW308 TiS maakt het retourbericht <TestCase> Bij het scenario TiS als gemeente zijn deze testcases mogelijk: <TestCase> Toelichting Handleiding Testvoorziening istandaarden 15/24

16 1 Wmo_TiS_Als_Gemeente-ZA_Als_Initiator Berichten gaan over de Wmo: iwmo JW_TiS_Als_Gemeente-ZA_Als_Initiator Berichten gaan over de Jeugdwet: ijw iwmo_v2_2_tis_als_gemeente- ZA_Als_Initiator 4 ijw_v2_2_tis_als_gemeente- ZA_Als_Initiator Berichten gaan over de Wmo: iwmo 2.2 Berichten gaan over de Jeugdwet: ijw Vulbericht Om het testscenario goed te kunnen uitvoeren, moet op voorhand een aantal gegevens bekend zijn om gewenste controles uit te voeren en berichten aan te maken. Het vulbericht is gebaseerd op het 301-bericht en moet geldig zijn volgens de schemadefinitie van de 301: WMO301 voor een Wmo-scenario en JW301 voor een Jeugdwet-scenario. 7.7 Voor de gemeente; Wmo en Jw In dit scenario is TiS de zorgaanbieder en is de initiator de gemeente Proces De gemeente start met het vulbericht. Hierop krijgt de gemeente een 315- bericht aangeboden, waarmee de start van het proces is aangegeven In schema, met TiS-toestand De initiator is de (softwareleverancier van de) gemeente. TiS heeft de rol van zorgaanbieder. Gemeente TiS Toestand Toelichting 1 Vulbericht.xml - startstate De gemeente stuurt het vulbericht aan TiS 2 - WMO/JW315 TiS stuurt een 315- bericht 3 WMO/JW316 - wmo/jw316state Gemeente maakt het retourbericht 4 WMO/JW301 - wmo/jw301state Gemeente maakt een 301-bericht op basis de WMO/JW WMO/JW302 TiS stuurt het retourbericht 6 - WMO/JW305 TiS stuurt een melding aanvang zorg (305bericht) 7 WMO/JW306 - wmo/jw306state Gemeente maakt het retourbericht 8 - WMO/JW303 TiS stuurt het 303- bericht 9 WMO/JW304 - wmo/jw304state Gemeente maakt het retourbericht 10 - WMO/JW307 TiS maakt het 307- bericht 11 WMO/JW308 - wmo/jw308state Gemeente stuurt het Handleiding Testvoorziening istandaarden 16/24

17 retourbericht <TestCase> Bij het scenario TiS als zorgaanbieder zijn deze testcases mogelijk: <TestCase> Toelichting 1 Wmo_TiS_Als_ZA_en_Initiator Berichten gaan over de Wmo: iwmo JW_TiS_Als_ZA_en_Initiator Berichten gaan over de Jeugdwet: ijw iwmo_v2_2_tis_als_za_en_initiator Berichten gaan over de Wmo: iwmo ijw_v2_2_tis_als_za_en_initiator Berichten gaan over de Jeugdwet: ijw Vulbericht Om het testscenario goed te kunnen uitvoeren, moet op voorhand een aantal gegevens bekend zijn om gewenste controles uit te voeren en berichten aan te maken. Het vulbericht is gebaseerd op het 301-bericht en moet geldig zijn volgens de schemadefinitie van de 301: WMO301 voor een Wmo-scenario en JW301 voor een Jeugdwet-scenario. Omdat TiS een 303 moet kunnen aanmaken, kan in het commentaarveld van de cliënt vervolgens het tarief worden opgenomen. Het mogen alleen cijfers zijn, een tarief van 12,45 vult u bijvoorbeeld als [xpath: /Bericht/Clienten/Client/Commentaar] 7.8 Berichtoverstijgende controles: Wmo en Jeugdwet Aanvullend controleert TiS op de berichtoverstijgende regels. De releasenotes bij TiS, die gepubliceerd zijn op de TiS-pagina, geven de actuele status aan. Deze berichtoverstijgende regels zijn nu geïmplementeerd: TR019 Bij een output- of inspanningsgerichte werkwijze moet de melding van de start of de beëindiging van de ondersteuning gerelateerd zijn aan een toewijzing (op basis van de sleutelvelden). TR096 Begindatum moet overeenkomen met de actuele melding start ondersteuning die op of voor Einddatum ligt. TR300 Als de toewijzing volgt op een Verzoek om toewijzing-bericht, moet ReferentieAanbieder worden overgenomen van het betreffende Verzoek om toewijzing-bericht (315). Aanvullend controleert TiS op de berichtoverstijgende regels. Handleiding Testvoorziening istandaarden 17/24

18 8 Persoonsgebonden budget: ipgb In dit hoofdstuk leest u over de mogelijkheden van TiS voor gebruik bij de implementatie van ipgb. 8.1 Voor wie? TiS is binnen de ipgb ingericht voor (de softwareleverancier voor) de gemeente en voor (de softwareleverancier van) het zorgkantoor. TiS heeft altijd de rol van SVB. De ipgb-berichten zijn voor gebruik binnen de Jeugdwet (berichten beginnen met JW) de Wet maatschappelijke ondersteuning (berichten beginnen met WMO) of de Wet langdurige zorg (berichten beginnen met WLZ). 8.2 Aansluiting casuïstiek TiS ondersteunt casus 2 van de casuïstiek zoals beschreven in het Informatiemodel ipgb. De berichtstromen naar de SVB is daarbij voor alle drie de wetten gelijk. 8.3 Vulbericht Het vulbericht is gebaseerd op het 501-bericht. Elke wet heeft dan een eigen vulbericht-soort, namelijk JW501, WMO501 en WLZ501 voor respectievelijk de Jeugdwet, de Wet maatschappelijke ondersteuning en de Wet langdurige zorg. 8.4 Beperkingen - Eén cliënt per bericht; 8.5 Testcases Voor ipgb zijn momenteel drie testcases gedefinieerd. 1. Voor de gemeente: Jeugdwet 2. Voor de gemeente: Wet maatschappelijke ondersteuning 3. Voor het zorgkantoor: Wet langdurige zorg Omdat de berichtstromen voor elke testcase gelijk zijn, worden ze gemeenschappelijk besproken. 8.6 Voor de gemeente of het zorgkantoor Deze casus beschrijft de situatie van een toegekend persoonsgebonden budget (pgb) voor een periode van minder dan een jaar. Tijdens deze periode geeft de budgethouder aan de verstrekker een wijziging door van de gegevens van de vertegenwoordiger In schema, met TiS-toestand De interactie met TiS ziet er als volgt uit. Gemeente/ Zorgkantoor TiS Toestand Toelichting 1 Vulbericht.xml - startstate De gebruiker stuurt het Vulbericht aan TiS 2 i501 i501state- 1 De gebruiker stuurt het 501-bericht 3 - i502 TiS maakt een 502-bericht aan op basis van het ontvangen vulbericht Handleiding Testvoorziening istandaarden 18/24

19 4 i501 - i501state- 2 De gebruiker stuurt het tweede 501-bericht met mutatie 5 - i502 TiS maakt het retourbericht 6 - i507 TiS maakt het 507-bericht 7 i508 i508state De gebruiker stuurt het 508-bericht Op de plek van de i vóór de nummering kan JW, WMO of WLZ staan <TestCase> Als TiS de rol heeft van SVB zijn deze testcases gedefinieerd: TestCase_id Toelichting 1 ipgb_jw_tis_als_svb_gemeente_als_initiator_casus_2 Jeugdwet 2 ipgb_wmo_tis_als_svb_gemeente_als_initiator_casus_2 Wmo 3 ipgb_wlz_tis_als_svb_gemeente_als_initiator_casus_2 Wlz De waarde in de kolom <TestCase> moet letterlijk worden overgenomen in de Soap-calls. De waarde is hoofdlettergevoelig. Let op De gele markering moet functioneel Zorgkantoor zijn, maar u moet Gemeente meegeven. 8.7 Berichtoverstijgende regels Deze volgende berichtoverstijgende regels zijn geïmplementeerd voor ipgb: TR502 Wanneer dezelfde Zorgfunctie meer dan één keer aan dezelfde Budgethouder is toegekend, mogen de geldigheidsduren van deze toekenningen beperkt overlappen. (Beperking) TR562 Iedere mutatie moet gerelateerd zijn aan een eerder verzonden bericht op basis van sleutelvelden. (Beperking) TR574 Ieder Budget krijgt een unieke BudgetIdentificatie per Client per verstrekker. (Beperking) Handleiding Testvoorziening istandaarden 19/24

20 9 Wet langdurige zorg: iwlz In dit hoofdstuk leest u meer over de mogelijkheden van TiS voor gebruik bij de implementatie van iwlz. 9.1 Voor wie? TiS is binnen de iwlz ingericht voor (de softwareleverancier voor) de zorgaanbieder en voor (de softwareleverancier van) het zorgkantoor. Dit betekent dat afhankelijk van de testcase TiS de rol van CIZ, zorgaanbieder of zorgkantoor, of CAK kan vervullen. 9.2 Aansluiting casuïstiek De casuïstiek iwlz sluit in sommige gevallen aan bij de scenario s van TiS. Meer hierover leest u bij de bespreking van de scenario s. 9.3 Samenstelling vulbericht Voor een goede werking van TiS is een afwijkend bericht nodig dat voor meerdere berichten data bevat die TiS nodig heeft in de verschillende stappen binnen een scenario. Dit vulbericht moet gegevens bevatten voor het kunnen aanmaken van: Het indicatiebericht (IO31); Het toewijzingsbericht (AW33); Het wijzigingsbericht (AW39). Er is geen standaard-iwlz-bericht dat direct aan al deze eisen kan voldoen. Daarom is gekozen voor een extra bericht. Om de standaard zo dicht mogelijk te benaderen, is dit bericht een combinatie van een AW33 en deel van een AW39. Zie voor de volledige details de xsd s van iwlz 2.0 die u kunt downloaden onder Meer informatie op de iwlz 2.0-ontwikkelpagina op istandaarden.nl. Voor een invulinstructie bekijkt u de toelichting van de verschillende scenario s. 9.4 Beperkingen Geen relatiegegevens; Eén cliënt per bericht; Geen functies; Als de toegewezen zorg via een AW39 over diverse aanbieders verdeeld moet worden, moeten alle aanbieders bij dezelfde zorgkantoorregio horen. Daardoor levert het aanmaken van berichten door TiS geen foutieve zorgkantoor- of AGB-code op. Bovenregionaal berichtenverkeer is nog niet mogelijk. 9.5 Testcases Voor iwlz zijn momenteel vier testcases gedefinieerd. 1. Voor de zorgaanbieder: zonder mutatiebericht 2. Voor de zorgaanbieder: met mutatiebericht 3. Voor het zorgkantoor: zonder mutatiebericht 4. Voor het zorgkantoor: met mutatiebericht In paragraaf 9.6 tot en met 9.9 gaan we in detail in op elke testcase. Handleiding Testvoorziening istandaarden 20/24

21 9.6 Voor de zorgaanbieder: zonder mutatiebericht (AW39) In dit scenario start de zorgaanbieder direct met het leveren van de toegewezen zorg. Er is geen sprake van het mutatiebericht (AW39). TiS vervult de rol van het zorgkantoor Proces De zorgaanbieder ontvangt van TiS een AW33 en stuurt hier vervolgens een AW35 op terug. De AW33 die TiS verstuurt, is gemaakt op basis van het door de zorgaanbieder aangeleverde vulbericht In schema, met TiS-toestand De interactie met TiS ziet er zo uit: Zorgkantoor TiS Toestand Toelichting 1 Vulbericht.xml - startstate De zorgaanbieder stuurt het vulbericht aan TiS 2 - AW33 TiS maakt een AW33 aan op basis van het ontvangen vulbericht 3 AW34 - aw34state De zorgaanbieder stuurt het retourbericht AW34 aan TiS 4 AW35 - aw35state De zorgaanbieder stuurt een melding aanvang zorg (AW35) aan TiS 5 - AW36 TiS maakt een AW36 aan op basis van de ontvangen AW <TestCase> De benodigde TestCase-id: iwlz_v2_0_tis_als_zk_za_start_direct Let op De testcase-id is hoofdlettergevoelig Vulbericht De zorgaanbieder vult het deel over de AW33 in. Het gaat daarbij minimaal om de verplichte berichtklassen. 9.7 Voor de zorgaanbieder: met mutatiebericht (AW39) In deze scenario s stuurt de zorgaanbieder na ontvangst van de eerste toewijzing (AW33) eerst een wijzigingsverzoek (AW39) in. Redenen kunnen zijn: 1. Wijziging van leveringsvorm; 2. Meerzorg; 3. Verdeling MPT. TiS vervult de rol van zorgkantoor Proces De zorgaanbieder ontvangt van TiS een AW33 en stuurt hier vervolgens een AW39 op terug. Hierop reageert TiS weer met een tweede AW33 waarop de zorgaanbieder een AW35 in stuurt. De berichten die TiS aanmaakt, zijn eerst vervaardigd op basis van het vulbericht, daarna is sprake van een combinatie van het vulbericht en de AW39. Handleiding Testvoorziening istandaarden 21/24

22 9.7.2 In schema, met TiS-toestand De interactie met TiS ziet er zo uit: Zorgkantoor TiS State toelichting 1 Vulbericht.xml - startstate De zorgaanbieder stuurt het vulbericht aan TiS 2 - AW33 TiS maakt een AW33 aan op basis van het vulbericht 3 AW34 - aw34state_1 De zorgaanbieder stuurt het eerste retourbericht AW34 aan TiS 4 AW39 - aw39state Op basis van AW33 stuurt zorgaanbieder een wijzigingsverzoek (AW39) in aan TiS 5 - AW310 TiS maakt het retourbericht AW310 aan 6 - AW33 TiS maakt een tweede toewijzing AW33 aan op basis van het vulbericht en de AW39 7 AW34 - aw34state_2 De zorgaanbieder stuurt het tweede retourbericht AW34 aan TiS 8 AW35 - aw35state De zorgaanbieder stuurt een melding aanvang zorg AW35 aan TiS 9 - AW36 TiS maakt het retourbericht AW36 aan <TestCase> De benodigde TestCase-id: iwlz_v2_0_tis_als_zk_za_start_indirect Let op De testcase-id is hoofdlettergevoelig Vulbericht De zorgaanbieder vult het deel over de AW33 in. Het gaat daarbij minimaal om de verplichte berichtklassen. 9.8 Voor het zorgkantoor: zonder mutatiebericht De zorgaanbieder kan direct de toegewezen zorg leveren en stuurt dus een melding aanvang zorg naar het zorgkantoor. TiS vervult in de verschillende stappen de rol van het CIZ, de zorgaanbieder en het CAK Proces Het zorgkantoor ontvangt een indicatiebesluit waarop het zorgkantoor een zorgtoewijzing maakt. De ontvangende zorgaanbieder start met het leveren van de zorg. Daarna doet het zorgkantoor hier melding van bij het CAK ten behoeve van de eigen bijdrage-berekening. Handleiding Testvoorziening istandaarden 22/24

23 9.8.2 In schema, met TiS-toestand De interactie met TiS ziet er zo uit. Zorgkantoor TiS State toelichting 1 Vulbericht.xml - startstate Het zorgkantoor stuurt vulbericht naar TiS 2 - IO31 TiS maakt op basis van vulbericht een IO31 3 IO32 - io32state Het zorgkantoor stuurt het retourbericht IO32 4 AW33 - aw33state Het zorgkantoor stuurt op basis van IO31 een AW AW34 TiS maakt het retourbericht AW AW35 TiS maakt op basis van AW33 een AW35 7 AW36 - aw36state Het zorgkantoor stuurt het retourbericht AW36 8 CA317 - ca317state Het zorgkantoor stuurt een CA CA318 TiS maakt het retourbericht CA <TestCase> De benodigde TestCase-id: iwlz_v2_0_tis_als_cizzacak_zk_start_direct_1 Let op De testcase-id is hoofdlettergevoelig Vulbericht Het zorgkantoor vult het deel over de AW33 in. Het gaat daarbij minimaal om de verplichte berichtklassen. 9.9 Voor het zorgkantoor: met mutatiebericht Nadat het zorgkantoor een eerste toewijzing heeft verstuurd, geeft de zorgaanbieder aan een gewijzigde zorgtoewijzing te willen ontvangen en stuurt eerst een wijzigingsverzoek (AW39) in. Vervolgens stuurt het zorgkantoor opnieuw een toewijzing met daarin opgenomen de wijzigingen. De reden voor het wijzigingsvoorstel kunnen zijn: 1. Wijziging van leveringsvorm; 2. Meerzorg; 3. Verdeling MPT over meer aanbieders Proces Het zorgkantoor ontvangt een indicatiebesluit vanuit TiS op basis van het aangeboden vulbericht. Hierop maakt het zorgkantoor een zorgtoewijzing. TiS maakt hierop een mutatiebericht aan. Het zorgkantoor maakt een nieuwe AW33 en ontvangt van TiS de betrokken startberichten. Daarna is het proces vergelijkbaar met de situatie zonder mutatiebericht en stuurt het zorgkantoor een startbericht ten behoeve van de eigen bijdrage naar TiS. TiS vervult in de verschillende stappen de rol van het CIZ, de zorgaanbieder en het CAK. Handleiding Testvoorziening istandaarden 23/24

24 9.9.2 In schema, met TiS-toestand De interactie met TiS ziet er zo uit: Zorgkantoor TiS toestand toelichting 1 Vulbericht.xml - startstate Het zorgkantoor stuurt vulbericht naar TiS 2 - IO31 TiS maakt op basis van vulbericht een IO31 3 IO32 - io32state Het zorgkantoor stuurt het retourbericht IO32 4 AW33 - aw33state_1 Het zorgkantoor stuurt op basis van IO31 een AW AW34 TiS maakt het retourbericht AW34 6 AW39 TiS maakt op basis van het vulbericht een AW39 7 AW310 - aw310state Het zorgkantoor stuurt het retourbericht 8 AW33(1) - aw33state_2 Het zorgkantoor stuurt voor elke betrokken zorgaanbieder een nieuwe toewijzing aan TiS 9 AW34(1) TiS maakt het eerste retourbericht 10 - AW35(1) TiS maakt op basis van AW33 een AW35 11 AW33(2) - aw33state_3 Het zorgkantoor stuurt voor elke betrokken zorgaanbieder een nieuwe toewijzing 12 - AW34(2) TiS maakt het tweede retourbericht 13 - AW35(2) TiS maakt op basis van AW33 een AW35 14 AW36(1) - aw36state_1 Het zorgkantoor stuurt de retourberichten 15 AW36(2) - aw36state_2 Het zorgkantoor stuurt de retourberichten 16 CA317 - ca317state Het zorgkantoor stuurt een CA CA318 TiS maakt het retourbericht CA <TestCase> De benodigde TestCase-id: iwlz_v2_0_tis_als_cizzacak_zk_start_direct_2 Let op De testcase-id is hoofdlettergevoelig Vulbericht Het zorgkantoor vult het deel over de AW33 in. Het gaat daarbij minimaal om de verplichte berichtklassen. Daarnaast moet de klasse Aanvraag aangevuld worden om een AW39 vanuit TiS terug te ontvangen. Handleiding Testvoorziening istandaarden 24/24