Back to top

De MoneyView API - AVP

De MoneyView API biedt de mogelijkheid om allerlei data uit de MoneyView databases beschikbaar te stellen. Dit is een RESTful API die JSON accepteert en ook retourneert.

MoneyView verzoekt u de server niet dermate zwaar te belasten zodanig dat andere gebruikers daar hinder van ondervinden (fair use).

Voor vragen of problemen over deze api kunt u contact opnemen met MoneyView via https://www.moneyview.nl/contact

Algemene informatie over de interface naar “Engine” producten is te vinden op de pagina met algemene documentatie. Het is raadzaam deze eerst te lezen alvorens te beginnen aan de documentatie hieronder.

COMMAND

Om een AVP te berekenen zijn klantgegevens en de gewenste dekking nodig. Bij de betaling moet een termijn worden meegegeven. Dit kan zijn MAAND, KWARTAAL, HALF JAAR of JAAR.

In onderstaand voorbeeld zijn de velden te zien:

{
   "profile":{
    "BEREKENING_MY": "Vraag MoneyView naar uw code",
    "SESSION_ID": "CASUS1",
    "BEREKENING_INGANGSDATUM": "20230118",
    "PERSOON_POSTCODE": "4401",
    "PERSOON_PC_LETTERS": "AA",
    "PERSOON_HUISNR": "11",
    "PERSOON_HUISNRTVG": "",
    "PERSOONLIJKE_OMSTANDIGHEDEN": "GEZIN MET KINDEREN",
    "PERSOON_GEBOORTEDATUM": "19700101",
    "PERSOON_GEBOORTEDATUM_PARTNER": "19730701",
    "ER_SOORT": "ALGEMEEN",
    "BEREKENING_ER_ALLEMAAL": "0",
    "BEREKENING_ER_KINDEREN": "0",
    "BEREKENING_VERZEKERD_BEDRAG": "2500000",
    "BEREKENING_SCHADEVERHAAL": "NEE",
    "BEREKENING_JAGERSRISICO": "NEE",
    "BEREKENING_BEZIT_2E": "NEE",
    "BEREKENING_PRIVEGEBRUIK_2E": "NEE",
    "BEREKENING_BETALINGSTERMIJN": "MAAND",
    "BEREKENING_ASSU_BELAST": "JA",
    "BEREKENING_NULPREMIES": "JA",
    "BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
    "BEREKENING_ER_AFWIJKING_WAARDE": "0"
  }
}

Uitleg velden:

INVOERVELD SOORT DEFAULT OF FORMAT TOELICHTING OF INVULMOGELIJKHEDEN
Session_Id string Unieke casus identifier
Berekening_Ingangsdatum int yyyymmdd Op welke datum moet de verzekering ingaan
Persoon_Postcode int Getal 1000 - 9999
Persoon_Pc_Letters string 2 letters AA - ZZ
Persoon_Huisnr String Leeg, Getal (Op moment van schrijven 1 - 99137)
Persoon_Huisnrtvg String Leeg, of de toevoeging.
Persoonlijke_Omstandigheden string Gezinssituatie (LOOKUP)
Persoon_Geboortedatum int yyyymmdd Geboortedatum verzekerde
Persoon_Geboortedatum_Partner int yyyymmdd Geboortedatum partner verzekerde
Er_Soort string Welk eigen risico is leidend voor het zoeken naar pasende waarden (ALGEMEEN of KINDEREN, zie toelichting)
Berekening_Er_Allemaal int Als ER_Soort = algemeen dan dit veld vullen (LOOKUP)
Berekening_Er_Kinderen int Als ER_Soort = kinderen dan dit veld vullen (LOOKUP)
Berekening_Verzekerd_Bedrag int Verzekerd bedrag (LOOKUP)
Berekening_Schadeverhaal string Nee [Ja]/[Nee] (ook wel verhaalsbijstand genoemd) is een dekking voor het verhalen van schade op een aansprakelijke derde.
Berekening_Jagersrisico string Nee [Ja]/[Nee] Extra dekking Jagers risico
Berekening_Bezit_2E string Nee [Ja]/[Nee] Extra dekking bezit 2e woning
Berekening_Privegebruik_2E string [Ja]/[Nee] Extra dekking verhuur 2e woning
Berekening_Betalingstermijn string [Jaar], [Half jaar], [Kwartaal], [Maand] (LOOKUP)
Berekening_My string Dit veld moet verplicht worden gevuld met een door MoneyView aangegeven waarde. Vraag de waarde op bij MoneyView.
Berekening_Assu_Belast string [Ja]/[Nee] Eindpremie inclusief assurantiebelasting
Berekening_Nulpremies string Nee Niet van toepassing bij AVP
Berekening_Er_Afwijking_Waarde int 0 Niet van toepassing, altijd 0
Berekening_Er_Afwijking_Type string Close [Close] of [Equal]

