GovLink: koppeling leggen met Admin-IS | Consult

Wanneer u voor het eerst aan de slag gaat met het platform, zullen er nog geen klanten in staan. Ons systeem voorziet in de optie om uw bestaande klanten met hun basisinformatie te importeren. 

In dit artikel lichten we toe hoe de koppeling met Admin-IS | Consult kan gelegd worden. Dit is de noodzakelijke eerste stap om vervolgens een import of update uit te voeren.

Voor het eerst aan de slag met een import vanuit Admin-IS | Consult 

Alvorens de eerste import te kunnen uitvoeren, zal er een koppeling met jullie Admin-IS | Consult account moeten gelegd worden. Dit gebeurt als volgt: in de linkerbalk, onder 'Instellingen', vindt u het item 'Integraties' terug. Klik op de optie Admin-IS | Consult.

API Endpoint en API Key opstellen

Om klantengegevens uit Admin-IS | Consult te importeren in Accounton, moet de AdminIS | Consult instantie van jullie kantoor toegankelijk gemaakt worden voor ons integratieplatform. 

Om dit veilig te doen, raden wij aan de volgende stappen te doorlopen met uw IT-verantwoordelijke:

1. Activeer de Admin-IS | Consult API, volgens https://syneton.zendesk.com/hc/nl/articles/360015107099-API-activatie-en-configuratie . Noteer de API Key (formaat: abcd1234-01234-5687-abcd-efghijklmnp). 

2. Zet forwarding op naar de Admin-IS | Consult instantie, zodat deze van buitenaf toegankelijk is, bijvoorbeeld volgens https://syneton.zendesk.com/hc/nl/articles/360016389880-Consult-API-public-Configure-forwarding-on-IIS . Deze instellingen bepalen het API Endpoint (voorbeeld: https://consultapi.uwkantoor.be/api/v1)

3. Zet een SSL certificaat op, zodat dit endpoint enkel via veilig HTTPS verkeer kan aangesproken worden.

4. (optioneel) Configureer de firewall om enkel het IP adres van ons integratieplatform toe te laten verbinding te maken. Dit is 104.155.116.147 

Tip: Uw IT-verantwoordelijke kan met het volgende commando nagaan of de instelling correct is gebeurd:

curl -X GET "[API Endpoint]/token/[API Key]"

Als de instelling correct is, is het resultaat van het formaat:

{"Id": ..., "TokenGuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", ...}

5. Vul de API Key (uit stap 1) en het API Endpoint (uit stap 2) in in Accounton onder ‘Instellingen’ > ‘Integraties'. 

Indien de koppeling succesvol is verlopen, zal er naast Admin-IS | Consult een aanduiding komen dat de sync actief is.

De koppeling is nu gemaakt. De volgende stap is het uitvoeren van de import. Meer informatie over de effectieve import van de bedrijven, vindt u op de volgende pagina: Aan de slag met de GovLink

Opgelet: zonet de connectie voor het eerst gelegd? Dan kan het een 5-tal minuten duren voordat u de tweede stap kan uitvoeren.