Toelichting Grouper-update Versie 5.0.0 27 september 2012
Toelichting Grouper-update │ v5.0.0 v20120927
Voorwoord Voor u ligt het document “Toelichting Grouper Update”. Bij iedere software-update en/of tabeluitlevering van de grouper wordt u geïnformeerd over de wijzigingen. Dit kunnen softwarewijzigingen, maar ook tabelwijzigingen zijn. Deze kunnen onafhankelijk van elkaar worden uitgevoerd. Softwarewijzigingen betreffen technische aanpassingen binnen de grouper en worden aangeduid met versienummer vXX.YY.ZZ, In hoofdstuk 1 ”Softwarewijzigingen” vindt u een beschrijving van alle functionele wijzigingen van de grouper die relevant zijn voor gebruikers. Voor de versienummering van de wijzigingen wordt navolgende releasenummering gehanteerd: Release XX:
Een verhoging van de releasenummering houdt in vele gevallen een grote verandering in de grouper in. Indien de release een wijziging binnen de gebruikerssystemen vereist, wordt dit vooraf gecommuniceerd.
Versie YY:
Een verhoging van het versienummer heeft te maken met kleinere veranderingen in de grouper. Deze veranderingen kunnen van impact zijn op systemen van de eindgebruiker, dit is echter niet noodzakelijk. Indien de release een wijziging binnen de gebruikerssystemen vereist, wordt dit vooraf gecommuniceerd.
Build ZZ:
Het buildnummer wordt gebruikt voor correcties van de grouper. Bij een verhoging van de build is er geen aanpassing van eindgebruikers noodzakelijk.
Bij een productstructuurwijziging of een wijziging in de landelijke tabellen wordt deze wijziging ook doorgevoerd in de tabellen waar de grouper gebruik van maakt, zie hoofdstuk 2. Op deze wijze wordt er voor gezorgd dat het afleidresultaat van de grouper overeenkomt met op dat moment geldende productstructuur en landelijke tabellen.
© DBC-Onderhoud
2 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
Inhoudsopgave Inhoud 1
Softwarewijzigingen ....................................................................................................................... 4 1.1 Wijzigingen conform ICT-eisen en specificaties ....................................................................... 4 1.1.1
Wijzigingen in de grouper ............................................................................................. 4
1.1.2
Wijzigingen in de connectivity eisen ............................................................................. 6
1.2 Overige wijzigingen .................................................................................................................. 7 1.2.1
Diakritische tekens........................................................................................................ 7
1.2.2
Wijzing headerinformatie .............................................................................................. 7
2
Wijzigingen in de tabellen van de grouper .................................................................................. 8
3
Overige wijzigingen ....................................................................................................................... 9 3.1 Scripts en voorbeelden ............................................................................................................. 9 3.2 Casussen grouper .................................................................................................................... 9
4
Uitvoering...................................................................................................................................... 10
© DBC-Onderhoud
3 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
1 Softwarewijzigingen Navolgende softwarewijzigingen zijn doorgevoerd als onderdeel van grouperversie 5.0
1.1
Wijzigingen conform ICT-eisen en specificaties
Onderstaande wijzigingen zijn eerder beschreven in “Gebruikersdocument – ICT – eisen en specificaties va 05 00 v20120703. Op enkele onderdelen vindt u een aanvullende toelichting.
1.1.1
Wijzigingen in de grouper
Tijdsafhankelijkheid Een wijziging t.a.v. tijdsafhankelijkheid van wordt doorgevoerd in de grouper.
Hieronder valt: Nieuwe vertaaltabel zorgactiviteiten De referentietabellen van de grouper worden uitgebreid met een extra tabel om nieuwe zorgactiviteiten te vertalen naar vergelijkbare zorgactiviteiten ten behoeve van een voorgaande productstructuur.
Controle en verwerking van zorgactiviteiten De controle van geldigheid van de uitgevoerde zorgactiviteitcode vindt altijd plaats op basis van de uitvoerdatum in plaats van de begindatum van het subtraject. Voor de bepaling van add-on en OVP is de uitvoerdatum bepalend in plaats van de begindatum subtraject. Voor het gebruik van de uitgevoerde zorgactiviteiten bij de afleiding naar het zorgproduct worden alleen de zorgactiviteiten betrokken die geldig zijn op begindatum subtraject. Voor zorgactiviteiten die wel geldig zijn op de uitvoerdatum, maar niet op begindatum subtraject wordt waar mogelijk een vertaling gemaakt naar een vergelijkbare zorgactiviteitcode op basis van de vertaaltabel.
Retourinformatie Het outputbericht (declaratieresultset) wordt uitgebreid met een extra settingsveld „ZA-vertaling toegepast’ als er minstens één zorgactiviteitcode vertaald is naar een vergelijkbare zorgactiviteitcode. Dit is ongeacht of de betreffende zorgactiviteit ook daadwerkelijk is uitgevraagd bij de afleiding. Specifieke informatie hierover is te vinden in de volgende documenten: Handleiding Foutmeldingen va v05 00 v20120927
© DBC-Onderhoud
4 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
Implementatiehandleiding HL7v3-DBCGrouper v2.1 SDD va v05 00 v20120927
Toekomstige berichten Het is vanaf versie 5.0 mogelijk om toekomstige berichten aan te bieden aan de grouper. Afhankelijk van de werkomgeving wordt het mogelijk om toekomstige berichten aan te bieden aan de grouper. Er wordt een configureerbare waarde toegevoegd waardoor de onderstaande controles niet worden uitgevoerd: -
Begindatum subtraject moet op of voor aanleverdatum liggen; Einddatum subtraject moet op of na aanleverdatum liggen.
Als een toekomstig bericht is aangeboden wordt een nieuwe melding DBC069 (Let op, het subtraject xxxxx ligt in de toekomst) van het type „informational‟ retour gestuurd. N.B. toekomstige berichten kunnen alleen op de acceptatieomgeving worden aangeboden. De verwerking van berichten met een begin- en/of eindatum in de toekomst op de productieomgeving blijft onveranderd t.a.v. voorgaande versie van de grouper Specifieke informatie hierover is te vinden in de volgende documenten: Handleiding Foutmeldingen va v05 00 v20120927 SDD va v05 00 v20120927 .
Aantal uitgevoerde zorgactiviteiten Het aantal uitgevoerde zorgactiviteiten is momenteel maximaal 3 posities (999). Met ingang van 1 januari 2013 is de maximale lengte van het veld gewijzigd in maximaal 4 posities (9999). Specifieke informatie hierover is te vinden in de volgende documenten: Implementatiehandleiding HL7v3-DBCGrouper v20120927 SDD Grouper va v05 00 v20120927 Hashcode Samenstelling Grouper va v5 00 v20120927
Verwijderen overbodig settingsvelden De settingsvelden die niet meer worden gebruikt, zijn definitief uit de software verwijderd. Het betreft de velden: - Setting poli - Setting Dag - Setting Klin < 3 - Setting Klin >= 3 Deze velden worden momenteel standaard op „0‟ gezet waardoor ze geen onderdeel meer zijn van het retourbericht. Vanaf 1 januari 2013 zijn de velden geheel verwijderd.
© DBC-Onderhoud
5 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
Specifieke informatie hierover is te vinden in de volgende documenten: Implementatiehandleiding HL7v3-DBCGrouper v2.1 SDD va v05 00 v20120703
1.1.2
Wijzigingen in de connectivity eisen
Servercertificaat Indien de grouper een nieuw certificaat nodig heeft zal daarvoor gebruik worden gemaakt van de nieuwe versie van KPN in plaats van Getronics. Verplicht gebruik van SOAP-location en SOAP-action Vanaf 1 januari 2013 geldt de verplichting om de SOAP-location en SOAP-Action te gebruiken voor het aanbieden van berichten aan de grouper. Op dit moment worden berichten die geen volledig SOAP-location en –action meegeven omgeleid naar de juiste webservice. Ter toelichting: op dit moment kunnen berichten bijvoorbeeld aangeboden worden middels: https://acceptatie.dbcogrouper.nl, Verdere verwerking van de aanroep naar de juiste web pagina wordt automatisch uitgevoerd Vanaf 5.0 kan dit enkel nog via: https://acceptatie.dbcogrouper.nl/dbc/soapserver/DBC.WS.Declaraties.cls https://acceptatie.dbcogrouper.nl/dbc/soapserver/DBC.WS.Management.cls Uiteraard dient de aanlevering te geschieden in combinatie met bijbehorende SOAPaction. Aanleveringen met een onjuiste SOAPLocation worden afgekeurd met een HTTP/404 of HTTP/403
Toegang met een Vecozo-certificaat Verzendende instellingen die geen aanspraak kunnen maken op een registratie als abonnee van het UZI-register, omdat het een servicebureau betreft of een niet-Nederlandse organisatie, krijgen de mogelijkheid aan te leveren met een VECOZO-servercertificaat.
Overige wijzigingen Aanvullend op de wijzigingen beschreven in de ICT-eisen en specificaties, zijn navolgende wijzingen in de connectivity eisen doorgevoerd. - Ondersteuning IPv4 - Minimale eis m.b.t. ondersteuning cookies - Eisen m.b.t. gebruik van het failovermechanisem Meer informatie vindt u in het document: “Connectivity Eisen v20120927”.
© DBC-Onderhoud
6 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
1.2 1.2.1
Overige wijzigingen Diakritische tekens
Vanaf grouper versie 5.0 wordt het gebruik diakritische tekens ondersteund.
1.2.2
Wijzing headerinformatie
Als gevolg van release 5.0 is de header-informatie van het outputbericht gewijzigd. Voorbeeld oude situatie HTTP 200 PRAGMA: no-cache Cache-Control: no-cache Date: Wed, 05 Sep 2012 14:25:50 GMT Expires: Thu, 29 Oct 1998 17:04:19 GMT Set-Cookie: CSPSESSIONID-SP-443-UP-dbc-soapserver=00f00003000041f79fGrgh00001y7FBDoUYQYWUrWq1c9ynw--; path=/dbc/soapserver/;,CSPWSERVERID=ce7927c71af4a534683130d0a01abd3fcf9ca330; path=/; Server: Apache CONTENT-LENGTH: 17742 Connection: close Content-Type: text/xml; charset=UTF-8
Nieuwe situatie HTTP 200 Vary: SoapAction PRAGMA: no-cache Cache-Control: no-cache Date: Tue, 04 Sep 2012 10:18:59 GMT Expires: Thu, 29 Oct 1998 17:04:19 GMT Set-Cookie: CSPSESSIONID-SP-443-UP-dbc-soapserver=0020000200002b37zJf96r0000Y4iF8K4fnoeOSMPc0aUt4w--; path=/dbc/soapserver/; secure; HttpOnly;,CSPWSERVERID=d071d535af490ff7313756ae4a0c9f543988d268; path=/; Server: Apache CONTENT-LENGTH: 3727 Connection: close Content-Type: text/xml; charset=UTF-8
© DBC-Onderhoud
7 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
2 Wijzigingen in de tabellen van de grouper Op 27 september worden tabellen van de RZ13a beschikbaar gesteld op de acceptatieomgeving van de grouper voor testdoeleinden. Dit betreft een samengestelde productstructuur van de RZ12b (geldigheid 1-1-2012 tot 1-5-2012), RZ12c (geldigheid 1-5-2012 tot 1-9-2012), RZ12d (geldigheid 1-92012 tot 1-1-2013) en de RZ13a met een ingangsdatum van 1-1-2013. De tabellen en toelichting op de tabellen worden tevens op de website uitgeleverd.
Zie ook: -
Groupertabellen v20120927 Toelichting groupertabellen v20120927
© DBC-Onderhoud
8 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
3 Overige wijzigingen
3.1
Scripts en voorbeelden
Een nieuwe versie van de scripts en voorbeelden is uitgeleverd. Hierbinnen is enkel de WSDL aangepast t.a.v. van de vorige versie. De WSDL beschrijft nu de SOAP-locations conform de definities in de connectivity eisen. Zie ook: Scripts en voorbeelden v2.10
3.2
Casussen grouper
Een nieuwe versie van de casussen voor de grouper is beschikbaar. Zie ook: Casussen Grouper v20120927
© DBC-Onderhoud
9 │ 10
Toelichting Grouper-update │ v5.0.0 v20120927
4 Uitvoering Hier vindt u een overzicht van de data en tijdstippen van de uitvoering van de grouperupdates. De desbetreffende omgeving is gedurende deze periode niet of beperkt beschikbaar. Bij de release op de productieomgeving is de verstoring echter minimaal als gevolg van het gebruik van het automatische uitwijksysteem van de grouper. Na de software- en tabelrelease op 27 september voert DBC-onderhoud acceptatietesten uit op de acceptatieomgeving. Deze omgeving is daardoor gedurende 2 dagen niet beschikbaar. De release van het pakket van de RZ13a, en daarmee tabellen, vindt niet plaats op de productieomgeving. Op 15 november staat de uitlevering van de RZ13b gepland met een ingangsdatum welke per 1 januari 2013 in prodcutie zal gaan. De exacte datum en tijd van de release op de productieomgeving wordt nog bepaald.
Release 5.0 met bijbehorende tabellen wordt niet uitgevoerd op de GRZ-omgeving.
Acceptatieomgeving Software-
Datum
27 / 28 september 2012
wijziging
Periode
Gehele dag
Acceptatieomgeving grz
Productieomgeving 1 januari 2013 n.t.b.
nvt Tabel-
Datum
27 / 28 september 2012
nvt, RZ13b gaat in
wijzigingen
Periode
Gehele dag
productie
© DBC-Onderhoud
10 │ 10