De MoneyView API - Reis Kortlopend
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 kortlopend 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. Hoewel in het profiel richting de gezinssamenstelling wordt gestuurd kan dit ook willekeurige samenstellen van een aantal personen zijn.
In onderstaand voorbeeld zijn de velden te zien:
{
"profile": {
"BEREKENING_MY": "Vraag MoneyView naar uw code",
"SESSION_ID": "CASUS1",
"PERSOON_POSTCODE": "4401",
"BEREKENING_INGANGSDATUM": "20211201",
"BEREKENING_EINDDATUM": "20211207",
"REIS_DEKKINGSGEBIED": "EUROPA",
"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": "JA",
"BEREKENING_BOEKINGSDATUM": "20211125",
"BEREKENING_REKENDATUM": "20211125",
"BEREKENING_REISSOM": "1000",
"BEREKENING_ASSU_BELAST": "JA",
"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 | |
| Berekening_Ingangsdatum | Int | yyyymmdd | Op welke datum moet de verzekering ingaan |
| Berekening_Einddatum | Int | yyyymmdd | Op welke datum moet de verzekering aflopen (Om aantal dagen te bepalen) |
| Reis_Dekkingsgebied | String | Europa | Periode waarbinnen dekking is |
| Persoon_Geboortedatum | Int | yyyymmdd | Geboortedatum van de verzekerde |
| Persoon_Geboortedatum_Partner | Int | yyyymmdd | … |
| Persoon_Geboortedatum_Kind1 | Int | yyyymmdd | … |
| Persoon_Geboortedatum_Kind2 | Int | yyyymmdd | … |
| Persoon_Geboortedatum_Kind3 | Int | yyyymmdd | … |
| Persoon_Geboortedatum_Kind4 | Int | yyyymmdd | … |
| Persoon_Geboortedatum_Kind5 | Int | yyyymmdd | … |
| Reis_Totaal_Bagage | Int | Bedrag aan bagage per persoon(LOOKUP) | |
| Reis_Totaal_Onderwatersport | Int | Bedrag aan extra sportuitrusting per polis | |
| Reis_Totaal_Geld_Cheques | Int | Waarde aan geld en cheques per polis | |
| Berekening_Er | Int | 0 | getal, gevraagd eigen risico m.b.t. bagagedekking (lookup) |
| 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 | [Ja]/[Nee] Dit is een bedrag per polis, diverse partijen kennen een maximum per persoon |
| Berekening_Rekendatum | Int | yyyymmdd | Datum waarop de annuleringsverzekering wordt gesloten, datum ligt op of na de boekingsdatum |
| Berekening_Boekingsdatum | Int | yyyymmdd | Datum waarop de reis is geboekt, deze datum kan niet voor rekendatum (= afsluitdatum) liggen |
| Berekening_Reissom | Int | 0 | T.b.v. annulering Dit is een bedrag per polis, diverse partijen kennen een maximum per persoon |
| Berekening_Assu_Belast | String | Nee | [Ja]/[Nee] |
| Berekening_Er_Afwijking_Waarde | Int | 0 | Niet van toepassing, altijd 0 |
| Berekening_Er_Afwijking_Type | String | Close | [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.
Relatie invoervelden
Berekening_Rekendatum, Berekening_Boekingsdatum en Berekening_Reissom worden alleen gevuld wanneer Dekking_Annulering is “Ja”. Berekening_Rekendatum is de datum waarop de annuleringsverzekering is gesloten, deze mag niet voor Berekening_Boekingsdatum liggen. Bij de meeste partijen mag er maximaal een week zitten tussen de boeking en het sluiten van de verzekering.
Keuze lijsten(lookup lijsten kunnen wijzigen en zijn niet altijd limitatief.)
| ITEM | KEUZES | ITEM | KEUZES | |
|---|---|---|---|---|
| berekening_er | 0 | reis_totaal_geld_cheques | 0 | |
| berekening_er | 50 | reis_totaal_geld_cheques | 200 | |
| berekening_er | 100 | reis_totaal_geld_cheques | 300 | |
| berekening_er | 150 | reis_totaal_geld_cheques | 400 | |
| berekening_er | 200 | reis_totaal_geld_cheques | 500 | |
| berekening_er | 250 | reis_totaal_geld_cheques | 600 | |
| reis_dekkingsgebied | Nederland | reis_totaal_geld_cheques | 750 | |
| reis_dekkingsgebied | Benelux/Duitsland | reis_totaal_geld_cheques | 1000 | |
| reis_dekkingsgebied | Europa | reis_totaal_onderwatersport | 4000 | |
| reis_dekkingsgebied | Wereld | reis_totaal_onderwatersport | 5000 | |
| reis_totaal_bagage | 0 | reis_totaal_onderwatersport | 0 | |
| reis_totaal_bagage | 1000 | reis_totaal_onderwatersport | 500 | |
| reis_totaal_bagage | 1500 | reis_totaal_onderwatersport | 1000 | |
| reis_totaal_bagage | 2000 | reis_totaal_onderwatersport | 2000 | |
| reis_totaal_bagage | 2500 | reis_totaal_onderwatersport | 3000 | |
| reis_totaal_bagage | 4000 | |||
| reis_totaal_bagage | 5000 | |||
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": "REISKORT",
"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",
"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_ZAKENREIS": "string",
"PD_EIGENRISICO": "string",
"PD_SUB": "number:",
"PREMIE_SUB_TOTAAL": "number",
"ASSU_BEL": "number",
"PREMIE_TOTAAL": "number",
"POLISKOSTEN": "number",
"GLOBAL_ESCAPE_REASON": "string",
"ANNULERING_ACCEPTATIE": "string",
}
]
}
}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.
DEKKING_ANNULERING geeft het bedrag per polis, per persoon of per reis aan.
ANNULERING_ACCEPTATIE Dit veld bevat “INCLUSIEF” wanneer er dekking is of “MAX TERMIJN TUSSEN BOEKEN EN AFSLUITEN OVERSCHREDEN”. Er is dan geen dekking voor annulering!