802

Aansluitdocument webservices Documentversie 1.0 Definitief 1

Aansluitdocument webservices COV VZ801/802 Documentversie 1.0 Definitief

Pagina 1 van 30


Historie Versie

Status

Auteur

Datum

Veranderingen

1.0

Definitief

Jeroen Jansen

20-apr2012

Document definitief gemaakt.

Distributie Versie

Status

Datum

Aan

1.0

Voorstel Definitief 1

04-apr-2012

Portal, Functioneel Beheer VECOZO, Systeemontwikkeling VECOZO, Werkgroep COV, Vektis, selectie software leveranciers

1.0


17-apr-2012

Portal, Functioneel Beheer VECOZO, Systeemontwikkeling VECOZO, Werkgroep COV

1.0


19-apr-2012

Portal, Functioneel Beheer VECOZO, Systeemontwikkeling VECOZO, Werkgroep COV

1.0

Definitief

20-apr-2012

Software leveranciers

1.0

Definitief

11-mei-2012

Vektis portal voor EI standaarden

Referenties REF

Naam document

WSDL Verzekeringsrecht Controleren

COVVZ801802_incoming flat.wsdl

Pagina 2 van 30


Inhoudsopgave 1

Inleiding

4

2

Communicatie

5

2.1

HTTPS

5

2.2

Certificaten

5

2.3

SOAP

5

2.3.1

Codering

5

2.3.2

Datumvelden en tijdzones

5

2.4

Niet geauthenticeerd

6

2.4.2

Niet geautoriseerd

6

Versiebeheer

COV VZ801/802 Functionaliteit 3.1

4

5

2.4.1

2.5 3

SOAP Fault

Context

COV VZ801/802 webservices

6 7 7 8

4.1

Overzicht

8

4.2

Controleren Verzekeringsrecht service

8

4.2.1

Operatie controleer

8

4.2.2

Berichtstructuur

9

4.2.3

Toelichting zoekalgoritme

16

Bijlage A WSDL endpoints per omgeving

20

Bijlage B SOAP fouten en resultaten

21

Bijlage C VZ801/802 versus VZ37/38 berichtstructuur

24

Zoekopdracht

24

Zoekresultaat

26

Bijlage D Begrippenlijst

Pagina 3 van 30

30


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 4 van 30


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> s:Sender VZ802001 Figuur 1 SOAP Fault conform SOAP 1.1

Pagina 5 van 30


<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:Body> <s:Fault> <s:Code> <s:Value>s:Sender <s:Reason> <s:Text>VZ802001 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 6 van 30


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 7 van 30


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

4.2

Paragraaf §4.2 Controleren Verzekeringsrecht service

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 8 van 30


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.

Zorgaanbieder

«WSDL» Controleren Verzekeringsrecht + Controleer(ControleerRequest) :ControleerResponse

ControleerRequest

ControleerResponse

«verplicht» - AGB-zorgverlenersoort :N2 0..1 - AGB-nummer :N6

«verplicht» - Resultaat :RetourberichtresultaatType

Een COV verzoek bestaat uit maximaal 20 zoekopdrachten. 1..20 Zoekopdracht «verplicht» - Volgnummer :N1..2 - Geboortedatum :YYYY-MM-DD - Peildatum :YYYY-MM-DD

Een zoekopdracht en zoekresultaat zijn aan elkaar te matchen door middel van het volgnummer.

«conditioneel verplicht» - BSN :N9 - Verzekerdenummer :T1..15 - Postcode :T1..8

1..20

Een COV retourbericht bestaat uit maximaal 20 zoekresultaten. Dit aantal komt altijd overeen met het aantal zoekopdrachten.,

Zoekresultaat «verplicht» - Volgnummer :N1..2 - Resultaat :ZoekresultaatType «conditioneel verplicht» - Referentie zorgaanbieder :T1..20

«optioneel» - Referentie zorgaanbieder :T1..20 - Huisnummer :N1..5 - Huisnummer toevoeging :T1..6

«enumeration» Geslacht Man Vrouw Onbekend NietGespecificeerd

Codering van het geslacht conform NEN1888: 0 = Onbekend 1 = Man 2 = Vrouw 9 = Niet gespecificeerd

«enumerati... Code geslacht 0 1 2 9

«enumeration» Soort verzekering Aanvullend AanvullendPlusTand AWBZ Basis Hoofdverzekering Tand

GeenZoekopdrachten MeerDan20Zoekopdrachten VerzoekAkkoord

