Aansluitdocument webservices COV VZ801/802



Vergelijkbare documenten
Aansluitdocument webservices. VSP-EDP Validatiemodule

Ontwerp Interfaces Zorgverzekeraar. Machtigingen

FOUTAFHANDELINGEN TIJDENS HET AANLEVEREN VAN BESTANDEN VOOR KNOOPPUNTDIENSTEN WMO EN JW

Openbare webservice diergeneeskunderegister

Aandachtspunten gebruik portalen VECOZO en SBV-Z

Ontwerp Interfaces Zorgverlener. Machtigingen

BESCHRIJVING ROLSTOELEN STANDAARD

Aandachtspunten gebruik portalen VECOZO en SBV-Z

Inleiding. Wijkverpleging Notitie. Aan. Zorgaanbieders en zorgverzekeraars Project IZA en Zorgverzekeraars Nederland. Auteur

Demonstratie Machtigingenportaal. 14 mei 2013

Invulinstructie Exceldefinitie WMO303

Veld: Zorgverlenerscode Lengte: 8 Vul in dit veld de identificerende AGB-code van de zorgverlener, indien bekend. De code bestaat uit acht cijfers.

Beslisboom voor het verwerken van retourinformatie Waar leest u het retourbericht? Webportaal VECOZO?

Retour samenloop financiering Wlz-Zvw

Machtigingenportaal. Relatiedag softwareleveranciers. 10 april 2014 VECOZO

Veld: Zorgverlenerscode Lengte: 8 Vul in dit veld de identificerende AGB-code van de zorgverlener, indien bekend. De code bestaat uit acht cijfers.

Gebruikers Handleiding Webservice Verzekering Afsluiten

Functioneel ontwerp. Omgevingsloket online. Koppeling met GBA

Invulinstructie WMO 303 bericht

Het besluit is gevallen om de optie van gelaagd aanleveren en flexibel aanleveren voorlopig uit te stellen.

Gebaseerd op het document Declaratie Overige Sectoren OS301v1.0_Restitutienota_u1.pdf van Vektis uitgave document 1,

Bijlage 3. Handleiding declareren Podotherapie PM 304

Externe integratie DECLARATIE KRAAMZORG KZ301/KZ302. INVULINSTRUCTIES [INV] Aanwijzingen bij het gebruik van het EI-bericht

Service API Specificatie. Key2Parkeren Koppelvlak Kentekenwijziging

Berichtspecificatie - JW305 (Aanvang Jeugdhulp)

Declaratie ZZP en extramurale parameters forensische zorg

Beste DAPA-gebruiker, Vanaf 2 januari 2018 gaat de DAPA-2018 live.

Invulinstructie Exceldefinitie WMO303

Het leveren en declareren van jeugdhulp

Functionele en technische meldingen

Handleiding update Wlz 2017

Preferentiebeleid IR V-1-3-1

Functioneel ontwerp. Omgevingsloket online. Koppeling met GBA

Technische handleiding encryptie DKD

Bijlage 2 Handleiding declareren logopedie 2016/2017

Beheervoorziening BSN - Use Case Specificatie 16: Toets of nummer een BSN is

Handleiding Abakus. Koppeling met MIJNfysio. Naam handleiding: Koppeling met MIJNfysio Product: Abakus Compleet Versie: 1.0

Declaratie/factuur Wmo-ondersteuning

Declaratieformat GEMEENTE SCHIERMONNIKOOG. Gemeentelijke Groene Vink

Algemene vragen U kunt met al uw vragen en het aanleveren van bestanden terecht bij de Servicedesk Dataverkeer Ketenpartners:

Handleiding declareren fysiotherapie

GEBRUIKERSHANDLEIDING Uploaden van gegevens voor Qualiview

WMO303 Excel formaat

Verzoek om Toewijzing. Handleiding Februari 2017

Bijlage 2 Handleiding declareren ergotherapie 2015 PM 304 Vrijgevestigd/AWBZ-instellingen

Declaratieformat GEMEENTE HARLINGEN. Gemeentelijke Groene Vink

Handleiding declareren dieetadvisering 2015 ZH308

Programma VISD 2014 Ketenkaart Jeugd/AZR versie mei 2014

Bijlage 2 Handleiding declareren logopedie 2017

Zorgverlenerscode voorschrijver/verwijzer of specialisme voorschrijver/verwijzer ontbreekt of is onjuist. Bij elke prestatie kunt u aangeven wie de Vo

Crediteren werkt als volgt: maak opnieuw een declaratie aan (exact hetzelfde als de originele Debet) waarbij: Alle bedragen een - teken er voor krijge

Bijlage 2 Handleiding declareren Ergotherapie 2016/2017

Bestandsbeschrijving. bestand Verwerkingsverslag

Handleiding declareren Diëtetiek

WMO307 (Wmo-BeeindigingMutatieOndersteuning)

GEBRUIKERSHANDLEIDING KNOOPPUNTDIENSTEN BERICHTUITWISSELING VIA WEBSERVICE

Bijlage 1. Handleiding declareren eerstelijns psychologie EP 301 Eerstelijns psychologen

Bijlage 1. Handleiding declareren logopedie ZH308. Ziekenhuizen/ZBC

Handleiding declareren logopedie 2017 ZH308

Externe integratie. Indicatie Wlz IW801-IW802. Invulinstructie [INV] Versie EI-standaard 1.0 Versie datum

Handleiding Zorgaanbieder module

Bijlage 1 Handleiding declareren oefentherapie Cesar/Mensendieck 2016/2017

TLN - AANLEVER- EN ONTVANGSTSPECIFICATIE VOOR WERKGEVERS Achmea ISelect VERSIE 0.1

BEP-model Wlz iwlz 1.0 versie 1.1

Declaratieprotocol Mondzorg 2015

Handleiding Validatiemodule istandaarden

Handleiding declareren Huisartsen 2019

Ontwerp Zorgadresboek

Uniforme Pensioen Aangifte (UPA)

GEBRUIKERSHANDLEIDING KNOOPPUNTDIENSTEN

Verzoek om Toewijzing. Handleiding Versie 1.0 d.d. 07 okt 2016

Externe integratie. Indicatie Wlz IW801-IW802. Invulinstructie [INV] Versie EI-standaard 1.0 Versie datum

Uniforme Pensioen Aangifte (UPA)

Werken met de Verwijsindex Rechtenrol Gebruiker

Ook voor de pedicure? Nieuwe eisen en nieuwe technieken. Een gezamenlijk initiatief van PodoFile en Melissa

Berichten uitwisselen via VECOZO. Informatie voor zorgaanbieders en gemeenten

12 De eigen bijdrage is gebaseerd op de geleverde Wlz-zorg. De eigen bijdrage is gebaseerd op de geleverde Wlz-zorg of de afgegeven beschikking.

Functionele Dataservice Beschrijving

