Homepage > Broker Entry Point
Broker Entry Point
Recommendations This section contains recommendations on how to use components and material in an orderly way, the goal being to guarantee an optimal commonality, within the so-called Broker Entry Point.
Subject

Broker Entry Point

Het "Broker Entry Point" is de beveiligde webomgeving van PortimaConnect die de toegangen van de aangesloten makelaars naar de applicaties van de ook bij Portima aangesloten verzekeraars visualiseert en faciliteert, zonder dat de makelaar zich telkens opnieuw moet authenticeren (principe van Single Sign-On, SSO).

Op basis van 3 genormeerde "filters" (waardenlijsten) wordt maximaal gestreefd naar een uniformiteit zodat de aangesloten makelaar makkelijk de gewenste toepassing van de verzekeraar kan terugvinden en gebruiken.

Door waarden (verder "tags" genoemd) van deze 3 filters toe te kennen aan de producten en applicaties zorgen de aangesloten verzekeraars er dus voor de makelaar door de genormeerde filters/tags snel de juiste toepassing van het gewenste product (en gamma) bij de verzekeringsmaatschappij kan terugvinden. Het beheer van de tags is een exclusieve verantwoordelijkheid van de aangesloten verzekeraar.

De filters kunnen los van elkaar gebruikt worden (er is geen hiërarchie of één-op-één verband), en er kunnen meerdere tags uit dezelfde filters aan dezelfde applicatie/product worden toegekend door de verzekeraar. Het is evenmin verplicht om uit elke filter minimaal één "tag" te gebruiken.

De filters en "tags" staan volledig los van de bestaande tabellen die gebruikt worden in de uitwisseling van gestructureerde berichten, het is evenmin de bedoeling om de filters/tags te gebruiken in de uitwisseling van de gestructureerde berichten.

Er zijn 3 filters met waarden gedefinieerd:

  • BEP1 "Product Segment Display" is het eerste classificatie: Leven en/of Niet-leven.
  • BEP2 "Product Sub Segment Display" is het tweede classificatie: Mobiliteit, Woning, Beleggen…
  • BEP3 "Doelpubliek Display", die aangeeft of het product bedoeld is voor privé en/of professioneel.

Elke "tag" is gekoppeld aan een (niet-juridische) "definitie" die kan worden weergegeven in het "Broker Entry Point" om meer informatie te krijgen over de betekenis van de tag. Deze "definities" zijn alleen geldig in de context van het "Broker Entry Point". Ze zijn niet bedoeld om te garanderen dat producten door alle verzekeraars op dezelfde manier geclassificeerd worden.

Hoewel de filters los van elkaar gebruikt kunnen worden, is het echter sterk aanbevolen dat verzekeraars de subsegmenten in de segmenten als volgt indelen en dat ze ook de subsegmenten in de onderstaande volgorde weergeven.

Het wordt ook sterk aanbevolen dat ze het "Woning"-subsegment voor het "Privé"-doelpubliek weergeven en het "Goederen en winsten"-subsegment voor het "Professioneel"-doelpubliek.

Leven Niet-Leven
  1. Fiscaal sparen
  2. Niet-fiscaal sparen
  3. Beleggingen
  4. Bescherming
  5. Hospitalisatie en medische kosten
  1. Package
  2. Mobiliteit
  3. Woning
  4. Goederen en winsten
  5. Aansprakelijkheid
  6. Ongevallen en ziekte
  7. Hospitalisatie en medische kosten
  8. Arbeidsongevallen
  9. Reis en Bijstand
  10. Rechtsbijstand
  11. Cyber-verzekering
  12. Transport en Marine
  13. Lening

Om uniformiteit in de benaming van acties en subacties en een consistente classificatie te garanderen, hebben de maatschappijen die leden zijn van de werkgroep Normalisatie het volgende document opgesteld. Dit document geeft een overzicht van de mogelijke acties en subacties per segment, subsegment en doelgroep.

Download hier

De lijst met acties is volledig genormeerd. Spelers worden gevraagd hier niet van af te wijken.
Het is niet verplicht om alle acties door te geven, maar het is niet toegestaan om andere acties door te geven.

Maatschappijen die geen Makelaars-Front‑End hebben voor een bepaalde actie mogen de actie gewoon niet doorsturen of mogen de actie doorsturen met informatie over een alternatieve procedure voor de makelaar (bijv. een contact e‑mailadres).

Maatschappijen met een Makelaars-Front‑End waarin meerdere acties uitgevoerd kunnen worden, moeten alle acties doorgeven en deze naar dezelfde URL verwijzen.

