De MoneyView API - Beleggingsproducten
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
Voor de berekening moet een producttype worden meegegeven. Hierbij staat RBBER voor beleggingsrekening, ULLPB voor lijfrente beleggen met periodieke inleg en ULLPI voor lijfrente beleggen met eenmalige inleg.
Om een beleggingsproduct te berekenen zijn contractantgegevens, betaalgegevens en fondsen nodig.
Het betaalschema kan verschillende soorten inleg bevatten: periodiek of eenmalig. Naast de periodieke inleg kan een extra storting of aanvullende premie gedaan worden. Om een berekening te kunnen doen, moet eerst bepaald zijn welk product en welke, aan het product gerelateerde fondsen doorgerekend moeten worden. De fondsverdeling moet bij het eerste betaalschema worden meegegeven.
De fondsgegevens kunnen eerst worden opgehaald via een data request /relatiekenmerken Hierbij is een beleggingsproduct een ‘hoofdproduct’ en is een fonds een gerelateerd product. Meer over data requests is te vinden op de algemene pagina … Bij elk fonds moet een ID (= id van een fonds) en een fondsaandeel (percentage) worden meegegeven. Het totaal van de fondsaandelen moet 100% zijn.
In onderstaand voorbeeld (van berekening van een beleggingsrekening) 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 01-03-2018 om 15:37",
"@STARTDATUM": "01042018",
"@EINDDATUM": "01042048",
"@KEUZERND": "8",
"@AARDRND": "CF_AEQ",
"@RAPRND": "KEUZE",
"@REKENRICHTING": "PK",
"@WAARDEOVZ": "CONTRACTJR",
"CONTRACTANTEN": {
"CONTRACTANT": {
"@NAAM": "Contractant 1",
"@GEBOORTEDATUM": "01031988"
}
},
"PRODUCTEN": {
"@TYPE": "RBBER",
"PRODUCT": {
"@ID": "9777",
"BETAALSCHEMA": {
"INLEG": {
"@BEDRAG": "500",
"@SRT": "PREMIE",
"@TERMIJN": "MAAND",
"@DUUR_IN_MND": "360",
"FONDSEN": {
"FONDS": [
{
"@PRCT": "50",
"@ID": "8532"
},
{
"@PRCT": "25",
"@ID": "14820"
},
{
"@PRCT": "25",
"@ID": "8065"
}
]
}
}
}
}
}
}
}
}
}Bijzonderheden:
-
Rendement (KEUZERND): percentage
-
Grondslag berekening (AARDRND): conform AeQuote (CF_AEQ) of conform offertesoftware maatschappij (CF_MIJ)
-
Rapportagerendement (RAPRND): keuzerendement (KEUZE), 3 jaars HBR (3HBR) of 5 jaars HBR (5HBR)
-
Soort berekening (REKENRICHTING): inleg naar kapitaal (PK) of kapitaal naar inleg (KP) In geval van een kapitaal naar inleg berekening, moet een eindkapitaal worden meegegeven. Dit kan worden gedaan door het attribuut EINDKAPITAAL binnen het element CONTRACT mee te geven. In geval van een inleg naar kapitaal berekening, moet een periodiek in te leggen bedrag worden meegegeven. Dit kan worden gedaan door het attribuut BEDRAG binnen het element INLEG mee te geven.
-
Waardeoverzicht (WAARDEOVZ): per contractjaar (CONTRACTJR) of per kalenderjaar (KALENDERJR)
-
Het is mogelijk een extra storting mee te geven. Hiervoor een extra element INLEG worden toegevoegd met een BEDRAG en een soort inleg (SRT = EXTRAS_STORTING)
-
Het is mogelijk een aanvullende premie mee te geven. Hierbij moet dan een soort (SRT = AANVULLENDE_INLEG), een termijn en een duur in maanden (DUUR_IN_MND) worden meegegeven.
-
Bandbreedte: bij een extra storing of een aanvullende premie kan een bandbreedte worden bepaald. Er moet binnen de INLEG dan geen BEDRAG worden meegegeven, maar een verhouding ten opzichte van de premie (VERH_TOV_PREMIE).
RESPONSES
Er worden kunnen drie scenario’s worden doorgerekend:
-
keuzerendement (KEUZE)
-
als rendementsgegevens beschikbaar zijn: 3-jaars herbeleggingsrendement (HBR3)
-
als rendementsgegevens beschikbaar zijn: 5-jaars herbeleggingsrendement (HBR5)
Onder KOSTEN staan de kosten van de gezamelijke fondsen.
-
Scenario (SRT): KEUZE, HBR3 of HBR5
-
Totale kosten (KST) = kosten tegenrekening + fondskosten
-
Kosten tegenrekening (TR)
-
Totale fondskosten (FK)
-
Aankoopkosten (AK)
-
Verkoopkosten (VK)
-
Kostenpercentage (KST_PRCT)
Onder het element FONDSEN staan de resultaten per fonds. Per fonds worden de volgende gegevens geretourneerd:
-
Uniek id van het fonds (ID)
-
Fondsaandeel bij aanvang (PRCT)
-
Naam van het fonds (NAAM)
-
Naam van de aanbieder van het fonds (AANBIEDERNAAM)
-
Beheerkosten percentage (TER)
Elk fonds bevat voor elk scenario een waardeoverzicht (onder FWULTIMO):
-
Scenario (SRT): KEUZE, HBR3 of HBR5
-
Rendementspercentage: PRCT
-
Fondswaarde aan het einde van de looptijd: WRD
- Per fonds een waardeoverzicht: Hierbij bevat elk jaar de volgende attributen:
- Jaarnummer: NR
- Jaartal: JR
- Fondsaandeel (AANDEEL): Aandeel dat de fondswaarde van dit fonds inneemt binnen totale fondswaarde van dit jaar.
- Fondswaarde (WAARDE): Fondswaarde aan het einde van dit jaar.
Over de fondsen heen is er nog een totaal waardeoverzicht. Dit waardeoverzicht bevat per jaar de totale fondswaarde. Hierbij bevat elk jaar de volgende attributen.
-
Jaarnummer: NR
-
Jaartal: JR
-
Fondswaarde: WAARDE
Per fonds of per kenmerk kunnen er kenmerken worden geretourneerd voor rapportagedoeleinden. Dit zijn doorgaans kenmerken die van belang zijn geweest bij de berekening. Het kan zijn dat hieraan meer kenmerken zullen worden toegevoegd.
Hieronder een response horend bijhet bovenstaande voorbeeldbericht:
{
"RESPONSES": {
"@SESSION-ID": "d0c850fb-bcff-4620-8ac7-84cd99e0192e",
"@CNT": "1",
"@MS": "1031",
"PRD": {
"@ID": "9777",
"@NAAM": "Beleggersrekening",
"@VERSIE": "1",
"@AANBIEDERNAAM": "Triodos Bank",
"@SEQUENCE": "1",
"KENMERKEN": {
"KENMERK": [
{
"@NAAM": "Beheerkosten procentueel",
"@WAARDE": "0"
},
{
"@NAAM": "Minimale beheerkosten",
"@WAARDE": "0"
},
{
"@NAAM": "Maximale beheerkosten",
"@WAARDE": "999999999"
},
{
"@NAAM": "Verrekening kosten",
"@WAARDE": "per kwartaal"
},
{
"@NAAM": "Aankoopkosten",
"@WAARDE": "0.25"
},
{
"@NAAM": "Vaste aankoopkosten",
"@WAARDE": "0"
},
{
"@NAAM": "Verkoopkosten",
"@WAARDE": "0.4"
},
{
"@NAAM": "Vaste verkoopkosten",
"@WAARDE": "0"
}
]
},
"BETAALSCHEMA": {
"INLEG": {
"@BEDRAG": "500",
"@SRT": "PREMIE",
"@TERMIJN": "MAAND",
"@DUUR_IN_MND": "360"
}
},
"KOSTEN": {
"TOTALEN": [
{
"@SRT": "KEUZE",
"@KST": "87270.8",
"@TR": "5692.09",
"@FK": "81578.71",
"@AK": "450",
"@VK": "2135.05",
"@KST_PRCT": "1.63"
},
{
"@SRT": "HBR3",
"@KST": "62765.44",
"@TR": "4094.41",
"@FK": "58671.03",
"@AK": "450",
"@VK": "1331.37",
"@KST_PRCT": "1.61"
},
{
"@SRT": "HBR5",
"@KST": "136829.63",
"@TR": "9167.74",
"@FK": "127661.89",
"@AK": "450",
"@VK": "4557.94",
"@KST_PRCT": "1.71"
}
]
},
"FONDSEN": {
"FONDS": [
{
"@ID": "8532",
"@PRCT": "50",
"@NAAM": "Triodos Sustainable Pioneer Fund R-Cap",
"@AANBIEDERNAAM": "Triodos Bank",
"@TER": "1.3",
"KENMERKEN": {
"KENMERK": {
"@NAAM": "Lopende kosten",
"@WAARDE": "1,30%"
}
},
"FWULTIMO": [
{
"@SRT": "KEUZE",
"@PRCT": "8",
"@WRD": "267390.67",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "50.03",
"@WAARDE": "3096.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "51.15",
"@WAARDE": "269062.79"
}
]
}
},
{
"@SRT": "HBR3",
"@PRCT": "5.5",
"@WRD": "214844.21",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "50.03",
"@WAARDE": "3096.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "51.15",
"@WAARDE": "269062.79"
}
]
}
},
{
"@SRT": "HBR5",
"@PRCT": "13.5",
"@WRD": "992687.61",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "50.03",
"@WAARDE": "3096.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "51.15",
"@WAARDE": "269062.79"
}
]
}
}
]
},
{
"@ID": "14820",
"@PRCT": "25",
"@NAAM": "Triodos Microfinance Fund R-Cap",
"@AANBIEDERNAAM": "Triodos Bank",
"@TER": "2.12",
"KENMERKEN": {
"KENMERK": {
"@NAAM": "Lopende kosten",
"@WAARDE": "2,12%"
}
},
"FWULTIMO": [
{
"@SRT": "KEUZE",
"@PRCT": "8",
"@WRD": "114035",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "24.92",
"@WAARDE": "1541.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "21.89",
"@WAARDE": "115080.7"
}
]
}
},
{
"@SRT": "HBR3",
"@PRCT": "2.1",
"@WRD": "59342.01",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "24.92",
"@WAARDE": "1541.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "21.89",
"@WAARDE": "115080.7"
}
]
}
},
{
"@SRT": "HBR5",
"@PRCT": "3.6",
"@WRD": "76376.65",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "24.92",
"@WAARDE": "1541.34"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "21.89",
"@WAARDE": "115080.7"
}
]
}
}
]
},
{
"@ID": "8065",
"@PRCT": "25",
"@NAAM": "Triodos Cultuurfonds (N.V.) R-Dis",
"@AANBIEDERNAAM": "Triodos Bank",
"@TER": "1.03",
"KENMERKEN": {
"KENMERK": {
"@NAAM": "Lopende kosten",
"@WAARDE": "1,03%"
}
},
"FWULTIMO": [
{
"@SRT": "KEUZE",
"@PRCT": "8",
"@WRD": "141034.27",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "25.05",
"@WAARDE": "1550.44"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "26.95",
"@WAARDE": "141792.1"
}
]
}
},
{
"@SRT": "HBR3",
"@PRCT": "0.8",
"@WRD": "48158.11",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "25.05",
"@WAARDE": "1550.44"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "26.95",
"@WAARDE": "141792.1"
}
]
}
},
{
"@SRT": "HBR5",
"@PRCT": "1.8",
"@WRD": "56694.41",
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@AANDEEL": "25.05",
"@WAARDE": "1550.44"
},
...
{
"@NR": "30",
"@JR": "2048",
"@AANDEEL": "26.95",
"@WAARDE": "141792.1"
}
]
}
}
]
}
]
},
"WAARDEOVERZICHT": {
"JAAR": [
{
"@NR": "1",
"@JR": "2019",
"@WAARDE": "6188.13"
},
...
{
"@NR": "30",
"@JR": "2048",
"@WAARDE": "525935.59"
}
]
}
}
}
}