De MoneyView API - Direct ingaande lijfrentes

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 direct ingaande lijfrentes te berekenen zijn contractantgegevens en uitgangspunten voor de inleg en de uitkering nodig.

Het formaat waarin de contractantgegevens worden gedefinieerd komt overeen met andere AeQuote productsoorten.

Alle producten worden doorgerekend op basis van het producttype. Om onderscheid te maken tussen banksparen en verzekeren is hierbij ook het SUBTYPE toegevoegd. Als het SUBTYPE waarde ‘productsoort=verzekeren’ heeft worden de verzekeringsproducten doorgerekend. In geval van ‘productsoort=banksparen’ worden de bankspaarproducten doorgerekend. Als het SUBTYPE wordt weggelaten worden beide productsoorten doorgerekend.

Met onderstaand voorbeeld worden verzekeringsproducten 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": "01022018",
        "CONTRACTANTEN": {
          "CONTRACTANT": [
            {
              "@NAAM": "Contractant 1",
              "@GEBOORTEDATUM": "26011953",
              "@GESLACHT": "M"
            },
            {
              "@NAAM": "Contractant 2",
              "@GEBOORTEDATUM": "01021949",
              "@GESLACHT": "V",
              "@OVERGANGSPRCT": "70"
            }
          ]
        },
        "PRODUCTEN": {
          "@TYPE": "TRLDI",
          "@SUBTYPE": "productsoort=verzekeren",
          "INLEG": {
            "@EENMALIG": "50000",
            "@HERKOMST": "000",
            "@HERKOMST_MAATSCHAPPIJ": 774
          },
          "UITKERING": {
            "@FREQUENTIE": "12",
            "@SLOTUITK": "N",
            "@SOORT_DUUR": "002"
          }
        }
      }
    }
  }
}

Bijzonderheden bij verzekeringsproducten:

OVERGANGSPRCT: gebroken getal tussen 0 en 100. Als voor beide contractanten een overgangspercentage is meegegeven, geldt de overgang op de langstlevende. Als voor alleen de tweede contractant een overgangspercentage is meegegeven, geldt de overgang op de medecontractant.
SOORT_DUUR: tijdelijk (001) of levenslang (002)
De optie levenslang is alleen van toepassing bij verzekeringsproducten. Bij deze optie hoeft geen einddatum te worden meegegeven.

Met onderstaand voorbeeld worden bankspaarproducten 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": "01022018",
        "@EINDDATUM": "01022028",
        "CONTRACTANTEN": {
          "CONTRACTANT": [
            {
              "@NAAM": "Contractant 1",
              "@GEBOORTEDATUM": "01051953",
              "@GESLACHT": "M"
            }
          ]
        },
        "PRODUCTEN": {
          "@TYPE": "TRLDI",
          "@SUBTYPE": "productsoort=banksparen",
          "INLEG": {
            "@EENMALIG": "50000",
            "@HERKOMST": "000",
            "@HERKOMST_MAATSCHAPPIJ": 774
          },
          "UITKERING": {
            "@FREQUENTIE": "12",
            "@SLOTUITK": "N",
            "@SOORT_DUUR": "001"
          }
        }
      }
    }
  }
}

Bijzonderheden bij verzekerings- en bankspaarproducten:

Bij inleg:

EENMALIG: in te leggen kapitaal op startdatum.
HERKOMST:
- 000 = expirerend lijfrentekapitaal
- 002 = afstorting oudedagsreserve
- 003 = bedrijfsbeëindiging/stakingswinst
- 004 = gouden handdruk
- 005 = expirerend pensioenkapitaal
HERKOMST_MAATSCHAPPIJ: in geval van een expirerend lijfrentekapitaal of een expirerend pensioenkapitaal is van belang of expiratie bij dezelfde of bij een andere maatschappij plaatsvindt. Hiervoor kan in het veld HERKOMST_MAATSCHAPPIJ een ans id van de maatschappij van herkomst worden ingevuld. Als hier -1 wordt meegegeven, geldt dat de nieuwe maatschappij hetzelfde is als de maatschappij van herkomst.

Bij uitkering:

FREQUENTIE: aantal keer per jaar dat er uitgekeerd moet worden: 12 (per maand), 4 (per kwartaal), 2 (per half jaar), 1 (per jaar)
SLOTUITK: slotuitkering ja (J) of (N)

