Back to top

De MoneyView API - Bromfiets

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 bromfietsverzekering 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.

In onderstaand voorbeeld staat een overzicht van de invoervelden:

{
  "profile": {
      "BEREKENING_MY": "Vraag MoneyView naar uw code",
      "SESSION_ID": "CASUS1",
      "BEREKENING_INGANGSDATUM": "20201020",
      "PERSOON_GEBOORTEDATUM": "19800101",
      "PERSOON_POSTCODE": "4401",
      "PERSOON_PC_LETTERS": "AA",
      "PERSOON_HUISNR": "1",
      "PERSOON_HUISNRTVG": "",
      "SPECIFIEK_SCHADEVRIJE_JAREN": "0",
      "BROMFIETS_BRANDSTOF": "BENZINE",
      "BROMFIETS_KENTEKEN": "FBD41L",
      "BROMFIETS_BOUWDATUM": "20200701",
      "BROMFIETS_MERK": "PIAGGIO",
      "BEREKENING_BEVEILIGING_SLOT": "GEEN",
      "BEREKENING_BEVEILIGING_ALARM": "GEEN",
      "BROMFIETS_TYPE": "VESPINO CARGO",
      "BROMFIETS_MODEL": "SNORFIETS",
      "BROMFIETS_CATALOGUSWAARDE": "1123",
      "BROMFIETS_DAGWAARDE": "1000",
      "BROMFIETS_GEWICHT": "115",
      "BROMFIETS_CILINDERINHOUD": "49",
      "BROMFIETS_VERMOGENKW": "0",
      "BROMFIETS_ACCESSOIRES": "0",
      "BROMFIETS_AUDIOAPPARATUUR": "0",
      "BROMFIETS_VERSNELLINGEN": "2",
      "BEREKENING_KILOMETRAGE": "6000",
      "BEREKENING_ER": "0",
      "BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
      "BEREKENING_TREDEBESCHERMING": "ALLES",
      "BEREKENING_VORM": "ALLES",
      "BEREKENING_GEBRUIK": "PARTICULIER",
      "BEREKENING_BROMFIETSKLEDING": "0",
      "BEREKENING_BETALINGSTERMIJN": "JAAR",
      "BEREKENING_ASSU_BELAST": "NEE",
      "BEREKENING_NULPREMIES": "JA"
  }
}

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 Huidige dag Op welke datum moet de verzekering ingaan (YYYYMMDD)
Berekening_Kilometrage String 5000 [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)
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], [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
Bromfiets_Bouwdatum Integer Geef als volledig datum (YYYYMMDD)
Bromfiets_Kenteken String
Bromfiets_Brandstof String Benzine, Diesel of Elektrisch (Lookup)
Berekening_Beveiliging_Alarm String GEEN / SCM (Lookup)
Berekening_Beveiliging_Slot String GEEN / ART / TBBS (Lookup)
Bromfiets_Merk String (Lookup)
Bromfiets_Model String (Lookup)BROMFIETS, BROMMOBIEL, BROMSCOOTER ,PEDELEC, SNORFIETS, SNORSCOOTER,SPEED PEDELEC, TWIZY
Bromfiets_Type String type of uitvoering (B.v. Rs4 125, Vespa Alpha, Leonardo 125, en vele meer)
Bromfiets_Cataloguswaarde Integer Bedrag in Euro’s
Bromfiets_Dagwaarde Integer Bedrag in Euro’s (op moment van schrijven niet van belang)
Bromfiets_Gewicht Integer Gewicht in hele kilogrammen
Bromfiets_Cilinderinhoud Integer Cilinderinhoud in CC
Bromfiets_Vermogenkw Integer Getal in kilowatt
Bromfiets_Versnellingen Integer Getal
Bromfiets_Accessoires Integer Bedrag in Euro’s
Bromfiets_Audioapparatuur Integer Bedrag in Euro’s
Berekening_Bromfietskleding Integer Bedrag in Euro’s
Berekening_Gebruik String Particulier [Particulier], [Zakelijk] (Lookup)

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": "BROMFIETS" ,
    "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_BROMFIETSKLEDING":  "type": "number" ,
      "OPM_BROMFIETSKLEDING":  "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 bromfiets.

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 - BROMFIETS_BOUWJAAR_MAAND is geworden BROMFIETS_BOUWDATUM (Het oude veld zal blijven werken maar het nieuwe veld heeft de voorkeur)

01-01-2022 - revisie

17-09-2024 - Bugfix BROMFIETS_VERSNELLING moet zijn BROMFIETS_VERSNELLINGEN. (Het oude veld zal blijven werken maar het nieuwe veld heeft de voorkeur)

Generated by aglio on 17 Sep 2024