De lijst van subacties is zoveel mogelijk genormeerd. Het is niet verplicht om alle subacties door te geven. Bij uitzondering mag de maatschappij een subactie doorgeven die niet in de lijst staat, op voorwaarde dat deze zeer maatschappij-specifiek is.

Maatschappijen met subacties die naar dezelfde URL verwijzen, mogen deze groeperen en een benaming gebruiken die zo dicht mogelijk bij de genormeerde benaming ligt.

In sommige gevallen kunnen de weergegeven producten of (sub)acties gegrijst/gedeactiveerd zijn. Om verschillende toepassingen voor verschillende verzekeraars te voorkomen en zo verwarring te zaaien bij makelaars, wordt het sterk aanbevolen om deze weergavemodus alleen in de volgende twee gevallen te gebruiken:

  1. Wanneer de medewerker van de makelaarskantoor niet de rechten heeft om een bepaalde (sub)actie uit te voeren.
  2. Voor een beperkte periode wanneer een product niet langer beschikbaar is.

Broker Entry Point

Le "Broker Entry Point" est l'environnement web sécurisé de PortimaConnect qui permet de visualiser les applications des assureurs affiliés et qui en facilite l'accès aux courtiers (également affiliés) sans qu'ils ne doivent s'authentifier à chaque fois (principe du Single Sign-On (SSO)).

Sur base de 3 "filtres" (listes de valeurs) normalisés, une uniformité maximale est recherchée afin que le courtier puisse facilement retrouver et utiliser le module compagnie (application web) approprié.

En attribuant des valeurs (appelées "tags" (étiquettes)) issues de ces 3 filtres aux produits et applications, les assureurs s'assurent que le courtier puisse rapidement trouver la bonne application permettant de gérer le produit (ou gamme de produits) souhaité(e) auprès de la compagnie d'assurance. La gestion des "tags" relève de la responsabilité exclusive de l'assureur.

