Aansluiten op VPI. (VolmachtBeheer Producten Interface)

Transcriptie

1 Aansluiten op VPI (VolmachtBeheer Producten Interface) Auteur : Max Wout en Bram Doveren (Colimbra) Versie : 1.1 Datum : 27 april 2009

2 Inhoudsopgave 1 Algemeen Aanleiding Doel van dit document Voordat u begint Afbakening De betrokken partijen Implementatie Keuze architectuur Globale stappen Technische realisatie Voorbeeldprogramma voor aansluiten op de Het gebruik van AFD (All Finance Datacatalogus) Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 2

3 1 Algemeen 1.1 Aanleiding Er zijn globaal zo n 300 à 400 volmachtbedrijven in Nederland. De taken van de volmachtbedrijven zijn vergelijkbaar met die van de maatschappijen, te weten: acceptatie; schadebehandeling; prolongeren; incasseren; beheer van clausules en voorwaarden; onderhoud (premies, regio s, bm-tabellen, indexcijfers etc.) Eén van de belangrijkste redenen voor het ontstaan van de meeste van deze volmachtbedrijven, is integratie van het beheer van de gehele administratie. Met andere woorden, men was niet meer afhankelijk van maatschappijen. Een volmachtbedrijf, dat beschikte over verschillende volmachten, deed daarmee aan ketenintegratie en behaalde zo een efficiencyvoordeel. Tegenwoordig is het opnemen van producten van verzekeraars in de administratie van een gevolmachtigde een tijdrovend proces. Daarnaast dient dit niet eenmaal, maar bij elke gevolmachtigde te geschieden. Ook het onderhoud hiervan geschiedt voor elke gevolmachtigde afzonderlijk. Al lang bestaat er de behoefte distributie en implementatie van nieuwe tarieven te vereenvoudigen. De VolmachtBeheer Producten Interface (VPI) realiseert een koppeling tussen de tariefmodules van de verzekeraars en de administratiepakketten van de volmachtbedrijven. Deze koppeling heeft de volgende voordelen: Rechtstreekse koppeling met de rekenboxen van de maatschappij; Nieuwe producten en tarieven zullen sneller beschikbaar zijn en kunnen daardoor eerder ingezet worden bij advies en verkoop; Invoeren en onderhouden van tariefregels zal niet meer nodig zijn; Hierdoor kostenbesparing op het gebied van beheer; Eén rekentoepassing voor zowel de back-, mid- als frontoffice (hierdoor geen verschillen meer tussen berekende premies vanuit bijvoorbeeld het offerteprogramma en het volmachtpakket). 1.2 Doel van dit document Dit document beschrijft de stappen om aan te sluiten op de VolmachtBeheer Producten Interface. De VPI standaardiseert elektronische communicatie tussen verzekeraars en gevolmachtigden en maakt daarbij gebruik van de bestaande branchestandaarden GIM (Generieke Interface Manager) en AFD (All Finance Datamodel). Partijen kunnen voor het aansluiten op de VPI daarom ook gebruik maken van de GIM Communicatie Module (). Dit is standaard koppelingssoftware die gratis beschikbaar wordt gesteld aan systeemhuizen. Dit document is geschreven voor ontwikkelaars en managers van een afdeling voor systeemontwikkeling. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 3

