Back to top

De MoneyView API - Bestelauto

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 bestelauto 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 beknopt overzicht van de invoervelden:

{
  "profile": {
      "BEREKENING_MY": "Vraag MoneyView naar uw code",
      "SESSION_ID": "CASUS1",
      "BEREKENING_VORM": "WA",
      "BEREKENING_INGANGSDATUM": "20201101",
      "PERSOON_GEBOORTEDATUM": "19700101",
      "PERSOON_POSTCODE": "4401",
      "PERSOON_PC_LETTERS": "AA",
      "PERSOON_HUISNR": "1",
      "PERSOON_HUISNRTVG": "",
      "SPECIFIEK_JAREN_RIJBEWIJS": "4",
      "SPECIFIEK_SCHADEVRIJE_JAREN": "2",
      "SPECIFIEK_SCHADE_GEHAD": "NEE",
      "AUTOGEGEVENS_ACCESSOIRES": "0",
      "AUTOGEGEVENS_AUDIOAPPARATUUR": "0",
      "AUTOGEGEVENS_BOUWJAAR": "20090825",
      "AUTOGEGEVENS_KENTEKEN": "6VDN20",    
      "AUTOGEGEVENS_BRANDSTOF": "DIESEL",
      "AUTOGEGEVENS_BEVEILIGING": "SCM3",
      "AUTOGEGEVENS_INCL_BTW": "NEE",
      "AUTOGEGEVENS_MERK": "VOLKSWAGEN",
      "AUTOGEGEVENS_TYPE": "TRANSPORTER",
      "AUTOGEGEVENS_UITVOERING": "",    
      "AUTOGEGEVENS_CATALOGUSWAARDE": "49055",
      "AUTOGEGEVENS_DAGWAARDE": "5752",
      "AUTOGEGEVENS_GEWICHT": "1850", 
      "AUTOGEGEVENS_LAADVERMOGEN": "950",
      "AUTOGEGEVENS_CARROSSERIEVORM": "BESTEL",
      "AUTOGEGEVENS_TRANSMISSIE": "HANDGESCHAKELDE BAK",
      "AUTOGEGEVENS_AANDRIJVING": "V",
      "AUTOGEGEVENS_VERMOGENKW": "62", 
      "AUTOGEGEVENS_ACCELERATIE": "50",
      "BEREKENING_KILOMETRAGE": "40000",
      "BEREKENING_ER": "0",
      "BEREKENING_BEROEP": "OVERIG",   
      "BEREKENING_TREDEBESCHERMING": "NEE",
      "BEREKENING_AUTOGEBRUIK": "ZAKELIJK",
      "BEREKENING_BETALINGSTERMIJN": "JAAR",
      "BEREKENING_ASSU_BELAST": "NEE",
      "BEREKENING_FUNCTIE": "OVERIG",    
      "BEREKENING_LADING": "OVERIG",
      "BEREKENING_BRANCHE": "KANTOREN",   
      "BEREKENING_NULPREMIES": "JA",
      "BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
      "BEREKENING_ER_AFWIJKING_WAARDE": "0",
      "AUTOGEGEVENS_TURBO": "JA",
      "BEREKENING_BEDRIJFSVORM": "MKB"
  }
}

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_Autogebruik String Zakelijk [Particulier], [Zakelijk]
Berekening_Beroep String Overig Lookup lijst
Berekening_Branche String Kantoren Lookup Lijst
Berekening_Bedrijfsvorm String MKB Lookup Lijst [MKB], [ZZP]
Berekening_Functie String Overig Lookup lijst
Berekening_Lading String Overig Lookup lijst
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_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) bij Bestel nog niet gebruikt
Persoon_Huisnrtvg* String Leeg, of de toevoeging. Bij Bestel nog niet gebruikt.
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]
Berekening_Extra_dekkingen String Nee [Ja] of [Nee] (lookup)
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

Niet alle velden worden op dit moment gebruikt door verzekeraars.