Documentatie DHD thesauri Bijlage 1 : Uitleverformaat 2.2 Diagnosethesaurus

Excel declaratie format

WMO303 FACTSHEET BERICHTENVERKEER REGIO ZAANSTREEK- WATERLAND WMO FACTUUR/DECLARATIE

IW801-IW802v1.0_INVu5

BEP-model AWBZ AZR 3.2 v0.9 / AW319 v1.4

GEBRUIKERSHANDLEIDING Uploaden Excel bestand

Invulinstructie berichtenverkeer

ZorgMail FileTransfer Gebruikershandleiding

Invulinstructie berichtenverkeer

Handleiding declareren ergotherapie 2015 ZH308

Handleiding declareren fysiotherapie ZH308

Bijlage 2: Uniform declaratieprotocol wijkverpleging, eerstelijnsverblijf (ELV) en zorg zintuigelijk gehandicapten (ZG)

Functioneel ontwerp. Omgevingsloket online. Koppeling met BAG

Beheervoorziening BSN - Use Case Specificatie 33: Stellen Bulkvraag

Preferentiebeleid IR V-1-3-2

BIG-register Externe webservices. Title BIG-register Subject Externe webservices Version 2.3 Date Author CIBG / IV en ICT unit

Mutatieoverzicht iwlz 1.2 versie 1.1 t.o.v. iwlz 1.2 versie 1.0. Inhoudsopgave. Informatiemodel iwlz 1.2 versie 1.1.

JW315 (Verzoek om toewijzing Jeugdhulp) Berichtspecificatie - JW315 Verzoek om toewijzing Jeugdhulp. 1 Klassenview

Invulinstructie Exceldefinitie JW303

Specificaties gegevensvelden ZZP-scoreprogramma versie 1.4

Transcriptie:

Aansluitdocument webservices COV VZ801/802 Documentversie 1.0 Uitgave 4 Definitief Pagina 1 van 32

Historie Versie Status Auteur Datum Veranderingen 1.0 Uitgave 1 Definitief Jeroen Jansen 20-apr- 2012 Document definitief gemaakt. Documentatie aanpassingen (geen impact op WSDL): 1.0 Uitgave 2 Definitief Jeroen Jansen 12-jul-2012 - Tabel bijlage B aangepast, resultaat BSNOnbekend wordt teruggekoppeld op niveau van entiteit Zoekresultaat - P5 en p6: SOAP faults voorbeelden aangepast (taal die wordt gehanteerd meesturen in fault) - p12: extra toelichting bij vulling van het gegeven Overleden - nieuwe paragraaf 4.2.2.2 toegevoegd met vulregels voor de verzekerdengegevens - Bijlage B: toegelicht dat enkel 1 rol nodig is - Bijlage B: uitwerking toegevoegd van de actie zoeken naar laatst gesloten verzekeringen - Verduidelijking van begrip jongste ingangsdatum bij de vulregels in paragraaf 4.2.2.2 - Documentstatus naar Definitief 1.0 Uitgave 3 Definitief Jeroen Jansen 30-jul-2012 Documentatie aanpassing (geen impact op WSDL): - Bijlage A: SOAP 1.1 endpoints toegevoegd 1.0 Uitgave 4 Definitief Sandy Snoeren 02-nov- 2012 In 4.2.2 bij AGB-zorgverlenersoort zijn toegevoegd welke cijfers ondersteund worden en bij welke zorgverlenersoort deze behoren. Distributie Versie Status Datum Aan 1.0 Uitgave 1 Voorstel Definitief 3 19-apr-2012 Portal, Functioneel Beheer VECOZO, Systeemontwikkeling VECOZO, Werkgroep COV 1.0 Uitgave 1 1.0 Uitgave 1 1.0 Uitgave 2 1.0 Uitgave 3 1.0 Uitgave 4 Definitief 20-apr-2012 Software leveranciers Definitief 11-mei-2012 Vektis portal voor EI standaarden Definitief 12-jul-2012 Portal, software leveranciers, Vektis portal voor EI standaarden Definitief 12-jul-2012 Portal, software leveranciers, Vektis portal voor EI standaarden Definitief 02-nov-2012 Tom Schonewille Pagina 2 van 32

Referenties REF WSDL Verzekeringsrecht Controleren Naam document COVVZ801802_incoming flat.wsdl Pagina 3 van 32

Inhoudsopgave 1 Inleiding 5 2 Communicatie 6 2.1 HTTPS 6 2.2 Certificaten 6 2.3 SOAP 6 2.3.1 Codering 6 2.3.2 Datumvelden en tijdzones 6 2.4 SOAP Fault 6 2.4.1 Niet geauthenticeerd 7 2.4.2 Niet geautoriseerd 7 2.5 Versiebeheer 7 3 COV VZ801/802 Functionaliteit 8 3.1 Context 8 4 COV VZ801/802 webservices 9 4.1 Overzicht 9 4.2 Controleren Verzekeringsrecht service 9 4.2.1 Operatie controleer 9 4.2.2 Berichtstructuur 10 4.2.2.1 Vulregels 17 4.2.3 Toelichting zoekalgoritme 17 Bijlage A WSDL endpoints per omgeving 21 Bijlage B SOAP fouten en resultaten 22 Bijlage C VZ801/802 versus VZ37/38 berichtstructuur 26 Zoekopdracht 26 Zoekresultaat 28 Bijlage D Begrippenlijst 32 Pagina 4 van 32

1 Inleiding Dit document is bedoeld voor software ontwikkelaars en de afdeling Functioneel beheer VECOZO. De scope beperkt zich tot de webservice van COV VZ801/802 en richt zich op het ondersteunen bij het integreren van externe systemen met de webservice van VECOZO. Indien u extra informatie wenst, of problemen ondervindt tijdens de integratie dan kunt u contact opnemen met VECOZO. Pagina 5 van 32

