De MoneyView API - Lijfrente Sparen
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 lijferente sparen producten te berekenen zijn contractantgegevens en uitgangspunten voor de inleg nodig.
Het formaat waarin de contractantgegevens worden gedefinieerd komt overeen met andere AeQuote productsoorten.
Met onderstaand voorbeeld worden producten doorgerekend:
{
"COMMAND": {
"@SENDER": "ZET HIER UW BEDRIJFSNAAM/APPLICATIENAAM",
"@SESSION-ID": "HIER KAN EEN SESSIE ID MEEGEGEVEN WORDEN",
"@INTERFACE": "2",
"BEREKENEN": {
"CONTRACT": {
"@OMSCHRIJVING": "Omschrijving vergelijking",
"@STARTDATUM": "01122025",
"@EINDDATUM": "01122055",
"CONTRACTANTEN": {
"CONTRACTANT": [
{
"@NAAM": "Contractant",
"@GEBOORTEDATUM": "05111995"
}
]
},
"PRODUCTEN": {
"@TYPE": "TRLPB",
"INLEG": {
"@KAPITAALNAARPREMIE": "N",
"@PERIODIEK": "350",
"@EENMALIG": "50000",
"@FREQUENTIE": "12",
"@EINDDATUM": "01122055",
"@RENTEOPTIE": "ACTUEEL_VARIABEL"
}
}
}
}
}
}Bijzonderheden:
Betaalopties (INLEG):
-
TYPE: in geval van periodieke inleg ‘TRLPB’ of ‘TRLPI’ bij eenmalige inleg
-
PERIODIEK: periodieke betaling
-
EENMALIG: eenmalige betaling
-
FREQUENTIE: betaalfrequentie (12 = per maand, 6 = per half jaar, 3 = per kwartaal, 1 = per jaar
-
EINDDATUM: einddatum betalingen
Renteoptie onder inleg (RENTEOPTIE)
-
ACTUEEL_VARIABEL: Actuele rente wordt door de berekening bepaald
-
ACTUEEL_DEPOSITO: Actuele rente wordt door de berekening bepaald
-
HISTORISCH_VARIABEL: Historische rente wordt door de berekening bepaald
-
KEUZE_VARIABEL: Rente moet worden meegegeven
-
KEUZE_DEPOSITO: Rente moet worden meegegeven Als de rente moet worden meegeven moet het attribuut RENTE onder INLEG worden meegegeven.
Rekenrichting:
-
Kapitaal -> Inleg: KAPITAALNAARPREMIE: J
-
Inleg -> Kapitaal: KAPITAALNAARPREMIE: N
RESPONSES
Hieronder de reponse van een berekende uitkeringen. Deze response bevat aanbieder en productnaam.
De belangrijkste waarden staat onder het element RESN:
-
EINDKAPITAAL: eindkapitaal
-
MINIMAAL_EINDKAPITAAL: minimaal eindkapitaal
-
HISTORISCH_EINDKAPITAAL: eindkapitaal op basis van de historische rente
-
TERMIJN_INLEG: termijn inleg
-
EENMALIGE_INLEG: eenmalige inleg
-
TOT_INLEG: totale inleg
-
HISTORISCHE_RENTE: historische rente
-
RENTE: rente
Per jaar wordt een RES element geretourneerd met de volgende attributen:
-
JR: jaarnummer
-
WRD: waarde
-
INLEG: inleg
-
RNT: rente (in geval van keuze voor ACTUEEL_DEPOSITO)
Dit is een fragment van de response:
{
"RESPONSES": {
"@SESSION-ID": "HIER KAN EEN SESSIE ID MEEGEGEVEN WORDEN",
"@CNT": "8",
"@MS": "1890",
"PRD": [
{
"@ID": "10385",
"@NAAM": "Pensioenaanvulling met variabele rente",
"@VERSIE": "1",
"@AANBIEDERNAAM": "ABN AMRO",
"@SEQUENCE": "1",
"RESN": {
"@EINDKAPITAAL": "247008.15",
"@TERMIJN_INLEG": "350",
"@EENMALIGE_INLEG": "50000",
"@TOT_INLEG": "176000",
"@MINIMAAL_EINDKAPITAAL": "176000",
"@HISTORISCH_EINDKAPITAAL": "377266.26",
"@HISTORISCHE_RENTE": "3.7",
"@RENTE": "1.7",
"RES": [
{
"@JR": "1",
"@WRD": "54302.91",
"@INLEG": "54200",
"@RNT": "0"
},
{
"@JR": "2",
"@WRD": "59458.69",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "3",
"@WRD": "64702.11",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "4",
"@WRD": "70034.67",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "5",
"@WRD": "75457.89",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "6",
"@WRD": "80973.3",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "7",
"@WRD": "86582.47",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "8",
"@WRD": "92287",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "9",
"@WRD": "98088.5",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "10",
"@WRD": "103988.63",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "11",
"@WRD": "109989.06",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "12",
"@WRD": "116091.5",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "13",
"@WRD": "122297.68",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "14",
"@WRD": "128609.37",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "15",
"@WRD": "135028.35",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "16",
"@WRD": "141556.46",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "17",
"@WRD": "148195.54",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "18",
"@WRD": "154947.49",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "19",
"@WRD": "161814.23",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "20",
"@WRD": "168797.69",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "21",
"@WRD": "175899.88",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "22",
"@WRD": "183122.8",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "23",
"@WRD": "190468.52",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "24",
"@WRD": "197939.11",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "25",
"@WRD": "205536.7",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "26",
"@WRD": "213263.45",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "27",
"@WRD": "221121.55",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "28",
"@WRD": "229113.24",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "29",
"@WRD": "237240.79",
"@INLEG": "4200",
"@RNT": "0"
},
{
"@JR": "30",
"@WRD": "247008.15",
"@INLEG": "4200",
"@RNT": "0"
}
]
}
},