«enumeration» ZoekresultaatType BSNOnbekend BSNVoldoetNietAanElfproef CombinatieBSNGeboortedatumOnbekend GeenGeldigZoekpad Gevonden GevondenPeildatumInToekomst MeerdereZoekpadenOpgegeven MeerderePersonenGevonden NietGevonden Peildatum2JaarOfOuder

0..1 Verzekerde

Een zoekresultaat bevat de gegevens van maximaal één verzekerde. In het geval er op een zoekopdracht geen verzekerden zijn gevonden of kunnen worden teruggekoppeld (bijvoorbeeld indien er meerdere verzekerden zijn gevonden), dan wordt er geen verzekerde teruggekoppeld als onderdeel van het zoekresultaat.

«enumeration» RetourberichtresultaatType

«enumeration» VerzekerderesultaatType

«verplicht» - Resultaat :VerzekerderesultaatType - Geboortedatum :YYYY-MM-DD - Geslacht :Geslacht - Code geslacht :Code geslacht - Overleden :boolean - Achternaam1 :T1..25

ActieveVerzekeringen DubbeleActieveVerzekeringenGevonden InactieveVerzekeringen

«conditioneel verplicht» - BSN :N9 - Voorletters :T1..6 - Voorvoegsel1 :T1..10 - Achternaam2 :T1..25 - Voorvoegsel2 :T1..10

1..* Verzekering

Voor een gevonden verzekerde worden 1 of meerdere bijbehorende verzekeringen teruggekoppeld.

«verplicht» - Resultaat :VerzekeringresultaatType - UZOVI :N4 «conditioneel verplicht» - Verzekerdenummer :T1..15 - Soort verzekering :Soort verzekering - Pakketcode :T1..10 - Pakketnaam :T1..50 - Labelcode :T1..10 - Labelnaam :T1..50 - Ingangsdatum :YYYY-MM-DD - Einddatum :YYYY-MM-DD

«enumeration» VerzekeringresultaatType Actief Inactief 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 9 van 30


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). Optioneel

Conditioneel

Type

Verplicht

Veldnaam

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 ).

X 

De tweede achternaam van de verzekerde.

Achternaam2

AGB-zorgverlenersoort

AGB-nummer

X 

T1..25

N2

N6

Retour-bericht: conditioneel verplicht gegeven voor de entiteit e Verzekerde, indien een 2 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 ). Eerste 2 cijfers van de 8-cijferige AGB-code. Invullen bij gebruik “impersonation”. VECOZO controleert of de aanroepende partij een toestemmingsverklaring heeft verkregen van de instantie die is aangeduid met de AGB-code in het heen-bericht.

X 

Heen-bericht: gegeven verplicht voor de entiteit Zorgaanbieder. De entiteit Zorgaanbieder moet worden opgevoerd indien er gebruik wordt gemaakt van”impersonation”.

Laatste 6 cijfers van de 8-cijferige AGB-code. Invullen bij gebruik “impersonation”. VECOZO controleert of de aanroepende partij een toestemmingsverklaring heeft verkregen van de instantie die is aangeduid met de AGB-code in het heen-bericht.

X 

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

X 

X 

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. Retour-bericht: conditioneel verplicht gegeven voor de entiteit

Pagina 10 van 30


Optioneel

Conditioneel

Type

Verplicht

Veldnaam

Toelichting

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.

X 

Einddatum van de verzekering.

Einddatum

YYYYMM-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 ).

X 

Geboortedatum van de verzekerde.

Geboortedatum

YYYY-MM-DD

Heen-bericht: verplicht gegeven voor de entiteit Zoekopdracht.

X  

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

X 

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

Pagina 11 van 30

N1..5

X 

Heen-bericht: optioneel gegeven voor de entiteit Zoekopdracht indien wordt gekozen voor het zoekpad adres.


Optioneel

Conditioneel

Huisnummer toevoeging

Type

Verplicht

Veldnaam

X 

T1..6

Toelichting

De toevoeging behorende bij het huisnummer van het woonadres. Heen-bericht: optioneel gegeven voor de entiteit Zoekopdracht indien wordt gekozen voor het zoekpad adres. Ingangsdatum van de verzekering.

Ingangsdatum

YYYYMM-DD

X 


Code van het label zoals deze is bepaald door de zorgverzekeraar.

Labelcode

X 

T1..10


Naam van het label.

Labelnaam

