Verbinding opzetten met Yuki

Met de Yuki-verbinding in FinWizer wordt data automatisch uitgelezen via de Yuki API. De verbinding wordt per Yuki-portaal opgezet. Heb je meerdere portalen? Dan maak je voor elk portaal een aparte verbinding aan in FinWizer. Daarbij geef je aan welk portaal het hoofdportaal is en welke portalen als subportaal hieraan gekoppeld zijn.

Voor het ophalen van verbruiksdata — zoals actieve licenties per administratie — kan een aanvullende upload van de Yuki-factuurspecificatie gedaan worden. Dit wordt toegelicht in stap 3.

Vereisten

Voor het aanmaken van een API-sleutel in Yuki heb je een account nodig met de rol Portaalbeheerder.

De API-sleutel moet minimaal toegang hebben tot de webservices

• Financieel
• Archief
• Domeinen

Stap 1: API-sleutel aanmaken in Yuki

1. Log in op het Yuki portaal en klik rechtsboven op het Instellingen-icoon.
2. Ga naar Webservices.
3. Klik op Voeg nieuwe API-sleutel toe en volg de stappen om de sleutel aan te maken.
4. Kopieer de gegenereerde API-sleutel en sla deze veilig op.

Stap 2: Verbinding aanmaken in FinWizer

1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
2. Selecteer Yuki (in de categorie Boekhouden).
3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
4. Is dit portaal een subportaal? Vink dan Subportaal aan en selecteer het bijbehorende hoofdportaal uit de lijst.
5. Vul de portaalnaam en de API-sleutel in.
6. Klik op Bevestig.

De verbinding is nu actief en FinWizer begint automatisch met het ophalen van de data. Herhaal deze stappen voor elk Yuki-portaal dat je wil koppelen.

Stap 3: Verbruiksdata uploaden via factuurspecificatie

De Yuki API geeft geen details over actieve licenties per administratie. Om deze verbruiksdata toch beschikbaar te maken in FinWizer, upload je de Yuki-factuurspecificatie als CSV-bestand.

1. Download de factuurspecificatie als CSV-bestand vanuit Yuki.
2. Ga in FinWizer naar Verbindingen en open de Yuki-verbinding van het hoofdportaal.
3. Ga naar het tabblad Facturen.
4. Zoek de juiste periode op en klik op het upload-icoon naast het bestandstype CSV.
5. Selecteer het CSV-bestand en upload het.

De verbruiksdata uit de factuurspecificatie wordt verwerkt voor zowel het hoofdportaal als alle gekoppelde subportalen.