Hoe leg ik een koppeling?

Hieronder lichten we toe hoe je een API-sleutel en Administratie-ID kan aanmaken om zo Yuki te koppelen met een ander pakket. 

Een gebruiker met de rol Directie of Backoffice rol kan een API-sleutel en Administratie-ID aanmaken.

• Hoe maak ik een API-sleutel en Administratie-ID aan?
• Type, rechten en administratie definiëren bij het aanmaken van een API-sleutel
• Aandachtspunten

Hoe maak ik een API-sleutel en Administratie-ID aan?

1. Navigeer in de Yuki omgeving via Instellingen naar Webservices, terug te vinden onder de tab Integraties
   
   
   
   
2. Klik links bovenaan op het plus icoon
   
   
   
   
3. Onderstaand scherm zal geopend worden:
   
   
4. Klik links bovenaan op Bewaren
5. Je zal nu de API-sleutel en Administratie-ID te zien krijgen. Deze kan je kopiëren en plakken in het andere pakket. 
   Opgelet: in heel uitzonderlijke gevallen heb je een domein ID nodig, dan zal je het type moeten wijzigen van Administratie naar Domein.
   
   

Ben je een accountant en wens je al je dossiers te laten synchroniseren met een rapportageprogramma (bv. Silverfin, Biztax,..)?

Via het portaal kan je een API-sleutel genereren die toegang geeft tot al de administraties die hangen onder jouw Backoffice portaal. Klik hier om terug te vinden hoe je deze portaal API-sleutel kan aanmaken.

Type, rechten en administratie definiëren bij het aanmaken van een API-sleutel

Bij het aanmaken van een API-sleutel zal Yuki standaard onderstaande opties weergeven:

Type

We raden aan om dit type ingesteld te laten staan op Administratie omwille van het volgende:

De API-sleutel op basis van administratie (bij Type) is de meest gebruikte en geeft ook enkel toegang tot die specifieke administratie. Indien het type ingesteld staat op Administratie, zal je ook, na het kiezen voor Bewaren, zowel de API-sleutel én de Administratie-ID krijgen wat in vele pakketten nodig is om in te geven.

Administratie

Wordt de boekhouding van meerdere administraties/ondernemingen bijgehouden in 1 Yuki omgeving? Dan kan je een API-sleutel en Administratie-ID aanmaken per administratie/onderneming.

Rechten

Wil je een koppeling leggen met een bestaand pakket?

Dan is het aan te raden om de optie Alle webservices aangevinkt te laten.

Afhankelijk van hoe de koppeling is opgesteld, kan het zijn dat het andere pakket toegang nodig heeft tot meerdere webservices /rechten. Denk bv. aan een facturatiepakket die zowel jouw verkoopfacturen gaat doorsturen naar Yuki maar ook jouw ontvangen betalingen (in Yuki) gaat ophalen.

Bouw je zelf een koppeling?

Dan kan je ervoor kiezen om de API-sleutel en Administratie-ID aan te maken op basis van specifiek geselecteerde webservices.

Opmerking

Als je meerdere pakketten gaat koppelen, dan kan het handig zijn om voor elk pakket een nieuwe API-sleutel aan te maken. In het opmerkingen veld kan je meegeven voor welke koppeling de sleutel wordt gebruikt. 

Aandachtspunten

• Wil je meerdere administraties linken, dan dien je meerdere API-sleutels aan te maken.
• Wissel de codes zeker niet om, dan werkt de koppeling niet.
• In vele pakketten zal je het veld "Toegangscode" of 'WebserviceAccessKey' zien. Hier plaats je de API-sleutel.
• Wordt een pakket na verloop van tijd niet meer gebruikt? Dan kan je in Yuki de API sleutel verwijderen en ben je zeker dat de koppeling niet meer bestaat.
• Onze koppelingen zullen enkel verbindingen met beveiliging TLS 1.2 en  hoger accepteren. Dit levert voor de meeste koppeling implementaties (applicaties die verbonden zijn met Yuki om date te versturen of op te halen) geen problemen. Heb je vragen of twijfel je? Neem dan even contact op met je software partner. Bij verdere vragen kan je software partner ons contacteren via koppelingen@yuki.be.