Inleiding
Om de accountants meer controle te geven over het gebruik van hun data (database) moeten andere softwareleveranciers toegang vragen tot de database van de accountants. Dit moet ook gebeuren voor de Algemene Verordening Gegevensbescherming (GDPR).
De oude manier van werken met een rechtstreekse databaseconnectie wordt vanaf 01/01/2021 niet meer opgezet en vanaf 31/12/2021 definitief afgesloten. Deze timing geeft iedereen de tijd om de nodige migraties te doen. Er volgt nog tussentijdse communicatie met de accountants en software integratoren om de timing op te volgen.
De Consult API kan on premise gebruikt worden zoals alle andere Marketplace integraties en ook extern via het Internet zoals Admin-Mobile, deze opzet vereist wel extra netwerkconfiguratie door de IT-afdeling. Mogelijke oplossing zijn Firewall configuratie of port forwaring met IIS.
Inhoudstafel
Installatie marketplace
Via [Configuratie - algemeen - Marketplace] vind je het Marketplace platform.
Je dient eerst de Marketplace te installeren om deze integratie actief te hebben.
Daarna kan je via de knop "installeren" de integratie activeren. Na enkele seconden zal de integratie actief staan.
Integratie Instellen
Configuratie
Via de configuratie kan je bepalen welke software toegang heeft op welke modules.
Klik op het "+"-teken en geef de naam op van de software die je toegang wilt verlenen:
(1) Eenmaal de software is aangemaakt, wordt er een unieke sleutel gegenereerd die de softwareleverancier nodig heeft om data op te vragen.
(2) met de "+"-tekens kan je toegang geven tot de modules:
- Permanent Dossier
- Financial
- Taskflow
- DMS
- Registraties
- HRM
De linker kolom is voor de leesrechten en de rechter kolom is voor de schrijfrechten.
Connectiegegevens
Het adres(URL) om de sleutel te gebruiken hangt af van de configuratie.
On premise gebruik
Voor de standaard on premise configuratie vind je het adres terug in de configuratie van de Marketplace Mananger. Het adres voor de softwareleverancier is het basisadres van de Manager + de poort van de Consult API + "/api/v1/".
Met onderstaand voorbeeld geeft dit: http://192.168.0.189:2100/api/v1/
Internet gebruik
Stem af met de IT-afdeling voor het juiste publieke adres/website.
Het uiteindelijke adres: publieke IP adres + de sleutel moeten doorgegeven worden aan de softwareleverancier.
Instellingen
Bij 'instellingen' kan je de standaard API instellingen wijzigen.
- Standaard aantal resultaten per API call
- Maximum aantal resultaten per pagina: Indien je er meer opvraagt dan het maximum aantal dan zullen enkel het standaard aantal resultaten getoond worden.
- Levensduur van het token (in uren)
- Maximum aantal API oproepen per minuut: meer oproepen per minuut zal de foutmelding "You are throttling the system" weergeven. Er moet één minuut gewacht worden alvorens er weer API calls kunnen gebeuren.
API overzicht
Via de documentatie link krijg je meer informatie over alle mogelijke API’s van de modules.
Dit is een Swagger interface die de mogelijkheden documenteert en ook kan gebruikt worden om te testen .
Via de API Config link ga je terug naar het configuratiescherm van Consult API.
Gebruik van de API
Een developer kan nu aan de slag met de API.
Meer info in dit artikel: Admin-IS / Admin-Consult API Werking voor de Softwareleverancier
API testomgeving
Er staat een Consult API online die je kan bekijken en testen op:
http://consultapi.syneton.be:2100/doc
- online tussen 7u en 19u
- de gegevens worden gereset elke zondagavond om 22u
Toegang aanvragen voor modules met een ticket op onze online helpdesk Syneton.Zendesk.com:
Hierna krijg je een sleutel om de API te gebruiken.
Opmerkingen, vragen of problemen eveneens melden met een ticket.
Opgelet:
- Dit is één gedeelde omgeving waar iedereen kan testen, gelieve op te letten met persoonlijke data.
- Hier komen ook de nieuwe items in bèta-test, deze zijn nog niet zichtbaar in productie.
Deze worden na goedkeuring gereleased, maar kunnen ook weer worden ingetrokken
Versies
Hoe een nieuwe versie krijgen? Zie artikel Marketplace Algemeen, Nieuwe Versies.
31-03-2021 - v1.1.5.18
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API:
-
- External File: spaces in column names allowed
- UBO: all data available
- Configuration page: "Software" renamed to "API gebruikers"
- Configuration page: Settings:
-
- default records per page
- max records per page
- TimeToLive of session token
- max API calls per minute
-
- /api/v1/apisettings
- /api/v1/customer/changes: also for customer_address
- Model Customer includes second phone number (Phone2)
- Language parameter for an API account (gebruiker) for code translations. Current accounts default to Dutch.
-
26-02-2021 - v1.1.5.14
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API: External File (known issue: spaces in column names), Invoice Email Recepients, Country Code in Customer Adresses
19-01-2021 - v1.1.5.6
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API: customer/changes and Changedetails
27-10-2020 - v1.1.4.5
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API: HRM: Employee.LoginName
16-10-2020 - v1.1.4.3
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API: DMS: FilePostedBy, FilePostedOn, FileInfo
24-9-2020 - v1.1.4.2
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API: ExtraField
24-9-2020 - v1.1.3.9
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API:
1) Customer.CustomerCrmTypeCustomerCrmType can be found through API GET /api/v1/customercrmtypes2) Customer.CustomerGroupCustomerGroup can be found through API GET /api/v1/customergroups3) CustomerJuridical.ClosingDatee.g. '2020-12-31'4) Customer.IsActive5) Customer.SocialSecurityNumber6) Customer.AccountancySoftwareAccountancySoftware can be found through API GET /api/v1/accountancysoftwares
7) customer_metadata
BillToBox info
31-8-2020 - v1.1.3.7
- Vanaf Admin-IS / Admin-Consult v9.1.0.10
- Uitbreiding API
- Data filters
- Pagineren
- interne verbeteringen
8-7-2020 - v1.1.0.3
- Vanaf Admin-IS / Admin-Consult v9.1.010
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.