De verbinding met een ecosysteempartner stopzetten

Op deze pagina leggen we uit welke stappen je moet volgen wanneer je de verbinding tussen je Brio‑omgeving en een ecosysteempartner die gebruikmaakt van de Brio Open API’s (BOA), wilt stopzetten.


De deactivering gebeurt door het verwijderen van de bijhorende technische gebruiker in Portima Connect.
Deze actie leidt tot de onmiddellijke ongeldigverklaring van de gekoppelde beveiligingssleutel (PI2Key) en beëindigt de verbinding tussen beide systemen definitief.

Wat je best weet voor je start

Voor je de procedure opstart, vragen we je rekening te houden met het volgende:

  • De deactivering kan uitsluitend worden uitgevoerd door de LRA van het betrokken kantoor.
  • Zorg ervoor dat je duidelijk hebt geïdentificeerd welke ecosysteempartner je wilt loskoppelen en welk(e) affiliatienummer(s) daarbij betrokken zijn.
  • Elk affiliatienummer beschikt over een eigen technische gebruiker.
  • De ecosysteempartner dient vooraf op de hoogte te worden gebracht van je beslissing om de integratie stop te zetten, bij voorkeur met vermelding van een geplande deactiveringsdatum. Zo kan de partner zijn API‑calls tijdig stopzetten.
  • Het verwijderen van een technische gebruiker is onherroepelijk.
  • Een eventuele heraansluiting in de toekomst vereist een volledig nieuwe onboardingprocedure, inclusief de aanmaak van een nieuwe technische gebruiker en een nieuwe PI2Key.

Deactiveringsprocedure

De ecosysteempartner informeren

Neem contact op met de ecosysteempartner via e‑mail of via je gebruikelijke communicatiekanaal om te melden dat je de integratie met Brio wilt stopzetten.
Geef daarbij de geplande deactiveringsdatum mee, zodat de partner zijn API‑calls tijdig kan stopzetten.


Aanmelden op Portima Connect

Meld je aan op Portima Connect met je LRA‑gegevens.
Portima Connect is de beheertool waarin de technische gebruikers die gekoppeld zijn aan BOA‑integraties worden beheerd.


De technische gebruiker identificeren die moet worden verwijderd

Zoek in Portima Connect naar de technische gebruiker die gekoppeld is aan de ecosysteempartner die je wilt loskoppelen.
Deze gebruiker volgt steeds de volgende naamstructuur: [naam van de partner] boa technical user

Voorbeelden: 

  • MyHarmoney boa technical user
  • Qollabi boa technical user
  • Ravical boa technical user

Elke technische gebruiker is gekoppeld aan een specifiek affiliatienummer.
Let erop dat je de juiste gebruiker selecteert, aangezien elke integratie over een eigen technische gebruiker beschikt.


De technische gebruiker verwijderen

Verwijder de geïdentificeerde technische gebruiker in Portima Connect.
Zodra de verwijdering is bevestigd:

  • wordt de bijhorende PI2Key onmiddellijk ongeldig verklaard,
  • zal elke authenticatiepoging van de partner mislukken: de partner kan geen JWT‑token meer verkrijgen en heeft geen toegang meer tot Brio voor het betrokken affiliatienummer.

De verbreking bevestigen aan de partner

Breng de ecosysteempartner op de hoogte dat de deactivering effectief werd uitgevoerd.
Blijft de partner daarna API‑calls uitvoeren, dan ontvangt hij een authenticatiefout.


Portima informeren

Gelieve onze administratieve dienst te informeren over je wens om de integratie met de gekozen partner te deactiveren door het deactiveringsformulier in te vullen.
Dit formulier is beschikbaar op de pagina Brio Ecosysteem via de knop ‘Deactiveer [naam van de partner ]’.
Zo kunnen we je contracten correct bijwerken.

Onmiddellijke gevolgen van de deactivering

  • De PI2Key van de ecosysteempartner voor het betrokken affiliatienummer wordt definitief ongeldig verklaard en kan niet opnieuw worden geactiveerd.
  • De partner kan zich niet langer authenticeren bij de Brio Open API’s voor het betrokken affiliatienummer.
  • De gegevens die reeds aanwezig zijn in Brio worden niet verwijderd.
  • Alle klantendossiers, contracten, schadedossiers en documenten die via de integratie werden aangemaakt of gewijzigd, blijven beschikbaar in je Brio‑omgeving.

Hulp nodig?

Bij moeilijkheden tijdens de procedure of wanneer je twijfelt over welke technische gebruiker moet worden verwijderd, staat ons Brokers Contact Center op 02/404.44.22 klaar om je te begeleiden.