AFD-definitie Standaard

De AFD-definitie Standaard zorgt ervoor dat specificaties van berichten en eventueel services niet hoeven te worden aangeleverd in Excel- of Word-documenten. Het gebruik van de AFD-definitie Standaard voorkomt fouten rond specificaties en maakt het mogelijk software (geheel) geautomatiseerd in te richten voor de afhandeling van berichten of services.

De AFD-definitie Standaard is zowel voor AFD 1.0 als AFD 2.0 te gebruiken. Een AFD-definitie specificeert vier aspecten:

1. Data: Welke gegevens zitten in een bericht?
2. Structuur: In welke structuur worden deze gegevens binnen een bericht opgenomen?
3. Validaties: Welke controles moeten worden uitgevoerd om een correct bericht te genereren?
4. Service: Hoe moet een service gebruikt worden? (Alleen AFD 2.0)

De aspecten (1) en (2) zijn gespecificeerd op basis van respectievelijk XML- en JSON-schema’s, aspect (3) op basis van respectievelijk XPath- en JMESPath-specificaties en aspect (4) op basis van OpenAPI Specification.

Het doel van het gebruik van AFD-definities is tweeledig:

1. Zorgen dat men AFD-specificaties op een eenduidige manier kan delen.
   Door uit te gaan van gangbare en wijdverspreide open standaarden met een formele syntax is geborgd dat bij juist gebruik specificaties altijd syntactisch correct zijn.
2. Zorgen dat men AFD-specificaties geautomatiseerd kan verwerken.
   Voor de gebruikte standaarden zijn veel betrouwbare libraries beschikbaar om binnen de eigen code de onderdelen van een AFD-definitie (geheel) geautomatiseerd te verwerken voor het inrichten van registratie, schermen, validaties, aanroep van services, enzovoort. Afhankelijk van de ontwikkelomgeving is er vaak een goede keuze tussen open source en betaalde libraries. Natuurlijk is het ook mogelijk om de specificaties op basis van een AFD-definitie handmatig te verwerken.

AFD-definities kan men voor heel veel doelen inzetten. Binnen SIVI AFS anticiperen we op de onderstaande drie scenario’s:

1. (Web)services
   Een service omvat de uitwisseling van gegevens tussen verschillende systemen om een actie uit te voeren. Een voorbeeld van zo’n verzoek is een API-oproep voor het berekenen van een premie. De ‘request’ bevat de gegevens op basis waarvan de premie berekend wordt. De ‘response’ bevat de berekende premie.
   Partijen kunnen AFD-definities opstellen voor hun eigen (web)services en functies. De AFD-definitie bevat een XML Schema (AFD 1.0) of JSON Schema (AFD 2.0) met de specificaties van het request- en, indien van toepassing, het response-bericht van de service. Op basis van XPath- en JMESPath-specificaties kan men aanvullend verbandscontroles voor een correct bericht opnemen. Rond de OpenAPI Specification (OAS) bestaat een omvangrijk ecosysteem, en veel partijen gebruiken deze specificatie, al dan niet geautomatiseerd, als vertrekpunt om een API in te richten en/of een testomgeving (mockserver) op te zetten. Met de AFD-definitie kunnen partijen makkelijker een service of API inrichten.
2. Gegevensopslag
   AFD-definities worden niet alleen gebruikt voor transacties, maar ook voor de registratie/opslag van gegevens in databases en (semi-)structured data-omgevingen. Hier zien we een toenemend gebruik van AFD 2.0. De AFD-definitie specificeert dan welke gegevens moeten worden opgeslagen (structuur) en welke verbanden moeten gelden (verbandscontroles). Net als in andere toepassingen vormt een AFD-structure hierbij de basis. Zo worden polisgegevens altijd opgeslagen in een policyStructure, en partijgegevens in een partyStructure. Cruciaal voor gegevensopslag – en voor het opzoeken/terugvinden van opgeslagen data – is het gebruik van sleutels (keys) en verwijzingen, waarin AFD 2.0 volledige ondersteuning biedt.
   Een bijzondere variant is de AFD-definitie kunnenAanleveren voor Uniforme Inrichting Volmachtketen (UIV). Deze AFD-definitie is niet direct gekoppeld aan de opslag van gegevens, maar specificeert wel wat je vanuit de database van een gevolmachtigde moet kunnen aanleveren aan de verzekeraar.
   Een aantal partijen gebruikt AFD-definities ook voor het vastleggen van productmodellering. Hierin bevatten de AFD-definities alle productgerelateerde gegevens: dus niet alleen dekkingen, objecten en partijen, maar ook alle condities, bm-tabellen, acceptatievragen en schermdialogen.
3. Berichtspecificaties
   Hier gaat het om de structuur en inhoud van specifieke berichten. Zo stelt SIVI de specificaties van protocollen als het NVGA Protocol op middels de AFD-definitie Standaard. Hierdoor is het voor aanbieders (verzendende partijen in het protocol) eenvoudiger om geautomatiseerd berichten op te stellen die aan het protocol voldoen. Voor verwerkers (ontvangende partijen in het protocol) is het eenvoudiger om de verwerking geautomatiseerd in te richten en binnenkomende berichten automatisch te valideren en te verwerken.

Voor het opstellen en publiceren van AFD-definities biedt SIVI de AOS-software (AFD Online Samenstellen) aan, zie de verwijzing aan de rechterkant van de pagina.

SIVI publishes all documentation in Dutch. If you want to read it in another language, please use the translation module of your browser.