Algemene toelichting hash

Transcriptie

1 Algemene toelichting hash Vanaf softwareversie 6.0 Versie va november 2014

2 Document historie Revisies Document Versie Vanaf softwareversie Publicatie Datum Wijzigingen v Relevante gebruikersinformatie samengesteld en gereviseerd uit het document Hashcode samenstelling Grouper versie 1.0 (v ). v Tekstuele wijziging: De term bits is vervangen door bytes. Informatie over de implementatie m.b.t. voorloopnullen en spaties is verwijderd. Deze staat vermeld in het document Hashcode Samenstelling Grouper. v Beschikbaarheid van de public key op de website van DBC- Onderhoud. Daarnaast zijn enkele tekstuele wijzigingen doorgevoerd. v Toevoeging van technische informatie t.b.v. gebruik en versleutelings van de hash in paragraaf 3.1 v Tekstuele verbetering en eenduidig gebruik van termen. v Definitieve versie RZ14b. Geen inhoudelijke wijzigingen t.a.v. v DBC-Onderhoud 2 12

3 Inhoudsopgave 1 Inleiding Verzegeling van de uitkomsten van de grouper voor DIS en zorgverzekeraar Controle van de hash door zorgverzekeraars en DIS Het bepalen van de hash door de grouper De controle van de hash Controle hash door zorgaanbieders Rapportage aan DIS Gebruik van de hashcodes bij het proces na de grouperverwerking Public keys Gerelateerde beschrijvingen en specificaties DBC-Onderhoud 3 12

4 1 Inleiding Dit document beschrijft het concept, de werking en de toepassingsmogelijkheden van het hashingmechanisme van de grouper binnen de keten van aanlevering aan de grouper, declaratie (EI-bericht) en aanlevering aan DIS. Dit document geeft daarnaast uitleg over de verschillende typen hashcodes waarbij onderscheid gemaakt wordt tussen een zogenaamde hashstring, hashvalue en signed hash. De specificaties van de eerste stap in het opbouwen van de hash, namelijk het samenstellen van de hashstring, wordt beschreven binnen het gebruikersdocument Hashcodesamenstelling grouper. DBC-Onderhoud 4 12

5 2 Verzegeling van de uitkomsten van de grouper voor DIS en zorgverzekeraar Het primaire doel van de verzegeling van de uitkomsten van de grouper is om er voor te zorgen dat: de zorgverzekeraar kan vaststellen dat de gegevens die bij de declaratie van de declarabele prestaties worden aangeboden, door de landelijke DBC-Onderhoud grouper zijn verwerkt. Er wordt daarbij een onderscheid gemaakt tussen de declaratie van een zorgproduct en van een zorgactiviteitdeclaratie (add-on en/of OZP). Bij de declaratie is de hashcode voor het zorgproduct verplicht. De hashcode voor de add-on is conditioneel. Dat betekent dat: bij declaratie van de add-on in combinatie met het zorgproduct na de verwerking door de grouper deze verplicht is; bij declaratie van de add-ons buiten de verwerking van de complete DBC declaratiedataset door de grouper om deze niet verplicht is; de hashcode voor de OZP s wel verplicht is. DIS kan aan de hand van de hash bepalen of de DBC en de profielgegevens van het hoofdsubtraject en de voorkomende 51 subtrajecten die in de DBC declaratiedataset aan de grouper zijn aangeboden, ongewijzigd bij DIS zijn aangekomen. Het door de zorgaanbieder gedefinieerde DBC declaratiedatasetnummer zorgt bij de aanlevering voor een unieke identificatie van de desbetreffende trajecten. Daarmee kunnen eventuele latere correcties mee worden gerelateerd aan de eerdere aanlevering. Het door de grouper gegenereerde declaratieresultsetnummer geeft de unieke relatie weer met de verwerking door de grouper. Dit veld is overigens niet in de hashcodesamenstelling opgenomen ter voorkoming van onnodige crediteringen. De functie van de verzegeling is er dus op gericht om de gegevens die bij de verwerking door de grouper gebruikt worden dan wel ontstaan te borgen. Om deze reden bevat de hash voornamelijk velden welke alleen betrekking hebben op het grouperproces (het afleiden van declaraties). Als gegevens welke van belang zijn voor declaratie wijzigen zal dat altijd moeten leiden tot een nieuwe aanlevering aan de grouper. Indien er sprake is van nagekomen verrichtingen zal de aangevulde dataset opnieuw aan de grouper worden aangeboden. Dat kan ten aanzien van de declarabele prestaties leiden tot hetzelfde of een aangepast resultaat. Het kan zijn dat het zelfde zorgproduct wordt afgeleid, maar een ander aantal add-ons. Alleen bij andere prestaties dan wel bij een wijziging van de zorgverzekeraarshash dan zal creditering noodzakelijk zijn. Als de hash voor de DIS is gewijzigd zal een nieuwe aanlevering aan de DIS moeten volgen. DBC-Onderhoud 5 12