Overleden

Pagina 12 van 30

X 

T1..50

Boolean

X 


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. 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 ).


Optioneel

Conditioneel

Type

Verplicht

Veldnaam

Toelichting

Code van het verzekeringspakket.

Pakketcode

X 

T1..10


Naam van het verzekeringspakket.

Pakketnaam

X 

T1..50


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. verzekering

Peildatum

YYYYMM-DD

X 

Ingangsdatum: 01-01-2010 Peildatum 01-07-2009

Einddatum 31-12-2010 Peildatum 01-05-2010

Peildatum 01-02-2011

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

Pagina 13 van 30

T1..8

X 

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).


Optioneel

Conditioneel

Type

Verplicht

Veldnaam

Toelichting

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. Referentie zorgaanbieder

X 

T1..20

X 

Retour-bericht: conditioneel verplicht gegeven voor de entiteit 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

X 

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

X 

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 ).

Pagina 14 van 30


Optioneel

Conditioneel

Type

Verplicht

Veldnaam

Toelichting

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 ).

X 

Verzekerdenummer van de verzekerde. 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. Verzekerdenummer

Volgnummer

T1..15

N2

X 

X 


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.

X  

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

Pagina 15 van 30

T1..6

X 

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


Optioneel

Conditioneel

Type

Verplicht

Veldnaam

Toelichting

op het niveau van de Verzekerde (zie de beslisboom in Bijlage B ).

Eerste voorvoegsel van de verzekerde.

Voorvoegsel1

T1..10

X 

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

4.2.3

T1..10

X 

Retour-bericht: conditioneel verplicht gegeven voor de entiteit Verzekerde, indien het tweede 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 ).

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 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.

Pagina 16 van 30



Huisnummer

Postcode

X

Verzekerdenummer

X

BSN

BSN

Geboortedatum

Peildatum

Zoekpad

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 opgegeven BSN en geboortedatum.

X

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. Verzekerdenummer

X

X

X 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.

Adres

X

X

X

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 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

Pagina 17 van 30



Huisnummer

Postcode

Verzekerdenummer

BSN

Geboortedatum

Peildatum

Zoekpad

Toelichting

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

X

X

X

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

X

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

X

X

X

X

X

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.

Adres Pagina 18 van 30

X

X

X

X

