Handleiding voor gegevensmakelaars. Aanlevering kwaliteitsgegevens bij Zorginstituut Nederland

Handleiding voor gegevensmakelaars Aanlevering kwaliteitsgegevens bij Zorginstituut Nederland

INHOUD Leeswijzer.................................................................................................................................. 2 1. Het aanleverproces ................................................................................................................ 3 1.1 Account aanvragen........................................................................................................... 4 1.2 Autorisatie aanvragen voor aanleveren gegevensbestanden........................................... 6 1.3 Bestand voor aanleveren gegevens opstellen (XML maken) ........................................... 7 1.4 Gegevensbestand aanleveren (XML uploaden) ................................................................ 7 1.4.1. Aangeleverde bestand is fout .................................................................................... 8 1.4.2 Aangeleverd bestand is correct .................................................................................10 1.5 Ingelezen bestand goedkeuren........................................................................................10 2. Toelichting op dataset ...........................................................................................................11 2.1 Bestandsgegevens ..........................................................................................................11 2.2 Organisatiegegevens.......................................................................................................11 2.3 Indicatorsets en indicatorgegevens..................................................................................13 3 Codelijsten .............................................................................................................................16 Bijlage 1 : XSD Voor gegevensaanleveringen op Zorginzicht....................................................19 Bijlage 2: Voorbeeld XML..........................................................................................................21

Versiebeheer Versie

Datum

Toelichting/status

1.0

16 maart 2015

Definitief

1.1

12 mei 2015

Kleine aanpassingen

1

Leeswijzer Voor wie is deze handleiding Deze handleiding is voor gegevensmakelaars: partijen die namens een groep zorginstellingen (bijvoorbeeld via een branche-organisatie) kwaliteitsgegevens aan het Zorginstituut moeten aanleveren op de website www.zorginzicht.nl. Deze handleiding geeft aan welke stappen er genomen moeten worden om een gegevensbestand aan te kunnen leveren. Ook wordt het bestandsformaat en de inhoud van het bestand toegelicht. Het is belangrijk om dit door te lezen voordat u start met het klaarzetten of genereren van een gegevensbestand. Welke documenten zijn er nog meer Naast deze handleiding is er ook een Handleiding voor gebruik van de Bibliotheek en het Kwaliteitsregister Hierin staat uitleg over het gedeelte van Zorginzicht waar informatie gedeeld kan worden over (het ontwikkelen van) meetinstrumenten en kwaliteitsstandaarden. Ook is er een Leidraad voor gegevensaanlevering beschikbaar, dit document bevat handvatten voor inrichting van het proces van gegevens verzamelen en aanleveren. Aanleverplicht Het Kwaliteitsinstituut maakt afspraken met zorgaanbieders over welke kwaliteitsgegevens gemeten worden en wanneer die worden aangeleverd. Deze staan op de Transparantiekalender. Zorgaanbieders zijn wettelijk verplicht informatie over de kwaliteit van verleende zorg conform afspraken in de Transparantiekalender aan te leveren bij het Kwaliteitsinstituut. Meer informatie Meer informatie over meetinstrumenten en kwaliteitsstandaarden en over de aanleverplicht is te vinden op de website van Zorginstituut Nederland en op Zorginzicht.nl. Op Zorginzicht zijn onder andere ook indicatorgidsen te vinden en achtergronddocumentatie bij de indicatoren waarover kwaliteitsinformatie moet worden aangeleverd.

2

1. Het aanleverproces Voor het aanleveren van kwaliteitsgegevens aan het Zorginstituut Nederland volgt u de volgende stappen: 1 Account aanvragen 2 Autorisatie aanvragen voor het aanleveren van gegevensbestanden 3 Bestand voor aanleveren gegevens opstellen 4 Gegevensbestand aanleveren (XML uploaden) 5 Ingelezen gegevensbestand goedkeuren Deze stappen worden in dit hoofdstuk nader toegelicht.

Figuur 1: Stappenplan Aanleveren kwaliteitsgegevens.

3