6 3 Controle van de hash door zorgverzekeraars en DIS 3.1 Het bepalen van de hash door de grouper Het bepalen van de verschillende hashcodes van de grouper gebeurt in drie stappen, waarbij onderscheid wordt gemaakt tussen de hashstring, de hashvalue en signed hash. De signed hash is het uiteindelijke eindproduct dat door de grouper wordt afgeven. De berekening en encryptie van de hash door de grouper gebeurt als volgt: Figuur 1 Het bepalen van de hash De Hash codes worden bepaald op basis van meerdere gegevens van de declaratiedataset. Er wordt een drietal hashcodes onderscheiden: De hashcode over het te declareren zorgproduct De hashcode over de te declareren add-ons en OZP s De hashcode over de aan de DIS aan te leveren informatie over zorgproduct en profiel In de eerste stap van het proces, wordt de hashstring samengesteld op basis van de voor die hashstring relevante velden (de message digest). Na het toepassen van een cryptografisch hashing algoritme (SHA-1) ontstaat een hashvalue / hashwaarde. De berekende hashvalue is een sequence van bytes, met een vaste lengte (20 posities). De hashvalue van het bericht (de message digest) wordt versleuteld met de private key van de grouper. Op deze manier wordt een versleutelde hashwaarde / signed hash verkregen met een lengte van 128 bytes. Deze waarde wordt omgezet naar een Base64 tekenreeks van maximaal 200 posities. 3.2 De controle van de hash Zowel DIS als de zorgverzekeraar ontvangen van de zorgaanbieder aanleveringen voorzien van een hashcode in de vorm van een signed hash. Voor zorgverzekeraars en DIS is een publieke sleutel beschikbaar om de meegestuurde de signed hash te decrypten en te vergelijken met een zelf berekende hashwaarde op basis van de aanlevering van de zorgaanbieder. Zo kunnen zij op basis van de hash controleren of het door hun ontvangen bericht hetzelfde is als dat wat door de grouper is verwerkt, cq bepaald. De controle van de hash zal plaats moeten vinden vooraf aan de nadere verwerking van het ontvangen bericht. DBC-Onderhoud 6 12

7 Als er in het vervolg van deze paragraaf gesproken wordt over bericht dan dient voor de Zorgverzekeraar EI bericht, en voor de DIS het formaat van de gegevensaanlevering DIS gelezen te worden. Het principe van de controle van de hashcode is als volgt: Figuur 2 Controle van de hashcode Allereerst wordt door de ontvanger, uit de aanlevering van de zorgaanbieder, de hashstring samengesteld door de hash-specifieke velden van het bericht (signed Message) op eenzelfde manier als de grouper te verwerken tot een hashstring. Hierover wordt vervolgens m.b.v. SHA-1 een zogenaamde hashwaarde berekend (Current Hash-value). De hashwaarde is 20 posities groot. Vervolgens wordt met behulp van de Public Key de meegeleverde signed hash (de Digital signature- 200 posities) gedecrypt tot een hashwaarde (20 posities). De signed hash is door de grouper bepaald. Tenslotte worden de eigen hashwaarde en de hashwaarde van de grouper met elkaar vergeleken. Als beide waarden gelijk zijn, zijn de velden waar de hash over bepaald is door DIS / Zorgverzekeraar exact gelijk aan de waarden waarover door de grouper de hashberekning is uitgevoerd. De hashcontrole is dan positief, het ontvangen bericht is het resultaat van de verwerking door de landelijke grouper en de gegevens zijn na de grouperverwerking niet veranderd. De verdere verwerking door de zorgverzekeraar of DIS kan plaatsvinden. Opmerking: In de specificaties van de hashcode bepaling van VEKTIS is opgenomen dat meerdere velden voor de hashstring geen vaste lengte qua in te vullen waarden hebben, terwijl in de EI-standaard de veldlengtes wel vast zijn. In het EI-bericht worden numerieke velden zo nodig voorafgegaan door voorloopnullen en alfanumerieke velden door naloopspaties. Door de zorgverzekeraars dient om deze reden een bewerking op sommige EI-velden worden gedaan om de hashcode te kunnen controleren. In de invul instructie wordt aangegeven welk deel van het aangeleverde gegeven moet worden gebruikt bij de hashcontrole. Deze instructie maakt deel uit van de specificaties van het EI bericht van VEKTIS. DBC-Onderhoud 7 12

