Tarief selectie

1. Tarieven ophalen

Na het aanmaken van een product:Berekening wordt er een lijst met producten (product:Product) geretourneerd welke uiteindelijk de beschikbare Tarieven (product:Tarief) bevat.

> Berekening
> Product
> Tarief:sample

Maatschappij

Elk product:Tarief wordt aangeboden vanuit een maatschappij, deze informatie is opgenomen in de attributen MaatschappijNaam en MaatschappijNummer. In sommige gevallen kan het wenselijk zijn om het logo van de maatschappij op te halen; dit kan op basis van het MaatschappijNummer met onderstaande url.

https://media.voogd.com/maatschappij/{MaatschappijNummer}/logo.png?width=200

Opbouw datamodel

  • Premie en Pakketkorting worden apart teruggegeven in het product:Tarief.
  • Premie en Pakketkorting zijn inclusief assurantiebelasting.
  • De product:Berekening bevat totaalsommen voor de Premie en Pakketkorting op basis van de geselecteerde Tarieven.
  • De Servicebijdrage in product:Berekening wordt gesommeerd op basis van de gekozen producten. Deze komt terug in het attribuut Kosten binnen de product:Berekening. Let op: dit is een verouderde term, in schermen dient dit altijd terug te komen met de term Servicebijdrage.
  • Het attribuut Totaal in de product:Berekening sommeert de totaalkosten voor de consument per betalingstermijn.
  • De consument betaalt: Premie + Servicebijdrage - Pakketkorting.

Aanvullende informatie

Tarieven zijn vaak een samenstelling van meerdere dekkingen. Wanneer er vanuit de applicatie behoefte is om de onderliggende informatie van de dekking te tonen, zoals aanvullende clausules of de opbouw van de premies, kan er gebruikgemaakt worden van aanvullende endpoints.

Product
Aanhangwagen
Aansprakelijkheid
Bestelauto
Bromfiets
Caravan
Doorlopende reis
Fiets
Gezinsongevallen
Inboedel
Kampeerauto
Motorfiets
Personenauto
Rechtsbijstand
Recreatiewoning
Woonhuis

2. Tarief selecteren

De tarief-selectie vindt plaats binnen de sub-profielen. Elk sub-profiel bevat een GewensteTariefKenmerk en GewensteTariefVersie attribuut welke correspondeert met het Kenmerk en Versie attribuut binnen het product:Tarief. Om het tarief te selecteren kan de berekening bijgewerkt worden met een PUT request, zie ook berekening wijzigen.

ModelKenmerkVersie
Berekeningproduct:Product > product:Tarief > Kenmerkproduct:Product > product:Tarief > Versie
ProfielGewensteTariefKenmerkGewensteTariefVersie

Let op: Wanneer er geen voorkeurstarief is opgegeven wordt automatisch het goedkoopste tarief gehanteerd.

Let op: Wanneer het product:PersonenautoProfiel:GewensteTariefKenmerk en de product:PersonenautoProfiel:GewensteTariefVersie op voorhand al bekend zijn kunnen deze direct ingevoerd worden bij het aanmaken van het product:Profiel.

Let op: In sommige profielen, bijv. bij personenauto, is er ook een attribuut product:PersonenautoProfiel:GewensteTarieven. Dit kan gebruikt worden om de gewenste tarieven voor de aanvullende dekking(en) te specificeren. Zie hiervoor de specifieke productpagina's.

> Berekening
> Product
> PersonenautoProfiel
> Tarief:sample

Special Limits tarieven

Let op: Om Special Limits te gebruiken is Product V2 nodig, de opvolger van voordeelpakketberekening v1.

Let op: Special Limits moeten altijd voorgelegd worden aan de risicodrager. Vandaar dat:

  • Automatische acceptatie niet mogelijk is en de behandeltijd hierdoor iets langer kan zijn.
  • Voorlopige dekking niet mogelijk is bij deze risico’s.

Let op: Special Limits tarieven worden standaard uitgesloten van het berekeningsresultaat. Om Special Limits tarieven in het resultaat terug te krijgen moet de eigenschap InclusiefSpecialeLimietTarieven in het profiel op true worden gezet.

Special Limits tarieven terugkrijgen in het berekeningsresultaat

Om tarieven in het berekeningsresultaat terugkrijgen, die als Special Limits zijn gemarkeerd, moet u de eigenschap InclusiefSpecialeLimietTarieven in het profiel instellen op true.

Voorbeeld

{
  "Profiel": {
    "PersonenautoProfiel": [
      {
        ...,
        "InclusiefSpecialeLimietTarieven": true
      }
    ],
  }
}

Deze nieuwe eigenschap is beschikbaar voor de volgende profielen:

> AanhangwagenProfiel
> AansprakelijkheidProfiel
> BestelautoProfiel
> BromfietsProfiel
> CaravanProfiel
> DoorlopendeReisProfiel
> FietsProfiel
> GezinsongevallenProfiel
> InboedelProfiel
> KampeerautoProfiel
> MotorfietsProfiel
> PersonenautoProfiel
> RechtsbijstandProfiel
> RecreatiewoningProfiel
> WoonhuisProfiel