1.1 Account aanvragen Als gegevensmakelaar heeft u een Zorginzicht-account nodig om kwaliteitsgegevens aan te kunnen leveren. Daarnaast kunt u met uw account inzicht krijgen in statussen van gerelateerde processen in ‘Mijn Loket’. Via: www.zorginzicht.nl kunt u een account aanvragen, door op [inloggen] te klikken. Vervolgens op [Nog geen account? Vraag hier een account aan]. Zie schermafbeelding:

Figuur 2: Klik rechtsboven op [Inloggen].

Figuur 3: Klik dan op [Nog geen account? Vraag hier een account aan].

Of u kunt zich direct aanmelden via de volgende link: https://www.zorginzicht.nl/Paginas/Aanmelden.aspx

4

U kiest voor de rol [Gegevensmakelaar] en vult in ieder geval de verplichte velden in.

Figuur 4: Vul het aanmeldformulier in.

Als u de aanvraag heeft ingediend, ontvangt u binnen maximaal 5 werkdagen een e-mail1. In deze e-mail staat een link die u moet bevestigen om uw account te activeren.

1

ZorgInzicht verstuurt u een automatisch gegenereerde mail. In een enkel geval kan het gebeuren dat uw mail in een spamfilter terecht komt. Als u binnen de genoemde 5 werkdagen geen mail heeft ontvangen kunt u contact opnemen met [email protected]

5

1.2 Autorisatie aanvragen voor aanleveren gegevensbestanden Let op: u kunt alleen inloggen als uw account geactiveerd is. Kies na het inloggen voor [Mijn account], daarna voor [Wijzig uw account]. Bij [Aanvragen autorisatie] kunnen een of meer Indicatorensets worden toegevoegd waarvoor de gegevens aangeleverd worden. Kies voor [Opslaan].

Figuur 5: Autorisatie aanvragen Indicatorsets.

U ontvangt een e-mail met een bevestiging van uw aanvraag. Uw verzoek wordt binnen maximaal 5 werkdagen afgehandeld,een bevestiging ontvangt u per e-mail2. Uw account is nu gereed voor het aanleveren van de gegevens (gemeten resultaten) van de indicatorensets waarvoor uw account geautoriseerd is.

2

ZorgInzicht verstuurt u een automatisch gegenereerde mail. In een enkel geval kan het gebeuren dat uw mail in een spamfilter terecht komt. Als u binnen de genoemde 5 werkdagen geen mail heeft ontvangen kunt u contact opnemen met [email protected]

6

1.3 Bestand voor aanleveren gegevens opstellen (XML maken) Voor de indicatorensets waarvoor u geautoriseerd bent om gegevens aan te leveren, kunt u nu per set - een gegevensbestand opstellen. Dit bestand moet in xml-formaat worden opgesteld en bevat een aantal verplichte elementen. Hoe dit bestand moet worden samengesteld en met welke elementen, wordt toegelicht in hoofdstuk 2 (dataset).

1.4 Gegevensbestand aanleveren (XML uploaden) Het gegevensbestand kunt u aanleveren door te kiezen voor: [Open data] - [Aanleveren gegevens]. Vervolgens selecteert u de indicatorset waarvoor de gegevens aangeleverd worden.

Figuur 6: Selecteer een indicatorset.

Hierna kunt u het bestand uploaden, waarbij u ervoor kunt kiezen een omschrijving mee te geven. Deze omschrijving is voor eigen gebruik en is niet verplicht. De applicatie valideert vervolgens of u een geldige XML heeft aangeleverd en of deze voldoet aan de gestelde structuureisen.

7

1.4.1. Aangeleverde bestand is fout Als uw bestand fouten bevat, dan ontvangt u een e-mail3.

Figuur 7: Voorbeeld e-mail met foutmeldingen uit aangeleverd bestand.

3

ZorgInzicht verstuurt u een automatisch gegenereerde mail. In een enkel geval kan het gebeuren dat uw mail in een spamfilter terecht komt. Als u binnen de genoemde 5 werkdagen geen mail heeft ontvangen kunt u contact opnemen met [email protected]

8

Via de menu-optie [Open Data] -[Mijn Loket] is het mogelijk om uw aangeleverde bestanden te bekijken en tevens de foutmeldingen te bekijken per aanlevering. Door op de 3 puntjes te klikken bij de betreffende aangeleverde indicatorset, wordt een menu geopend.