Er wordt gezocht naar actieve verzekeringen (aan de hand van de peildatum wordt bepaald of een



Huisnummer

Postcode

Verzekerdenummer

BSN

Geboortedatum

Peildatum

Zoekpad

Toelichting

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. 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 19 van 30


Bijlage A WSDL endpoints per omgeving Omgeving

WSDL endpoint

Test

https://tstcovwebservice.vecozo.nl/v1/VZ801802.svc

Acceptatie

https://acccovwebservice.vecozo.nl/v1/VZ801802.svc

Productie

https://covwebservice.vecozo.nl/v1/VZ801802.svc

Pagina 20 van 30


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 1 SOAPFAULT

Omschrijving Niet geauthenticeerd Niet geautoriseerd 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.

Actief

X

ActieveVerzekeringen

BSNOnbekend

BSNVoldoetNietAanElfProef

CombinatieBSNGeboortedatumOnbekend

1

Omschrijving

De gevonden verzekering is actief op de opgegeven peildatum.

X

Er zijn één of meer actieve verzekeringen gevonden.

X

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.

X

De opgegeven BSN voldoet niet aan de elfproef.

X

De geboortedatum die is opgegeven voor het BSN klopt niet met de geboortedatum die voor het betreffende BSN bekend is in COV.

DubbeleActieveVerzekeringenGevonden

GeenGeldigZoekpad

Verzekering

Verzekerde

Zoekresultaat

Retour-bericht

Resultaat

X

X

Er zijn actieve verzekeringen gevonden en er is sprake van een dubbele actieve basisverzekering en/of dubbele actieve AWBZ verzekering. Er is geen geldig zoekpad opgegeven.

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 21 van 30


Verzekering

Verzekerde

Zoekresultaat

Retour-bericht

Resultaat

Omschrijving

Geldige zoekpaden zijn: - 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.

X

Gevonden

X

Er zijn verzekeringen gevonden naar aanleiding van een zoekopdracht.

GevondenPeildatumInToekomst

X

Er zijn verzekeringen gevonden naar aanleiding van een zoekopdracht waarbij de peildatum in de toekomst ligt.

InactieveVerzekeringen Inactief MeerDan20Zoekopdrachten

Er zijn louter inactieve verzekeringen gevonden.

X X

De gevonden verzekering is inactief. Er zijn meer dan 20 zoekopdrachten opgegeven in het heen-bericht.

X

MeerderePersonenGevonden

X

Er zijn meerdere personen gevonden die voldoen aan de zoekopdracht.

MeerdereZoekpadenOpgegeven

X

Er zijn meerdere zoekpaden tegelijkertijd opgegeven (bijvoorbeeld zowel het BSN als het verzekerdenummer is ingevuld).

NietGeautoriseerdVoorZorgverzekeraar

X

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

X

Er zijn geen verzekeringen gevonden n.a.v. de zoekopdracht.

Peildatum2JaarOfOuder

X

Er is een peildatum opgevoerd die ouder is dan 2 jaar.

VerzoekAkkoord Pagina 22 van 30

X

Het COV verzoek is akkoord en de zoekopdrachten worden uitgevoerd.


LEGENDA

Resultaat terugkoppeling niveau Retour-bericht

[technisch incorrect]

Controleer technische correctheid heen-bericht

Resultaat terugkoppeling: SOAP fout

SOAP-FAULT

[technisch correct] Start (verwerking heen-bericht)

[niet geauthenticeerd]

Controleer authenticatie

SOAP-FAULT (VZ802001)

[geauthenticeerd] Resultaat terugkoppeling niveau Zoekresultaat

Einde (retourbericht teruggekoppeld)

[niet geautoriseerd]

Controleer autorisatie


[geautoriseerd]

Systeem actie [geen impersonation] Resultaat terugkoppeling niveau Verzekerde

Resultaat terugkoppeling niveau Verzekering

[impersonation]

Einde (volgende zoekopdracht)

Controleer toestemmingsverklaring

[niet gemachtigd]

[gemachtigd]


[geen zoekopdrachten] Controleer aantal zoekopdrachten

GeenZoekopdrachten

[meer dan 20 zoekopdrachten] MeerDan20Zoekopdrachten

VerzoekAkkoord

Scope: per zoekopdracht [Peildatum 2 jaar of ouder] Controleer peildatum

Peildatum2JaarOfOuder

[meer dan 1 zoekpad opgegeven] Controleer opgave geldig zoekpad

MeerdereZoekpadenOpgegeven

[geen geldig zoekpad opgegeven] GeenGeldigZoekpad [zoekpad adres]

[zoekpad BSN]

[zoekpad verzekerdenummer]

Zoeken naar actieve verzekeringen op adres+geboortedatum

Controleer BSN elfproef

Controleer BSN bekendheid

Zoeken naar actieve verzekeringen op verzekerdenummer+geboortedatum

[voldoet niet aan elfproef] BSNVoldoetNietAanElfproef

[BSN niet bekend bij VECOZO] BSNOnbekend

[Geboortedatum klopt niet met BSN] CombinatieBSNGeboortedatumOnbekend

Controleer combinatie BSN en geboortedatum

Zoeken naar actieve verzekeringen op BSN+geboortedatum

[geen actieve verzekeringen gevonden]

Zoeken naar laatst gesloten Basis, aanvullende en AWBZ verzekeringen

[actieve verzekeringen gevonden] [Volgende zoekopdracht]

[geen verzekeringen gevonden] NietGevonden [verzekeringen gevonden]

[Meerdere personen] MeerderePersonenGevonden

Controleer op meerdere personen [één persoon gevonden]

[peildatum vandaag OF in verleden]

[peildatum in toekomst]

GevondenPeildatumInToekomst

Gevonden

[louter actieve verzekeringen]

[louter inactieve verzekeringen]

InactieveVerzekeringen

[Dubbele actieve basisverzekering EN/OF dubbele actieve AWBZ verzekering]

ActieveVerzekeringen

DubbeleActieveVerzekeringenGevonden

voor iedere gevonden verzekering

[inactief]

Inactief

[Niet geautoriseerd voor zorgverzekeraar] [Actief]

Actief

NietGeautoriseerd VoorZorgverzekeraar

[Alle zoekopdrachten uitgevoerd]

Beslisboom: resultaatbepaling COV VZ801/802

Pagina 23 van 30


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: Vervallen

Gewijzigd

Nieuw

Veld

Toelichting

Achternaam

X

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

X

Heeft geen toegevoegde waarde meer in relatie tot de ondersteunde zoekpaden.

Pagina 24 van 30


NAWVerzekerdeRetourneren

Vervallen

Gewijzigd

Nieuw

Veld

X

Toelichting

Vervalt n.a.v. niet meer terugkoppelen van adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security.

PatiëntNummer

X

Het patiëntnummer kan optioneel worden opgevoerd op het niveau van de zoekopdracht in het meer generieke veld “Referentie zorgaanbieder”.

Postcode

X

De postcode is verruimd qua aantal posities zodat ook buitenlandse postcodes in de zoekopdracht kunnen worden opgevoerd.

Soort verzekering

UZOVI-nummer

Pagina 25 van 30

X

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.

X

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.


Zoekresultaat

Figuur 7 Zoekresultaten nieuwe (VZ802) en oude (VZ38) COV standaard naast elkaar

Pagina 26 van 30


De wijzigingen die zijn aangebracht in de berichtstructuur van het zoekresultaat ten opzichte van het COV VZ38 bericht zijn toegelicht in onderstaande tabel:

Vervallen

Gewijzigd

Nieuw

Veld

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

X

Voorbeeld: AchterNaam1 Voorvoegsel1 AchterNaam2 Voorvoegsel2 Voorletters

Maas Van Graaf De J

Achternaam via VZ38 is: Maas – de Graaf

Code geslacht

X

Het geslacht van de verzekerde wordt als een code teruggekoppeld conform NEN-1888.

Geslacht

X

Geslacht wordt ten behoeve van de duidelijkheid in het zoekresultaat voluit uitgeschreven; bijvoorbeeld “Man” in plaats van 1.

Huisnummer

X

Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security.

HuisnummerToevoeging

X


LabelCode

X

Nieuw gegevenselement dat wordt teruggekoppeld als onderdeel van het zoekresultaat, n.a.v. wens werkgroep COV.

LabelNaam

X

Nieuw gegevenselement dat wordt teruggekoppeld als onderdeel van het zoekresultaat, n.a.v. wens werkgroep COV.

Landcode

PatiëntNummer Pagina 27 van 30

X

X

Vervalt n.a.v. niet meer terugkoppelen adresgegevens van een verzekerde via COV VZ801/802 in het kader van privacy&security. Het patiëntnummer wordt teruggekoppeld in het veld “Referentie zorgaanbieder” op het niveau van het


Vervallen

Gewijzigd

Nieuw

Veld

Toelichting

zoekresultaat (1 COV verzoek bevat één of meerdere COV zoekopdrachten en -resultaten).

Postcode

X


PraktijkcodeHuisarts

X

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”.

X

SoortVerzekering wordt niet meer als nummer in het zoekresultaat teruggekoppeld, maar wordt uitgeschreven; bijvoorbeeld “Basis” in plaats van “1”

SoortVerzekering

Pakketsoort (VZ802)

Mapt naar (VZ38)

Opmerkingen

Aanvullend

Aanvullend

Code 93 in VZ38 bericht.

Aanvullend+Tand

Aanvullend


AWBZ

n.v.t

Er is geen mapping voorzien voor AWBZ verzekeringen.

Basis

Basis


Hoofdverzekering

Basis


Tand

Aanvullend


X

.

Straatnaam

X


VerzekerdenNummer

X

Het verzekerdenummer wordt geschreven zonder dubbele –n.

Voorvoegsel

X

Voorvoegsel in het VZ38 bericht correspondeert met Voorvoegsel1 in het VZ802 bericht. In het VZ38 bericht is het

Pagina 28 van 30


Vervallen

Gewijzigd

Nieuw

Veld

Toelichting

e

eventuele 2 voorvoegsel van een verzekerde verwerkt in het veld Achternaam.

Woonplaats

X


ZorgverlenerscodeHuisarts

X

De zorgverlenerscode van de huisarts wordt in de “as is” situatie nooit teruggekoppeld. Daarom vervalt dit element.

Pagina 29 van 30


Bijlage D Begrippenlijst Begrip

AVG

DeclaratieUZOVI

“Impersonation”

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.

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.

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. Label

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 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

verzekering Ingangsdatum: 01-01-2010 Peildatum 01-07-2009

Einddatum 31-12-2010 Peildatum 01-05-2010

Peildatum 01-02-2011

Figuur 8 Voorbeeld werking peildatum bij zoeken naar actieve verzekeringen

SAAS

Pagina 30 van 30

Software As A Service

802

Recommend Documents