De MoneyView API - Persoonlijke Lening

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 persoonlijke leningen te berekenen zijn uitgangspunten voor de lening nodig. Daarnaast product gegevens voor het te berekenen product.

Met onderstaand voorbeeld worden persoonlijke leningen doorgerekend:

{
  "COMMAND": {
    "@SENDER": "ZET HIER UW BEDRIJFSNAAM/APPLICATIENAAM",
    "@SESSION-ID": "HIER KAN EEN SESSIE ID MEEGEGEVEN WORDEN",
    "@INTERFACE": "2",
    "BEREKENEN": {
      "CONTRACT": {
        "@OMSCHRIJVING": "Omschrijving van de vergelijking",
        "@STARTDATUM": "01012019",
        "@BEREKENING": "ALLE",
        "@WAARDEOVZ": "JA",
        "PRODUCTEN": {
          "@TYPE": "KREPL",
          "LENING": {
            "@TERMIJN": "MAAND",
            "@BEDRAG": "10000",
            "@DUUR_MND": "72"
          }
        }
      }
    }
  }
}

Bijzonderheden bij persoonlijke lening:

Bij het element CONTRACT:

BEREKENING:
- ALLE: Reken door met alle mogelijke risicoklassen
- HOOGSTELAAGSTE: Reken alleen door met de hoogste en laagste risicoklasse
- LAAGSTE: Reken alleen door met de laagst mogelijke risicoklasse
WAARDEOVZ: Is een waardeoverzicht gewenst? JA of NEE

Bij het element LENING:

TERMIJN:
- MAAND
- KWARTAAL
- HALFJAAR
- JAAR
BEDRAG: de gewenste lening in euro’s
DUUR_MND: de gewenste looptijd in maanden

RESPONSES

Hieronder de reponse van een berekende persoonlijke lening. Deze response bevat aanbieder en productnaam.

De belangrijkste waarden staan onder het element RESN:

RISICOKLASSE: Naamgeving van de risicoklasse
RENTE_PRCT: Rente percentage behorend bij risicoklasse
LOOPTIJD_MND: Looptijd in maanden
MAANDBEDRAG: Bedrag dat maandelijks moet worden betaald
TOT_BEDRAG: Totaal bedrag dat de lening gaat kosten. Dit is de som van aflossing en lening

Het waardeoverzicht, indien gevraagd, bestaat uit meerdere jaren en retourneert voor elk jaar een RES element binnen het element RESN:

JR: Belastingjaar
RNT: Som van alle rentedelen dit jaar
AFL: Som van alle aflossingsdelen dit jaar

Hieronder een fragment van de response:

{
  "RESPONSE": {
    "@SESSION-ID": "dae0954f-e341-48a7-87c6-9d166d7b5fa5",
    "@CNT": "2",
    "@MS": "362",
    "PRD": {
      "@ID": "21967",
      "@NAAM": "Persoonlijke Lening",
      "@VERSIE": "1",
      "@AANBIEDERNAAM": "Findio",
      "RESN": [
        {
          "@RISICOKLASSE": "A",
          "@RENTE_PRCT": "5.1",
          "@MAANDBEDRAG": "160.98",
          "@LOOPTIJD_MND": "72",
          "@TOT_BEDRAG": "11590.39",
          "RES": [
            {
              "@JR": "2019",
              "@RNT": "465.25",
              "@AFL": "1466.48"
            },
            ...
            {
              "@JR": "2024",
              "@RNT": "51.16",
              "@AFL": "1880.57"
            }
          ]
        }
      ]
    }
  }
}

COMMAND ¶

RESPONSES ¶

COMMAND

RESPONSES