SIVI AFS API-raamwerk

Met (web)services kunnen twee (computer)systemen informatie met elkaar uitwisselen. Dit kan zijn voor het opvragen van gegevens of het uitvoeren van een transactie. Bijvoorbeeld, voor een premieberekening stuurt een ‘client’ een opdracht voor premieberekening naar een ‘server’. De ‘server’ berekent de premie op basis van het ontvangen bericht en stuurt direct een antwoord met de berekende premie naar de ‘client’ terug. Voorbeelden van veelgebruikte services zijn premieberekening, acceptatie, aanvraag polis, mutatie polis en opvragen polisgegevens.

Als standaard voor het aanbieden van services heeft SIVI voor AFD 1.0 in 2004 het AFD-webservice Protocol ontwikkeld dat uitgaat van SOAP/XML. Het AFD-webservice Protocol beschrijft hoe partijen online (realtime/synchrone) services kunnen aanbieden en uitvoeren op basis van het AFD.

In 2020 heeft SIVI het SIVI AFS API-raamwerk gepubliceerd. Het doel van het SIVI AFS API-raamwerk is om functies (bijvoorbeeld premieberekening met varianten voor nieuwe polis, mutatie en prolongatie) zo onafhankelijk mogelijk van hun technische implementatie te beschrijven. De functionele eisen zijn veel constanter in de tijd dan de eisen rondom technische implementatie. De uitgewerkte voorbeelden gaan uit van AFD 2.0 en REST/JSON.

In onderstaande figuur is een kleine subset van het SIVI AFS API-raamwerk afgebeeld: hierin zie je enkele functievarianten uit het cluster ‘contract’. Elke rij in de tabel vertegenwoordigt een specifieke functievariant, met daarbij informatie over het type operatie, de AFD-structuur en technische details zoals de relevante HTTP-methode (POST, PUT, PATCH of GET), endpoints en eventuele parameters. De volledige functietabel uit het SIVI AFS API-raamwerk kent inmiddels ruim 150 van dit soort specificaties.

Zie de download onderaan deze pagina voor de volledige versie van de functietabel met alle clusters en functievarianten.

Naast het gebruik van services voor primaire processen zoals premieberekening, vergelijking, offerte, aanvraag, mutatie/beheer en claim, zien we ook services die deze processen ondersteunen. Bijvoorbeeld het raadplegen van voertuigdata, opstaldata, herstelopdrachten en dergelijke. Technisch gezien worden services ook gebruikt om (deel)systemen te koppelen. Bijvoorbeeld de koppeling tussen een polisadministratie en een extranet, of de koppeling tussen een adviestoepassing en een vergelijker.

De specificaties van een service ondersteunen we met de AFD-definitie Standaard. Binnen een AFD-definitie is het mogelijk om:

• Het request-bericht te specificeren (JSON-schema).
• Het response-bericht te specificeren (JSON-schema).
• De volledige technische specificaties van een service volgens de OpenAPI Specification standaard op te stellen.

Met behulp van AOS (AFD Online Samenstellen) kun je een AFD-definitie opstellen.