Opstart: 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. Op deze manier is de gekende informatie reeds aanwezig in ons platform en kan deze data alvast ingevuld worden in de vragenlijsten van de klant. 

Er zijn drie manieren om klanten in bulk te importeren: 

• Via een Excel file  - Opstart: eerste import via een Excel file

• Vanuit AdminPulse - Opstart: koppeling leggen met AdminPulse 

• Vanuit Admin-IS | Consult

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. Deze tweede stap omtrent de import zelf, wordt verder uitgelegd in het volgende artikel: Importeren vanuit AdminPulse of Admin IS | Consult

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 account moeten gelegd worden. Dit gebeurt als volgt: in de linkerbalk, onder 'Instellingen', vindt u het item 'Integraties' terug. Wanneer u hierop klikt, ziet u de integraties die mogelijk zijn. Het proces verschilt voor een koppeling met Admin-IS | Consult en AdminPulse. Lees hier meer indien u met AdminPulse werkt: Opstart: koppeling leggen met AdminPulse

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#h_01ENQB6CD61PF7M224Q0PYG9PT . 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.

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