Simplicate koppelen aan APIcenter

Je koppelt Simplicate aan APIcenter met een API-key en een API-secret die je zelf in Simplicate aanmaakt. Je doet dit één keer. Daarna gebruik je Simplicate in al je integraties.

Wat je nodig hebt

• Een Simplicate-omgeving. Het adres ziet er zo uit: https://<jouwdomein>.simplicate.nl.
• Een Simplicate-gebruiker met rechten om een API-key aan te maken.
• Een gebruiker waarvoor je de API-key maakt die de facturen en de relaties (personen en organisaties) in Simplicate mag bekijken. Een API-key krijgt namelijk dezelfde rechten als de gebruiker waarvoor je hem maakt. Heeft die gebruiker geen toegang tot een onderdeel, dan heeft de API-key die ook niet.

Een API-key aanmaken in Simplicate

1. Ga in Simplicate naar Instellingen > API.
2. Klik rechtsboven op Nieuw.
3. Kies de gebruiker waarvoor je de API-key maakt en kies een verloopdatum.
4. Simplicate toont een Authentication-Key en een Authentication-Secret. Bewaar beide waarden veilig. Deel ze met niemand en zet ze niet in een e-mail of document.

Let op: de verloopdatum van een bestaande API-key kun je niet wijzigen. Na de verloopdatum werkt de API-key niet meer. Noteer de datum, zodat je op tijd een nieuwe API-key maakt en in APIcenter invult. Verwijder je een API-key in Simplicate, dan werkt hij niet meer.

Simplicate legt het aanmaken uit in API-key aanmaken en verwijderen.

Zo koppel je Simplicate

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Simplicate.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je Simplicate-omgeving.
3. Vul de verbindingsgegevens in die het formulier vraagt: de Authentication-Key en de Authentication-Secret uit Simplicate en het adres van je Simplicate-omgeving.
4. Klik op Opslaan.
5. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Simplicate klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Als het niet lukt

• Controleer of je de key en de secret volledig en zonder spaties hebt overgenomen.
• Controleer in Simplicate bij Instellingen > API of de API-key nog bestaat en niet is verlopen.
• Controleer of de gebruiker van de API-key genoeg rechten heeft in Simplicate.

Zie ook Simplicate: veelvoorkomende fouten en Verbinding of inloggen mislukt.

Volgende stappen

Maak een integratie met Simplicate en controleer de instellingen. Zie Simplicate verbindings- en integratie-instellingen.

Meer informatie van Simplicate zelf staat in de documentatie van de Simplicate REST API.