2 Communicatie In dit hoofdstuk wordt de communicatie tussen VECOZO en externe partijen m.b.t. de COV VZ801/802 webservice nader beschreven. 2.1 HTTPS Als applicatieprotocol wordt gebruik gemaakt van HyperText Transfer Protocol Secure. Voor de versleuteling van de gegevens worden SSL 3.0 en TLS 1.0 ondersteund. HTTPS is een vereiste voor het gebruik van webservices van VECOZO. 2.2 Certificaten Bij de webservice communicatie tussen VECOZO en externe partijen wordt gebruik gemaakt van certificaten. De instantie die de COV VZ801/802 webservice aanroept dient te beschikken over een systeemcertificaat dat door VECOZO is uitgegeven. Dit zorgt ervoor dat het certificaat kan worden gebruikt als een digitaal paspoort waarmee de aanroepende instantie zich kan legitimeren bij VECOZO. Voor een volledige werking van het systeemcertificaat moet VECOZO als Trusted Certificate Authority bekend zijn bij de aanroepende partij. Hiervoor dient de aanroepende partij het VECOZO root certificaat te installeren. Het root certificaat kan worden gedownload via de website van VECOZO. Voor de test- en productieomgeving zijn verschillende root certificaten te downloaden. 2.3 SOAP Alle webservices die VECOZO aanbiedt ondersteunen SOAP 1.1 en SOAP 1.2. Elementen zijn qualified en attributen unqualified. In Bijlage A zijn de WSDL endpoints per omgeving vermeld. 2.3.1 Codering De berichten moeten conform UTF-8 gecodeerd worden. 2.3.2 Datumvelden en tijdzones VECOZO ontvangt bij voorkeur heen-berichten waarin de datumvelden (datum en datumtijd velden) zijn opgevoerd zonder tijdzone. VECOZO hanteert dan standaard de tijdzone van Nederland. Indien de tijdzone wél wordt opgegeven bij een datumveld, dan dient de tijdzone conform ISO8601 te worden opgegeven. VECOZO rekent de opgegeven datum terug naar de tijdzone van Nederland. VECOZO koppelt in het retour-bericht geen tijdzones terug. 2.4 SOAP Fault Als er een technische fout optreedt in een webservice van VECOZO, dan wordt er een SOAP Fault met HTTP response code 500 verstuurd naar de client. Hieronder volgen twee voorbeelden van een SOAP Fault voor SOAP 1.1 en SOAP 1.2 <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:body> <s:fault> <faultcode>s:sender</faultcode> <faultstring xml:lang="nl-nl">vz802001</faultstring> </s:fault> </s:body> </s:envelope> Figuur 1 SOAP Fault conform SOAP 1.1 Pagina 6 van 32

<s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:body> <s:fault> <s:code> <s:value>s:sender</s:value> </s:code> <s:reason> <s:text xml:lang="nl-nl">vz802001</s:text> </s:reason> </s:fault> </s:body> </s:envelope> Figuur 2 SOAP Fault conform SOAP 1.2 2.4.1 Niet geauthenticeerd Indien er geen certificaat wordt aangeboden of wanneer het certificaat verlopen is wordt de SOAP Fault met resultaatcode VZ802001 teruggekoppeld. 2.4.2 Niet geautoriseerd Indien er een geldig certificaat wordt aangeboden, terwijl de aan het certificaat gekoppelde gebruiker niet voldoende autorisaties heeft, dan wordt de SOAP Fault teruggekoppeld met resultaatcode VZ802002 of VZ802003 (afhankelijk van de situatie, zie Bijlage B SOAP fouten en resultaten). Als toch het juiste certificaat is aangeboden, dient contact op te worden genomen met VECOZO om aan de gebruiker de juiste autorisaties toe te kennen. 2.5 Versiebeheer De versie van de WSDL staat na de laatste forward slash genoemd in de targetnamespace van de WSDLdefinitie. Bij de realisatie van een nieuwe versie van de WSDL wordt het versienummer opgehoogd van bijvoorbeeld v1 naar v2. Voorbeeld: targetnamespace="http://schemas.vecozo.nl/vz801802/v1" Pagina 7 van 32

3 COV VZ801/802 Functionaliteit Dit hoofdstuk geeft een functionele beschrijving van de aangeboden webservice. 3.1 Context Figuur 3 Hieronder wordt een overzicht gegeven van de aangeboden functionaliteit. Service Korte omschrijving De service Verzekeringsrecht controleren wordt aangeroepen om één of meerdere COV (Controle Op Verzekeringsrecht) zoekopdrachten uit te zetten. Een COV zoekopdracht wordt uitgevoerd met het doel het verzekeringsrecht te achterhalen van een persoon. Verzekeringsrecht controleren Het systeem ondersteunt per zoekopdracht alleen één van de volgende zoekpaden. Meerdere zoekpaden tegelijkertijd hanteren in één zoekopdracht is niet mogelijk. peildatum, geboortedatum,bsn peildatum, geboortedatum, verzekerdenummer peildatum, geboortedatum, postcode, huisnummer, huisnummer toevoeging Bij het zoeken naar verzekeringen wordt de peildatum gebruikt om actieve verzekeringen te vinden van een verzekerde, zie Bijlage D Begrippenlijst. Één heen-bericht bevat een maximum van 20 zoekopdrachten, waarbij iedere zoekopdracht een uniek volgnummer moet hebben. Bovendien is het mogelijk per zoekopdracht een referentie mee te geven (optioneel). Er wordt direct een retourbericht gestuurd met hierin per zoekopdracht het zoekresultaat. Indien een referentie is opgevoerd voor een zoekopdracht, dan wordt deze referentie teruggekoppeld in het zoekresultaat. Pagina 8 van 32

4 COV VZ801/802 webservices 4.1 Overzicht COV VZ801/802 is gerealiseerd met gebruikmaking van één webservice die geïmplementeerd is bij VECOZO. Figuur 4 Webservice VECOZO Controleren Verzekeringsrecht Paragraaf 4.2 Controleren Verzekeringsrecht service 4.2 Controleren Verzekeringsrecht service Dit is een service die een endpoint aanbiedt waarop één of meer COV zoekopdrachten kunnen worden uitgezet bij VECOZO. De technische beschrijving van de operaties en berichtstructuur is terug te vinden in [WSDL Verzekeringsrecht Controleren]. 4.2.1 Operatie controleer Deze operatie wordt aangeroepen om één of meerdere COV zoekopdrachten uit te zetten. Per aanroep geldt een maximum van 20 zoekopdrachten. Er wordt direct een response bericht gestuurd met hierin per zoekopdracht het zoekresultaat. Zie voor mogelijke resultaten de uitleg in Bijlage B SOAP fouten en resultaten. In deze bijlage is ook een beslisboom opgenomen waaruit de totstandkoming van de fouten en resultaten kan worden herleid. Pagina 9 van 32

