Back to top

De MoneyView API - Motor

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 “Engine” producten is te vinden op de pagina met algemene documentatie. Het is raadzaam deze eerst te lezen alvorens te beginnen aan de documentatie hieronder.

COMMAND

Om een premie voor een motorverzekering te berekenen zijn klantgegevens, de dekking en het voertuig nodig.

MoneyView kent een groot aantal invoervelden om zoveel mogelijk aansluiting te vinden met de tarieven van de maatschappijen. Enkele velden hebben hun functie verloren doordat een product die dat veld gebruikte is weggevallen. Een voorbeeld hiervan is het veld Berekening_Beroep. MoneyView kiest ervoor zo’n veld niet gelijk uit het invoer profiel te halen maar deze te vullen met een standaard waarde. Daarmee blijft het later mogelijk dat een product weer gebruik gaat maken van een dergelijk veld.

In onderstaand voorbeeld staat een overzicht van de invoervelden:

{
  "profile": {
      "BEREKENING_MY": "Vraag MoneyView naar uw code",
      "SESSION_ID": "CASUS1",
      "BEREKENING_VORM": "VC",
      "BEREKENING_INGANGSDATUM": "20190601",
      "PERSOON_GEBOORTEDATUM": "19670806",
      "PERSOON_POSTCODE": "4401",
      "PERSOON_PC_LETTERS": "AA",
      "PERSOON_HUISNR": "1",
      "PERSOON_HUISNRTVG": "A",
      "SPECIFIEK_SCHADEVRIJE_JAREN": "15",
      "BEREKENING_KILOMETRAGE": "5000",
      "BEREKENING_ER": "0",
      "BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
      "BEREKENING_ER_AFWIJKING_WAARDE": "0",
      "BEREKENING_TREDEBESCHERMING": "NEE",
      "BEREKENING_BETALINGSTERMIJN": "JAAR",
      "BEREKENING_ASSU_BELAST": "NEE",
      "BEREKENING_NULPREMIES": "JA",
      "MOTOR_BOUWDATUM": "20180401",
      "MOTOR_KENTEKEN": "19MJNS",
      "MOTOR_BRANDSTOF": "BENZINE",
      "BEREKENING_BEVEILIGING_ALARM": "GEEN",
      "BEREKENING_BEVEILIGING_SLOT": "TBBS",   
      "MOTOR_MERK": "SUZUKI",
      "MOTOR_MODEL": "ALL-ROAD",
      "MOTOR_UITVOERING": "DL 650 V-STROM ABS",
      "MOTOR_CATALOGUSWAARDE": "8999",
      "MOTOR_DAGWAARDE": "6122",
      "MOTOR_GEWICHT": "214",
      "MOTOR_RDW_LEEGGEWICHT": "210",
      "MOTOR_CILINDERINHOUD": "645",
      "MOTOR_VERMOGENKW": "51",
      "MOTOR_ACCESSOIRES": "0",
      "MOTOR_AUDIOAPPARATUUR": "0",
      "MOTOR_ZIJSPAN": "NEE",
      "SPECIFIEK_WINTERSTOP": "NEE",
      "BEREKENING_MOTORKLEDING": "0",
      "BEREKENING_GEBRUIK": "PARTICULIER"
  }
}

Allereerst een toelichting op de niet voertuig specifieke velden :

INVOERVELD SOORT VOORBEELD / FORMAT TOELICHTING OF INVULMOGELIJKHEDEN
Session_Id String Unieke casus identifier om de in- en uitvoer aan elkaar te kunnen koppelen
Berekening_Ingangsdatum Int yyyymmdd Op welke datum moet de verzekering ingaan
Berekening_Kilometrage String 40000 [ONBEPERKT], getal tussen 0 - 99999 (LOOKUP)(zie toelichting)
Berekening_Er String 0 [Standaard] of getal (LOOKUP)
Berekening_Er_Afwijking_Type String close [Close] of [Equal] (bij Close mag het ER afwijken)
Berekening_Er_Afwijking_Waarde Int 0 Niet van toepassing, altijd 0
Persoon_Geboortedatum Int yyyymmdd Geboortedatum van de verzekerde
Persoon_Postcode String Getal 1000 - 9999
Persoon_Pc_Letters String 2 letters AA - ZZ
Persoon_Huisnr String Leeg, Getal (Op moment van schrijven 1 - 99137)
Persoon_Huisnrtvg String Leeg, of de toevoeging.
Specifiek_Schadevrije_Jaren Int 0 Hoeveel schadevrije jaren heeft verzekerde?
Berekening_Tredebescherming String nee [Ja], [Nee], [alles] Zie toelichting
Berekening_Vorm String Alles [WA], [BC], [VC] of [Alles]
Berekening_Betalingstermijn String Jaar [Jaar], [Half jaar], [Kwartaal], [Maand] (LOOKUP)
Berekening_Assu_Belast String Ja [Ja] of [Nee]
Berekening_Nulpremies String Nee [Ja] of [Nee] (toon niet geaccepteerde producten)
Berekening_My String Dit veld moet verplicht worden gevuld met een door MoneyView aangegeven waarde. Vraag de waarde op bij MoneyView.

