De MoneyView API - Uitvaartverzekeringen

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 een uitvaartverzekering te berekenen zijn contractantgegevens, een dekking en betaalgegevens nodig.

Het formaat waarin de contractantgegevens worden gedefinieerd komt overeen met andere AeQuote productsoorten. Voor uitvaartverzekering is een geboortedatum altijd nodig.

Alle producten worden doorgerekend op basis van het producttype.

Als het SUBTYPE waarde ‘dekking=natura’ heeft, worden de producten waarde dekking natura heeft doorgerekend.

In geval van ‘dekking=kapitaal’ worden de producten met dekking kapitaal doorgerekend.

Als het SUBTYPE wordt weggelaten, worden beide subtypen doorgerekend.

In onderstaand voorbeeld 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": {
        "@STARTDATUM": "01052018",
        "@OMSCHRIJVING": "Vergelijking 13-04-2018",
        "CONTRACTANTEN": {
          "CONTRACTANT": [
            {
              "@ROOKGEDRAG": "J",
              "@GESLACHT": "M",
              "@GEBOORTEDATUM": "01081980",
              "@NAAM": "Persoon 1"
            },
            {
              "@ROOKGEDRAG": "J",
              "@GESLACHT": "V",
              "@GEBOORTEDATUM": "01011970",
              "@NAAM": "Persoon 2"
            }
          ]
        },
        "PRODUCTEN": {
          "@TYPE": "UITV",
          "DEKKING": {
            "@STIJGINGSPRCT": "1",
            "@VERZEKERDBEDRAG_VZ": "5000",
            "@VERZEKERDBEDRAG_MV": "4000"
          },
          "BETALING": {
            "@DUUR": "10",
            "@TERMIJN": "MAAND",
            "@TARIEF": "PREMIE"
          }
        }        
      }
    }
  }
}

Bijzonderheden:

DEKKING
- SOORT: Bij de DEKKING kan het attribuut SOORT worden meegeven met mogelijke waarden NATURA of KAPITAAL. Bij een niet-geldige soort dekking voor een geselecteerd product, zal een acceptatiemelding worden gegeven. Het is ook mogelijk via een SUBTYPE producten weg te filteren (zie hierboven).
- STIJGINGSPRCT: Gewenste indexering (indien deze niet mogelijk is, wordt in de berekening een andere indexering gekozen.)
- VERZEKERDBEDRAG_VZ en VERZEKERDBEDRAG_MV: Verzekerd bedrag eerste verzekerde en medeverzekerde.
KINDEREN
- Voor het meegeven van kinderen moet per kind een geboortedatum worden meegegeven. Hiervoor moet het element KINDEREN onder het element CONTRACT gezet worden (naast CONTRACTANTEN dus). Onder het element KINDEREN moet voor elk kind een KIND element gezet worden. Binnen het KIND element moet een attribuut GEBOORTEDATUM worden meegegeven.
BETALING
- DUUR: Mogelijke opties zijn: ‘TOT 65’, ‘TOT 85’, ‘LEVENSLANG’ of een getal voor het aantal jaren. Als gekozen is voor een specifiek aantal jaren, worden ook de andere mogelijke opties doorgerekend. Hierdoor is het mogelijk per product meerdere duren tegelijk door te rekenen.
- VASTE_DUUR: Als hier ‘J’ voor wordt meegegeven worden alleen de meegegeven duur doorgerekend. (Standaard is dit ‘N’.)
- TARIEF: KOOPSOM of PREMIE
- TERMIJN: EENMALIG (bij koopsom), MAAND, KWARTAAL, HALFJAAR of JAAR.

RESPONSES

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

De belangrijkste waarden staat onder het element RESN:

De response bevat 11 producten die in 1828 milliseconden berekend zijn. Hieronder volgt een verkorte weergave:

{
  "RESPONSES": {
    "@SESSION-ID": "a77104e4-4e0e-49fd-a0bc-221255715941",
    "@CNT": "11",
    "@MS": "1828",
    "PRD": [
      {
        "@ID": "17418",
        "@NAAM": "UitvaartPlan in Geld (direct)",
        "@VERSIE": "2",
        "@AANBIEDERNAAM": "DELA",
        "@SEQUENCE": "1",
        "DEKKING": {
          "@STIJGINGSPRCT": "0.94"
        },
        "RESN": [
          {
            "@EERSTE_TERMIJNPREMIE": "28.5",
            "@TOTALE_PREMIE": "8061.42",
            "@TOTALE_VERG_PREMIE": "6290.03",
            "@ER": "0.0189",
            "@DUUR_PREMIE_VZ_IN_MAANDEN": "336",
            "@DUUR_PREMIE_MV_IN_MAANDEN": "216",
            "@VK_LFT_80_VZ": "5981.11",
            "@VK_LFT_80_MV": "6808.62",
            "@DUUR_PREMIE": "TOT 65",
            "KOSTEN": {
              "@SOORT": "D",
              "@BEDRAG": "0.1",
              "@TERMIJN": "MAAND",
              "@DUUR_IN_MAANDEN": "120"
            }
          }
        }
      },
      
      ....
      
}

DEKKING STIJGINGSPRCT: Gebruikte indexatie tijdens de berekening. Deze kan anders zijn dan in de invoer omdat de dichtstbijzijnde indexatie gebruikt indien de gevraagde indexering niet mogelijk is.
EERSTE_TERMIJNPREMIE: Termijn eerste premie
DUUR_PREMIE_VZ_IN_MAANDEN: Premieduur in maanden verzekerde
DUUR_PREMIE_MV_IN_MAANDEN: Premieduur in maanden medeverzekerde
TOTALE_VERG_PREMIE: Over betalingsperiode contant gemaakte totale premie. Hiermee kan een correcte vergelijking gemaakt worden.
ER: Het verwachte rendement bij het afsluiten van de verzekering rekening houdend met de toekomstige premiebetalingen en verwachte uitkering. (Effectief rendement)
VK_LFT_80_VZ: Verzekerd bedrag 80 jaar verzekerde
VK_LFT_80_MV: Verzekerd bedrag 80 jaar medeverzekerde
KOSTEN: In geval van soort “D”, distributiekosten bij de verzekering, met een BEDRAG, TERMIJN en DUUR_IN_MAANDEN

COMMAND ¶

RESPONSES ¶

COMMAND

RESPONSES