De autogegevens baseren we op de velden die Solera beschikbaar heeft in de kentekenkoppeling V4 of V8. De onderstaande velden zijn voor de berekening van auto, slechts een deel wordt gebruikt bij de bestelauto. In de tabel staat vermeld welk bronveld uit de ABZ kentekenkoppeling door MoneyView gebruikt is om het Rekenengine invoerveld te vullen.

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_Dagwaarde Integer Op basis van kenteken of met formule Slechts enkele partijen gebruiken deze waarde voor de BC.
Autogegevens_Gewicht Integer Techinfo_Gewicht_Massaleegvoertuig
Autogegevens_Aandrijving String Uitvoeringsinfo_Aandrijving Zie tabel volgende pagina
Autogegevens_Carrosserievorm String Uitvoeringsinfo_Koetswerk ABZ koetswerk vertaalt naar ETX Carrosserie benaming
Autogegevens_Brandstof String Alginfo_Brandstof + Alginfo_Brandstof2 Zie tabel volgende pagina
Autogegevens_Bouwjaar String Histinfo_Datumeerstetoelating Is de eerste registratie van het voertuig
Autogegevens_Transmissie String Uitvoeringsinfo_Versnelling Zie tabel volgende pagina
Autogegevens_Vermogenkw Integer Uitvoeringsinfo_Motorvermogen motorvermogen van het voertuig in kw
Autogegevens_Laadvermogen Integer Techinfo_Gewicht_Laadvermogen Altijd leeg
Autogegevens_Acceleratie String Uitvoeringsinfo_Acceleratie Acceleratiesnelheid 0-100 km/uur in tienden van seconden
Autogegevens_Turbo String Uitvoeringsinfo_Ob_Turbo Turbo J/N Is de motor voorzien van een turbo ? (uitlaatgas gedreven aanjager)
Autogegevens_Incl_Btw String n.v.t. Ja/Nee, default is Nee
Velden hieronder worden wel bij Auto gebruik maar nog niet bij Bestel auto
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_Abz_Brochure_Gewicht Integer Uitvoeringsinfo_Ob_Afmwe Het gewicht vanuit de brochurelijsten
Autogegevens_Rdw_Leeggewicht Integer Techinfo_Gewicht_Massaleegvoertuig Het leeggewicht conform het RDW
Abz_Koetswerk String Uitvoeringsinfo_Koetswerk ABZ koetswerk onvertaald, deze is leidend boven bovenstaande.
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_Cc Integer Uitvoeringsinfo_Cilinderinhoud cilinderinhoud van de motor in cc
Autogegevens_Bpm Integer Belastinginfo_Bpm BPM RDW ( BELASTINGINFO_BPM)
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_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_Topsnelheid String Uitvoeringsinfo_Topsnelheid topsnelheid van het voertuig in km/u

Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)

ITEM KEUZES ITEM KEUZES
Branche Agrarisch Beveiligingsalarm Geen
Branche Ambacht Beveiligingsalarm Scm1
Branche Bouw Beveiligingsalarm Scm2
Branche Detailhandel Beveiligingsalarm Scm3
Branche Dienstverlening Beveiligingsalarm Scm4
Branche Groothandel Beveiligingsalarm Scm5
Branche Horeca Autogebruik Zakelijk
Branche Bezorgende horeca Autogebruik Particuler
Branche Industrie Lading Autowrakken
Branche Kantoren Lading Bloemen en/of planten
Branche Overig Lading Bouwmaterialen
Branche (Para)medisch Lading Brandstoffen
Branche Particulier Lading Chemicalien
Branche VVE Lading Collega`s
Branche Winkel Lading Containers
Branche Zorg Lading Dag- en/of weekbladen
Branche Onbekend Lading Explosieve stoffen
Gebruiksfunctie Bak- en frituurauto Lading Geld
Gebruiksfunctie Bode- en koeriersdienst Lading Groente en/of fruit
Gebruiksfunctie Demonstratie Lading Koel- en/of diepvriesprodukten
Gebruiksfunctie Exporteur Lading Licht-ontvlambare stoffen
Gebruiksfunctie Importeur Lading Melk
Gebruiksfunctie Internationaal vervoer Lading Motorrijtuigen
Gebruiksfunctie Politie en/of beveiliging Lading Personen tegen betaling
Gebruiksfunctie Ventwagen Lading Schroot en/of ijzer
Gebruiksfunctie Verhuur Lading Uitstekende lading
Gebruiksfunctie Vervoer eigen goederen Lading Vee
Gebruiksfunctie Vervoer goederen van derden Lading Vloeistoffen in tanks
Gebruiksfunctie Overig Lading Zware bouwmaterialen
Verzekeringsvorm WA Lading Overig
Verzekeringsvorm BV Tredebescherming nee
Verzekeringsvorm VC Tredebescherming alles
Verzekeringsvorm Alles

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": "BESTEL" },
    "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" },
      "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.

  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)

Generated by aglio on 06 Dec 2021