4 2 Voordat u begint In dit hoofdstuk worden de belangrijkste begrippen en partijen toegelicht die van toepassing zijn voor de VPI. Uiteraard is dit niet limitatief maar genoeg om het domein van de VPI in kaart te brengen. 2.1 Afbakening De VPI voorziet in een aanbieder van een toepassing cq. dienst en een partij die hier op aansluit. In de praktijk bieden verzekeraars een tarief van een product aan, via een webservice of een rekenbox, die met behulp van het VPI platform op een gelijke wijze is ontsloten voor afnemers: de intermediaire systemen. Hiermee wordt een groot deel van de bestaande volmachttarieven afgedekt. Het inbouwen van de koppelingssoftware en aansluiten op de VPI-standaard geschiedt door of in opdracht van de partij die de software voor het intermediair ontwikkeld. Hier is dan ook de afbakening gekozen voor dit document. Uiteraard kan met de meeste ontwikkelomgevingen ook rechtstreeks, zonder de SIVI koppelingsmodule te gebruiken, een koppeling gelegd worden met de tarieven van verzekeraars via de VPI. De VPI-standaard is echter in beweging zodat nieuwe ontwikkelingen ook gevolgd en ingebouwd moeten worden. Door gebruik te maken van de koppelingsmodule van SIVI wordt de inspanning geminimaliseerd. Bovendien wordt deze module gratis ter beschikking gesteld. De koppelingsmodule regelt eveneens dat afwijkingen in de koppelingen voor de aansluitende partij verdwijnen. Deze afwijkingen ontstaan veelal door afwijkingen in de ontwikkelomgevingen die ieder een eigen SOAP dialect spreken. Alle data die uitgewisseld wordt is gemodelleerd in het AFD-formaat. Dit model wordt verondersteld bekend te zijn en wordt niet nader uitgewerkt in dit document. De VPI standaard maakt voor het koppelen van afnemers (intermediair) aan tarieven van verzekeraars gebruik van de GIM-standaard. Deze standaard bestaat uit drie delen ook wel protocollen genoemd. Dit zijn de GIM-transactieservice, de GIM-resultatenservice en de GIMwebservices. Om aan te sluiten op het VPI platform is alleen de GIM-transactieservice protocol van toepassing. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 4

