De MoneyView API - Auto
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 auto 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 en informatie uit verschillende kenteken koppelingen. 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. Omdat het best lastig is de aansluiting gelijk te vinden hebben we een basis profiel opgesteld waarmee een autocall kan worden gedaan. Deze call bevat de belangrijkste velden, voor enkele partijen zou dit voldoende zijn om een juiste premie te krijgen echter sommige partijen kennen meer premie bepalende velden.
Hieronder een voorbeeld profiel:
{ "profile": {
"BEREKENING_MY": "Vraag MoneyView naar uw code",
"SESSION_ID": "CASUS1",
"BEREKENING_VORM": "ALLES",
"BEREKENING_INGANGSDATUM": "20240201",
"PERSOON_POSTCODE": "2597",
"PERSOON_PC_LETTERS": "HJ",
"PERSOON_GEBOORTEDATUM": "19940115",
"SPECIFIEK_SCHADEVRIJE_JAREN": "6",
"AUTOGEGEVENS_KENTEKEN": "R389XZ",
"AUTOGEGEVENS_MERK": "MAZDA",
"AUTOGEGEVENS_TYPE": "MX-5",
"AUTOGEGEVENS_UITVOERING": "2.0 SKYAC-G 184 LUX.",
"AUTOGEGEVENS_CARROSSERIEVORM": "SOFTTOP",
"AUTOGEGEVENS_BOUWJAAR": "20230115",
"AUTOGEGEVENS_BRANDSTOF": "BENZINE",
"AUTOGEGEVENS_GEWICHT": "1087",
"AUTOGEGEVENS_CATALOGUSWAARDE": "53450",
"AUTOGEGEVENS_DAGWAARDE": "53450",
"AUTOGEGEVENS_ACCELERATIE": "65",
"AUTOGEGEVENS_AANDRIJVING": "A",
"AUTOGEGEVENS_TRANSMISSIE": "H",
"AUTOGEGEVENS_DEUREN": "2",
"AUTOGEGEVENS_CC": "1998",
"AUTOGEGEVENS_TURBO": "N",
"AUTOGEGEVENS_VERMOGENKW": "135",
"UITVOERINGSINFO_TOPSNELHEID": "219",
"AUTOGEGEVENS_ATL_ENERGIELABEL": "E",
"SEGMENT": "O - OPEN",
"AUTOGEGEVENS_IMPORT": "NEE",
"AUTOGEGEVENS_ACCESSOIRES": "0",
"AUTOGEGEVENS_AUDIOAPPARATUUR": "0",
"AUTOGEGEVENS_BEVEILIGING": "SCM5",
"BEREKENING_KILOMETRAGE": "12000",
"BEREKENING_ER": "100",
"BEREKENING_TREDEBESCHERMING": null,
"BEREKENING_BETALINGSTERMIJN": "MAAND",
"BEREKENING_ASSU_BELAST": "JA",
"BEREKENING_NULPREMIES": "JA",
}
Om een idee te geven hoe een uitgebreid profiel er kan uitzien hieronder nog een voorbeeld.
{ "profile": {
"BEREKENING_MY": "Vraag MoneyView naar uw code",
"SESSION_ID": "CASUS1",
"BEREKENING_VORM": "WA",
"BEREKENING_INGANGSDATUM": "20200707",
"PERSOON_GEBOORTEDATUM": "19740403",
"PERSOON_POSTCODE": "9502",
"PERSOON_PC_LETTERS": "PN",
"PERSOON_HUISNR": "20",
"SPECIFIEK_BM_VERKLARING": "JA",
"SPECIFIEK_SCHADEVRIJE_JAREN": "5",
"SPECIFIEK_SCHADE_GEHAD": "0",
"BEREKENING_KILOMETRAGE": "20000",
"BEREKENING_ER": "0",
"BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
"BEREKENING_ER_AFWIJKING_WAARDE": "0",
"BEREKENING_TREDEBESCHERMING": "NEE",
"BEREKENING_BETALINGSTERMIJN": "MAAND",
"BEREKENING_ASSU_BELAST": "JA",
"BEREKENING_NULPREMIES": "JA",
"AUTOGEGEVENS_BOUWJAAR": "20190205",
"AUTOGEGEVENS_KENTEKEN": "XF-004-R",
"AUTOGEGEVENS_BRANDSTOF": "BENZINE",
"AUTOGEGEVENS_BEVEILIGING": "SCM2",
"AUTOGEGEVENS_MERK": "PEUGEOT",
"AUTOGEGEVENS_TYPE": "5008",
"AUTOGEGEVENS_UITVOERING": "1.2 PURETECH ALLURE",
"AUTOGEGEVENS_CARVARIANT": "",
"AUTOGEGEVENS_CATALOGUSWAARDE": "43290",
"AUTOGEGEVENS_CW_RDW": "43290",
"AUTOGEGEVENS_DAGWAARDE": "29638",
"AUTOGEGEVENS_GEWICHT": "1405",
"AUTOGEGEVENS_ABZ_BROCHURE_GEWICHT": "1405",
"AUTOGEGEVENS_RDW_LEEGGEWICHT": "1405",
"AUTOGEGEVENS_LAADVERMOGEN": "0",
"AUTOGEGEVENS_TOTAALGEWICHT": "2150",
"AUTOGEGEVENS_CARROSSERIEVORM": "SUV",
"AUTOGEGEVENS_DEUREN": "5",
"AUTOGEGEVENS_AANDRIJVING": "VOOR",
"AUTOGEGEVENS_TRANSMISSIE": "AUTOMATISCHE TRANSMISSIE",
"AUTOGEGEVENS_CC": "1199",
"AUTOGEGEVENS_VERMOGENKW": "96",
"AUTOGEGEVENS_ACCELERATIE": "102",
"AUTOGEGEVENS_TURBO": "JA",
"AUTOGEGEVENS_KLEUR": "GRIJS",
"AUTOGEGEVENS_ATLCODE": "178795",
"AUTOGEGEVENS_ACCESSOIRES": "0",
"AUTOGEGEVENS_AUDIOAPPARATUUR": "0",
"BEREKENING_AUTOGEBRUIK": "PARTICULIER",
"BEREKENING_CATEGORIE": "EIGEN AUTO",
"BEREKENING_BEROEP": "OVERIG",
"AUTOGEGEVENS_BRANDSTOF1_ABZ": "BENZINE",
"AUTOGEGEVENS_BRANDSTOF2_ABZ": "",
"AUTOGEGEVENS_MERK_RDW": "PEUGEOT",
"AUTOGEGEVENS_HANDELSBENAMING": "5008",
"AUTOGEGEVENS_AANTALCILINDERS": "3",
"AUTOGEGEVENS_AANTALZITPLAATSEN": "7",
"AUTOGEGEVENS_ATL_ENERGIELABEL": "B",
"AUTOGEGEVENS_CO2UITSTOOT": "119",
"AUTOGEGEVENS_TOPSNELHEID": "196",
"MILIEUINFO_ZUINIGHEIDSLABEL": "B",
"ACCESSOIRESINFO_ABS": "J",
"ACCESSOIRESINFO_AIRBAG": "J",
"ACCESSOIRESINFO_PARKEERSENSOREN": "N",
"ACCESSOIRESINFO_STABILITYCONTROL": "N",
"ACCESSOIRESINFO_TRACTIONCONTROL": "N",
"AUTOGEGEVENS_IMPORT": "N"
}
De velden worden in delen toegelicht. 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 | 20000 | [ONBEPERKT], getal tussen 0 - 99999 (lookup)(zie toelichting) |
Berekening_Autogebruik | String | Particulier | [Particulier], [Zakelijk] |
Berekening_Beroep | String | Overig | Lookup lijst (het beroep is al langere tijd geen premie bepalende factor |
Berekening_Categorie | String | eigen auto | [lease/bedrijfsauto] of [eigen auto] (lookup) |
Berekening_Er | String | 300 | [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_Geslacht | String | Man | [Man] of [Vrouw] (lookup)(deze waarde is op dit moment niet van belang voor de berekening.) |
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_Bm_Verklaring | String | JA | [Ja] of [Nee] Heeft verzekerde een BM verklaring? (bij nee wordt Schadevrije jaren op 0 gezet) |
Specifiek_Jaren_Rijbewijs | Int | 0 | Hoeveel jaar heeft verzekerde een rijbewijs? (Op dit moment niet van belang voor de berekening) |
Specifiek_Schade_Gehad | String | Nee | Heeft verzekerde schade gehad in afgelopen 5 jaar?(Op dit moment niet van belang voor de berekening) |
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] zie toelichting. |
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. | |
Uitvoer_Top_Aantal | String | Alles | [Alles] geeft alle resultaten weer, [getal n] geeft de n laagste premies per vorm terug. |
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 wat 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 werkt alleen bij type": “sauwa” |
Bc | Toon alleen de producten met WA + BeperktCasco dekking werkt alleen bij type": “saubc” |
Vc | Toon alleen de producten met WA + VolledigCasco dekking werkt alleen bij type": “sauvc” |
Alles | Toon alle producten van alle vormen onder elkaar werkt bij alle typen |
In de uitvoer vind je VORM ook terug, daar kan deze zijn WA, WABC, WAVC, ALLE of ALLES.
MoneyView werkt met de autodatabase van Autotelex. Solera/abz biedt een kenteken koppeling waarbij de autodata van RDW wordt gekoppeld aan de data van Autotelex. Let op, alleen de kenteken data van RDW gebruiken zal niet voldoende zijn om tot aansluitende premies te komen. Verzekeraars gebruiken aanvullende data van het voertuig om tot hun tarieven te komen. De autogegevens baseren we op de velden die ABZ beschikbaar heeft in de kentekenkoppeling V4 of V8. De meeste velden worden op dit moment niet gebruikt door verzekeraars. In de tabel staat vermeld welk bronveld uit de ABZ kentekenkoppeling door MoneyView gebruikt is om het Rekenengine invoerveld te vullen. De informatie over de kenteken koppeling kan wat gedateerd zijn, MoneyView kan helpen met de juiste vertaling te maken van velden uit een kenteken koppeling.
INVOERVELD | SOORT | ABZ_BRONVELD | TOELICHTING OF INVULMOGELIJKHEDEN |
---|---|---|---|
Autogegevens_Atlcode | INT | Uitvoeringsinfo_Atlcodemeestwaarschijnlijk | Unieke autotelex code |
Autogegevens_Kenteken | String | Parameters_Kenteken | |
Autogegevens_Merk | string(50) | Uitvoeringsinfo_Merk | Merk beschrijving |
Autogegevens_Type | string(30) | Uitvoeringsinfo_Model | Type(model) beschrijving |
Autogegevens_Uitvoering | string(40) | Uitvoeringsinfo_Type | Uitvoering beschrijving. |
Autogegevens_Cataloguswaarde | Integer | Prijsinfo_Consum_Prijs_Incl_Meeruitv_Inclbtw | Prijsinfo_Consum_Prijs_Incl_Meeruitv_Inclbtw Omdat dit voor de meeste partijen de gebruikte catwaarde is. |
Autogegevens_Cw_Rdw | Integer | Histinfo_Rdwcatalogusprijs | Het bedrag dat door de importeur bij het aanvragen van een kenteken is opgegeven als catalogusprijs voor een voertuig op het moment van aanvragen. De catalogusprijs is opgebouwd uit de netto-catalogusprijs, inclusief af-fabriek accessoires, vermeerderd met de BPM en de omzetbelasting. De catalogusprijs vormt de grondslag voor het berekenen van de fiscale bijtelling voor het prive gebruik van een leaseauto, maar wordt geregistreerd voor alle personenauto’s en lichte bedrijfswagens. De catalogusprijs wordt door de RDW voor de Belastingdienst geregistreerd, maar de RDW is niet verantwoordelijk voor de juiste en volledige aanlevering. |
Autogegevens_Dagwaarde | Integer | Op basis van kenteken of met formule | Slechts enkele partijen gebruiken deze waarde voor de BC. |
Autogegevens_Gewicht | Integer | Techinfo_Gewicht_Massaleegvoertuig | Het leeggewicht conform het RDW |
Autogegevens_Abz_Brochure_Gewicht | Integer | Uitvoeringsinfo_Ob_Afmwe | Het gewicht vanuit de brochurelijsten (enkele partijen gebruiken dit boven het leeggewicht) |
Autogegevens_Rdw_Leeggewicht | Integer | Techinfo_Gewicht_Massaleegvoertuig | Het leeggewicht conform het RDW (gelijk aan Autogegevens_Gewicht, zie toelichting onder de tabel) |
Autogegevens_Aandrijving | String | Uitvoeringsinfo_Aandrijving | Zie tabel hieronder |
Autogegevens_Carrosserievorm | String | Uitvoeringsinfo_Koetswerk | De carrosserie vorm kent vele schijfwijzen MoneyView streeft ernaar ze allemaal te herkennen. zie de Lookup lijst) |
Abz_Koetswerk | String | Uitvoeringsinfo_Koetswerk | ABZ koetswerk onvertaald, deze is leidend boven bovenstaande. |
Autogegevens_Brandstof | String | Alginfo_Brandstof + Alginfo_Brandstof2 | Zie tabel hieronder |
Autogegevens_Bouwjaar | String | Histinfo_Datumeerstetoelating | Is de eerste registratie van het voertuig Format: YYYYMMDD |
Autogegevens_Brandstof1_Abz | String | Alginfo_Brandstof | Eerste brandstof () |
Autogegevens_Brandstof2_Abz | String | Alginfo_Brandstof2 | Tweede brandstof () |
Autogegevens_Deuren | String | Uitvoeringsinfo_Aantaldeurencommercieel | Aantal deuren (Commercieel dus incl. achterklep) |
Autogegevens_Transmissie | String | Uitvoeringsinfo_Versnelling | Zie tabel volgende pagina |
Autogegevens_Cc | Integer | Uitvoeringsinfo_Cilinderinhoud | cilinderinhoud van de motor in cc |
Autogegevens_Vermogenkw | Integer | Uitvoeringsinfo_Motorvermogen | motorvermogen van het voertuig in kw |
Autogegevens_Bpm | Integer | Belastinginfo_Bpm | BPM RDW ( BELASTINGINFO_BPM) |
Autogegevens_Laadvermogen | Integer | Techinfo_Gewicht_Laadvermogen | Altijd leeg |
Autogegevens_Totaalgewicht | Integer | Techinfo_Gewicht_Maximummassa | |
Abz_Inrichting | String | Techinfo_Uitvoering_Inrichting | |
Autogegevens_Kleur1 | String | Techinfo_Uitvoering_Kleur1 | Kleur aanduiding |
Autogegevens_Kleur2 | String | Techinfo_Uitvoering_Kleur2 | Leeg of 2e kleur |
Autogegevens_Merk_Rdw | String | Alginfo_Merk | RDW beschrijving |
Autogegevens_Handelsbenaming | String | Alginfo_Handelsbenaming | RDW beschrijving |
Autogegevens_Aantalcilinders | String | Uitvoeringsinfo_Aantalcilinders | aantal cilinders van de motor |
Autogegevens_Aantalzitplaatsen | String | Uitvoeringsinfo_Aantalzitplaatsen | Het aantal zitplaatsen |
Autogegevens_Acceleratie | String | Uitvoeringsinfo_Acceleratie | Acceleratiesnelheid 0-100 km/uur in tienden van seconden |
Autogegevens_Atl_Energielabel | String | Uitvoeringsinfo_Atl_Energielabel | Autotelex energie label |
Autogegevens_Carvariant | String | Uitvoeringsinfo_Carvariant | Autotelex carrosserie variant |
Autogegevens_Co2Uitstoot | String | Uitvoeringsinfo_Co2uitstoot | De CO2 uitstoot |
Autogegevens_Hybride | String | Uitvoeringsinfo_Hybride | |
Autogegevens_Turbo | String | Uitvoeringsinfo_Ob_Turbo | Turbo J/N Is de motor voorzien van een turbo ? (uitlaatgas gedreven aanjager) |
Autogegevens_Topsnelheid | String | Uitvoeringsinfo_Topsnelheid | topsnelheid van het voertuig in km/u |
Autogegevens_Import | String | Additioneelinfo_Import | j/n of leeg |
Toelichting gewichtsvelden
Het basis veld voor gewicht is “Autogegevens_Gewicht” dat is het ledig gewicht van het voertuig zoals het RDW deze registreert maar kan ook een gewicht bevatten zoals deze in de autodatabase staat. Enkele partijen gebruiken echter het gewicht zoals het in de brochures staat, daarvoor is het veld “Autogegevens_Abz_Brochure_Gewicht”. “Autogegevens_Rdw_Leeggewicht” is erbij gekomen om duidelijk aan te geven dat dit gewicht gebaseerd is op de RDW database. Wanneer het veld “Autogegevens_Gewicht” wordt gevuld met het ledig gewicht van het RDW dan hoeft het veld “Autogegevens_Rdw_Leeggewicht” niet gevuld te worden.
Toelichting brandstof
Een voertuig kan meerdere brandstofsoorten hebben. Hoewel Elektriciteit geen brandstof is wordt het nog wel zo genoemd. Het RDW geeft de brandstofsoorten die bij een kenteken horen met een volgnummer door. De unieke opties zijn Alcohol, Benzine, CNG, Diesel, Elektriciteit, LNG, LPG of Waterstof
Een hybride benzine wordt doorgegeven als Benzine en Elektriciteit of Elektriciteit en Benzine. Voertuigen met 3 soorten bestaan ook, meestal zit er dan ook een LPG tank in.
MoneyView kent een samengesteld veld om de brandstof van het voertuig te herkennen. De optie voor AUTOGEGEVENS_BRANDSTOF staan hieronder, eventueel kunnen aanvullend de losse opties worden doogegeven als AUTOGEGEVENS_BRANDSTOF1_ABZ en AUTOGEGEVENS_BRANDSTOF2_ABZ. Enkele partijen kijken alleen naar AUTOGEGEVENS_BRANDSTOF1_ABZ. Een Benzine/Elektriciteit kan dan of een Benzine of Elektriciteit zijn afhankelijk van hoe RDW de volgorde van de brandstofcodes heeft.
MoneyView optie | RDW brandstof 1 | RDW brandstof 2 | RDW brandstof 3 | |
---|---|---|---|---|
Benzine | Benzine | |||
Diesel | Diesel | |||
Lpg | LPG | Benzine | ||
Elektriciteit | Elektriciteit | |||
Benzine/Elektriciteit | Benzine | Elektriciteit | ||
Diesel/Elektriciteit | Diesel | Elektriciteit | ||
Cng of Aardgas | CNG | |||
Waterstof | Waterstof |
De volgende velden zijn beschikbaar bij de kenteken service en kunnen ook meegegeven worden met de call naar de rekenengine.
De velden met een * kunnen op dit moment invloed hebben op de premie
INVOERVELD | SOORT | ABZ_BRONVELD | TOELICHTING OF INVULMOGELIJKHEDEN |
---|---|---|---|
Milieuinfo_Co2Uitstootgecombineerd | String | Gecombineerde CO2 uitstoot RDW | |
*Milieuinfo_Zuinigheidslabel | String | RDW Energie label | |
*Prijsinfo_Afleverkosten | Integer | ||
Prijsinfo_Bpmnieuwprijs | Integer | BPM bedrag over het netto catalogusprijs volgens de importeur | |
Prijsinfo_Btwnieuwprijs | Integer | BTW bedrag over het netto catalogusprijs | |
Prijsinfo_Catalogusprijs* | Integer | catalogusprijs ten tijde afgifte datum deel 1(systeemdatum i.g.v. gereserveerde kentekens, datum eerste toelating i.g.v. parallel import) Incl. BTW en BPM, excl. opties. | |
Prijsinfo_Consum_Prijs_Incl_Meeruitv_Exclbtw | Integer | benadering van de consumentenprijs excl. BTW, inclusief fabrieksmatig aangebrachte- en BPM-bezwaarde meeruitvoeringen ten tijde van de datum van het kentekenbewijs deel, berekend op basis van het op het kentekenbewijs opgenomen wettelijke BPM-bedrag | |
*Prijsinfo_Consum_Prijs_Incl_Meeruitv_Inclbtw | Integer | benadering van de consumentenprijs incl. BTW, inclusief fabrieksmatig aangebrachte- en BPM-bezwaarde meeruitvoeringen ten tijde van de datum van het kentekenbewijs deel, berekend op basis van het op het kentekenbewijs opgenomen wettelijke BPM-bedrag | |
Prijsinfo_Datumprijslijst | String | ||
Prijsinfo_Nettocatalogusprijs | String | netto catalogusprijs (exclusief BPM en BTW) ten tijde afgifte datum deel 1 (systeemdatum i.g.v. gereserveerde kentekens, datum eerste toelating i.g.v. parallel import) exclusief opties | |
*Accessoiresinfo_Abs | String | j/n of leeg. Aangezien elke auto die na 2004 in europa verkocht is deze functie moet hebben gaan we uit van ja als dit veld leeg is en het bouwjaar vanaf 2003 is. | |
Accessoiresinfo_Airbag | String | j/n of leeg | |
Accessoiresinfo_Beveiliging | String | j/n of leeg | |
Accessoiresinfo_Cruisecontrol | String | j/n of leeg | |
*Accessoiresinfo_Parkeersensoren | String | j/n of leeg | |
*Accessoiresinfo_Stabilitycontrol | String | j/n of leeg | |
*Accessoiresinfo_Tractioncontrol | String | j/n of leeg | |
Histinfo_Datumeersteafgiftened | Integer | Datum Deel 1 Formaat yyyymmdd | |
Histinfo_Datumlaatstetenaamstelling | Integer | Datum Deel 2 Formaat yyyymmdd |
Onderstaande velden alleen bij de V8 licentie. De dagwaarde kan gebruikt worden om het veld dagwaarde te vullen. MoneyView gebruikt onderstaande velden nog niet met uitzondering van segment, deze wordt wel gebruikt door enkele partijen en kan worden doorgegeven in het veld SEGMENT. Bij het ontbreken van het segment in het profiel proberen we op basis van merk model en carrosserie het segment alsnog te bepalen.
INVOERVELD | SOORT | ABZ_BRONVELD | TOELICHTING OF INVULMOGELIJKHEDEN |
---|---|---|---|
Alginfo_Vervaldatumapk | Integer | Formaat yyyymmdd | |
Alginfo_Wielbasis | Integer | Wielbasis in cm van de uitvoering | |
Prijsinfo_Dagwaardeexchange | Integer | Restwaarde inruil in hele euro’s | |
Prijsinfo_Dagwaarderetail | Integer | Restwaarde verkoop in hele euro’s | |
Prijsinfo_Dagwaarderetailzakelijk | Integer | Restwaarde verkoop in hele euro’s zakelijk; excl btw en BPM | |
Prijsinfo_Dagwaardetrade | Integer | Restwaarde handel in hele euro’s | |
Prijsinfo_Dagwaardetradezakelijk | Integer | Restwaarde handel in hele euro’s zakelijk; excl btw en BPM | |
Uitvoeringsinfo_Ob_Segment | String | Voertuig segment (Format: letter - beschrijving : “O - OPEN”) |
Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)
ITEM | KEUZES | ITEM | KEUZES | |
---|---|---|---|---|
Turbo | Ja | voertuig_beveilig_alarm | scm1 | |
Turbo | Nee | voertuig_beveilig_alarm | scm2 | |
Turbo | Turbo | voertuig_beveilig_alarm | scm4 | |
Turbo | voertuig_beveilig_alarm | scm3 | ||
Voertuig_transmissie | Handgeschakelde bak | voertuig_beveilig_alarm | scm5 | |
Voertuig_transmissie | Automatische transmissie | voertuig_beveilig_alarm | geen | |
Voertuig_transmissie | Variabele transmissie | voertuig_categorie | lease/bedrijfsauto | |
Voertuig_transmissie* | Automaat traploos sequentieel | voertuig_categorie | eigen auto | |
Voertuig_transmissie* | Halfautomatische versnellingsbak | voertuig_gebruik | particulier | |
Voertuig_transmissie* | Automaat sequentieel | voertuig_gebruik | zakelijk | |
Voertuig_aandrijving | Voor | Eigen Risico | 0 - 2000 | |
Voertuig_aandrijving | Achter | Eigen Risico | Standaard | |
Voertuig_aandrijving | 4WD | Brandstof | Benzine | |
verzekeringsvorm | wa | Brandstof | Diesel | |
verzekeringsvorm | bc | Brandstof | Lpg | |
verzekeringsvorm | vc | Brandstof | Elektriciteit | |
verzekeringsvorm | alles | Brandstof | Benzine/Elektriciteit | |
tredebescherming | ja | Brandstof | Diesel/Elektriciteit | |
tredebescherming | nee | Brandstof | Cng of Aardgas | |
tredebescherming | alles | Brandstof | Waterstof | |
voertuig_kilometrage | 0 - 99999 | |||
voertuig_kilometrage | Onbeperkt |
- Keuze optie voor transmissie kunnen beperkt worden tot de eerste 3, de overige waarden kunnen wel vanuit Autotelex worden meegegeven.
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": "AUTO" },
"local": {"type": "string"},
"specific": {"type": "string"},
"response": {
"SESSION_ID": { "type": "string" },
"GLOBAL": { "type": "string" },
"LOCAL": { "type": "string" },
"SPECIFIC": { "type": "string" },
"EIGENRISICO": { "type": "integer" },
"VORM": { "type": "string" },
"KLANT_PREMIE": { "type": "number" },
"OPM_TARIEF": { "type": "string" },
"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" },
"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" },
"BM_KT_PERC_WA": { "type": "number" },
"BM_KT_PERC_CA": { "type": "number" },
"BM_KT_WA": { "type": "number" },
"BM_KT_CA": { "type": "number" },
"NETTO_CA": { "type": "number" },
"NETTO_CA_SUB": { "type": "number" },
"TP_NETTO_CA_SUB": { "type": "number" },
"NETTO_WA": { "type": "number" },
"TP_NETTO_WA": { "type": "number" },
"KTT_BRUTO_CA": { "type": "number" },
"KTT_BRUTO_WA": { "type": "number" },
"KTT_NETTO_CA": { "type": "number" },
"KTT_NETTO_WA": { "type": "number" },
"EXTRA_BM_TREDE_WA": { "type": "integer" },
"EXTRA_BM_TREDE_CA": { "type": "integer" },
"MIN_PREMIE": { "type": "number" },
"ER_VRIJEKEUS": { "type": "integer" },
"ER_DIEFSTAL": { "type": "integer" },
"OPM_BIJKOMENDE_KOSTEN": { "type": "string" },
"BIJKOMENDE_KOSTEN": { "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 groene velden vallen buiten de standaard berekeningsopbouw en zijn ter informatie in het plaatje opgenomen.
-
Bruto WA premiedeel voor afspraakkorting
-
Berekende bruto afspraakkorting voor WA deel
-
Bruto premie na afspraakkorting voor WA deel (ook algemene bruto premie) TP_Bruto_Wa bevat het: Bruto_WA * termijn toeslag / termijn deler.
-
Berekend BM kortingsbedrag voor WA deel
-
Berekende Netto afspraakkorting voor WA deel
-
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.
-
Bruto Casco premiedeel voor afspraakkorting
-
Berekende bruto afspraakkorting voor Cascodeel
-
Bruto premie na afspraakkorting voor Cascodeel
TP_Bruto_CA bevat het: Bruto_CA * termijn toeslag / termijn deler.
-
Berekend BM kortingsbedrag voor Cascodeel
-
Berekende Netto afspraakkorting voor Cascodeel
-
Netto Cascodeel (bruto/netto kortingen en Extra treden zijn toegepast)
-
Algemeen Netto toeslag (b.v. BC deel bijtellen of netto toeslag ER afkoop).
-
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.
-
Audio- en accessoires premie wanneer er sprake is van een los pakket.
-
Totaal Netto premie
-
Het termijn toeslagpercentage (of bij uitzondering indien van toepassing het vaste bedrag)
-
Minimum termijnpremie
-
Eindpremie exclusief tredebeschermingspremie (eventueel opgehoogd naar minimum premie)
-
Premie t.b.v. trede bescherming
-
Eindpremie inclusief tredebescherming
-
Eindpremie inclusief Assurantiebelasting indien gekozen.
-
Bedrag aan poliskosten
-
Hier is nog ruimte voor een algemene opmerking met betrekking tot de specifieke vorm.
Let op,
-
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)
Extra dekkingen Auto
De extra dekkingen voor auto zijn technisch gezien aan te roepen als losse call. Echter de ontwikkeling van deze tarieven laten steeds meer zien dat het eigenlijk samen met de auto berekening plaats zou moeten vinden. Doordat bijvoorbeeld bij de pechhulp maar ook bij OIV vaak meerdere varianten zijn is het integreren in de reguliere call weer lastig. We zoeken nog een goede manier om dit te doen. Tot die tijd staat hier nog de huidige manier om deze dekkingen uit te vragen maar tarieven zijn niet voor alle producten bijgewerkt. Indien de wens is om deze tarieven te gebruiken kan dat alleen in goed overleg met MoneyView.
Voor het aanroepen van de aanvullende dekkingen van auto (ED_AUTO) moet onderstaande beschrijving worden gebruikt. De onderstaande aanvullende dekkingen kunnen worden berekend:
-
Schadeverzekering inzittenden (SVI)
-
Ongevallen inzittenden verzekering (OIV)
-
Rechtsbijstandverzekering (RBV)
-
Pechhulp (PH)
Voor het aanroepen van de Extra dekkingen kan één van de bovenstaande afkortingen gebruikt worden als type. Het is mogelijk om met één call alle vier de verschillende dekkingen uit te vragen. Daarnaast is het ook mogelijk om een alleen één losse dekking uit te vragen. Dit is afhankelijk van de keuzes bij de velden “OIV”, “SVI”, “RBS” en “HULPVERLENING”.
De invoervelden “AUTO_LOCAL” en “AUTO_SPECIFIC” hoeven alleen gevuld te worden als een specifieke maatschappij wordt gevraagd.
ED_AUTO - Input (ScripletEngineRequest)
{
"profile": {
"BEREKENING_INGANGSDATUM": "20180321",
"PERSOON_GEBOORTEDATUM": "19800101",
"PERSOON_POSTCODE": "4401",
"PERSOON_PC_LETTERS": "AA",
"AUTO_LOCAL": "null",
"AUTO_SPECIFIC": "null",
"BEREKENING_AUTOGEBRUIK": "PARTICULIER",
"BEREKENING_CATEGORIE": "EIGEN AUTO",
"AUTOGEGEVENS_CARROSSERIEVORM": "HATCHBACK",
"BEREKENING_BETALINGSTERMIJN": "JAAR",
"SPECIFIEK_SCHADEVRIJE_JAREN": "0",
"OIV": "JA",
"OIV_VB_A": "5000",
"OIV_VB_B": "10000",
"OIV_AANTAL_ZITPLAATSEN": "4",
"SVI": "JA",
"SVI_VB": "500000",
"SVI_AANTAL_ZITPLAATSEN": "4",
"RBS": "JA",
"HULPVERLENING": "JA",
"AUTOGEGEVENS_BOUWJAAR": "20180301",
"BEREKENING_ASSU_BELAST": "JA",
"BEREKENING_MY": "...",
"BEREKENING_NULPREMIES": "JA"
}
}
ED_AUTO - Toelichting invoer
Voor de velden waar Lookup bij staat is een keuzelijst beschikbaar
INVOERVELD | SOORT | VOORBEELD OF FORMAT | TOELICHTING OF INVULMOGELIJKHEDEN |
---|---|---|---|
Auto_Local | string | Bij welke maatschappij komen deze dekkingen | |
Auto_Specific | string | Bij welke product komen deze dekkingen | |
Berekening_Ingangsdatum | string | yyyymmdd | Op welke datum moet de verzekering ingaan |
(t.b.v. actie periodes.) | |||
Autogegevens_Carrosserievorm | string | Carrosserievorm uit Autotelex database (lookup) | |
Persoon_Postcode | string | Getal 1000 - 9999 | |
Persoon_Pc_Letters | string | 2 letters AA - ZZ | |
Berekening_Autogebruik | string | Particulier | [Particulier], [Zakelijk] (lookup) |
Berekening_Categorie | string | eigen auto | [lease/bedrijfsauto] of [eigen auto] (lookup) |
Oiv | string | [Ja]/[Nee] Is OIV dekking gewenst? | |
Oiv_Vb_A | integer | 5000 / 10000 / 15000 / 20000 / 25000 | |
Oiv_Vb_B | integer | 10000 / 20000 / 30000 / 40000 / 50000 | |
Oiv_Aantal_Zitplaatsen | int | 1-9 | |
Svi | string | [Ja]/[Nee] Is SVI dekking gewenst? | |
Svi_Vb | integer | 500000 / 1000000 / 2500000 | |
Svi_Aantal_Zitplaatsen | integer | 1-9 | |
Rbs | string | [Ja]/[Nee] ] Is Rechtsbijstanddekking gewenst? | |
Hulpverlening | string | [Ja]/[Nee] ] Is dekking voor Hulpverlening gewenst? | |
Specifiek_Schadevrije_jaren | Integer | 0 | Hoeveel schadevrije jaren heeft verzekerde? |
Autogegevens_Bouwjaar | Integer | yyyymmdd | Wat is de bouwdatum van de auto t.b.v. hulpverlening? |
Berekening_Nulpremies | string | [Ja] of [Nee] (toon producten die geen acceptatie hebben. | |
Berekening_Betalingstermijn | string | Jaar | [Jaar], [Half jaar], [Kwartaal], [Maand] (lookup) |
Berekening_My | string | Klant identifier |
ED_AUTO - Keuzelijsten (lookup)
ITEM | KEUZES | ITEM | KEUZES | |
---|---|---|---|---|
Carrosserievorm | Cabriolet | voertuig_categorie | eigen auto | |
Carrosserievorm | Coupe | voertuig_gebruik | particulier | |
Carrosserievorm | Hatchback | voertuig_gebruik | zakelijk | |
Carrosserievorm | MPV | |||
Carrosserievorm | Pick-Up | |||
Carrosserievorm | Roadster | |||
Carrosserievorm | Sedan | |||
Carrosserievorm | Stationwagon | |||
Carrosserievorm | Terreinwagen |
ED_AUTO - Output (ScripletEngineResponse)
Per aanvullende dekking wordt er een afzonderlijk response gestuurd
{
"ScripletEngineResponseParameters": {
"task": "type": "string", "#text": "PROCESS_ONE" ,
"global": "type": "string", "#text": "ED_AUTO" ,
"local": "type": "string",
"specific": "type": "string",
"response":{
"GLOBAL": "string",
"LOCAL": "string",
"SPECIFIC": "string",
"SOORT": "String",
"PREMIE": "number",
"VB_OIV_A": "integer",
"VB_OIV_B": "integer",
"AANTAL_ZITPLAATSEN": "string",
"POLISKOSTEN": "number",
"ASSU_PERC": "number",
"CODE": "integer"
}
}
ED_AUTO - Toelichting uitvoer
Voor elke soort dekking is een los product beschikbaar.
UITVOERVELD | SOORT | TOELICHTING |
---|---|---|
GLOBAL | string | Module naam |
LOCAL | string | Maatschappijnaam |
SPECIFIC | string | Product (meestal verzekering soort) |
SOORT | string | Soort dekking: OIV / SVI / RBS / HULP of OIV/SVI |
PREMIE | number | Premie bedrag |
VB_OIV_A | integer | Verzekerd bedrag A voor OIV (alleen bij soort OIV) |
VB_OIV_B | integer | Verzekerd bedrag B voor OIV (alleen bij soort OIV) |
AANTAL_ZITPLAATSEN | string | Aantal gedekte zitplaatsen |
VB_SVI | integer | Verzekerd bedrag SVI (alleen bij soort SVI) |
POLISKOSTEN | number | Poliskosten |
OPM | string | Algemene opmerking m.b.t. het product |
PECHHULP_DEKKINGSGEBIED | string | Korte beschrijving dekkingsgebied van de pechhulp |
GLOBAL_ESCAPE_REASON | string | Reden voor niet tonen van een premie |
Bijzonderheden bij de extra dekkingen: Op deze premie zijn geen minimum termijn premies toegepast.
Overzicht Dekkingsgebied codes
De onderstaande codes worden gescheiden met een pipeline (|) in plaats van de komma (,).
PECHHULP_DEKKINGSGEBIED CODE | Uitleg |
---|---|
NL, WNP | Nederland incl. Woonplaats |
EU, WNP | Europa incl. Woonplaats |
NL | Alleen Nederland (excl. woonplaats) |
EU | Europa (excl. woonplaats) |
BL | Buitenland (Europa excl. Nederland) |