Figuur 8: Klik voor het menu op de 3 puntjes.

Kies voor [Bekijk Validatielog] om de foutmeldingen bij deze aanlevering te tonen, dat ziet er bijvoorbeeld zo uit:

Figuur 9: Voorbeeld validatielog

Als het bestand door u is goedgekeurd, wordt het ingelezen in de Openbare database. Als u het bestand niet goedkeurt, kunt u het verwijderen, via het zelfde menu, met het menu item [Verwijder Indicatorset]. Het wordt dan niet meer getoond in de aangeleverde bestanden in Mijn Loket en u kunt het ook niet meer goedkeuren. U kunt wel opnieuw een bestand aanleveren.

9

1.4.2 Aangeleverd bestand is correct Als uw bestand correct is aangeleverd, krijg u daarvan ook een e-mail4. Dan kunt u het aangeleverde bestand bekijken, via de menuoptie [Bekijk Indicatorset]. U ziet dan de eerste 100 aangeleverde records uit het bestand, een voorbeeld staat hieronder:

Figuur 10: Voorbeeld aangeleverde records uit bestand.

1.5 Ingelezen bestand goedkeuren U kunt de indicatorset via Zorginzicht goedkeuren, als u na het bekijken van de indicatorset akkoord bent. Dit kunt u doen via het menu item [Goedkeuren Indicatorset]. Als het bestand door u is goedgekeurd, wordt het ingelezen in de Openbare database. Als u het bestand niet goedkeurt, kunt u het verwijderen, via hetzelfde menu, met het menu item [Verwijder Indicatorset]. Het wordt dan niet meer getoond in de aangeleverde bestanden in Mijn Loket en u kunt het ook niet meer goedkeuren. U kunt wel opnieuw een bestand aanleveren. Als het niet lukt om een bestand aan te leveren en te laten valideren en daarna goedkeuren, kunt u contact opnemen met onze helpdesk5

4

ZorgInzicht verstuurt u een automatisch gegenereerde mail. In een enkel geval kan het gebeuren dat uw mail in een spamfilter terecht komt. Als u binnen de genoemde 5 werkdagen geen mail heeft ontvangen kunt u contact opnemen met [email protected] 5 [email protected]

10

2. Toelichting op dataset De gegevensaanlevering vindt altijd plaats per indicatorset en bevat een aantal verplichte en een aantal facultatieve gegevenselementen.

2.1 Bestandsgegevens U kunt via het Loket van Zorginzicht gegevensbestanden aanleveren voor de indicatoren die op de Transparantiekalender van Zorginzicht staan. Het gegevensbestand moet in xml-formaat worden aangeleverd en voldoen aan de in de door Zorginstituut Nederland beschikbaar gestelde XML Schema Definitie (xsd) . Zie bijlage 1 voor een beschrijving van de xsd. Deze is ook direct te downloaden van Zorginzicht. Toelichting XSD In het XSD wordt aangegeven hoe elementen (de velden met daadwerkelijke informatie in het bestand) worden opgebouwd: - welk datatype - in welke volgorde - welke restricties (bijv. of het leeg mag zijn of minstens 1 keer moet voorkomen in het bestand) In dit hoofdstuk worden de velden uit de XSD toegelicht en in bijlage 2 is een voorbeeld XML uitgewerkt. Op internet is informatie en software beschikbaar voor het (automatisch laten) omzetten van XSD in een XML.

2.2 Organisatiegegevens De aangeleverde kwaliteitsgegevens worden door ZIN gepubliceerd in de Openbare Database en op KiesBeter. Voor de publicatie op KiesBeter is het noodzakelijk dat de adresgegevens van alle zorginstellingen en hun vestigingen worden meegeleverd. In het bestand dat u aanlevert is het mogelijk om zowel op hoofdvestigingsniveau data aan te leveren als op vestigingsniveau. Als u op vestigingsniveau aanlevert, moet u ook de gegevens van de hoofdvestiging aan leveren, zie het voorbeeld-xml in bijlage 3. Voor zowel hoofdvestigingen als vestigingen hebben we een Kamer van Koophandel (KvK)nummer nodig, de naam zoals de (hoofd-)vestiging is geregistreerd in het Handelsregister (van de KvK) en indien mogelijk een AGB code. Het KvK-nummer en de naam van de instelling (zoals geregistreerd in het Handelregister) van de (hoofd-)vestiging kunt u opzoeken op de website van het Handelsregister: www.kvk.nl