4.2.2 Berichtstructuur class Operatie Controleer Berichten De entiteit Zorgaanbieder is optioneel om op te voeren voor het heen-bericht. Indien er gebruik wordt gemaakt van impersonation dan moet deze entiteit wel opgevoerd worden. Het COV verzoek wordt dan uitgevoerd onder de context van de opgegeven AGB-code. «WSDL» Controleren Verzekeringsrecht + Controleer(ControleerRequest) :ControleerResponse Zorgaanbieder ControleerRequest ControleerResponse «verplicht» «verplicht» - AGB-zorgverlenersoort :N2 0..1 - Resultaat :RetourberichtresultaatType - AGB-nummer :N6 Een COV retourbericht Een COV verzoek bestaat uit maximaal Een bestaat uit maximaal 20 zoekopdrachten. zoekopdracht en 20 zoekresultaten. Dit aantal komt altijd 1..20 zoekresultaat zijn aan elkaar te 1..20 overeen met het aantal Zoekopdracht matchen door zoekopdrachten., middel van het Zoekresultaat «verplicht» volgnummer. - Volgnummer :N1..2 «verplicht» - Geboortedatum :YYYY-MM-DD - Volgnummer :N1..2 - Peildatum :YYYY-MM-DD - Resultaat :ZoekresultaatType «conditioneel verplicht» «conditioneel verplicht» - BSN :N9 - Referentie zorgaanbieder :T1..20 - Verzekerdenummer :T1..15 - Postcode :T1..8 «optioneel» - Referentie zorgaanbieder :T1..20 - Huisnummer :N1..5 0..1 - Huisnummer toevoeging :T1..6 Verzekerde «verplicht» - Resultaat :VerzekerderesultaatType Een zoekresultaat bevat de gegevens van - Geboortedatum :YYYY-MM-DD «enumeration» maximaal één verzekerde. In het geval er op - Geslacht :Geslacht Geslacht een zoekopdracht geen verzekerden zijn - Code geslacht :Code geslacht gevonden of kunnen worden teruggekoppeld Man - Overleden :boolean (bijvoorbeeld indien er meerdere verzekerden Vrouw - Achternaam1 :T1..25 zijn gevonden), dan wordt er geen verzekerde Onbekend «conditioneel verplicht» teruggekoppeld als onderdeel van het NietGespecificeerd - BSN :N9 zoekresultaat. - Voorletters :T1..6 - Voorvoegsel1 :T1..10 «enumerati... - Achternaam2 :T1..25 Codering van het Code geslacht - Voorvoegsel2 :T1..10 geslacht conform NEN- Voor een gevonden 1888: 0 verzekerde worden 1 of 0 = Onbekend 1 meerdere 1 = Man 2 1..* bijbehorende 2 = Vrouw 9 verzekeringen 9 = Niet gespecificeerd Verzekering teruggekoppeld. «verplicht» «enumeration» - Resultaat :VerzekeringresultaatType Soort verzekering - UZOVI :N4 «conditioneel verplicht» Aanvullend - Verzekerdenummer :T1..15 AanvullendPlusTand - Soort verzekering :Soort verzekering AWBZ - Pakketcode :T1..10 Basis - Pakketnaam :T1..50 Hoofdverzekering - Labelcode :T1..10 Tand - Labelnaam :T1..50 - Ingangsdatum :YYYY-MM-DD - Einddatum :YYYY-MM-DD BSNOnbekend «enumeration» ZoekresultaatType BSNVoldoetNietAanElfproef CombinatieBSNGeboortedatumOnbekend GeenGeldigZoekpa d Gevonden GevondenPeildatumInToekomst MeerdereZoekpadenOpgegeve n MeerderePersonenGevonde n NietGevonde n Peildatum2JaarOfOude r «enumeration» RetourberichtresultaatType GeenZoekopdrachten MeerDan20Zoekopdrachten VerzoekAkkoord «enumeration» VerzekerderesultaatType ActieveVerzekeringe n DubbeleActieveVerzekeringenGevonden InactieveVerzekeringen Actief Inactief «enumeration» VerzekeringresultaatType NietGeautoriseerdVoorZorgverzekeraar Figuur 5 Berichtstructuur Controleren Verzekeringsrecht. Heen-bericht (VZ801) ControleerRequest Retour-bericht (VZ802) ControleerResponse De casing of schrijfwijze van de gegevenselementen kan in de WSDL op detailniveau afwijken ten opzichte van bovenstaande figuur. Het gegevenselement Code geslacht is bijvoorbeeld geschreven in de WSDL als CodeGeslacht, zonder tussenliggende spatie. In Bijlage C VZ801/802 versus VZ37/38 berichtstructuur is een vergelijking uitgewerkt van de VZ801/802 berichtstructuur ten opzichte van de oude VZ37/38 berichtstructuur. Pagina 10 van 32

