De MoneyView API - Fiets

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 fietsverzekering te berekenen zijn klantgegevens en fietsgegevens nodig. Bij fietsverzekeringen is sprake van diefstaldekking en schadedekking. De dekkingen zullen naast elkaar getoond worden. In de uitvoer kan dus eenzelfde product vaker voorkomen met de verschillende dekking maar ook verschillende looptijden (doorlopend of aflopend, bijvoorbeeld 1,3 of 5 jaar).

In onderstaand voorbeeld staat een overzicht van de invoervelden:

{
  "profile": {
      "BEREKENING_MY": "Vraag MoneyView naar uw code",
      "SESSION_ID": "CASUS1",
      "BEREKENING_INGANGSDATUM": "20210324",
      "PERSOON_POSTCODE": "4401",
      "PERSOON_PC_LETTERS": "AA",
      "PERSOON_GEBOORTEDATUM": "19800101",
      "FIETS_BOUWDATUM": "20210301",
      "FIETS_MERK": "ONBEKEND",
      "FIETS_TYPE": "STADSFIETS",
      "FIETS_EBIKE": "NEE",
      "FIETS_AANSCHAFWAARDE": "1500",
      "FIETS_ACCESSOIRES": "0",
      "BEREKENING_ER": "0",
      "BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
      "BEREKENING_ASSU_BELAST": "NEE",
      "BEREKENING_BETALINGSTERMIJN": "JAAR",
      "BEREKENING_NULPREMIES": "JA",
      "BEREKENING_VORM": "ALLES",
      "BEREKENING_AF_DOORLOPEND": "ALLES"
    }
}

Toelichting invoer ¶

INVOERVELD	SOORT	DEFAULT	TOELICHTING OF INVULMOGELIJKHEDEN
Session_Id	String		Unieke casus identifier om de in- en uitvoer aan elkaar te kunnen koppelen
Berekening_Ingangsdatum	Integer	Huidige dag	Geef als volledig datum (YYYYMMDD)
Persoon_Postcode	Integer		Getal 1000 - 9999
Persoon_Pc_Letters	String		2 letters AA - ZZ
Persoon_Geboortedatum	Integer		geboortedatum (formaat YYYYMMDD)
Berekening_Er	integer		Wat is het gewenste eigen risico?
Berekening_Er_Afwijking_Type	String	close	[Close] of [Equal] (bij Close mag het ER afwijken)
Fiets_Bouwdatum	Integer		formaat YYYY0101, dus 20200101 voor jaar 2020
Fiets_Merk	String	onbekend	Merk is vrije invoer. Slechts een beperkt aantal merken zijn van invloed op de tarieven, deze zijn met een lookup uit te lezen (LOOKUP)
Fiets_type	String		Soort fiets [Stadsfiets] , [Atb] , [Bakfiets] , [Hybride] , [Kinderfiets] , [Ligfiets] , [Mtb] , [Racefiets] , [Tandem] , [Tourfiets] , [Vouwfiets] (LOOKUP)
Fiets_Ebike	String		[Ja]/[Nee]
Fiets_Aanschafwaarde	Integer		Bedrag in Euro’s
Fiets_Accessoires	Integer		Bedrag in Euro’s
Berekening_Assu_Belast	String		[Ja]/[Nee]
Berekening_Betalingstermijn	String		[Jaar], [Maand] (LOOKUP)
Berekening_My	String		Dit veld moet verplicht worden gevuld met een door MoneyView aangegeven waarde. Vraag de waarde op bij MoneyView.
Berekening_Nulpremies	String	Nee	[Ja] of [Nee] (toon niet geaccepteerde producten)
Berekening_Vorm	String	Alles	Filter op volgende dekkingsvarianten [Diefstal],[Schade], [Diefstal+schade] of [Alles](geen filter)
Berekening_Af_Doorlopend	String	Alles	Filter op alleen aflopende of doorlopende producten [Aflopend], [Doorlopend] of [Alles](geen filter)

Een elektrische stadsfiets zal als volgt moeten worden gevuld:

Fiets_type = Stadsfiets en Fiets_Ebike= Ja

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": "FIETS" ,
    "local": "type": "string",
    "specific": "type": "string",
    "response":{ 
      "SESSION_ID":  "type": "string" ,
      "GLOBAL":  "type": "string" ,
      "LOCAL":  "type": "string" ,
      "SPECIFIC":  "type": "string" ,
      "OPM_TARIEF":  "type": "string" ,      
      "ER_SCHADE":  "type": "integer" ,
      "ER_TOTAALVERLIES":  "type": "integer" ,
      "ER_DIEFSTAL":  "type": "integer" ,
      "KLANT_PREMIE":  "type": "number" ,
      "VERGELIJKINGSPREMIE_PER_MAAND":   "type": "number" ,
      "VERGELIJKINGSPREMIE_PER_JAAR":   "type": "number" ,
      "GLOBAL_ESCAPE_REASON":  "type": "string" ,
      "TERMIJN":  "type": "string" ,
      "LOOPTIJD_VERZEKERING": "type": "integer" ,
      "POLISKOSTEN":  "type": "number" ,
      "MIN_PREMIE":   "type": "number" ,
      "OPM_ALG":   "type": "string" 
    }
  }
}

Toelichting uitvoer ¶

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

In de specific staat de gekregen dekking:

Schade, Diefstal of Diefstal+schade

Daarnaast staat in de specific tussen haakjes de looptijd in jaren of dat het product een doorlopend product is. Tussen haakjes kan ook de duur van de aanschafwaardegarantie (AW) staan.

Vergelijkings premie ¶

Bij fietsverzekeringen kan er sprake zijn van een eenmalige premie voor een aflopende verzekering met een dekking van 3 jaar.

Om een vergelijking te maken met de premie van een doorlopende verzekering die periodiek betaald wordt zijn er 2 velden met daarin een vergelijkingspremie. De premies van zowel de aflopende- als de doorlopende producten zijn teruggerekend naar een premie per maand of per jaar.

CHANGELOG ¶

24-03-2021 - Eerste versie

01-01-2022 - revisie, carrosserie is type geworden.

25-10-2023 - Filters voor dekkingsvorm en doorlopende/aflopende producten