Les filtres peuvent être utilisés indépendamment les uns des autres (il n'y a pas de hiérarchie ni de relation entre eux) et l'assureur peut attribuer plusieurs "tags" issus du même filtre à la même application/produit. Il n'est pas non plus obligatoire d'utiliser au moins un "tag" issu de chaque filtre.

Les filtres et les "tags" sont totalement distincts des tables existantes utilisées dans l'échange de messages structurés et il n'est pas prévu d'utiliser les filtres/tags dans l'échange de messages structurés.

Il y a 3 filtres avec des valeurs définies :

  • BEP1 "Affichage du segment du produit" est la première classification : Vie et/ou Non-Vie.
  • BEP2 "Affichage du sous-segment du produit" est la deuxième classification : Mobilité, Habitation, Investissement...
  • BEP3 "Affichage du public cible" indique si le produit est destiné au privé et/ou au professionnel.

Chaque "tag" est lié à une "définition" (non juridique) qui peut être affichée dans le "Broker Entry Point" pour obtenir plus d'informations sur la signification de l'étiquette. Ces "définitions" ne sont valables que dans le contexte du "Broker Entry Point". Elles ne visent pas à garantir que les produits soient classés de la même manière par tous les assureurs.

Malgré que les filtres puissent être utilisés indépendamment les uns des autres, il est néanmoins fortement recommandé aux assureurs de répartir les sous-segments dans les segments de la manière suivante ainsi que d'afficher les sous-segments dans l'ordre repris ci-dessous.

Il leur est également fortement recommandé d'afficher le sous-segment "Habitation" pour le public cible "Privé" et le sous-segment "Biens et bénéfices" pour le public cible "Professionnel".

Vie Non-Vie
  1. Epargne fiscale
  2. Epargne non fiscale
  3. Placements
  4. Protection
  5. Hospitalisation et frais médicaux
  1. Package
  2. Mobilité
  3. Habitation
  4. Biens et bénéfices
  5. Responsabilité
  6. Accidents et maladies
  7. Hospitalisation et frais médicaux
  8. Accidents du travail
  9. Voyage et Assistance
  10. Protection juridique
  11. Assurance Cyber
  12. Transport et Marine
  13. Prêt

Afin d'assurer une uniformité des libellés d'actions et sous-actions ainsi qu'une classification consistente, les compagnies membres du groupe de travail normalisation ont rédigé le document suivant. Ce document reprend les actions et sous actions possibles par segment, sous-segment et public cible.

Téléchargez ici

La liste des actions est complètement normalisée. Il est demandé aux acteurs de ne pas en dévier.
Il n'est pas obligatoire de transmettre toutes les actions, mais il n'est pas autorisé d'en transmettre d'autres.

Les compagnies qui, pour une certaine action, n'ont pas de Front‑End courtiers, peuvent simplement ne pas transmettre l'action ou bien la transmettre accompagnée d'information à propos d'une procédure alternative pour le courtier (une adresse e‑mail de contact par ex.).

Les compagnies disposant d'un Front-End courtiers dans lequels plusieurs actions peuvent être réalisées, doivent transmettre toutes les actions et les faire pointer vers la même URL.

La liste des sous-actions est normalisée au maximum. Il n'est pas obligatoire de transmettre toutes les sous-actions. Exceptionnellement, la compagnie peut transmettre une sous‑action qui n'est pas dans la liste pour autant qu'elle soit très spécifique à la compagnie.

Les compagnies ayant des sous-actions pointant vers la même URL, peuvent les regrouper et utiliser un libellé aussi proche que possible des libellés normalisés.

Dans certains cas, les produits ou (sous‑)actions affichés peuvent être grisés/désactivés. Afin d'éviter des utilisations différentes entre assureurs et générer ainsi de la confusion auprès des courtiers, il est fortement recommandé d'utiliser ce mode d'affichage uniquement dans les deux cas suivants :

  1. Lorsque le collaborateur du bureau de courtage n'a pas les droits pour effectuer une (sous‑)action donnée.
  2. Pendant une période limitée lorsqu'un produit n'est plus disponible.

BMS Broker Entry Point

"BMS Broker Entry Point" is de Portima API van "Broker Entry Point" waarmee een bij PortimaConnect aangesloten makelaar, vanuit een bepaalde context in zijn BMS (contract, schade, klant, enz.), aan een eveneens bij PortimaConnect aangesloten maatschappij, de lijst met de mogelijke beheeracties voor deze context kan opvragen en via welk kanaal (API, MPB/MSB, aanspreking, maatschappijmodule, e‑mail...).

Net als bij het "Broker Entry Point", om uniformiteit in de benaming van acties en subacties en een consistente classificatie te garanderen, hebben de maatschappijen die leden zijn van de werkgroep Normalisatie het hierboven te downloaden document aangevuld met de mogelijke acties en subacties per context.

De lijst met acties is volledig genormeerd. Spelers worden gevraagd hier niet van af te wijken.
Het is niet verplicht om alle acties door te geven, maar het is niet toegestaan om andere acties door te geven.

De lijst van subacties is zoveel mogelijk genormeerd. Het is niet verplicht om alle subacties door te geven. Bij uitzondering mag de maatschappij een subactie doorgeven die niet in de lijst staat, op voorwaarde dat deze zeer maatschappij-specifiek is.

Contexten in fase 1

Context Context tag Minimum gegevens nodig voor identificatie binnen context
Contract Contract
  • PolicyReference (mandatory)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Kwijting PremiumNotification
  • PolicyReference (mandatory)
  • PremiumNotificationCompanyReference (mandatory)
Nieuw schadedossier

(Nog niet bekend bij de maatschappij)

 NewClaimFile
  • PolicyReference (mandatory)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Bestaand schadedossier

(Al bekend bij de maatschappij)

 ClaimFile
  • PolicyReference (mandatory)
  • ClaimReference (mandatory)
  • MomentOfTheEventDateTime (optional)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Klant Customer
  • NaturalOrLegalPersonCode (optional)
  • CompanyNumberReferenceBinary (Beschikt de makelaar over het KBO-nummer van de klant? (y/n)) (optional)
  • BepProductSegmentDisplayCode (optional but mandatory if BepProductSubsegmentDisplayCode is provided)
  • BepProductSubsegmentDisplayCode (optional)
  • BepProductTargetAudienceTypeDisplayCode (optional)
Risico-object

(buiten contract)

 ObjectInsured
  • Object type/qualifier
  • IF ObjectInsuredTractorVehicle
    • VehicleCode (mandatory if available)
    • VehicleUsageCode (mandatory if available)
    • SpecialLicensePlateCode (mandatory if available)
  • IF ObjectInsuredTrailer
    • VehicleCode (mandatory if available)
    • SpecialLicensePlateCode (mandatory if available)
    • MaximumAuthorisedWeightQuantity (mandatory if available)
  • IF ObjectInsuredBuilding OR ObjectInsuredContents OR ObjectInsuredCaravan OR ObjectInsuredPropertyEstate OR ObjectInsuredEquipment OR ObjectInsuredFurnitureAndHouseholdEffects OR ObjectInsuredRealEstateEmbellishments
    • BuildingUsageCode (mandatory if available)
    • ConstuctionUsageCode (mandatory if available)
    • ConstructionNatureCode (mandatory if available)
    • BusinessCodeNacebel2025Code (mandatory if available)
  • IF ObjectInsuredPersonCarryingOutAnActivity
    • BusinessCodeNacebel2025Code (mandatory if available)
  • BepProductSegmentDisplayCode (optional but mandatory if BepProductSubsegmentDisplayCode is provided)
  • BepProductSubsegmentDisplayCode (optional)
  • BepProductTargetAudienceTypeDisplayCode (optional)
Package Package
  • PolicygroupingNumberReference (mandatory)

BMS Broker Entry Point

"BMS Broker Entry Point" est l'API Portima de "Broker Entry Point" qui permet à un courtier affilié à PortimaConnect, à partir d'un contexte donné dans son BMS (contrat, sinistre, client, etc.), de demander à une compagnie, également affiliée à PortimaConnect, la liste des actes de gestion possibles pour ce contexte et via quel canal (API, MPB/MSB, invocation, module compagnie, e‑mail...).

Comme pour le "Broker Entry Point", afin d'assurer une uniformité des libellés d'actions et sous-actions ainsi qu'une classification consistente, les compagnies membres du groupe de travail normalisation ont complété le document téléchargeable plus haut avec les actions et sous actions possibles par contexte.

La liste des actions est complètement normalisée. Il est demandé aux acteurs de ne pas en dévier.
Il n'est pas obligatoire de transmettre toutes les actions, mais il n'est pas autorisé d'en transmettre d'autres.

La liste des sous-actions est normalisée au maximum. Il n'est pas obligatoire de transmettre toutes les sous-actions. Exceptionnellement, la compagnie peut transmettre une sous-action qui n'est pas dans la liste pour autant qu'elle soit très spécifique à la compagnie.

Contextes de la phase 1

Contexte Contexte tag Données minimales pour l'identification dans le contexte
Contrat Contract
  • PolicyReference (mandatory)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Quittance PremiumNotification
  • PolicyReference (mandatory)
  • PremiumNotificationCompanyReference (mandatory)
Nouveau dossier sinistre

(Pas encore connue à la compagnie)

 NewClaimFile
  • PolicyReference (mandatory)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Dossier sinistre existant

(Déjà connue à la compagnie)

 ClaimFile
  • PolicyReference (mandatory)
  • ClaimReference (mandatory)
  • MomentOfTheEventDateTime (optional)
  • Domain (mandatory)
  • PolicyProductCode (mandatory)
Client Customer
  • NaturalOrLegalPersonCode (optional)
  • CompanyNumberReferenceBinary (Le courtier dispose-t-il du numéro CBE du client? (y/n)) (optional)
  • BepProductSegmentDisplayCode (optional but mandatory if BepProductSubsegmentDisplayCode is provided)
  • BepProductSubsegmentDisplayCode (optional)
  • BepProductTargetAudienceTypeDisplayCode (optional)
Objet de risque

(hors contrat)

 ObjectInsured
  • Object type/qualifier
  • IF ObjectInsuredTractorVehicle
    • VehicleCode (mandatory if available)
    • VehicleUsageCode (mandatory if available)
    • SpecialLicensePlateCode (mandatory if available)
  • IF ObjectInsuredTrailer
    • VehicleCode (mandatory if available)
    • SpecialLicensePlateCode (mandatory if available)
    • MaximumAuthorisedWeightQuantity (mandatory if available)
  • IF ObjectInsuredBuilding OR ObjectInsuredContents OR ObjectInsuredCaravan OR ObjectInsuredPropertyEstate OR ObjectInsuredEquipment OR ObjectInsuredFurnitureAndHouseholdEffects OR ObjectInsuredRealEstateEmbellishments
    • BuildingUsageCode (mandatory if available)
    • ConstuctionUsageCode (mandatory if available)
    • ConstructionNatureCode (mandatory if available)
    • BusinessCodeNacebel2025Code (mandatory if available)
  • IF ObjectInsuredPersonCarryingOutAnActivity
    • BusinessCodeNacebel2025Code (mandatory if available)
  • BepProductSegmentDisplayCode (optional but mandatory if BepProductSubsegmentDisplayCode is provided)
  • BepProductSubsegmentDisplayCode (optional)
  • BepProductTargetAudienceTypeDisplayCode (optional)
Package Package
  • PolicygroupingNumberReference (mandatory)

Created on 06/12/2023.
Last updated on 02/06/2025.