De MoneyView API - Direct ingaande pensioenen

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

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

Alle producten worden doorgerekend op basis van het producttype.

Met onderstaand voorbeeld worden de producten 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": "01102021",
        "CONTRACTANTEN": {
          "CONTRACTANT": [
            {
              "@NAAM": "Contractant 1",
              "@GEBOORTEDATUM": "03031956",
              "@GESLACHT": "M"
            },
            {
              "@NAAM": "Contractant 2",
              "@GEBOORTEDATUM": "25101954",
              "@GESLACHT": "V",
              "@OVERGANGSPRCT": "70"
            }
          ]
        },
        "PRODUCTEN": {
          "@TYPE": "DIP",
          "INLEG": {
            "@KOOPSOM_NA_2005": "50000",
            "@KOOPSOM_VOOR_2005": "0",
            "@HERKOMST": "000",
            "@HERKOMST_MAATSCHAPPIJ": "776"
          },
          "UITKERING": {
            "@FREQUENTIE": "MAAND",
            "@SLOTUITK": "N",
            "@STIJGINGSPRCT": "0",
            "@HOOGLAAG": "N",
            "@DUUR_HOOG_MND": "63",
            "@PERCENTAGE_LAAG": "75"
          }
        }
      }
    }
  }
}

Bijzonderheden

INLEG:

KOOPSOM_NA_2005: Als géén sprake is van sekseneutrale knip wordt hier opgebouwd kapitaal ingevuld. Als WEL sprake is sekseneutrale knip wordt hier opgebouwd kapitaal NA 1-1-2005 ingevuld. Mogelijke waarden: 1 tot en met 9999999.
KOOPSOM_VOOR_2005: Als sprake is van sekseneutrale knip wordt hier opgebouwd kapitaal voor 1-1-2005 ingevuld. Mogelijk waarden: 1 tot en met 9999999, waarde 0 als er geen knip is.
HERKOMST: Herkomst kapitaal: expiratie bij verzekeraar of DGA (eigen beheer); Mogelijke waarden:
- 000 - Verzekeraar
- 001 - DGA eigen beheer
HERKOMST_MAATSCHAPPIJ: Bepaalt waar kapitaal vandaan komt indien bij herkomst 000 is ingevuld. Mogelijke waarden:
- 000 - Overig
- of aanbieder id uit lijst via data request /aanbieders?json={“productsoorten”:[498]}

UITKERING:

FREQUENTIE: Uitkeringsfrequentie. Mogelijke waarden:
- MAAND
- KWARTAAL
- HALFJAAR
- JAAR
SLOTUITK: Bepaalt of rekening gehouden wordt met slotuitkering. Mogelijke waarden: J (Ja) of N (Nee).
STIJGINGSPRCT: Jaarlijks stijgingspercentage uitkering. Mogelijke waarden: 0, 1, 2, 3.
HOOGLAAG: Bepaalt of hoog/laag doorgerekend wordt. Mogelijke waarden: J (Ja) of N (Nee).
DUUR_HOOG_MND: Als HOOGLAAG ‘Ja’ is. Duur hoog in maanden als gekozen is voor J bij HOOGLAAG. Mogelijke waarden: 0 tot en met 240.
PERCENTAGE_LAAG: Als HOOGLAAG ‘Ja’ is. Bepaalt hoeveel procent de lage uitkering is t.o.v. de hoge uitkering. Mogelijke waarden: 75 tot en met 99.

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:

SRT: Soort DIP (vast of variabel), op dit moment alleen VAST.
PRCT: Gedeelte vast/variabel (op dit moment altijd 100% vast).
TVU: Totale vergelijkings uitkering. (In de totale vergelijkings uitkering worden alle uitkeringen contant gemaakt tegen 2% en opgeteld. Ook wordt er rekening gehouden met sterftekansen. Hierdoor worden eventuele dalende uitkeringen en/of hoog laag constructies vergelijkbaar gemaakt.)
ER: Effectief rendement.
OP_LL: Ouderdomspensioen laag -> als er maar één contractant is en géén HOOGLAAG staat hier de gelijkblijvende (levenslange) uitkering.
OP_HOOG: Ouderdomspensioen hoog als voor HOOG/LAAG is gekozen.
PP_LL: Partnerpensioen laag bij 2 contractanten -> als er geen HOOGLAAG is gekozen, staat hier de geblijkblijvende (levenslange) uitkering.
PP_HOOG: Partnerpensioen hoog bij 2 contractacten als er voor HOOGLAAG is gekozen.
SLOTUITK: Of bij dit product sprake is van een slotuitkering.
DATUM_EERSTE_UITKERING: Datum eerste uitkering.

Hieronder een fragment van de response:

{
  "RESPONSES": {
    "@SESSION-ID": "ca420d88-0a09-4282-b96b-287dc03dc079",
    "@CNT": "7",
    "@MS": "1421",
    "PRD": [
      {
        "@ID": "21075",
        "@NAAM": "Uitkerend Garantiepensioen",
        "@VERSIE": "12",
        "@AANBIEDERNAAM": "Aegon",
        "@SEQUENCE": "1",
        "RESN": {
          "@SRT": "VAST",
          "@PRCT": "100",
          "@TVU": "30078.5",
          "@ER": "-0.0249",
          "@OP_LL": "133.47",
          "@OP_HOOG": "177.97",
          "@PP_LL": "100.48",
          "@PP_HOOG": "100.48",
          "@SLOTUITK": "J",
          "@DATUM_EERSTE_UITKERING": "01112021"
        }
        ...
      }
    ]
  }
}

COMMAND ¶

RESPONSES ¶

COMMAND

RESPONSES