De velden uit bovenstaande figuur zijn hieronder beschreven. Met de pijlen is aangegeven of een veld betrekking heeft op het heen-bericht, het retour-bericht of beiden ( voor het heen-bericht en voor het retour-bericht). Veldnaam Type Verplicht Conditioneel Optioneel Toelichting De eerste achternaam van de verzekerde. Achternaam1 T1..25 Retour-bericht: gegeven verplicht voor de entiteit Verzekerde. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). De tweede achternaam van de verzekerde. Achternaam2 T1..25 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde, indien een 2 e achternaam bekend is voor de verzekerde volgens AVG. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). AGB-zorgverlenersoort N2 Eerste 2 cijfers van de 8-cijferige AGB-code. Invullen bij gebruik impersonation. VECOZO controleert of de aanroepende partij een toestemmingsverklaring heeft gekregen van de zorgaanbieder die is aangeduid met de AGBcode in het heen-bericht. VECOZO ondersteunt de volgende zorgverlenersoorten: 01 Huisartsen, 17 Rechtspersonen, 37 Gezondheidscentra, 76 Leveranciers hulpmiddelen, 85 Taxivervoerders, 98 Declaranten. Heen-bericht: gegeven verplicht voor de entiteit Zorgaanbieder. De entiteit Zorgaanbieder moet worden opgevoerd indien er gebruik wordt gemaakt van impersonation. AGB-nummer N6 Laatste 6 cijfers van de 8-cijferige AGB-code. Invullen bij gebruik impersonation. VECOZO controleert of de aanroepende partij een toestemmingsverklaring heeft gekregen van de instantie die is aangeduid met de AGB-code in het heen-bericht. Heen-bericht: gegeven verplicht voor de entiteit Zorgaanbieder. De entiteit Zorgaanbieder moet worden opgevoerd indien er gebruik wordt gemaakt van impersonation. BSN van de verzekerde. BSN N9 Heen-bericht: conditioneel verplicht gegeven voor de entiteit Zoekopdracht, indien er gezocht wordt op BSN en de specifieke velden voor de overige twee zoekpaden (verzekerdenummer en adres) zijn leeg gelaten. Pagina 11 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde indien de verzekerde volgens AVG een geverifieerd BSN of SOFI-nummer heeft. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). Code geslacht Enumeratie Code geslacht van de verzekerde conform NEN-1888. Zie Figuur 5 voor mogelijke waardes. Einddatum van de verzekering. Einddatum YYYY- MM-DD Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Geboortedatum van de verzekerde. Geboortedatum YYYY- -MM-DD Heen-bericht: verplicht gegeven voor de entiteit Zoekopdracht. Retour-bericht: verplicht gegeven voor de entiteit Verzekerde. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). Geslacht van de verzekerde. Zie Figuur 5 voor mogelijke waardes. Geslacht Enumeratie Retour-bericht: verplicht gegeven voor de entiteit Verzekerde. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). Huisnummer van het woonadres. Huisnummer N1..5 Heen-bericht: optioneel gegeven voor de entiteit Zoekopdracht indien wordt gekozen voor het zoekpad adres. Huisnummer toevoeging T1..6 De toevoeging behorende bij het huisnummer van het woonadres. Heen-bericht: optioneel gegeven voor de entiteit Zoekopdracht indien wordt gekozen voor het zoekpad adres. Pagina 12 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting Ingangsdatum van de verzekering. Ingangsdatum YYYY- MM-DD Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Code van het label zoals deze is bepaald door de zorgverzekeraar. Labelcode T1..10 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Naam van het label. Labelnaam T1..50 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Indicatie (true of false) of de persoon is overleden. De overleden indicatie die wordt teruggekoppeld heeft geen directe relatie met de peildatum die is opgegeven in de Zoekopdracht Overleden Boolean Retour-bericht: verplicht gegeven voor de entiteit Verzekerde. Het systeem controleert per van toepassing zijnde actieve verzekering én inactieve verzekering vóór de peildatum of er sprake is van een overleden verzekerde. Indien het systeem eenmaal constateert dat de betreffende persoon is overleden, dan wordt het veld Overleden gevuld bij terugkoppeling van de entiteit Verzekerde. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ).. Code van het verzekeringspakket. Pakketcode T1..10 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. Pagina 13 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Naam van het verzekeringspakket. Pakketnaam T1..50 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Te gebruiken peildatum voor de zoekopdracht. Op basis van de peildatum wordt er gezocht naar actieve verzekeringen. In onderstaande figuur wordt er een voorbeeld gegeven van een verzekering die als actief wordt gevonden bij een peildatum 01-05-2010, terwijl bij de overige peildatums geen actieve verzekering zal worden gevonden. Peildatum YYYY- MM-DD De peildatum mag zowel in het verleden als in de toekomst liggen. Een peildatum in het verleden mag maximaal 2 jaar in het verleden liggen. Het begrip peildatum is uitgebreider toegelicht in Bijlage D Begrippenlijst. Heen-bericht: verplicht gegeven voor de entiteit Zoekopdracht. (Internationale) postcode van het woonadres. Postcode T1..8 Heen-bericht: conditioneel verplicht gegeven voor de entiteit Zoekopdracht, indien er gezocht wordt op adres (de specifieke velden voor de twee overige zoekpaden (BSN en verzekerdenummer) worden dan niet gevuld). Referentie zorgaanbieder T1..20 Referentie van de zorgaanbieder op het niveau van de zoekopdracht. Deze referentie wordt ongewijzigd teruggestuurd in het retour-bericht in het zoekresultaat. Hierin kan bijvoorbeeld de patiënt identificatie worden ingevuld. Heen-bericht: optioneel gegeven voor de entiteit Zoekopdracht. Retour-bericht: conditioneel verplicht gegeven voor de entiteit Pagina 14 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting Zoekresultaat, indien in het heen-bericht de referentie zorgaanbieder is opgegeven. De entiteit Zoekresultaat wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van het Zoekresultaat (zie de beslisboom in Bijlage B ). Het resultaat op het niveau van het gehele retourbericht, zoekresultaat, de verzekerde en de verzekering. Zie Bijlage B SOAP fouten en resultaten voor een overzicht van alle mogelijke resultaten op de verschillende niveaus. In de bijlage is ook een beslisboom opgenomen waaruit blijkt wanneer welke fout of resultaat wordt teruggekoppeld. Resultaat Enumeratie Retour-bericht: verplicht gegeven voor de entiteiten ControleerResponse, Zoekresultaat, Verzekerde en Verzekering. Het terugkoppelen van een resultaat op een bepaald niveau (bijvoorbeeld het resultaat InactieveVerzekeringen onder de entiteit Verzekerde) impliceert de terugkoppeling van de entiteit zelf. De beslisboom in Bijlage B beschrijft wanneer welk resultaat op welk niveau wordt teruggekoppeld. De soort verzekering, bijvoorbeeld Basis of AWBZ. Zie Figuur 5 voor mogelijke waardes. Soort verzekering Enumeratie Verschillende combinaties van soorten verzekeringen (bijvoorbeeld een basisverzekering én een AWBZ verzekering) kunnen worden teruggekoppeld in één zoekresultaat. Het is logisch dat bepaalde typen verzekeringen in combinatie voorkomen (bijvoorbeeld een basisverzekering en een AWBZ verzekering), maar dit hoeft niet per sé en hangt helemaal af van de verzekerdegegevens die de verzekeraars aanleveren via AVG. Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Declaratie-UZOVI van de zorgverzekeraar van de bijbehorende verzekering. UZOVI N4 Retour-bericht: verplicht gegeven voor de entiteit Verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Pagina 15 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting Verzekerdenummer van de verzekerde. Verzekerdenummer T1..15 Heen-bericht: conditioneel verplicht gegeven voor de entiteit Zoekopdracht, indien er gezocht wordt op Verzekerdenummer en de specifieke velden voor de overige twee zoekpaden (BSN en adres) zijn leeg gelaten. Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekering, indien de gebruiker geautoriseerd is te COV-en voor de bijbehorende UZOVI van de gevonden verzekering. De entiteit Verzekering wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekering (zie de beslisboom in Bijlage B ). Volgnummer N2 Iedere zoekopdracht in het heen-bericht wordt voorzien van een uniek volgnummer. Er geldt een maximum van 20 zoekopdrachten per heen-bericht. Het volgnummer uit het heen-bericht wordt overgenomen in het retour-bericht, zodat de ontvangende partij de zoekresultaten kan matchen aan de zoekopdrachten. Heen-bericht: verplicht gegeven voor de entiteit Zoekopdracht. Retour-bericht: verplicht gegeven voor de entiteit Zoekresultaat. De entiteit Zoekresultaat wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van het Zoekresultaat (zie de beslisboom in Bijlage B ). Voorletters van de verzekerde. Voorletters T1..6 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde, indien de voorletters bekend zijn voor de verzekerde volgens AVG. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). Eerste voorvoegsel van de verzekerde. Voorvoegsel1 T1..10 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde, indien het eerste voorvoegsel bekend is voor de verzekerde volgens AVG. De entiteit Verzekerde wordt teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). Tweede voorvoegsel van de verzekerde. Voorvoegsel2 T1..10 Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde, indien het tweede voorvoegsel bekend is voor de verzekerde volgens AVG. De entiteit Verzekerde wordt Pagina 16 van 32