RESPONSES

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

De belangrijkste waarden staat onder het element RESN:

Uitkeringen bij bancaire producten:

UITKERING: uitkering
TOT_UITKERING: totale uitkering als soort duur tijdelijk is

Uitkeringen bij verzekeringsproducten, met twee contractanten:

UITKERING_EERSTE: uitkering als alleen de eerste contractant leeft aan het einde van de looptijd
UITKERING_TWEEDE: uitkering als alleen de medecontractant leeft aan het einde van de looptijd
UITKERING_BEIDEN: uitkering als beiden leven aan het einde van de looptijd
TOT_UITKERING_BEIDEN: totale uitkering als soort duur tijdelijk is

Uitkeringen bij verzekeringsproducten, met één contractant:

UITKERING: uitkering
TOT_UITKERING: totale uitkering als soort duur tijdelijk is

Overige attributen zijn:

ER: Effectief rendement
RBO: Rendement bij overleven als soort duur tijdelijk is
SLOTUITK: slotuitkering ja/nee (Alleen bij verzekeringsproducten van toepassing. Het is mogelijk dat in het profiel is aangeven dat geen slotuitkering gewenst is, maar de aanbieder dat wel vereist. In dit geval wordt hier ‘J’ geretourneerd, als eerder ‘N’ gewenst was. De response wordt in dit geval ook uitgebreid met een waarschuwing.)
RENTE: gehanteerd rentepercentage (alleen bij bancaire producten)
KOOPSOM_STORTING_BINNEN_DAG: dag binnen maand waarvoor storting uiterlijk gedaan moet zijn
DATUM_EERSTE_UITKERING: datum van eerste uitkering

Bij banspaarproducten staat onder RES het waardeoverzicht.

JR: jaar X.
WRD: waarde in jaar X.

Hieronder een fragment van de response met een bancair en een verzekeringsproduct:

{
  "RESPONSES": {
    "@SESSION-ID": "ca420d88-0a09-4282-b96b-287dc03dc079",
    "@CNT": "29",
    "@MS": "14219",
    "PRD": [
      {
        "@ID": "13394",
        "@NAAM": "Gouden Handdruk Leefrekening",
        "@VERSIE": "1",
        "@AANBIEDERNAAM": "ABN AMRO",
        "@SEQUENCE": "1",
        "RESN": {
          "@ER": "0.0042",
          "@RBO": "0.0042",
          "@UITKERING": "425.5",
          "@TOT_UITKERING": "50999",
          "@SLOTUITK": "N",
          "@RENTE": "0.55",
          "@KOOPSOM_STORTING_BINNEN_DAG": "1",
          "@DATUM_EERSTE_UITKERING": "25022018",
          "RES": [
            {
              "@JR": "1",
              "@WRD": "45483.55"
            },
            {
              "@JR": "2",
              "@WRD": "40586.63"
            },
            {
              "@JR": "3",
              "@WRD": "35662.73"
            },
            {
              "@JR": "4",
              "@WRD": "30711.68"
            },
            {
              "@JR": "5",
              "@WRD": "25733.35"
            },
            {
              "@JR": "6",
              "@WRD": "20727.58"
            },
            {
              "@JR": "7",
              "@WRD": "15694.23"
            },
            {
              "@JR": "8",
              "@WRD": "10633.13"
            },
            {
              "@JR": "9",
              "@WRD": "5544.14"
            },
            {
              "@JR": "10",
              "@WRD": "0"
            }
          ]
        }
      }, 
      
      ...
         
      {
        "@ID": "3300",
        "@NAAM": "Lijfrente Garantie Polis",
        "@VERSIE": "1",
        "@AANBIEDERNAAM": "ABN AMRO",
        "@SEQUENCE": "3",
        "RESN": {
          "@ER": "-0.0134",
          "@UITKERING_EERSTE": "171.57",
          "@UITKERING_TWEEDE": "120.1",
          "@UITKERING_BEIDEN": "171.57",
          "@SLOTUITK": "N",
          "@KOOPSOM_STORTING_BINNEN_DAG": "1",
          "@DATUM_EERSTE_UITKERING": "25022018"
        }
      }
    ]
  }
}

COMMAND ¶

RESPONSES ¶

COMMAND

RESPONSES