Selecteer uw taal

(BMS) Broker Entry Point en Broker Bridge

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.

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)

 

Broker Bridge

Broker Bridge is een PortimaConnect-API waarmee verzekeringsmaatschappijen de gegevens kunnen opvragen die makelaars in hun BMS beschikbaar hebben en die nodig zijn om bepaalde acties uit te voeren. Deze gegevens worden vervolgens uitgewisseld van het BMS naar de maatschappij.
Het doel is om de huidige context-exchange uitwisselingen te vervangen door een moderne technologie, zodat makelaars gegevens niet langer dubbel moeten invoeren.

De maatschappij stuurt eerst een request op basis van de JSON-schema's, met daarin de gegevens die ze wil ontvangen. De waarden van de gevraagde attributen worden hierbij als "null" meegestuurd. Het BMS beantwoordt dit bericht door dezelfde structuur terug te sturen, maar dan aangevuld met de effectieve waarden die in het BMS beschikbaar zijn.
Het is niet de bedoeling dat de maatschappij bij elke request alle informatie opvraagt, maar enkel de gegevens die noodzakelijk zijn voor de uit te voeren actie.

Json Schemas

In het downloadcentrum kunnen de JSON-schema's worden gedownload. Momenteel betreft het een draftversie; deze wordt finaal zodra de eerste versie in productie gaat.
Het is de verantwoordelijkheid van de verzender om de berichten te valideren vóór ze verstuurd worden.
Voor elk object dat kan worden uitgewisseld, vindt u de volgende bestanden:

  • Json schema (gebruikt voor zowel de request als het antwoord)
  • Voorbeeld van een request bericht van de maatschappij
  • Voorbeeld van een response bericht van de BMS

Daarnaast vindt u een Excel bestand die de mappinng weergeeft tussen de oude norm en de nieuwe norm.

 

Aangemaakt op 06/12/2023.
Laatst bijgewerkt op 07/05/2026.

Contact

Links