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”)