Veldnaam Type Verplicht Conditioneel Optioneel Toelichting teruggekoppeld indien er een resultaat wordt teruggekoppeld op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ). 4.2.2.1 Vulregels ID Omschrijving VR1 De velden BSN, geboortedatum, Geslacht, Code Geslacht, Achternaam1, Achternaam2, Voorvoegsel1, Voorvoegsel2 (entiteit Verzekerde) worden gevuld en herleid in onderstaande volgorde op basis van: a. De actieve basisverzekering b. De actieve hoofdverzekering c. De actieve AWBZ verzekering d. De actieve verzekering met de jongste ingangsdatum van één van de volgende soorten: Aanvullend, AanvullendPlusTand, Tand. De "jongste" ingangsdatum is de ingangsdatum die het dichtste bij het heden ligt. Indien er in (a), (b), (c) of (d) sprake is van meerdere actieve verzekeringen (bijvoorbeeld 2 actieve basisverzekeringen), dan wordt de verzekering gebruikt met de jongste ingangsdatum om de genoemde verzekerdengegevens terug te koppelen. Voorbeeld: Indien verzekerde A een basisverzekering heeft bij Achmea en een aanvullende verzekering bij CZ, dan worden de verzekerdengegevens gebruikt die Achmea heeft aangeleverd. Indien er enkel inactieve verzekeringen worden teruggekoppeld, dan worden de bijbehorende verzekerdengegevens (entiteit Verzekerde: BSN, geboortedatum, Geslacht, Code Geslacht, Achternaam1, Achternaam2, Voorvoegsel1, Voorvoegsel2) gevuld en herleid in onderstaande volgorde op basis van: a. De gevonden basisverzekering b. De gevonden hoofdverzekering VR2 Toelichting: indien geen inactieve basis of hoofdverzekering worden gevonden, dan wordt het resultaat "NietGevonden" teruggekoppeld (zie Bijlage B, p26). Indien er in (a) en (b) sprake is van meerdere gevonden verzekeringen (bijvoorbeeld 2 basisverzekeringen), dan wordt de verzekering gebruikt met de jongste ingangsdatum om de verzekerdengegevens terug te koppelen. De "jongste" ingangsdatum is de ingangsdatum die het dichtste bij het heden ligt. 4.2.3 Toelichting zoekalgoritme Het systeem ondersteunt per zoekopdracht alleen één van de volgende zoekpaden. Meerdere zoekpaden tegelijkertijd hanteren in één zoekopdracht is niet mogelijk. peildatum, geboortedatum,bsn peildatum, geboortedatum, verzekerdenummer Pagina 17 van 32

peildatum, geboortedatum, postcode, huisnummer, huisnummer toevoeging Er wordt standaard gezocht naar actieve verzekeringen van één uniek persoon, conform de beslisboom in Bijlage B. Voor alle zoekpaden zijn de peildatum en geboortedatum verplicht om op te geven in de zoekopdracht. In onderstaande tabel zijn de verschillende zoekpaden nader toegelicht. Met kruisjes is aangegeven welke velden verplicht zijn om te gebruiken voor een specifiek zoekpad. Zoekpad Peildatum Geboortedatum BSN Verzekerdenummer Postcode Huisnummer Huisnummer toevoeging Toelichting BSN Verzekerdenummer Adres Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van de opgegeven BSN en geboortedatum. Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van het opgegeven verzekerdenummer en geboortedatum. Alleen verzekeringen met het opgegeven verzekerdenummer worden teruggekoppeld. Voorbeeld: Piet Jansen, heeft een basisverzekering bij Univé met verzekerdenummer 1234 en een aanvullende verzekering bij Zilveren Kruis Achmea met verzekerdenummer 5678. Indien er wordt gezocht met verzekerdenummer 1234, dan wordt alleen de verzekering van Piet Jansen bij Univé teruggekoppeld. Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van louter de geboortedatum en postcode, ongeacht de waardes die volgens COV bekend zijn voor de velden huisnummer en huisnummer toevoeging. Verzekerdegegevens worden teruggekoppeld conform de beslisboom in Bijlage B. De kans is hier groot dat er meerdere personen worden gevonden waardoor het resultaat MeerderePersonenGevonden (Bijlage B ) wordt teruggekoppeld. Voorbeeld: Verzekerde Piet Jansen (geboortedatum 7 juli 1977), met postcode 1234AB en huisnummer 10, wordt gevonden door het zoekalgoritme als er gezocht wordt op louter postcode 1234AB. De verzekeringen van Piet worden teruggekoppeld omdat Piet de enige persoon is met postcode 1234AB en geboortedatum 7 juli 1977. Voorbeeld 2: Verzekerde Lianne Jansen (geboortedatum 26 juli 1981), met postcode 1234AB en Pagina 18 van 32

Zoekpad Peildatum Geboortedatum BSN Verzekerdenummer Postcode Huisnummer Huisnummer toevoeging Toelichting huisnummer 10, wordt gevonden door het zoekalgoritme als er gezocht wordt op louter postcode 1234AB. Echter, het resultaat MeerderePersonenGevonden (Bijlage B ) wordt teruggekoppeld, omdat er nog een andere verzekerde (woonachtig op huisnummer 12) is gevonden met postcode 1234AB en geboortedatum 26 juli 1981. Om toch de verzekeringen van Lianne als resultaat terug te krijgen zal er hier gezocht moeten worden op het volledige adres, inclusief huisnummer zodat er geen meerdere personen worden gevonden. Adres Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van de geboortedatum, postcode en het huisnummer, ongeacht de waarde die volgens COV bekend is voor de huisnummer toevoeging. Een verzekerde waarvoor in COV een huisnummer toevoeging bekend is (behorend bij het huisnummer), wordt op deze manier toch gevonden door het zoekalgoritme Voorbeeld: Verzekerde Piet Jansen, met postcode 1234AB, huisnummer 10, huisnummer toevoeging AB, wordt gevonden door het zoekalgoritme als er gezocht wordt op postcode 1234AB en huisnummer 10. Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van de geboortedatum, postcode, huisnummer en huisnummer toevoeging. Het zoekalgoritme zoekt naar een verzekerde waarbij het adres precies matcht met de zoekopdracht. Adres Voorbeeld: Verzekerde Piet Jansen (geboortedatum 7 juli 1977), met postcode 1234AB, huisnummer 10, huisnummer toevoeging AB, wordt gevonden door het zoekalgoritme als er gezocht wordt op geboortedatum 7 juli 1977, postcode 1234AB, huisnummer 10 en huisnummer toevoeging AB. Voorbeeld 2: Verzekerde Piet Jansen (geboortedatum 7 juli 1977), met postcode 1234AB, huisnummer 10, huisnummer toevoeging AB, wordt NIET gevonden door het zoekalgoritme als er gezocht wordt op geboortedatum 7 juli 1977, postcode 1234AB, huisnummer 10 en huisnummer toevoeging CD. Pagina 19 van 32