Toelichting Huisnummer en Toevoeging

Maatschappijen beginnen te kijken of het exacte adres gebruikt kan worden om tot een tarief te komen. Om dat in de toekomst te kunnen doen hebben we vast de benodigde velden in de documentatie opgenomen.

Toelichting Eigen risico (ER)

Het eigen risico bij AVP bestaat uit een algemeen eigen risico en een specifiek eigen risico voor aansprakelijkheidsschades veroorzaakt door kinderen. De meeste maatschappijen kennen vaste combinaties zoals 0-0, 0-175 en 100-100. Een beperkt aantal aanbieders biedt voor aansprakelijkheidsschades veroorzaakt door kinderen een afwijkend eigen risico aan. In een profiel kunnen twee eigen risico waardes opgeven worden. Echter het veld ER_SOORT (‘ALGEMEEN’ of ‘KINDEREN’) bepaalt welke van de twee gebruikt wordt om de beste passende combinatie van eigen risico’s te vinden. In de uitvoer staat weergegeven welke eigen risico combinatie van toepassing is.

Bij een alleenstaande zonder kinderen kan de ER_SOORT ‘KINDEREN’ niet gebruikt worden. Als ‘BEREKENING_ER_ALLEMAAL’ niet gevuld is wordt deze op 0 gezet.

Om een overzicht te krijgen van de meest gangbare combinaties van een product kan bij: ‘ER_SOORT’ de waarde ‘ALLE COMBINATIES’ worden gebruikt. Dan zal een product met meerdere opties vaker in de uitvoer worden getoond.

Toelichting Eigen woning

Berekening_Bezit_2E, geeft aan dat er sprake is van bezit 2e woning. Berekening_Privegebruik_2E, geeft aan dat de 2e woning voor verhuur bestemd is. Bij Ja is er sprake van verhuur, bij Nee is er geen sprake van verhuur.

Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)

ITEM KEUZES ITEM KEUZES
er_soort algemeen Persoonlijke_Omstandigheden gezin met kinderen
er_soort kinderen Persoonlijke_Omstandigheden gezin zonder kinderen
er_kinderen 0 Persoonlijke_Omstandigheden alleenstaande met kinderen
er_kinderen 150 Persoonlijke_Omstandigheden alleenstaande zonder kinderen
er_algemeen 0 Berekening_Verzekerd_Bedrag 1000000
er_algemeen 45 Berekening_Verzekerd_Bedrag 1250000
er_algemeen 90 Berekening_Verzekerd_Bedrag 2500000
er_algemeen 100

RESPONSES

Hieronder de reponse van een berekende premie. Deze response bevat aanbieder en productnaam.

{
  "ScripletEngineResponseParameters": {
    "task": "type": "string", "#text": "PROCESS_ONE",
    "global": "type": "string", "#text": "AVP",
    "local": "type": "string",
    "specific": "type": "string",
    "response": {
        "SESSION_ID": "string",
        "GLOBAL": "string",
        "LOCAL": "string",
        "SPECIFIC": "string",
        "VERZ_BEDRAG": "number",
        "PERSOONLIJKE_OMSTANDIGHEDEN": "string",
        "PREMIEDEEL_BASIS":  "number",
        "PREMIEDEEL_JAGERS": "number",
        "PREMIEDEEL_SCHADEVERHAAL": "number",
        "PREMIEDEEL_WONING": "number",
        "BRUTO_PREMIE": "number",     
        "DUUR": "integer",
        "DUUR_STANDAARD": "integer",
        "TOESLAG_DUUR": "number",
        "TERMIJN_TOESLAG": "number",
        "TOESLAG_ASSURANTIE": "number",
        "JAAR_PREMIE": "number",
        "TERMIJN_PREMIE": "number",     
        "POLISKOSTEN_BASIS": "number",
        "POLISKOSTEN_JAGER": "number",
        "POLISKOSTEN": "number",
        "EIGENRISICO_ALGEMEEN": "number",
        "EIGENRISICO_KINDEREN": "number",
        "GLOBAL_ESCAPE_REASON": "string"
     }
  }
}

Toelichting uitvoer

Onderstaande geeft een overzicht van de uitvoervelden. De eindpremie, die op de website getoond moet worden, is de TERMIJN_PREMIE. Daarnaast kunnen getoond worden: poliskosten en eigen risico.

CHANGELOG

29-04-2020 - Beschrijving Schadeverhaal toegevoegd

02-11-2020 - aanvulling informatie over eigen risico algemeen en kinderen

Generated by aglio on 25 Jan 2023