Overslaan naar inhoud

Hoe koppel ik WeGroup aan ANVA?

Picture of Huub Derks
WeGroup biedt een koppeling met ANVA die je zelf eenvoudig configureert. Na configuratie zijn de volgende acties mogelijk:
  • Relaties importeren uit ANVA
  • Adviesrapporten met daaraan gelinkte taken exporteren naar ANVA (voor relaties die uit ANVA zijn geïmporteerd)

 

Om de koppeling tussen WeGroup en ANVA te maken, ga je eerst naar Instellingen > Verbindingen > Beheerpakket. Klik vervolgens naast ANVA op 'Verbinden'. 

 

Je krijgt onderstaand scherm te zien. Vul alle gegevens in en klik vervolgens op 'Verbinden'.




Beschik je nog niet over alle gegevens? Maak dan een Support ticket aan bij ANVA zodat zij je deze kunnen bezorgen en een aparte API account voor je kunnen maken. 

  • Client ID en Client secret: Op te vragen bij ANVA. 
  • Host: https://api.anva.io (of .cloud voor testomgevingen).
  • Organisatie code: Wordt ingesteld bij het maken van het account. Wordt aangeleverd door ANVA. 
  • WeGroup gebruikersnaam: Maak je gebruikersnaam aan in ANVA of neem de bestaande gebruikersnaam over.
  • Agent nummer: Dit veld is optioneel en kan ingevuld worden wanneer enkel data van een bepaald kantoor mag opgehaald worden. 


Je hebt de koppeling tussen WeGroup en ANVA nu gemaakt en kan relaties importen uit ANVA.

Ga daarvoor naar Mijn portefeuille > Relaties en klik op 'Importeren uit ANVA' om op basis van het relatienummer een relatie te importeren in jouw WeGroup platform. Vervolledig een risicoscan, maak een adviesrapport op en exporteer dat rapport eenvoudig naar ANVA, met indien gewenst ook meteen de taken die aan dit rapport gekoppeld zijn. 

Koppeling voorbereiding - op te leveren informatie

Als u met uw kantoor met WeGroup gaat werken kunt u direct profiteren van de generieke koppeling die we met ANVA hebben ontwikkeld. Dat betekent dat voor zo ver er gebruikt wordt gemaakt van standaard inrichting, zoals in gebruik zijnde vaste ANVA labels, de koppeling direct de informatie uit de koppeling goed verwerkt. Bijvoorbeeld, een verzekeringsoverzicht met o.a. premies, hoofdvervaldata, polisnummers wordt gelijk overzichtelijk getoond. Er zijn een paar onderdelen waar de inrichting van een ANVA klant kan afwijken. Daarvoor maken wij de koppeling voor uw kantoor specifiek. Het betreft de volgende onderdelen, inclusief een verdere uitleg.  

  • Variabele ANVA labels in gebruik die relevant zijn voor het gebruik van WeGroup. Bijvoorbeeld, indien adresgegevens binnen het object in de polis op andere labelnummers staan dan zetten we hier aanvullende mapping op zodat ze juist binnenkomen in de object registratie in WeGroup. Het format van het bestand bestaat doorgaans uit "Omschrijving", "Code", "Groep" en is te vinden via pad BLL in ANVA. Druk op de Excel knop om het overzicht te exporteren. 
  • In gebruik zijnde ANVA dekkingcodes en naar welke ADN dekkingcodes deze zijn gemapt. De lijst met deze mappings kan opgehaald worden door naar het pad BPBD te gaan in ANVA. Druk op het printertje om een lijst te exporteren. 
  • Lijst van loginnamen van medewerkers die opgenomen moeten worden in de toe te wijzen personen bij het sturen van een werklijst item (taak) naar ANVA. Zowel de volledig uitgeschreven naam als de key die in ANVA bekend is hebben wij nodig. Bijv. uitgeschreven naam: Jan van der Jansen, bekend onder: JNVDJANSN. De lijst van gebruikers kan opgehaald worden via pad BGG. 
  • Lijst van prioriteiten t.b.v. het inschieten van werklijst items. Dit wordt meegestuurd bij het inschieten van documenten in ANVA onder codelabel 97004. Standaard wordt uitgegaan van Hoog (H) - Middel (M) - Laag (L). Bij afwijkende codelabels dient dit doorgegeven te worden. De codering kan opgehaald worden via pad BLC. Zoek vervolgens op label 97004 om de codelijst van beschikbare mogelijkheden te bekijken. 
  • Agendareden bij inschieten werklijst item. Standaard koppelen we op code 10. Moet een andere code gebruikt worden bij het aanmaken van de werklijst items? Geef deze dan aan ons door. 
  • Inladen van data dat gekoppeld is aan de wijzigingsreden in ANVA. Denk aan het importeren van offertes of elders lopende verzekeringen. Per ANVA installatie worden hier aparte wijzigingsredenen voor gebruikt. Geef door welke wijzigingsredenen gekoppeld moeten worden aan lopende verzekeringen via het kantoor, elders lopende verzekeringen en offertes. Laatstgenoemde kan dan met 1 klik toegevoegd worden aan het adviesrapport. 