11

De AGB-code is nodig omdat ZIN de adresgegevens van zorginstellingen wil kunnen koppelen, voornamelijk in verband met de vindbaarheid van uw instelling op KiesBeter. In 1 bestand kunnen voor meerdere zorginstellingen gegevens worden aangeleverd. Per locatie of vestiging Als er gegevens per locatie of vestiging worden aangeleverd, moet het KvK-nummer van de vestiging worden aangeleverd (dit staat apart vermeld op de website van het handelsregister). In het XML-voorbeeld in bijlage 3 ziet u een voorbeeld van een XML-bestand met zowel een hoofdvestiging als een vestiging. Als er alleen een hoofdvestiging is, mag u de velden voor locatie/vestiging leeg laten. Element * betekent verplicht veld

Toelichting

Voorbeeld

Kvk nummer*

Het KvK-nummer van de hoofdvestiging of vestiging

123456

Organisatienaam*

De naam van de (hoofd)vestiging zoals deze in het Handelsregister (KvK) is opgenomen

Organisatie postcode*

De postcode van de (hoofd)vestiging

Organisatie plaats*

De plaatsnaam van de (hoofd)vestiging

Organisatie huisnummer*

Het huisnummer van de (hoofd)vestiging

Organisatie AGB code

De AGB code de (hoofd)vestiging. Deze AGB code alleen vullen indien deze afwijkt van de AGB code van het concern. Deze is dus niet verplicht voor een vestiging.

*LET OP : geen postbussen Een voorbeeld van een XML/bestand staat in bijlage 2.

12

2.3 Indicatorsets en indicatorgegevens Indicatorsetgegevens Indicatorset is een gegeven: u kiest de set waarvoor u het bestand wilt aanleveren (zie hoofdstuk 1). Het systeem controleert bij het inlezen van het bestand of de indicatorcodes overeenstemmen met de opgegeven indicatorset. Indicatorgegevens Per indicator moeten de volgende gegevens verplicht worden aangeleverd: Element * betekent verplicht veld

Toelichting

Voorbeeld

Indicatorcode*

Een door Zorginzicht gegenereerde code; zie voor uitleg het hoofdstuk Codelijsten

IND000587

MeetperiodeBeginDatum*

De begindatum van de periode waarover de indicatorwaardes gemeten zijn. Dit kan ook een peildatum zijn, in dat geval zijn begin- en einddatum gelijk. Let op de juiste Datum/Tijd6 notatie: YYYY-MM-DD-MM-

2014-03-31T00:00:00

YYYYT00:00:00 MeetperiodeEinddatum*

De einddatum van de periode waarover de indicatorwaardes gemeten zijn. Dit kan ook een peildatum zijn, in dat geval zijn begin- en einddatum gelijk. Let op de juiste Datum/Tijd notatie: YYYY-MM-DD-MM-

2014-03-31T00:00:00

YYYYT00:00:00 Indicatorwaarde

6

Waarde van de indicator. Afhankelijk van het datatype van de indicator (getal, tekst, datum, Ja/Nee, percentage etc.)

98,345

De xsd valideert op DatumTijd. U moet dus naast de datum ook een tijd ingeven.

13

N

Volume

123

Teller

Waarde van de teller, als deze wordt meegeleverd met de indicator

43

Noemer

Waarde van de noemer, als deze wordt meegeleverd met de indicator

78

IndicatorNvt*

Hiermee kan worden aangegeven of de indicator voor deze zorginstelling van toepassing is. Let op Dit is een boolean. Standaard staat de waarde op 0 (niet van toepassing is niet waar); als de indicator niet van toepassing is moet de waarde 1 hier worden aangeleverd.

0

Opmerking

Tekstveld waar een opmerking of toelichting bij de aangeleverde indicatorwaarde kan worden gegeven.

