Tarief selectie
1. Tarieven ophalen
Na het aanmaken van een voordeelpakketberekening:Berekening
wordt er een lijst met Producten
geretourneerd welke uiteindelijk de beschikbare Tarieven
bevat.
> Berekening > Product > Tarief:sample
Maatschappij
Elk voordeelpakketberekening: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
voordeelpakketberekening:Tarief
. - Premie en Pakketkorting zijn inclusief assurantiebelasting.
- De
voordeelpakketberekening:Berekening
bevat totaalsommen voor de Premie en Pakketkorting op basis van de geselecteerdeTarieven
. - De Servicebijdrage in
voordeelpakketberekening:Berekening
wordt gesommeerd op basis van de gekozen producten. Deze komt terug in het attribuutKosten
binnen devoordeelpakketberekening:Berekening
. Let op: dit is een verouderde term, in schermen dient dit altijd terug te komen met de term Servicebijdrage. - Het attribuut
Totaal
in devoordeelpakketberekening: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 |
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 voordeelpakketberekening:Tarief
. Om het tarief te selecteren kan de berekening bijgewerkt worden met een PUT request, zie ook berekening wijzigen.
Model | Pad | Model | Pad | ||
---|---|---|---|---|---|
Berekening | Producten > Product > Tarieven > Tarief > Kenmerk | => | Profiel | PersonenautoProfielen > PersonenautoProfiel > GewensteTariefKenmerk | |
Berekening | Producten > Product > Tarieven > Tarief > Versie | => | Profiel | PersonenautoProfielen > PersonenautoProfiel > GewensteTariefVersie |
Let op: Wanneer er geen voorkeurstarief is opgegeven wordt automatisch het goedkoopste tarief gehanteerd.
Let op: Wanneer het
GewensteTariefKenmerk
en deGewensteTariefVersie
op voorhand al bekend zijn kunnen deze direct ingevoerd worden bij het aanmaken van hetvoordeelpakketberekening:Profiel
.
Let op: In sommige profielen, bijv. bij personenauto, is er ook een attribuut
voordeelpakketberekening: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
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 voordeelpakketberekening:Berekening
.
Dekking clausules
Aanvullend op de algemene clausules kunnen er ook clausules terug komen voor de onderliggende dekkingen. De dekkingen kunnen opgehaald worden per voordeelpakketberekening:Product
, zie ook Aanvullende informatie.
Onderstaand een voorbeeld waar de clausules per product-type terug te vinden zijn:
Model | Pad |
---|---|
PersonenautoProduct | GarantieTarieven > GarantieTarief > GarantieDekkingen > GarantieDekking > Clausules |
PersonenautoProduct | MotorrijtuigenrechtsbijstandTarieven > MotorrijtuigenrechtsbijstandTarief > MotorrijtuigenrechtsbijstandDekkingen > MotorrijtuigenrechtsbijstandDekking > Clausules |
PersonenautoProduct | OngevallenInzittendenTarieven > etc. |
AansprakelijkheidProduct | AansprakelijkheidTarieven > 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 voordeelpakketberekening: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 voordeelpakketberekening: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.