Technische documentatie van berichtenverkeer via ISA-Stekker

Technische documentatie van berichtenverkeer via ISA-Stekker

Samenvatting (Nederlands)

De technische documentatie beschrijft de ISA-webservices voor Roy-data 2.0, gebruikt voor het uitwisselen van royementsgegevens tussen verzekeraars. Er zijn drie typen transactionele bevragingen mogelijk: standaard, V2 en ZI (Zelf Interpreteren). Elke variant maakt gebruik van XML SOAP-berichten en volgt de ISA-structuur van Stichting EPS.

Hoofdstukken in de documentatie:

  • Endpoints: Demo- en productieomgevingen zijn gespecificeerd.

  • Autorisatie: Toegang is uitsluitend mogelijk met een clientcertificaat.

  • Berichtdefinities: Gelijk aan Roy-data 1.0. Zie bijlage “Berichtdefinities Roy-data 20140418.pdf”.

  • Webservices:

    • ROYDATA-TRANSACTION(-V2/-ZI) – voor opvragen van gegevens. (Transactionele bevraging – Response V2 = end of life)

    • ROYDATA-ANNULEREN – voor annuleren van bevragingen.

    • ROYDATA-INGEBRUIKNEMEN – om gegevens in gebruik te nemen.

    • ROYDATA-VRIJGEVEN – om gebruiksrechten vrij te geven.

  • Voorbeeldberichten: Voor elke functionaliteit zijn voorbeeld XML’s bijgevoegd.

Meegeleverde bestanden (ZIP-bijlage):

  • XSD’s: voor validatie van berichtenstructuren.

  • WSDL’s: voor servicebeschrijvingen.

  • Voorbeeld-XML’s: voorbeeldverzoeken en -antwoorden per service.

  • SOAP-UI projecten: per bevragingsvariant klaar voor testen.

Summary (English)

This technical documentation outlines the ISA-based web services for Roy-data 2.0, which facilitate the secure exchange of policy termination data between Dutch insurers. The services are SOAP-based and support three types of transactional queries: standard, V2, and ZI (self-interpretable).

Main components of the documentation:

  • Endpoints: Demo and production URLs are defined.

  • Authorization: Requires a valid client certificate.

  • Message definitions: Identical to Roy-data 1.0. Refer to the attachment “Berichtdefinities Roy-data 20140418.pdf”.

  • Web Services:

    • ROYDATA-TRANSACTION(-V2/-ZI) – for querying data. (Transactionele bevraging – Response V2 = end of life)

    • ROYDATA-ANNULEREN – to cancel a query.

    • ROYDATA-INGEBRUIKNEMEN – to activate retrieved records.

    • ROYDATA-VRIJGEVEN – to release ownership.

  • Example messages: Request/response XMLs are provided for each interaction.

Included files (ZIP attachment):

  • XSD files: schema validation.

  • WSDL files: service contracts.

  • XML examples: for implementation reference.

  • SOAP-UI projects: ready-to-import templates for testing.

    • Related Articles

    • Clearinghuis Swagger UI - Api

      Vind hier de meest recente Swagger UI - Api voor het gebruik van Clearinghuis regres Clearinghuis regres Materieel Productie https://www.clearinghuisregres.nl/api/v1/materieel/swagger Demo/acceptatie ...

    • Afmeldredenen API Clearinghuis Regres Licht letsel

      Overzicht van de afmeldredenen en de bijbehorende codes die gebruikt worden in de API Clearinghuis Regres Licht letsel   <Item key="1" value="Verkeerde tegenpartij" />                 <Item key="2" value="Letselschade" /> ...

    • FAQ - Roy data 2.0 versie 1 2025

      Welkom bij de FAQ voor deelnemers van Roy-data 2.0 Roy-data heeft al sinds 2007 een belangrijke rol binnen de verzekeringsmarkt van motorrijtuigen, maar de huidige royementsverklaringen-database, Roy-data 1.0, voldoet niet langer aan de moderne eisen ...

    • Wat is de berichtenflow van ZI berichten?

      ZI-berichten staat voor Zelf Interpreteerbaar zoekresultaten, waarbij de deelnemer zelf een royement in gebruik te nemen. Voor deze berichten geldt de volgende flow. * In het geval van een W Respons zal de bevraging opgenomen in de doorlopende ...

    • Welke berichtformaten kunnen door Roy-data worden verwerkt?

      Roy-data kan worden benaderd via de Webbrowser, een webservice (ISA-Stekker) en via de Postbus (AIMS) van Solera. In onderstaande overzicht tref je de type berichten aan en de bestandsformaten die ondersteund worden door Roy-data. Transactie Kanaal ...