Zowel de deelnemend hematoloog/internist als klinisch patholoog zijn IKNL consulent, maar nemen niet in deze rol deel aan het structureel overleg

ExclusieNvt

Tekstveld waarin eventuele exclusiecriteria kunnen worden vermeld, mits dit bij indiening van de indicator is vermeld. Let op Dit is een boolean. Standaard staat de waarde op 0 (Er is geen sprake van exclusiecriteria); als er voor de indicator wel exclusiecriteria van toepassing zijn moet de waarde 1 hier worden aangeleverd.

1

Niet Beschikbaar

Hiermee kan worden aangegeven indien de indicator voor deze zorginstelling van niet beschikbaar is. Let op Dit is een boolean. Standaard staat de waarde

0

14

op 0 (de indicator is wel beschikbaar); als de indicator niet beschikbaar is moet de waarde 1 hier worden aangeleverd. Gemiddelde uitkomst

Hiermee kunnen eventueel berekende (gemiddelde) waarden bij het totaal van aangeleverde indicatorscores7 worden aangeleverd

3.88

Laagste uitkomst

Hiermee kunnen eventueel berekende (laagste) waarden bij het totaal van aangeleverde indicatorscores worden aangeleverd

2.31

Hoogste uitkomst

Hiermee kunnen eventueel (hoogste) berekende waarden bij het totaal van aangeleverde indicatorscores worden aangeleverd

6.52

Middelste uitkomst

Hiermee kunnen eventueel (middelste) berekende waarden bij het totaal van aangeleverde indicatorscores worden aangeleverd

3.88

Overige indicator gegevens hoeven (anders dan in voorgaande jaren) niet te worden aangeleverd. In plaats daarvan wordt gewerkt met Indicatorcodes (zie hieronder in Hoofdstuk 3).

7

De uitkomstwaardes zijn van het type float. Het gebruik van en komma is niet toegestaan.

15

3 Codelijsten Elke indicator waarvoor gegevens moeten worden aangeleverd, staat op de Transparantiekalender en maakt altijd onderdeel uit van een Indicatorset. Van de indicatoren op de Transparantiekalender worden de volgende gegevens opgeslagen in de database: Inhoud van de Tabel Indicator Veldnaam

Betekenis

Voorbeeld

Code

Indicatorcode; identificerende code

IND000013

Nummer

Eventueel een nummer van de 2.1.b indicator, niet verplicht, bedoeld voor eigen gebruik zorgaanbieders en/of gegevensmakelaar

Naam

Omschrijving van de indicator. Hieruit moet blijken welke gegevens door deze indicator worden opgevraagd

Het percentage patiënten met meniscusletsel dat daar operatief voor is behandeld en een diagnostische MRI heeft gekregen maximaal één jaar voorafgaand aan de ingreep

Eerste aanleverdatum

De eerstvolgende datum waarop de gegevens voor de deze indicator bij ZIN moeten zijn aangeleverd

01-06-2015T00:00:00

Meetperiode begindatum

Start van de meet- of verslagperiode. Als er sprake is van een peildatum moet deze datum hier worden ingevuld.

01-01-2014T00:00:00

Meetperiode einddatum

Einde van de meet- of verslagperiode. Als er sprake is van een peildatum moet deze datum hier worden ingevuld.

31-12-2014T00:00:00

Keuzeinformatie

Ja

Zorginkoopinformatie

Ja

Toezichtsinformatie

Nee

16

Interne verbeterinformatie

Ja

Omschrijving

Extra veld om informatie over de indicator te kunnen opslaan

Gegevens uit BRaM rapportage van SBG, meetinstrumenten conform project 'ROM GGZ'

Thema

Het thema waarop de indicator betrekking heeft Het komt voor dat binnen een indicatorset een extra indeling van indicatoren gewenst of nodig is.

Diagnostische MRI

Leeswijzer

Informatie over de interpretatie van de indicator en/of de indicatorwaarden

De respons zoals hier genoemd over het percentage DBC trajecten met een afsluitdatum in 2014 dat met een geldige ROM voor- en nameting is aangeleverd bij de Stichting Benchmark GGZ

Clientinformatie

