Back to top

De MoneyView API - Gezinsongevallen

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 Gezinsongevallen te berekenen zijn klantgegevens en de gewenste dekking(en) 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": "20180123",
    "PERSOON_GEBOORTEDATUM": "19800101",
    "PERSOON_POSTCODE": "4401",
    "PERSOON_GEBOORTEDATUM_PARTNER": "19700101",
    "PERSOON_GEBOORTEDATUM_KIND1": "",
    "PERSOON_STUDEREND_KIND1": "NEE",
    "PERSOON_GEBOORTEDATUM_KIND2": "",
    "PERSOON_STUDEREND_KIND2": "NEE",
    "PERSOON_GEBOORTEDATUM_KIND3": "",
    "PERSOON_STUDEREND_KIND3": "NEE",
    "PERSOON_GEBOORTEDATUM_KIND4": "",
    "PERSOON_STUDEREND_KIND4": "NEE",
    "PERSOON_GEBOORTEDATUM_KIND5": "",
    "PERSOON_STUDEREND_KIND5": "NEE",
    "BEREKENING_VERZEKERD_BEDRAG_A": "5000",
    "BEREKENING_VERZEKERD_BEDRAG_B": "10000",
    "BEREKENING_BETALINGSTERMIJN": "JAAR",
    "BEREKENING_NULPREMIES": "JA",
    "BEREKENING_PROGRESSIEF_B": "100"
  }
}

Uitleg velden:

INVOERVELD SOORT DEFAULT OF FORMAT TOELICHTING OF INVULMOGELIJKHEDEN
Session_Id String Unieke casus identifier
Berekening_Ingangsdatum int YYYYMMDD Ingangsdatum verzekering
Persoon_Geboortedatum Int YYYYMMDD Geboortedatum Hoofdverzekerde (HV)
Persoon_Postcode Int Getal 1000 - 9999
Persoon_Geboortedatum_Partner Int YYYYMMDD Geboortedatum Partner
Persoon_Geboortedatum_Kind1 Int YYYYMMDD Geboortedatum Kind 1
Persoon_Studerend_Kind1 string Nee Zichtbaar indien kind 1 > 16 jaar [Ja/Nee]
Persoon_Geboortedatum_Kind2 Int YYYYMMDD Geboortedatum Kind 2
Persoon_Studerend_Kind2 string Nee Zichtbaar indien kind 2 > 16 jaar [Ja/Nee]
Persoon_Geboortedatum_Kind3 Int YYYYMMDD Geboortedatum Kind 3
Persoon_Studerend_Kind3 string Nee Zichtbaar indien kind 3 > 16 jaar [Ja/Nee]
Persoon_Geboortedatum_Kind4 Int YYYYMMDD Geboortedatum Kind 4
Persoon_Studerend_Kind4 string Nee Zichtbaar indien kind 4 > 16 jaar [Ja/Nee]
Persoon_Geboortedatum_Kind5 Int YYYYMMDD Geboortedatum Kind 5
Persoon_Studerend_Kind5 string Nee Zichtbaar indien kind 5 > 16 jaar [Ja/Nee]
Berekening_Verzekerd_Bedrag_A Int 0 Gewenste dekking Overlijden
Berekening_Verzekerd_Bedrag_B Int 0 Gewenste dekking invaliditeit
Berekening_Betalingstermijn string Jaar 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_Nulpremies string Nee [Ja] of [Nee] (toon niet geaccepteerde producten)

RESPONSES

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

{
  "ScripletEngineResponseParameters": {
    "task": "type": "string", "#text": "PROCESS_TWO",
    "global": "type": "string", "#text": "ONGEVALLEN",
    "local": "type": "string",
    "specific": "type": "string",
    "response": [
       {
    "SESSION_ID": "string",
    "KLANT_PREMIE": "number",
    "TERMIJN_TOESLAG": "number",
    "GLOBAL_ESCAPE_REASON": "string",
    "PROG_B_BIJ_KLANT_PREMIE": "string",
    "VB_A": "integer",
    "VB_B": "integer",
    "POLISKOSTEN": "number",
    "DUUR": "integer",
    "BASIS_PREMIE": "number",
    "PROG_B_BIJ_BASIS_PREMIE": "string",
    "PROG_B_OPTIE1_PD": "number",
    "PROG_B_OPTIE1_OPM": "string",
    "PROG_B_OPTIE2_PD": "number",
    "PROG_B_OPTIE2_OPM": "string",
      }  
    ]
  }
}

Toelichting uitvoer

INVOERVELD SOORT DEFAULT OF FORMAT TOELICHTING OF INVULMOGELIJKHEDEN
Session_Id String Unieke casus identifier uit de invoer
Global String Module
Local String Maatschappij
Specific String Product
Klant_Premie number Uiteindelijke klant premie (excl kosten)
Termijn_toeslag number Toeslagspercentage voor betaaltermijn
Prog_B_bij_Klant_Premie String Standaard progressief B-percentage
Basis_Premie number Premie per jaar excl kosten en geen rekening houdend met verschillende toeslagen, zoals termijntoeslag
Prog_B_bij_Basis_Premie String Progressief B-percentage bij basispremie
Prog_B_Optie1_Pd number Extra premie voor progressief optie 1 (excl kosten)
Prog_B_Optie1_Opm String Progressief B-percentage bij optie 1
Prog_B_Optie2_Pd number Extra premie voor progressief optie 2 (excl kosten)
Prog_B_Optie2_Opm String Progressief B-percentage bij optie 2
Poliskosten number Éénmalige poliskosten
VB_A Int Dekking Overlijden
VB_B Int Dekking Blijvende Invaliditeit
Duur Int Contractduur
Global_Escape_Reason String Indicatie van de reden voor geen premie

De eindpremie, die op de website getoond moet worden, is de KLANT_PREMIE. Daarnaast kunnen getoond worden: poliskosten en eigen risico.

Toelichting Progressief B

De meeste ongevallenverzekeringen kennen een maximale uitkering van 100% van het verzekerd bedrag. Bij een beperkt aantal producten ligt dit percentage bij blijvende invaliditeit (rubriek B) hoger. Het maximale percentage dat standaard geldt is te vinden in de velden PROG_B_BIJ_KLANT_PREMIE en PROG_B_BIJ_BASIS_PREMIE.

Bij een aantal producten is het mogelijk om het percentage tegen een premietoeslag te verhogen. De percentages die hier bij horen zijn te vinden in de velden PROG_B_OPTIE1_OPM en PROG_B_OPTIE2_OPM. De extra premie is te vinden in de velden PROG_B_OPTIE1_PD en PROG_B_OPTIE2_PD. In de invoer zit geen veld om deze extra dekkingen te kiezen. De extra premiedelen zullen in ons systeem daarom nooit opgeteld zijn/worden bij het veld KLANT_PREMIE. Natuurlijk kan dit wel handmatig gedaan worden.

CHANGELOG

24-01-2017 - Eerste versie

13-01-2020 - Termijntoeslag percentage m.b.t. termijn betaling toegevoegd aan uitvoer (“TERMIJN_TOESLAG”: “number”)

Generated by aglio on 06 Dec 2021