Brio Open API: de connectie met Brio maken
Koppel Brio en WeGroup rechtstreeks in twee richtingen via de Open API van Portima, met een synchronisatie die in real time meeloopt.
WeGroup heeft een rechtstreekse koppeling met Brio via de Brio Open API, de officiele API van Portima. Waar de oudere Brio-verbindingen werken met exportbestanden en Bloc Retour, wisselen Brio en WeGroup hier in twee richtingen gegevens uit, en loopt de synchronisatie in real time mee: past er iets in Brio, dan volgt WeGroup zonder dat jij een export moet plannen.
In dit artikel lees je wat je nodig hebt, hoe je de verbinding maakt en wat er gebeurt na het verbinden. Wil je precies weten welke velden en objecten overgaan? Dat staat in dit artikel over de gesynchroniseerde data.
Welke Brio-verbinding heb ik nodig?
In Instellingen > Verbindingen > Beheerpakket staan twee Brio-verbindingen naast elkaar. Ze doen niet hetzelfde:
Werk je met Brio Comfort, dan is de Brio Open API de koppeling die je wil. De oudere verbinding blijft bestaan voor kantoren die ze vandaag gebruiken: lees daarover het artikel over de Brio External Connector.
Wat heb je nodig?
- Brio Comfort. De Brio Open API is de omgeving die Portima openstelt voor Brio Comfort-makelaars. Meer daarover lees je in deze toelichting van Portima.
- Je P1- en P2-sleutels van Portima. Deze sleutels identificeren jouw kantoor bij Portima. De sleutel die je in WeGroup ingeeft, is de sleutel die in het veld PI2 Key hoort.
- Beheerdersrechten in WeGroup. Alleen de beheerder van je kantoor kan verbindingen instellen. Jouw beheerder kan je rechten geven bij Instellingen > Medewerkers, of mail support@wegroup.be.
Je sleutels aanvragen bij Portima
Heb je nog geen P1- en P2-sleutels? Vraag ze aan bij Portima:
- Via portima.com/nl/pki, met de aanvraag Aanvraag tot verzenden P1 en P2-codes.
- Of via jouw Portima accountmanager.
- Vragen over je codes? Portima Connect helpt je verder op 02/404.44.22 (kies optie 1) of via help.portimaconnect@portima.com.
🧐 De sleutel is een gevoelig gegeven, net zoals een wachtwoord. Bezorg ze niet per gewone mail aan derden en geef ze enkel in op de instellingenpagina van WeGroup.
Stap 1: ga naar Instellingen > Verbindingen > Beheerpakket
Ga naar Instellingen > Verbindingen en klik op het tabblad Beheerpakket. Zoek in het overzicht de verbinding Brio Open API, te herkennen aan het Portima-logo en de omschrijving Rechtstreekse gegevensuitwisseling met Brio in twee richtingen.
❗Let op dat je niet de rij Brio kiest: dat is de oudere verbinding via de Brio External Connector.
Stap 2: geef je PI2-sleutel in
Klik op Verbinden naast Brio Open API. In de pop-up Verbinden met Brio Open API vul je bij PI2 Key de sleutel in die je van Portima kreeg.
Stap 3: zet 'Kan partijen importeren' aan
Zet de schakelaar Kan partijen importeren aan. Dit is wat de synchronisatie van Brio naar WeGroup opent: je partijen, hun risico-objecten, polissen en waarborgen worden vanaf dan overgenomen. Laat je de schakelaar uit, dan blijft de koppeling beperkt tot wat WeGroup naar Brio stuurt.
Stap 4: bewaar je wijzigingen
Klik op Wijzigingen opslaan. De status van de verbinding springt op Verbonden, en je kan de pop-up sluiten. Wil je de sleutel later aanpassen of de koppeling stopzetten, dan kan dat via hetzelfde tandwielicoontje of via Loskoppelen.
Wat gebeurt er na het verbinden?
Zodra je sleutel bewaard is, start de eerste synchronisatie. Die begint met het ophalen van je partijen, en werkt van daaruit verder naar de gegevens die eraan hangen.
Hoe lang die eerste ronde duurt, hangt af van de grootte van je portefeuille: reken op enkele dagen voor een volledige portefeuille. Je hoeft daar niets voor te doen en je kan gewoon blijven werken, de gegevens vullen zich onderweg aan.
Daarna loopt de koppeling in real time. Portima verwittigt WeGroup via webhooks wanneer er in Brio iets verandert, waardoor je geen export meer moet plannen en geen wachttijd van een dag of een week meer hebt.
En verder
- Welke data wordt gesynchroniseerd tussen Brio en WeGroup?
- Brio: de Brio External Connector
- Brio: connecteren met Brio Plus
🧐 Vragen bij deze koppeling of hulp nodig bij het instellen? Neem contact op met onze Supportdienst via support@wegroup.be of via de chat rechtsonderaan in het platform. Gaat je vraag over je P1- en P2-sleutels zelf, dan helpt Portima Connect je sneller verder.