Keuzeopties Kilometrage

In dit veld kan in een willekeurig getal worden opgegeven, dit getal wordt als minimale eis gesteld. Dit betekent dat je bij een getal van 20000 bij sommige partijen in de “tot en met 20000” klasse komt maar bij andere partijen in de "vanaf 20000 tot … " klasse komt.

Als het geen harde lijn is, kan gekozen worden voor 19999 als kilometrage naar de engine mee te geven, dat zorgt ervoor dat bij alle partijen een vergelijkbare klasse wordt verkregen die “tot” en “tot en met” kan zijn.

In de lookup lijst staan de meest gangbare kilometrage grenzen.

In de uitvoer staat altijd het gekregen maximum kilometrage is.

Keuzeopties Tredebescherming Beschrijving
Ja Toon alleen de producten die tredebescherming kennen
Nee Toon alle producten zonder tredebeschermer
Alles Toon alle producten waarbij de producten die tredebescherming kennen inclusief tredebescherming zijn. De overige producten zijn exclusief tredebescherming.
Keuzeopties Berekening_Vorm Beschrijving
Wa Toon alleen de producten met WA-Sec dekking
Bc Toon alleen de producten met WA + BeperktCasco dekking
Vc Toon alleen de producten met WA + VolledigCasco dekking
Alles Toon alle producten van alle vormen onder elkaar

De overige velden hebben betrekking op het voertuig.

INVOERVELD SOORT DEFAULT TOELICHTING OF INVULMOGELIJKHEDEN
Motor_Bouwdatum Integer Geef als volledig datum (YYYYMMDD)
Motor_Kenteken String
Motor_Brandstof String Benzine, Diesel of Elektrisch (Lookup)
Berekening_Beveiliging_Alarm String GEEN / ART / TBBS (Lookup)
Berekening_Beveiliging_Slot String GEEN / SCM (Lookup)
Motor_Merk String (Lookup)
Motor_Model String (Lookup)
Motor_Uitvoering String
Motor_Cataloguswaarde Integer Bedrag in Euro’s
Motor_Dagwaarde Integer Bedrag in Euro’s
Motor_Gewicht Integer Gewicht in hele kilogrammen
Motor_Rdw_Leeggewicht Integer Het leeggewicht conform het RDW
Motor_Cilinderinhoud Integer Cilinderinhoud in CC
Motor_Vermogenkw Integer Getal in Kilowattage
Motor_Accessoires Integer Bedrag in Euro’s
Motor_Audioapparatuur Integer Bedrag in Euro’s
Berekening_Motorkleding Integer Bedrag in Euro’s
Berekening_Gebruik String (Lookup)
Motor_Zijspan String [Ja]/[Nee]
Specifiek_Winterstop String [Ja]/[Nee]

RESPONSES

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

{
  "ScripletEngineResponseParameters": {
 "task": {
    "type": "string", "#text": "PROCESS_TWO" },
    "global": {"type": "string", "#text": "MOTOR" },
    "local": {"type": "string"},
    "specific": {"type": "string"},
    "response": {
      "SESSION_ID": { "type": "string" },
      "GLOBAL": { "type": "string" },
      "LOCAL": { "type": "string" },
      "SPECIFIC": { "type": "string" },
      "OPM_TARIEF": { "type": "string" },      
      "EIGENRISICO": { "type": "integer" },
      "VORM": { "type": "string" },
      "KLANT_PREMIE": { "type": "number" },
      "DK_TB": { "type": "string" },
      "TP_EXCL_TB": { "type": "number" },
      "TP_PD_TB": { "type": "number" },
      "OPM_TB": { "type": "string" },
      "SUB_TOTAAL": { "type": "number" },
      "TP_TOTAAL": { "type": "number" },
      "ED_AUDIO_ACC": { "type": "number" },
      "OPM_AUDIO_ACC": { "type": "string" },
      "ED_MOTORKLEDING": { "type": "number" },
      "OPM_MOTORKLEDING": { "type": "string" },
      "NETTO_TOESLAG": { "type": "number" },
      "OPM_NETTO_TOESLAG": { "type": "string" },
      "TERMIJN_PERC": { "type": "string" },
      "TERMIJN": { "type": "string" },
      "POLISKOSTEN": { "type": "number" },
      "KILOMETRAGE": { "type": "string" },
      "REGIO": { "type": "string" },
      "SCHADEVRIJEJAREN": { "type": "integer" },
      "GLOBAL_ESCAPE_REASON": { "type": "string" },
      "OPM_ALG": { "type": "string" },
      "BP_WA": { "type": "number" },
      "BP_CA": { "type": "number" },
      "BRUTO_CA": { "type": "number" },
      "TP_BRUTO_CA": { "type": "number" },
      "BRUTO_WA": { "type": "number" },
      "TP_BRUTO_WA": { "type": "number" },
      "BM_TREDE_WA": { "type": "integer" },
      "BM_TREDE_CA": { "type": "integer" },
      "NETTO_CA": { "type": "number" },
      "NETTO_CA_SUB": { "type": "number" },
      "TP_NETTO_CA_SUB": { "type": "number" },
      "NETTO_WA": { "type": "number" },
      "TP_NETTO_WA": { "type": "number" },
      "MIN_PREMIE": { "type": "number" }
    }
  }
}