Een clientvriendelijke omschrijving van de indicator (indien beschikbaar)

GeldigVan

Geldigheidsduur van de indicator; indien van toepassing en bekend

GeldigTotEnMet

Geldigheidsduur van de indicator; indien van toepassing en bekend

IndicatorEenheid

Het datatype van de indicator

Percentage, Tekst, JaNee, Getal, Aantal

IndicatorEenheidNaam

Het soort indicator

Structuur, proces of uitkomst

17

Deze codelijst voor indicatoren kan via de Transparantiekalender in Excel-formaat worden gedownload:

Figuur 11: Exporteren lijst voor indicatoren via de Transparantiekalender

U kunt kiezen voor het downloaden van alle sets, maar u kunt ook eerst een selectie maken. In Excel kan de tabel er dan bijvoorbeeld zo uit zien:

Figuur 12: Voorbeeld selectie in Excel

18

Bijlage 1 : XSD Voor gegevensaanleveringen op Zorginzicht <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" attributeFormDefault="unqualified"> <xs:element name="Organisaties"> <xs:complexType> <xs:sequence> <xs:element name="Organisatie" minOccurs="1" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element type="xs:int" name="KvkNummer" /> <xs:element type="xs:string" name="OrganisatieNaam" /> <xs:element type="xs:string" name="OrganisatiePostcode" /> <xs:element type="xs:string" name="OrganisatiePlaats" /> <xs:element type="xs:string" name="OrganisatieHuisnr" minOccurs="0" /> <xs:element type="xs:string" name="OrganisatieAGBCode" minOccurs="0"/> <xs:element name="Aanlevering"> <xs:complexType> <xs:sequence> <xs:element name="AanleverData" minOccurs="1" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element type="xs:string" name="IndicatorCode" /> <xs:element type="xs:dateTime" name="MeetperiodeBeginDatum" /> <xs:element type="xs:dateTime" name="MeetperiodeEindDatum" /> <xs:element type="xs:string" name="IndicatorWaarde" minOccurs="0"/> <xs:element type="xs:string" name="N" minOccurs="0"/> <xs:element type="xs:int" name="Teller" minOccurs="0"/> <xs:element type="xs:int" name="Noemer" minOccurs="0"/> <xs:element type="xs:boolean" name="IndicatorNvt"/> <xs:element type="xs:string" name="Opmerking" minOccurs="0"/> <xs:element type="xs:boolean" name="ExclusieNvt" minOccurs="0"/> <xs:element type="xs:boolean" name="NietBeschikbaar" minOccurs="0"/> <xs:element type="xs:float" name="GemiddeldeUitkomst" minOccurs="0"/> <xs:element type="xs:float" name="LaagsteUitkomst" minOccurs="0"/> <xs:element type="xs:float" name="HoogsteUitkomst" minOccurs="0"/> <xs:element type="xs:float" name="MiddelsteUitkomst" minOccurs="0"/> <xs:element name="OrganisatieLocatie" minOccurs="0" maxOccurs="1"> <xs:complexType> <xs:sequence> <xs:element type="xs:string" name="VestigingsNummer" minOccurs="0"/> <xs:element type="xs:string" name="LocatieNaam" /> <xs:element type="xs:string" name="LocatiePostcode" /> <xs:element type="xs:string" name="LocatiePlaats" /> <xs:element type="xs:string" name="LocatieHuisnr" minOccurs="0" /> <xs:element type="xs:string" name="LocatieAGBCode" minOccurs="0"/>

19



20

Bijlage 2: Voorbeeld XML 123456 Stichting VU-VUmc 1081HV Amsterdam 1117 12345678 IND000587 <MeetperiodeBeginDatum>2014-01-01T00:00:00 <MeetperiodeEindDatum>2014-12-31T00:00:00 98,345 123 43 78 1 Zowel de deelnemend hematoloog/internist als klinisch patholoog zijn IKNL consulent, maar nemen niet in deze rol deel aan het structureel overleg <ExclusieNvt>0 1 3.88 2.31 6.52 <MiddelsteUitkomst>3.88 7160925 VU Medisch Centrum 1081HV Amsterdam 1117 03456984

21