8 4 Controle hash door zorgaanbieders De inputgegevens uit de Declaratiedataset worden wel verwerkt in de hashwaarden, maar binnen productieaanleveringen niet in de afgeleide DeclaratieResultSet mee teruggestuurd door de grouper! Het ZIS/XIS van de Zorginstelling moet er zelf voor zorgen dat bij het declareren dezelfde declaratiegegevens als bij het aanmaken van de Declaratiedataset worden meegestuurd. Als deze gegevens niet overeenkomen zal de zorgverzekeraar bij het berekenen van de hashwaarden op een andere waarde uitkomen, waarmee de declaratie zal worden afgekeurd. Met het oog op de behoefte van zorginstellingen om de hashcodes te kunnen decrypten, is de public key beschikbaar op de website van DBC-Onderhoud. Voor meer informatie zie paragraaf 7 Public keys. DBC-Onderhoud 8 12

9 5 Rapportage aan DIS Naast de declaratie aan de zorgverzekeraar dient de complete set gegevens ook naar DIS gestuurd te worden. Dit nadat de DIS-dataset gecompleteerd is met gegevens die niet uit de grouper komen, zoals verzekeraar en tarieven. Dat betekent inclusief de mogelijk eerder gedeclareerde add-ons. DBC-Onderhoud 9 12

10 6 Gebruik van de hashcodes bij het proces na de grouperverwerking Na het afleiden van declarabele producten via de grouper vinden een aantal vervolg bewerkingen plaats, waarbij gebruik gemaakt wordt van de door de grouper geleverde informatie. Beoordeling Declarabele prestaties De uitkomst van het grouper proces zal door de zorgaanbieder worden beoordeeld op juistheid, alvorens zal worden overgegaan tot het declareren van de declarabele prestaties aan de zorgverzekeraar. Dit proces wordt per ziekenhuis ingericht. Declaratie van de declarabele prestaties De declarabele prestaties worden gedeclareerd aan de zorgverzekeraar waar de patiënt verzekerd is op het moment van het leveren van de prestatie. Voor het DBC-zorgproduct is dat de ingangsdatum van het subtraject, voor de add-ons en de OVP s de prestatiedatum. Add-on controle Voor de add-ons dient de zorgaanbieder na te gaan welke add-ons reeds eerder werden gedeclareerd. Het zorgactiviteitnummer (in het EI-bericht ZorgactiviteitIdentificatienummer genoemd en in de grouper zorgactiviteitnummer genoemd) kan daarbij als unieke sleutel worden gebruikt, in combinatie met het zorgtrajectnummer bij dure geneesmiddelen of het verwijzend zorgtrajectnummer bij IC prestaties dat bij de tussentijdse declaratie van de add-ons ook in het EI-bericht wordt verwacht. Hashcodes voor zorgverzekeraars Bij de declaratie van de declarabele prestaties zal gebruik gemaakt worden van het berichtformat volgens de EI-standaard zoals vastgesteld door VEKTIS. In de berichtspecificaties wordt een onderscheid gemaakt in de declaratie van de DBC-zorgproducten en de add-ons. Voor beide geldt dat er sprake is van verzegeling HASHTOTAAL ZV (de signed hash) voor de DBC-zorgproducten en voor de declaratie van de door de grouper vastgestelde add-ons en OZP s DBC-Onderhoud 10 12

11 7 Public keys De public keys van de grouper zijn beschikbaar via de website van DBC-Onderhoud. Er zijn aparte keys voor de acceptatie- en de productieomgeving van de grouper. De uitwijkomgeving van de grouper is voorzien van dezelfde sleutel als de productieomgeving. Indien de grouperomgevingen worden voorzien van nieuwe sleutels worden deze vooraf beschikbaar gesteld. Per key zijn twee versies beschikbaar: één met header- en footerinformatie en één als lange string (NoNL). De key is (standaard) in base64 'gecodeerd'. Voor de encryptie van de hashes wordt er gebruik gemaakt van het RSA algoritme, met Mode : NONE en Padding: NONE. DBC-Onderhoud 11 12

12 8 Gerelateerde beschrijvingen en specificaties De volgende documenten geven een technische detaillering van de Hashcode samenstelling (zie website DBC-Onderhoud): Implementatiehandleiding van HL7v3 berichten van en naar de Grouper Beschrijving van het in- en output model van de berichten van de grouper. Hashcode samenstelling Grouper Specificaties en voorbeelden van de opbouw van de hashcode samenstelling (hashstring) van de verschillende type hashcodes. DBC-Onderhoud 12 12