Back to top

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"
            }
          ]
        }
      ]
    }
  }
}

Generated by aglio on 25 Mar 2019