De MoneyView API - Overlijdensrisicoverzekeringen
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 leven producten is te vinden op de pagina met algemene documentatie. Het is raadzaam deze eerst te lezen alvorens te beginnen aan de documentatie hieronder.
Om een berekening te doen moet een JSON rekenbericht gepost worden naar https://api.moneyview.nl/calculation.
COMMAND
Om een ORV te berekenen zijn contractantgegevens, een dekking en betaalgegevens nodig.
Het formaat waarin de contractantgegevens worden gedefinieerd komt overeen met andere AeQuote productsoorten. Voor ORV is een geboortedatum altijd nodig. Ook kan het zijn dat er een postcode nodig is om de premie te berekenen.
Alle producten worden doorgerekend op basis van het producttype. Om onderscheid te maken tussen gelijkblijvend en variabel is hierbij ook het SUBTYPE toegevoegd.
Als het SUBTYPE waarde ‘premiebetaling=gelijkblijvend’ heeft, worden de risicoproducten met gelijkblijvende premiebetaling doorgerekend. In geval van ‘premiebetaling=variabel’ worden de producten met variabele premiebetaling doorgerekend. Als het SUBTYPE wordt weggelaten, worden beide subtypen doorgerekend.
Bij de betaling moet een termijn worden meegegeven. Dit kan zijn MAAND, KWARTAAL, HALFJAAR of JAAR.
In onderstaand voorbeeld (van vergelijking van gelijkblijvende risicoverzekeringen) zijn de velden te zien:
{
"COMMAND": {
"@SENDER": "ZET HIER UW BEDRIJFSNAAM/APPLICATIENAAM",
"@SESSION-ID": "HIER KAN EEN SESSIE ID MEEGEGEVEN WORDEN",
"@INTERFACE": "4",
"BEREKENEN": {
"CONTRACT": {
"@TWEELEVENSAPART": "N",
"@VERPANDING": "J",
"@OMSCHRIJVING": "Orv calculation",
"@STARTDATUM": "01112016",
"CONTRACTANTEN": {
"CONTRACTANT": [
{
"@NAAM": "Verzekerde 1",
"@GEBOORTEDATUM": "01111986",
"@GESLACHT": "M",
"@ROOKGEDRAG": "N",
"@POSTCODE": "1000AA"
},
{
"@NAAM": "Verzekerde 2",
"@GEBOORTEDATUM": "01111976",
"@GESLACHT": "V",
"@ROOKGEDRAG": "J",
"@POSTCODE": "1000AA"
}
]
},
"PRODUCTEN": {
"@TYPE": "TRRGE",
"DEKKINGSVORM": {
"@DUUR_IN_MND": "120",
"@VERZEKERDBEDRAG1": "75000",
"@VERZEKERDBEDRAG2": "75000"
},
"BETALING": {
"@TERMIJN": "MAAND"
}
}
}
}
}
}Bijzonderheden:
-
Met behulp van het veld TWEELEVENSAPART (met waarde ‘J’) kan worden aangegeven of twee contractanten op een polis moeten worden doorgerekend of op twee polissen. De polissen zijn in de response te onderscheiden aan de hand van het element ‘VERZEKERDEN’. Als de waarde ‘VZ’ is, gaat het om de eerste verzekerde, als de waarde ‘MV’ is gaat het om de medeverzekerde.
-
Het veld VERPANDING staat (inmiddels) voor een verplichte koppeling met een hypotheek. Waarde hiervan kan ‘J’ zijn of ‘N’. Als dit attribuut weggelaten wordt, wordt er niet gecontroleerd op verpanding.
-
Bij annuïtaire risicoverzekeringen moet ook het annuïtair percentage worden meegegeven. Dat kan onder DEKKINGSVORM met attribuut ANNUITAIRPERCENTAGE.
-
Onder contractanten kan een bruto gezinsinkomen worden meegegeven via het attribuut: GEZINSINKOMEN.
-
Onder contractant kan het persoonlijke inkomen worden meegegeven via het attribuut: INKOMEN.
-
Onder contractant kan bepaald of contractant gaat stoppen met roken via het attribuut: STOPPENMETROKEN. ‘J’ als gestopt gaat worden met roken, anders ‘N’. Dit attribuut werkt in combinatie met ROOKGEDRAG.
-
Onder contractant kan een opleiding worden meegegeven via het attribuut: OPLEIDING. De mogelijke waarden hiervoor zijn: LO (lager onderwijs), VO (voortgezet onderwijs), LBO, VMBO, MB, HBO, MAVO, HAVO, VWO, WO. Default: HBO.
-
Intermediaire bemiddelingskosten kunnen apart worden doorgegeven. Hiervoor kunnen de volgende attributen onder BETALING worden toegevoegd:
- BK_EENMALIG: Eenmalig kosten
- BK_PERIODIEK: Gespreide kosten
- BK_TERM: Termijn voor gespreide kosten
- BK_DUUR_IN_MND: Duur voor gespreide kosten in maanden
-
Rekenen zonder distributiekosten kan door onder het element BETALING, het attribuut ZONDER_DIST_KST mee te geven. De waarde hiervan moet op ‘J’ staan.
RESPONSES
Hieronder de response van een berekende premie. Deze response bevat aanbieder en productnaam.
De belangrijkste waarden staat onder het element RESN:
-
CHANNEL: Product direct of indirect te sluiten. Mogelijke waarden zijn INTERMEDIAIR, DIRECT en MULTI-CHANNEL.
-
BRUTOTERMIJNPREMIE: Premie per opgegeven termijn.
-
TOTALE_PREMIE: Totale premie over de gehele betalingsperiode.
-
TOTALE_VERG_PREMIE: Over betalingsperiode contant gemaakte totale premie. Hiermee kan een correcte vergelijking gemaakt worden.
-
AFSLUITKOSTEN: Kosten voor het afsluiten van de verzekering (distributiekosten).
-
RISCPRMS: Premieoverzicht van risicopremies over de looptijd. Hierbij staat een jaarnummer, een premiesom en een premie voor de eerste maand.
De response bevat 39 producten die in 3625 milliseconden berekend zijn. Hieronder volgt een verkorte weergave:
{
"RESPONSES": {
"@SESSION-ID": "477c128a-94a4-4175-a1d3-6c5d10ad6dd4",
"@CNT": "39",
"@MS": "3625",
"PRD": [
{
"@ID": "3464",
"@NAAM": "Overlijdensrisicoverzekering",
"@VERSIE": "4",
"@AANBIEDERNAAM": "ABN AMRO",
"@SEQUENCE": "1",
"DEKKINGSVORM": {
"@CODE": "GB",
"@DUUR": "120",
"@ANNUITAIRPERCENTAGE": "0"
},
"RESN": {
"@NUMMER": "1",
"@VERZEKERDEN": "BEIDE",
"@CHANNEL": "INTERMEDIAIR",
"@BRUTOTERMIJNPREMIE": "10.84",
"@DUUR": "10",
"@DUUR_IN_MND": "120",
"@EINDDATUM": "01112026",
"@TOTALE_PREMIE": "1475.8",
"@TOTALE_VERG_PREMIE": "1346.04",
"@AFSLUITKOSTEN": "175"
}
},
...
{
"@ID": "13132",
"@NAAM": "Overlijdensrisicoverzekering",
"@VERSIE": "4",
"@AANBIEDERNAAM": "Allianz",
"@SEQUENCE": "5",
"DEKKINGSVORM": {
"@CODE": "GB",
"@DUUR": "120",
"@ANNUITAIRPERCENTAGE": "0"
},
"RESN": [
{
"@NUMMER": "1",
"@VERZEKERDEN": "BEIDE",
"@CHANNEL": "DIRECT",
"@BRUTOTERMIJNPREMIE": "13.25",
"@DUUR": "10",
"@DUUR_IN_MND": "120",
"@EINDDATUM": "01112026",
"@TOTALE_PREMIE": "1685",
"@TOTALE_VERG_PREMIE": "1526.39",
"@DIST_KOSTEN": "95",
"@DIST_DUUR_IN_MND": "0",
"RISCPRMS": {
"RISCPRM": [
{
"@JR": "1",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "2",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "3",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "4",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "5",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "6",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "7",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "8",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "9",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
},
{
"@JR": "10",
"@BEDR": "159",
"@MND1": "13.25",
"@VK1": "75000",
"@VK2": "75000"
}
]
}
},
...
{
"@ID": "18442",
"@NAAM": "Overlijdensrisicoverzekering (eenmaandelijks)",
"@VERSIE": "2",
"@AANBIEDERNAAM": "Woonfonds",
"@SEQUENCE": "38",
"ACCEPTATIERAPPORT": {
"OPMERKINGEN": {
"OPMERKING": "Dit product kan alleen worden afgesloten voor ��n verzekerde."
}
}
},
{
"@ID": "18466",
"@NAAM": "OverlijdensRisicoVerzekering",
"@VERSIE": "3",
"@AANBIEDERNAAM": "Zwitserleven",
"@SEQUENCE": "39",
"DEKKINGSVORM": {
"@CODE": "GB",
"@DUUR": "120",
"@ANNUITAIRPERCENTAGE": "0"
},
"RESN": [
{
"@NUMMER": "1",
"@VERZEKERDEN": "BEIDE",
"@CHANNEL": "DIRECT",
"@BRUTOTERMIJNPREMIE": "14.24",
"@DUUR": "10",
"@DUUR_IN_MND": "120",
"@EINDDATUM": "01112026",
"@TOTALE_PREMIE": "1803.8",
"@TOTALE_VERG_PREMIE": "1633.34",
"@DIST_KOSTEN": "95",
"@DIST_DUUR_IN_MND": "0"
},
{
"@NUMMER": "2",
"@VERZEKERDEN": "BEIDE",
"@CHANNEL": "INTERMEDIAIR",
"@BRUTOTERMIJNPREMIE": "14.24",
"@DUUR": "10",
"@DUUR_IN_MND": "120",
"@EINDDATUM": "01112026",
"@TOTALE_PREMIE": "1708.8",
"@TOTALE_VERG_PREMIE": "1538.34"
}
]
}
]
}
}
Berekening voor het voorbereiden van een offerte
Onderstaande opties zijn niet op alle producten van toepassing. Neem eerst contact op met MoneyView voor meer informatie.
Om een offerte te kunnen voorbereiden moet een uitgebreide berekening gedaan worden. Hiervoor moet bij het element CONTRACT een attribuut DOEL_BEREKENING met waarde OFFERTE worden meegegeven. Als dit wordt meegegeven, zullen extra risicopremies en gesplitste premies worden doorgerekend.
Extra risicopremie
COMMAND
Doel berekening moet offerte zijn. Zie hierboven.
Binnen het element DEKKINGSVORM kunnen de volgende attributen worden meegegeven:
-
OVERSTERFTE1 en OVERSTERFTE2: Oversterftepercentage (getal tussen 0.0 en 100.0)
-
EXTRA_RP1 en EXTRA_RP2: Extra risicopremie voor verzekerde of medeverzekerde.
-
DUUR_EXTRA_RP1 en DUUR_EXTRA_RP2: Duur in jaren van de extra risicopremie voor de verzekerde of medeverzekerde.
RESPONSE
De bruto termijnpremie inclusief extra risicopremie komt in BRUTOTERMIJNPREMIE_INCL_EXTRA_RP (binnen element RESN). Per jaar wordt een extra risicopremie voor de eerste en tweede verzekerde geretourneerd binnen element RISCPRM: EXTRA_RP1 en EXTRA_RP2
Premiesplitsing
COMMAND
Doel berekening moet offerte zijn. Zie hierboven.
RESPONSE
Bij gelijkblijvende premie worden de volgende waarden geretourneerd binnen element RESN:
-
BRUTOTERMIJNPREMIE_GESPLITST: Gesplitste bruto premie van tweede verzekerde.
-
NETTOPREMIE: Netto premie.
In geval van het variabele tarief worden de gesplitste premies per jaar geretourneerd: Hiervoor is het element RISCPRM uitgebreid met BP1 en BP2 voor de brutopremie voor de eerste en tweede verzekerde.
CHANGELOG
19-05-2020 - BMI verwijderd (niet meer nodig)