Correcte koppeling met WeGroup gebruikersnaam

Om de koppeling te laten werken is het van belang dat een gebruiker binnen ANVA is gekoppeld aan het OpenId account waarmee contact wordt gelegd met de API's van ANVA. Enkele controles die je kunt doen om te bekijken of dit goed is ingericht:

  • Log in op https://hub.anva.io/.
  • Ga naar "Mijn organisatie" > "Beheer openId client" (knop helemaal rechts op het scherm). Dan de open id client van WeGroup opzoeken. Controleer of de UUID onder "OpenID Client ID" overeenkomt met de client_id van het API-account. 
  • Controleer de gekoppelde ANVA-gebruikersnaam (On behalf Of Anva Username) door naar beneden te scrollen:

  • Bekijk of deze gebruikersnaam ook in ANVA zelf bestaat. Daarbij moet de Username exact overeenkomen! Ga naar de gebruikers binnen ANVA via pad BGG. Check of de loginnaam (te zien rechts op het scherm in ANVA) overeenkomt. 

Koppeling voorbereidingen ANVA data platform

Het gebruik van het ANVA data platform heeft diverse voordelen. Er is een uitgebreidere set van informatie beschikbaar en bovendien verloopt het importeren van data veel sneller dan via de XML koppeling. Momenteel vindt de initiële search vanuit WeGroup in het ANVA data platform plaats wanneer deze ingesteld is. Het is belangrijk dat WeGroup de juiste rechten krijgt om de koppeling te leggen. Hieronder de tabellen die benodigd zijn, inc. uitleg waar ze voor dienen.

  • Voor het importeren van relaties met bijbehorende polisgegevens zijn de tabellen NAWBES, POLBES, DEKKING en VERWIJS. 
  • T.b.v. het importen van clausules: POLVFORM voor het ophalen van de clausules die op contract X geplaatst zijn. Vervolgens BOUWST11 voor de clausule titels en BOUWST12 voor de clausules omschrijvingen. 

 

Voor bovenstaande richten wij een klantspecifieke mapping in bovenop de standaard generieke inrichting. 

Instellen van de koppeling met ANVA data platform vanuit WeGroup

De huidige voordelen van het gebruik van ANVA data platform betreft het kunnen zoeken vanuit WeGroup op andere gegevens dan enkel op het relatienummer. Zo kun je bijvoorbeeld ook zoeken op naam, e-mailadres of straatnaam. Daarnaast verloopt het zoeken van een relatie sneller dan via de XML koppeling. Na de initiële search zal de data via de XML koppeling verrijkt worden met objectdata, polisdata en dekkingdata. 
 
Instellingen van deze koppeling:
Vanuit ANVA heb je een document ontvangen startend met de naam "USR_...". Dit document bevat een aantal gegevens die je nodig hebt voor het inrichten van de koppeling met het ANVA data platform. Deze dienen aangevuld te worden met het SSH wachtwoord en persoonlijke SSH sleutel. 
  • Schema: ODBC. Zijn er nog andere opties? 
  • Gebruiker: te vinden onder "User": onderaan in het document. 
  • Host: anva-dwh.api.proxy.azure.wegroup.be. 
  • Account: ophalen uit document onder "Server".
  • Agent nummer: in te vullen indien filtering op agentnummer benodigd is. 
  • Database: op te halen onder "Database" uit document. 
  • Magazijn: op te halen onder "Warehouse" uit document.
  • Rol: op te halen onder "Role" uit document. 
  • Authenticatie: op te halen onder "Authenticator" uit document. 
  • SSH wachtwoord: wachtwoord dat is gekozen bij het invoeren aanmaken van een private/public keypair. 
  • Persoonlijke SSH sleutel: op te halen uit het privateKey bestand dat is gegenereerd door ANVA. Let op dat je ook het gedeelte BEGIN en END mee neemt bij het kopiëren en plakken.