De MoneyView API - Reis
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 Reis Doorlopend te berekenen zijn klantgegevens en de gewenste dekking(en) nodig. Bij deze module is met name samenstelling van het reisgenoodschap van belang en de gewenste dekking.
In onderstaand voorbeeld zijn de velden te zien:
{
"profile": {
"BEREKENING_MY": "Vraag MoneyView naar uw code",
"SESSION_ID": "CASUS1",
"BEREKENING_INGANGSDATUM": "20171027",
"PERSOON_POSTCODE": "4401",
"PERSOON_PC_LETTERS": "AA",
"PERSOON_HUISNR": "11",
"PERSOON_HUISNRTVG": "A",
"REIS_DEKKINGSGEBIED": "EUROPA",
"DEKKING_PERIODE": "45",
"PERSOON_GEBOORTEDATUM": "19700101",
"PERSOON_GEBOORTEDATUM_PARTNER": "",
"PERSOON_GEBOORTEDATUM_KIND1": "",
"PERSOON_GEBOORTEDATUM_KIND2": "",
"PERSOON_GEBOORTEDATUM_KIND3": "",
"PERSOON_GEBOORTEDATUM_KIND4": "",
"PERSOON_GEBOORTEDATUM_KIND5": "",
"REIS_TOTAAL_BAGAGE": "1000",
"REIS_TOTAAL_ONDERWATERSPORT": "0",
"REIS_TOTAAL_GELD_CHEQUES": "0",
"BEREKENING_ER": "0",
"DEKKING_WINTERSPORT": "NEE",
"DEKKING_ONDERWATERSPORT": "NEE",
"DEKKING_GEVAARLIJKESPORT": "NEE",
"DEKKING_GENEESKUNDIG": "NEE",
"DEKKING_ONGEVALLEN": "NEE",
"DEKKING_AUTOMOBILISTENHULP": "NEE",
"DEKKING_ZAKENREIS": "NEE",
"DEKKING_ANNULERING": "NEE",
"BEDRAG_ANNULERING": "0",
"ANNULERING_SAMENGESTELDE_REIS": "NEE",
"ANNULERING_ZAAKWAARNEMER": "NEE",
"ANNULERING_HUISDIEREN": "NEE",
"DEKKING_REPATRIERING": "NEE",
"DEKKING_VERV_VERVOER": "NEE",
"DEKKING_RECHTSBIJSTAND": "NEE",
"DEKKING_EIGEN_VERBLIJF_NL": "NEE",
"BEREKENING_ASSU_BELAST": "JA",
"BEREKENING_BETALINGSTERMIJN": "JAAR",
"BEREKENING_ER_AFWIJKING_WAARDE": "0",
"BEREKENING_ER_AFWIJKING_TYPE": "CLOSE",
"BEREKENING_NULPREMIES": "JA"
}
}Uitleg velden:
| INVOERVELD | SOORT | DEFAULT OF FORMAT | TOELICHTING OF INVULMOGELIJKHEDEN |
|---|---|---|---|
| Session_Id | String | Unieke casus identifier | |
| 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. | |
| Berekening_Ingangsdatum | Int | Op welke datum moet de verzekering ingaan | |
| Reis_Dekkingsgebied | String | Europa | Wat is het minimale dekkingsgebied (LOOKUP) |
| Dekking_Periode | Int | 45 | Wat is de maximum aaneengesloten reisduur (LOOKUP) |
| Persoon_Geboortedatum | Int | yyyymmdd | Geboortedatum van de verzekeringnemer |
| Persoon_Geboortedatum_Partner | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Persoon_Geboortedatum_Kind1 | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Persoon_Geboortedatum_Kind2 | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Persoon_Geboortedatum_Kind3 | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Persoon_Geboortedatum_Kind4 | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Persoon_Geboortedatum_Kind5 | Int | yyyymmdd | (bepaalt de gezinssituatie, kan leeg blijven) |
| Reis_Totaal_Bagage | Int | Bedrag aan bagage (LOOKUP) per persoon | |
| Reis_Totaal_Onderwatersport | Int | Bedrag aan extra sportuitrusting (LOOKUP) per polis | |
| Reis_Totaal_Geld_Cheques | Int | Bedrag aan geld (LOOKUP) per polis | |
| Berekening_Er | Int | 0 | Getal (LOOKUP) Eigen risico per polis voor bagage |
| Dekking_Wintersport | String | Nee | [Ja]/[Nee] Dekking voor het risico van skiën en snowboarden |
| Dekking_Onderwatersport | String | Nee | [Ja]/[Nee] Dekking voor het risico van duiken |
| Dekking_Gevaarlijkesport | String | Nee | [Ja]/[Nee] Dekking voor het risico van sporten met een meer dan gemiddeld risico |
| Dekking_Geneeskundig | String | Nee | [Ja]/[Nee] Dekking voor medische kosten die de zorgverzekering niet vergoed |
| Dekking_Ongevallen | String | Nee | [Ja]/[Nee] Dekking voor overlijden of blijvende invaliditeit als gevolg van een ongeval |
| Dekking_Automobilistenhulp | String | Nee | [Ja]/[Nee] Dekking voor hulp bij ongeval of pech met het voertuig |
| Dekking_Zakenreis | String | Nee | [Ja]/[Nee] Dekking voor reizen met een zakelijk doel |
| Dekking_Annulering | String | Nee | (LOOKUP) Dekking voor de annuleringskosten bij afzegging of afbreking van de reis |
| Bedrag_Annulering | Int | 0 | Hoogte van de gewenste annuleringsdekking (LOOKUP) |
| Dit is een bedrag per persoon, bij de berekening wordt gecontroleerd of de totaal dekking per polis niet wordt overschreden. | |||
| Annulering_Samengestelde_Reis | String | Nee | [Ja]/[Nee] Annuleringsdekking voor samengestelde reizen door uitval van een onderdeel |
| Annulering_Zaakwaarnemer | String | Nee | [Ja]/[Nee] Annuleringsdekking voor ziekte, ongeval of overlijden van (zaak)waarnemer |
| Annulering_Huisdieren | String | Nee | [Ja]/[Nee] Annuleringsdekking voor ziekte, ongeval of overlijden van hond, kat of paard |
| Dekking_Repatriering | String | Nee | [Ja]/[Nee] Dekking voor repatriering van het voertuig |
| Dekking_Verv_Vervoer | String | Nee | [Ja]/[Nee] Dekking voor vervangend vervoer bij uitval van het voertuig |
| Dekking_Rechtsbijstand | String | Nee | [Ja]/[Nee] Dekking voor Juridische hulp in het buitenland, schadeverhaal en rechtsbijstand bij geschillen met betrekking tot contracten die verband houden met de reis |
| Berekening_Assu_Belast | String | JA | Assurantiebelasting |
| Berekening_Betalingstermijn | String | Jaar | [Jaar], [Half jaar], [Kwartaal], [Maand] (LOOKUP) |
| Berekening_Er_Afwijking_Waarde | Int | Niet van toepassing, altijd 0 | |
| Berekening_Er_Afwijking_Type | String | [Close] of [Equal] | |
| 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. | |
Toelichting Assurantiebelasting reisverzekeringen
In 2012 heeft de Belastingdienst assurantiebelasting (forfaitaire bedragen) ingevoerd voor reisverzekeringen met een gemengd karakter. Vanwege verschillende implementaties hiervan door verzekeringsmaatschappijen is het niet meer in alle gevallen mogelijk om de exacte hoogte van de assurantiebelasting vast te stellen. MoneyView kan daarom niet garanderen dat het juiste bedrag gevuld wordt bij het uitvoerveld “ASSU_BEL”. Indien het invoerveld “Berekening_Assu_Belast” gevuld wordt met ‘JA’ zijn - voor zover van toepassing - alle (deel)premies inclusief assurantiebelasting.
Relatie Dekking_Annulering en Bedrag_Annulering
Bij geen bedrag voor annulering dan wordt dekking_annulering als ‘Nee’ geïnterpreteerd.
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.
Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)
| ITEM | KEUZES | ITEM | KEUZES | |
|---|---|---|---|---|
| reis_totaal_geld_cheques | 0 | reis_totaal_bagage | 0 | |
| reis_totaal_geld_cheques | 50 | reis_totaal_bagage | 1000 | |
| reis_totaal_geld_cheques | 100 | reis_totaal_bagage | 1500 | |
| reis_totaal_geld_cheques | 150 | reis_totaal_bagage | 2000 | |
| reis_totaal_geld_cheques | 200 | reis_totaal_bagage | 2500 | |
| reis_totaal_geld_cheques | 250 | reis_totaal_bagage | 3000 | |
| reis_totaal_geld_cheques | 500 | reis_totaal_bagage | 4000 | |
| berekening_er | 0 | reis_totaal_bagage | 5000 | |
| berekening_er | 50 | reis_totaal_bagage | 7500 | |
| berekening_er | 100 | reis_totaal_bagage | 10000 | |
| berekening_er | 150 | dekking_periode | 45 | |
| berekening_er | 200 | dekking_periode | 60 | |
| berekening_er | 250 | dekking_periode | 90 | |
| dekking_annulering | Ja | dekking_periode | 120 | |
| dekking_annulering | Garantie-annulering | dekking_periode | 180 | |
| dekking_annulering | Allrisk-annulering | dekking_periode | 365 | |
| dekking_annulering | Nee | reis_totaal_onderwatersport | 0 | |
| bedrag_annulering | 0 | reis_totaal_onderwatersport | 500 | |
| bedrag_annulering | 700 | reis_totaal_onderwatersport | 1000 | |
| bedrag_annulering | 1000 | reis_totaal_onderwatersport | 2000 | |
| bedrag_annulering | 1250 | reis_totaal_onderwatersport | 3000 | |
| bedrag_annulering | 1500 | reis_totaal_onderwatersport | 4000 | |
| bedrag_annulering | 2500 | reis_totaal_onderwatersport | 5000 | |
| reis_dekkingsgebied | Nederland | |||
| reis_dekkingsgebied | Europa | |||
| reis_dekkingsgebied | Wereld | |||
RESPONSES
Hieronder de reponse van een berekende premie. Deze response bevat aanbieder en productnaam.
{
"ScripletEngineResponseParameters": {
"task": "type": "string", "#text": "PROCESS_ONE",
"global": "type": "string", "#text": "REIS",
"local": "type": "string",
"specific": "type": "string",
"response": [
{
"SESSION_ID": "string",
"GLOBAL": "string",
"LOCAL": "string",
"SPECIFIC": "string",
"DEKKINGSGEBIED": "string",
"EIGENRISICO": "number",
"DEKKING_BAGAGE": "number",
"DEKKING_ONDERWATERSPORT": "string",
"DEKKING_GELDCHEQUES": "number",
"DEKKING_ANNULERING": "string",
"DEKKING_PERIODE": "string",
"PREMIE_BASIS": "number",
"PD_BAGAGE": "string",
"PD_GELD": "string",
"PD_WINTER": "string",
"PD_GEVAARLIJKESPORT": "string",
"PD_ONDERWATERSPORT": "string",
"PD_DUIKUITRUSTING": "string",
"PD_ONGEVALLEN": "string",
"PD_GENEESKUNDIG": "string",
"PD_AUTOMOBILISTENHULP": "string",
"PD_VERLENGING": "string",
"PD_ZAKENREIS": "string",
"PD_REPATRIERING": "string",
"PD_VERV_VERVOER": "string",
"PD_ANNULERING": "string",
"PD_ANNU_SR": "string",
"PD_ANNU_ZW": "string",
"PD_ANNU_HD": "string",
"OPM_BAGAGE": "string",
"OPM_GELD": "string",
"OPM_WINTER": "string",
"OPM_GEVAARLIJKESPORT": "string",
"OPM_ONDERWATERSPORT": "string",
"OPM_DUIKUITRUSTING": "string",
"OPM_ONGEVALLEN": "string",
"OPM_GENEESKUNDIG": "string",
"OPM_AUTOMOBILISTENHULP": "string",
"OPM_ZAKENREIS": "string",
"OPM_REPATRIERING": "string",
"OPM_VERV_VERVOER": "string",
"PD_EIGENRISICO": "string",
"OPM_ANNULERING": "string",
"OPM_ANNU_SR": "string",
"OPM_ANNU_ZW": "string",
"OPM_ANNU_HD": "string",
"PD_SUB": "number:",
"PREMIE_SUB_TOTAAL": "number",
"ASSU_BEL": "number",
"PREMIE_TOTAAL": "number",
"POLISKOSTEN": "number",
"GLOBAL_ESCAPE_REASON": "string",
"OPM_BIJKOMENDE_KOSTEN": "string",
"BIJKOMENDE_KOSTEN": "number:",
"PREMIE_TOTAAL_INCL_KOSTEN": "number",
}
]
}
}Toelichting uitvoer
De eindpremie, die op de website getoond moet worden, is de PREMIE_TOTAAL. Daarnaast kunnen getoond worden: poliskosten en eigen risico.
PD velden bevatten een premiedeel, dit kan een toeslag of korting zijn voor het al dan niet meeverzekeren van het item of wel een subtotaal.
OPM velden, bevatten informatie over het verzekerde deel:
| OPM tekst | Betekenis |
|---|---|
| Geen dekking | Niet gedekt |
| Basisdekking | Valt onder basisdekking |
| Gedekt met … | Valt onder … dekking (daar staat dan ook de premie vermeld) |
| Extra dekking | Is gekozen als extra dekking en valt niet onder basisdekking |
| Uitgesloten | Valt onder basisdekking maar is niet meeverzekerd n.a.v. invoer. |
Assurantiebelasting bij reisverzekeringen.
Toegevoegd in mei 2012 t.b.v. de nieuwe assurantiebelastingregels.
Bij al onze modules berekenen we eerst een totaal premie exclusief en dan komt er assurantiebelasting bij. Bij reis en reiskort zijn echter niet alle delen belast. Enkele maatschappijen werken met basistarieven inclusief assurantiebelasting waarbij het lijkt dat ze helemaal geen assurantiebelasting heffen.
Tot 1 mei 2012 hebben we vast gehouden aan de techniek om de assurantiebelasting aan het einde bij te tellen voor zover er een bekend verschil was.
Enkele maatschappijen geven nu aan de consument tarieven (dus inclusief) gelijk te houden en zelf wel een oplossing te gaan vinden voor wat ze gaan afdragen. Het tonen van exclusief premiedelen is daarmee steeds minder zinvol en zelfs onmogelijk. Daarom zit in de uitvoer alleen nog maar tarieven inclusief assurantiebelasting, dus ook alle tussenliggende delen. Het uiteindelijke totaal zal daardoor niet veranderen maar het “sommetje” gaat er wel anders uit zien omdat alle getoonde delen al inclusief zijn.
In oude situatie bevatten alleen de totalen assurantiebelasting, in de nieuwe situatie is het dus overal al bijgeteld(gele velden) als het van toepassing is. Waar mogelijk wordt het bedrag aan assurantiebelasting nog wel weergegeven maar dat zal in sommige gevallen een benadering zijn.
