De MoneyView API - Pakketverzekering Inboedel_Opstal
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 Inboedel_Opstal te berekenen zijn klantgegevens, de dekking wensen en woning informatie nodig. Bij de betaling moet een termijn worden meegegeven. Dit kan zijn MAAND, KWARTAAL, HALF JAAR of JAAR.
In onderstaand voorbeeld zijn de velden te zien:
{
"profile": {
"BEREKENING_MY": "Vraag MoneyView naar uw code",
"SESSION_ID": "CASUS1",
"BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
"BEREKENING_ER_AFWIJKING_WAARDE": "0",
"BEREKENING_INGANGSDATUM": "20230123",
"PERSOON_GEBOORTEDATUM": "19780505",
"PERSOON_POSTCODE": "4401",
"PERSOON_PC_LETTERS": "AA",
"PERSOON_HUISNR": "11",
"PERSOON_HUISNRTVG": "",
"PERSOONLIJKE_OMSTANDIGHEDEN": "GEZIN ZONDER KINDEREN",
"WHS_TYPE": "RIJTJESWONING",
"WHS_WOZ": "250000",
"WHS_OPP": "120",
"WHS_BOUWAARD": "STEEN/HARD",
"WHS_BUITENZIJDE": "STEEN",
"WHS_KAMERS": "5",
"WHS_EIGENAAR": "JA",
"WHS_GLAS": "GEEN",
"BEREKENING_ER": "0",
"WHS_BEVEILIGING": "GEEN",
"BEREKENING_VORM": "EUG+AR",
"AVP_DEKKING": "JA",
"AVP_VB": "1000000",
"BEREKENING_BETALINGSTERMIJN": "JAAR",
"BEREKENING_ASSU_BELAST": "NEE",
"BEREKENING_NULPREMIES": "JA",
"INB_WAARDEBEPALING": "WAARDEMETER",
"PERSOON_INKOMEN": "1800",
"INB_STANDAARD": "0",
"INB_DIEFSTALRISICO": "NEE",
"INB_LIJFSIERADEN": "0",
"INB_COMPUTER": "0",
"INB_AUDIO": "0",
"INB_ANTIEK": "0",
"INB_VERZAM": "0",
"INB_KUNST": "0",
"INB_INSTR": "0",
"INB_OVERIG": "0",
"INB_HUURDERSBELANG": "0",
"BEREKENING_TOTAAL": "0",
"INB_BHD": "NEE",
"INB_BHD_VB": "0",
"IBW_INFOFOLIO": "",
"WHS_BESTAAND": "NEE",
"WHS_BOUWJAAR": "20060101",
"WHS_VERD_VLOER": "BETON",
"OPS_WAARDEBEPALING": "WAARDEMETER",
"WHS_HBW": "0",
"WHS_FUNDERING": "NEE",
"WHS_CONSTRUCTIE": "NORMAAL",
"WHS_CONSTRUCTIE_DAKISOLATIE": "NEE",
"WHS_GEVEL": "NORMAAL",
"WHS_GEVEL_ISOLATIE": "NEE",
"WHS_AFWERKING": "NORMAAL",
"WHS_KEUKEN": "0",
"WHS_BADKAMER": "0",
"WHS_AFBOUW_JONGER_DAN_10JR": "LEEG",
"WHS_ZONNEPANELEN": "LEEG",
"WHS_M3_WONING": "150",
"WHS_GARAGE": "GEEN",
"WHS_M3_GARAGE": "0",
"WHS_BERGING": "NEE",
"WHS_M3_BERGING": "0",
"WHS_M3_BIJGEBOUW": "0",
"HBW_INFOFOLIO": "",
"WHS_EIGEN_BEWONING": "JA"
}
}
Uitleg velden:
INVOERVELD | SOORT | DEFAULT OF FORMAT | TOELICHTING OF INVULMOGELIJKHEDEN |
---|---|---|---|
Session_Id | String | Unieke casus identifier | |
Berekening_Ingangsdatum | Int | yyyymmdd | Op welke datum moet de verzekering ingaan? |
Persoon_Postcode | Int | 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. Lijst is beschikbaar. | |
Persoonlijke_Omstandigheden | String | Gezinssituatie (LOOKUP) | |
Persoon_Geboortedatum | Int | yyyymmdd | Geboortedatum van de verzekerde. |
Persoon_inkomen | Int | Bedrag in euro’s | |
Inb_Waardebepaling | String | Lijst (LOOKUP) | |
Inb_Antiek | Int | Bedrag aan Antiek (Ook standaard deel) | |
Inb_Audio | Int | Bedrag aan Apparatuur (Ook standaard deel) | |
Inb_Computer | Int | Bedrag aan Computers (Ook standaard deel) | |
Inb_Diefstalrisico | String | Ja | [Ja]/[Nee] |
Inb_Huurdersbelang | Int | Bedrag aan Huurdersbelang (Ook standaard deel) | |
Inb_Instr | Int | Bedrag aan Instrumenten (Ook standaard deel) | |
Inb_Kunst | Int | Bedrag aan Kunst (Ook standaard deel) | |
Inb_Lijfsieraden | Int | Bedrag aan lijfsieraden (Ook standaard deel) | |
Inb_Overig | Int | Bedrag aan Overige bijzondere inboedel (Ook standaard deel) | |
Inb_Standaard | String | Bedrag aan normale (huisraad) inboedel | |
Inb_Verzam | Int | Bedrag aan Verzamelingen’ (Ook standaard deel) | |
Ops_Waardebepaling | String | Type waardemeter (LOOKUP) | |
Whs_Afwerking | String | Constructie van de afwerking (LOOKUP) | |
Whs_Badkamer | Int | Waarde van de badkamer. | |
Whs_Berging | String | [Ja]/[Nee] Meeverzekeren niet-inpandige berging. | |
Whs_Bestaand | String | Ja | [Ja]/[Nee] |
Whs_Beveiliging | String | Geen | Lijst (LOOKUP) |
Whs_Bouwaard | String | (LOOKUP) | |
Whs_Bouwjaar | Int | yyyymmdd | Bouwdatum |
Whs_Buitenzijde | String | Steen | [steen]/[hout] (LOOKUP) |
Whs_Constructie | String | Constructie van de woning (LOOKUP) | |
Whs_Constructie_Dakisolatie | String | Leeg | Isolatiewaarde hoger dan de minimale rc/rd waarde [Ja]/[Nee] (alleen Ja heeft effect) |
Whs_Eigen_Bewoning | String | Ja | [Ja]/[Nee] |
Whs_Eigenaar | String | Nee | [Ja]/[Nee] |
Whs_Fundering | String | Meeverzekeren van de fundering (LOOKUP) | |
Whs_Garage | String | Type garage (LOOKUP) | |
Whs_Gevel | String | Constructie van de gevel (LOOKUP) | |
Whs_Gevel_Isolatie | String | Leeg | Isolatiewaarde hoger dan de minimale rc/rd waarde [Ja]/[Nee] (alleen Ja heeft effect) |
Whs_Glas | String | Geen | geen ,enkel glas ,dubbel glas (LOOKUP) |
Whs_Hbw | Int | Herbouwwaarde | |
Whs_Kamers | Int | 1 tot 99 meer dan 9 vaak niet geaccepteerd. | |
Whs_Keuken | Int | Waarde van de keuken | |
Whs_M3_Berging | Int | Inhoud van de berging/garage (m3)? | |
Whs_M3_Bijgebouw | Int | Inhoud van de bijgebouwen excl berging/garage (m3)? | |
Whs_M3_Garage | Int | Inhoud van de berging/garage (m3)? | |
Whs_M3_Woning | Int | Inhoud van de woning excl bijgebouwen (m3)? | |
Whs_Opp | Int | Getal in m² | |
Whs_Type | String | (LOOKUP) | |
Whs_Verd_Vloer | String | beton | Aard van de verdiepingsvloer(en) (LOOKUP) |
Whs_Woz | Int | Bedrag in euro’s (t.b.v. oude waardemeter) | |
Whs_Afbouw_Jonger_Dan_10jr | String | [Ja]/[Nee] | |
Whs_Zonnepanelen | String | Nee | [Ja]/[Nee] meer dan wettelijk minimum bij bestaande bouw. |
Inb_Bhd | String | Nee | [Ja]/[Nee] |
Inb_Bhd_Vb | Int | 0 | Bedrag voor buitenshuisdekking. |
Avp_Dekking | String | Nee | [Ja]/[Nee] |
Avp_Vb | String | 1000000 | Minimale eis voor dekking [1000000], [1250000], [2500000] (LOOKUP) |
Berekening_Assu_Belast | String | Nee | [Ja]/[Nee] |
Berekening_Betalingstermijn | String | Jaar | [Jaar], [Half jaar], [Kwartaal], [Maand] (LOOKUP) |
Berekening_Er | Int | Getal (LOOKUP) | |
Berekening_Er_Afwijking_Type | String | Close | [Close] of [Equal] |
Berekening_Er_Afwijking_Waarde | Int | Niet van toepassing, altijd 0 | |
Berekening_Meerjarig | String | Exclusief | [exclusief] of [inclusief](langere contractsduren) |
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 | Leeg | te kiezen verzekeringsvorm bv. AR (Lookup) |
Toelichting Buitenshuisdekking
De buitenshuisdekking is extra te sluiten bij een aantal maatschappijen. Het kan zijn dat er dan al sprake is van een pakket. Daarom is naast de buitenshuisdekking velden ook een pakketkortingveld opgenomen.
Toelichting Huisnummer en Toevoeging
Maatschappijen beginnen te kijken of het exacte adres gebruikt kan worden om tot een tarief te komen. Om dat in de toekomst te kunnen doen hebben we vast de benodigde velden in de documentatie opgenomen.
Toelichting Isolatie
Whs_Constructie_Dakisolatie en Whs_Gevel_Isolatie heeft volgens het verbond betrekking op een extra isolatie die na de eerste bouw is gedaan vanuit duurzaamheid subsidie of andere overwegingen.
Toelichting AVP bij woonverzekering
Bij de woonverzekeringen zijn de premies voor de aansprakelijkheidsverzekeringen aan de losse premieberekeningen toegevoegd. Wanneer de dekking voor een aansprakelijkheidsverzekering gevraagd is dan wordt naast een inboedel- en/of opstalpremie ook een AVP-premie berekend. Hierbij wordt ook rekening gehouden met de extra pakketkortingen die van toepassing kunnen zijn door het sluiten van meerdere verzekeringen.
Bij het inbouwen van de premies voor de aansprakelijkheidsverzekeringen binnen de woonverzekeringen zijn de volgende uitgangspunten gebruikt:
-
De getoonde premie geldt voor een basisdekking zonder jagersrisico en zonder verhuur van een tweede (vakantie)woning.
-
Het opgegeven verzekerde bedrag is een minimale eis. Als een verzekerde een dekking van 2,5 miljoen wil dan worden geen premies getoond van verzekeraars die dit niet kunnen bieden.
-
De gezinssituatie bij de woonverzekering is hetzelfde als voor de aansprakelijkheidsverzekering.
-
Het eigen risico dat voor de woonverzekering gevraagd is, is ook het gevraagde eigen risico voor de aansprakelijkheidsverzekering.
-
Wanneer een verzekerde geen kinderen heeft dan wordt ervan uitgegaan dat de verzekerde een eigen risico voor kinderen wil om zo premiekorting te krijgen, indien de maatschappij dit biedt.
Wanneer deze dekking wordt opgevraagd dan worden extra uitvoervelden met informatie toegevoegd aan de bestaande uitvoer. Informatie met betrekking tot de pakketregeling staat in deze velden:
- “TOESLAG_EUG_PAKKET”: “number”
- “TOESLAG_AR_PAKKET”: “number”
- “PAKKETKORTINGS_PERCENTAGE”: “number”
En de AVP velden:
- “NETTO_PREMIE_AVP”: “number”
- “AVP_MAX_VB”: “string”
- “AVP_ER_ALG”: “integer”
- “AVP_ER_KIND”: “integer”
Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)
ITEM | KEUZES | ITEM | KEUZES | |
---|---|---|---|---|
Whs_Bouwaard | steen/hard | Whs_Verd_Vloer | beton | |
Whs_Bouwaard | hout/hard | Whs_Verd_Vloer | hout | |
Whs_Bouwaard | steen/riet | Whs_Buitenzijde | hout | |
Whs_Bouwaard | houtskeletbouw | Whs_Buitenzijde | steen | |
Whs_Bouwaard | hout/riet | Whs_Buitenzijde | hout | |
Whs_Bouwaard | steen/kunstof riet/onduline | Whs_Buitenzijde | steen | |
Whs_Bouwaard | steen/hard riet onderschoten | Whs_Garage | geen | |
Whs_Bouwaard | zweedse/deense/finse woning | Whs_Garage | inpandig | |
Whs_Bouwaard | zaanse woning | Whs_Garage | aangebouwd | |
Whs_Bouwaard | steen/riet met draad op panlatten | Whs_Garage | vrijstaand | |
Whs_Bouwaard | steen/riet met spijkerdaken | Whs_Garage | dubbel | |
Whs_Bouwaard | steen/hard | Whs_Glas | geen | |
Whs_Type | Rijtjeswoning | Whs_Glas | enkel glas | |
Whs_Type | Hoekwoning | Whs_Glas | dubbel glas | |
Whs_Type | 2-1 Kapwoning | Whs_Constructie | normaal | |
Whs_Type | Vrijstaande woning | Whs_Constructie | bijzonder | |
Whs_Type | Villa | Whs_Constructie | plat | |
Whs_Type | Woonboerderij | Whs_Fundering | nee | |
Whs_Type | Herenhuis | Whs_Fundering | ja heiwerk | |
Whs_Type | Grachtenpand | Whs_Fundering | ja op zand | |
Whs_Type | Monumentaal pand | Whs_Gevel | normaal | |
Whs_Type | Appartement / flat (1-4 lagen) | Whs_Gevel | ||
Whs_Type | Appartement / flat (5-99 lagen) | Whs_Gevel | ||
Whs_Type | Etagewoning | Whs_Gevel | kopgevel | |
Whs_Type | Recreatiewoning | Whs_Afwerking | luxe | |
persoonlijke_omstandigheden | alleenstaande zonder kinderen | Whs_Afwerking | normaal | |
persoonlijke_omstandigheden | gezin zonder kinderen | Whs_Afwerking | hoogwaardig | |
persoonlijke_omstandigheden | alleenstaande met kinderen | Berekening_Er | 0 | |
persoonlijke_omstandigheden | gezin met kinderen | Berekening_Er | 100 | |
inb_waardebepaling | waardemeter | Berekening_Er | 225 | |
inb_waardebepaling | inventarislijst | Berekening_Er | 450 | |
inb_waardebepaling | eigen opgave | Berekening_Vorm | 1 regel | |
Ops_Waardebepaling | waardemeter | Berekening_Vorm | ar | |
Ops_Waardebepaling | taxatierapport | Berekening_Vorm | eug | |
Ops_Waardebepaling | eigen opgave | Berekening_Vorm | alles Of leeg laten | |
Whs_Beveiliging | Politiekeurmerk veilig wonen | Berekening_Vorm | eug+ar | |
Whs_Beveiliging | BORG certificaat | |||
Whs_Beveiliging | beide | |||
Whs_Beveiliging | geen | |||
RESPONSES
RESPONSE versie bij “UITVOER_PERVORM”: “NEE”
Hieronder de reponse van een berekende premie. Deze response bevat aanbieder en productnaam.
Deze response geeft de EUG en AR premie in losse velden
De uitvoer “UITVOER_PERVORM”: “JA” is niet beschikbaar bij de combi module.
{
"ScripletEngineResponseParameters": {
"task": "type": "string", "#text": "PROCESS_ONE",
"global": "type": "string", "#text": "INBOEDEL_OPSTAL",
"local": "type": "string",
"specific": "type": "string",
"response": [
{
"GLOBAL": "string",
"LOCAL": "string",
"SPECIFIC": "string",
"SESSION_ID": "string",
"INB_BP_EUG": "number",
"INB_BP_AR": "number",
"OPS_BP_EUG": "number",
"OPS_BP_AR": "number",
"COM_BP_EUG": "number",
"COM_BP_AR": "number",
"COM_BRUTO_PREMIE_EUG": "number",
"COM_BRUTO_PREMIE_AR": "number",
"COM_TOESLAG_EUG_ER": "number",
"COM_TOESLAG_AR_ER": "number",
"INB_TOESLAG_EUG_BEVEILIGING": "number",
"INB_TOESLAG_AR_BEVEILIGING": "number",
"INB_LS_STANDAARD": "string",
"INB_AA_STANDAARD": "string",
"INB_CPU_STANDAARD": "string",
"INB_HUUR_STANDAARD": "string",
"INB_PREMIE_EUG_LS": "number",
"INB_PREMIE_EUG_AA": "number",
"INB_PREMIE_EUG_CPU": "number",
"INB_PREMIE_EUG_HUUR": "number",
"INB_PREMIE_AR_LS": "number",
"INB_PREMIE_AR_AA": "number",
"INB_PREMIE_AR_CPU": "number",
"INB_PREMIE_AR_HUUR": "number",
"INB_LS_HUIDIGE_DEKKING": "string",
"INB_AA_HUIDIGE_DEKKING": "string",
"INB_CPU_HUIDIGE_DEKKING": "string",
"INB_HUUR_HUIDIGE_DEKKING": "string",
"COM_PREMIE_EUG_GLAS": "number",
"COM_PREMIE_AR_GLAS": "number",
"COM_TOESLAG_EUG_TERMIJN": "number",
"COM_TOESLAG_AR_TERMIJN": "number",
"COM_TOESLAG_EUG_CONTRACTDUUR": "number",
"COM_TOESLAG_AR_CONTRACTDUUR": "number",
"COM_NETTO_PREMIE_EUG": "number",
"COM_NETTO_PREMIE_AR": "number",
"COM_NETTO_TERMIJNPREMIE_EUG": "number",
"COM_NETTO_TERMIJNPREMIE_AR": "number",
"COM_TOTAAL_PREMIE_EUG": "number",
"COM_TOTAAL_PREMIE_AR": "number",
"COM_ASSU_EUG": "number",
"COM_ASSU_AR": "number",
"TOESLAG_EUG_PAKKET": "number",
"TOESLAG_AR_PAKKET": "number",
"PAKKETKORTINGS_PERCENTAGE": "number",
"OPM_PAKKETTEKST1": "string",
"COM_PROLONGATIEKOSTEN": "number",
"COM_POLISKOSTEN": "number",
"INB_EIGENRISICO": "string",
"OPS_EIGENRISICO": "string",
"INB_DUUR": "string",
"INB_TERMIJN_TOESLAG": "number",
"INB_MIN_PREMIE": "number",
"OPS_DUUR": "string",
"OPS_TERMIJN_TOESLAG": "number",
"OPS_MIN_PREMIE": "number",
"INB_SUB_BEDRAGEN_EUG": "number",
"INB_SUB_BEDRAGEN_AR": "number",
"INB_BEVEILIGING_PERC": "integer",
"INB_OPM_EUG": "string",
"INB_OPM_AR": "string",
"INB_ER_UITLEG": "string",
"OPS_ER_UITLEG": "string",
"GLOBAL_ESCAPE_REASON": "string",
"INB_MAX_VB": "string",
"OPS_MAX_VB": "string",
"INB_METER": "string",
"OPS_METER": "string",
"INB_METER_INFO": "string",
"OPS_METER_INFO": "string",
"OPS_OPM_AR_GLAS": "string",
"INB_OVERIG_STANDAARD": "string",
"INB_OVERIG_HUIDIGE_DEKKING": "string",
"NETTO_PREMIE_AVP": "number",
"PREMIE_EUG_BHD": "number",
"PREMIE_AR_BHD": "number",
"INB_BDH_MAX_VB": "string",
"AVP_MAX_VB": "string",
"AVP_ER_ALG": "integer",
"AVP_ER_KIND": "integer",
"ASSU_PERC": "number"
}
]
}
}
Toelichting uitvoer
Onderstaande geeft een overzicht van de uitvoervelden. EUG en AR naast elkaar
Let op!
-
niet alle producten volgen onderstaande opbouw volledig.
-
sommige producten kennen extra premiedelen die niet in onze uitvoer zitten, deze delen worden dan op de benodigde plek van de berekening toegevoegd.
-
het eindtotaal kan dus afwijken van de som der delen in het voorgaande, dit gebeurt met name wanneer er sprake is van minimum termijnpremies.
Maatschappijen doen een controle op de eindpremies en niet perse een controle op de premie delen bij de opbouw.
De te tonen premies zijn:
-
“COM_TOTAAL_PREMIE_EUG”: “number”,
-
“COM_TOTAAL_PREMIE_AR”: “number”,
CHANGELOG
01-12-2021 2 isolatie velden opgenomen, deze velden zijn in 2020 bij de verbondsmeter geintroduceerd kleine invloed op de waardemeting. Let op het gaat hier wel over bijzondere isolatie het verbond schrijft “Isolatiewaarde hoger dan de minimale rc/rd waarde”.
04-09-2024 Bij Whs_Constructie is de optie “bijzonder / riet” in het keuzelijsten aangepast naar “bijzonder” zoals de lookup deze teruggeeft. Riet is namelijk maar een voorbeeld van een bijzondere constructie, een bijzondere constructie hoeft niet altijd riet te zijn. Omdat hier verwarring over bestaat was de riet optie weggehaald, nu ook in de documentatie. bij WHS_GEVEL twee overbodige opties verwijderd.