Yuki koppelen aan APIcenter

Je koppelt Yuki aan APIcenter met een API-sleutel (in Yuki heet die de webservice API-sleutel of WebserviceAccessKey). Je maakt die sleutel zelf aan in Yuki en vult hem in APIcenter in. Je doet dit één keer. Daarna gebruik je Yuki in al je integraties.

Wat je nodig hebt

• Toegang tot je Yuki-omgeving met een gebruikersrol die webservices mag instellen. Volgens Yuki mogen alleen gebruikers met bepaalde rollen, zoals Directie, een API-sleutel aanmaken. Heb je die rol niet, vraag het dan aan iemand die hem wel heeft.
• Voor facturen: de Sales-webservice. In alle andere bundels is hij inbegrepen. In de bundel Minimal voegt een gebruiker met de rol Portaalbeheerder hem als accountantfeature toe.

Stap 1: maak de API-sleutel aan in Yuki

1. Klik in Yuki in de navigatiebalk op het icoon Instellingen en kies in de sectie Integraties voor Webservices.
2. Klik op de knop +.
3. Kies Administratie en selecteer de administratie die je wilt koppelen.
4. Selecteer Alle webservices. Yuki raadt dit aan voor een koppeling met bestaande software. Met een selectie van webservices kan APIcenter een foutmelding krijgen dat de API-sleutel geen rechten heeft.
5. Klik op Bewaren.
6. Kopieer de API-sleutel.

Wil je meerdere administraties koppelen? Maak dan voor elke administratie een eigen API-sleutel aan en koppel Yuki voor elke administratie apart in APIcenter. APIcenter vraagt het administratie-ID niet aan je: dat leest APIcenter zelf uit Yuki, via de sleutel.

Yuki beschrijft de stappen op Webservices in domein en/of administratie instellen en Waar vind ik in Yuki de API-sleutel en de Administratie-ID?.

Stap 2: koppel Yuki 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 Yuki.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je administratie.
3. Plak de API-sleutel bij API Key.
4. Kies bij Country het land van je Yuki-omgeving: be of nl.
5. Klik op Opslaan en daarna op Testverbinding. APIcenter vraagt Yuki dan om een sessie voor je API-sleutel. Lukt dat, dan is Yuki klaar voor gebruik.

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

Als het niet lukt

• Mislukt de testverbinding? Controleer of je de hele API-sleutel hebt gekopieerd, zonder spaties, en of de sleutel niet is vervangen in Yuki. Zie Verbinding of inloggen mislukt.
• Geeft Yuki een melding dat de API-sleutel geen rechten heeft? Maak de sleutel opnieuw aan met Alle webservices.

Meer fouten met oorzaak en oplossing staan in Yuki: veelvoorkomende fouten.

Volgende stappen

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

Meer informatie van Yuki zelf staat in de Yuki API-documentatie.