Brincr koppelen aan APIcenter

Je koppelt Brincr aan APIcenter via de Visma Developer Portal. Brincr laat alleen toegang toe via een service-applicatie met OAuth 2.0 (client credentials) en een tenant-ID. Je doet dit één keer. Daarna gebruik je Brincr in al je integraties.

Wat je nodig hebt

• Een Brincr-account met een API-verbinding. Voor productie koopt de Brincr-gebruiker die API-verbinding in de Brincr Shop. Dit staat in de documentatie van de Brincr API.
• Een API-gebruiker in Brincr met het Client ID van de applicatie in de Visma Developer Portal. Brincr maakt de API-gebruiker zelf aan nadat de API-verbinding in Brincr is ingesteld. Je kunt er het Client ID bij invullen.
• Toestemming van de Brincr-gebruiker in de Visma Developer Portal voor de rechten (scopes) die de koppeling nodig heeft.

Toestemming geven in Visma

Brincr werkt met een uitnodigingscode. De Brincr-gebruiker geeft er toestemming mee:

1. Log in bij de Visma Developer Portal met het account van de Brincr-gebruiker.
2. Ga naar Visma App Store en kies, als daarom gevraagd wordt, de organisatie die bij Brincr hoort.
3. Ga naar My apps en klik op Use invitation code.
4. Vul de uitnodigingscode in en klik op Find.
5. Controleer de gevraagde rechten. Alle rechten staan standaard aan. Zet er geen uit zonder overleg: een ontbrekend recht geeft later een fout.
6. Scroll naar beneden en klik op Integrate.

Je krijgt de uitnodigingscode van de ontwikkelaar van de koppeling. Heb je hem niet, neem dan contact op met APIcenter-support. Op de pagina van de uitnodiging kun je de toestemming later ook weer intrekken.

Zo koppel je Brincr in APIcenter

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Brincr.
2. Vul de velden in die APIcenter voor Brincr toont. Bij Tenant ID vul je het tenant-ID in. Brincr gebruikt dat ID bij het opvragen van de toegangssleutel bij Visma.
3. Sla de verbinding op en test haar.

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

Als het niet lukt

Geeft Brincr een fout 401 of 403? Zie Brincr: veelvoorkomende fouten en Verbinding of inloggen mislukt.

Volgende stappen

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