Zoekpad Peildatum Geboortedatum BSN Verzekerdenummer Postcode Huisnummer Huisnummer toevoeging Toelichting Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een verzekering actief is, zie Bijlage D ) op basis van de geboortedatum, postcode en huisnummer toevoeging, ongeacht de waarde die volgens COV bekend is voor het huisnummer. Adres Voorbeeld: Verzekerde Piet Jansen (geboortedatum 7 juli 1977), met postcode 1234AB, geen huisnummer, huisnummer toevoeging ABC, wordt gevonden door het zoekalgoritme als er gezocht wordt op geboortedatum 7 juli 1977, postcode 1234AB en huisnummer toevoeging ABC. Voorbeeld 2: Verzekerde Sjaak Jansen (geboortedatum 7 juli 1950), met postcode 1234AB, geen huisnummer, huisnummer toevoeging ABC, wordt NIET gevonden door het zoekalgoritme als er gezocht wordt op geboortedatum 7 juli 1950, postcode 1234AB en huisnummer toevoeging ABCD. Voorbeeld 3: Verzekerde Eveline Jansen (geboortedatum 26 juni 1979), met postcode 1234AB, huisnummer 20, huisnummer toevoeging ABC, wordt gevonden door het zoekalgoritme als er gezocht wordt op geboortedatum 26 juni 1979, postcode 1234AB en huisnummer toevoeging ABC. Pagina 20 van 32

Bijlage A WSDL endpoints per omgeving Omgeving SOAP versie WSDL endpoint Test 1.1 https://tstcovwebservice.vecozo.nl/v1/vz801802.svc/soap11 Test 1.2 https://tstcovwebservice.vecozo.nl/v1/vz801802.svc Acceptatie 1.1 https://acccovwebservice.vecozo.nl/v1/vz801802.svc/soap11 Acceptatie 1.2 https://acccovwebservice.vecozo.nl/v1/vz801802.svc Productie 1.1 https://covwebservice.vecozo.nl/v1/vz801802.svc/soap11 Productie 1.2 https://covwebservice.vecozo.nl/v1/vz801802.svc Pagina 21 van 32

Bijlage B SOAP fouten en resultaten De onderstaande fouten worden teruggekoppeld d.m.v. een SOAP fout. In onderstaande tabel zijn de mogelijke SOAP fouten opgenomen die voor kunnen komen binnen COV VZ801/802. SOAPFAULT code VZ802001 VZ802002 VZ802003 VZ802999 SOAPFAULT 1 Omschrijving Niet geauthenticeerd Niet geautoriseerd (een gebruiker heeft enkel de rol COV Raadpleger verzekeringsrecht VZ801802 webservice nodig) Geen toestemmingsverklaring impersonation voor opgegeven AGB-code Onbekende technische fout Heen-bericht technisch incorrect Functionele resultaten worden teruggekoppeld als onderdeel van de response van het retour-bericht. Onderstaande tabel geeft een overzicht van alle mogelijke resultaten. Met de kruisjes is aangegeven op welk niveau binnen het retour-bericht een resultaat wordt teruggekoppeld. Resultaat Retour-bericht Zoekresultaat Verzekerde Verzekering Omschrijving Actief De gevonden verzekering is actief op de opgegeven peildatum. ActieveVerzekeringen Er zijn één of meer actieve verzekeringen gevonden. BSNOnbekend De opgegeven BSN is niet bekend binnen COV. Dit resultaat kan worden teruggekoppeld voor een verzekerde met een BSN die door geen enkele verzekeraar ten behoeve van COV is aangeleverd via AVG. BSNVoldoetNietAanElfProef De opgegeven BSN voldoet niet aan de elfproef. CombinatieBSNGeboortedatumOnbekend De geboortedatum die is opgegeven voor het BSN klopt niet met de geboortedatum die voor het betreffende BSN bekend is in COV. DubbeleActieveVerzekeringenGevonden Er zijn actieve verzekeringen gevonden en er is sprake van een dubbele actieve basisverzekering en/of dubbele actieve AWBZ verzekering. GeenGeldigZoekpad Er is geen geldig zoekpad opgegeven. Geldige zoekpaden zijn: 1 In het geval dat het heen-bericht technisch incorrect is stuurt VECOZO een SOAPFAULT terug naar de zendende partij waaruit blijkt welk gedeelte uit het heen-bericht niet correct is. Er is gekozen om voor deze situatie géén vaste resultaatcode te gebruiken. Pagina 22 van 32

Resultaat Retour-bericht Zoekresultaat Verzekerde Verzekering Omschrijving - Peildatum + BSN + geboortedatum - Peildatum + Verzekerdenummer + geboortedatum - Peildatum + Adres (postcode, huisnummer en eventueel huisnummer toevoeging) + geboortedatum GeenZoekopdrachten Er zijn in het heen-bericht geen zoekopdrachten opgegeven. Gevonden Er zijn verzekeringen gevonden naar aanleiding van een zoekopdracht. GevondenPeildatumInToekomst Er zijn verzekeringen gevonden naar aanleiding van een zoekopdracht waarbij de peildatum in de toekomst ligt. InactieveVerzekeringen Er zijn louter inactieve verzekeringen gevonden. Inactief De gevonden verzekering is inactief. MeerDan20Zoekopdrachten Er zijn meer dan 20 zoekopdrachten opgegeven in het heen-bericht. MeerderePersonenGevonden MeerdereZoekpadenOpgegeven Er zijn meerdere personen gevonden die voldoen aan de zoekopdracht. Er zijn meerdere zoekpaden tegelijkertijd opgegeven (bijvoorbeeld zowel het BSN als het verzekerdenummer is ingevuld). NietGeautoriseerdVoorZorgverzekeraar Er is een verzekering gevonden waarvoor de gebruiker niet geautoriseerd is om de details van in te zien. In dit geval wordt enkel de UZOVI van de verzekering teruggekoppeld zodat duidelijk is voor welke UZOVI de gebruiker geen autorisatie heeft. NietGevonden Peildatum2JaarOfOuder Er zijn geen verzekeringen gevonden n.a.v. de zoekopdracht. Er is een peildatum opgevoerd die ouder is dan 2 jaar. VerzoekAkkoord Het COV verzoek is akkoord en de zoekopdrachten worden uitgevoerd. In de onderstaande diagrammen op de volgende pagina s is aangegeven hoe het systeem de resultaten bepaalt. Pagina 23 van 32

Pagina 24 van 32

Het onderstaande diagram is de uitwerking van de actie Zoeken naar laatst gesloten verzekeringen. Deze actie staat in de bovenstaande beslisboom. Pagina 25 van 32

Bijlage C VZ801/802 versus VZ37/38 berichtstructuur In deze bijlage wordt de COV VZ801/802 berichtstructuur vergeleken met de as is VZ37/38 berichtstructuur, door de functioneel belangrijkste entiteiten uit het heen- en retour-bericht naast elkaar te zetten. Zoekopdracht Figuur 6 Zoekopdrachten nieuwe (VZ801) en oude (VZ37) COV standaard naast elkaar De wijzigingen die zijn aangebracht in de berichtstructuur van de zoekopdracht ten opzichte van het COV VZ37 bericht zijn toegelicht in onderstaande tabel: Veld Nieuw Gewijzigd Vervallen Toelichting Achternaam Vervalt n.a.v. het niet meer kunnen zoeken op de naam van een verzekerde via COV VZ801/802 in het kader van privacy&security. Geslacht Heeft geen toegevoegde waarde meer in relatie tot de ondersteunde zoekpaden. NAWVerzekerdeRetourneren Vervalt n.a.v. niet meer terugkoppelen van adresgegevens van een verzekerde via COV VZ801/802 in het kader van Pagina 26 van 32