Toelichting uitvoer

De eindpremie, die getoond moet worden, is de KLANT_PREMIE.

Daarnaast kunnen getoond worden: poliskosten, vorm (WA, BC, VC), eigen risico en eventueel kilometrage.

Onderstaande geeft een beschrijving van de uitvoervelden. Onder het schema wordt per regelnummer een toelichting gegeven.

Als de uitvoervelden volgens bovenstaande structuur worden geplaatst is de premie opbouw te zien. De afspraak functie werkt niet bij Motor.

De groene velden vallen buiten de standaard berekeningsopbouw en zijn ter informatie in het plaatje opgenomen.

  1. Bruto WA premiedeel voor afspraakkorting

  2. Berekende bruto afspraakkorting voor WA deel

  3. Bruto premie na afspraakkorting voor WA deel (ook algemene bruto premie) TP_Bruto_Wa bevat het: Bruto_WA * termijn toeslag / termijn deler.

  4. Berekend BM kortingsbedrag voor WA deel

  5. Berekende Netto afspraakkorting voor WA deel

  6. Netto WA deel (bruto/netto kortingen en Extra treden zijn toegepast) TP_Netto_Wa bevat het: Netto_WA * termijn toeslag / termijn deler.

Het blauwe gedeelte dat alleen bij BC en VC van toepassing is.

  1. Bruto Casco premiedeel voor afspraakkorting

  2. Berekende bruto afspraakkorting voor Cascodeel

  3. Bruto premie na afspraakkorting voor Cascodeel

    TP_Bruto_CA bevat het: Bruto_CA * termijn toeslag / termijn deler.

  4. Berekend BM kortingsbedrag voor Cascodeel

  5. Berekende Netto afspraakkorting voor Cascodeel

  6. Netto Cascodeel (bruto/netto kortingen en Extra treden zijn toegepast)

  7. Algemeen Netto toeslag (b.v. BC deel bijtellen of netto toeslag ER afkoop).

  8. Netto_CA_Sub is de optelling van Netto_CA en Netto_toeslag, Exclusief Audio_Acc_Premie. TP_Netto_CA_Sub bevat het: Netto_CA_Sub * termijn toeslag / termijn deler.

  9. Audio- en accessoires premie wanneer er sprake is van een los pakket.

  10. Totaal Netto premie

  11. Het termijn toeslagpercentage (of bij uitzondering indien van toepassing het vaste bedrag)

  12. Minimum termijnpremie

  13. Eindpremie exclusief tredebeschermingspremie (eventueel opgehoogd naar minimum premie)

  14. Premie t.b.v. trede bescherming

  15. Eindpremie inclusief tredebescherming

  16. Eindpremie inclusief Assurantiebelasting indien gekozen.

  17. Bedrag aan poliskosten

  18. Hier is nog ruimte voor een algemene opmerking met betrekking tot de specifieke vorm.

De eindpremie, die getoond moet worden, is de KLANT_PREMIE.

Daarnaast kunnen getoond worden: poliskosten, vorm (WA, BC, VC), eigen risico en eventueel kilometrage.

  • voor een aantal producten kan de uitgebreide informatie ontbreken.

  • enkele producten volgen niet het hele bruto - netto traject tussentijdse premie kunnen hierop worden gecorrigeerd. B.v. . (Netto_wa, Netto_ca en TP_EXCL_TB)

CHANGELOG

20-11-2020 - MOTOR_BOUWJAAR_MAAND is geworden MOTOR_BOUWDATUM (Het oude veld zal blijven werken maar het nieuwe veld heeft de voorkeur)

Generated by aglio on 06 Dec 2021