Sélectionnez votre langue

(BMS) Broker Entry Point et Broker Bridge

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" 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 (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)
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)

 

Broker Bridge

Broker Bridge est une API PortimaConnect qui permet aux compagnies d'assurances de demander les données disponibles dans le BMS du courtier et nécessaires à l'exécution de certaines actions. Ces données sont ensuite échangées du BMS vers la compagnie.
L'objectif est de remplacer les échanges actuels basés sur context exchange par une technologie plus moderne, afin d'éviter que les courtiers ne doivent encoder les informations en double.

La compagnie envoie d'abord une requête basée sur les schémas JSON, contenant les données qu'elle souhaite recevoir. Les valeurs des attributs demandés sont envoyées avec la valeur «null». Le BMS répond à ce message en renvoyant la même structure, mais complétée avec les valeurs réelles disponibles dans le BMS.
Il n'est pas prévu que la compagnie demande toutes les informations à chaque requête, mais uniquement celles nécessaires à l'action à effectuer.

Json Schemas

Ci-dessous, vous pouvez télécharger les schémas JSON. Il s'agit actuellement d'une version draft ; une version finale sera publiée dès que la première version sera mise en production.
Il est de la responsabilité de l'expéditeur de valider les messages avant leur envoi.
Pour chaque objet pouvant être échangé, vous trouverez les fichiers suivants :

  • Le schéma JSON (utilisé à la fois pour la requête et la réponse)
  • Un exemple de message de requête envoyé par la compagnie
  • Un exemple de message de réponse envoyé par le BMS

De plus, vous trouverez un fichier Excel qui présente la correspondance entre l'ancienne norme et la nouvelle norme.

 

Créé le 06/12/2023.
Dernière mise à jour le 07/05/2026.

Contact

À propos de Telebib2

Liens