Veld Nieuw Gewijzigd Vervallen Toelichting privacy&security. PatiëntNummer Het patiëntnummer kan optioneel worden opgevoerd op het niveau van de zoekopdracht in het meer generieke veld Referentie zorgaanbieder. Postcode De postcode is verruimd qua aantal posities zodat ook buitenlandse postcodes in de zoekopdracht kunnen worden opgevoerd. Soort verzekering Vervalt n.a.v. wens werkgroep COV om het systeem zo simpel mogelijk te houden en standaard alle soorten verzekeringen terug te koppelen van de gevonden verzekerde. UZOVI-nummer Vervalt n.a.v. wens werkgroep COV. Dit element bestond om een zoekopdracht te routeren naar de juiste verzekeraar. Hiervan is geen sprake meer sinds de komst van AVG, waarbij alle verzekeraars hun verzekerdegegevens aanleveren bij VECOZO. Pagina 27 van 32

Zoekresultaat Figuur 7 Zoekresultaten nieuwe (VZ802) en oude (VZ38) COV standaard naast elkaar Pagina 28 van 32

De wijzigingen die zijn aangebracht in de berichtstructuur van het zoekresultaat ten opzichte van het COV VZ38 bericht zijn toegelicht in onderstaande tabel: Veld Nieuw Gewijzigd Vervallen Toelichting Achternaam is opgesplitst in Achternaam1, Achternaam2 en Voorvoegsel2 omdat dit in lijn is met AVG. De ontvanger van het retour-bericht kan vervolgens de naamgegevens naar wens presenteren. In het VZ38 bericht wordt de Achternaam als volgt opgebouwd: AchterNaam1 - Voorvoegsel2 AchterNaam2 Achternaam Voorbeeld: AchterNaam1 Voorvoegsel1 AchterNaam2 Voorvoegsel2 Voorletters Maas Van Graaf De J Achternaam via VZ38 is: Maas de Graaf Code geslacht Geslacht Het geslacht van de verzekerde wordt als een code teruggekoppeld conform NEN-1888. Geslacht wordt ten behoeve van de duidelijkheid in het zoekresultaat voluit uitgeschreven; bijvoorbeeld Man in plaats van 1. Huisnummer HuisnummerToevoeging Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. LabelCode LabelNaam Nieuw gegevenselement dat wordt teruggekoppeld als onderdeel van het zoekresultaat, n.a.v. wens werkgroep COV. Nieuw gegevenselement dat wordt teruggekoppeld als onderdeel van het zoekresultaat, n.a.v. wens werkgroep COV. Landcode Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. PatiëntNummer Het patiëntnummer wordt teruggekoppeld in het veld Referentie zorgaanbieder op het niveau van het zoekresultaat (1 COV verzoek bevat één of meerdere COV Pagina 29 van 32

Veld Nieuw Gewijzigd Vervallen Toelichting zoekopdrachten en -resultaten). Postcode Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. PraktijkcodeHuisarts De praktijkcode van de huisarts wordt in de as is situatie nooit teruggekoppeld. Daarom vervalt dit element. ResultaatcodeCOV Het resultaat wordt niet meer als code teruggekoppeld maar wordt uitgeschreven; bijvoorbeeld NietGevonden in plaats van 6415. SoortVerzekering wordt niet meer als nummer in het zoekresultaat teruggekoppeld, maar wordt uitgeschreven; bijvoorbeeld Basis in plaats van 1 Pakketsoort (VZ802) Mapt naar (VZ38) Opmerkingen Aanvullend Aanvullend Code 93 in VZ38 bericht. Aanvullend+Tand Aanvullend Code 93 in VZ38 bericht. SoortVerzekering AWBZ n.v.t Er is geen mapping voorzien voor AWBZ verzekeringen. Basis Basis Code 92 in VZ38 bericht. Hoofdverzekering Basis Code 92 in VZ38 bericht. Tand Aanvullend Code 93 in VZ38 bericht.. Straatnaam Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. VerzekerdenNummer Voorvoegsel Pagina 30 van 32 Het verzekerdenummer wordt geschreven zonder dubbele n-. Voorvoegsel in het VZ38 bericht correspondeert met Voorvoegsel1 in het VZ802 bericht. In het VZ38 bericht is het

Veld Nieuw Gewijzigd Vervallen Toelichting eventuele 2 e voorvoegsel van een verzekerde verwerkt in het veld Achternaam. Woonplaats Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. ZorgverlenerscodeHuisarts De zorgverlenerscode van de huisarts wordt in de as is situatie nooit teruggekoppeld. Daarom vervalt dit element. Pagina 31 van 32

Bijlage D Begrippenlijst Begrip AVG Omschrijving AVG staat voor Aanlevering Verzekerden Gegevens. Zorgverzekeraars gebruiken AVG om dagelijks complete afslagen van hun verzekerdenadministratie aan te leveren bij VECOZO. VECOZO verwerkt vervolgens deze gegevens ten behoeve van verschillende doeltoepassingen waaronder COV. Declaratie- UZOVI Impersonation Het UZOVI dat gebruikt moet worden voor het declareren. Impersonation betreft het uitzetten van COV zoekopdrachten door een derde partij (bijvoorbeeld een software leverancier), namens een bepaalde zorgaanbieder. Zo moet een zorgaanbieder een SAAS softwareleverancier een toestemmingsverklaring verstrekken om COV namens de zorgaanbieder uit te voeren. Dit is een vorm van impersonation met toestemmingsverklaring. Label Een label is een merknaam of organisatie die verzekerden in beheer heeft. Een label valt altijd onder een zorgverzekeraar, waarbij een aparte naam wordt gehanteerd naar de buitenwereld (bijvoorbeeld verzekerden) toe. Een label wordt geïdentificeerd aan de hand van de labelcode en labelnaam. Voorbeeld: De zorgverzekeraar Univé voert drie labels, namelijk Univé, ZEKUR en ZORGZ. De zorgverzekeraar de Friesland voert twee labels, namelijk DFZ en Kiemer. Er wordt standaard gezocht naar een verzekerde met actieve verzekeringen op basis van de opgegeven peildatum in de zoekopdracht. Een verzekering is actief als: de ingangsdatum van de verzekering vóór of op de peildatum ligt de einddatum van de verzekering ná of op de peildatum ligt Peildatum In onderstaande figuur wordt er een voorbeeld gegeven van een verzekering die als actief wordt gevonden bij een peildatum 01-05-2010, terwijl bij de overige peildatums geen actieve verzekering zal worden gevonden. Figuur 8 Voorbeeld werking peildatum bij zoeken naar actieve verzekeringen SAAS Software As A Service Pagina 32 van 32