De MoneyView API - Annuïteiten en Lineaire Hypotheken
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 annuïteiten of lineaire hypotheken te berekenen zijn contractantgegevens en leningdelen nodig. Bij de annuïteiten of lineaire leningdelen kunnen ook aflossingvrije leningdelen worden toegevoegd.
Het formaat waarin de contractantgegevens worden gedefinieerd komt overeen met andere AeQuote productsoorten.
In onderstaand voorbeeld (van vergelijking van annuïtaire hypotheken) zijn de velden te zien:
{
"COMMAND": {
"@SENDER": "ZET HIER UW BEDRIJFSNAAM/APPLICATIENAAM",
"@SESSION-ID": "HIER KAN EEN SESSIE ID MEEGEGEVEN WORDEN",
"@INTERFACE": "2",
"BEREKENEN": {
"CONTRACT": {
"@OMSCHRIJVING": "Vergelijking gemaakt op 18-08-2017 om 13:26",
"@STARTDATUM": "01102017",
"@EINDDATUM": "01102047",
"@WAARDEOVERZICHT": "KALENDERJR",
"@MARKTWAARDE": "175000",
"@BOUWAARD": "O",
"@LOOPTIJDRENTE": "JA",
"CONTRACTANTEN": {
"CONTRACTANT": {
"@NAAM": "Contractant 1",
"@GEBOORTEDATUM": "05091987",
"@GESLACHT": "M",
"@BEL_SCHIJF": "36.55"
}
},
"PRODUCTEN": {
"@TYPE": "ANNH",
"LENINGDELEN": {
"LENINGDEEL": {
"@TYPE": "ANNH",
"@BEDRAG": "125000",
"@DUUR_MND": "360",
"@RVP": "P10Y",
"@FISCAAL_REGIME": "BOXI"
}
}
}
}
}
}
}Bijzonderheden:
-
WAARDEOVERZICHT: KALENDERJR of CONTRACTJR
-
MARKTWAARDE: Marktwaarde van onderpand, nodig voor bepaling LTV
-
BOUWAARD: Oudbouw (O) of Nieuwbouw (N) (default: O)
-
LOOPTIJDRENTE: JA, NEE. Bepaal of de rente automatisch mag dalen tijdens de looptijd.
-
BEL_SCHIJF: Fiscaal aftrekpercentage voor het maken van bruto-netto berekeningen.
Per leningdeel:
-
TYPE: ANNH (annuïtair dalend), LINH (lineair dalend), AFLOH (aflossingsvrij)
-
TERMIJN: MAAND, KWARTAAL, HALFJAAR of JAAR (default: MAAND)
-
DUUR_MND: duur in maanden
-
RVP: rentevaste periode. P10Y staat voor 10 jaar. Formaat van duur conform: https://www.w3.org/TR/xmlschema-2/#duration
-
FISCAAL_REGIME: BOXI of BOXIII
RESPONSES
Hieronder de reponse van een berekende premie. Deze response bevat aanbieder en productnaam.
De belangrijkste waarden staat onder het element RESN:
-
TOT_AFL: Totaal bedrag afgelost bij einde looptijd.
-
TOT_NET_RNT: Totale netto rente bij einde looptijd.
-
TOT_NET_INL: Totale netto inleg bij einde looptijd.
-
LPT_RNT: Toegepaste methode voor looptijdrente. RVP = rentedaling na rentevaste periode, MND = rentedaling mogelijk per maand, NEE = geen rentedaling mogelijk.
-
RST: Restschuld bij einde looptijd.
-
AFL_MND_1: Aflossing in eerste maand.
-
BRT_INL_MND_1: Bruto inleg eerste maand.
-
NET_INL_MND_1: Netto inleg eerste maand.
-
BRT_RNT_MND_1: Bruto rente eerste maand.
-
NET_RNT_MND_1: Netto rente eerste maand.
-
RENTES: Overzicht van de toegepaste rentes per marktwaarde. De looptijdrente is het toegepaste gewogen gemiddelde van de rentes over de looptijd.
Onder RES staat het waardeoverzicht.
-
JR: jaar X.
-
AFL: aflossing jaar X.
-
NET_RNT: netto rente jaar X.
-
BRT_RNT: bruto rente jaar X.
-
RST: restschuld na jaar X.
{
"RESPONSES": {
"@SESSION-ID": "c9e134f5-4429-4e01-bb17-d1ba455b0e18",
"@CNT": "55",
"@MS": "1547",
"PRD": [
{
"@ID": "197",
"@NAAM": "Aflossingsvrije hypotheek",
"@VERSIE": "1",
"@AANBIEDERNAAM": "ABN AMRO",
"@SEQUENCE": "1",
"RESN": {
"@NR": "1",
"@TYPE": "ANNH",
"@PRODUCTID": "286",
"@TOT_AFL": "125000",
"@TOT_NET_RNT": "26762.2",
"@TOT_NET_INL": "151762.2",
"@LPT_RNT": "RVP",
"@RST": "0",
"@AFL_MND_1": "248.32",
"@BRT_INL_MND_1": "470.19",
"@NET_INL_MND_1": "389.1",
"@BRT_RNT_MND_1": "221.87",
"@NET_RNT_MND_1": "140.78",
"RENTES": {
"RENTE": [
{
"@WAARDE": "1.93",
"@NAAM": "NHG"
},
{
"@WAARDE": "1.93",
"@NAAM": "+0 - +65% MW"
},
{
"@WAARDE": "2.13",
"@NAAM": "65 - +85% MW"
},
{
"@WAARDE": "2.48",
"@NAAM": "85 - +114% MW"
},
{
"@WAARDE": "2.035",
"@NAAM": "Looptijdrente"
}
]
},
"RES": [
{
"@JR": "1",
"@AFL": "3009.08",
"@NET_RNT": "1670.79",
"@BRT_RNT": "2633.24",
"@RST": "121990.92"
},
{
"@JR": "2",
"@AFL": "3073.8",
"@NET_RNT": "1629.72",
"@BRT_RNT": "2568.51",
"@RST": "118917.12"
},
{
"@JR": "3",
"@AFL": "3139.91",
"@NET_RNT": "1587.77",
"@BRT_RNT": "2502.4",
"@RST": "115777.21"
},
{
"@JR": "4",
"@AFL": "3207.45",
"@NET_RNT": "1544.92",
"@BRT_RNT": "2434.86",
"@RST": "112569.76"
},
{
"@JR": "5",
"@AFL": "3276.44",
"@NET_RNT": "1501.15",
"@BRT_RNT": "2365.87",
"@RST": "109293.32"
},
{
"@JR": "6",
"@AFL": "3346.91",
"@NET_RNT": "1456.43",
"@BRT_RNT": "2295.4",
"@RST": "105946.41"
},
{
"@JR": "7",
"@AFL": "3418.9",
"@NET_RNT": "1410.75",
"@BRT_RNT": "2223.41",
"@RST": "102527.5"
},
{
"@JR": "8",
"@AFL": "3492.44",
"@NET_RNT": "1364.09",
"@BRT_RNT": "2149.87",
"@RST": "99035.06"
},
{
"@JR": "9",
"@AFL": "3567.56",
"@NET_RNT": "1316.43",
"@BRT_RNT": "2074.75",
"@RST": "95467.5"
},
{
"@JR": "10",
"@AFL": "3644.3",
"@NET_RNT": "1267.74",
"@BRT_RNT": "1998.02",
"@RST": "91823.21"
},
{
"@JR": "11",
"@AFL": "3799.07",
"@NET_RNT": "1103.2",
"@BRT_RNT": "1738.7",
"@RST": "88024.14"
},
{
"@JR": "12",
"@AFL": "3873.04",
"@NET_RNT": "1056.27",
"@BRT_RNT": "1664.72",
"@RST": "84151.1"
},
{
"@JR": "13",
"@AFL": "3948.45",
"@NET_RNT": "1008.42",
"@BRT_RNT": "1589.31",
"@RST": "80202.65"
},
{
"@JR": "14",
"@AFL": "4025.34",
"@NET_RNT": "959.64",
"@BRT_RNT": "1512.43",
"@RST": "76177.31"
},
{
"@JR": "15",
"@AFL": "4103.72",
"@NET_RNT": "909.9",
"@BRT_RNT": "1434.05",
"@RST": "72073.59"
},
{
"@JR": "16",
"@AFL": "4183.62",
"@NET_RNT": "859.2",
"@BRT_RNT": "1354.14",
"@RST": "67889.97"
},
{
"@JR": "17",
"@AFL": "4265.08",
"@NET_RNT": "807.52",
"@BRT_RNT": "1272.68",
"@RST": "63624.89"
},
{
"@JR": "18",
"@AFL": "4348.13",
"@NET_RNT": "754.82",
"@BRT_RNT": "1189.63",
"@RST": "59276.75"
},
{
"@JR": "19",
"@AFL": "4432.8",
"@NET_RNT": "701.1",
"@BRT_RNT": "1104.97",
"@RST": "54843.96"
},
{
"@JR": "20",
"@AFL": "4519.11",
"@NET_RNT": "646.33",
"@BRT_RNT": "1018.65",
"@RST": "50324.84"
},
{
"@JR": "21",
"@AFL": "4607.11",
"@NET_RNT": "590.5",
"@BRT_RNT": "930.66",
"@RST": "45717.74"
},
{
"@JR": "22",
"@AFL": "4696.81",
"@NET_RNT": "533.58",
"@BRT_RNT": "840.95",
"@RST": "41020.92"
},
{
"@JR": "23",
"@AFL": "4788.27",
"@NET_RNT": "475.55",
"@BRT_RNT": "749.5",
"@RST": "36232.65"
},
{
"@JR": "24",
"@AFL": "4881.5",
"@NET_RNT": "416.4",
"@BRT_RNT": "656.26",
"@RST": "31351.15"
},
{
"@JR": "25",
"@AFL": "4976.56",
"@NET_RNT": "356.09",
"@BRT_RNT": "561.21",
"@RST": "26374.6"
},
{
"@JR": "26",
"@AFL": "5073.46",
"@NET_RNT": "294.6",
"@BRT_RNT": "464.31",
"@RST": "21301.14"
},
{
"@JR": "27",
"@AFL": "5172.25",
"@NET_RNT": "231.92",
"@BRT_RNT": "365.52",
"@RST": "16128.89"
},
{
"@JR": "28",
"@AFL": "5272.96",
"@NET_RNT": "168.02",
"@BRT_RNT": "264.81",
"@RST": "10855.93"
},
{
"@JR": "29",
"@AFL": "5375.63",
"@NET_RNT": "102.87",
"@BRT_RNT": "162.13",
"@RST": "5480.3"
},
{
"@JR": "30",
"@AFL": "5480.3",
"@NET_RNT": "36.46",
"@BRT_RNT": "57.46",
"@RST": "0"
}
]
}
},
{
"@ID": "21529",
"@NAAM": "bijBouwe Hypotheek",
"@VERSIE": "1",
"@AANBIEDERNAAM": "bijBouwe",
"@SEQUENCE": "9",
"ACCEPTATIERAPPORT": {
"OPMERKINGEN": {
"OPMERKING": "Voor dit product is geen hypotheekrente gevonden voor hypotheekdeel 'annu�teit' met een rentevast periode van 10 jaar en een bevoorschotting van 71.43 procent."
}
}
}
]
}
}Het voorbeeld hierboven bevat ook een foutmelding. Deze kan ontstaan als er geen rentes worden gevonden voor de gegeven criteria.