5 De transactieservice (GTS) dient voor het uitvoeren van transacties op het VPI platform op dit moment premieberekening. Figuur 1 GIM Transactieservice (GTS) De protocollen worden uitgebreid beschreven in de GIM protocollen gepubliceerd op de website van SIVI ( 2.2 De betrokken partijen Software leveranciers: Deze partijen maken de software waarmee het intermediair werkt en waarmee koppelingen gemaakt worden met de VPI. Intermediair: Sluit aan op de VPI, met behulp van de software van bovengenoemde leveranciers, en haalt eventueel de berichten op die klaargezet zijn door de verzekeraar. Aansluiten wil in dit geval zeggen het uitwisselen van gemeenschappelijke data en het geautomatiseerd aanroepen van de beschikbare tarieven. Maatschappijen: Bieden tarieven van producten aan die via de VPI zijn aan te roepen. SIVI: Het standaardisatie instituut voor de branche. Ontwikkelt en documenteert de standaarden en biedt standaard koppelingssoftware aan. VolmachtBeheer: Geeft de organisatie van de VPI vorm in samenwerking met verschillende branchepartijen en helpt intermediairs en verzekeraars aan te sluiten op de VPI. Colimbra: Ontwikkelt en beheert de VPI in samenwerking met VolmachtBeheer en helpt verzekeraars en software leveranciers aan te sluiten op de VPI. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 5

6 3 Implementatie De koppeling met de VPI kan op verschillende manieren gerealiseerd worden waarmee ook de wijze van aansluiten op de VPI wordt bepaald. De eerste stap is dan ook het bepalen, hoe de koppeling gerealiseerd dient te worden. 3.1 Keuze architectuur De GIM Communicatie Module () wordt gekoppeld met en aangesproken door een externe. De architectuur van die bepaalt hoe de ingezet dient te worden. De bestaat uit twee delen. Een deel wat op de cliënt geïnstalleerd kan worden en een deel dat op de server geïnstalleerd wordt. Hierdoor ontstaan drie mogelijke configuraties. Standalone Dit is de meest eenvoudige installatie. Alles wordt geïnstalleerd op één plaats. Deze installatie wordt gebruikt indien de aan te sluiten ook op de werkplek wordt geïnstalleerd en er geen centrale server beschikbaar is. client VPI Werkplek Figuur 2 - Standalone De aan te sluiten communiceert met een.net API van de Client, die op zijn beurt communiceert met de VPI. De gehele installatie dient op elke werkplek uitgevoerd te worden. Het registerbestand met daarin de aangesloten verzekeraars kan gedeeld worden in het netwerk. In dat geval staat het register centraal. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 6

7 Client- De client-server installatie minimaliseert de installatie op de werkplek. Nog steeds communiceert de aan te sluiten met een.net API van de Client. De Client communiceert vervolgens met de webservice die centraal geïnstalleerd is. Centraal wil hierbij zeggen binnen de organisatie, er is geen ondersteuning in de software voor het gebruik over meerdere organisaties. client webservice VPI Werkplek Figuur 3 Client- Op de server wordt in dit geval het register geplaatst en ook de client certificaten dienen hier te worden geïnstalleerd. Hierdoor is de installatie op de werkplek vereenvoudigd. Deze configuratie is vooral bedoeld om aan te sluiten bij s die ook werken in een clientserver architectuur. Steeds meer s zijn server-based of worden aangeboden in ASP en werken met een browserinterface. In dat geval wordt er uitsluitend gebruik gemaakt van de webservice. Communicatie met de webservice vindt plaats door middel van een aantal webservices. webservice VPI Werkplek Figuur 4 - Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 7

8 Bovenstaande configuratie wordt gebruikt als het aansluiten van de toepassing werkt met webservices in plaats van het installeren en aanspreken van de Client. Bij server-based s ligt het voor de hand om uitsluitend gebruik te maken van de webservice er is immers geen client waar eenvoudig software op geïnstalleerd kan worden. Zie onderstaande configuratie. webservice VPI Werkplek Figuur 5 - Gehost via een derde partij Er zijn ook derde partijen die een gehoste variant van de bieden, zoals APLAZA, en die kan worden ingekocht als een dienst. Het voordeel hierbij is dat er geen beheer en installatie meer plaats vindt bij het intermediair maar er gebruik gemaakt wordt van een centrale dienst van deze derde. Aangezien gebruik gemaakt wordt van dezelfde standaard interfaces is deze architectuur gelijk aan de oplossing voor het aansluiten op een server installatie. Per intermediair kan eventueel uitgemaakt worden wat de beste manier is om aan te aansluiten. VPI webservice Werkplek Derde Partij Figuur 6 Derde Partij Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 8

9 3.2 Globale stappen Wat zijn de globale stappen om aan te sluiten op het VPI-platform? Het begint met het downloaden van de software van de website van SIVI ( Ook is het verstandig om je bij VolmachtBeheer ( en Colimbra ( aan te melden via . Hierdoor weten VolmachtBeheer en Colimbra dat een partij gaat aansluiten en kan indien noodzakelijk een verzoek tot ondersteuning gedaan worden. Na het downloaden van de software dient deze nog in de juiste configuratie geïnstalleerd te worden. Hiervoor zijn handleidingen beschikbaar. Deze kunnen eveneens gedownload worden van de website van SIVI. Om te kunnen testen dient een Digitaal Paspoort (cliëntcertificaat) beschikbaar en op de juiste wijze geïnstalleerd te zijn. Het Digitaal Paspoort is verplicht bij de meeste verzekeraars. Het Digitaal Paspoort kan aangevraagd worden via website van Abz. Met behulp van het Digitaal Paspoort kan een testaccount aangevraagd worden bij SIVI voor de testserver (DKI). Hiervoor kan men een verzoek naar SIVI sturen via met daarin het adres van het certificaat. Om verbinding te kunnen maken met de testserver dient ook een registratiebericht geïnstalleerd te zijn. Ook dit registratiebericht kan worden gedownload van de website van SIVI. Hierna kan de installatie getest worden met behulp van het Test Center (GTC) en een test uitgevoerd worden met de testserver van het SIVI (DKI). Hiermee kan de correcte werking worden vastgesteld en een goed inzicht worden verkregen hoe het protocol werkt. Als de software correct is geïnstalleerd en de test met de DKI goed kan worden afgerond kan gestart worden met de ontwikkeling van de koppeling. In het volgende hoofdstuk zal hier uitgebreid op in worden gegaan. Naast het testen met de DKI kan men ook bij VolmachtBeheer een testaccount aanvragen. Hierdoor kan ook getest worden met de VPI zoals die later gebruikt gaat worden. Technisch gezien zal dit qua werking geen verschil uitmaken, daar zorgt immers de GIM-standaard voor. In de data die uitgewisseld wordt zijn wel grote verschillen, maar ook daarvoor gelden een aantal universele afspraken. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 9

10 4 Technische realisatie In dit hoofdstuk wordt dieper ingegaan op de technische realisatie van de koppeling. Voordat begonnen kan worden aan de realisatie dienen de stappen genoemd in het vorige hoofdstuk te zijn doorlopen. 4.1 Voorbeeldprogramma voor aansluiten op de Het aansluiten op de in.net techniek is beschreven in de SIVI-documentatie (GcmClientApi). Hierin wordt stap voor stap de aansluiting op de doorlopen en toegelicht met een voorbeeld programma. Dit voorbeeld programma, inclusief de broncode, is ook te downloaden van de website van SIVI. 4.2 Het gebruik van AFD (All Finance Datacatalogus) Naast het technisch aansluiten bestaat een groot deel van het werk uit de koppeling van data-elementen. Dit geldt zowel voor de data die naar de VPI gaat voor de berekening van de tarieven als de data die terugkomt uit de rekenbox van de verzekeraar. Het sjabloon dient compleet gevuld te worden omdat het bij de VPI om de onbemensde transactie gaat. Indien niet alle premiebepalende en in het sjabloon voorkomende elementen gevuld worden kan de VPI de webservices voor de tarieven niet correct afhandelen. Voor het vullen van het sjabloon zijn twee methoden: 1. De eerste methode is het dynamisch vullen van het sjabloon. Hierbij kan het hele interne datamodel worden vertaald naar een AFD-datamodel waarmee het sjabloon kan worden gevuld. In de sjablonen zitten grote verschillen maar door het dynamisch vullen is er weinig onderhoud aan de GIM koppeling. Wel dienen bij interne database wijzigingen en wijzigingen aan het AFD-datamodel ook de vertalingen te worden aangepast. 2. De tweede methode gaat uit van de sjablonen die per verzekeraar worden vertaald. De werkwijze is dan als volgt: een verzekeraar wil gekoppeld worden, vervolgens worden de sjablonen gecontroleerd en wordt programmatuur ontwikkeld die de sjablonen zo goed mogelijk vult. Deze werkwijze is eenvoudig maar onderhoudsgevoelig. Ook de combinatie van beide methoden kan worden gebruikt en tot een goed resultaat leiden. De laatste stap in de VPI-transactie is het verwerken van het door de VPI aangeboden resultaat. Het AFD-bericht dat ontvangen wordt kan op gelijke wijze worden verwerkt als de prolongatieberichten. De GIM-berichten zijn echter veel uitgebreider en bevatten meer data. De bestaande verwerking van de binnenkomende AFD-berichten dient over het algemeen dan ook te worden uitgebreid. Indien het systeem de verwerking van binnenkomende AFD-berichten nog niet ondersteund zal de realisatie uiteraard meer werk omvatten. Over het algemeen wordt het AFD-bericht aan de hand van vertaaltabellen vertaald naar de interne datastructuur. Dit zal veelal niet lukken met alleen tabellen hierbij horen ook specifieke vertaalfuncties voor de meer complexere vertalingen. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 10

11 Daarnaast is het aan te bevelen om het complete AFD-bericht op te slaan, bijvoorbeeld in een archief, zodat deze later door de gebruiker kan worden bekeken. Hiervoor dient dan wel een Viewer te worden ontwikkeld. Daarnaast kan dit AFD-bericht gebruikt worden bij het aanleveren van gegevens aan de verzekeraar. De informatie uit de polistabellen kan zo worden aangevuld met de data uit het vorige AFD-bericht. Hierdoor gaat geen informatie verloren, zodat de gebruiker geen informatie opnieuw of dubbel moet invoeren. Aansluiten op VolmachtBeheer Producten Interface (VPI) 2009 Pagina 11