Special Limits tarief selecteren

Het selectieproces werkt net als bij elk ander tarief, zie Tarief selecteren.

Een tarief met Special Limits kan worden gevonden door de waarde van de SecundaireDetails van een tarief te controleren. Binnen de SecundaireDetails vind het volgende:

ModelPad
DetailTarief > SecundaireDetails

Voorbeeld

{
  "Product": [
    {
      "Tarief": {
        "SecundaireDetails": [
          {
            "Naam": "Special limit tarief",
            "Type": "Boolean",
            "Waarde": "false"
          },
        ]
      }
    }
  ]
}

Wanneer de waarde van deze invoer true is, betekent dit dat dit tarief een Special Limits betreft.

Garantievoorwaarden (alleen voertuigen)

Wanneer bij een voertuiganvraag het veld MinimaleGarantieTermijnInMaanden wordt ingevuld, moet ook het veld Aankoopdatum worden opgegeven.

Indien Aankoopdatum ontbreekt, zal er geen tarief worden geselecteerd.

Voorbeeld

{
  "MinimaleGarantieTermijnInMaanden": 24,
  "Aankoopdatum": "2023-06-15"
}

3. Clausules ophalen

Clausules kunnen op twee niveaus terug komen: algemeen en per dekking.

Algemene clausules

De algemene clausules zijn van toepassing op alle VoordeelPakketten, ongeacht het gekozen tarief / de dekking. De algemene clausules zijn terug te vinden in het attribuut Clausules van de product:Berekening.

Dekking clausules

Aanvullend op de algemene clausules kunnen er ook clausules terug komen voor de onderliggende dekkingen. De dekkingen kunnen opgehaald worden per product:Product, zie ook Aanvullende informatie.

Onderstaand een voorbeeld waar de clausules per product-type terug te vinden zijn:

ModelPad
PersonenautoProductGarantieTarieven > GarantieTarief > GarantieDekkingen > GarantieDekking > Clausules
PersonenautoProductMotorrijtuigenrechtsbijstandTarieven > MotorrijtuigenrechtsbijstandTarief > MotorrijtuigenrechtsbijstandDekkingen > MotorrijtuigenrechtsbijstandDekking > Clausules
PersonenautoProductOngevallenInzittendenTarieven > etc.
AansprakelijkheidProductAansprakelijkheidTarieven > etc.
etc.....

Clausule details ophalen

Bovengenoemde clausules worden als nummers terug gegeven in de attributen. Om aanvullende informatie over een clausule op te halen kan er gebruik worden gemaakt van het clausules:/clausules/{nummer} endpoint.

/clausules/{nummer}

Conform het juridisch normenkader dient de klant de mogelijkheid te hebben om de toepasselijke clausules in te zien en te downloaden. Het onderstaande endpoint kan gebruikt worden om een PDF te downloaden welke alle, op dat moment, geselecteerde dekkingen omvat in context van het aangegeven tarief.

/berekeningen/{berekeningid}/producten/{productid}/tarieven/{tariefkenmerk}/{tariefversie}/clausules/document

4. Polisvoorwaarden ophalen

De consument dient akkoord te gaan met de polisvoorwaarden welke op het gekozen tarief van toepassing zijn. Om de polisvoorwaarden op te halen kan gebruikgemaakt worden van de Polisvoorwaarden-API.

Elk product:Tarief bevat het attribuut PolisvoorwaardenAlleDekkingen welke gebruikt kan worden om de onderliggende documenten op te halen via het /polisvoorwaarden/{nummer}/documenten endpoint. De inhoud van een document (PDF) kan vervolgens worden gedownload met het /polisvoorwaarden/{nummer}/documenten/{id} endpoint.

Let hierbij op dat de PolisvoorwaardenAlleDekkingen meerdere nummers kan retourneren. Een nummer kan vervolgens weer meerdere documenten bevatten.

/polisvoorwaarden/{nummer}/documenten
/polisvoorwaarden/{nummer}/documenten/{id}

Let op: er kunnen meerdere polisvoorwaarden / documenten per dekking terug komen. Alle polisvoorwaarden dienen getoond te worden aan de klant ter acceptatie.

5. Verzekeringskaarten tonen

De consument dient akkoord te gaan met de verzekeringskaarten welke op het gekozen tarief van toepassing zijn. Elk product:Tarief bevat het attribuut VerzekeringskaartUrls welke de urls naar de betreffende verzekeringskaarten omvat.

"VerzekeringskaartUrls" : [
    "https://verzekeringskaarten.nl/voogd/Avero-Achmea-Rustig-op-Weg-WA-casco",
    "https://verzekeringskaarten.nl/allianz-assistance/Pechhulp-Verzekering"
]

Let op: er kunnen meerdere verzekeringskaarten per dekking terug komen. Alle verzekeringskaarten dienen getoond te worden aan de klant ter acceptatie.

← Berekening aanmakenProvisie instellingen →